@dougharness/cli 1.4.0 → 1.6.0

package/node_modules/@dougharness/flow/lib/plan.mjs

@@ -576,6 +576,46 @@ export function validatePlan(plan) {
       }
     });
   }
+  errors.push(...signatureErrors(plan));
+  return errors;
+}
+
+// Card planner-keeps-stated-signatures (2026-10-23, ts-orders swarm-skill): a signature the goal or an acceptance
+// line quotes in backticks (`name(...)...`) must reach every task spec that quotes the same name, character for
+// character after an optional `export `, `async `, `function ` prefix. Two different signatures for one name are
+// rejected, never guessed between. Non-string goal, spec, and acceptance entries are skipped.
+function signatureErrors(plan) {
+  const spans = (s) => (typeof s === "string" ? [...s.matchAll(/`([^`\n]+)`/g)].map((m) => m[1].trim()) : []);
+  const strip = (s) => s.replace(/^export\s+/, "").replace(/^async\s+/, "").replace(/^function\s+/, "").replace(/\s*;\s*$/, "").trim();
+  // A stated signature is a call form that carries a return type (its last `)` is followed by `:`); an untyped call
+  // is an example, never compared.
+  const nameOf = (s) => (/\)\s*:/.test(s.slice(s.lastIndexOf(")"))) ? /^([A-Za-z_$][\w$]*)\(/.exec(s)?.[1] : undefined);
+  const texts = [plan.goal, ...(Array.isArray(plan.acceptance) ? plan.acceptance.map((a) => (a && typeof a === "object" ? a.text : a)) : [])];
+  const stated = new Map(); // name -> signatures (distinct)
+  for (const text of texts) {
+    for (const span of spans(text)) {
+      const sig = strip(span);
+      const name = nameOf(sig);
+      if (!name) continue;
+      if (!stated.has(name)) stated.set(name, []);
+      if (!stated.get(name).includes(sig)) stated.get(name).push(sig);
+    }
+  }
+  const errors = [];
+  for (const [name, sigs] of stated) {
+    if (sigs.length > 1) errors.push(`the goal and acceptance state ${name} two ways, ${sigs.map((s) => `\`${s}\``).join(" and ")}: a stated signature reaches the plan verbatim, so state one`);
+  }
+  if (!Array.isArray(plan.tasks)) return errors;
+  for (const t of plan.tasks) {
+    if (!t || typeof t !== "object") continue;
+    for (const span of spans(t.spec)) {
+      const sig = strip(span);
+      const name = nameOf(sig);
+      const want = name && stated.get(name);
+      if (!want || want.length !== 1 || want[0] === sig) continue;
+      errors.push(`task ${t.id} spec states \`${sig}\` but the plan states \`${want[0]}\`: a stated signature reaches the task spec verbatim`);
+    }
+  }
   return errors;
 }
 

package/node_modules/@dougharness/flow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dougharness/flow",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "private": true,
   "description": "Plan, approve, implement one task per worktree, verify, review: a Workflow-tool template and subagents for Claude Code.",
   "type": "module",

package/node_modules/@dougharness/flow/scripts/autopilot.mjs

@@ -23,10 +23,11 @@
 //   autopilot.mjs end
 // --dir <d> names the project (default cwd). Exit 0 done; 1 no run or unknown card; 2 bad usage.
 import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { loadModels } from "../lib/models.mjs";
 import { AUTOPILOT_FILE, STEPS, clearable, readAutopilot } from "../lib/autopilot-view.mjs";
 import { contextThreshold } from "../lib/context.mjs";
@@ -34,6 +35,21 @@ import { classifyNotification, pickCards, queenLabel, renameQueenMeta, workersMa
 import { nextReadyCards } from "../lib/board.mjs";
 import { SEATS } from "../lib/card-loop.mjs";
 import { planFor, reportPathFor } from "../lib/plan.mjs";
+import { readMemoryConfig, readMemoryStaleDays } from "../lib/embeddings.mjs";
+
+// Card memory-failures-wiring (user decision, 2026-10-28): a stopped card starts `memory.mjs reflect --failures
+// <card> --max-usd 0.5 --detach` (job failures-<card>, cheap row), after its run history is written. The queue
+// approval is the approval. A start that fails (a live job holds the name) warns and never fails the report.
+function startFailuresReflect(dir, id) {
+  try {
+    execFileSync(process.execPath, [join(dirname(fileURLToPath(import.meta.url)), "memory.mjs"), "reflect", "--failures", id, dir, "--max-usd", "0.5", "--detach"], {
+      stdio: ["ignore", "ignore", "pipe"],
+      env: process.env,
+    });
+  } catch (e) {
+    process.stderr.write(`autopilot: warning: cannot start reflect --failures for ${id}: ${String(e.stderr || e.message || e).trim().split("\n")[0]}\n`);
+  }
+}
 
 const argv = process.argv.slice(2);
 const opts = {};
@@ -484,6 +500,167 @@ switch (cmd) {
         }
       }
     }
+    if (kind === "hand" && parsed !== null) {
+      const rep = parsed.report ?? parsed;
+      if (rep && typeof rep === "object" && rep.outcome === "stopped") {
+        try {
+          const mem = await import("../lib/memory.mjs");
+          const written = JSON.stringify(rep, null, 2) + "\n";
+          const readOr = (p) => {
+            try {
+              return readFileSync(p, "utf8");
+            } catch {
+              return "";
+            }
+          };
+          const ids = mem.runAgentIds((Array.isArray(c.journals) ? c.journals : []).map(readOr));
+          const blocks = mem.attributeBlocks(readOr(join(dir, ".doug/.state/blocks.jsonl")), ids);
+          let condition = null;
+          try {
+            const parsedCondition = JSON.parse(readFileSync(join(dir, ".doug/.state/reports", c.id, "condition.json"), "utf8"));
+            if (parsedCondition && typeof parsedCondition === "object" && !Array.isArray(parsedCondition)) condition = parsedCondition;
+          } catch {
+            condition = null;
+          }
+          const row = mem.stopOutcomeRow({
+            card: c.id,
+            report: rep,
+            reportHash: createHash("sha256").update(written).digest("hex"),
+            reportPath: join(dir, ".doug/.state/reports", c.id, "card-report.json"),
+            run,
+            blocks,
+            condition,
+          });
+          const m = mem.openMemory(dir);
+          try {
+            mem.recordOutcomes(m, [row]);
+          } finally {
+            m.close();
+          }
+        } catch (e) {
+          process.stderr.write(`autopilot: warning: cannot record the stop row for ${c.id}: ${e.message || e}\n`);
+        }
+      }
+    }
+    if (kind === "hand" && parsed !== null) {
+      try {
+        const mem = await import("../lib/memory.mjs");
+        const rep = parsed.report ?? parsed;
+        const readOr = (p) => {
+          try {
+            return readFileSync(p, "utf8");
+          } catch {
+            return "";
+          }
+        };
+        const sid = process.env.CLAUDE_CODE_SESSION_ID;
+        const jp = journalPath(run);
+        const journalText = jp ? readOr(jp) : "";
+        let queenArgs = null;
+        try {
+          queenArgs = JSON.parse(readFileSync(join(dir, ".doug/.state/reports", c.id, "queen-args.json"), "utf8"));
+        } catch {
+          // no saved args: no briefs
+        }
+        const seatRuns = mem.journalSeatRuns(journalText);
+        const briefs = mem.replayBriefs(queenArgs, seatRuns);
+        const ids = mem.runAgentIds([journalText]);
+        const blocks = mem.attributeBlocks(readOr(join(dir, ".doug/.state/blocks.jsonl")), ids);
+        const denials = mem.attributeDenials(sid ? readOr(join(dir, ".doug/.state/trace", `${sid.replace(/[^A-Za-z0-9_.-]/g, "_")}.jsonl`)) : "", ids);
+        const scan = await mem.historyScanner(dir);
+        const entries = [{ kind: "report", source: "card-report.json", value: rep }];
+        for (const b of blocks) entries.push({ kind: "block", source: "blocks.jsonl", value: b });
+        for (const d of denials) entries.push({ kind: "denial", source: "trace", value: d });
+        seatRuns.forEach((r, i) => {
+          if (briefs[i] !== null) entries.push({ kind: "brief", seat: r.seat, round: r.round, source: "replay:card-loop.mjs", value: briefs[i] });
+          entries.push({ kind: "hand-back", seat: r.seat, round: r.round, source: "journal.jsonl", value: r.result });
+        });
+        mem.writeRunHistory(dir, { card: c.id, run, entries, scan });
+      } catch (e) {
+        process.stderr.write(`autopilot: warning: cannot write the run history for ${c.id}: ${e.message || e}\n`);
+      }
+    }
+    if (kind === "hand" && parsed !== null && (parsed.report ?? parsed)?.outcome === "stopped") startFailuresReflect(dir, c.id);
+    if (kind === "flow" && parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) && parsed.ok === false && !parsed.paused) {
+      try {
+        const mem = await import("../lib/memory.mjs");
+        const readOr = (p) => {
+          try {
+            return readFileSync(p, "utf8");
+          } catch {
+            return "";
+          }
+        };
+        const written = JSON.stringify(parsed, null, 2) + "\n";
+        const ids = mem.runAgentIds((Array.isArray(c.journals) ? c.journals : []).map(readOr));
+        const blocks = mem.attributeBlocks(readOr(join(dir, ".doug/.state/blocks.jsonl")), ids);
+        const levels = Array.isArray(parsed.levels) ? parsed.levels : [];
+        let stopClass = null;
+        let stopReason = null;
+        for (const lv of levels) {
+          const t = (Array.isArray(lv?.tasks) ? lv.tasks : []).find((x) => x && typeof x.stopReason === "string" && x.stopReason.trim() !== "");
+          if (t) {
+            stopClass = t.stopClass ?? null;
+            stopReason = t.stopReason;
+            break;
+          }
+        }
+        if (stopReason === null) {
+          stopReason = "the run stopped";
+          if (parsed.stoppedAtLevel !== undefined && parsed.stoppedAtLevel !== null) {
+            stopReason += ` at level ${parsed.stoppedAtLevel}`;
+            const lv = levels.find((x) => x && x.index === parsed.stoppedAtLevel) ?? levels[parsed.stoppedAtLevel];
+            const why = lv?.integration?.reason;
+            if (typeof why === "string" && why.trim() !== "") stopReason += `: ${why}`;
+          }
+        }
+        const row = {
+          ...mem.stopOutcomeRow({
+            card: c.id,
+            report: { outcome: "stopped", reason: stopClass, detail: stopReason },
+            reportHash: createHash("sha256").update(written).digest("hex"),
+            reportPath: join(dir, reportPathFor(c.id)),
+            run,
+            blocks,
+            memoryConfig: mem.memoryConfig({ embeddings: readMemoryConfig(dir).embeddings, staleDays: readMemoryStaleDays(dir), track: "flow" }),
+          }),
+          track: "flow",
+        };
+        const m = mem.openMemory(dir);
+        try {
+          mem.recordOutcomes(m, [row]);
+        } finally {
+          m.close();
+        }
+      } catch (e) {
+        process.stderr.write(`autopilot: warning: cannot record the stop row for ${c.id}: ${e.message || e}\n`);
+      }
+    }
+    if (kind === "flow" && parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) && (parsed.ok === true || parsed.ok === false) && !parsed.paused) {
+      try {
+        const mem = await import("../lib/memory.mjs");
+        const readOr = (p) => {
+          try {
+            return readFileSync(p, "utf8");
+          } catch {
+            return "";
+          }
+        };
+        const sid = process.env.CLAUDE_CODE_SESSION_ID;
+        const jp = journalPath(run);
+        const ids = mem.runAgentIds([jp ? readOr(jp) : ""]);
+        const blocks = mem.attributeBlocks(readOr(join(dir, ".doug/.state/blocks.jsonl")), ids);
+        const denials = mem.attributeDenials(sid ? readOr(join(dir, ".doug/.state/trace", `${sid.replace(/[^A-Za-z0-9_.-]/g, "_")}.jsonl`)) : "", ids);
+        const scan = await mem.historyScanner(dir);
+        const entries = [{ kind: "report", source: "last-report.json", value: parsed }];
+        for (const b of blocks) entries.push({ kind: "block", source: "blocks.jsonl", value: b });
+        for (const d of denials) entries.push({ kind: "denial", source: "trace", value: d });
+        mem.writeRunHistory(dir, { card: c.id, run, entries, scan });
+      } catch (e) {
+        process.stderr.write(`autopilot: warning: cannot write the run history for ${c.id}: ${e.message || e}\n`);
+      }
+    }
+    if (kind === "flow" && parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) && parsed.ok === false && !parsed.paused) startFailuresReflect(dir, c.id);
     const v = classifyNotification(kind, { status: "completed", result: parsed === null ? text : parsed });
     if (v.action === "ask") {
       let answered = false;

package/node_modules/@dougharness/flow/scripts/board.mjs

@@ -38,13 +38,13 @@
 //                                                 flow, or named by .doug/plan.json (each with --force removes it
 //                                                 and prints a warning to stderr); prints the removed card as JSON
 //                                                 to stdout so a mistaken removal can be re-added by hand
-//   board.mjs record <id> <report.json> [dir] --summary "<one sentence>" [--cost <usd>] [--codex-cost <usd>] [--shared-cost <usd>] [--wall <text>] [--commit <sha>] [--adversary "<id>=<class>[: <reason>]"]... [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed>] [--run <run-id>] [--claude-dir <dir>]
+//   board.mjs record <id> <report.json> [dir] --summary "<one sentence>" [--cost <usd>] [--codex-cost <usd>] [--shared-cost <usd>] [--wall <text>] [--commit <sha>] [--adversary "<id>=<class>[: <reason>]"]... [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed> [--rehearsal-fixture <name>]] [--run <run-id>] [--claude-dir <dir>]
 //                                                 append a run entry for the card to docs/live-runs.md; every adversary block
 //                                                 in the report is classified real, marginal, or false (repeat the flag per block).
 //                                                 When .doug/plan.json lists the card among its `cards` (a batch), the entry
 //                                                 shows only that card's tasks, --cost is that card's tasks' cost, and
 //                                                 --shared-cost <usd> the shared integration agents', counted once
-//   board.mjs record <id> --hand [dir] --summary "<one sentence>" [--commit <sha>] [--wall <text>] [--gate <text>] [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed>] [--cost <usd>]
+//   board.mjs record <id> --hand [dir] --summary "<one sentence>" [--commit <sha>] [--wall <text>] [--gate <text>] [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed> [--rehearsal-fixture <name>]] [--cost <usd>]
 //                                                 append a hand-track entry (no report) for the card
 //   --rehearsal <scenario> (either form) marks the entry as a rehearse.mjs run on the ts-basic fixture (the start scenario: an empty git repo): the first
 //   prose line and the commit sha (abbreviated to 7 characters) read as the fixture's, not this repository's.
@@ -94,8 +94,8 @@ const planUsage = (kind) => [
   `       board.mjs ${kind} edit <id> [dir] [--title <t>] [--goal <g>] [--version <v>] [--date YYYY-MM-DD] [--status planned|active|done] [--force]`,
   `       board.mjs ${kind} list [dir]`,
 ].join("\n");
-const RECORD_HAND_FLAGS = ["summary", "hand", "commit", "wall", "gate", "note", "rehearsal", "rehearsal-outcome", "cost"];
-const RECORD_REPORT_FLAGS = ["summary", "cost", "codex-cost", "wall", "commit", "adversary", "shared-cost", "note", "rehearsal", "rehearsal-outcome", "run", "claude-dir"];
+const RECORD_HAND_FLAGS = ["summary", "hand", "commit", "wall", "gate", "note", "rehearsal", "rehearsal-outcome", "rehearsal-fixture", "cost"];
+const RECORD_REPORT_FLAGS = ["summary", "cost", "codex-cost", "wall", "commit", "adversary", "shared-cost", "note", "rehearsal", "rehearsal-outcome", "rehearsal-fixture", "run", "claude-dir"];
 const opts = {};
 const positional = [];
 for (let i = 0; i < argv.length; i++) {
@@ -131,8 +131,8 @@ const USAGE_FOR = {
   labels: "usage: board.mjs labels --check [dir] | labels init [dir]",
   summary: "usage: board.mjs summary <report.json> --summary \"<one sentence>\" [--cost <usd>] [--codex-cost <usd>] [--wall <text>] [--commit <sha>] [--card <id>] [--run <run-id>] [--claude-dir <dir>] [--note <text>]",
 };
-const RECORD_HAND_USAGE = "usage: board.mjs record <id> --hand [dir] --summary \"<one sentence>\" [--commit <sha>] [--wall <text>] [--gate <text>] [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed>] [--cost <usd>]";
-const RECORD_REPORT_USAGE = "usage: board.mjs record <id> <report.json> [dir] --summary \"<one sentence>\" [--cost <usd>] [--codex-cost <usd>] [--shared-cost <usd>] [--wall <text>] [--commit <sha>] [--adversary \"<id>=<class>[: <reason>]\"]... [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed>] [--run <run-id>] [--claude-dir <dir>]";
+const RECORD_HAND_USAGE = "usage: board.mjs record <id> --hand [dir] --summary \"<one sentence>\" [--commit <sha>] [--wall <text>] [--gate <text>] [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed> [--rehearsal-fixture <name>]] [--cost <usd>]";
+const RECORD_REPORT_USAGE = "usage: board.mjs record <id> <report.json> [dir] --summary \"<one sentence>\" [--cost <usd>] [--codex-cost <usd>] [--shared-cost <usd>] [--wall <text>] [--commit <sha>] [--adversary \"<id>=<class>[: <reason>]\"]... [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed> [--rehearsal-fixture <name>]] [--run <run-id>] [--claude-dir <dir>]";
 
 // An unknown --flag for the given subcommand: exit 2, name the flag and the subcommand's usage.
 // Runs on flag names only (parse order doesn't matter), before any work or write.
@@ -145,7 +145,11 @@ function unknownFlagFor(cmd, opts) {
 }
 
 function dirFrom(args, n) {
-  return resolve(process.env.CLAUDE_PROJECT_DIR || args[n] || process.cwd());
+  const d = resolve(process.env.CLAUDE_PROJECT_DIR || args[n] || process.cwd());
+  if (!existsSync(join(d, ".doug")) && !existsSync(join(d, "docs", "board.json"))) {
+    fail(`not a Doug project: ${d} has no .doug/`, 1);
+  }
+  return d;
 }
 
 if (cmd === "epic" || cmd === "milestone") {
@@ -177,6 +181,7 @@ if (cmd === "record" || cmd === "summary") {
 if (cmd === "record") {
   const ro = opts["rehearsal-outcome"];
   if (opts.rehearsal !== undefined && ro !== "passed" && ro !== "failed") fail(`--rehearsal needs --rehearsal-outcome passed|failed, got ${ro === undefined ? "none" : JSON.stringify(ro)}\n${opts.hand ? RECORD_HAND_USAGE : RECORD_REPORT_USAGE}`, 2);
+  if (opts.rehearsal === undefined && opts["rehearsal-fixture"] !== undefined) fail(`--rehearsal-fixture is only valid with --rehearsal\n${opts.hand ? RECORD_HAND_USAGE : RECORD_REPORT_USAGE}`, 2);
   if (opts.rehearsal === undefined && ro !== undefined) fail(`--rehearsal-outcome is only valid with --rehearsal\n${opts.hand ? RECORD_HAND_USAGE : RECORD_REPORT_USAGE}`, 2);
 }
 
@@ -192,7 +197,8 @@ function landingBlock({ id, ok, commit, wall, gate, cost, codexCost, note, rehea
   const learned = typeof note === "string" && note.trim() ? note.trim().replace(/\s+/g, " ") : "nothing new";
   const lines = [`Changed: ${summarySentence}`, `Outcome: ${outcome}`, `Learned: ${learned}`];
   const words = lines.join("\n").split(/\s+/).filter(Boolean).length;
-  if (words > LANDING_BLOCK_WORDS) fail(`landing block is ${words} words; the limit is ${LANDING_BLOCK_WORDS}. Shorten --summary or --note.`);
+  // A rehearsal's block is print-only (no landing-block files, so the Stop gate checks nothing): no cap, so a failed stage's long note still records.
+  if (!rehearsal && words > LANDING_BLOCK_WORDS) fail(`landing block is ${words} words; the limit is ${LANDING_BLOCK_WORDS}. Shorten --summary or --note.`);
   return lines;
 }
 // The pending marker holds the session that landed, so only that session's Stop checks it (empty when unset).
@@ -212,6 +218,25 @@ function writeLandingBlock(dir, id, lines, keepFile = false, printOnly = false)
   }
   process.stdout.write(lines.join("\n") + "\n");
 }
+// A plan landed after `plan.mjs done --force` (landed set, report not ok, --commit naming the land merge or absent,
+// not a rehearsal) is a landed card whatever the report says; its gate is land's own acceptance. In a batch plan
+// only the entries tagged `[<card>] ` count, or the whole list labelled as the plan's when none carries the tag.
+function forcedLanding({ plan, report, opts, card }) {
+  const lc = plan && plan.landed && typeof plan.landed === "object" ? plan.landed : null;
+  const lm = lc && typeof lc.mergeCommit === "string" ? lc.mergeCommit : "";
+  const forced = report.ok !== true && !opts.rehearsal && lc !== null && (opts.commit === undefined || (lm !== "" && (lm.startsWith(String(opts.commit)) || String(opts.commit).startsWith(lm))));
+  if (!forced) return { forced: false, gate: null };
+  if (!Array.isArray(lc.acceptance)) return { forced, gate: "acceptance checked at land" };
+  const count = (list) => `${list.filter((a) => a && a.ok).length}/${list.length}`;
+  if (plan && Array.isArray(plan.cards) && plan.cards.includes(card)) {
+    const tag = `[${card}] `;
+    const own = lc.acceptance.filter((a) => a && (typeof a === "string" ? a : String(a.text ?? "")).startsWith(tag));
+    if (own.length) return { forced, gate: `acceptance ${count(own)} at land` };
+    return { forced, gate: `acceptance ${count(lc.acceptance)} at land (the plan's)` };
+  }
+  return { forced, gate: `acceptance ${count(lc.acceptance)} at land` };
+}
+
 function acceptanceGate(report) {
   const levels = (report.levels || []).filter((l) => l && l.integration);
   const acc = levels.length && Array.isArray(levels[levels.length - 1].integration.acceptance) ? levels[levels.length - 1].integration.acceptance : [];
@@ -434,11 +459,11 @@ try {
     case "record": {
       if (opts.hand) {
         const [id] = rest;
-        if (!id) fail("usage: board.mjs record <id> --hand [dir] --summary \"<one sentence>\" [--commit <sha>] [--wall <text>] [--gate <text>] [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed>] [--cost <usd>]", 2);
+        if (!id) fail("usage: board.mjs record <id> --hand [dir] --summary \"<one sentence>\" [--commit <sha>] [--wall <text>] [--gate <text>] [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed> [--rehearsal-fixture <name>]] [--cost <usd>]", 2);
         if (opts.cost !== undefined && !/^\d+(\.\d+)?$/.test(opts.cost)) fail(`--cost takes a non-negative number of dollars, got ${JSON.stringify(opts.cost)}`, 2);
         const dir = dirFrom(rest, 1);
         const card = findCard(loadBoard(dir), id);
-        const entry = handEntry({ card, commit: opts.commit ?? null, wallClock: opts.wall ?? null, gate: opts.gate ?? null, note: opts.note ?? null, record: relative(dir, boardPath(dir)), rehearsal: opts.rehearsal ?? null, rehearsalOutcome: opts["rehearsal-outcome"] ?? null, cost: opts.cost !== undefined ? Number(opts.cost) : null });
+        const entry = handEntry({ card, commit: opts.commit ?? null, wallClock: opts.wall ?? null, gate: opts.gate ?? null, note: opts.note ?? null, record: relative(dir, boardPath(dir)), rehearsal: opts.rehearsal ?? null, rehearsalOutcome: opts["rehearsal-outcome"] ?? null, fixture: opts["rehearsal-fixture"] ?? null, cost: opts.cost !== undefined ? Number(opts.cost) : null });
         const block = landingBlock({ id, ok: true, commit: opts.commit, wall: opts.wall, gate: opts.gate, cost: opts.cost, note: opts.note, rehearsal: opts.rehearsal ?? null, rehearsalOutcome: opts["rehearsal-outcome"] ?? null });
         const { file, promoted } = recordLanding(dir, id, entry);
         process.stdout.write(`${summarySentence}\n`);
@@ -452,7 +477,7 @@ try {
         break;
       }
       const [id, reportFile] = rest;
-      if (!id || !reportFile) fail("usage: board.mjs record <id> <report.json> [dir] --summary \"<one sentence>\" [--cost <usd>] [--codex-cost <usd>] [--shared-cost <usd>] [--wall <text>] [--commit <sha>] [--adversary \"<id>=<class>[: <reason>]\"]... [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed>] [--run <run-id>] [--claude-dir <dir>]", 2);
+      if (!id || !reportFile) fail("usage: board.mjs record <id> <report.json> [dir] --summary \"<one sentence>\" [--cost <usd>] [--codex-cost <usd>] [--shared-cost <usd>] [--wall <text>] [--commit <sha>] [--adversary \"<id>=<class>[: <reason>]\"]... [--note <text>] [--rehearsal <scenario> --rehearsal-outcome <passed|failed> [--rehearsal-fixture <name>]] [--run <run-id>] [--claude-dir <dir>]", 2);
       const dir = dirFrom(rest, 2);
       const card = findCard(loadBoard(dir), id);
       const report = unwrapReport(JSON.parse(readFileSync(resolve(reportFile), "utf8")));
@@ -461,8 +486,10 @@ try {
       const batch = plan && Array.isArray(plan.cards) && plan.cards.includes(id) ? plan.cards : null;
       const taskIds = batch ? plan.tasks.filter((t) => t.card === id).map((t) => t.id) : [];
       const wall = opts.run ? wallForRun({ runId: opts.run, claudeDir: opts["claude-dir"], projectDir: dir, wallMinutes: report.budget?.wallMinutes ?? DEFAULT_BUDGET.wallMinutes }) : null;
-      const entry = runEntry({ card, report, wall, cost: opts.cost !== undefined ? Number(opts.cost) : null, codexCost: opts["codex-cost"] !== undefined ? Number(opts["codex-cost"]) : null, wallClock: opts.wall ?? null, mergeCommit: opts.commit ?? null, record: relative(dir, boardPath(dir)), adversary: parseAdversaryClasses(opts.adversary || []), batch, taskIds, sharedCost: opts["shared-cost"] !== undefined ? Number(opts["shared-cost"]) : null, note: opts.note ?? null, rehearsal: opts.rehearsal ?? null, rehearsalOutcome: opts["rehearsal-outcome"] ?? null });
-      const block = landingBlock({ id, ok: report.ok === true, commit: opts.commit, wall: opts.wall, gate: acceptanceGate(report), cost: opts.cost, codexCost: opts["codex-cost"], note: opts.note, rehearsal: opts.rehearsal ?? null, rehearsalOutcome: opts["rehearsal-outcome"] ?? null });
+      // A plan landed after `plan.mjs done --force` is recorded as landed, with land's own acceptance.
+      const { forced, gate: forcedGate } = forcedLanding({ plan, report, opts, card: id });
+      const entry = runEntry({ forcedLanding: forced, card, report, wall, cost: opts.cost !== undefined ? Number(opts.cost) : null, codexCost: opts["codex-cost"] !== undefined ? Number(opts["codex-cost"]) : null, wallClock: opts.wall ?? null, mergeCommit: opts.commit ?? null, record: relative(dir, boardPath(dir)), adversary: parseAdversaryClasses(opts.adversary || []), batch, taskIds, sharedCost: opts["shared-cost"] !== undefined ? Number(opts["shared-cost"]) : null, note: opts.note ?? null, rehearsal: opts.rehearsal ?? null, rehearsalOutcome: opts["rehearsal-outcome"] ?? null, fixture: opts["rehearsal-fixture"] ?? null });
+      const block = landingBlock({ id, ok: report.ok === true || forced, commit: opts.commit, wall: opts.wall, gate: forced ? forcedGate : acceptanceGate(report), cost: opts.cost, codexCost: opts["codex-cost"], note: opts.note, rehearsal: opts.rehearsal ?? null, rehearsalOutcome: opts["rehearsal-outcome"] ?? null });
       const { file, promoted } = recordLanding(dir, id, entry);
       process.stdout.write(`${summarySentence}\n`);
       if (promoted) process.stdout.write(`Promoted the research note for ${id} to ${promoted}.\n`);
@@ -491,9 +518,10 @@ try {
           if (saved.length === 3) sumSaved = saved;
         } catch {}
       }
-      const sumBlock = sumSaved ? sumSaved : opts.card !== undefined ? landingBlock({ id: opts.card, ok: report.ok === true, commit: opts.commit, wall: opts.wall, gate: acceptanceGate(wholeReport), cost: opts.cost, codexCost: opts["codex-cost"], note: opts.note }) : null;
+      const sumForced = opts.card !== undefined ? forcedLanding({ plan: sumPlan, report: wholeReport, opts, card: opts.card }) : { forced: false, gate: null };
+      const sumBlock = sumSaved ? sumSaved : opts.card !== undefined ? landingBlock({ id: opts.card, ok: report.ok === true || sumForced.forced, commit: opts.commit, wall: opts.wall, gate: sumForced.forced ? sumForced.gate : acceptanceGate(wholeReport), cost: opts.cost, codexCost: opts["codex-cost"], note: opts.note }) : null;
       process.stdout.write(`${summarySentence}\n`);
-      process.stdout.write(runSummary({ report, wall, batch: sumBatch, card: opts.card ?? null, cost: opts.cost !== undefined ? Number(opts.cost) : null, codexCost: opts["codex-cost"] !== undefined ? Number(opts["codex-cost"]) : null, wallClock: opts.wall ?? null, mergeCommit: opts.commit ?? null }));
+      process.stdout.write(runSummary({ report, forcedLanding: sumForced.forced, wall, batch: sumBatch, card: opts.card ?? null, cost: opts.cost !== undefined ? Number(opts.cost) : null, codexCost: opts["codex-cost"] !== undefined ? Number(opts["codex-cost"]) : null, wallClock: opts.wall ?? null, mergeCommit: opts.commit ?? null }));
       if (sumBlock) writeLandingBlock(dirFrom(rest, 1), opts.card, sumBlock, sumSaved !== null);
       break;
     }

package/node_modules/@dougharness/flow/scripts/learn.mjs

@@ -43,7 +43,9 @@ for (const a of argv) {
 const [cmd, ...rest] = positional;
 
 function dirFrom(args, n) {
-  return resolve(process.env.CLAUDE_PROJECT_DIR || args[n] || process.cwd());
+  const d = resolve(process.env.CLAUDE_PROJECT_DIR || args[n] || process.cwd());
+  if (!existsSync(join(d, ".doug"))) fail(`not a Doug project: ${d} has no .doug/`, 1);
+  return d;
 }
 
 function readClaudeMd(dir) {
@@ -95,7 +97,7 @@ function readOwnSkills() {
 function signalsText(s) {
   return [
     `outcomes: ${s.outcomes.rows.length} rows, ${s.outcomes.gateFailures} gate failures, blocks real=${s.outcomes.blocksByClass.real} marginal=${s.outcomes.blocksByClass.marginal} false=${s.outcomes.blocksByClass.false}, fixPasses sum=${s.outcomes.fixPasses.sum} max=${s.outcomes.fixPasses.max}, usd sum=${s.outcomes.usd.sum.toFixed(2)} n=${s.outcomes.usd.n}, cards=${Object.keys(s.outcomes.byCard).length}`,
-    `lessons: ${s.lessons.total} total, ${s.lessons.live} live, ${s.lessons.helpful} helpful, ${s.lessons.harmful} harmful, ${s.lessons.stale} stale, ${s.lessons.repeated.length} repeated`,
+    `lessons: ${s.lessons.total} total, ${s.lessons.live} live, ${s.lessons.helpful} helpful, ${s.lessons.harmful} harmful, ${s.lessons.stale} stale, ${s.lessons.pitfalls.length} pitfalls with occurrences`,
     `trace: ${s.trace.files.length} files, ${s.trace.denials.length} denials, ${s.trace.unmatched.length} unmatched (reported only, never a proposal signal), ${s.trace.skills.length} skills invoked, ${s.trace.instructionsLoaded.length} instruction files loaded`,
   ].join("\n");
 }