doctrina-cli 0.15.1 → 0.16.0

package/src/commands/handoff.js

@@ -2,12 +2,10 @@
 import path from "node:path";
 import process from "node:process";
 import { exists } from "../lib/fs-ops.js";
-import { collectStatus } from "./status.js";
-import { computeActions } from "./next.js";
-import { openChanges } from "./prime.js";
-import { today } from "../lib/dates.js";
 import { c } from "../lib/colors.js";
 import { notADoctrinaProject } from "../lib/exit-codes.js";
+import { collectSnapshot } from "../lib/snapshot.js";
+import { renderView } from "../lib/views.js";
 
 // Session handoff note: everything the NEXT session (a fresh agent, a
 // teammate, tomorrow's you) needs to resume without re-reading the tree —
@@ -17,6 +15,10 @@ import { notADoctrinaProject } from "../lib/exit-codes.js";
 // change. It is a VIEW derived from the tree at call time, deliberately not
 // a stored file: a saved note goes stale the moment work continues, the
 // tree never does (no new home for facts).
+//
+// Since change 0037 that word "view" is literal: the note is rendered by
+// lib/views.js from the one snapshot lib/snapshot.js collects, and is equally
+// reachable as `doctrina status --view handoff`.
 
 // Flags this command accepts. Declared HERE, with the command, so
 // adding a command never requires editing the entrypoint — the gap that
@@ -28,59 +30,7 @@ export async function run(_positional, _flags) {
   if (!exists(path.join(projectRoot, ".doctrina"))) {
     throw notADoctrinaProject();
   }
-
-  const s = collectStatus(projectRoot);
-  const open = openChanges(projectRoot);
-  const actions = computeActions(projectRoot);
-
-  console.log(`# Doctrina handoff — ${s.project} (${today()})`);
-  console.log("");
-
-  // Gate digest — the red ones are what the resuming session fixes first.
-  console.log("## Where things stand");
-  console.log("");
-  console.log(`- index: ${s.indexState} · framework stamp: ${s.stamp ?? "—"} (CLI ${s.cli})`);
-  console.log(`- coverage: ${s.coverage.pct}% (${s.coverage.totalCovered}/${s.coverage.totalCriteria} criteria` +
-    (s.coverage.totalDangling ? `, ${s.coverage.totalDangling} dangling` : "") +
-    (s.coverage.totalConditional ? `, ${s.coverage.totalConditional} conditional` : "") + ")");
-  const tr = s.trace.anchors === 0 ? "no anchors declared" : `${s.trace.realized}/${s.trace.anchors} anchors realized`;
-  console.log(`- trace: ${tr}` + (s.trace.untraceable ? ` (${s.trace.untraceable} untraceable)` : ""));
-  console.log(`- verify: ${s.verify.configured ? `${s.verify.checks} checks declared — run \`doctrina verify\`` : "not configured"}`);
-
-  // The in-flight work, task by task.
-  console.log("");
-  if (open.length === 0) {
-    console.log("## Open work");
-    console.log("");
-    console.log("- none — the tree is at rest; start with `doctrina work \"<prompt>\"`");
-  } else {
-    for (const ch of open) {
-      console.log(`## Open change \`${ch.id}\`${ch.title ? ` — ${ch.title}` : ""}`);
-      console.log("");
-      console.log(`- proposal status: ${ch.status}`);
-      if (ch.tasksTotal > 0) {
-        console.log(`- tasks: ${ch.tasksDone}/${ch.tasksTotal} checked`);
-        for (const t of ch.unchecked.slice(0, 8)) console.log(`  - [ ] ${t}`);
-        if (ch.unchecked.length > 8) console.log(`  - … ${ch.unchecked.length - 8} more in tasks.md`);
-      } else {
-        console.log("- tasks: no tasks.md checklist found");
-      }
-      console.log(`- resume with: \`doctrina work --resume ${ch.id}\` · close with: \`doctrina close ${ch.id}\``);
-      console.log("");
-    }
-  }
-
-  // What to do, in priority order.
-  console.log("## Next actions");
-  console.log("");
-  if (actions.length === 0) {
-    console.log("1. nothing pending — `doctrina next` will confirm; pick up new work");
-  } else {
-    actions.forEach((a, i) => console.log(`${i + 1}. ${a}`));
-  }
-
-  console.log("");
-  console.log("*Generated read-only from the tree — regenerate anytime with `doctrina handoff`.*");
+  for (const line of renderView("handoff", collectSnapshot(projectRoot))) console.log(line);
   if (process.stdout.isTTY) {
     console.log("");
     console.log(c.gray("tip: pipe it — `doctrina handoff > note.md` — or paste it as the first message of the next session"));
@@ -96,6 +46,9 @@ with its task-by-task progress and the exact resume command, and the
 prioritised next actions. Made to be pasted as the first message of the
 next agent session (or piped to a file).
 
+The same view as \`doctrina status --view handoff\`; both render one
+collection of the tree.
+
 Deliberately a derived view, not a stored file — the tree is the truth
 and never goes stale; regenerate on demand. Read-only; always exits 0.
 `;

package/src/commands/hooks.js

@@ -3,7 +3,10 @@ import path from "node:path";
 import process from "node:process";
 import { chmodSync } from "node:fs";
 import { exists, mkdirp, read, relPath, write } from "../lib/fs-ops.js";
-import { locateTemplatesDir } from "../lib/templates.js";
+import { locateTemplatesDir, substitute } from "../lib/templates.js";
+import { fileURLToPath } from "node:url";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
 import { flagBool } from "../lib/args.js";
 import { c } from "../lib/colors.js";
 import { suggest } from "../lib/suggest.js";
@@ -45,7 +48,13 @@ export async function run(positional, flags) {
 
   const templatesDir = locateTemplatesDir();
   const tplPath = path.join(templatesDir, "hooks", "pre-commit.sample");
-  const body = read(tplPath);
+  // The hook pins the CLI that installed it (change 0116). `.git/hooks/` is
+  // local to the clone, so an absolute path is the right thing to write;
+  // a bare `doctrina` ran whichever release was on the PATH — a global
+  // 0.15.0 under a 0.15.1 tree rewrote the stamp backwards on every commit.
+  // `DOCTRINA=` in the environment overrides it.
+  const entry = path.resolve(here, "..", "index.js").replaceAll("\\", "/");
+  const body = substitute(read(tplPath), { DOCTRINA_BIN: `node \"${entry}\"` });
   write(target, body, { force: true });
   chmodSync(target, 0o755);
   console.log(c.green("installed") + ` ${relPath(projectRoot, target)}`);

package/src/commands/index-rebuild.js

@@ -3,8 +3,7 @@ import path from "node:path";
 import process from "node:process";
 import { exists } from "../lib/fs-ops.js";
 import * as idx from "../lib/index-json.js";
-import { deriveIndex, indexesMatch, stableStringify } from "../lib/scan.js";
-import { cliVersion } from "../lib/version.js";
+import { collectIndexDrift } from "../lib/scan.js";
 import { today } from "../lib/dates.js";
 import { flagBool } from "../lib/args.js";
 import { c } from "../lib/colors.js";
@@ -38,39 +37,30 @@ function rebuild(flags) {
     throw notADoctrinaProject();
   }
 
-  let current = null;
-  try {
-    current = idx.load(projectRoot);
-  } catch (err) {
+  const state = collectIndexDrift(projectRoot);
+  if (state.unreadable) {
     if (check) {
-      console.error(c.red("error:") + ` ${err.message}`);
+      console.error(c.red("error:") + ` ${state.unreadable}`);
       return 1;
     }
-    console.log(c.yellow("warn:") + ` ${err.message} — rebuilding from scratch`);
+    console.log(c.yellow("warn:") + ` ${state.unreadable} — rebuilding from scratch`);
   }
 
-  const derived = deriveIndex(projectRoot, current);
-  // Migrate the framework stamp to the running CLI (3.6). deriveIndex carries
-  // the old value over (so `next` does not nag on a version-only difference);
-  // overriding it here lets a stale stamp count as drift, so `index rebuild`
-  // both reports and fixes it instead of short-circuiting on "nothing to do".
-  derived.framework_version = cliVersion();
-
-  if (indexesMatch(derived, current)) {
+  if (state.ok) {
     console.log(c.green("ok") + " index.json matches the tree (nothing to do)");
     return 0;
   }
 
-  const drift = describeDrift(current, derived);
-  for (const line of drift) console.log((check ? c.yellow("drift: ") : c.gray("sync:  ")) + line);
+  for (const line of state.drift) console.log((check ? c.yellow("drift: ") : c.gray("sync:  ")) + line);
 
   if (check) {
     console.log("");
-    console.log(c.red("fail") + ` index.json has drifted from the tree (${drift.length} difference${drift.length === 1 ? "" : "s"})`);
+    console.log(c.red("fail") + ` index.json has drifted from the tree (${state.drift.length} difference${state.drift.length === 1 ? "" : "s"})`);
     console.log(c.gray("hint: ") + "run `doctrina index rebuild` to regenerate it");
     return 1;
   }
 
+  const derived = state.derived;
   derived.last_updated = today();
   idx.save(projectRoot, derived);
   const a = derived.artifacts;
@@ -80,35 +70,6 @@ function rebuild(flags) {
   return 0;
 }
 
-// Human-readable category-level drift between the on-disk index and the
-// derived one: added / removed / changed entry ids.
-function describeDrift(current, derived) {
-  const lines = [];
-  if (!current) return ["index.json missing or unreadable"];
-  if ((current.framework_version ?? null) !== (derived.framework_version ?? null)) {
-    lines.push(`framework_version: ${current.framework_version ?? "unset"} -> ${derived.framework_version}`);
-  }
-  const categories = ["specs", "decisions", "changes", "changes_archive", "skills"];
-  for (const cat of categories) {
-    const cur = new Map((current.artifacts?.[cat] ?? []).map((e) => [e.id, e]));
-    const der = new Map((derived.artifacts?.[cat] ?? []).map((e) => [e.id, e]));
-    for (const id of der.keys()) {
-      if (!cur.has(id)) lines.push(`${cat}: "${id}" on disk but not in index`);
-      else if (stableStringify(cur.get(id)) !== stableStringify(der.get(id))) {
-        lines.push(`${cat}: "${id}" metadata differs from the files`);
-      }
-    }
-    for (const id of cur.keys()) {
-      if (!der.has(id)) lines.push(`${cat}: "${id}" in index but not on disk`);
-    }
-  }
-  if (stableStringify(current.artifacts?.product ?? null) !== stableStringify(derived.artifacts.product)) {
-    lines.push("product: metadata differs");
-  }
-  if (lines.length === 0) lines.push("structural difference (key order or missing category)");
-  return lines;
-}
-
 export const help = `
 Usage: doctrina index <subcommand>
 

package/src/commands/init.js

@@ -7,13 +7,14 @@ import {
   surfaceBlock, findSurfaceBlock, agentChangelogBlock, findAgentChangelogBlock,
 } from "../lib/commands.js";
 import * as idx from "../lib/index-json.js";
+import { scaffoldConfig } from "../lib/config.js";
 import { today } from "../lib/dates.js";
 import { cliVersion } from "../lib/version.js";
-import { flagBool, flagString } from "../lib/args.js";
+import { flagBool, flagString, flagGivenWithoutValue } from "../lib/args.js";
 import { c } from "../lib/colors.js";
 import { EXIT } from "../lib/exit-codes.js";
 import { ask, isInteractive } from "../lib/prompt.js";
-import { writeIntakeFile, printBootstrapPlaybook, warnIfThinIntake } from "./intake.js";
+import { looksLikePath, writeIntakeFile, printBootstrapPlaybook, warnIfThinIntake } from "../lib/intake-model.js";
 
 const SUPPORTED_AGENTS = [
   "claude",
@@ -32,7 +33,7 @@ const SUPPORTED_AGENTS = [
 
 export const flags = {
   boolean: ["json", "force", "non-interactive", "overwrite-content"],
-  string: ["project-name", "project-description", "agent", "intake", "from", "date"],
+  string: ["project-name", "project-description", "agent", "intake", "intake-text", "from", "date"],
 };
 
 export async function run(_positional, flags) {
@@ -45,17 +46,56 @@ export async function run(_positional, flags) {
   // --intake hands over the FULL description up front (ADR 0005); the
   // one-line summary is then derived instead of prompted for.
   const intakeFile = flagString(flags, "intake");
+  const intakeText = flagString(flags, "intake-text");
   let intakeBody = null;
+  let intakeSource = null;
+  // Onboarding is ONE moment, so it gets one command (change 0051). The
+  // separation between `init` and `intake` is an architectural fact — `init`
+  // refuses to read language, ADR 0005 — and it was being charged to the
+  // user as two steps of setup. Both commands stay: `intake` is still the
+  // door for converting a description in a project that already exists.
+  if (intakeFile && intakeText !== undefined) {
+    console.error(c.red("error:") + " pass --intake <file> or --intake-text \"<text>\", not both");
+    return EXIT.USAGE;
+  }
+  // A flag written without a value is a usage error, never a silent fallback
+  // to "no intake": the operator asked for one and would get a project
+  // without it, and nothing would say so.
+  for (const name of ["intake", "intake-text"]) {
+    if (flagGivenWithoutValue(flags, name)) {
+      console.error(c.red("error:") + ` --${name} needs a value`);
+      console.error(c.gray("hint: ") + (name === "intake"
+        ? "doctrina init --intake ./description.md"
+        : "doctrina init --intake-text \"<the whole project description>\""));
+      return EXIT.USAGE;
+    }
+  }
+  if (typeof intakeText === "string" && intakeText.trim() !== "") {
+    intakeBody = intakeText;
+    intakeSource = "inline (--intake-text)";
+  }
   if (intakeFile) {
     const intakeAbs = path.resolve(projectRoot, intakeFile);
-    if (!isFile(intakeAbs)) {
+    if (isFile(intakeAbs)) {
+      intakeBody = read(intakeAbs);
+      intakeSource = relPath(projectRoot, intakeAbs);
+      if (intakeBody.trim().length === 0) {
+        console.error(c.red("error:") + ` --intake file is empty: ${intakeFile}`);
+        return 1;
+      }
+    } else if (looksLikePath(intakeFile)) {
       console.error(c.red("error:") + ` --intake file not found: ${intakeFile}`);
+      console.error(c.gray("hint: ") +
+        'to pass the description itself, use `--intake-text "<description>"`');
       return 1;
-    }
-    intakeBody = read(intakeAbs);
-    if (intakeBody.trim().length === 0) {
-      console.error(c.red("error:") + ` --intake file is empty: ${intakeFile}`);
-      return 1;
+    } else {
+      // The same rule `intake` applies to its positional (change 0071): the
+      // two commands answer the same input shape the same way, so an agent
+      // that learned one is not surprised by the other.
+      intakeBody = intakeFile;
+      intakeSource = "inline";
+      console.error(c.gray("note:  ") +
+        'read as the description itself, not as a file — `--intake-text "<description>"` says so explicitly');
     }
   }
 
@@ -214,6 +254,20 @@ export async function run(_positional, flags) {
     console.log(c.green("created") + ` ${relPath(projectRoot, written)}`);
   }
 
+  // config.json, written from the module that READS it (lib/config.js) for
+  // the same reason index.json is written from its schema: a template copy
+  // is how a project is born already needing a scaffold update. Before this
+  // the file was created by nothing, named in no surface block and reported
+  // by no command — it existed only for someone who had read the source, and
+  // a pt-BR project sat permanently red under `clarify` with no clue why.
+  {
+    const dest = path.join(doctrinaDir, "config.json");
+    if (!isFile(dest) || force) {
+      write(dest, scaffoldConfig(), { force });
+      console.log(c.green("created") + ` ${relPath(projectRoot, dest)}`);
+    }
+  }
+
   // Adapters
   if (agentSelector) {
     const agents = agentSelector === "all" ? SUPPORTED_AGENTS : [agentSelector];
@@ -229,7 +283,7 @@ export async function run(_positional, flags) {
   if (intakeBody) {
     const intakePath = writeIntakeFile(projectRoot, {
       body: intakeBody,
-      source: relPath(projectRoot, path.resolve(projectRoot, intakeFile)),
+      source: intakeSource,
       projectName,
       date,
       force,
@@ -361,9 +415,12 @@ Options:
   --project-description <text>   One-sentence description
   --agent <name>                 Install adapter for one agent
                                  (claude|codex|cursor|copilot|gemini|aider|windsurf|continue|amp|devin|factory|jules|all)
-  --intake <file>                Full project description; stored verbatim at .doctrina/intake.md
-                                 and used to derive the one-line description when absent.
-                                 Follow up with \`doctrina intake\` for the bootstrap playbook
+  --intake <file>                Full project description; stored verbatim at .doctrina/intake.md,
+                                 used to derive the one-line description when absent, and the
+                                 bootstrap playbook is printed inline — no second command
+  --intake-text "<text>"         The same, inline, with no file to write first. Mutually
+                                 exclusive with --intake; either one written without a value
+                                 is a usage error, not a project scaffolded without an intake
   --from <path>                  Local conventions directory; if it contains AGENTS.md and/or
                                  .doctrina/product.md, the content is folded into the new project
   --date <YYYY-MM-DD>            Override the system date

package/src/commands/intake.js

@@ -8,6 +8,11 @@ import * as idx from "../lib/index-json.js";
 import { today } from "../lib/dates.js";
 import { flagBool, flagString } from "../lib/args.js";
 import { c } from "../lib/colors.js";
+import { looksLikePath, warnIfThinIntake, writeIntakeFile, printBootstrapPlaybook } from "../lib/intake-model.js";
+
+// `init --intake` performs the same operations; they live in
+// lib/intake-model.js so neither command imports out of the other (F7).
+export { warnIfThinIntake, writeIntakeFile, printBootstrapPlaybook } from "../lib/intake-model.js";
 import { EXIT, notADoctrinaProject } from "../lib/exit-codes.js";
 
 // `intake` is the first half of the no-ceremony path (ADR 0005): store the
@@ -58,12 +63,24 @@ export async function run(positional, flags) {
     source = "inline (--text)";
   } else {
     const abs = path.resolve(projectRoot, sourceFile);
-    if (!isFile(abs)) {
+    if (isFile(abs)) {
+      body = read(abs);
+      source = relPath(projectRoot, abs);
+    } else if (looksLikePath(sourceFile)) {
       console.error(c.red("error:") + ` description file not found: ${sourceFile}`);
+      console.error(c.gray("hint: ") +
+        'to pass the description itself, use `doctrina intake --text "<description>"`');
       return 1;
+    } else {
+      // Prose, not a path (change 0071). The surface block says "store the
+      // intent", so passing the intent is what its wording invites; answering
+      // "description file not found:" and echoing the author's whole sentence
+      // back as a filename was the CLI blaming the reader for reading it.
+      body = sourceFile;
+      source = "inline";
+      console.error(c.gray("note:  ") +
+        'read as the description itself, not as a file — `--text "<description>"` says so explicitly');
     }
-    body = read(abs);
-    source = relPath(projectRoot, abs);
   }
   if (body.trim().length === 0) {
     console.error(c.red("error:") + " the description is empty");
@@ -74,6 +91,16 @@ export async function run(positional, flags) {
     console.error(c.red("error:") + ` ${relPath(projectRoot, intakePath)} already exists (pass --force to overwrite)`);
     return 1;
   }
+  // After conversion the specs are the only source of truth, and the intake
+  // is never edited to change requirements (change 0112). `--force` was the
+  // CLI-sanctioned way to do exactly that: it rewrote the file to `pending`
+  // and printed the bootstrap playbook as if the tree were empty. The door
+  // for new intent is `intent add`; for a change of behaviour, `work`.
+  if (exists(intakePath) && (listHeader(read(intakePath), "Status") ?? "pending").toLowerCase() === "converted") {
+    console.error(c.red("error:") + ` ${relPath(projectRoot, intakePath)} is already converted — the specs are the source of truth now, and --force does not reopen it`);
+    console.error(c.gray("hint: ") + "new product intent: `doctrina intent add \"<text>\"` · a change of behaviour: `doctrina work \"<prompt>\"`");
+    return EXIT.PRECONDITION;
+  }
 
   const projectName = idx.load(projectRoot).project ?? path.basename(projectRoot);
   writeIntakeFile(projectRoot, { body, source, projectName, date: today(), force });
@@ -84,95 +111,6 @@ export async function run(positional, flags) {
   return 0;
 }
 
-// Clarification gate (review Topic A). A description too thin to spec from is
-// the moment to ask the user, not to let the agent invent requirements. Prints
-// the specific gaps before the bootstrap playbook; advisory, never blocking —
-// the intake is still captured verbatim (the playbook step 6 resolves it).
-export function warnIfThinIntake(body) {
-  const assessment = assessBrief(body, { kind: "intake" });
-  if (!assessment.thin) return;
-  console.log(c.yellow("⚠ thin intake — clarify with the user before converting to specs:"));
-  for (const reason of assessment.reasons) console.log(`    - ${reason}`);
-  console.log("");
-}
-
-// Shared with `init --intake`. Writes the intake verbatim under a small
-// status header; the agent flips Status to converted at the end of the
-// playbook, which is how `next` knows the bootstrap is done.
-export function writeIntakeFile(projectRoot, { body, source, projectName, date, force = false }) {
-  const intakePath = path.join(projectRoot, ".doctrina", "intake.md");
-  const content = [
-    `# Intake — ${projectName}`,
-    "",
-    "- **Status:** pending",
-    `- **Date:** ${date}`,
-    `- **Source:** ${source}`,
-    "",
-    "<!-- Raw project intent, stored verbatim. The bootstrap playbook",
-    "     (doctrina intake) converts it into product.md and capability",
-    "     specs, then flips Status to converted. After conversion the",
-    "     specs are the only source of truth; never edit this file to",
-    "     change requirements. -->",
-    "",
-    "---",
-    "",
-    body.replace(/\r\n/g, "\n").replace(/\n*$/, "\n"),
-  ].join("\n");
-  write(intakePath, content, { force });
-  return intakePath;
-}
-
-// Exported so `init --intake` can print the same playbook inline instead
-// of bouncing the user to a second command.
-export function printBootstrapPlaybook(projectRoot) {
-  const hasSpecs = exists(path.join(projectRoot, ".doctrina", "specs"));
-  console.log(c.bold("Bootstrap playbook") + c.gray(" — agent-executed (ADR 0005); the CLI does no interpretation."));
-  console.log("");
-  console.log("Execute in order, in a single linear pass:");
-  console.log("");
-  console.log(`1. Read ${c.cyan(".doctrina/intake.md")} (raw intent) and ${c.cyan(".doctrina/product.md")}.`);
-  console.log("");
-  console.log("2. Fill every product.md section from the intake: Vision, Problem,");
-  console.log("   Target users, Scope (in/out), Non-goals, Success criteria, and the");
-  console.log("   Delivery order — name the ONE end-to-end walking skeleton to build");
-  console.log("   and verify before fanning out (depth before breadth).");
-  console.log("   One fact, one home — product.md holds vision, never requirements.");
-  console.log("");
-  console.log("3. Derive the capability list: kebab-case, one per area of behaviour");
-  console.log("   (e.g. auth, billing, reports). For each capability:");
-  console.log(`       ${c.cyan("doctrina spec new <capability>")}`);
-  console.log("   then replace the template placeholders in");
-  console.log("   .doctrina/specs/<capability>/spec.md with EARS requirements derived");
-  console.log("   from the intake (Ubiquitous / Event-driven / State-driven /");
-  console.log("   Unwanted-behavior / Optional). Keep the two axes honest — leave");
-  console.log("   Implementation: planned for what is not built yet; keep aspiration");
-  console.log("   under ## Maturity → Future, not in EARS; write concrete Acceptance");
-  console.log("   criteria, each [unverified] until a cited test proves it.");
-  console.log("");
-  console.log("4. If the project spans services/front-ends, own the seams between");
-  console.log("   them (port map, env, API/WS/event shapes) as a contract:");
-  console.log(`       ${c.cyan("doctrina contract new <name>")} → fill it → ${c.cyan("doctrina contract check")}`);
-  console.log("");
-  console.log("5. Record any architectural decision the intake forces (cite Evidence):");
-  console.log(`       ${c.cyan("doctrina decision new \"<title>\"")} → edit → ${c.cyan("doctrina decision accept <num>")}`);
-  console.log("");
-  console.log("6. Quality gates — fix everything they report before moving on:");
-  console.log(`       ${c.cyan("doctrina clarify --all")}`);
-  console.log(`       ${c.cyan("doctrina validate")}`);
-  console.log(`       ${c.cyan("doctrina coverage")}   (and ${c.cyan("doctrina verify --init")} to declare the build gate)`);
-  console.log("   If something in the intake is genuinely ambiguous, ask the user");
-  console.log("   before assuming.");
-  console.log("");
-  console.log("7. Mark the intake consumed: in .doctrina/intake.md flip");
-  console.log("   \"- **Status:** pending\" to \"- **Status:** converted\".");
-  console.log("");
-  console.log(`8. ${c.cyan("doctrina next")} — follow the recommendation. Implementation then`);
-  console.log(`   flows through ${c.cyan("doctrina work \"<brief prompt>\"")}, one change at a time.`);
-  if (!hasSpecs) {
-    console.log("");
-    console.log(c.yellow("warn:") + " .doctrina/specs/ is missing — re-run `doctrina init` first.");
-  }
-}
 
 export const help = `
 Usage: doctrina intake [<file>] [--text "<description>"] [--force]