Skip to content

feat(refresh): add Refresh Gate to interactive refresh#103

Merged
derek-palmer merged 2 commits into
mainfrom
feat/refresh-gate
Jun 9, 2026
Merged

feat(refresh): add Refresh Gate to interactive refresh#103
derek-palmer merged 2 commits into
mainfrom
feat/refresh-gate

Conversation

@derek-palmer

Copy link
Copy Markdown
Owner

Closes #102

What

Adds the Refresh Gate to the /forerunner-refresh skill form: after the staleness check, the agent presents the check report and asks once — multi-select, all options pre-selected — which STALE/MISSING docs to regenerate, instead of rewriting everything unprompted.

Behaviour

  • UNVERIFIABLE docs are shown in the report but never offered; noted as gaps.
  • auto argument, or a harness that can't ask (headless/AFK), skips the gate and proceeds with the full stale set, saying so in the summary.
  • Approved tasks still run in Task Registry refresh_sequence order regardless of selection order.
  • changelog and review stay on-demand — never offered at the gate.
  • Summary gains a "declined" category alongside updated / skipped (CURRENT) / gaps.
  • Batch prompt form (prompts/tasks/refresh.md) is unchanged in behaviour — one sentence added documenting that the gate is skill-form-only, keeping the CI/AFK path non-interactive.

Files

  • skills/forerunner-refresh/SKILL.md + plugin + .agents copies (kept identical)
  • src/codeforerunner/prompts/tasks/refresh.md — doc note only
  • CONTEXT.md — Refresh Gate glossary entry + example dialogue
  • uv.lock — stale version sync 0.4.7 → 0.4.8 (separate chore commit)

Verification

  • scripts/validate_skill_copies.py — V10 OK
  • uv run pytest — 296 passed
  • node --test tests/install.test.js — all passed

Out of scope

skills-lock.json has no forerunner-refresh entry (pre-existing gap, noted in #102).

🤖 Generated with Claude Code

Skill form now presents the staleness check report and asks once
(multi-select, all pre-selected) which STALE/MISSING docs to
regenerate. UNVERIFIABLE docs are reported but never offered. "auto"
argument or an ask-less harness skips the gate with the full stale
set. Batch prompt form stays non-interactive for CI/AFK. Summary
gains a declined category. Glossary: Refresh Gate added to CONTEXT.md.
@derek-palmer derek-palmer merged commit df9749f into main Jun 9, 2026
12 checks passed
@derek-palmer derek-palmer deleted the feat/refresh-gate branch June 9, 2026 18:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refresh Gate: interactive refresh asks before regenerating stale docs

1 participant