flavor-code 1.3.12 → 1.3.15

package/dist/desktop/main.js

@@ -4227,7 +4227,7 @@ ${summarizeReport(report2)}`).join("\n\n")
 import { readFile as readFile27 } from "fs/promises";
 import { createHash as createHash21, randomUUID as randomUUID25 } from "crypto";
 import { homedir as homedir2, release as osRelease, tmpdir as tmpdir4, version as osVersion } from "os";
-import { basename as basename8, join as join32, relative as relative23, resolve as resolve32, sep as sep23 } from "path";
+import { basename as basename8, join as join33, relative as relative23, resolve as resolve33, sep as sep23 } from "path";
 
 // src/agent/subagents.ts
 import { z as z10 } from "zod";
@@ -19684,6 +19684,232 @@ function formatReviewReport(report) {
   return lines.join("\n");
 }
 
+// src/explain/service.ts
+async function resolveExplainTarget(graph, query) {
+  const trimmed = query.trim();
+  if (trimmed.includes("#")) {
+    const hit = await graph.relations(trimmed).catch(() => void 0);
+    if (hit?.origin !== void 0) return { kind: "resolved", node: hit.origin };
+  }
+  const hits = await graph.search(trimmed, 10);
+  if (hits.length === 0) return { kind: "not-found", query: trimmed };
+  if (hits.length === 1) return { kind: "resolved", node: hits[0] };
+  return { kind: "ambiguous", candidates: hits };
+}
+function explainCandidateLabel(candidate) {
+  return candidate.id;
+}
+async function selectExplainCandidate(candidates, questions, signal) {
+  const shown = candidates.slice(0, 3);
+  const answers = await questions.ask([{
+    header: "Symbol",
+    question: "Multiple symbols match. Which one should /explain cover? (Pick one, or type a more exact name.)",
+    options: [
+      ...shown.map((candidate) => ({
+        label: explainCandidateLabel(candidate),
+        description: `${candidate.kind} \xB7 ${candidate.filePath}:${candidate.startLine}-${candidate.endLine}`
+      })),
+      { label: "Cancel", description: "Abort /explain without choosing." }
+    ]
+  }], signal);
+  const answer = (answers[0] ?? "").trim();
+  if (answer === "Cancel" || answer === "") return { kind: "cancelled" };
+  const picked = shown.find((candidate) => explainCandidateLabel(candidate) === answer);
+  if (picked !== void 0) return { kind: "picked", node: picked };
+  return { kind: "typed", query: answer };
+}
+var MAX_SOURCE_CHARS = 2e4;
+function buildExplainPrompt(input) {
+  const source = input.anchorSource.length > MAX_SOURCE_CHARS ? `${input.anchorSource.slice(0, MAX_SOURCE_CHARS)}
+\u2026 (truncated)` : input.anchorSource;
+  const line = (n) => `- ${n.name} \u2014 ${n.filePath}:${n.startLine}`;
+  return [
+    "You are a senior engineer onboarding a new team member. Explain the following code symbol clearly and concretely; never invent behavior that is not in the shown evidence.",
+    `Answer in ${input.language}.`,
+    "Structure the answer with short markdown sections:",
+    "1. \u5B83\u662F\u505A\u4EC0\u4E48\u7684 \u2014 one paragraph, plain language, beginner first.",
+    "2. \u5173\u952E\u5B9E\u73B0\u70B9 \u2014 2-5 bullets tied to concrete lines/branches in the source.",
+    "3. \u8C01\u8C03\u7528\u5B83 / \u5B83\u8C03\u7528\u8C01 \u2014 use the relation lists; explain the data flow in one or two sentences.",
+    "4. \u4E3A\u4EC0\u4E48\u8FD9\u6837\u5199 \u2014 infer from the recent commit subjects when possible; say '\u4E0D\u786E\u5B9A' instead of guessing.",
+    "5. \u65B0\u4EBA\u6CE8\u610F\u4E8B\u9879 \u2014 pitfalls, guards or invariants worth knowing.",
+    ...input.focus === void 0 || input.focus.trim() === "" ? [] : [`The user specifically asks about: ${input.focus.trim()}`],
+    "",
+    `Symbol: ${input.anchor.id} (${input.anchor.kind}${input.anchor.signature ? `, signature: ${input.anchor.signature}` : ""})`,
+    "",
+    `Source (${input.anchor.filePath}:${input.anchor.startLine}-${input.anchor.endLine}):`,
+    source,
+    "",
+    `Callers:
+${input.callers.map(line).join("\n") || "- (none)"}`,
+    `Callees:
+${input.callees.map(line).join("\n") || "- (none)"}`,
+    "",
+    `Recent commits touching the file:
+${input.history.map((h) => `- ${h.date} ${h.author}: ${h.subject}`).join("\n") || "- (no history)"}`
+  ].join("\n");
+}
+async function explainWithModel(options, prompt, signal, onText) {
+  const { adapter, model } = options.registry.get(options.modelId());
+  let text = "";
+  for await (const event of adapter.stream({
+    model,
+    messages: [{ role: "user", content: prompt }],
+    tools: [],
+    signal
+  })) {
+    if (event.type === "text") {
+      text += event.text;
+      onText?.(event.text);
+    } else if (event.type === "error") throw new Error(`explain generation failed: ${event.error.message}`);
+    else if (event.type === "done") break;
+  }
+  const cleaned = text.trim();
+  if (cleaned === "") throw new Error("explain generation returned no text");
+  return cleaned;
+}
+var HISTORY_LIMIT = 8;
+var MAX_RESOLVE_ROUNDS = 2;
+async function runExplain(deps, query, focus, signal) {
+  if (query === void 0) {
+    return "Usage: /explain <symbol | file.ts#symbol> [what to focus on]. Example: /explain src/order.ts#cancelOrder error handling";
+  }
+  if (!(await deps.graph.status()).available) {
+    return "The code graph is not built yet \u2014 run /ast init, then try /explain again.";
+  }
+  let target = await resolveExplainTarget(deps.graph, query);
+  for (let round = 1; round <= MAX_RESOLVE_ROUNDS; round += 1) {
+    if (target.kind !== "ambiguous") break;
+    if (deps.questions === void 0) {
+      return `"${query}" is ambiguous. Use the exact node id, e.g. /explain ${target.candidates[0]?.id ?? "path/file.ts#name"}.`;
+    }
+    const selection = await selectExplainCandidate(target.candidates, deps.questions, signal);
+    if (selection.kind === "cancelled") return "/explain cancelled \u2014 no symbol was selected.";
+    if (selection.kind === "picked") {
+      target = { kind: "resolved", node: selection.node };
+      break;
+    }
+    target = await resolveExplainTarget(deps.graph, selection.query);
+    if (round === MAX_RESOLVE_ROUNDS && target.kind === "ambiguous") {
+      return `"${selection.query}" is still ambiguous. Pick one node id explicitly: /explain ${target.candidates[0]?.id ?? "path/file.ts#name"}`;
+    }
+  }
+  if (target.kind === "not-found") {
+    return `No matching symbol for "${target.query}" \u2014 check the name, or refresh the graph with /ast sync.`;
+  }
+  if (target.kind !== "resolved") {
+    return `"${query}" is ambiguous. Pick one node id explicitly: /explain ${target.candidates[0]?.id ?? "path/file.ts#name"}`;
+  }
+  const anchor = target.node;
+  signal.throwIfAborted();
+  deps.notify?.(`Explaining ${anchor.id} \u2026`);
+  const { callers, callees } = await deps.graph.relations(anchor.id, 1);
+  const raw = await deps.readFile(anchor.filePath).catch(() => "");
+  const lines = raw.split("\n");
+  const anchorSource = lines.slice(Math.max(0, anchor.startLine - 1), anchor.endLine).join("\n") || raw;
+  const history = deps.history === void 0 ? [] : await deps.history(anchor.filePath, HISTORY_LIMIT).catch(() => []);
+  try {
+    if (deps.onText !== void 0) deps.onText(`Explain ${anchor.id}
+
+`);
+    const explanation = await explainWithModel(
+      { registry: deps.registry, modelId: deps.modelId },
+      buildExplainPrompt({
+        anchor,
+        anchorSource,
+        callers: callers.map((n) => ({ name: n.name, filePath: n.filePath, startLine: n.startLine })),
+        callees: callees.map((n) => ({ name: n.name, filePath: n.filePath, startLine: n.startLine })),
+        history,
+        ...focus === void 0 ? {} : { focus },
+        language: deps.language
+      }),
+      signal,
+      deps.onText
+    );
+    return deps.onText === void 0 ? `Explain ${anchor.id}
+
+${explanation}` : "";
+  } catch (error) {
+    if (signal.aborted) throw error;
+    return `/explain failed: ${error instanceof Error ? error.message : String(error)}`;
+  }
+}
+
+// src/desktop/astgraph-service.ts
+import { stat as stat10 } from "fs/promises";
+import { createRequire as nodeCreateRequire } from "module";
+import { join as join27, resolve as resolve26 } from "path";
+var FIELDS = "id, kind, name, qualified_name, file_path, language, start_line, end_line, signature";
+var DesktopAstGraphService = class {
+  #path;
+  constructor(workspace) {
+    this.#path = join27(resolve26(workspace), ".flavor", "astgraph", "index.db");
+  }
+  async status() {
+    if ((await stat10(this.#path).catch(() => void 0))?.isFile() !== true) {
+      return { available: false, path: this.#path, files: 0, nodes: 0, edges: 0 };
+    }
+    return this.#read((db) => {
+      const count = (table) => Number(db.prepare(`SELECT COUNT(*) AS count FROM ${table}`).get().count);
+      const metadata = db.prepare("SELECT value FROM project_metadata WHERE key = 'last_index'").get();
+      let indexedAt;
+      try {
+        const at = Number(JSON.parse(metadata?.value ?? "{}").at);
+        if (Number.isFinite(at)) indexedAt = new Date(at).toISOString();
+      } catch {
+      }
+      return { available: true, path: this.#path, files: count("files"), nodes: count("nodes"), edges: count("edges"), ...indexedAt === void 0 ? {} : { indexedAt } };
+    });
+  }
+  async search(query, limit = 40) {
+    const value = query.trim().slice(0, 200);
+    if (value.length === 0 || !(await this.status()).available) return [];
+    return this.#read((db) => db.prepare(`SELECT ${FIELDS} FROM nodes WHERE lower(name) LIKE ? OR lower(qualified_name) LIKE ? ORDER BY CASE WHEN lower(name) = ? THEN 0 ELSE 1 END, name LIMIT ?`).all(`%${value.toLowerCase()}%`, `%${value.toLowerCase()}%`, value.toLowerCase(), Math.min(Math.max(limit, 1), 100)).map(mapNode));
+  }
+  async relations(id, hops = 2) {
+    if (!/^[A-Za-z0-9._:/#@+~-]{1,512}$/.test(id)) throw new Error("Invalid AST node id");
+    if (!(await this.status()).available) return { callers: [], callees: [], impact: [] };
+    return this.#read((db) => {
+      const originRow = db.prepare(`SELECT ${FIELDS} FROM nodes WHERE id = ?`).get(id);
+      const linked = (direction) => {
+        const source = direction === "callers" ? "e.source" : "e.target";
+        const predicate = direction === "callers" ? "e.target = ?" : "e.source = ?";
+        return db.prepare(`SELECT DISTINCT n.${FIELDS.split(", ").join(", n.")} FROM edges e JOIN nodes n ON n.id = ${source} WHERE ${predicate} AND e.kind IN ('calls','imports') LIMIT 100`).all(id).map(mapNode);
+      };
+      const seen = /* @__PURE__ */ new Map();
+      let frontier = [id];
+      for (let hop = 1; hop <= Math.min(Math.max(hops, 1), 4) && frontier.length > 0 && seen.size < 200; hop += 1) {
+        const next = [];
+        for (const current of frontier) {
+          const rows = db.prepare("SELECT source AS other FROM edges WHERE target = ? UNION SELECT target AS other FROM edges WHERE source = ? LIMIT 200").all(current, current);
+          for (const row of rows) if (row.other !== id && !seen.has(row.other)) {
+            seen.set(row.other, hop);
+            next.push(row.other);
+          }
+        }
+        frontier = next;
+      }
+      const impact = [...seen].flatMap(([nodeId, hop]) => {
+        const row = db.prepare(`SELECT ${FIELDS} FROM nodes WHERE id = ?`).get(nodeId);
+        return row === void 0 ? [] : [{ ...mapNode(row), hop }];
+      });
+      return { ...originRow === void 0 ? {} : { origin: mapNode(originRow) }, callers: linked("callers"), callees: linked("callees"), impact };
+    });
+  }
+  #read(run) {
+    const sqlite = nodeCreateRequire(import.meta.url)("node:sqlite");
+    const db = new sqlite.DatabaseSync(this.#path, { readOnly: true });
+    try {
+      return run(db);
+    } finally {
+      db.close();
+    }
+  }
+};
+function mapNode(value) {
+  const row = value;
+  return { id: String(row.id), kind: String(row.kind), name: String(row.name), qualifiedName: String(row.qualified_name), filePath: String(row.file_path), language: String(row.language), startLine: Number(row.start_line), endLine: Number(row.end_line), ...row.signature == null ? {} : { signature: String(row.signature) } };
+}
+
 // src/git/tools.ts
 import { z as z34 } from "zod";
 var GitHistoryInput = z34.object({
@@ -19885,7 +20111,7 @@ function createTodoWriteTool() {
 // src/tools/managed.ts
 import { randomUUID as randomUUID18 } from "crypto";
 import { link, lstat as lstat11, mkdir as mkdir20, readFile as readFile22, readdir as readdir9, unlink as unlink3, writeFile as writeFile12 } from "fs/promises";
-import { dirname as dirname21, join as join27, resolve as resolve26 } from "path";
+import { dirname as dirname21, join as join28, resolve as resolve27 } from "path";
 import { z as z37 } from "zod";
 var MANAGED_TOOL_VERSION = 1;
 var MAX_RECORD_BYTES = 256 * 1024;
@@ -19927,9 +20153,9 @@ var ManagedToolStore = class {
   #entries = /* @__PURE__ */ new Map();
   #diagnostics = [];
   constructor(options) {
-    this.#workspace = resolve26(options.workspace);
-    this.#projectRoot = join27(this.#workspace, ".flavor", "tools");
-    this.#globalRoot = join27(resolve26(options.home), ".flavor-code", "tools");
+    this.#workspace = resolve27(options.workspace);
+    this.#projectRoot = join28(this.#workspace, ".flavor", "tools");
+    this.#globalRoot = join28(resolve27(options.home), ".flavor-code", "tools");
     this.#now = options.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
   }
   get diagnostics() {
@@ -19976,7 +20202,7 @@ var ManagedToolStore = class {
       version: MANAGED_TOOL_VERSION,
       createdAt: this.#now()
     });
-    const path = join27(this.directory(input.scope), filename(input.name));
+    const path = join28(this.directory(input.scope), filename(input.name));
     const definition = compileDefinition(record3, input.scope, this.#workspace);
     await writeExclusive(path, `${JSON.stringify(record3, void 0, 2)}
 `);
@@ -20001,7 +20227,7 @@ var ManagedToolStore = class {
     if (!parsed.success) return [];
     const matches = this.#matching(parsed.data.name).filter((entry2) => parsed.data.scope === void 0 || entry2.scope === parsed.data.scope);
     if (matches.length > 0) return matches.map((entry2) => entry2.path);
-    return [join27(this.directory(parsed.data.scope ?? "project"), filename(parsed.data.name))];
+    return [join28(this.directory(parsed.data.scope ?? "project"), filename(parsed.data.name))];
   }
   async #loadDirectory(scope2) {
     const root = this.directory(scope2);
@@ -20014,7 +20240,7 @@ var ManagedToolStore = class {
       return;
     }
     for (const name of names) {
-      const path = join27(root, name);
+      const path = join28(root, name);
       try {
         const info = await lstat11(path);
         if (!info.isFile() || info.isSymbolicLink()) throw new Error("Managed tool record must be a regular file");
@@ -20603,6 +20829,7 @@ var MVP_COMMANDS = [
   "mcp",
   "commit",
   "review",
+  "explain",
   "ide",
   "memory",
   "remember",
@@ -20678,6 +20905,12 @@ function parseSlashCommand(input, dynamicCommands = [], skillCommands = [], mana
     const focus = args.join(" ").trim();
     return focus.length === 0 ? { name } : { name, focus };
   }
+  if (name === "explain") {
+    const [query, ...focusParts] = args;
+    if (query === void 0) return { name };
+    const focus = focusParts.join(" ").trim();
+    return focus.length === 0 ? { name, query } : { name, query, focus };
+  }
   if (name === "loop") {
     const goal = args.join(" ").trim();
     if (!goal) return { name: "invalid", command: name, message: "Use /loop <goal>." };
@@ -21281,6 +21514,14 @@ var FlavorSession = class {
       this.#notice(await required(this.#services.gitCommit, "commit")(command.hint, signal));
     } else if (command.name === "review") {
       this.#notice(await required(this.#services.gitReview, "review")(command.focus, signal));
+    } else if (command.name === "explain") {
+      const result = await required(this.#services.explain, "explain")(
+        command.query,
+        command.focus,
+        signal,
+        (chunk) => this.#services.output({ type: "text", text: chunk })
+      );
+      if (result !== "") this.#notice(result);
     } else if (command.name === "mcp") {
       this.#notice(await this.#services.mcp(command, signal));
     } else if (command.name === "pals") {
@@ -22317,7 +22558,7 @@ ${total}`;
 // src/memory/store.ts
 import { createHash as createHash17 } from "crypto";
 import { readFile as readFile23, rm as rm12 } from "fs/promises";
-import { resolve as resolve27, join as join28, relative as relative19, sep as sep19 } from "path";
+import { resolve as resolve28, join as join29, relative as relative19, sep as sep19 } from "path";
 
 // src/memory/similarity.ts
 function normalizeForSimilarity(value) {
@@ -22419,10 +22660,10 @@ var MemoryStore = class {
   constructor(options) {
     if (!Number.isSafeInteger(options.maxEntries) || options.maxEntries < 1) throw new Error("maxEntries must be an integer of at least 1");
     if (!Number.isSafeInteger(options.maxEntryChars) || options.maxEntryChars < 1) throw new Error("maxEntryChars must be an integer of at least 1");
-    this.workspace = resolve27(options.workspace);
-    this.#memoryRoot = join28(this.workspace, ".flavor", "memory");
-    this.path = join28(this.#memoryRoot, "MEMORY.md");
-    this.#behaviorPath = join28(this.#memoryRoot, "behavior.json");
+    this.workspace = resolve28(options.workspace);
+    this.#memoryRoot = join29(this.workspace, ".flavor", "memory");
+    this.path = join29(this.#memoryRoot, "MEMORY.md");
+    this.#behaviorPath = join29(this.#memoryRoot, "behavior.json");
     this.#maxEntries = options.maxEntries;
     this.#maxEntryChars = options.maxEntryChars;
   }
@@ -22645,7 +22886,7 @@ var MemoryStore = class {
   }
   #resolveContentPath(contentPath) {
     if (!/^tasks\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\.md$/.test(contentPath)) throw new Error("Invalid memory content path");
-    const path = resolve27(this.#memoryRoot, ...contentPath.split("/"));
+    const path = resolve28(this.#memoryRoot, ...contentPath.split("/"));
     const rel = relative19(this.#memoryRoot, path);
     if (rel === ".." || rel.startsWith(`..${sep19}`)) throw new Error("Memory content path escapes the memory directory");
     return path;
@@ -23105,12 +23346,12 @@ var MemoryReviewBridge = class {
 
 // src/execution/docker.ts
 import { spawn as spawn6 } from "child_process";
-import { relative as relative20, resolve as resolve28, sep as sep20, win32 } from "path";
+import { relative as relative20, resolve as resolve29, sep as sep20, win32 } from "path";
 function buildDockerInvocation(options) {
   const workspace = options.workspace;
   const cwd = options.request.cwd;
   const windows = /^[A-Za-z]:[\\/]/.test(workspace);
-  const delta = windows ? win32.relative(workspace, cwd) : relative20(resolve28(workspace), resolve28(cwd));
+  const delta = windows ? win32.relative(workspace, cwd) : relative20(resolve29(workspace), resolve29(cwd));
   if (delta === ".." || delta.startsWith(`..${windows ? "\\" : sep20}`)) throw new Error("Docker cwd escapes workspace");
   const containerCwd = delta.length === 0 ? "/workspace" : `/workspace/${delta.replaceAll("\\", "/")}`;
   const args = [
@@ -23210,8 +23451,8 @@ function createExecutionEnvironment(workspace, config) {
 }
 
 // src/ide/client.ts
-import { readFile as readFile24, readdir as readdir10, stat as stat10 } from "fs/promises";
-import { basename as basename7, join as join29, relative as relative21, resolve as resolve29, sep as sep21 } from "path";
+import { readFile as readFile24, readdir as readdir10, stat as stat11 } from "fs/promises";
+import { basename as basename7, join as join30, relative as relative21, resolve as resolve30, sep as sep21 } from "path";
 var FlavorIdeClient = class {
   #workspace;
   #home;
@@ -23222,8 +23463,8 @@ var FlavorIdeClient = class {
   #sessionId;
   #eventTail = Promise.resolve();
   constructor(options) {
-    this.#workspace = resolve29(options.workspace);
-    this.#home = resolve29(options.home);
+    this.#workspace = resolve30(options.workspace);
+    this.#home = resolve30(options.home);
     this.#environment = options.environment ?? process.env;
     this.#fetch = options.fetch ?? fetch;
   }
@@ -23307,7 +23548,7 @@ var FlavorIdeClient = class {
       };
       if (await this.#healthy(configured)) return configured;
     }
-    const directory = join29(this.#home, ".flavor-code", "ide");
+    const directory = join30(this.#home, ".flavor-code", "ide");
     let entries;
     try {
       entries = (await readdir10(directory)).filter((name) => name.endsWith(".lock"));
@@ -23315,9 +23556,9 @@ var FlavorIdeClient = class {
       return void 0;
     }
     const candidates = (await Promise.all(entries.map(async (name) => {
-      const path = join29(directory, name);
+      const path = join30(directory, name);
       try {
-        const [contents, info] = await Promise.all([readFile24(path, "utf8"), stat10(path)]);
+        const [contents, info] = await Promise.all([readFile24(path, "utf8"), stat11(path)]);
         const lock = parseLockfile(contents);
         return lock === void 0 ? void 0 : { lock, modified: info.mtimeMs };
       } catch {
@@ -23421,8 +23662,8 @@ function parsePort(value) {
   return Number.isInteger(port2) && port2 > 0 && port2 <= 65535 ? port2 : void 0;
 }
 function isWithin8(parent, child) {
-  const base = normalize(resolve29(parent));
-  const target = normalize(resolve29(child));
+  const base = normalize(resolve30(parent));
+  const target = normalize(resolve30(child));
   return target === base || target.startsWith(`${base}${sep21}`);
 }
 function normalize(path) {
@@ -23576,8 +23817,8 @@ function snapshot2(job) {
 
 // src/terminal/service.ts
 import { randomUUID as randomUUID20 } from "crypto";
-import { createRequire as nodeCreateRequire } from "module";
-import { isAbsolute as isAbsolute14, relative as relative22, resolve as resolve30, sep as sep22 } from "path";
+import { createRequire as nodeCreateRequire2 } from "module";
+import { isAbsolute as isAbsolute14, relative as relative22, resolve as resolve31, sep as sep22 } from "path";
 var TerminalService = class {
   #root;
   #factory;
@@ -23585,7 +23826,7 @@ var TerminalService = class {
   #maxOutputChars;
   #sessions = /* @__PURE__ */ new Map();
   constructor(workspace, options = {}) {
-    this.#root = resolve30(workspace);
+    this.#root = resolve31(workspace);
     this.#factory = options.factory ?? defaultFactory;
     this.#jobs = options.jobs;
     this.#maxOutputChars = options.maxOutputChars ?? 2e5;
@@ -23690,7 +23931,7 @@ function snapshot3(record3) {
 }
 function defaultFactory(shell2, args, options) {
   try {
-    const pty = nodeCreateRequire(import.meta.url)("node-pty");
+    const pty = nodeCreateRequire2(import.meta.url)("node-pty");
     return pty.spawn(shell2, args, { ...options, name: "xterm-256color" });
   } catch (error) {
     throw new Error(`Pseudo-terminal backend is unavailable: ${error instanceof Error ? error.message : String(error)}`);
@@ -23703,7 +23944,7 @@ function cleanEnvironment(environment) {
   return Object.fromEntries(Object.entries(environment).filter((entry2) => entry2[1] !== void 0));
 }
 function workspacePath(root, input) {
-  const path = resolve30(root, input);
+  const path = resolve31(root, input);
   const delta = relative22(root, path);
   if (delta === ".." || delta.startsWith(`..${sep22}`) || isAbsolute14(delta)) throw new Error("Terminal cwd is outside the workspace");
   return path;
@@ -23711,7 +23952,7 @@ function workspacePath(root, input) {
 
 // src/tools/terminal.ts
 import { z as z40 } from "zod";
-import { resolve as resolve31 } from "path";
+import { resolve as resolve32 } from "path";
 var Id = z40.string().regex(/^term-[a-f0-9-]+$/);
 var OpenInput = z40.object({ cwd: z40.string().optional(), shell: z40.string().optional(), args: z40.array(z40.string()).optional(), columns: z40.coerce.number().int().min(10).max(500).optional(), rows: z40.coerce.number().int().min(2).max(300).optional() });
 var OptionalBoolean = z40.union([z40.boolean(), z40.string().refine((value) => value === "true" || value === "false")]);
@@ -23725,8 +23966,8 @@ function createTerminalTools(terminals, workspace = process.cwd()) {
       name: "TerminalOpen",
       description: "Open a persistent interactive pseudo-terminal in the workspace",
       inputSchema: OpenInput,
-      paths: (input) => [resolve31(workspace, input.cwd ?? ".")],
-      permissions: (input) => ({ paths: [resolve31(workspace, input.cwd ?? ".")], command: input.shell ?? "system-shell", args: input.args ?? [], cwd: resolve31(workspace, input.cwd ?? ".") }),
+      paths: (input) => [resolve32(workspace, input.cwd ?? ".")],
+      permissions: (input) => ({ paths: [resolve32(workspace, input.cwd ?? ".")], command: input.shell ?? "system-shell", args: input.args ?? [], cwd: resolve32(workspace, input.cwd ?? ".") }),
       execute: async (input, _signal, context) => terminals.open({
         owner: owner(context),
         ...input.cwd === void 0 ? {} : { cwd: input.cwd },
@@ -23822,7 +24063,7 @@ function palSocketAddress(options) {
 import { createHash as createHash20 } from "crypto";
 import { Socket as Socket2 } from "net";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join31 } from "path";
+import { join as join32 } from "path";
 import { spawn as spawn7 } from "child_process";
 
 // src/pals/broker.ts
@@ -23835,16 +24076,16 @@ import { dirname as dirname23 } from "path";
 import { randomBytes as randomBytes3, randomUUID as randomUUID21 } from "crypto";
 import { chmod as chmod2, link as link2, mkdir as mkdir21, open as open12, readFile as readFile25, unlink as unlink4 } from "fs/promises";
 import { homedir } from "os";
-import { join as join30 } from "path";
+import { join as join31 } from "path";
 var PAL_AUTH_TOKEN_BYTES = 32;
 var TOKEN_PATTERN = /^[a-f0-9]{64}$/;
 async function loadOrCreatePalAuthToken(options = {}) {
-  const directory = join30(options.home ?? homedir(), ".flavor-code", "pals");
-  const tokenPath = join30(directory, "auth-token");
+  const directory = join31(options.home ?? homedir(), ".flavor-code", "pals");
+  const tokenPath = join31(directory, "auth-token");
   await mkdir21(directory, { recursive: true, mode: 448 });
   await chmod2(directory, 448);
   const token = (options.random ?? randomBytes3)(PAL_AUTH_TOKEN_BYTES).toString("hex");
-  const temporaryPath = join30(directory, `.auth-token-${process.pid}-${randomUUID21()}.tmp`);
+  const temporaryPath = join31(directory, `.auth-token-${process.pid}-${randomUUID21()}.tmp`);
   let handle;
   try {
     handle = await open12(temporaryPath, "wx", 384);
@@ -23879,7 +24120,7 @@ function validatePalAuthToken(token) {
 
 // src/pals/lifecycle.ts
 import { randomUUID as randomUUID22 } from "crypto";
-import { mkdir as mkdir22, open as open13, readFile as readFile26, rename as rename11, stat as stat11, unlink as unlink5 } from "fs/promises";
+import { mkdir as mkdir22, open as open13, readFile as readFile26, rename as rename11, stat as stat12, unlink as unlink5 } from "fs/promises";
 import { dirname as dirname22 } from "path";
 function defaultProcessAlive(pid) {
   if (!Number.isSafeInteger(pid) || pid <= 0) return true;
@@ -23911,7 +24152,7 @@ async function acquirePalFileLock(options) {
     handle = await open13(options.path, "wx", 384);
   } catch (error) {
     if (error.code !== "EEXIST") throw error;
-    const [contents, info] = await Promise.all([readFile26(options.path, "utf8").catch(() => ""), stat11(options.path).catch(() => void 0)]);
+    const [contents, info] = await Promise.all([readFile26(options.path, "utf8").catch(() => ""), stat12(options.path).catch(() => void 0)]);
     if (await options.endpointLive()) return void 0;
     const existing = parseMetadata(contents);
     if (existing !== void 0 && (options.processAlive ?? defaultProcessAlive)(existing.pid)) return void 0;
@@ -23974,7 +24215,7 @@ function canConnect(address) {
 }
 function startupLockPath(address) {
   const digest = createHash20("sha256").update(address, "utf8").digest("hex").slice(0, 24);
-  return join31(tmpdir3(), `flavor-code-pals-${digest}.startup.lock`);
+  return join32(tmpdir3(), `flavor-code-pals-${digest}.startup.lock`);
 }
 async function spawnProductionBroker(address) {
   const entry2 = process.argv[1];
@@ -24666,8 +24907,8 @@ var ApprovalBridge = class {
   }
 };
 async function createProductionRuntime(options) {
-  const workspace = resolve32(options.workspace ?? process.cwd());
-  const home = resolve32(options.home ?? homedir2());
+  const workspace = resolve33(options.workspace ?? process.cwd());
+  const home = resolve33(options.home ?? homedir2());
   const environment = options.environment ?? process.env;
   const ide = new FlavorIdeClient({ workspace, home, environment });
   const ideReady = ide.initialize();
@@ -24752,9 +24993,28 @@ async function createProductionRuntime(options) {
   const recovered = options.resumeSession === void 0 ? void 0 : await sessionStore.load(options.resumeSession === true ? void 0 : options.resumeSession);
   let timelineState = recovered === void 0 ? createTranscriptState() : restoreTranscriptState(recovered.timeline.state);
   const restoredTranscript = restoreTranscriptState(timelineState);
+  const pendingTimelineStreams = [];
+  const flushTimelineStreams = () => {
+    for (const pending2 of pendingTimelineStreams.splice(0)) {
+      timelineState = transcriptReducer(timelineState, {
+        type: "session",
+        event: { type: pending2.type, text: pending2.chunks.join("") }
+      });
+    }
+  };
+  const recordTimelineEvent = (event) => {
+    if (event.type === "text" || event.type === "thinking") {
+      const last = pendingTimelineStreams.at(-1);
+      if (last?.type === event.type) last.chunks.push(event.text);
+      else pendingTimelineStreams.push({ type: event.type, chunks: [event.text] });
+      return;
+    }
+    flushTimelineStreams();
+    timelineState = transcriptReducer(timelineState, { type: "session", event });
+  };
   let ideSessionId;
   const emitOutput = (event) => {
-    timelineState = transcriptReducer(timelineState, { type: "session", event });
+    recordTimelineEvent(event);
     options.output(event);
     if (ideSessionId !== void 0) ide.publishEvent(ideSessionId, event);
   };
@@ -24891,8 +25151,8 @@ async function createProductionRuntime(options) {
   const registeredProviders = registration.registered;
   let effectiveLlm = registration.effectiveLlm;
   const pluginHost = new PluginHost({
-    globalPluginDirs: [join32(home, ".flavor-code", "plugins")],
-    projectPluginDirs: [join32(workspace, ".flavor", "plugins")],
+    globalPluginDirs: [join33(home, ".flavor-code", "plugins")],
+    projectPluginDirs: [join33(workspace, ".flavor", "plugins")],
     config,
     // Existing project plugins (including astgraph and superharness) use Node.js
     // built-ins. The Worker/vm sandbox deliberately blocks those imports, so it
@@ -25000,7 +25260,7 @@ async function createProductionRuntime(options) {
       const address = palSocketAddress({
         platform: process.platform,
         userScope: home,
-        runtimeDir: join32(tmpdir4(), `flavor-code-pals-${createHash21("sha256").update(home).digest("hex").slice(0, 16)}`)
+        runtimeDir: join33(tmpdir4(), `flavor-code-pals-${createHash21("sha256").update(home).digest("hex").slice(0, 16)}`)
       });
       const baseCollaborationClient = collaboration.client ?? collaboration.createClient?.({
         instanceId: collaboration.instanceId,
@@ -25111,8 +25371,8 @@ async function createProductionRuntime(options) {
       diagnostics.push(`MCP servers could not start: ${message(error)}`);
     });
     const skills = new SkillRegistry({
-      globalRoots: [join32(home, ".flavor-code", "skills")],
-      projectRoots: [join32(workspace, ".flavor", "skills"), ...pluginSkillRoots],
+      globalRoots: [join33(home, ".flavor-code", "skills")],
+      projectRoots: [join33(workspace, ".flavor", "skills"), ...pluginSkillRoots],
       authorizeResource: async () => true,
       disabledNames: config.skills.disabled
     });
@@ -25120,7 +25380,7 @@ async function createProductionRuntime(options) {
     skillsReady.catch(() => void 0);
     tools.push(createSkillTool(skills), createSkillResourceTool(skills));
     if (options.extraTools !== void 0) tools.push(...options.extraTools);
-    const flavor = await optionalText2(join32(workspace, "FLAVOR.md"));
+    const flavor = await optionalText2(join33(workspace, "FLAVOR.md"));
     const instructionBaseline = await workspaceInstructions.baseline();
     let memoryContext;
     if (memoryStore !== void 0) {
@@ -25171,27 +25431,30 @@ async function createProductionRuntime(options) {
       };
     }
     let persistTail = Promise.resolve();
-    const sessionDocument = () => ({
-      version: SESSION_VERSION,
-      sessionId,
-      createdAt,
-      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      workspace: { path: workspace },
-      conversation: storedConversation(harness.main.context.snapshot()),
-      tasks: {
-        ...taskPlan === void 0 ? {} : { plan: taskPlan },
-        ...taskGraph === void 0 ? {} : { graph: taskGraph },
-        states: { ...taskStates },
-        results: { ...taskResults }
-      },
-      // Persist the resolved decision, not the harness snapshot: after logout the
-      // harness may still hold the old login model, and resuming from that stale
-      // value is what made the welcome card show a previous service.
-      models: { main: mainModel, subagent: childModel },
-      permissionMode: harness.permissionMode,
-      memory: memoryLifecycle,
-      timeline: { version: 1, state: timelineState }
-    });
+    const sessionDocument = () => {
+      flushTimelineStreams();
+      return {
+        version: SESSION_VERSION,
+        sessionId,
+        createdAt,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        workspace: { path: workspace },
+        conversation: storedConversation(harness.main.context.snapshot()),
+        tasks: {
+          ...taskPlan === void 0 ? {} : { plan: taskPlan },
+          ...taskGraph === void 0 ? {} : { graph: taskGraph },
+          states: { ...taskStates },
+          results: { ...taskResults }
+        },
+        // Persist the resolved decision, not the harness snapshot: after logout the
+        // harness may still hold the old login model, and resuming from that stale
+        // value is what made the welcome card show a previous service.
+        models: { main: mainModel, subagent: childModel },
+        permissionMode: harness.permissionMode,
+        memory: memoryLifecycle,
+        timeline: { version: 1, state: timelineState }
+      };
+    };
     let persistFailed = false;
     const persist = () => {
       persistTail = persistTail.catch(() => void 0).then(
@@ -25698,7 +25961,7 @@ async function createProductionRuntime(options) {
         evolveService.toolDefinition(),
         ...mcpTools
       ];
-      const loopFlavor = await optionalText2(join32(input.workspace, "FLAVOR.md"));
+      const loopFlavor = await optionalText2(join33(input.workspace, "FLAVOR.md"));
       const loopInstructionBaseline = await loopInstructions.baseline();
       const loopEnvironment = createPromptEnvironment({
         now: /* @__PURE__ */ new Date(),
@@ -26058,6 +26321,22 @@ async function createProductionRuntime(options) {
         modelId: () => harness.subagentModelId,
         notify: (message2) => emitOutput({ type: "notice", message: message2 })
       }, focus, signal),
+      explain: (query, focus, signal, onText) => runExplain({
+        graph: new DesktopAstGraphService(workspace),
+        readFile: async (path) => {
+          const root = resolve33(workspace);
+          const abs = resolve33(root, path);
+          if (abs !== root && !abs.startsWith(root + sep23)) throw new Error(`path outside workspace: ${path}`);
+          return readFile27(abs, "utf8");
+        },
+        history: async (path, limit) => fileHistory(workspace, path, limit),
+        questions,
+        registry,
+        modelId: () => harness.subagentModelId,
+        language,
+        notify: (message2) => emitOutput({ type: "notice", message: message2 }),
+        ...onText === void 0 ? {} : { onText }
+      }, query, focus, signal),
       audit: async (toolFilter) => {
         try {
           const raw = await readFile27(auditLogger.path, "utf8");
@@ -26247,7 +26526,7 @@ ${renderMemoryDocument(entries)}`;
           return `Provider "${providerName}" is missing authorizationUrl, tokenUrl, or clientId.`;
         }
         try {
-          const tokenStore = createFileTokenStore(join32(home, ".flavor-code", "auth.json"));
+          const tokenStore = createFileTokenStore(join33(home, ".flavor-code", "auth.json"));
           const credentialId = oauthCredentialId(oauthConfig.tokenUrl, oauthConfig.clientId);
           await migrateLegacyOAuthToken(tokenStore, providerName, credentialId);
           const oauth = new OAuthCallbackAuthProvider({
@@ -26294,7 +26573,7 @@ ${renderMemoryDocument(entries)}`;
         }
       },
       async logout() {
-        const tokenStore = createFileTokenStore(join32(home, ".flavor-code", "auth.json"));
+        const tokenStore = createFileTokenStore(join33(home, ".flavor-code", "auth.json"));
         const tokens2 = await tokenStore.load();
         const hadCredentials = Object.keys(tokens2).length > 0 || effectiveLlm !== void 0;
         if (!hadCredentials) {
@@ -26570,8 +26849,8 @@ async function workspaceFingerprint(workspace) {
   let remaining = 5 * 1024 * 1024;
   for (const name of untracked.stdout.split("\0").filter(Boolean).sort()) {
     if (name === ".flavor/loops" || name.startsWith(".flavor/loops/")) continue;
-    const path = resolve32(workspace, name);
-    const relativePath = relative23(resolve32(workspace), path);
+    const path = resolve33(workspace, name);
+    const relativePath = relative23(resolve33(workspace), path);
     if (relativePath === ".." || relativePath.startsWith(`..${sep23}`)) continue;
     hash.update(name);
     if (remaining <= 0) continue;
@@ -26789,7 +27068,7 @@ async function registerConfiguredAdapters(providers, registry, environment, diag
   const configured = { ...providers };
   if (configured.openai === void 0 && environment.OPENAI_API_KEY) configured.openai = { type: "openai", apiKey: environment.OPENAI_API_KEY };
   if (configured.anthropic === void 0 && environment.ANTHROPIC_API_KEY) configured.anthropic = { type: "anthropic", apiKey: environment.ANTHROPIC_API_KEY };
-  const oauthTokenStore = createFileTokenStore(join32(home, ".flavor-code", "auth.json"));
+  const oauthTokenStore = createFileTokenStore(join33(home, ".flavor-code", "auth.json"));
   const registered = [];
   let effectiveLlm;
   for (const [name, provider] of Object.entries(configured)) {
@@ -27220,13 +27499,13 @@ function createMemoryTaskId() {
 
 // src/desktop/runtime-controller.ts
 import { createHash as createHash27 } from "crypto";
-import { mkdir as mkdir27, readFile as readFile35, readdir as readdir12, rm as rm15, stat as stat14, writeFile as writeFile17 } from "fs/promises";
+import { mkdir as mkdir27, readFile as readFile35, readdir as readdir12, rm as rm15, stat as stat15, writeFile as writeFile17 } from "fs/promises";
 import { homedir as homedir4 } from "os";
-import { basename as basename9, join as join42, resolve as resolve35 } from "path";
+import { basename as basename9, join as join43, resolve as resolve36 } from "path";
 
 // src/d2c/workflow.ts
 import { createHash as createHash22 } from "crypto";
-import { join as join33 } from "path";
+import { join as join34 } from "path";
 import { z as z42 } from "zod";
 
 // src/d2c/workflow-shared.ts
@@ -27372,7 +27651,7 @@ function reviewsFor(report, previous) {
 function implementationDirectory(report) {
   const source = report.implementation.source;
   if (!/^https?:\/\//i.test(source)) return source;
-  return join33("src", "d2c-output", report.task);
+  return join34("src", "d2c-output", report.task);
 }
 function createWorkflow(report, framework) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -27496,7 +27775,7 @@ function applyQualityIssueDecision(workflow, issueId2, decision) {
   };
 }
 function workflowPath(workspace, task) {
-  return join33(taskDir(workspace, task), "workflow.json");
+  return join34(taskDir(workspace, task), "workflow.json");
 }
 async function readWorkflow(workspace, task) {
   return (await readRecoverableFile(workflowPath(workspace, task), decodeWorkflow))?.value;
@@ -27750,7 +28029,7 @@ function confirmApiMapping(mapping, operationKey, operations) {
 
 // src/d2c/modules.ts
 import { readFile as readFile28 } from "fs/promises";
-import { isAbsolute as isAbsolute15, join as join34, normalize as normalize2, posix, sep as sep24, win32 as win322 } from "path";
+import { isAbsolute as isAbsolute15, join as join35, normalize as normalize2, posix, sep as sep24, win32 as win322 } from "path";
 import { z as z43 } from "zod";
 var ModuleSchema = z43.object({
   id: z43.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/),
@@ -27769,13 +28048,13 @@ function safeSource(path) {
 }
 function d2cOutputDirectory(workspace, task) {
   if (!D2C_TASK_PATTERN.test(task)) throw new Error(`Invalid D2C task: ${task}`);
-  return join34(workspace, "src", "d2c-output", task);
+  return join35(workspace, "src", "d2c-output", task);
 }
 async function readD2cModules(workspace, task) {
   const project = d2cOutputDirectory(workspace, task);
   let raw;
   try {
-    raw = await readFile28(join34(project, "d2c.modules.json"), "utf8");
+    raw = await readFile28(join35(project, "d2c.modules.json"), "utf8");
   } catch {
     return [{ id: "page", label: task, sourceFiles: ["src/App.vue", "src/App.jsx"], keywords: [task] }];
   }
@@ -27796,7 +28075,7 @@ async function readD2cModules(workspace, task) {
 
 // src/d2c/integration.ts
 import { mkdir as mkdir24, readFile as readFile29, writeFile as writeFile13 } from "fs/promises";
-import { join as join35 } from "path";
+import { join as join36 } from "path";
 function record2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 }
@@ -27932,7 +28211,7 @@ async def reset_acceptance(request: Request):
 }
 async function generateIntegrationArtifacts(projectDir, document, mappings, options = {}) {
   if (mappings.some((mapping) => mapping.status === "needs-confirmation")) throw new Error("Confirm every uncertain OpenAPI mapping before generating integration code");
-  const packagePath = join35(projectDir, "package.json");
+  const packagePath = join36(projectDir, "package.json");
   let pkg;
   try {
     pkg = JSON.parse(await readFile29(packagePath, "utf8"));
@@ -27942,9 +28221,9 @@ async function generateIntegrationArtifacts(projectDir, document, mappings, opti
   const scripts = options.pythonServer ? { ...record2(pkg.scripts) ?? {} } : { ...record2(pkg.scripts) ?? {}, mock: "node mock/server.mjs" };
   const dependencies2 = options.pythonServer ? { ...record2(pkg.dependencies) ?? {}, axios: "^1.7.9" } : { ...record2(pkg.dependencies) ?? {}, axios: "^1.7.9", express: "^5.2.1" };
   const selected = [...new Set(mappings.map((mapping) => mapping.operationKey))].map((key) => document.operations.find((operation) => operation.id === key)).filter((operation) => operation !== void 0);
-  const apiDir = join35(projectDir, "src", "api");
-  const mockDir = join35(projectDir, "mock");
-  const serverDir = join35(projectDir, "server");
+  const apiDir = join36(projectDir, "src", "api");
+  const mockDir = join36(projectDir, "mock");
+  const serverDir = join36(projectDir, "server");
   await Promise.all([
     mkdir24(apiDir, { recursive: true }),
     ...options.pythonServer ? [] : [mkdir24(mockDir, { recursive: true })],
@@ -27954,23 +28233,23 @@ async function generateIntegrationArtifacts(projectDir, document, mappings, opti
   if (options.pythonServer) files.push("server/main.py", "server/requirements.txt", "server/README.md", "server/flavor-runtime.json");
   else files.push("mock/server.mjs");
   await Promise.all([
-    writeFile13(join35(apiDir, "http.js"), `import axios from "axios";
+    writeFile13(join36(apiDir, "http.js"), `import axios from "axios";
 
 export const http = axios.create({ baseURL: import.meta.env.VITE_API_BASE_URL || ${JSON.stringify(document.baseUrl ?? "")}, timeout: 15000 });
 
 http.interceptors.response.use((response) => response, (error) => Promise.reject({ name: "ApiError", status: error.response?.status, message: error.response?.data?.message || error.message, cause: error }));
 `),
-    writeFile13(join35(apiDir, "d2c-api.js"), apiModule(selected)),
-    writeFile13(join35(apiDir, "d2c-bindings.json"), `${JSON.stringify({ schema: 1, generatedAt: (/* @__PURE__ */ new Date()).toISOString(), mappings }, null, 2)}
+    writeFile13(join36(apiDir, "d2c-api.js"), apiModule(selected)),
+    writeFile13(join36(apiDir, "d2c-bindings.json"), `${JSON.stringify({ schema: 1, generatedAt: (/* @__PURE__ */ new Date()).toISOString(), mappings }, null, 2)}
 `),
-    ...options.pythonServer ? [] : [writeFile13(join35(mockDir, "server.mjs"), mockModule({ ...document, operations: selected }))],
+    ...options.pythonServer ? [] : [writeFile13(join36(mockDir, "server.mjs"), mockModule({ ...document, operations: selected }))],
     writeFile13(packagePath, `${JSON.stringify({ ...pkg, scripts, dependencies: dependencies2 }, null, 2)}
 `),
     ...options.pythonServer ? [
-      writeFile13(join35(serverDir, "main.py"), pythonServerModule({ ...document, operations: selected })),
-      writeFile13(join35(serverDir, "requirements.txt"), "fastapi>=0.116,<1\nuvicorn[standard]>=0.35,<1\nsqlalchemy>=2.0,<3\n"),
-      writeFile13(join35(serverDir, "README.md"), "# Python API service\n\nThis is the real integration service, not a mock. Development defaults to SQLite through `DATABASE_URL=sqlite:///./data/app.db`. Set the same environment variable to a SQLAlchemy MySQL or PostgreSQL URL for deployment; keep schema changes in migrations instead of database-specific SQL. Flavor Code starts the service automatically for acceptance.\n"),
-      writeFile13(join35(serverDir, "flavor-runtime.json"), `${JSON.stringify({
+      writeFile13(join36(serverDir, "main.py"), pythonServerModule({ ...document, operations: selected })),
+      writeFile13(join36(serverDir, "requirements.txt"), "fastapi>=0.116,<1\nuvicorn[standard]>=0.35,<1\nsqlalchemy>=2.0,<3\n"),
+      writeFile13(join36(serverDir, "README.md"), "# Python API service\n\nThis is the real integration service, not a mock. Development defaults to SQLite through `DATABASE_URL=sqlite:///./data/app.db`. Set the same environment variable to a SQLAlchemy MySQL or PostgreSQL URL for deployment; keep schema changes in migrations instead of database-specific SQL. Flavor Code starts the service automatically for acceptance.\n"),
+      writeFile13(join36(serverDir, "flavor-runtime.json"), `${JSON.stringify({
         schema: 1,
         kind: "python-fastapi",
         cwd: "server",
@@ -27991,7 +28270,7 @@ http.interceptors.response.use((response) => response, (error) => Promise.reject
 import { spawn as spawn8 } from "child_process";
 import { access as access3, readFile as readFile30 } from "fs/promises";
 import { createServer as createServer5 } from "net";
-import { join as join36 } from "path";
+import { join as join37 } from "path";
 async function exists3(path) {
   try {
     await access3(path);
@@ -28099,7 +28378,7 @@ ${output.trim()}` : ""}`);
   }
 }
 async function runPythonBackend(projectDir, options) {
-  const serverDir = join36(projectDir, "server");
+  const serverDir = join37(projectDir, "server");
   if (options.installDependencies !== false) await installPython(serverDir, options.signal);
   const selectedPort = await port();
   const url = `http://127.0.0.1:${selectedPort}`;
@@ -28145,7 +28424,7 @@ ${managed.output().slice(-4e3)}`);
   };
 }
 async function runD2cMockServer(projectDir, options = {}) {
-  const runtimePath = join36(projectDir, "server", "flavor-runtime.json");
+  const runtimePath = join37(projectDir, "server", "flavor-runtime.json");
   if (await exists3(runtimePath)) {
     let runtime;
     try {
@@ -28156,9 +28435,9 @@ async function runD2cMockServer(projectDir, options = {}) {
     if (runtime.schema !== 1 || runtime.kind !== "python-fastapi") throw new Error("Unsupported E2E backend runtime manifest");
     return runPythonBackend(projectDir, options);
   }
-  const serverPath = join36(projectDir, "mock", "server.mjs");
+  const serverPath = join37(projectDir, "mock", "server.mjs");
   if (!await exists3(serverPath)) throw new Error(`D2C mock server is not generated at ${serverPath}`);
-  if (options.installDependencies === false && !await exists3(join36(projectDir, "node_modules", "express", "package.json"))) {
+  if (options.installDependencies === false && !await exists3(join37(projectDir, "node_modules", "express", "package.json"))) {
     throw new Error("D2C mock server dependencies are not installed");
   }
   if (options.installDependencies !== false) await install(projectDir, options.signal);
@@ -28200,8 +28479,8 @@ ${managed.output().slice(-4e3)}`);
 
 // src/d2c/product.ts
 import { createHash as createHash24, randomUUID as randomUUID27 } from "crypto";
-import { copyFile as copyFile2, mkdir as mkdir25, readFile as readFile32, rename as rename13, stat as stat12, unlink as unlink7, writeFile as writeFile15 } from "fs/promises";
-import { join as join37 } from "path";
+import { copyFile as copyFile2, mkdir as mkdir25, readFile as readFile32, rename as rename13, stat as stat13, unlink as unlink7, writeFile as writeFile15 } from "fs/promises";
+import { join as join38 } from "path";
 import { z as z44 } from "zod";
 
 // src/e2e/prd-governance.ts
@@ -28356,13 +28635,13 @@ var PlanSchema2 = z44.object({
 }).strict();
 function d2cProductDirectory(workspace, task) {
   if (!D2C_TASK_PATTERN.test(task)) throw new Error("Invalid D2C task name");
-  return join37(taskDir(workspace, task), "product");
+  return join38(taskDir(workspace, task), "product");
 }
 function d2cProductPrototypeDirectory(workspace, task) {
-  return join37(d2cProductDirectory(workspace, task), "prototype");
+  return join38(d2cProductDirectory(workspace, task), "prototype");
 }
 function planPath(workspace, task) {
-  return join37(taskDir(workspace, task), "product-plan.json");
+  return join38(taskDir(workspace, task), "product-plan.json");
 }
 function resolveD2cProductTechnology(requirement, fallbackFramework = "vue") {
   const frontendCandidates = [
@@ -28450,7 +28729,7 @@ function buildD2cProductOpenApi(task, modules) {
 `;
 }
 async function fileTimestamp(path) {
-  const info = await stat12(path).catch(() => void 0);
+  const info = await stat13(path).catch(() => void 0);
   return info?.isFile() ? info.mtime.toISOString() : void 0;
 }
 async function fileHash(path) {
@@ -28545,16 +28824,16 @@ async function readD2cProductPlan(workspace, task) {
 }
 async function discoverD2cProductArtifacts(workspace, plan) {
   const product = d2cProductDirectory(workspace, plan.task);
-  const prdUpdatedAt = await fileTimestamp(join37(product, "prd.md"));
-  const prdHash = await fileHash(join37(product, "prd.md"));
-  const prototypeUpdatedAt = await fileTimestamp(join37(product, "prototype", "index.html"));
-  const prototypeHash = await fileHash(join37(product, "prototype", "index.html"));
-  const expectedManifest = join37(product, "prototype", "interaction-manifest.json");
+  const prdUpdatedAt = await fileTimestamp(join38(product, "prd.md"));
+  const prdHash = await fileHash(join38(product, "prd.md"));
+  const prototypeUpdatedAt = await fileTimestamp(join38(product, "prototype", "index.html"));
+  const prototypeHash = await fileHash(join38(product, "prototype", "index.html"));
+  const expectedManifest = join38(product, "prototype", "interaction-manifest.json");
   let manifestUpdatedAt = await fileTimestamp(expectedManifest);
   if (manifestUpdatedAt === void 0) {
-    const misplacedManifest = join37(product, "interaction-manifest.json");
+    const misplacedManifest = join38(product, "interaction-manifest.json");
     if (await fileTimestamp(misplacedManifest) !== void 0) {
-      await mkdir25(join37(product, "prototype"), { recursive: true });
+      await mkdir25(join38(product, "prototype"), { recursive: true });
       await copyFile2(misplacedManifest, expectedManifest);
       manifestUpdatedAt = await fileTimestamp(expectedManifest);
     }
@@ -28587,8 +28866,8 @@ async function readD2cProductPlanView(workspace, task) {
   if (stored === void 0) return void 0;
   const plan = await discoverD2cProductArtifacts(workspace, stored);
   if (plan.revision !== stored.revision) await writeD2cProductPlan(workspace, plan);
-  const prdMarkdown = plan.prd === void 0 ? void 0 : await readFile32(join37(taskDir(workspace, task), plan.prd.path), "utf8");
-  const manifestPath = join37(d2cProductDirectory(workspace, task), "prototype", "interaction-manifest.json");
+  const prdMarkdown = plan.prd === void 0 ? void 0 : await readFile32(join38(taskDir(workspace, task), plan.prd.path), "utf8");
+  const manifestPath = join38(d2cProductDirectory(workspace, task), "prototype", "interaction-manifest.json");
   const validationError = plan.phase === "design-generating" && await fileTimestamp(manifestPath) !== void 0 ? await validateAndNormalizePrototypeManifest(manifestPath) : void 0;
   return {
     plan,
@@ -28747,7 +29026,7 @@ function createAcceptanceEvidence(coverage, run, now = /* @__PURE__ */ new Date(
 
 // src/e2e/delivery-run.ts
 import { createHash as createHash26 } from "crypto";
-import { join as join38 } from "path";
+import { join as join39 } from "path";
 import { z as z45 } from "zod";
 var DELIVERY_NODE_IDS = ["requirement", "prd", "design", "d2c", "api", "acceptance", "delivery"];
 var ArtifactSchema = z45.object({
@@ -28864,7 +29143,7 @@ function completeDeliveryNode(run, node, outputs, now = /* @__PURE__ */ new Date
   return { ...run, nodes, updatedAt: timestamp2 };
 }
 function deliveryRunPath(workspace, task) {
-  return join38(taskDir(workspace, task), "delivery-run.json");
+  return join39(taskDir(workspace, task), "delivery-run.json");
 }
 function decodeDeliveryRun(raw) {
   return DeliveryRunSchema.parse(JSON.parse(raw));
@@ -28907,14 +29186,14 @@ async function updateDeliveryRun(workspace, task, expectedRevision, mutation) {
 // src/skills/manager.ts
 import { lstat as lstat13, mkdir as mkdir26, readFile as readFile34, readdir as readdir11, realpath as realpath13, rm as rm14, writeFile as writeFile16 } from "fs/promises";
 import { homedir as homedir3 } from "os";
-import { isAbsolute as isAbsolute16, join as join39, relative as relative24, resolve as resolve33, sep as sep25 } from "path";
+import { isAbsolute as isAbsolute16, join as join40, relative as relative24, resolve as resolve34, sep as sep25 } from "path";
 import { stringify } from "yaml";
 var SkillManager = class {
   #workspace;
   #home;
   constructor(options) {
-    this.#workspace = resolve33(options.workspace);
-    this.#home = resolve33(options.home ?? homedir3());
+    this.#workspace = resolve34(options.workspace);
+    this.#home = resolve34(options.home ?? homedir3());
   }
   async list() {
     const { registry, disabled } = await this.#registry();
@@ -28930,7 +29209,7 @@ var SkillManager = class {
   async create(draft) {
     const value = parseDraft(draft);
     const projectRoot = this.#projectRoot();
-    const directory = join39(projectRoot, value.name);
+    const directory = join40(projectRoot, value.name);
     await mkdir26(projectRoot, { recursive: true, mode: 448 });
     try {
       await mkdir26(directory, { mode: 448 });
@@ -28939,7 +29218,7 @@ var SkillManager = class {
       throw error;
     }
     try {
-      await writeFile16(join39(directory, "SKILL.md"), renderSkill(value), { encoding: "utf8", flag: "wx", mode: 384 });
+      await writeFile16(join40(directory, "SKILL.md"), renderSkill(value), { encoding: "utf8", flag: "wx", mode: 384 });
       await this.#persistEnabled(value.name, true);
       return this.get(value.name);
     } catch (error) {
@@ -28957,7 +29236,7 @@ var SkillManager = class {
       throw error;
     });
     if (!info.isDirectory() || info.isSymbolicLink()) throw new Error(`Project skill path is not a real directory: ${validName}`);
-    const skillFile = join39(directory, "SKILL.md");
+    const skillFile = join40(directory, "SKILL.md");
     const fileInfo = await lstat13(skillFile);
     if (!fileInfo.isFile() || fileInfo.isSymbolicLink()) throw new Error(`Project skill file is not a real file: ${validName}`);
     await writeFile16(skillFile, renderSkill(value), { encoding: "utf8", mode: 384 });
@@ -28989,12 +29268,12 @@ var SkillManager = class {
   async #registry() {
     const loaded = await loadConfig({ cwd: this.#workspace, home: this.#home });
     const [globalPluginRoots, projectPluginRoots] = await Promise.all([
-      discoverPluginSkillRoots(join39(this.#home, ".flavor-code", "plugins")),
-      discoverPluginSkillRoots(join39(this.#workspace, ".flavor", "plugins"))
+      discoverPluginSkillRoots(join40(this.#home, ".flavor-code", "plugins")),
+      discoverPluginSkillRoots(join40(this.#workspace, ".flavor", "plugins"))
     ]);
     return {
       registry: new SkillRegistry({
-        globalRoots: [join39(this.#home, ".flavor-code", "skills"), ...globalPluginRoots],
+        globalRoots: [join40(this.#home, ".flavor-code", "skills"), ...globalPluginRoots],
         projectRoots: [this.#projectRoot(), ...projectPluginRoots]
       }),
       disabled: new Set(loaded.config.skills.disabled)
@@ -29010,10 +29289,10 @@ var SkillManager = class {
     };
   }
   #projectRoot() {
-    return join39(this.#workspace, ".flavor", "skills");
+    return join40(this.#workspace, ".flavor", "skills");
   }
   #projectSkillDirectory(name) {
-    return join39(this.#projectRoot(), name);
+    return join40(this.#projectRoot(), name);
   }
 };
 function parseName(value) {
@@ -29054,11 +29333,11 @@ async function discoverPluginSkillRoots(directory) {
   const roots = [];
   for (const entry2 of entries) {
     if (!entry2.isDirectory() || entry2.isSymbolicLink()) continue;
-    const pluginRoot = await realpath13(join39(directory, entry2.name));
+    const pluginRoot = await realpath13(join40(directory, entry2.name));
     try {
-      const manifest = PluginManifestSchema.parse(JSON.parse(await readFile34(join39(pluginRoot, "flavor-plugin.json"), "utf8")));
+      const manifest = PluginManifestSchema.parse(JSON.parse(await readFile34(join40(pluginRoot, "flavor-plugin.json"), "utf8")));
       for (const contribution of manifest.contributes.skillRoots) {
-        const candidate = resolve33(pluginRoot, contribution.path);
+        const candidate = resolve34(pluginRoot, contribution.path);
         const info = await lstat13(candidate);
         if (!info.isDirectory() || info.isSymbolicLink()) continue;
         const physical = await realpath13(candidate);
@@ -29131,11 +29410,11 @@ async function createProjectMemoryManager(options) {
 }
 
 // src/mcp/config-manager.ts
-import { join as join40 } from "path";
+import { join as join41 } from "path";
 var ProjectMcpConfigManager = class {
   path;
   constructor(workspace) {
-    this.path = join40(workspace, ".flavor", "flavor.json");
+    this.path = join41(workspace, ".flavor", "flavor.json");
   }
   async list() {
     const document = await readRecoverableFile(this.path, (raw) => parseDocument2(this.path, raw));
@@ -29232,7 +29511,7 @@ function isRecord7(value) {
 }
 
 // src/desktop/model-config.ts
-import { join as join41 } from "path";
+import { join as join42 } from "path";
 var DEFAULT_DESKTOP_MODELS = [
   {
     id: "anthropic:deepseek-v4-pro",
@@ -29253,7 +29532,7 @@ var DEFAULT_DESKTOP_MODELS = [
 ];
 async function loadDesktopModels(workspace, home) {
   try {
-    const tokens2 = await createFileTokenStore(join41(home, ".flavor-code", "auth.json")).load();
+    const tokens2 = await createFileTokenStore(join42(home, ".flavor-code", "auth.json")).load();
     const pkceModels = [];
     const knownPkce = /* @__PURE__ */ new Set();
     for (const token of Object.values(tokens2)) {
@@ -29321,9 +29600,9 @@ function protocolLabel(type) {
 
 // src/desktop/d2c-product-preview.ts
 import { createReadStream as createReadStream2 } from "fs";
-import { realpath as realpath14, stat as stat13 } from "fs/promises";
+import { realpath as realpath14, stat as stat14 } from "fs/promises";
 import { createServer as createServer6 } from "http";
-import { extname as extname3, isAbsolute as isAbsolute17, relative as relative25, resolve as resolve34, sep as sep26 } from "path";
+import { extname as extname3, isAbsolute as isAbsolute17, relative as relative25, resolve as resolve35, sep as sep26 } from "path";
 var MIME_TYPES = {
   ".css": "text/css; charset=utf-8",
   ".gif": "image/gif",
@@ -29345,8 +29624,8 @@ function isInside(root, candidate) {
   return delta === "" || !delta.startsWith(`..${sep26}`) && delta !== ".." && !isAbsolute17(delta);
 }
 async function startD2cProductPreview(rootDirectory) {
-  const root = await realpath14(resolve34(rootDirectory));
-  const rootInfo = await stat13(root);
+  const root = await realpath14(resolve35(rootDirectory));
+  const rootInfo = await stat14(root);
   if (!rootInfo.isDirectory()) throw new Error("D2C product prototype directory is unavailable");
   const server = createServer6(async (request, response2) => {
     response2.setHeader("cache-control", "no-store");
@@ -29357,11 +29636,11 @@ async function startD2cProductPreview(rootDirectory) {
       let pathname = decodeURIComponent(url.pathname);
       if (pathname === "/") pathname = "/index.html";
       if (pathname.includes("\0")) return sendNotFound(response2);
-      const unresolved = resolve34(root, `.${pathname}`);
+      const unresolved = resolve35(root, `.${pathname}`);
       if (!isInside(root, unresolved)) return sendNotFound(response2);
       const target = await realpath14(unresolved).catch(() => void 0);
       if (target === void 0 || !isInside(root, target)) return sendNotFound(response2);
-      const info = await stat13(target);
+      const info = await stat14(target);
       if (!info.isFile()) return sendNotFound(response2);
       response2.writeHead(200, {
         "content-length": info.size,
@@ -29398,33 +29677,33 @@ function pngDataUrl(png) {
 }
 async function detectD2cFramework(workspace, task) {
   try {
-    const pkg = JSON.parse(await readFile35(join42(d2cOutputDirectory(workspace, task), "package.json"), "utf8"));
+    const pkg = JSON.parse(await readFile35(join43(d2cOutputDirectory(workspace, task), "package.json"), "utf8"));
     return pkg.dependencies?.react === void 0 ? "vue" : "react";
   } catch {
     return "vue";
   }
 }
 function integrationDirectory(workspace, task) {
-  return join42(workspace, ".flavor", "d2c", task, "integration");
+  return join43(workspace, ".flavor", "d2c", task, "integration");
 }
 var D2C_BACKEND_SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".cfg", ".env", ".ini", ".js", ".json", ".lock", ".mjs", ".py", ".toml", ".txt", ".yaml", ".yml"]);
 var D2C_BACKEND_IGNORED_DIRECTORIES = /* @__PURE__ */ new Set([".git", ".venv", "__pycache__", "data", "node_modules", "venv"]);
 async function d2cBackendSourceFingerprint(project) {
-  const runtimeManifest = join42(project, "server", "flavor-runtime.json");
-  const realBackend = (await stat14(runtimeManifest).catch(() => void 0))?.isFile() === true;
-  const root = realBackend ? join42(project, "server") : join42(project, "mock");
-  if ((await stat14(root).catch(() => void 0))?.isDirectory() !== true) return void 0;
+  const runtimeManifest = join43(project, "server", "flavor-runtime.json");
+  const realBackend = (await stat15(runtimeManifest).catch(() => void 0))?.isFile() === true;
+  const root = realBackend ? join43(project, "server") : join43(project, "mock");
+  if ((await stat15(root).catch(() => void 0))?.isDirectory() !== true) return void 0;
   const files = [];
   const visit = async (directory) => {
     const entries = await readdir12(directory, { withFileTypes: true });
     for (const entry2 of entries) {
       if (entry2.isDirectory()) {
-        if (!D2C_BACKEND_IGNORED_DIRECTORIES.has(entry2.name)) await visit(join42(directory, entry2.name));
+        if (!D2C_BACKEND_IGNORED_DIRECTORIES.has(entry2.name)) await visit(join43(directory, entry2.name));
         continue;
       }
       if (!entry2.isFile()) continue;
       const extension2 = entry2.name.includes(".") ? `.${entry2.name.split(".").pop().toLowerCase()}` : "";
-      if (D2C_BACKEND_SOURCE_EXTENSIONS.has(extension2)) files.push(join42(directory, entry2.name));
+      if (D2C_BACKEND_SOURCE_EXTENSIONS.has(extension2)) files.push(join43(directory, entry2.name));
     }
   };
   await visit(root);
@@ -29476,7 +29755,7 @@ var DesktopRuntimeController = class {
   /** Backend source digest observed when the managed process was started. */
   #d2cMockSourceFingerprints = /* @__PURE__ */ new Map();
   constructor(options) {
-    this.#home = resolve35(options.home ?? homedir4());
+    this.#home = resolve36(options.home ?? homedir4());
     this.#createRuntime = options.createRuntime ?? (async (runtimeOptions) => createProductionRuntime(runtimeOptions));
     this.#createTerminalService = options.createTerminalService ?? ((workspace) => new TerminalService(workspace));
     this.#listSessions = options.listSessions ?? (async (workspace) => {
@@ -29551,7 +29830,7 @@ var DesktopRuntimeController = class {
     };
   }
   async openWorkspace(path) {
-    const workspace = resolve35(path);
+    const workspace = resolve36(path);
     if (workspace !== this.#workspace) {
       await this.#disposeRuntime();
       await this.#stopAllD2cPreviews();
@@ -29978,8 +30257,8 @@ var DesktopRuntimeController = class {
     if (workflow === void 0 || !reviewProgress(workflow).complete || workflow.stage === "visual-review") {
       throw new Error("Complete visual review before importing OpenAPI");
     }
-    const moduleManifest = join42(d2cOutputDirectory(workspace, task), "d2c.modules.json");
-    const moduleManifestInfo = await stat14(moduleManifest).catch(() => void 0);
+    const moduleManifest = join43(d2cOutputDirectory(workspace, task), "d2c.modules.json");
+    const moduleManifestInfo = await stat15(moduleManifest).catch(() => void 0);
     if (moduleManifestInfo === void 0 || !moduleManifestInfo.isFile()) {
       throw new Error("D2C implementation must write d2c.modules.json before API mapping; ask the agent to split the project into modules first");
     }
@@ -29991,8 +30270,8 @@ var DesktopRuntimeController = class {
     await mkdir27(dir, { recursive: true });
     const hash = createHash27("sha256").update(raw).digest("hex");
     await Promise.all([
-      writeFile17(join42(dir, "swagger.json"), raw),
-      writeFile17(join42(dir, "openapi.normalized.json"), `${JSON.stringify(document, null, 2)}
+      writeFile17(join43(dir, "swagger.json"), raw),
+      writeFile17(join43(dir, "openapi.normalized.json"), `${JSON.stringify(document, null, 2)}
 `)
     ]);
     const next = {
@@ -30016,7 +30295,7 @@ var DesktopRuntimeController = class {
     const workspace = this.#workspace;
     if (workspace === void 0) throw new Error("Open a project before importing OpenAPI");
     await this.#assertProductPrdLocked(workspace, task);
-    const info = await stat14(sourcePath);
+    const info = await stat15(sourcePath);
     if (!info.isFile() || info.size > 8 * 1024 * 1024) throw new Error("OpenAPI JSON must be a file no larger than 8 MiB");
     return this.#storeD2cOpenApi(workspace, task, basename9(sourcePath), await readFile35(sourcePath, "utf8"), false);
   }
@@ -30027,7 +30306,7 @@ var DesktopRuntimeController = class {
     let workflow = await readWorkflow(workspace, task);
     if (workflow?.openapi === void 0 && workflow !== void 0 && reviewProgress(workflow).complete && await readD2cProductPlanView(workspace, task) !== void 0) {
       const modules = await readD2cModules(workspace, task);
-      const productOpenApiPath = join42(taskDir(workspace, task), "product", "openapi.json");
+      const productOpenApiPath = join43(taskDir(workspace, task), "product", "openapi.json");
       const authored = await readFile35(productOpenApiPath, "utf8").catch(() => void 0);
       const generated = authored === void 0;
       const prepared = await this.#storeD2cOpenApi(
@@ -30040,7 +30319,7 @@ var DesktopRuntimeController = class {
       return prepared;
     }
     if (workflow?.openapi === void 0 || workflow.mappings === void 0) return void 0;
-    const document = JSON.parse(await readFile35(join42(integrationDirectory(workspace, task), "openapi.normalized.json"), "utf8"));
+    const document = JSON.parse(await readFile35(join43(integrationDirectory(workspace, task), "openapi.normalized.json"), "utf8"));
     return { workflow, document, mappings: workflow.mappings };
   }
   async confirmD2cMapping(task, moduleId, operationKey) {
@@ -30107,7 +30386,7 @@ var DesktopRuntimeController = class {
     ].join("\n");
     const delivery = await readDeliveryRun(workspace, task);
     if (delivery?.nodes.api.status === "running") {
-      const apiArtifacts = await Promise.all(generated.files.map(async (file) => artifactRef(file, await readFile35(join42(project, file)))));
+      const apiArtifacts = await Promise.all(generated.files.map(async (file) => artifactRef(file, await readFile35(join43(project, file)))));
       const completed = await updateDeliveryRun(
         workspace,
         task,
@@ -30134,7 +30413,7 @@ var DesktopRuntimeController = class {
     try {
       const fingerprint2 = await d2cBackendSourceFingerprint(project);
       if (fingerprint2 !== void 0) this.#d2cMockSourceFingerprints.set(task, fingerprint2);
-      const environmentPath = join42(project, ".env.local");
+      const environmentPath = join43(project, ".env.local");
       const existingEnvironment = await readFile35(environmentPath, "utf8").catch(() => "");
       const environment = `${existingEnvironment.split(/\r?\n/).filter((line) => !/^\s*VITE_API_BASE_URL\s*=/.test(line)).join("\n").trim()}
 VITE_API_BASE_URL=${running.url}
@@ -30215,7 +30494,7 @@ VITE_API_BASE_URL=${running.url}
     const readyPreview = this.#d2cPreviews.get(task);
     const readyMock = this.#d2cMocks.get(task);
     if (readyPreview === void 0 || readyMock === void 0) throw new Error("D2C preview or backend service is unavailable after synchronization");
-    const manifestPath = join42(taskDir(workspace, task), "design", "interaction-manifest.json");
+    const manifestPath = join43(taskDir(workspace, task), "design", "interaction-manifest.json");
     const manifest = parseInteractionManifest(await readFile35(manifestPath, "utf8"));
     const baseline = await this.#verifyAcceptanceBaseline(workspace, task);
     const coverage = baseline === void 0 ? void 0 : verifyRequirementCoverage(baseline.approvedPrd.criteria, manifest);
@@ -30227,7 +30506,7 @@ VITE_API_BASE_URL=${running.url}
       await mkdir27(planDir, { recursive: true });
       try {
         const observations = await this.#observeD2cPages(manifest, readyPreview.url);
-        const prd = await readFile35(join42(taskDir(workspace, task), "product", "prd.md"), "utf8").catch(() => void 0);
+        const prd = await readFile35(join43(taskDir(workspace, task), "product", "prd.md"), "utf8").catch(() => void 0);
         const apiContext = JSON.stringify({ openapi: workflow.openapi, mappings: workflow.mappings }, null, 2);
         const plan = await this.#d2cJudge.planInteractions({ task, seed: manifest, observations, ...prd === void 0 ? {} : { prd }, apiContext });
         executableManifest = mergeInteractionManifests(manifest, plan.manifest);
@@ -30238,9 +30517,9 @@ VITE_API_BASE_URL=${running.url}
           plannedScenarios: executableManifest.pages.reduce((total, page) => total + page.scenarios.length, 0),
           pageAnalyses: plan.pageAnalyses
         };
-        await writeFile17(join42(planDir, "autonomous-interaction-plan.json"), `${JSON.stringify({ ...plan, manifest: executableManifest }, null, 2)}
+        await writeFile17(join43(planDir, "autonomous-interaction-plan.json"), `${JSON.stringify({ ...plan, manifest: executableManifest }, null, 2)}
 `, { encoding: "utf8", mode: 384 });
-        await rm15(join42(planDir, "autonomous-interaction-diagnostic.json"), { force: true });
+        await rm15(join43(planDir, "autonomous-interaction-diagnostic.json"), { force: true });
       } catch (cause) {
         const detail = message(cause);
         review = {
@@ -30248,8 +30527,8 @@ VITE_API_BASE_URL=${running.url}
           plannedScenarios: manifest.pages.reduce((total, page) => total + page.scenarios.length, 0),
           warning: `\u591A\u6A21\u6001\u81EA\u4E3B\u89C4\u5212\u5931\u8D25\uFF0C\u5DF2\u7EE7\u7EED\u6267\u884C\u5DF2\u786E\u8BA4\u7684\u8BBE\u8BA1\u5951\u7EA6\uFF1A${detail}`
         };
-        await rm15(join42(planDir, "autonomous-interaction-plan.json"), { force: true });
-        await writeFile17(join42(planDir, "autonomous-interaction-diagnostic.json"), `${JSON.stringify({
+        await rm15(join43(planDir, "autonomous-interaction-plan.json"), { force: true });
+        await writeFile17(join43(planDir, "autonomous-interaction-diagnostic.json"), `${JSON.stringify({
           schema: 1,
           stage: "planning",
           occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -30263,13 +30542,13 @@ VITE_API_BASE_URL=${running.url}
     let result = { ...rawResult, evidenceMode: review.mode };
     if (coverage !== void 0) {
       const evidence = createAcceptanceEvidence(coverage, result);
-      await writeFile17(join42(taskDir(workspace, task), "acceptance-evidence.json"), `${JSON.stringify({ ...evidence, baseline }, null, 2)}
+      await writeFile17(join43(taskDir(workspace, task), "acceptance-evidence.json"), `${JSON.stringify({ ...evidence, baseline }, null, 2)}
 `, { encoding: "utf8", mode: 384 });
       if (!evidence.passed) result = { ...result, passed: false, failures: Math.max(1, result.failures) };
     }
     const dir = integrationDirectory(workspace, task);
     await mkdir27(dir, { recursive: true });
-    await writeFile17(join42(dir, "interaction-results.json"), `${JSON.stringify(result, null, 2)}
+    await writeFile17(join43(dir, "interaction-results.json"), `${JSON.stringify(result, null, 2)}
 `);
     const next = await updateWorkflow(workspace, task, workflow.revision, (current) => applyInteractionRun(current, result));
     return { workflow: next, result, review };
@@ -30282,7 +30561,7 @@ VITE_API_BASE_URL=${running.url}
     if (mock === void 0 || !mock.exited() || result.failures === 0) return result;
     const output = mock.output().trim();
     try {
-      const dir = join42(d2cOutputDirectory(workspace, task), "mock-server.log");
+      const dir = join43(d2cOutputDirectory(workspace, task), "mock-server.log");
       await writeFile17(dir, `${output}
 `);
     } catch {
@@ -30377,7 +30656,7 @@ VITE_API_BASE_URL=${running.url}
     if (current === void 0) throw new Error("D2C product plan is unavailable");
     if (current.plan.approvedPrd !== void 0) throw new Error("The approved PRD is immutable and cannot be edited");
     if (current.plan.phase !== "prd-review") throw new Error("PRD sections can only be edited during PRD review");
-    const path = join42(taskDir(workspace, task), "product", "prd.md");
+    const path = join43(taskDir(workspace, task), "product", "prd.md");
     const updated = await updatePrdSectionFile(path, { sectionId, body, expectedHash });
     const now = (/* @__PURE__ */ new Date()).toISOString();
     await writeD2cProductPlan(workspace, {
@@ -30397,33 +30676,33 @@ VITE_API_BASE_URL=${running.url}
   async #assertProductPrdLocked(workspace, task) {
     const current = await readD2cProductPlanView(workspace, task);
     if (current?.plan.approvedPrd === void 0) return;
-    await assertApprovedPrd(join42(taskDir(workspace, task), "product", "prd.md"), current.plan.approvedPrd);
+    await assertApprovedPrd(join43(taskDir(workspace, task), "product", "prd.md"), current.plan.approvedPrd);
   }
   async #acceptancePaths(workspace, task) {
-    const product = join42(taskDir(workspace, task), "product");
-    const openapi = join42(product, "openapi.json");
+    const product = join43(taskDir(workspace, task), "product");
+    const openapi = join43(product, "openapi.json");
     return {
-      prd: join42(product, "prd.md"),
-      prototype: join42(product, "prototype", "index.html"),
-      interaction: join42(product, "prototype", "interaction-manifest.json"),
-      ...await stat14(openapi).catch(() => void 0) === void 0 ? {} : { openapi }
+      prd: join43(product, "prd.md"),
+      prototype: join43(product, "prototype", "index.html"),
+      interaction: join43(product, "prototype", "interaction-manifest.json"),
+      ...await stat15(openapi).catch(() => void 0) === void 0 ? {} : { openapi }
     };
   }
   async #verifyAcceptanceBaseline(workspace, task) {
     const product = await readD2cProductPlanView(workspace, task);
     if (product?.plan.approvedPrd === void 0) return void 0;
     await this.#assertProductPrdLocked(workspace, task);
-    const baseline = JSON.parse(await readFile35(join42(taskDir(workspace, task), "acceptance-baseline.json"), "utf8"));
+    const baseline = JSON.parse(await readFile35(join43(taskDir(workspace, task), "acceptance-baseline.json"), "utf8"));
     await verifyAcceptanceBaseline(await this.#acceptancePaths(workspace, task), baseline);
-    const design = join42(taskDir(workspace, task), "design");
+    const design = join43(taskDir(workspace, task), "design");
     await Promise.all([
-      verifyAcceptanceArtifact(join42(design, "index.html"), baseline.artifacts.prototype, "runtime prototype"),
-      verifyAcceptanceArtifact(join42(design, "interaction-manifest.json"), baseline.artifacts.interaction, "runtime interaction contract")
+      verifyAcceptanceArtifact(join43(design, "index.html"), baseline.artifacts.prototype, "runtime prototype"),
+      verifyAcceptanceArtifact(join43(design, "interaction-manifest.json"), baseline.artifacts.interaction, "runtime interaction contract")
     ]);
     const workflow = await readWorkflow(workspace, task);
     if (workflow?.openapi !== void 0) {
       await verifyAcceptanceArtifact(
-        join42(taskDir(workspace, task), "integration", "swagger.json"),
+        join43(taskDir(workspace, task), "integration", "swagger.json"),
         { hash: workflow.openapi.hash },
         "runtime OpenAPI contract"
       );
@@ -30444,14 +30723,14 @@ VITE_API_BASE_URL=${running.url}
       throw new Error("D2C PRD is empty and cannot be accepted");
     }
     if (stage === "design" && accepted) {
-      const manifest = join42(d2cProductPrototypeDirectory(workspace, task), "interaction-manifest.json");
+      const manifest = join43(d2cProductPrototypeDirectory(workspace, task), "interaction-manifest.json");
       const normalizedManifest = parseInteractionManifest(await readFile35(manifest, "utf8"));
       if (current.plan.approvedPrd === void 0) throw new Error("Approve the PRD before confirming the design");
       verifyRequirementCoverage(current.plan.approvedPrd.criteria, normalizedManifest);
       await writeFile17(manifest, `${JSON.stringify(normalizedManifest, null, 2)}
 `, { encoding: "utf8", mode: 384 });
       const baseline = await captureAcceptanceBaseline(await this.#acceptancePaths(workspace, task), current.plan.approvedPrd);
-      await writeFile17(join42(taskDir(workspace, task), "acceptance-baseline.json"), `${JSON.stringify(baseline, null, 2)}
+      await writeFile17(join43(taskDir(workspace, task), "acceptance-baseline.json"), `${JSON.stringify(baseline, null, 2)}
 `, { encoding: "utf8", mode: 384 });
     }
     const plan = await writeD2cProductPlan(
@@ -30485,8 +30764,8 @@ VITE_API_BASE_URL=${running.url}
     const imported = await this.importD2cDesign(task, d2cProductPrototypeDirectory(workspace, task));
     const delivery = await readDeliveryRun(workspace, task);
     if (delivery !== void 0) {
-      const prototype = await readFile35(join42(d2cProductPrototypeDirectory(workspace, task), "index.html"), "utf8");
-      const interaction = await readFile35(join42(d2cProductPrototypeDirectory(workspace, task), "interaction-manifest.json"), "utf8");
+      const prototype = await readFile35(join43(d2cProductPrototypeDirectory(workspace, task), "index.html"), "utf8");
+      const interaction = await readFile35(join43(d2cProductPrototypeDirectory(workspace, task), "interaction-manifest.json"), "utf8");
       const completed = await updateDeliveryRun(workspace, task, delivery.revision, (run) => completeDeliveryNode(run, "design", [
         artifactRef("product/prototype/index.html", prototype),
         artifactRef("product/prototype/interaction-manifest.json", interaction)
@@ -30570,10 +30849,10 @@ VITE_API_BASE_URL=${running.url}
     const next = await updateWorkflow(workspace, task, workflow.revision, (current) => applyQualityJudgment(current, judgment));
     const qualityContent = `${JSON.stringify(judgment, null, 2)}
 `;
-    await writeFile17(join42(taskDir(workspace, task), "quality-judge.json"), qualityContent, { encoding: "utf8", mode: 384 });
+    await writeFile17(join43(taskDir(workspace, task), "quality-judge.json"), qualityContent, { encoding: "utf8", mode: 384 });
     const delivery = await readDeliveryRun(workspace, task);
     if (next.stage === "completed" && delivery?.nodes.acceptance.status === "running") {
-      const interactionContent = await readFile35(join42(integrationDirectory(workspace, task), "interaction-results.json"), "utf8");
+      const interactionContent = await readFile35(join43(integrationDirectory(workspace, task), "interaction-results.json"), "utf8");
       const accepted = await updateDeliveryRun(workspace, task, delivery.revision, (run) => completeDeliveryNode(run, "acceptance", [
         artifactRef("integration/interaction-results.json", interactionContent),
         artifactRef("quality-judge.json", qualityContent)
@@ -30755,14 +31034,14 @@ function desktopWindowChrome(platform = process.platform) {
 
 // src/utils/crash-guard.ts
 import { mkdirSync as mkdirSync3, writeFileSync } from "fs";
-import { join as join43 } from "path";
+import { join as join44 } from "path";
 var installed = false;
 function installCrashGuard(options = {}) {
   if (installed) return;
   installed = true;
   const crashLogDir = () => {
     try {
-      return join43((options.workspace ?? process.cwd)(), ".flavor");
+      return join44((options.workspace ?? process.cwd)(), ".flavor");
     } catch {
       return process.cwd();
     }
@@ -30771,7 +31050,7 @@ function installCrashGuard(options = {}) {
     try {
       const dir = crashLogDir();
       mkdirSync3(dir, { recursive: true });
-      const path = join43(dir, `crash-${(/* @__PURE__ */ new Date()).toISOString().replace(/[^0-9]/g, "")}-${process.pid}.log`);
+      const path = join44(dir, `crash-${(/* @__PURE__ */ new Date()).toISOString().replace(/[^0-9]/g, "")}-${process.pid}.log`);
       writeFileSync(path, [
         `kind: ${kind}`,
         `version: ${process.version}`,
@@ -30816,7 +31095,7 @@ ${reason.stack ?? ""}`;
 
 // src/desktop/git-manager.ts
 import { readFile as readFile36, rm as rm16 } from "fs/promises";
-import { isAbsolute as isAbsolute18, relative as relative26, resolve as resolve36 } from "path";
+import { isAbsolute as isAbsolute18, relative as relative26, resolve as resolve37 } from "path";
 function failure(action, stderr, stdout) {
   return new Error(`${action}\u5931\u8D25\uFF1A${(stderr.trim() || stdout.trim() || "\u672A\u77E5 Git \u9519\u8BEF").split("\n")[0]}`);
 }
@@ -30909,13 +31188,13 @@ async function desktopLastTurnDiff(workspace, sessionId, paths = []) {
     return path.replaceAll("\\", "/");
   }));
   try {
-    const tree = JSON.parse(await readFile36(resolve36(workspace, ".flavor", "session-trees", sessionId, "tree.json"), "utf8"));
+    const tree = JSON.parse(await readFile36(resolve37(workspace, ".flavor", "session-trees", sessionId, "tree.json"), "utf8"));
     const leaf = tree.nodes?.find((node) => node.id === tree.leafId);
     const parent = leaf?.parentId == null ? void 0 : tree.nodes?.find((node) => node.id === leaf.parentId);
     if (leaf === void 0 || parent === void 0) return desktopGitReviewDiff(workspace, { scope: "last-turn", paths });
     const load = async (id) => {
       if (!/^checkpoint-[A-Za-z0-9-]+$/.test(id)) throw new Error("Invalid checkpoint id");
-      return JSON.parse(await readFile36(resolve36(workspace, ".flavor", "checkpoints", "manifests", `${id}.json`), "utf8"));
+      return JSON.parse(await readFile36(resolve37(workspace, ".flavor", "checkpoints", "manifests", `${id}.json`), "utf8"));
     };
     const [before, after] = await Promise.all([load(parent.checkpointId), load(leaf.checkpointId)]);
     const oldFiles = new Map(before.files.map((file) => [file.path, file.digest]));
@@ -30924,7 +31203,7 @@ async function desktopLastTurnDiff(workspace, sessionId, paths = []) {
     const object = async (digest) => {
       if (digest === void 0) return "";
       if (!/^[a-f0-9]{64}$/.test(digest)) throw new Error("Invalid checkpoint object");
-      const value = await readFile36(resolve36(workspace, ".flavor", "checkpoints", "objects", digest));
+      const value = await readFile36(resolve37(workspace, ".flavor", "checkpoints", "objects", digest));
       return value.includes(0) ? "[binary content]" : value.toString("utf8");
     };
     const chunks = await Promise.all(changed.map(async (path) => wholeFileDiff(path, await object(oldFiles.get(path)), await object(newFiles.get(path)))));
@@ -30949,8 +31228,8 @@ async function assertListed(workspace, path) {
 }
 function safeWorkspacePath(workspace, path) {
   if (isAbsolute18(path)) throw new Error("Git \u6587\u4EF6\u8DEF\u5F84\u5FC5\u987B\u662F\u9879\u76EE\u5185\u7684\u76F8\u5BF9\u8DEF\u5F84");
-  const root = resolve36(workspace);
-  const target = resolve36(root, path);
+  const root = resolve37(workspace);
+  const target = resolve37(root, path);
   const child = relative26(root, target);
   if (child === "" || child.startsWith("..") || isAbsolute18(child)) throw new Error("\u62D2\u7EDD\u8BBF\u95EE\u9879\u76EE\u4E4B\u5916\u7684\u8DEF\u5F84");
   return target;
@@ -30963,14 +31242,14 @@ function safeGitTarget(value) {
 
 // src/desktop/worktree-manager.ts
 import { randomUUID as randomUUID28 } from "crypto";
-import { mkdir as mkdir28, readFile as readFile37, readdir as readdir13, rm as rm17, stat as stat15, writeFile as writeFile18 } from "fs/promises";
-import { basename as basename10, isAbsolute as isAbsolute19, join as join44, relative as relative27, resolve as resolve37, sep as sep27 } from "path";
+import { mkdir as mkdir28, readFile as readFile37, readdir as readdir13, rm as rm17, stat as stat16, writeFile as writeFile18 } from "fs/promises";
+import { basename as basename10, isAbsolute as isAbsolute19, join as join45, relative as relative27, resolve as resolve38, sep as sep27 } from "path";
 var DesktopWorktreeManager = class {
   #repository;
   #storage;
   constructor(options) {
-    this.#repository = resolve37(options.repository);
-    this.#storage = resolve37(options.storage);
+    this.#repository = resolve38(options.repository);
+    this.#storage = resolve38(options.storage);
   }
   async create(label) {
     if (!await isGitRepository(this.#repository)) throw new Error("Task worktrees require a Git repository");
@@ -31010,8 +31289,8 @@ var DesktopWorktreeManager = class {
     }
     const values = await Promise.all(names.filter((name) => name.endsWith(".json")).map(async (name) => {
       try {
-        const stored = validateStored(JSON.parse(await readFile37(join44(this.#storage, name), "utf8")), this.#repository, this.#storage);
-        if ((await stat15(stored.path).catch(() => void 0))?.isDirectory() !== true) return void 0;
+        const stored = validateStored(JSON.parse(await readFile37(join45(this.#storage, name), "utf8")), this.#repository, this.#storage);
+        if ((await stat16(stored.path).catch(() => void 0))?.isDirectory() !== true) return void 0;
         const status = await git2(stored.path, ["status", "--porcelain"]);
         const merged = await git2(this.#repository, ["merge-base", "--is-ancestor", stored.branch, "HEAD"]);
         const { version: _version, ...item } = stored;
@@ -31051,7 +31330,7 @@ var DesktopWorktreeManager = class {
     return this.#safeStoragePath(`${id}.json`);
   }
   #safeStoragePath(name) {
-    const target = resolve37(this.#storage, name);
+    const target = resolve38(this.#storage, name);
     const delta = relative27(this.#storage, target);
     if (delta === "" || delta === ".." || delta.startsWith(`..${sep27}`) || isAbsolute19(delta)) throw new Error("Worktree path escapes storage");
     return target;
@@ -31060,10 +31339,10 @@ var DesktopWorktreeManager = class {
 function validateStored(value, repository, storage) {
   if (typeof value !== "object" || value === null) throw new Error("Invalid worktree metadata");
   const item = value;
-  if (item.version !== 1 || item.mode !== "worktree" || typeof item.id !== "string" || typeof item.path !== "string" || typeof item.branch !== "string" || typeof item.createdAt !== "string" || resolve37(item.repository ?? "") !== repository) {
+  if (item.version !== 1 || item.mode !== "worktree" || typeof item.id !== "string" || typeof item.path !== "string" || typeof item.branch !== "string" || typeof item.createdAt !== "string" || resolve38(item.repository ?? "") !== repository) {
     throw new Error("Invalid worktree metadata");
   }
-  const path = resolve37(item.path);
+  const path = resolve38(item.path);
   const delta = relative27(storage, path);
   if (delta === "" || delta === ".." || delta.startsWith(`..${sep27}`) || isAbsolute19(delta) || basename10(path) !== item.id) {
     throw new Error("Worktree metadata escapes storage");
@@ -31072,17 +31351,17 @@ function validateStored(value, repository, storage) {
 }
 
 // src/desktop/workbench-service.ts
-import { readFile as readFile38, readdir as readdir14, stat as stat16 } from "fs/promises";
+import { readFile as readFile38, readdir as readdir14, stat as stat17 } from "fs/promises";
 import { homedir as homedir5 } from "os";
-import { join as join45, resolve as resolve38 } from "path";
+import { join as join46, resolve as resolve39 } from "path";
 var MAX_TEXT = 128e3;
 var MAX_ITEMS = 200;
 var DesktopWorkbenchService = class {
   #workspace;
   #home;
   constructor(workspace, home = homedir5()) {
-    this.#workspace = resolve38(workspace);
-    this.#home = resolve38(home);
+    this.#workspace = resolve39(workspace);
+    this.#home = resolve39(home);
   }
   async inspect(sessionId) {
     const [goals, instructions, permissionFiles, audit, context] = await Promise.all([
@@ -31107,11 +31386,11 @@ var DesktopWorkbenchService = class {
     return url.toString().replace(/\/$/, input.trim().endsWith("/") ? "/" : "");
   }
   async #goals() {
-    const root = join45(this.#workspace, ".flavor", "goals");
+    const root = join46(this.#workspace, ".flavor", "goals");
     const names = await readdir14(root).catch((error) => error.code === "ENOENT" ? [] : Promise.reject(error));
     const values = await Promise.all(names.filter((name) => /^goal-[A-Za-z0-9._-]+\.json$/.test(name)).slice(0, MAX_ITEMS).map(async (name) => {
       try {
-        return GoalStateSchema.parse(JSON.parse(await boundedRead2(join45(root, name))));
+        return GoalStateSchema.parse(JSON.parse(await boundedRead2(join46(root, name))));
       } catch {
         return void 0;
       }
@@ -31121,7 +31400,7 @@ var DesktopWorkbenchService = class {
   async #instructions() {
     const names = ["FLAVOR.md", "AGENTS.md", "CLAUDE.md", "AGENTS.local.md", "CLAUDE.local.md"];
     const items = await Promise.all(names.map(async (name) => {
-      const path = join45(this.#workspace, name);
+      const path = join46(this.#workspace, name);
       try {
         return { name, path, content: redactErrorText(await boundedRead2(path)) };
       } catch (error) {
@@ -31133,10 +31412,10 @@ var DesktopWorkbenchService = class {
   }
   async #permissionFiles() {
     const candidates = [
-      ...process.env.FLAVOR_MANAGED_PERMISSIONS ? [{ tier: "managed", path: resolve38(process.env.FLAVOR_MANAGED_PERMISSIONS), content: "" }] : [],
-      { tier: "user", path: join45(this.#home, ".flavor-code", "permissions.json"), content: "" },
-      { tier: "project", path: join45(this.#workspace, ".flavor", "permissions.json"), content: "" },
-      { tier: "local", path: join45(this.#workspace, ".flavor", "permissions.local.json"), content: "" }
+      ...process.env.FLAVOR_MANAGED_PERMISSIONS ? [{ tier: "managed", path: resolve39(process.env.FLAVOR_MANAGED_PERMISSIONS), content: "" }] : [],
+      { tier: "user", path: join46(this.#home, ".flavor-code", "permissions.json"), content: "" },
+      { tier: "project", path: join46(this.#workspace, ".flavor", "permissions.json"), content: "" },
+      { tier: "local", path: join46(this.#workspace, ".flavor", "permissions.local.json"), content: "" }
     ];
     const values = await Promise.all(candidates.map(async (item) => {
       try {
@@ -31151,7 +31430,7 @@ var DesktopWorkbenchService = class {
   async #audit() {
     let raw;
     try {
-      raw = await boundedRead2(join45(this.#workspace, ".flavor", "audit.jsonl"));
+      raw = await boundedRead2(join46(this.#workspace, ".flavor", "audit.jsonl"));
     } catch (error) {
       if (error.code === "ENOENT") return [];
       throw error;
@@ -31166,7 +31445,7 @@ var DesktopWorkbenchService = class {
     }).reverse();
   }
   async #context(sessionId) {
-    const usage = await readJsonLines2(join45(this.#workspace, ".flavor", "usage.jsonl"));
+    const usage = await readJsonLines2(join46(this.#workspace, ".flavor", "usage.jsonl"));
     if (sessionId === void 0) return { visibility: [], usage };
     try {
       const document = await new SessionStore({ workspace: this.#workspace }).load(sessionId);
@@ -31177,7 +31456,7 @@ var DesktopWorkbenchService = class {
   }
 };
 async function boundedRead2(path) {
-  const info = await stat16(path);
+  const info = await stat17(path);
   if (!info.isFile()) throw new Error(`Expected a file: ${path}`);
   if (info.size > MAX_TEXT) throw new Error(`Workbench file exceeds ${MAX_TEXT} bytes: ${path}`);
   return readFile38(path, "utf8");
@@ -31204,82 +31483,6 @@ function redact2(value, key = "") {
   return typeof value === "string" && value.length > MAX_TEXT ? `${value.slice(0, MAX_TEXT)}\u2026` : value;
 }
 
-// src/desktop/astgraph-service.ts
-import { stat as stat17 } from "fs/promises";
-import { createRequire as nodeCreateRequire2 } from "module";
-import { join as join46, resolve as resolve39 } from "path";
-var FIELDS = "id, kind, name, qualified_name, file_path, language, start_line, end_line, signature";
-var DesktopAstGraphService = class {
-  #path;
-  constructor(workspace) {
-    this.#path = join46(resolve39(workspace), ".flavor", "astgraph", "index.db");
-  }
-  async status() {
-    if ((await stat17(this.#path).catch(() => void 0))?.isFile() !== true) {
-      return { available: false, path: this.#path, files: 0, nodes: 0, edges: 0 };
-    }
-    return this.#read((db) => {
-      const count = (table) => Number(db.prepare(`SELECT COUNT(*) AS count FROM ${table}`).get().count);
-      const metadata = db.prepare("SELECT value FROM project_metadata WHERE key = 'last_index'").get();
-      let indexedAt;
-      try {
-        const at = Number(JSON.parse(metadata?.value ?? "{}").at);
-        if (Number.isFinite(at)) indexedAt = new Date(at).toISOString();
-      } catch {
-      }
-      return { available: true, path: this.#path, files: count("files"), nodes: count("nodes"), edges: count("edges"), ...indexedAt === void 0 ? {} : { indexedAt } };
-    });
-  }
-  async search(query, limit = 40) {
-    const value = query.trim().slice(0, 200);
-    if (value.length === 0 || !(await this.status()).available) return [];
-    return this.#read((db) => db.prepare(`SELECT ${FIELDS} FROM nodes WHERE lower(name) LIKE ? OR lower(qualified_name) LIKE ? ORDER BY CASE WHEN lower(name) = ? THEN 0 ELSE 1 END, name LIMIT ?`).all(`%${value.toLowerCase()}%`, `%${value.toLowerCase()}%`, value.toLowerCase(), Math.min(Math.max(limit, 1), 100)).map(mapNode));
-  }
-  async relations(id, hops = 2) {
-    if (!/^[A-Za-z0-9._:/#@+~-]{1,512}$/.test(id)) throw new Error("Invalid AST node id");
-    if (!(await this.status()).available) return { callers: [], callees: [], impact: [] };
-    return this.#read((db) => {
-      const originRow = db.prepare(`SELECT ${FIELDS} FROM nodes WHERE id = ?`).get(id);
-      const linked = (direction) => {
-        const source = direction === "callers" ? "e.source" : "e.target";
-        const predicate = direction === "callers" ? "e.target = ?" : "e.source = ?";
-        return db.prepare(`SELECT DISTINCT n.${FIELDS.split(", ").join(", n.")} FROM edges e JOIN nodes n ON n.id = ${source} WHERE ${predicate} AND e.kind IN ('calls','imports') LIMIT 100`).all(id).map(mapNode);
-      };
-      const seen = /* @__PURE__ */ new Map();
-      let frontier = [id];
-      for (let hop = 1; hop <= Math.min(Math.max(hops, 1), 4) && frontier.length > 0 && seen.size < 200; hop += 1) {
-        const next = [];
-        for (const current of frontier) {
-          const rows = db.prepare("SELECT source AS other FROM edges WHERE target = ? UNION SELECT target AS other FROM edges WHERE source = ? LIMIT 200").all(current, current);
-          for (const row of rows) if (row.other !== id && !seen.has(row.other)) {
-            seen.set(row.other, hop);
-            next.push(row.other);
-          }
-        }
-        frontier = next;
-      }
-      const impact = [...seen].flatMap(([nodeId, hop]) => {
-        const row = db.prepare(`SELECT ${FIELDS} FROM nodes WHERE id = ?`).get(nodeId);
-        return row === void 0 ? [] : [{ ...mapNode(row), hop }];
-      });
-      return { ...originRow === void 0 ? {} : { origin: mapNode(originRow) }, callers: linked("callers"), callees: linked("callees"), impact };
-    });
-  }
-  #read(run) {
-    const sqlite = nodeCreateRequire2(import.meta.url)("node:sqlite");
-    const db = new sqlite.DatabaseSync(this.#path, { readOnly: true });
-    try {
-      return run(db);
-    } finally {
-      db.close();
-    }
-  }
-};
-function mapNode(value) {
-  const row = value;
-  return { id: String(row.id), kind: String(row.kind), name: String(row.name), qualifiedName: String(row.qualified_name), filePath: String(row.file_path), language: String(row.language), startLine: Number(row.start_line), endLine: Number(row.end_line), ...row.signature == null ? {} : { signature: String(row.signature) } };
-}
-
 // src/desktop/main.ts
 installCrashGuard();
 var moduleDirectory = dirname24(fileURLToPath4(import.meta.url));