@hizliemre/horse-code 0.3.0 → 0.3.1

package/dist/{chunk-KAGKX2YT.js → chunk-ZPJP2VH5.js}

@@ -298,7 +298,16 @@ var LOCAL_ONLY = [
   // The graph itself: rebuilt per checkout, inherited by copy, and unmergeable by construction — see above.
   "graphify-out/graph.json",
   // …and the commit it was built at, which describes that local copy and travels with it.
-  "graphify-out/.graph-commit.json"
+  "graphify-out/.graph-commit.json",
+  /**
+   * The AST cache — which this list's own heading has always described and never actually excluded.
+   *
+   * "an AST cache keyed by local mtimes" is the sentence written above these rules, and no rule matched it.
+   * Measured on a real project: 711 files and 7.8 MB sitting untracked and un-ignored, so `git add -A` after
+   * a `/graph build` swept the whole cache into the commit. Keyed by this checkout's mtimes, it is worthless
+   * to anyone else and rebuilt whenever it is missing.
+   */
+  "graphify-out/cache/"
 ];
 var NESTED_CHECKOUTS = [".claude/worktrees/", ".horsecode/worktrees/"];
 function openDirectory(text, dir) {

package/dist/cli.js

@@ -15,31 +15,25 @@ import {
   restoreTerminal,
   runJob,
   sttySane
-} from "./chunk-XYZVZPAY.js";
+} from "./chunk-2WXG35EM.js";
 import "./chunk-M2RKCIGV.js";
 import {
-  CODE_TEAM,
   CliProvider,
-  DEFAULT_COUNCIL,
-  DEFAULT_PROMPTS,
-  DEFAULT_ROLE_SKILLS,
-  PLAN_TEAM,
-  REQUIRED_ROLES,
   RoleFitness,
-  RoleRegistry,
   SHORT_CALL_MS,
-  SPEC_TEAM,
   WorktreeManager,
-  ZAI_MODELS,
   buildCouncilRegistry,
   buildTeamRegistry,
-  cliCatalog,
   mainWorktreeRoot,
-  modelsFor,
   toSlug
-} from "./chunk-UEWVVN5L.js";
+} from "./chunk-27F44PBD.js";
 import "./chunk-QF4MP6BS.js";
-import "./chunk-UGESK765.js";
+import {
+  MAX_CHUNK_CHARS,
+  discover,
+  readFinding
+} from "./chunk-QJYVZPLG.js";
+import "./chunk-UTHLEW5V.js";
 import "./chunk-ZSQ24YDJ.js";
 import {
   parseFrontmatter
@@ -48,58 +42,75 @@ import {
   UNSET_MODEL,
   loadConfig,
   saveSkillSource
-} from "./chunk-EAF22QIG.js";
-import {
-  CLI_KINDS,
-  checkProfile,
-  runLogin
-} from "./chunk-G45RWL7S.js";
+} from "./chunk-JR2JLRE3.js";
 import "./chunk-H2FDGPVW.js";
 import {
+  CODE_TEAM,
+  DEFAULT_COUNCIL,
+  DEFAULT_PROMPTS,
+  DEFAULT_ROLE_SKILLS,
+  PLAN_TEAM,
+  REQUIRED_ROLES,
+  RoleRegistry,
+  SPEC_TEAM,
+  ZAI_MODELS,
   buildBrief,
+  cliCatalog,
   describePlan,
+  modelsFor,
   planFor,
   runTraces,
   traceableFiles
-} from "./chunk-MRZVA5JB.js";
+} from "./chunk-YULQ4URQ.js";
+import {
+  CLI_KINDS,
+  checkProfile,
+  runLogin
+} from "./chunk-G45RWL7S.js";
 import {
   defaultGitRunner
 } from "./chunk-LPQU436C.js";
 import {
   InjectionLog,
   memoryNote
-} from "./chunk-LLL7QWXB.js";
+} from "./chunk-BFIZMM4G.js";
 import "./chunk-63E73TGI.js";
+import {
+  ToolRegistry
+} from "./chunk-CYLPQWIF.js";
+import {
+  briefStatus
+} from "./chunk-6S4WWQMN.js";
 import {
   Telemetry,
-  ToolRegistry,
   clearPerfMarks,
   sampleMemory,
   setTelemetry,
   stripThinking,
   telemetry,
   writeHeapSnapshot
-} from "./chunk-AE36LLL2.js";
-import {
-  briefStatus
-} from "./chunk-6OSEQOYY.js";
+} from "./chunk-JLWQCA7B.js";
 import {
   discoverTraceRoot,
-  setTraceRoot
-} from "./chunk-KAGKX2YT.js";
+  ensureGitignore,
+  localOnly,
+  setTraceRoot,
+  sharedDerived,
+  traceRootRel
+} from "./chunk-ZPJP2VH5.js";
 import {
   buildProjectGraph,
   graphStatus,
   graphifyPython
-} from "./chunk-XEGQT5EN.js";
+} from "./chunk-4M6LXNG2.js";
 import {
   sessionBase
 } from "./chunk-6W4UH2BQ.js";
 
 // src/cli.ts
 import { execFileSync } from "child_process";
-import { readFileSync as readFileSync5, existsSync as existsSync3, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, realpathSync, rmSync } from "fs";
-import { join as join11, dirname as dirname5 } from "path";
+import { readFileSync as readFileSync5, existsSync as existsSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, realpathSync, rmSync, statSync as statSync2 } from "fs";
+import { join as join12, dirname as dirname5 } from "path";
 import { pathToFileURL } from "url";
 
 // src/agents/cli-accounts.ts
@@ -694,6 +705,137 @@ async function syncSkillSources(home, sources, deps = {}) {
   return { ok, failed };
 }
 
+// src/engine/init-project.ts
+import { existsSync as existsSync2, statSync, readdirSync } from "fs";
+import { join as join7 } from "path";
+
+// src/migrate/project-docs.ts
+import { basename } from "path";
+var DERIVED = [
+  { re: /^\.horsecode\//, why: "horse-code's own state \u2014 traces describe the code, so rules mined from them would be the code talking back to itself" },
+  { re: /^graphify-out\//, why: "generated by the graph build" },
+  { re: /(^|\/)(node_modules|vendor|third_party|\.git)\//, why: "not this project's writing" },
+  { re: /(^|\/)\.claude\/worktrees\//, why: "a nested checkout of this repository" }
+];
+var HISTORY = [
+  { re: /(^|\/)archive(d)?\//i, why: "an archive of finished work" },
+  { re: /\d{4}-\d{2}-\d{2}/, why: "dated \u2014 a record of a moment, not a standing rule" },
+  { re: /(^|\/)(HANDOFF|RESUME|CHANGELOG|RELEASE[-_]NOTES)[^/]*$/i, why: "a record of what happened" },
+  { re: /(^|\/)chats?\//i, why: "a pasted conversation" },
+  { re: /(^|\/)chat\d*\.md$/i, why: "a pasted conversation" }
+];
+function sortProjectDocs(files, known = []) {
+  const seen = new Set(known.map((k) => k.replace(/\\/g, "/")));
+  const candidates2 = [];
+  const skipped = [];
+  for (const f of files) {
+    const path = f.path.replace(/\\/g, "/");
+    if (!/\.mdx?$/i.test(path)) continue;
+    if (seen.has(path) || seen.has(basename(path))) continue;
+    const why = DERIVED.find((d) => d.re.test(path))?.why ?? HISTORY.find((h) => h.re.test(path))?.why;
+    if (why) skipped.push({ path, bytes: f.bytes, skipped: why });
+    else candidates2.push({ path, bytes: f.bytes });
+  }
+  const bySize = (a, b) => b.bytes - a.bytes;
+  return { candidates: candidates2.sort(bySize), skipped: skipped.sort(bySize) };
+}
+function totalBytes(docs) {
+  return docs.reduce((n, d) => n + d.bytes, 0);
+}
+function classifyCalls(bytes, chunk) {
+  return Math.max(1, Math.ceil(bytes / chunk));
+}
+
+// src/engine/init-project.ts
+var UNCLAIMED_FILE_FLOOR = 50;
+function countFiles(dir, cap = UNCLAIMED_FILE_FLOOR * 4) {
+  let n = 0;
+  const walk = (d) => {
+    if (n >= cap) return;
+    let entries;
+    try {
+      entries = readdirSync(d, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (n >= cap) return;
+      if (e.isDirectory()) walk(join7(d, e.name));
+      else n++;
+    }
+  };
+  walk(dir);
+  return n;
+}
+async function initProject(cwd, isIgnored, untracked, knowledge) {
+  const changed = await ensureGitignore(cwd);
+  const unclaimed = [];
+  for (const rel of untracked()) {
+    const path = join7(cwd, rel);
+    let dir = false;
+    try {
+      dir = statSync(path).isDirectory();
+    } catch {
+      continue;
+    }
+    if (!dir || isIgnored(rel)) continue;
+    const files = countFiles(path);
+    if (files >= UNCLAIMED_FILE_FLOOR) unclaimed.push({ path: rel, files });
+  }
+  return {
+    changed,
+    kept: [`${traceRootRel().replace(/\\/g, "/")}/`, ...sharedDerived()].filter((p) => existsSync2(join7(cwd, p)) || p.endsWith("/")),
+    excluded: localOnly(),
+    unclaimed: unclaimed.sort((a, b) => b.files - a.files),
+    ...knowledge ? { knowledge } : {}
+  };
+}
+function hasKnowledge(k) {
+  return !!k && (k.named.length > 0 || k.docs.length > 0);
+}
+function size(bytes) {
+  return bytes >= 1024 * 1024 ? `${(bytes / 1024 / 1024).toFixed(1)} MB` : `${Math.max(1, Math.round(bytes / 1024))} KB`;
+}
+function describeKnowledge(k, chunk = MAX_CHUNK_CHARS) {
+  const lines = ["", "**This project already says things about itself.**", ""];
+  if (k.named.length) {
+    lines.push(`Files a tool is known to write \u2014 ${size(totalBytes(k.named.map((n) => ({ path: n.label, bytes: n.bytes }))))}:`);
+    lines.push(...k.named.map((n) => `  \xB7 \`${n.label}\` (${size(n.bytes)})`));
+  }
+  if (k.docs.length) {
+    const bytes = totalBytes(k.docs);
+    lines.push("", `The project's other markdown \u2014 ${k.docs.length} file(s), ${size(bytes)}, about ${classifyCalls(bytes, chunk)} classification call(s):`);
+    lines.push(...k.docs.slice(0, 8).map((d) => `  \xB7 \`${d.path}\` (${size(d.bytes)})`));
+    if (k.docs.length > 8) lines.push(`  \xB7 \u2026and ${k.docs.length - 8} more`);
+  }
+  if (k.skipped.length) {
+    const reasons = /* @__PURE__ */ new Map();
+    for (const sk of k.skipped) reasons.set(sk.skipped ?? "", (reasons.get(sk.skipped ?? "") ?? 0) + 1);
+    lines.push("", `Set aside \u2014 ${k.skipped.length} file(s), ${size(totalBytes(k.skipped))}:`);
+    for (const [why, n] of [...reasons].sort((a, b) => b[1] - a[1])) lines.push(`  \xB7 ${n} \xD7 ${why}`);
+  }
+  return lines.join("\n");
+}
+function describeInit(report) {
+  const lines = [
+    report.changed ? "**Project set up for horse-code** \u2014 `.gitignore` updated." : "**Project is already set up** \u2014 `.gitignore` already says everything needed.",
+    "",
+    "Committed on purpose, because a clone would otherwise pay to produce it again:",
+    ...report.kept.map((p) => `  \xB7 \`${p}\``),
+    "",
+    "Kept out on purpose \u2014 derived from the source, keyed to this checkout, or unmergeable:",
+    ...report.excluded.map((p) => `  \xB7 \`${p}\``)
+  ];
+  if (report.unclaimed.length) {
+    lines.push(
+      "",
+      "Untracked and covered by no rule \u2014 `git add -A` would commit these. Yours to decide:",
+      ...report.unclaimed.map((u) => `  \xB7 \`${u.path}\` (${u.files >= UNCLAIMED_FILE_FLOOR * 4 ? `${u.files}+` : u.files} files)`)
+    );
+  }
+  return lines.join("\n");
+}
+
 // src/permission/rules.ts
 import picomatch from "picomatch";
 var DANGEROUS_PATTERNS = [
@@ -964,8 +1106,8 @@ var ProposalQueue = class {
 };
 
 // src/speckit/templates.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join7, dirname as dirname3 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
+import { join as join8, dirname as dirname3 } from "path";
 var TEMPLATE_FILES = {
   spec: "spec-template.md",
   plan: "plan-template.md",
@@ -988,10 +1130,10 @@ async function loadSpecKit(opts) {
     );
   }
   const fetchFn = opts.fetch ?? globalThis.fetch;
-  const cacheDir = join7(opts.home, ".horsecode", "spec-kit", opts.version, "templates");
+  const cacheDir = join8(opts.home, ".horsecode", "spec-kit", opts.version, "templates");
   const get = async (relPath) => {
-    const cachePath = join7(cacheDir, relPath);
-    if (existsSync2(cachePath)) return readFileSync3(cachePath, "utf8");
+    const cachePath = join8(cacheDir, relPath);
+    if (existsSync3(cachePath)) return readFileSync3(cachePath, "utf8");
     const url = `${RAW_BASE}/${opts.version}/templates/${relPath}`;
     const res = await fetchFn(url);
     if (!res.ok) {
@@ -1018,7 +1160,7 @@ Check your network or set specKit.version to a valid tag.`
 
 // src/wiring.ts
 import { homedir } from "os";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 async function buildJobDeps(opts) {
   const { config } = opts;
   const roles = {};
@@ -1064,7 +1206,7 @@ async function buildJobDeps(opts) {
   const queue = new ProposalQueue();
   let kitPromise;
   const specKit = () => kitPromise ??= loadSpecKit({ version: config.specKit.version, home: opts.home, fetch: opts.fetch });
-  const fitness = new RoleFitness(join8(opts.home ?? homedir(), ".horsecode", "model-fitness.json"));
+  const fitness = new RoleFitness(join9(opts.home ?? homedir(), ".horsecode", "model-fitness.json"));
   roleRegistry.setFitness(fitness);
   return {
     provider: opts.provider,
@@ -1257,9 +1399,9 @@ function redactRecord(record) {
 
 // src/obs/sink.ts
 import { createWriteStream, mkdirSync as mkdirSync4 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 function telemetryDir(home) {
-  return join9(home, ".horsecode", "telemetry");
+  return join10(home, ".horsecode", "telemetry");
 }
 var MAX_QUEUE = 1e4;
 var FileSink = class {
@@ -1268,7 +1410,7 @@ var FileSink = class {
   dropped = 0;
   path;
   constructor(home, runId) {
-    this.path = join9(telemetryDir(home), `${runId}.jsonl`);
+    this.path = join10(telemetryDir(home), `${runId}.jsonl`);
     try {
       mkdirSync4(telemetryDir(home), { recursive: true });
       this.stream = createWriteStream(this.path, { flags: "a" });
@@ -1328,12 +1470,12 @@ var FileSink = class {
 
 // src/cli-info.ts
 import { readFileSync as readFileSync4 } from "fs";
-import { dirname as dirname4, join as join10 } from "path";
+import { dirname as dirname4, join as join11 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function hcodeVersion() {
   try {
     const here = dirname4(fileURLToPath2(import.meta.url));
-    const pkg = JSON.parse(readFileSync4(join10(here, "..", "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync4(join11(here, "..", "package.json"), "utf8"));
     return pkg.version ?? "unknown";
   } catch {
     return "unknown";
@@ -1719,14 +1861,43 @@ async function main(argv) {
   );
   const notSignedIn = ambientLogins.filter((a) => !a.status.loggedIn).map((a) => a.kind);
   const accountsNote = () => accountsLine(accounts.usage(), notSignedIn);
+  const initProjectFn = async () => {
+    const r = await defaultGitRunner(["ls-files", "--others", "--exclude-standard", "--directory"], cwd);
+    const list = r.stdout.split("\n").map((l) => l.trim()).filter(Boolean);
+    const ignored = /* @__PURE__ */ new Set();
+    for (const path of list) {
+      if ((await defaultGitRunner(["check-ignore", "-q", path], cwd)).code === 0) ignored.add(path);
+    }
+    const all = await defaultGitRunner(["ls-files", "--cached", "--others", "--exclude-standard"], cwd);
+    const md = all.stdout.split("\n").map((l) => l.trim()).filter((l) => /\.mdx?$/i.test(l));
+    const withSize = md.map((path) => {
+      try {
+        return { path, bytes: statSync2(join12(cwd, path)).size };
+      } catch {
+        return { path, bytes: 0 };
+      }
+    });
+    const found = await discover({ cwd, home });
+    const named = found.filter((f) => f.kind === "rules" || f.kind === "mcp").map((f) => ({ label: f.label, bytes: f.bytes }));
+    const { candidates: candidates2, skipped } = sortProjectDocs(withSize, found.map((f) => f.label));
+    const knowledge = { named, docs: candidates2, skipped };
+    const report = await initProject(cwd, (path) => ignored.has(path), () => list, knowledge);
+    const canImport = hasKnowledge(knowledge);
+    const extra = [];
+    for (const d of candidates2) {
+      const r2 = await readFinding(join12(cwd, d.path));
+      if (r2?.text) extra.push({ kind: "rules", tool: "project document", path: join12(cwd, d.path), label: d.path, bytes: r2.bytes, own: true, text: r2.text });
+    }
+    return { text: describeInit(report) + (canImport ? describeKnowledge(knowledge) : ""), canImport, extra };
+  };
   const modelsPanelNote = (inUse) => modelsPanel(accounts.usage(), modelsFor, CLI_KINDS, inUse);
   const raw = new CliProvider({ readOnly: false, accounts });
   const provider = config.telemetry ? telemetryProvider(raw, telemetry()) : raw;
   const skillRegistry = new SkillRegistry();
   await registerBuiltinSkills(skillRegistry);
   await skillRegistry.loadFromDir(externalSkillsDir(home));
-  const skillsDir = join11(cwd, ".horsecode", "skills");
-  if (existsSync3(skillsDir)) await skillRegistry.loadFromDir(skillsDir);
+  const skillsDir = join12(cwd, ".horsecode", "skills");
+  if (existsSync4(skillsDir)) await skillRegistry.loadFromDir(skillsDir);
   const worktreeHome = await mainWorktreeRoot(defaultGitRunner, cwd);
   if (worktreeHome !== cwd) {
     console.log(`\u2139\uFE0F  Sessions will be opened in ${worktreeHome} \u2014 the repository's main checkout.`);
@@ -1758,7 +1929,7 @@ async function main(argv) {
   const useTui = shouldUseTui(!!process.stdin.isTTY, !!process.stdout.isTTY, !!args.noTui);
   if (!args.prompt) {
     if (useTui) {
-      const { runTuiRepl } = await import("./app-5FXHE7GX.js");
+      const { runTuiRepl } = await import("./app-4WN37LZ3.js");
       const { fetchCatalog, makeProbe, discoverSources } = await import("./discover-G2Z6XC3O.js");
       const { loadSourceCache, saveSourceCache } = await import("./source-cache-XEK5WN7I.js");
       const manualSources = config.modelSources.length > 0;
@@ -1809,8 +1980,8 @@ _Expected something like \`https://github.com/owner/repo\` or a link to the dire
 _Discoverable by every agent. \`/roles adjust\` assigns it to the roles it fits; \`/skills update\` re-installs it from upstream._`;
       };
       const reloadProjectSkills = async () => {
-        const dir = join11(cwd, ".horsecode", "skills");
-        if (existsSync3(dir)) await skillRegistry.loadFromDir(dir);
+        const dir = join12(cwd, ".horsecode", "skills");
+        if (existsSync4(dir)) await skillRegistry.loadFromDir(dir);
       };
       const updateSkills = async () => {
         if (!config.skillSources.length) {
@@ -1829,7 +2000,7 @@ _Discoverable by every agent. \`/roles adjust\` assigns it to the roles it fits;
 ${lines.join("\n")}${tail}`;
       };
       const graphStatusText = async () => {
-        const st = await graphStatus(cwd);
+        const st = await graphStatus((await derivedWorkdir(false)).dir);
         if (!st.built) {
           const py = await graphifyPython();
           return py ? "No code graph yet. `/graph build` \u2014 AST parsing only, no tokens, a few seconds.\n\n_Without it every agent works blind: it can grep for a name but cannot tell what calls it._" : "No code graph, and graphify is not installed.\n\n`uv tool install graphifyy` (or `pipx install graphifyy`), then `/graph build`.\n\n_MIT, pure tree-sitter AST parsing \u2014 no API key, no tokens._";
@@ -1848,7 +2019,7 @@ ${lines.join("\n")}${tail}`;
 
 _Every agent can query it: \`graph_impact\` (blast radius), \`graph_trace\`, \`graph_find\`, \`graph_context\`, \`graph_overview\`._`;
       };
-      const buildGraphText = async () => (await buildProjectGraph(cwd)).message;
+      const buildGraphText = async () => (await buildProjectGraph((await derivedWorkdir(true)).dir)).message;
       const cleanWorktreesText = async (apply, branch) => {
         const { surveySessions, cleanSessions, describeSurvey, describeClean } = await import("./clean-YOQATBMZ.js");
         const target = branch?.trim() || fromBranch;
@@ -1858,31 +2029,42 @@ _Every agent can query it: \`graph_impact\` (blast radius), \`graph_trace\`, \`g
         return describeClean(await cleanSessions(defaultGitRunner, cwd, target), target);
       };
       const gitFiles = async () => (await defaultGitRunner(["ls-files", "--cached", "--others", "--exclude-standard"], cwd)).stdout.split("\n").filter(Boolean);
-      const traceableDocs = async () => traceableFiles(cwd, { code: false });
-      const traceableFiles2 = async () => traceableFiles(cwd);
-      const tracerModel = () => {
+      const traceableDocs = async (dir = cwd) => traceableFiles(dir, { code: false });
+      const traceableFiles2 = async (dir = cwd) => traceableFiles(dir);
+      const tracerChain = () => {
         for (const role of ["tracer", "architect", "senior-coder", "judge"]) {
-          const m = config.roles[role]?.models[0];
-          if (m && m !== "default") return m;
+          const chain = (config.roles[role]?.models ?? []).filter((m) => m && m !== "default");
+          if (chain.length) return chain;
         }
-        return config.model;
+        return [config.model];
+      };
+      const derivedWorkdir = async (create) => {
+        const inSession = sessionBase(cwd);
+        if (inSession) return { dir: inSession };
+        const standing = join12(cwd, ".horsecode", "worktrees", "traces", "base");
+        if (!create) return { dir: existsSync4(standing) ? standing : cwd };
+        const session = await manager.openFixed(fromBranch, "traces");
+        return { dir: session.baseWorktree, session };
       };
       const planTracesFn = async () => {
-        const plan = await planFor(cwd, await traceableFiles2());
-        return { summary: describePlan(plan, tracerModel()), jobs: plan.jobs.length };
+        const { dir } = await derivedWorkdir(false);
+        const plan = await planFor(dir, await traceableFiles2(dir));
+        return { summary: describePlan(plan, tracerChain()), jobs: plan.jobs.length };
       };
       const runTracesFn = async (onProgress, metered) => {
-        const files = await traceableFiles2();
-        const brief = await buildBrief({ cwd, provider: metered ?? provider, model: tracerModel(), files: await traceableDocs() });
-        const plan = await planFor(cwd, files);
+        const { dir, session } = await derivedWorkdir(true);
+        const files = await traceableFiles2(dir);
+        const brief = await buildBrief({ cwd: dir, provider: metered ?? provider, models: tracerChain(), files: await traceableDocs(dir) });
+        const plan = await planFor(dir, files);
         const res = await runTraces({
-          cwd,
+          cwd: dir,
           provider: metered ?? provider,
-          model: tracerModel(),
+          models: tracerChain(),
           plan,
           liveFiles: new Set(files),
           ...onProgress ? { onProgress } : {}
         });
+        if (session) await manager.preserveSession(session, `docs(traces): ${res.written} file(s) described`);
         const bits = [`${brief.message}
 
 **Traces written: ${res.written}**`];
@@ -1890,9 +2072,13 @@ _Every agent can query it: \`graph_impact\` (blast radius), \`graph_trace\`, \`g
         if (res.pruned.length) bits.push(`${res.pruned.length} removed for deleted files`);
         if (res.wroteGitignore) bits.push("\n\n_Added .gitignore rules: traces are committed, the AST cache is not._");
         const failures = describeTraceFailures(res.failed);
+        const landed = session ? `
+
+_Written and committed on \`${session.baseBranch}\`, so your working tree is untouched._
+_Bring them in with \`git merge ${session.baseBranch}\`, or browse them at \`${session.baseWorktree}\`._` : "\n\n_Written in this session's worktree, on its own branch._";
         return `${bits.join(" \xB7 ")}${failures ? `
 
-${failures}` : ""}
+${failures}` : ""}${landed}
 
 _Committed with the repo, so every clone starts with them. Agents read one with \`graph_trace\`._`;
       };
@@ -1901,11 +2087,13 @@ _Committed with the repo, so every clone starts with them. Agents read one with
         memStore,
         accountsNote,
         modelsPanel: modelsPanelNote,
+        initProject: initProjectFn,
         listSkills,
         updateSkills,
         addSkill,
         reloadProjectSkills,
         graphStatus: graphStatusText,
+        derivedDir: async () => (await derivedWorkdir(true)).dir,
         buildGraph: buildGraphText,
         cleanWorktrees: cleanWorktreesText,
         planTraces: planTracesFn,
@@ -1938,7 +2126,7 @@ _Committed with the repo, so every clone starts with them. Agents read one with
     ...args.revisionRounds !== void 0 && { revisionRounds: args.revisionRounds }
   };
   if (useTui) {
-    const { runTui } = await import("./app-5FXHE7GX.js");
+    const { runTui } = await import("./app-4WN37LZ3.js");
     const res = await runTui({ buildDeps, job });
     console.log(renderResult(res));
     return;

package/dist/{fix-ONLA45HD.js → fix-QCL5AITT.js}

@@ -8,18 +8,19 @@ import {
   dirtyPaths,
   runFix,
   runSmallChange
-} from "./chunk-YPZP7LYL.js";
-import "./chunk-UEWVVN5L.js";
+} from "./chunk-3ACDNDCG.js";
+import "./chunk-27F44PBD.js";
 import "./chunk-ZSQ24YDJ.js";
+import "./chunk-YULQ4URQ.js";
 import "./chunk-G45RWL7S.js";
-import "./chunk-MRZVA5JB.js";
 import "./chunk-LPQU436C.js";
-import "./chunk-LLL7QWXB.js";
+import "./chunk-BFIZMM4G.js";
 import "./chunk-63E73TGI.js";
-import "./chunk-AE36LLL2.js";
-import "./chunk-6OSEQOYY.js";
-import "./chunk-KAGKX2YT.js";
-import "./chunk-XEGQT5EN.js";
+import "./chunk-CYLPQWIF.js";
+import "./chunk-6S4WWQMN.js";
+import "./chunk-JLWQCA7B.js";
+import "./chunk-ZPJP2VH5.js";
+import "./chunk-4M6LXNG2.js";
 import "./chunk-6W4UH2BQ.js";
 export {
   FIX_ATTEMPTS,

package/dist/{ongoing-WHYXPW24.js → ongoing-6NUSPSCV.js}

@@ -3,12 +3,13 @@ import {
 } from "./chunk-YBWTCXUS.js";
 import {
   askInUserLanguage
-} from "./chunk-UGESK765.js";
+} from "./chunk-UTHLEW5V.js";
 import {
   checkpointMtime,
   readCheckpoint
 } from "./chunk-ZSQ24YDJ.js";
-import "./chunk-AE36LLL2.js";
+import "./chunk-CYLPQWIF.js";
+import "./chunk-JLWQCA7B.js";
 import "./chunk-6W4UH2BQ.js";
 
 // src/engine/ongoing.ts

package/dist/{project-graph-5HNPRFQG.js → project-graph-OGIM2B33.js}

@@ -24,7 +24,7 @@ import {
   pruneTooling,
   readStamp,
   stampPath
-} from "./chunk-XEGQT5EN.js";
+} from "./chunk-4M6LXNG2.js";
 import "./chunk-6W4UH2BQ.js";
 export {
   BUILD_IDLE_TIMEOUT_MS,