codeforerunner 0.4.6__tar.gz → 0.4.8__tar.gz

{codeforerunner-0.4.6/src/codeforerunner.egg-info → codeforerunner-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeforerunner
-Version: 0.4.6
+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.6)](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.
 
@@ -91,10 +91,11 @@ Slash command availability depends on the agent CLI. Claude Code, Codex, and Gem
 
 | Flag | Effect |
 |------|--------|
-| `./install.sh` | Auto-detect all agents, prompt global vs local, install all skills |
-| `./install.sh --global` | Skip prompt, install to global agent dirs (all projects) |
-| `./install.sh --local` | Skip prompt, install to `.claude/skills/` and `.agents/skills/` in cwd |
-| `./install.sh --only claude` | Claude Code only |
+| `./install.sh` | Auto-detect agents, prompt for global vs local, prompt which agents to install |
+| `./install.sh --global` | Skip location prompt, install to global agent dirs (all projects) |
+| `./install.sh --local` | Skip location prompt, install to `.claude/skills/` and `.agents/skills/` in cwd |
+| `./install.sh --non-interactive` | Skip all prompts, install globally to all detected agents (useful in CI / curl\|bash) |
+| `./install.sh --only claude` | Claude Code only (skips agent selection prompt) |
 | `./install.sh --only codex` | Codex only |
 | `./install.sh --only gemini` | Gemini CLI only |
 | `./install.sh --dry-run` | Preview, write nothing |
@@ -148,7 +149,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6.0.2
-      - uses: derek-palmer/codeforerunner@v0.4.6
+      - uses: derek-palmer/codeforerunner@v0.4.8
         with:
           fail-on-drift: "true"   # set "false" to warn-only
 ```

{codeforerunner-0.4.6 → codeforerunner-0.4.8}/README.md

@@ -2,7 +2,7 @@
 
 # codeForerunner
 
-[![Socket Badge](https://badge.socket.dev/npm/package/codeforerunner/0.4.6)](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.
 
@@ -64,10 +64,11 @@ Slash command availability depends on the agent CLI. Claude Code, Codex, and Gem
 
 | Flag | Effect |
 |------|--------|
-| `./install.sh` | Auto-detect all agents, prompt global vs local, install all skills |
-| `./install.sh --global` | Skip prompt, install to global agent dirs (all projects) |
-| `./install.sh --local` | Skip prompt, install to `.claude/skills/` and `.agents/skills/` in cwd |
-| `./install.sh --only claude` | Claude Code only |
+| `./install.sh` | Auto-detect agents, prompt for global vs local, prompt which agents to install |
+| `./install.sh --global` | Skip location prompt, install to global agent dirs (all projects) |
+| `./install.sh --local` | Skip location prompt, install to `.claude/skills/` and `.agents/skills/` in cwd |
+| `./install.sh --non-interactive` | Skip all prompts, install globally to all detected agents (useful in CI / curl\|bash) |
+| `./install.sh --only claude` | Claude Code only (skips agent selection prompt) |
 | `./install.sh --only codex` | Codex only |
 | `./install.sh --only gemini` | Gemini CLI only |
 | `./install.sh --dry-run` | Preview, write nothing |
@@ -121,7 +122,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6.0.2
-      - uses: derek-palmer/codeforerunner@v0.4.6
+      - uses: derek-palmer/codeforerunner@v0.4.8
         with:
           fail-on-drift: "true"   # set "false" to warn-only
 ```

{codeforerunner-0.4.6 → codeforerunner-0.4.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codeforerunner"
-version = "0.4.6"
+version = "0.4.8"
 description = "Model-agnostic repository documentation tooling (prompt-first; thin CLI)."
 readme = "README.md"
 requires-python = ">=3.11"

codeforerunner-0.4.8/src/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-0.4.6 → codeforerunner-0.4.8}/src/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.6 → codeforerunner-0.4.8/src/codeforerunner.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeforerunner
-Version: 0.4.6
+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.6)](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.
 
@@ -91,10 +91,11 @@ Slash command availability depends on the agent CLI. Claude Code, Codex, and Gem
 
 | Flag | Effect |
 |------|--------|
-| `./install.sh` | Auto-detect all agents, prompt global vs local, install all skills |
-| `./install.sh --global` | Skip prompt, install to global agent dirs (all projects) |
-| `./install.sh --local` | Skip prompt, install to `.claude/skills/` and `.agents/skills/` in cwd |
-| `./install.sh --only claude` | Claude Code only |
+| `./install.sh` | Auto-detect agents, prompt for global vs local, prompt which agents to install |
+| `./install.sh --global` | Skip location prompt, install to global agent dirs (all projects) |
+| `./install.sh --local` | Skip location prompt, install to `.claude/skills/` and `.agents/skills/` in cwd |
+| `./install.sh --non-interactive` | Skip all prompts, install globally to all detected agents (useful in CI / curl\|bash) |
+| `./install.sh --only claude` | Claude Code only (skips agent selection prompt) |
 | `./install.sh --only codex` | Codex only |
 | `./install.sh --only gemini` | Gemini CLI only |
 | `./install.sh --dry-run` | Preview, write nothing |
@@ -148,7 +149,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6.0.2
-      - uses: derek-palmer/codeforerunner@v0.4.6
+      - uses: derek-palmer/codeforerunner@v0.4.8
         with:
           fail-on-drift: "true"   # set "false" to warn-only
 ```

{codeforerunner-0.4.6 → codeforerunner-0.4.8}/src/codeforerunner.egg-info/SOURCES.txt

@@ -33,6 +33,7 @@ src/codeforerunner/prompts/tasks/changelog.md
 src/codeforerunner/prompts/tasks/check.md
 src/codeforerunner/prompts/tasks/diagrams.md
 src/codeforerunner/prompts/tasks/flows.md
+src/codeforerunner/prompts/tasks/gaps.md
 src/codeforerunner/prompts/tasks/init-agent-onboarding.md
 src/codeforerunner/prompts/tasks/readme.md
 src/codeforerunner/prompts/tasks/refresh.md

{codeforerunner-0.4.6 → codeforerunner-0.4.8}/tests/test_tasks.py

@@ -33,7 +33,7 @@ def test_get_unknown_raises():
 
 
 def test_scan_exempt_names():
-    assert tasks.scan_exempt_names() == {"scan", "init-agent-onboarding"}
+    assert tasks.scan_exempt_names() == {"scan", "init-agent-onboarding", "gaps"}
 
 
 def test_refresh_tasks_ordered():
@@ -75,6 +75,36 @@ def test_cli_rejects_unregistered_task(tmp_path, capsys):
     assert "unknown task" in capsys.readouterr().err
 
 
+def test_gaps_task_registered():
+    t = tasks.get("gaps")
+    assert t.scan_exempt is True
+    assert t.skill_slug == "forerunner-gaps"
+
+
+def test_gaps_excluded_from_refresh_sequence():
+    names = [t.name for t in tasks.refresh_tasks()]
+    assert "gaps" not in names
+
+
+def test_gaps_installable_slug_present():
+    assert "forerunner-gaps" in tasks.installable_slugs()
+
+
+def test_gaps_skill_files_exist():
+    from pathlib import Path
+    root = Path(__file__).resolve().parent.parent
+    assert (root / "skills" / "forerunner-gaps" / "SKILL.md").is_file()
+    assert (root / "plugins" / "codeforerunner" / "skills" / "forerunner-gaps" / "SKILL.md").is_file()
+
+
+def test_gaps_skill_copies_in_sync():
+    from pathlib import Path
+    root = Path(__file__).resolve().parent.parent
+    installed = (root / "skills" / "forerunner-gaps" / "SKILL.md").read_text(encoding="utf-8")
+    plugin = (root / "plugins" / "codeforerunner" / "skills" / "forerunner-gaps" / "SKILL.md").read_text(encoding="utf-8")
+    assert installed == plugin
+
+
 def test_mcp_tools_list_matches_registry():
     from codeforerunner.mcp_server import _tools
     import codeforerunner