Add example workflow and enhance action metadata for CPython Patch PR Action

Author: CasperKristiansson

.github/workflows/example.yml

@@ -0,0 +1,21 @@
+name: Example Usage
+
+on:
+  workflow_dispatch:
+
+jobs:
+  run-action:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run CPython Patch PR Action
+        uses: ./
+        with:
+          track: '3.13'
+          include_prerelease: false
+          paths: |
+            .github/workflows/**/*.yml
+            Dockerfile
+            pyproject.toml
+          automerge: false
+          dry_run: true

action.yml

@@ -1,9 +1,40 @@
 name: CPython Patch PR Action
-description: "Scaffolded placeholder for the CPython patch PR GitHub Action."
+description: Track CPython patch releases and prepare update pull requests.
 author: Casper Kristiansson
+inputs:
+  track:
+    description: CPython minor series to track (for example 3.13).
+    required: false
+    default: "3.13"
+  include_prerelease:
+    description: Include pre-release tags when resolving the latest patch version.
+    required: false
+    default: "false"
+  paths:
+    description: Newline-separated glob patterns that determine which files to scan for pinned Python versions.
+    required: false
+    default: |
+      .github/workflows/**/*.yml
+      Dockerfile
+      **/Dockerfile
+      **/*.python-version
+      **/runtime.txt
+      **/pyproject.toml
+  automerge:
+    description: Attempt to automerge the pull request after required checks succeed.
+    required: false
+    default: "false"
+  dry_run:
+    description: Skip file modifications and output the planned changes only.
+    required: false
+    default: "false"
+outputs:
+  new_version:
+    description: Resolved CPython patch version (for example 3.13.5).
+  files_changed:
+    description: JSON array listing files that were updated.
+  skipped_reason:
+    description: Machine-readable reason describing why no update was applied.
 runs:
   using: node20
   main: dist/index.js
-defaults:
-  run:
-    shell: bash

docs/tasks.md

@@ -74,7 +74,7 @@ Use Context7 MCP for up to date documentation.
        Files: `package.json`, `tsconfig.json`, `action.yml`, `src/index.ts`.
        Verify: `npm run build` succeeds. `node dist/index.js` prints placeholder.
 
-3. [ ] **Define action metadata**
+3. [x] **Define action metadata**
        Inputs: `track`, `include_prerelease`, `paths`, `automerge`, `dry_run`.
        Outputs: `new_version`, `files_changed`, `skipped_reason`. `runs: node20`.
        Verify: `actionlint` passes on sample workflow.

src/index.ts

@@ -3,9 +3,41 @@ import * as core from '@actions/core';
 async function run(): Promise<void> {
   try {
     const track = core.getInput('track') || '3.13';
-    core.info(`CPython Patch PR Action placeholder executing for track ${track}.`);
-    // Temporary placeholder output until task-specific logic is implemented.
-    console.log('Placeholder: CPython patch PR action is under construction.');
+    const includePrerelease =
+      core.getInput('include_prerelease').toLowerCase() === 'true';
+    const paths =
+      core
+        .getMultilineInput('paths', { trimWhitespace: true })
+        .filter(Boolean) || [];
+    const automerge = core.getInput('automerge').toLowerCase() === 'true';
+    const dryRun = core.getInput('dry_run').toLowerCase() === 'true';
+
+    const effectivePaths =
+      paths.length > 0
+        ? paths
+        : [
+            '.github/workflows/**/*.yml',
+            '**/Dockerfile',
+            '**/.python-version',
+            '**/runtime.txt',
+            '**/pyproject.toml'
+          ];
+
+    core.startGroup('Configuration');
+    core.info(`track: ${track}`);
+    core.info(`include_prerelease: ${includePrerelease}`);
+    core.info(
+      `paths (${effectivePaths.length}): ${effectivePaths.join(', ')}`
+    );
+    core.info(`automerge: ${automerge}`);
+    core.info(`dry_run: ${dryRun}`);
+    core.endGroup();
+
+    // Placeholder output until the implementation is completed in later tasks.
+    core.info('CPython Patch PR Action placeholder executing.');
+    core.setOutput('new_version', '');
+    core.setOutput('files_changed', JSON.stringify([]));
+    core.setOutput('skipped_reason', 'not_implemented');
   } catch (error) {
     if (error instanceof Error) {
       core.setFailed(error.message);