Skip to content

fix(core): broaden recap-framing lint to accept accomplishment recaps (#49)#63

Merged
jbrecht merged 2 commits into
mainfrom
fix-49-broaden-recap-lint
Jun 16, 2026
Merged

fix(core): broaden recap-framing lint to accept accomplishment recaps (#49)#63
jbrecht merged 2 commits into
mainfrom
fix-49-broaden-recap-lint

Conversation

@jbrecht

@jbrecht jbrecht commented Jun 15, 2026

Copy link
Copy Markdown
Owner

Closes #49.

Problem

The strict-mode framing lint (#36) warns when the last step's narration "doesn't close with a recap", gated on RECAP_CUE_RE, which only matched a fixed cue set ("to recap", "in summary", "you're ready", "now you can", …). A well-written recap using past-tense accomplishment phrasing matched none of them, so strict mode emitted a false-positive warning. Real example from umami's #133 dogfood that slipped through:

"That's the core loop. You created an event, set up ticketing, added a banner… From here you can invite attendees and send broadcasts."

The asymmetry: INTRO_CUE_RE is much looser, so the objective side passed easily while the recap side over-nagged.

Fix

Widen RECAP_CUE_RE to also accept:

  • past-tense accomplishment verbs after "you" — created / added / built / set up / configured / enabled / published / …
  • the from here you… hand-off connector

All existing cues are kept (no regression); the lint stays advisory and never fails a render. This is heuristic tuning, not a rendering change — it just makes the lint trustworthy enough to leave on.

Tests

Added a spec test using the real umami recap above, asserting strict mode emits no recap warning for it. Full suite: 170 unit tests pass; build clean.

Note: adds a ## Unreleased CHANGELOG section; #61 (the #50 fix) does too, so whichever merges second needs a trivial one-line merge to combine the bullets.

🤖 Generated with Claude Code

jbrecht and others added 2 commits June 15, 2026 16:33
…#49)

The strict-mode lint that nudges the last step to close with a recap (#36)
only matched a fixed cue set ("to recap", "you're ready", …), so a valid
past-tense accomplishment recap false-warned. Widen RECAP_CUE_RE to also
match "you created/set up/added/…" accomplishment phrasing and the
"from here you…" hand-off, bringing it to parity with the much looser
INTRO_CUE_RE. All existing cues are kept; advisory-only, never fails a
render. Tested with the real umami recap that slipped through.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jbrecht jbrecht merged commit 1bd1652 into main Jun 16, 2026
1 check passed
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.

Recap lint heuristic too narrow: misses valid past-tense / accomplishment-style recaps

1 participant