arcane-cli 0.35.0 → 0.35.1

package/dist/assets/.github/prompts/spell-close-session.prompt.md

@@ -71,6 +71,8 @@ Workflow:
 
 4c. **Follow-up promotion sweep (LH-09; only when this repo has its own `scripts/check-followups.ts` — Arcane's own repo, or one that adopted the same convention; skip gracefully otherwise).** Run `npm run check:followups` (or the closest journal-scoped equivalent) and check whether this session's own journal entry or closure notes contain a deferral phrase ("filed as a separate", "follow-up", "out of scope", "not fixed here", "left open", "deferred", "revisit", "future work") with no tracker token nearby (`TODO`, `IDEAS`, `Q-NNN`, `ARC-NNN`, `EF-NN`, `RCA-NNN`, a PR URL) and no explicit `(untracked: <reason>)` opt-out. Promote each real hit to `TODO.md`/`IDEAS.md` before writing the handoff, or add the opt-out inline. Report-only tool — a hit is a prompt to check, not proof of an untracked gap; skip anything that's already tracked elsewhere in the same document.
 
+4d. **Record the epic's reader-facing line (only when this session shipped an epic of a tracked program — one with a `docs/plans/<slug>/PLAN.md`; skip entirely otherwise).** Copy the `## For the record` sentence from the epic's own PR description verbatim into that epic's `PLAN.md` entry as its `**Report:**` line, in the format `**Report:** <sentence> · category: <spell|feature|governance|decision|fix|process|docs|platform> · glyph: <emoji>`, alongside the PR number the epic ticked with. Authored at PR time (see `spell-create-pull-request` Step 4) and copied here — never re-invented at close, and never substituted with the commit subject, which describes the change to an engineer rather than to the program's reader. **If the PR carried no such section**, leave the line absent rather than writing one from memory: the generator renders a missing description visibly as `unwritten`, and a visible gap someone can fill later is worth more than a plausible sentence nobody verified. Where a completion report is generated (`npm run check:report` / `spell report`), regenerate it after this edit so the committed artifact matches its sources.
+
 5. **Update [ai-context/system-prompt-context.md](../../ai-context/system-prompt-context.md).**
    - If priorities, environment state, or agent rules changed during the session, update the file to reflect current reality.
    - If no changes are needed, skip this step.

package/dist/assets/.github/prompts/spell-commit-work.prompt.md

@@ -205,6 +205,12 @@ Workflow:
    - Structured `###` sections for each logical change area.
    - A `### Testing` checklist (`- [x]` / `- [ ]`).
    - Tables/code blocks where they improve clarity.
+   - `## For the record` — **only when this PR is one epic of a tracked program** (one with a
+     `docs/plans/<slug>/PLAN.md`); omit the heading entirely otherwise. One plain sentence a
+     non-engineer reading the finished program would understand, plus `· category: <…> · glyph: <…>`.
+     It is copied verbatim into the epic's `PLAN.md` entry as its `**Report:**` line when the epic
+     is recorded. See `spell-create-pull-request`'s Step 4 for the full convention — defined there,
+     referenced here.
 
    g. Capture PR ID/URL from command output.
    - Always render PRs as clickable markdown links with the full URL.

package/dist/assets/.github/prompts/spell-create-pull-request.prompt.md

@@ -125,6 +125,12 @@ Standard template:
 ## Testing
 
 - <coverage / test status if known, else "See CI pipeline results.">
+
+## For the record
+
+<One plain sentence a non-engineer reviewing the finished program would read — what changed for
+them, not how it was built. Omit this section entirely when the PR is not one epic of a tracked
+program.> · category: <spell|feature|governance|decision|fix|process|docs|platform> · glyph: <emoji>
 ```
 
 `--docs-only` template (skip Testing):
@@ -138,8 +144,22 @@ Standard template:
 
 ## Notes
 Documentation-only PR. No functional code changed.
+
+## For the record
+
+<Same as above — include only when this PR is one epic of a tracked program.> · category: docs · glyph: <emoji>
 ```
 
+**About `## For the record`** — include it **only when this PR is one epic of a tracked program**
+(one with a `docs/plans/<slug>/PLAN.md`); omit the heading entirely otherwise, since an empty
+section is worse than none. Write the sentence that program's completion report will show for this
+epic, in the reader's language rather than the implementation's — what changed for someone reading
+the finished program, not how it was built. Authoring it here, while the work is fresh, is the
+point: it is copied verbatim into the epic's `PLAN.md` entry as its `**Report:**` line when the
+epic is recorded (`spell-close-session` step 4d). An epic that never gets one renders visibly as
+**unwritten** in the report — never as a pasted commit subject — so a missing line stays a visible
+gap rather than a silently fabricated one.
+
 ## Step 5 — Create the PR
 
 - **GitHub:**

package/dist/index.js

@@ -5675,8 +5675,11 @@ async function runReportGeneration(options) {
   const templateHtml = await readFile13(options.templatePath, "utf8");
   const drifted = [];
   const repaired = [];
+  const unwritten = [];
   for (const program2 of options.programs) {
     const generated = await generateReport(options.rootDir, program2, templateHtml);
+    const missing = JSON.parse(generated.json).sections.flatMap((section) => section.rows).filter((row) => row.descriptionState === "unwritten").map((row) => row.id);
+    if (missing.length > 0) unwritten.push({ slug: program2.slug, ids: missing });
     const outAbs = options.outDir ? isAbsolute(options.outDir) ? options.outDir : resolve3(options.rootDir, options.outDir) : resolve3(options.rootDir, dirname4(program2.planRelPath));
     const outRel = toPosix(relative3(options.rootDir, outAbs));
     const outputs = [
@@ -5695,7 +5698,7 @@ async function runReportGeneration(options) {
       }
     }
   }
-  return { drifted, repaired };
+  return { drifted, repaired, unwritten };
 }
 
 // src/commands/report.ts
@@ -5746,6 +5749,11 @@ async function runReport(targetDir, options = {}, assetsDir) {
     programs,
     outDir: options.out
   });
+  for (const u of result.unwritten) {
+    console.warn(
+      `\u26A0 arcane: ${u.slug} has ${u.ids.length} epic(s) with no \`**Report:**\` line in PLAN.md -- they render as "unwritten": ${u.ids.join(", ")}.`
+    );
+  }
   if (result.repaired.length === 0) {
     console.log(`Show report: ${programs.length} program(s) already up to date.`);
     return;