wip

Author: hesreallyhim

.github/workflows/self-test.yml

@@ -70,7 +70,7 @@ post.ts (action.yml post hook, runs always)
     ├── Read final state
     ├── Generate warnings
     ├── Render summary to $GITHUB_STEP_SUMMARY + console
-    └── Expose state_json and poll_log_json as action outputs
+    └── Upload state.json + poll-log.json as diagnostics artifacts
 ```
 
 ---
@@ -113,7 +113,7 @@ See `docs/planning/IMPL-PLAN-declarative-self-test.md` for full design.
 
 ## Next Steps
 
-1. **Write README.md** — Usage examples, inputs/outputs reference, example summary output
+1. **Write README.md** — Usage examples, inputs/artifacts reference, example summary output
 2. **Increase test coverage** — poller lifecycle (20%), post.ts (0%), pre.ts (0%), poll-log.ts (0%)
 3. **Consider test isolation** — Dedicated repo or reserved token to avoid cross-workflow rate-limit noise
 4. **Consider adding**:
@@ -124,7 +124,7 @@ See `docs/planning/IMPL-PLAN-declarative-self-test.md` for full design.
 
 ## Resolved Questions
 
-1. **Poller log file** — Resolved: poller writes diagnostic JSONL to `$RUNNER_TEMP/github-api-usage-monitor/poll-log.jsonl` via `poll-log.ts`. Exposed as `poll_log_json` action output.
+1. **Poller log file** — Resolved: poller writes diagnostic JSONL to `$RUNNER_TEMP/github-api-usage-monitor/poll-log.jsonl` via `poll-log.ts`. Post hook uploads `poll-log.json` as a diagnostics artifact alongside `state.json`.
 
 2. **dist/ in repo** — Resolved: `dist/` is committed to git. Pre-commit hook verifies it stays in sync after `build:all`. CI also verifies.
 

.github/workflows/test-main-output.yml

@@ -28,22 +28,34 @@ The poller uses constant-space aggregation — it tracks per-bucket deltas acros
 |-------|----------|---------|-------------|
 | `token` | No | `${{ github.token }}` | GitHub token for API authentication |
 
-## Outputs
+## Diagnostics artifacts
 
-| Output | Description |
-|--------|-------------|
-| `state_json` | Finalized reducer state as a JSON string |
-| `poll_log_json` | Poll log entries as a JSON array string |
+The post hook uploads a per-job diagnostics artifact named `github-api-usage-monitor-${GITHUB_JOB}` that contains:
 
-### Using outputs in downstream steps
+- `state.json` — finalized reducer state
+- `poll-log.json` — poll log entries as a JSON array
 
-```yaml
-- uses: hesreallyhim/github-api-usage-monitor@main
-  id: monitor
+### Using artifacts in downstream jobs
 
-- name: Check usage
-  run: |
-    echo '${{ steps.monitor.outputs.state_json }}' | jq '.buckets.core.total_used'
+```yaml
+jobs:
+  monitor:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: hesreallyhim/github-api-usage-monitor@main
+
+  diagnostics:
+    runs-on: ubuntu-latest
+    needs: monitor
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: github-api-usage-monitor-monitor
+          path: ./monitor-artifacts
+
+      - name: Check usage
+        run: |
+          jq '.buckets.core.total_used' ./monitor-artifacts/state.json
 ```
 
 ## Example Summary Output

.github/workflows/test-output-payload.yml

@@ -12,28 +12,6 @@ inputs:
     required: false
     default: ${{ github.token }}
 
-outputs:
-  state_json:
-    description: 'Finalized reducer state as a JSON string'
-  poll_log_json:
-    description: 'Poll log entries as a JSON array string'
-  main_marker:
-    description: 'Marker value set by the main step'
-  post_marker:
-    description: 'Marker value set by the post step'
-  post_state_json_bytes:
-    description: 'Byte length of state_json output (post)'
-  post_poll_log_json_bytes:
-    description: 'Byte length of poll_log_json output (post)'
-  post_poll_log_entries:
-    description: 'Poll log entry count observed in post'
-  post_poll_log_path:
-    description: 'Poll log file path observed in post'
-  post_github_output_bytes:
-    description: 'GITHUB_OUTPUT size in bytes observed in post (before size output write)'
-  post_github_output_path:
-    description: 'GITHUB_OUTPUT path observed in post'
-
 runs:
   using: node20
   pre: dist/pre.js