cf15682d1c
* feat(#3028): responsive Markdown separators instead of fixed-width rules Stage banners, checkpoints, completion and error panels used fixed-width runs of box-drawing characters -- a 53-column heavy rule and a 62-column double-line box. Those runs are ordinary text to a Markdown-rendering host, so in a narrower pane they wrap and the border comes apart from the heading it framed. Shipped content now emits an ATX heading for a titled section and a blank-line-delimited --- for a break between sections, both of which adapt to the available width. The same convention is applied to the three code sites that built these strings at runtime: the UAT checkpoint renderer, the milestone-close audit report, and the TDD review checkpoint table. Removing the box also removes its only reason to exist -- the east-asian-width padding helpers that kept its right border aligned (checkpointBoxLine, displayWidth, isWideCodePoint, ZERO_WIDTH_MARK_RE, CHECKPOINT_BOX_WIDTH). RTL directional isolation is unchanged. The convention is specified in gsd-core/references/ui-brand.md and enforced across all shipped content by tests/responsive-separators.test.cjs. Refs #3028 * test(#3028): pin the heading form in checkpoint and audit-report assertions These suites asserted the exact box borders and the 62-column padded banner interior. With the box gone they assert the ### heading form, the --- break and the bolded instruction line, and each now carries a positive assertion that no box character remains -- which is what pins the fix rather than merely tolerating it. Language coverage is converted, not dropped: Japanese, Chinese, Korean, Hindi and Arabic all still assert their rendered banner, and the Arabic case still asserts the RTL directional isolates the box removal must not disturb. Adds a case for a banner longer than the old inner width, which previously produced a ragged border and now has none. Refs #3028 * chore(#3028): acknowledge execute-plan.md growth from the checkpoint display spec The checkpoint_protocol display spec described the drawn box; it now describes the heading, the --- break and the bolded action prompt, which costs 22 bytes (40111 -> 40133, 827 under the cap). Appended to the existing #3370 fragment rather than filed as a new one: a growth ack keys on the bare filename and #3370 already declares execute-plan.md, so a second source naming it would be a hard duplicate-key error. Same supersede-by-append route #3370 took for the spent #2652 fragment. Refs #3028 * docs(#3028): state the load-bearing half of the separator rule, and amend the zh-CN reference Review found three things. The rule as first written demanded a blank line above AND below every ---. Only the one above is load-bearing: it is what stops CommonMark reading the rule as a setext underline for the line above. The one below is cosmetic, because a thematic break is a leaf block. The rule now says that, with the reason, instead of asserting a stricter form the content does not keep. The zh-CN reference had received the mechanical box-to-heading swap but none of the prose behind it: it still claimed a 62-character checkpoint width and still listed --- among forbidden mixed banner styles, so it contradicted the convention it was translating. It now carries the separator section, the setext reasoning, the unconditional-vs-per-runtime rationale and a corrected anti-pattern list, in Chinese. The user guide asserted that a heading is not a degradation anywhere. That is an assertion, not a demonstration. It now says what was actually traded away in a plain terminal, points at the recorded rationale, and invites the report that would justify the capability flag instead. Refs #3028 * chore(#3028): backfill changeset PR number Refs #3028 --------- Co-authored-by: sim <sim@local>
87 lines
3.0 KiB
Markdown
87 lines
3.0 KiB
Markdown
<!--
|
|
offer-next.md — extracted from execute-phase.md step "offer_next" (#2537).
|
|
Eagerly @-referenced from execute-phase.md so runtime behavior is unchanged; the
|
|
extraction restores byte-budget headroom the frozen ceiling exists to provide.
|
|
-->
|
|
|
|
**Exception:** If `gaps_found`, the `verify_phase_goal` step already presents the gap-closure path (`/gsd:plan-phase {X} --gaps`). No additional routing needed — skip auto-advance.
|
|
|
|
**No-transition check (spawned by auto-advance chain):**
|
|
|
|
Parse `--no-transition` flag from $ARGUMENTS.
|
|
|
|
**If `--no-transition` flag present:**
|
|
|
|
Execute-phase was spawned by plan-phase's auto-advance. Do NOT run transition.md.
|
|
After verification passes and roadmap is updated, return completion status to parent:
|
|
|
|
```
|
|
## PHASE COMPLETE
|
|
|
|
Phase: ${PHASE_NUMBER} - ${PHASE_NAME}
|
|
Plans: ${completed_count}/${total_count}
|
|
Verification: {Passed | Gaps Found}
|
|
|
|
[Include aggregate_results output]
|
|
```
|
|
|
|
STOP. Do not proceed to auto-advance or transition.
|
|
|
|
**If `--no-transition` flag is NOT present:**
|
|
|
|
**Auto-advance detection:**
|
|
|
|
1. Parse `--auto` flag from $ARGUMENTS
|
|
2. Read consolidated auto-mode (`active` = chain flag OR user preference; chain flag already synced in init step):
|
|
```bash
|
|
AUTO_MODE=$(gsd_run query check auto-mode --pick active 2>/dev/null || echo "false")
|
|
```
|
|
|
|
**If `--auto` flag present OR `AUTO_MODE` is true (AND verification passed with no gaps):**
|
|
|
|
```
|
|
### AUTO-ADVANCING → TRANSITION
|
|
|
|
Phase {X} verified, continuing chain
|
|
```
|
|
|
|
Execute the transition workflow inline (do NOT use Agent — orchestrator context is ~10-15%, transition needs phase completion data already in context):
|
|
|
|
Read and follow `~/.claude/gsd-core/workflows/transition.md`, passing through the `--auto` flag so it propagates to the next phase invocation.
|
|
|
|
**If neither `--auto` nor `AUTO_MODE` is true:**
|
|
|
|
**STOP. Do not auto-advance. Do not execute transition. Do not plan next phase. Present options to the user and wait.**
|
|
|
|
**IMPORTANT: There is NO `/gsd-transition` command. Never suggest it. The transition workflow is internal only.**
|
|
|
|
Check whether CONTEXT.md already exists for the next phase:
|
|
|
|
```bash
|
|
ls .planning/phases/*{next}*/{next}-CONTEXT.md 2>/dev/null || echo "no-context"
|
|
```
|
|
|
|
If CONTEXT.md does **not** exist for the next phase, present:
|
|
|
|
```
|
|
## ✓ Phase {X}: {Name} Complete
|
|
|
|
/gsd:progress ${GSD_WS} — see updated roadmap
|
|
/gsd:discuss-phase {next} ${GSD_WS} — start here: discuss next phase before planning ← recommended
|
|
/gsd:plan-phase {next} ${GSD_WS} — plan next phase (skip discuss)
|
|
/gsd:execute-phase {next} ${GSD_WS} — execute next phase (skip discuss and plan)
|
|
```
|
|
|
|
If CONTEXT.md **exists** for the next phase, present:
|
|
|
|
```
|
|
## ✓ Phase {X}: {Name} Complete
|
|
|
|
/gsd:progress ${GSD_WS} — see updated roadmap
|
|
/gsd:plan-phase {next} ${GSD_WS} — start here: plan next phase (CONTEXT.md already present) ← recommended
|
|
/gsd:discuss-phase {next} ${GSD_WS} — re-discuss next phase
|
|
/gsd:execute-phase {next} ${GSD_WS} — execute next phase (skip planning)
|
|
```
|
|
|
|
Only suggest the commands listed above. Do not invent or hallucinate command names.
|