codeforerunner 0.4.7__py3-none-any.whl → 0.4.8__py3-none-any.whl

codeforerunner/prompts/tasks/gaps.md

@@ -0,0 +1,52 @@
+# Task: Surface Documentation and Scan Gaps
+
+Reads cached forerunner state and surfaces two categories of gaps for the user to act on:
+1. **Doc gaps** — STALE or MISSING findings from the check report
+2. **Scan gaps** — fields the scan could not determine from available evidence
+
+Does not generate docs. Routes the user to the right next step.
+
+## Input
+
+- `.forerunner/scan.yaml` — cached scan result (check file modification time)
+- `.forerunner/check-report.md` — cached staleness classifications (check file modification time)
+
+## Instructions
+
+### Step 1 — Check cache freshness
+
+Read `.forerunner/scan.yaml` and `.forerunner/check-report.md`.
+
+If either file is missing: report which file is absent and stop. Ask the user to run `forerunner doc scan` and/or `forerunner doc check` first.
+
+If `scan.yaml` is older than 24 hours: warn the user and offer to continue with cached results or re-run scan first.
+
+If `check-report.md` is older than `scan.yaml`: warn the user and offer to continue or re-run check first.
+
+### Step 2 — Surface doc gaps
+
+Extract all rows from `check-report.md` where status is `STALE` or `MISSING`.
+
+If none: report "All documented tasks are CURRENT." Proceed to step 3.
+
+Present a summary table and offer: run `/forerunner-refresh` to regenerate all stale/missing docs, or invoke a specific task skill for individual items.
+
+### Step 3 — Surface scan gaps
+
+Read the `gaps:` field from `scan.yaml`. If absent or empty: report "No scan gaps detected." Stop.
+
+Otherwise, list each gap and ask the user how to fill them:
+
+**A) Quick fill** — ask one question per gap and patch `scan.yaml` with user-provided values  
+**B) Full grill session** — deeper conversation that also updates `CONTEXT.md` and domain docs (requires `grill-with-docs` skill; fall back to A if not available)  
+**C) Skip**
+
+For quick fill (A): ask one question per gap in sequence, update the corresponding field in `.forerunner/scan.yaml`, mark as `# user-provided` inline.
+
+For grill session (B): invoke `grill-with-docs` with the gap list as the grilling focus.
+
+## Rules
+
+- Never run a fresh scan or check automatically. Only read cached files.
+- If `grill-with-docs` is not available when user selects B, fall back to A and inform the user.
+- End with a summary: what was surfaced, what was filled, what remains open.

codeforerunner/tasks.json

@@ -25,6 +25,7 @@
     {"name": "refresh",               "scan_exempt": false, "skill_slug": "forerunner-refresh"},
     {"name": "review",                "scan_exempt": false, "skill_slug": "forerunner-review"},
     {"name": "stack-docs",            "scan_exempt": false, "skill_slug": "forerunner-stack-docs"},
-    {"name": "version-audit",         "scan_exempt": false, "skill_slug": "forerunner-version-audit"}
+    {"name": "version-audit",         "scan_exempt": false, "skill_slug": "forerunner-version-audit"},
+    {"name": "gaps",                   "scan_exempt": true,  "skill_slug": "forerunner-gaps"}
   ]
 }

{codeforerunner-0.4.7.dist-info → codeforerunner-0.4.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeforerunner
-Version: 0.4.7
+Version: 0.4.8
 Summary: Model-agnostic repository documentation tooling (prompt-first; thin CLI).
 Author: Derek Palmer
 License-Expression: LicenseRef-Codeforerunner-SAL-0.1
@@ -29,7 +29,7 @@ Dynamic: license-file
 
 # codeForerunner
 
-[![Socket Badge](https://badge.socket.dev/npm/package/codeforerunner/0.4.7)](https://socket.dev/npm/package/codeforerunner)
+[![Socket Badge](https://badge.socket.dev/npm/package/codeforerunner/0.4.8)](https://socket.dev/npm/package/codeforerunner)
 
 Model-agnostic repository documentation tooling. Ships a prompt pack for codebase analysis and doc generation, a thin Python CLI, an MCP server, drift-detection rules that keep docs honest — and native slash-command skills for Claude Code, Codex, Gemini CLI, and other agent CLIs.
 
@@ -149,7 +149,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6.0.2
-      - uses: derek-palmer/codeforerunner@v0.4.7
+      - uses: derek-palmer/codeforerunner@v0.4.8
         with:
           fail-on-drift: "true"   # set "false" to warn-only
 ```

{codeforerunner-0.4.7.dist-info → codeforerunner-0.4.8.dist-info}/RECORD

@@ -11,7 +11,7 @@ codeforerunner/prompt_session.py,sha256=_ImYp5BBUmPF8uklcKGcuPw0Fx6p7Ev3PvxFpLpo
 codeforerunner/release_surfaces.json,sha256=q8fus5wrWrNucnBiK65cTKjDuHstb5-NsYeNL1RqreU,3481
 codeforerunner/release_surfaces.py,sha256=QIh9tcLCVF4JNj5COvLvBfzmFacSyTV6Cuvpa9aMvl8,3517
 codeforerunner/skill_parity.py,sha256=FEKO4SU7RzdV_oMfcVlTPBdydxH594cZShYJni9WjdA,3244
-codeforerunner/tasks.json,sha256=vgMW4OdfYE4_Al_8vDp38MAAx8uQF_uUYckcme3HQRM,1589
+codeforerunner/tasks.json,sha256=SEyeaZXRWyEgwvNqaCHQFkWJKzi6RI5W8kyZKjXq6iI,1684
 codeforerunner/tasks.py,sha256=DeLu3LAPcIbAQDra_xAi8mZyQicfEMPj3d64MhrTJss,1571
 codeforerunner/prompts/partials/context-format.md,sha256=WNfkr4kf2Awj0R8wLOrFotEiYCe6hfKTq5eA3Rt5_Xw,817
 codeforerunner/prompts/partials/output-rules.md,sha256=vfIAX-ImxCa-MVAeNH896uSIO7-cKbJd0KohkgHIiD8,1731
@@ -24,6 +24,7 @@ codeforerunner/prompts/tasks/changelog.md,sha256=zEy3HFFjsg_X4K93yOgKUfhpunrbqJr
 codeforerunner/prompts/tasks/check.md,sha256=TWEjrAqq14-yKGPL39x0RlaTTYfMZ8lG4VMSMsZ_4YA,2722
 codeforerunner/prompts/tasks/diagrams.md,sha256=Hjo5PS5HwH0VAwjQrAfZGhOjnOco1VjBZ_Z8Rdt1exo,2129
 codeforerunner/prompts/tasks/flows.md,sha256=JDfI9-zuSI-1rhStbpzb5Bb05iEMWFB0dAffsAwnI08,1592
+codeforerunner/prompts/tasks/gaps.md,sha256=cmULFPIlviPCAuw-tMuDKrfNZOa69_2uAqe7pp3uIPM,2341
 codeforerunner/prompts/tasks/init-agent-onboarding.md,sha256=J-HJ-6TcPdMUGC5E76QiNLD61XmnU-fWHZTanuFtzME,2504
 codeforerunner/prompts/tasks/readme.md,sha256=Fq9CTAryb7Kv4bPMIgcyGFgmmzh7KtnMRa9tSyWt0yU,1156
 codeforerunner/prompts/tasks/refresh.md,sha256=-7vRYazNLNegKC2wdJBfR1j9Brw_tLVEbaVx9BVbu0o,1435
@@ -31,9 +32,9 @@ codeforerunner/prompts/tasks/review.md,sha256=IRdIXAKvv0JMOE5WtrnlO1Cd4LHXtcJqb1
 codeforerunner/prompts/tasks/scan.md,sha256=IoZXX-bt9ODra7cSB-3Y6IUgws6YTDKwKNX_18ChjIU,2338
 codeforerunner/prompts/tasks/stack-docs.md,sha256=Dy-JSXpSmHSyhR5shQBXKa_F0PqnjPcmtljthYZpaiM,1923
 codeforerunner/prompts/tasks/version-audit.md,sha256=oK-pcoxt_VcvDOlj1Sz9OlEhXlcViLPn54r-qP5WfiA,5833
-codeforerunner-0.4.7.dist-info/licenses/LICENSE.md,sha256=iIhmJHib6GbdjcwiDMM-npiNRf3XgASom1WsOJivEdc,2915
-codeforerunner-0.4.7.dist-info/METADATA,sha256=Hu0QeISIv2xkzyH4ZoLu-KoWG_Alg4PnH18_mav37qo,9953
-codeforerunner-0.4.7.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-codeforerunner-0.4.7.dist-info/entry_points.txt,sha256=3p8BbPlq-wfcXk42tsweKePRaGlZ1WXho1gOkuZGyIQ,55
-codeforerunner-0.4.7.dist-info/top_level.txt,sha256=pV1rt0-NIpNEotKXpL_sF2060DHr-_0F86LWhUlvXis,15
-codeforerunner-0.4.7.dist-info/RECORD,,
+codeforerunner-0.4.8.dist-info/licenses/LICENSE.md,sha256=iIhmJHib6GbdjcwiDMM-npiNRf3XgASom1WsOJivEdc,2915
+codeforerunner-0.4.8.dist-info/METADATA,sha256=VWhixJeYrosJ2DtlFtwwCvTQNGAu_7zCvLjB-HP1kUE,9953
+codeforerunner-0.4.8.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+codeforerunner-0.4.8.dist-info/entry_points.txt,sha256=3p8BbPlq-wfcXk42tsweKePRaGlZ1WXho1gOkuZGyIQ,55
+codeforerunner-0.4.8.dist-info/top_level.txt,sha256=pV1rt0-NIpNEotKXpL_sF2060DHr-_0F86LWhUlvXis,15
+codeforerunner-0.4.8.dist-info/RECORD,,