@hasna/todos 0.11.69 → 0.11.71

package/dist/index.js

@@ -1198,6 +1198,11 @@ var init_migrations = __esm(() => {
   CREATE INDEX IF NOT EXISTS idx_storage_tombstones_object ON storage_tombstones(object_type, object_id);
   CREATE INDEX IF NOT EXISTS idx_storage_tombstones_updated ON storage_tombstones(updated_at);
   INSERT OR IGNORE INTO _migrations (id) VALUES (63);
+  `,
+    `
+  ALTER TABLE plans ADD COLUMN slug TEXT;
+  CREATE INDEX IF NOT EXISTS idx_plans_slug ON plans(slug);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (64);
   `
   ];
 });
@@ -1221,6 +1226,29 @@ function runMigrations(db) {
   }
   ensureSchema(db);
 }
+function planSlugBase(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "plan";
+}
+function backfillPlanSlugs(db) {
+  try {
+    const rows = db.query("SELECT id, project_id, name, slug FROM plans ORDER BY created_at ASC, id ASC").all();
+    const used = new Set;
+    for (const row of rows) {
+      const scope = row.project_id ?? "__global__";
+      const base = planSlugBase(row.slug || row.name);
+      let candidate = base;
+      let suffix = 2;
+      while (used.has(`${scope}:${candidate}`)) {
+        candidate = `${base}-${suffix}`;
+        suffix += 1;
+      }
+      used.add(`${scope}:${candidate}`);
+      if (row.slug !== candidate) {
+        db.run("UPDATE plans SET slug = ? WHERE id = ?", [candidate, row.id]);
+      }
+    }
+  } catch {}
+}
 function ensureSchema(db) {
   const ensureColumn = (table, column, type) => {
     try {
@@ -1270,7 +1298,8 @@ function ensureSchema(db) {
     )`);
   ensureTable("plans", `
     CREATE TABLE plans (
-      id TEXT PRIMARY KEY, project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+      id TEXT PRIMARY KEY, slug TEXT,
+      project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
       task_list_id TEXT, agent_id TEXT,
       name TEXT NOT NULL, description TEXT,
       status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'completed', 'archived')),
@@ -1785,8 +1814,10 @@ function ensureSchema(db) {
   ensureColumn("agents", "org_id", "TEXT");
   ensureColumn("agents", "capabilities", "TEXT DEFAULT '[]'");
   ensureColumn("projects", "org_id", "TEXT");
+  ensureColumn("plans", "slug", "TEXT");
   ensureColumn("plans", "task_list_id", "TEXT");
   ensureColumn("plans", "agent_id", "TEXT");
+  backfillPlanSlugs(db);
   ensureColumn("task_templates", "variables", "TEXT DEFAULT '[]'");
   ensureColumn("task_templates", "version", "INTEGER NOT NULL DEFAULT 1");
   ensureColumn("template_tasks", "condition", "TEXT");
@@ -1901,6 +1932,8 @@ function ensureSchema(db) {
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_tags_name ON tags(name)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_plans_project ON plans(project_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_plans_status ON plans(status)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_plans_slug ON plans(slug)");
+  ensureIndex("CREATE UNIQUE INDEX IF NOT EXISTS idx_plans_scope_slug ON plans(COALESCE(project_id, ''), slug) WHERE slug IS NOT NULL");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_plans_task_list ON plans(task_list_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_plans_agent ON plans(agent_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_history_task ON task_history(task_id)");
@@ -2734,6 +2767,9 @@ function clearExpiredLocks(db) {
   const cutoff = lockExpiryCutoff();
   db.run("UPDATE tasks SET locked_by = NULL, locked_at = NULL WHERE locked_at IS NOT NULL AND locked_at < ?", [cutoff]);
 }
+function slugifyRef(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
 function resolvePartialId(db, table, partialId) {
   if (!ALLOWED_TABLES.has(table)) {
     throw new Error(`Invalid table name: ${table}`);
@@ -2760,6 +2796,16 @@ function resolvePartialId(db, table, partialId) {
     if (slugRow)
       return slugRow.id;
   }
+  if (table === "plans") {
+    const slug = slugifyRef(partialId);
+    if (slug) {
+      const slugRows = db.query("SELECT id FROM plans WHERE slug = ?").all(slug);
+      if (slugRows.length === 1)
+        return slugRows[0].id;
+      if (slugRows.length > 1)
+        return null;
+    }
+  }
   if (table === "projects") {
     const nameRow = db.query("SELECT id FROM projects WHERE lower(name) = ?").get(partialId.toLowerCase());
     if (nameRow)
@@ -10736,15 +10782,59 @@ init_database();
 // src/db/plans.ts
 init_types();
 init_database();
+function planSlugBase2(value) {
+  return slugify(value) || "plan";
+}
+function normalizePlanSlug(value) {
+  const slug = slugify(value);
+  if (!slug)
+    throw new Error("Invalid plan slug");
+  return slug;
+}
+function plansBySlug(slug, db, projectId) {
+  if (projectId !== undefined) {
+    if (projectId === null) {
+      return db.query("SELECT * FROM plans WHERE slug = ? AND project_id IS NULL ORDER BY created_at ASC, id ASC").all(slug);
+    }
+    return db.query("SELECT * FROM plans WHERE slug = ? AND project_id = ? ORDER BY created_at ASC, id ASC").all(slug, projectId);
+  }
+  return db.query("SELECT * FROM plans WHERE slug = ? ORDER BY created_at ASC, id ASC").all(slug);
+}
+function planSlugExists(slug, projectId, db, excludeId) {
+  const rows = plansBySlug(slug, db, projectId);
+  return rows.some((plan) => plan.id !== excludeId);
+}
+function nextPlanSlug(base, projectId, db, excludeId) {
+  let candidate = base;
+  let suffix = 2;
+  while (planSlugExists(candidate, projectId, db, excludeId)) {
+    candidate = `${base}-${suffix}`;
+    suffix += 1;
+  }
+  return candidate;
+}
+function resolveCreateSlug(input, projectId, db) {
+  if (input.slug !== undefined) {
+    const slug = normalizePlanSlug(input.slug);
+    if (planSlugExists(slug, projectId, db)) {
+      throw new Error(`Plan slug already exists in this scope: ${slug}`);
+    }
+    return slug;
+  }
+  return nextPlanSlug(planSlugBase2(input.name), projectId, db);
+}
 function createPlan(input, db) {
   const d = db || getDatabase();
   const id = uuid();
   const timestamp = now();
+  const projectId = input.project_id || null;
+  const slug = resolveCreateSlug(input, projectId, d);
   const machineId = currentStorageMachineId(d);
-  d.run(`INSERT INTO plans (id, project_id, task_list_id, agent_id, name, description, status, created_at, updated_at, machine_id)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+  d.run(`INSERT INTO plans (id, slug, project_id, task_list_id, agent_id, name, description, status, created_at, updated_at, machine_id)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
     id,
-    input.project_id || null,
+    slug,
+    projectId,
     input.task_list_id || null,
     input.agent_id || null,
     input.name,
@@ -10779,6 +10869,14 @@ function updatePlan(id, input, db) {
     sets.push("name = ?");
     params.push(input.name);
   }
+  if (input.slug !== undefined) {
+    const slug = normalizePlanSlug(input.slug);
+    if (planSlugExists(slug, plan.project_id, d, id)) {
+      throw new Error(`Plan slug already exists in this scope: ${slug}`);
+    }
+    sets.push("slug = ?");
+    params.push(slug);
+  }
   if (input.description !== undefined) {
     sets.push("description = ?");
     params.push(input.description);
@@ -12632,7 +12730,7 @@ var dataKeys = [
 var insertColumns = {
   projects: ["id", "name", "path", "description", "task_list_id", "task_prefix", "task_counter", "created_at", "updated_at", "machine_id", "synced_at"],
   task_lists: ["id", "project_id", "slug", "name", "description", "metadata", "created_at", "updated_at", "machine_id", "synced_at"],
-  plans: ["id", "project_id", "task_list_id", "agent_id", "name", "description", "status", "created_at", "updated_at", "machine_id", "synced_at"],
+  plans: ["id", "slug", "project_id", "task_list_id", "agent_id", "name", "description", "status", "created_at", "updated_at", "machine_id", "synced_at"],
   tasks: [
     "id",
     "short_id",
@@ -12924,6 +13022,36 @@ function prepareValue(column, value) {
     return JSON.stringify(value ?? (column === "tags" || column === "files_changed" ? [] : {}));
   return value === undefined ? null : value;
 }
+function slugifyPlanValue(value) {
+  return typeof value === "string" ? value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") : "";
+}
+function planSlugBase3(plan) {
+  return slugifyPlanValue(plan.slug) || slugifyPlanValue(plan.name) || "plan";
+}
+function planSlugScope(projectId) {
+  return typeof projectId === "string" && projectId ? projectId : "__global__";
+}
+function planSlugKey(projectId, slug) {
+  return `${planSlugScope(projectId)}:${slug}`;
+}
+function normalizeBridgePlanSlugs(plans, db) {
+  const existingRows = db.query("SELECT id, project_id, slug FROM plans WHERE slug IS NOT NULL").all();
+  const existingIds = new Set(existingRows.map((row) => row.id));
+  const used = new Set(existingRows.filter((row) => row.slug).map((row) => planSlugKey(row.project_id, row.slug)));
+  return plans.map((plan) => {
+    if (existingIds.has(plan.id))
+      return plan;
+    const base = planSlugBase3(plan);
+    let candidate = base;
+    let suffix = 2;
+    while (used.has(planSlugKey(plan.project_id, candidate))) {
+      candidate = `${base}-${suffix}`;
+      suffix += 1;
+    }
+    used.add(planSlugKey(plan.project_id, candidate));
+    return { ...plan, slug: candidate };
+  });
+}
 function insertRecord(db, tableKey, row) {
   const table = tableByKey[tableKey];
   const columns = insertColumns[tableKey];
@@ -13060,6 +13188,7 @@ function importLocalBridgeBundle(bundle, options = {}, db) {
   const conflictStrategy = options.conflictStrategy ?? "skip";
   const data = {
     ...bundle.data,
+    plans: normalizeBridgePlanSlugs(bundle.data.plans, d),
     tasks: sortedTasks(bundle.data.tasks),
     saved_views: bundle.data.saved_views ?? [],
     task_boards: bundle.data.task_boards ?? [],
@@ -13253,6 +13382,7 @@ function createAgentProjectDemoBundle() {
   });
   data.plans.push({
     id: ids.plan,
+    slug: "ship-local-demo-workflow",
     project_id: ids.project,
     task_list_id: ids.list,
     agent_id: "demo-agent",
@@ -23380,9 +23510,17 @@ async function updateProject2(id, input, store) {
 }
 async function createPlan2(input, store, context) {
   const timestamp2 = new Date().toISOString();
+  const projectId = input.project_id ?? context?.projectId ?? null;
+  const slug = await resolvePostgresPlanSlug({
+    name: input.name,
+    slug: input.slug,
+    projectId,
+    store
+  });
   return store.upsert("plans", {
     id: randomUUID3(),
-    project_id: input.project_id ?? context?.projectId ?? null,
+    slug,
+    project_id: projectId,
     task_list_id: input.task_list_id ?? context?.taskListId ?? null,
     agent_id: input.agent_id ?? context?.agentId ?? null,
     name: input.name,
@@ -23396,7 +23534,17 @@ async function createPlan2(input, store, context) {
 }
 async function updatePlan2(id, input, store) {
   const plan = await requireRecord("plans", id, store);
-  return store.upsert("plans", { ...plan, ...definedPatch(input), updated_at: new Date().toISOString() });
+  const patch = definedPatch(input);
+  if (input.slug !== undefined) {
+    patch.slug = await resolvePostgresPlanSlug({
+      name: plan.name,
+      slug: input.slug,
+      projectId: plan.project_id,
+      store,
+      excludeId: id
+    });
+  }
+  return store.upsert("plans", { ...plan, ...patch, updated_at: new Date().toISOString() });
 }
 async function registerAgent2(input, store, context) {
   const existing = (await store.list("agents")).find((agent2) => agent2.name === input.name && agent2.status !== "archived");
@@ -23649,8 +23797,38 @@ function matchesOne(value, expected) {
 function priorityRank(priority) {
   return { critical: 0, high: 1, medium: 2, low: 3 }[priority];
 }
+function slugifyRaw(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
 function slugify2(value) {
-  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "todos";
+  return slugifyRaw(value) || "todos";
+}
+function normalizePlanSlug2(value) {
+  const slug = slugifyRaw(value);
+  if (!slug)
+    throw new Error("Invalid plan slug");
+  return slug;
+}
+function planSlugBase4(value) {
+  return slugifyRaw(value) || "plan";
+}
+async function resolvePostgresPlanSlug(options) {
+  const plans = await options.store.list("plans");
+  const used = new Set(plans.filter((plan) => plan.project_id === options.projectId && plan.id !== options.excludeId && plan.slug).map((plan) => plan.slug));
+  if (options.slug !== undefined) {
+    const slug = normalizePlanSlug2(options.slug);
+    if (used.has(slug))
+      throw new Error(`Plan slug already exists in this scope: ${slug}`);
+    return slug;
+  }
+  const base = planSlugBase4(options.name);
+  let candidate = base;
+  let suffix = 2;
+  while (used.has(candidate)) {
+    candidate = `${base}-${suffix}`;
+    suffix += 1;
+  }
+  return candidate;
 }
 function definedPatch(value) {
   return Object.fromEntries(Object.entries(value).filter(([, entry2]) => entry2 !== undefined));
@@ -24961,6 +25139,318 @@ function listCyclesWithStats(options = {}, db) {
     };
   });
 }
+// src/lib/plan-artifacts.ts
+init_database();
+import { existsSync as existsSync9, mkdirSync as mkdirSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "fs";
+import { join as join10, resolve as resolve10 } from "path";
+var PLAN_MARKDOWN_SCHEMA = "hasna.todos.plan/v1";
+function assertSafePathSegment(value, label) {
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "." || trimmed === ".." || trimmed.includes("/") || trimmed.includes("\\")) {
+    throw new Error(`Invalid ${label} for plan artifact path`);
+  }
+  if (!/^[A-Za-z0-9._-]+$/.test(trimmed)) {
+    throw new Error(`Invalid ${label} for plan artifact path`);
+  }
+  return trimmed;
+}
+function frontmatterScalar(value) {
+  return JSON.stringify(value);
+}
+function parseFrontmatterScalar(value) {
+  const trimmed = value.trim();
+  if (trimmed === "null")
+    return null;
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (parsed === null || typeof parsed === "string")
+      return parsed;
+  } catch {}
+  return trimmed.replace(/^["']|["']$/g, "") || null;
+}
+function markdownEscape(text) {
+  return text.replace(/<!--[\s\S]*?-->/g, "").trim();
+}
+function markdownLine(text) {
+  return markdownEscape(text).replace(/\s+/g, " ").trim();
+}
+function projectSlugMatches(project, ref) {
+  const normalized = slugify(ref);
+  return Boolean(normalized) && (project.task_list_id === normalized || slugify(project.name) === normalized);
+}
+function planArtifactSlug(plan) {
+  return slugify(plan.slug || plan.name) || "plan";
+}
+function resolvePlanArtifactProject(input) {
+  const db = input.db || getDatabase();
+  const ref = input.project_id || input.project_ref;
+  if (!ref)
+    throw new Error("Plan artifacts require a project id or project reference");
+  const byPath = getProjectByPath(resolve10(ref), db);
+  if (byPath)
+    return byPath;
+  const resolvedId = resolvePartialId(db, "projects", ref);
+  if (resolvedId) {
+    const project2 = getProject(resolvedId, db);
+    if (project2)
+      return project2;
+  }
+  const project = listProjects(db).find((candidate) => projectSlugMatches(candidate, ref));
+  if (project)
+    return project;
+  throw new Error(`Project not found for plan artifacts: ${ref}`);
+}
+function resolvePlanArtifactPaths(input) {
+  const project = resolvePlanArtifactProject(input);
+  const projectId = assertSafePathSegment(project.id, "project id");
+  const projectRoot = resolve10(project.path);
+  const directory = join10(projectRoot, ".hasna", "todos", "plans", projectId);
+  const planId = input.plan_id ? assertSafePathSegment(input.plan_id, "plan id") : null;
+  const planSlug = input.plan_slug ? assertSafePathSegment(slugify(input.plan_slug), "plan slug") : null;
+  const fileName = planId ? planSlug ? `${planSlug}--${planId.slice(0, 8)}.md` : `${planId}.md` : null;
+  return {
+    project_id: project.id,
+    project_root: projectRoot,
+    directory,
+    file_path: fileName ? join10(directory, fileName) : directory
+  };
+}
+function resolvePlanArtifactCandidatePaths(plan, db) {
+  return {
+    primary: resolvePlanArtifactPaths({
+      project_id: plan.project_id,
+      plan_id: plan.id,
+      plan_slug: planArtifactSlug(plan),
+      db
+    }),
+    legacy: resolvePlanArtifactPaths({ project_id: plan.project_id, plan_id: plan.id, db })
+  };
+}
+function buildPlanArtifactSnapshot(plan, tasks = [], artifactUpdatedAt = new Date().toISOString()) {
+  if (!plan.project_id)
+    throw new Error("Plan artifacts require a project-scoped plan");
+  const taskReferences = tasks.map((task2) => ({
+    task_id: task2.id,
+    title: task2.title,
+    status: task2.status,
+    priority: task2.priority
+  }));
+  const body = renderPlanArtifactBody(plan, taskReferences);
+  return {
+    metadata: {
+      schema: PLAN_MARKDOWN_SCHEMA,
+      plan_id: plan.id,
+      plan_slug: plan.slug ?? null,
+      project_id: plan.project_id,
+      task_list_id: plan.task_list_id ?? null,
+      agent_id: plan.agent_id ?? null,
+      stable_id: plan.id,
+      name: plan.name,
+      status: plan.status,
+      created_at: plan.created_at,
+      updated_at: plan.updated_at,
+      artifact_updated_at: artifactUpdatedAt
+    },
+    task_references: taskReferences,
+    body
+  };
+}
+function renderPlanArtifactBody(plan, tasks) {
+  const lines = [`# ${markdownLine(plan.name) || plan.id}`, ""];
+  if (plan.description?.trim()) {
+    lines.push(markdownEscape(plan.description), "");
+  }
+  lines.push("## Tasks", "");
+  if (tasks.length === 0) {
+    lines.push("_No tasks are currently attached to this plan._", "");
+  } else {
+    for (const task2 of tasks) {
+      const check = task2.status === "completed" ? "x" : " ";
+      lines.push(`- [${check}] ${markdownLine(task2.title) || task2.task_id}`);
+      lines.push(`  <!-- todos: task_id=${task2.task_id} status=${task2.status} priority=${task2.priority} -->`);
+    }
+    lines.push("");
+  }
+  return lines.join(`
+`);
+}
+function renderPlanArtifactMarkdown(snapshot) {
+  const metadata = snapshot.metadata;
+  const lines = [
+    "---",
+    `schema: ${frontmatterScalar(metadata.schema)}`,
+    `plan_id: ${frontmatterScalar(metadata.plan_id)}`,
+    `plan_slug: ${frontmatterScalar(metadata.plan_slug)}`,
+    `project_id: ${frontmatterScalar(metadata.project_id)}`,
+    `task_list_id: ${frontmatterScalar(metadata.task_list_id)}`,
+    `agent_id: ${frontmatterScalar(metadata.agent_id)}`,
+    `stable_id: ${frontmatterScalar(metadata.stable_id)}`,
+    `name: ${frontmatterScalar(metadata.name)}`,
+    `status: ${frontmatterScalar(metadata.status)}`,
+    `created_at: ${frontmatterScalar(metadata.created_at)}`,
+    `updated_at: ${frontmatterScalar(metadata.updated_at)}`,
+    `artifact_updated_at: ${frontmatterScalar(metadata.artifact_updated_at)}`,
+    "---",
+    "",
+    snapshot.body
+  ];
+  return `${lines.join(`
+`).replace(/\n{3,}/g, `
+
+`).trimEnd()}
+`;
+}
+function parsePlanArtifactMarkdown(markdown) {
+  const match = markdown.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!match)
+    throw new Error("Invalid plan artifact: missing frontmatter");
+  const rawMetadata = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const separator = line.indexOf(":");
+    if (separator === -1)
+      continue;
+    const key = line.slice(0, separator).trim();
+    const value = line.slice(separator + 1);
+    rawMetadata[key] = parseFrontmatterScalar(value);
+  }
+  if (rawMetadata.schema !== PLAN_MARKDOWN_SCHEMA) {
+    throw new Error(`Unsupported plan artifact schema: ${rawMetadata.schema ?? "unknown"}`);
+  }
+  const required = ["plan_id", "project_id", "stable_id", "name", "status", "created_at", "updated_at", "artifact_updated_at"];
+  for (const key of required) {
+    if (!rawMetadata[key])
+      throw new Error(`Invalid plan artifact: missing ${key}`);
+  }
+  const body = match[2] ?? "";
+  return {
+    metadata: {
+      schema: PLAN_MARKDOWN_SCHEMA,
+      plan_id: rawMetadata.plan_id,
+      plan_slug: rawMetadata.plan_slug ?? null,
+      project_id: rawMetadata.project_id,
+      task_list_id: rawMetadata.task_list_id ?? null,
+      agent_id: rawMetadata.agent_id ?? null,
+      stable_id: rawMetadata.stable_id,
+      name: rawMetadata.name,
+      status: rawMetadata.status,
+      created_at: rawMetadata.created_at,
+      updated_at: rawMetadata.updated_at,
+      artifact_updated_at: rawMetadata.artifact_updated_at
+    },
+    task_references: parseTaskReferences(body),
+    body
+  };
+}
+function parseTaskReferences(body) {
+  const references = [];
+  const taskLine2 = /^\s*-\s+\[[ xX]\]\s+(.+)$/;
+  const metadataLine = /<!--\s*todos:\s*task_id=([A-Za-z0-9._-]+)\s+status=([A-Za-z_]+)\s+priority=([A-Za-z_]+)\s*-->/;
+  const lines = body.split(/\r?\n/);
+  for (let index = 0;index < lines.length; index++) {
+    const titleMatch = lines[index].match(taskLine2);
+    if (!titleMatch)
+      continue;
+    const metadataMatch = lines[index + 1]?.match(metadataLine);
+    if (!metadataMatch)
+      continue;
+    references.push({
+      task_id: metadataMatch[1],
+      title: titleMatch[1].trim(),
+      status: metadataMatch[2],
+      priority: metadataMatch[3]
+    });
+  }
+  return references;
+}
+function writePlanArtifact(plan, db) {
+  if (!plan.project_id)
+    return null;
+  const d = db || getDatabase();
+  const tasks = listTasks({ plan_id: plan.id, include_archived: true }, d);
+  const paths = resolvePlanArtifactCandidatePaths(plan, d).primary;
+  const snapshot = buildPlanArtifactSnapshot(plan, tasks);
+  mkdirSync8(paths.directory, { recursive: true });
+  writeFileSync6(paths.file_path, renderPlanArtifactMarkdown(snapshot), "utf8");
+  return { path: paths.file_path, snapshot };
+}
+function readPlanArtifact(plan, db) {
+  if (!plan.project_id)
+    return null;
+  const d = db || getDatabase();
+  const paths = resolvePlanArtifactCandidatePaths(plan, d);
+  const path = existsSync9(paths.primary.file_path) ? paths.primary.file_path : existsSync9(paths.legacy.file_path) ? paths.legacy.file_path : null;
+  if (!path)
+    return null;
+  const markdown = readFileSync7(path, "utf8");
+  return {
+    path,
+    markdown,
+    ...parsePlanArtifactMarkdown(markdown)
+  };
+}
+function inspectPlanArtifact(plan, db) {
+  if (!plan.project_id)
+    return null;
+  const d = db || getDatabase();
+  const paths = resolvePlanArtifactCandidatePaths(plan, d);
+  const path = existsSync9(paths.primary.file_path) ? paths.primary.file_path : existsSync9(paths.legacy.file_path) ? paths.legacy.file_path : null;
+  if (!path) {
+    return {
+      path: paths.primary.file_path,
+      exists: false,
+      parse_error: null,
+      metadata: null,
+      task_references: [],
+      conflicts: []
+    };
+  }
+  try {
+    const artifact = parsePlanArtifactMarkdown(readFileSync7(path, "utf8"));
+    return {
+      path,
+      exists: true,
+      parse_error: null,
+      metadata: artifact.metadata,
+      task_references: artifact.task_references,
+      conflicts: comparePlanArtifact(plan, artifact, listTasks({ plan_id: plan.id, include_archived: true }, d))
+    };
+  } catch (error) {
+    return {
+      path,
+      exists: true,
+      parse_error: error instanceof Error ? error.message : String(error),
+      metadata: null,
+      task_references: [],
+      conflicts: []
+    };
+  }
+}
+function comparePlanArtifact(plan, artifact, tasks) {
+  const conflicts = [];
+  compare("plan_id", plan.id, artifact.metadata.plan_id, conflicts);
+  if (artifact.metadata.plan_slug !== null) {
+    compare("plan_slug", plan.slug ?? null, artifact.metadata.plan_slug, conflicts);
+  }
+  compare("project_id", plan.project_id ?? null, artifact.metadata.project_id, conflicts);
+  compare("name", plan.name, artifact.metadata.name, conflicts);
+  compare("status", plan.status, artifact.metadata.status, conflicts);
+  compare("updated_at", plan.updated_at, artifact.metadata.updated_at, conflicts);
+  const dbTaskIds = tasks.map((task2) => task2.id).sort();
+  const artifactTaskIds = artifact.task_references.map((task2) => task2.task_id).sort();
+  if (dbTaskIds.join(",") !== artifactTaskIds.join(",")) {
+    conflicts.push({
+      field: "task_references",
+      database: dbTaskIds.join(",") || null,
+      artifact: artifactTaskIds.join(",") || null
+    });
+  }
+  return conflicts;
+}
+function compare(field2, database, artifact, conflicts) {
+  if ((database ?? null) !== (artifact ?? null)) {
+    conflicts.push({ field: field2, database: database ?? null, artifact: artifact ?? null });
+  }
+}
 // src/db/project-knowledge.ts
 init_database();
 
@@ -25989,8 +26479,8 @@ function renderRetrospectiveMarkdown(record) {
 }
 // src/lib/project-bootstrap.ts
 init_database();
-import { existsSync as existsSync9, readFileSync as readFileSync7, statSync as statSync3 } from "fs";
-import { basename as basename2, dirname as dirname7, resolve as resolve10 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync8, statSync as statSync3 } from "fs";
+import { basename as basename2, dirname as dirname7, resolve as resolve11 } from "path";
 function safeStat(path) {
   try {
     return statSync3(path);
@@ -25999,7 +26489,7 @@ function safeStat(path) {
   }
 }
 function canonicalPath(input) {
-  const resolved = resolve10(input);
+  const resolved = resolve11(input);
   const stats2 = safeStat(resolved);
   if (stats2?.isFile())
     return dirname7(resolved);
@@ -26008,7 +26498,7 @@ function canonicalPath(input) {
 function findUp(start, marker) {
   let current = canonicalPath(start);
   while (true) {
-    if (existsSync9(resolve10(current, marker)))
+    if (existsSync10(resolve11(current, marker)))
       return current;
     const parent = dirname7(current);
     if (parent === current)
@@ -26019,11 +26509,11 @@ function findUp(start, marker) {
 function readPackageJson2(path) {
   if (!path)
     return null;
-  const file = resolve10(path, "package.json");
-  if (!existsSync9(file))
+  const file = resolve11(path, "package.json");
+  if (!existsSync10(file))
     return null;
   try {
-    const parsed = JSON.parse(readFileSync7(file, "utf-8"));
+    const parsed = JSON.parse(readFileSync8(file, "utf-8"));
     return parsed && typeof parsed === "object" ? parsed : null;
   } catch {
     return null;
@@ -26042,7 +26532,7 @@ function workspaceMarker(root, rootPackage) {
   if (rootPackage?.workspaces)
     markers.push("package.json#workspaces");
   for (const marker of ["pnpm-workspace.yaml", "turbo.json", "nx.json", "lerna.json", "rush.json", "bun.lock", "bun.lockb"]) {
-    if (existsSync9(resolve10(root, marker)))
+    if (existsSync10(resolve11(root, marker)))
       markers.push(marker);
   }
   const kind = markers.find((marker) => marker !== "bun.lock" && marker !== "bun.lockb") ?? null;
@@ -26535,21 +27025,21 @@ var gatherTrainingData = async (options = {}) => {
 };
 // src/lib/model-config.ts
 init_sync_utils();
-import { existsSync as existsSync10, mkdirSync as mkdirSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync11, mkdirSync as mkdirSync9, readFileSync as readFileSync9, writeFileSync as writeFileSync7 } from "fs";
+import { join as join11 } from "path";
 var DEFAULT_MODEL = "gpt-4o-mini";
 function getConfigDir() {
   return getTodosGlobalDir();
 }
 function getConfigPath2() {
-  return join10(getConfigDir(), "config.json");
+  return join11(getConfigDir(), "config.json");
 }
 function readConfig() {
   const configPath = getConfigPath2();
-  if (!existsSync10(configPath))
+  if (!existsSync11(configPath))
     return {};
   try {
-    const raw = readFileSync8(configPath, "utf-8");
+    const raw = readFileSync9(configPath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return {};
@@ -26557,10 +27047,10 @@ function readConfig() {
 }
 function writeConfig(config) {
   const configDir = getConfigDir();
-  if (!existsSync10(configDir)) {
-    mkdirSync8(configDir, { recursive: true });
+  if (!existsSync11(configDir)) {
+    mkdirSync9(configDir, { recursive: true });
   }
-  writeFileSync6(getConfigPath2(), JSON.stringify(config, null, 2) + `
+  writeFileSync7(getConfigPath2(), JSON.stringify(config, null, 2) + `
 `, "utf-8");
 }
 function getActiveModel() {
@@ -27282,7 +27772,7 @@ CLI equivalent: \`${r.equivalent_cli}\`
 `);
 }
 // src/lib/verification-providers.ts
-import { existsSync as existsSync11, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync10 } from "fs";
 init_database();
 init_config();
 init_redaction();
@@ -27393,7 +27883,7 @@ function classifyLog(text) {
 async function sleep2(ms) {
   if (ms <= 0)
     return;
-  await new Promise((resolve11) => setTimeout(resolve11, ms));
+  await new Promise((resolve12) => setTimeout(resolve12, ms));
 }
 async function runCommandProvider(provider, input) {
   const commandTemplate = input.command || provider.command;
@@ -27448,7 +27938,7 @@ Timed out after ${provider.timeout_ms}ms`);
   };
 }
 function runCiLogProvider(input) {
-  const text = input.log_text ?? (input.log_path && existsSync11(input.log_path) ? readFileSync9(input.log_path, "utf-8") : "");
+  const text = input.log_text ?? (input.log_path && existsSync12(input.log_path) ? readFileSync10(input.log_path, "utf-8") : "");
   return {
     status: classifyLog(text),
     attempts: 1,
@@ -27460,7 +27950,7 @@ function runBrowserProvider(input) {
   if (!input.artifact_path) {
     return { status: "unknown", attempts: 1, exit_code: null, output_summary: "browser provider needs a screenshot or artifact path" };
   }
-  if (!existsSync11(input.artifact_path)) {
+  if (!existsSync12(input.artifact_path)) {
     return { status: "failed", attempts: 1, exit_code: null, output_summary: `artifact not found: ${input.artifact_path}` };
   }
   return {
@@ -27624,7 +28114,7 @@ function listVerificationRecords(filter = {}, db) {
 }
 // src/lib/verification-evidence.ts
 init_database();
-import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync9 } from "fs";
+import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync10 } from "fs";
 import { dirname as dirname8 } from "path";
 var VERIFICATION_EVIDENCE_SCHEMA = "todos.verification_evidence.v1";
 function getMachineId3() {
@@ -27745,15 +28235,15 @@ function exportVerificationEvidence(filter = {}, db) {
   };
 }
 function writeVerificationExport(bundle, path) {
-  mkdirSync9(dirname8(path), { recursive: true });
-  writeFileSync7(path, JSON.stringify(bundle, null, 2), "utf8");
+  mkdirSync10(dirname8(path), { recursive: true });
+  writeFileSync8(path, JSON.stringify(bundle, null, 2), "utf8");
 }
 // src/lib/policy-packs.ts
-import { relative as relative3, resolve as resolve11 } from "path";
+import { relative as relative3, resolve as resolve12 } from "path";
 init_database();
 init_config();
 function normalizePath3(path) {
-  return resolve11(path);
+  return resolve12(path);
 }
 function unique4(values) {
   return Array.from(new Set((values || []).map((value) => value.trim()).filter(Boolean)));
@@ -27808,7 +28298,7 @@ function commandMatches(commands, pattern) {
 }
 function pathMatches(paths, pattern, root) {
   return paths.filter((path) => {
-    const candidate = path.startsWith("/") ? path : resolve11(root, path);
+    const candidate = path.startsWith("/") ? path : resolve12(root, path);
     if (!isPathInside3(root, candidate))
       return matchesPattern3(path, pattern);
     return matchesPattern3(path, pattern) || matchesPattern3(relative3(root, candidate), pattern);
@@ -28099,21 +28589,21 @@ function resourceDiagnostics() {
   };
 }
 // src/lib/sandbox-profiles.ts
-import { existsSync as existsSync12, readFileSync as readFileSync10, writeFileSync as writeFileSync8, mkdirSync as mkdirSync10 } from "fs";
-import { join as join11, dirname as dirname9 } from "path";
+import { existsSync as existsSync13, readFileSync as readFileSync11, writeFileSync as writeFileSync9, mkdirSync as mkdirSync11 } from "fs";
+import { join as join12, dirname as dirname9 } from "path";
 var SANDBOX_PROFILE_VERSION = "todos.sandbox-profile.v1";
 function getProfilesPath() {
   if (process.env["TODOS_SANDBOX_PROFILES_PATH"]) {
     return process.env["TODOS_SANDBOX_PROFILES_PATH"];
   }
-  const localDir = join11(process.cwd(), ".todos");
-  const local = join11(localDir, "sandbox-profiles.json");
-  if (existsSync12(localDir))
+  const localDir = join12(process.cwd(), ".todos");
+  const local = join12(localDir, "sandbox-profiles.json");
+  if (existsSync13(localDir))
     return local;
-  if (existsSync12(local))
+  if (existsSync13(local))
     return local;
   const home = process.env["HOME"] || "~";
-  return join11(home, ".hasna", "todos", "sandbox-profiles.json");
+  return join12(home, ".hasna", "todos", "sandbox-profiles.json");
 }
 var cached2 = null;
 function resetSandboxProfileCache() {
@@ -28145,11 +28635,11 @@ function loadSandboxProfiles() {
   if (cached2)
     return cached2;
   const path = getProfilesPath();
-  if (!existsSync12(path)) {
+  if (!existsSync13(path)) {
     cached2 = getDefaultSandboxProfiles();
     return cached2;
   }
-  const parsed = JSON.parse(readFileSync10(path, "utf8"));
+  const parsed = JSON.parse(readFileSync11(path, "utf8"));
   cached2 = parsed.profiles?.length ? parsed.profiles : getDefaultSandboxProfiles();
   return cached2;
 }
@@ -28158,8 +28648,8 @@ function getSandboxProfile(name) {
 }
 function saveSandboxProfiles(profiles) {
   const path = getProfilesPath();
-  mkdirSync10(dirname9(path), { recursive: true });
-  writeFileSync8(path, JSON.stringify({ schema_version: SANDBOX_PROFILE_VERSION, profiles }, null, 2));
+  mkdirSync11(dirname9(path), { recursive: true });
+  writeFileSync9(path, JSON.stringify({ schema_version: SANDBOX_PROFILE_VERSION, profiles }, null, 2));
   cached2 = profiles;
 }
 function commandMatchesAllowlist(command, allow) {
@@ -28518,9 +29008,9 @@ function getDefaultAgentAdapters() {
 }
 function resetAgentAdapterCache() {}
 // src/lib/git-traceability.ts
-import { existsSync as existsSync13, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync12 } from "fs";
 import { spawnSync as spawnSync2 } from "child_process";
-import { resolve as resolve12 } from "path";
+import { resolve as resolve13 } from "path";
 var GIT_TRACEABILITY_SCHEMA_VERSION = "todos.git_traceability.v1";
 function runGit(args, cwd) {
   const result = spawnSync2("git", args, { cwd, encoding: "utf8" });
@@ -28563,11 +29053,11 @@ function inspectGitCommit(sha, cwd) {
   };
 }
 function loadCiSnapshot(path) {
-  const target = path ? resolve12(path) : resolve12(process.cwd(), ".todos", "ci-snapshot.json");
-  if (!existsSync13(target))
+  const target = path ? resolve13(path) : resolve13(process.cwd(), ".todos", "ci-snapshot.json");
+  if (!existsSync14(target))
     return null;
   try {
-    const parsed = JSON.parse(readFileSync11(target, "utf8"));
+    const parsed = JSON.parse(readFileSync12(target, "utf8"));
     return { ...parsed, captured_at: parsed.captured_at ?? new Date().toISOString() };
   } catch {
     return null;
@@ -28660,8 +29150,8 @@ function formatTraceabilityReport(report) {
 `);
 }
 // src/lib/mention-resolver.ts
-import { existsSync as existsSync14, readdirSync as readdirSync2, readFileSync as readFileSync12, statSync as statSync4 } from "fs";
-import { basename as basename3, isAbsolute, join as join12, relative as relative4, resolve as resolve13, sep as sep2 } from "path";
+import { existsSync as existsSync15, readdirSync as readdirSync2, readFileSync as readFileSync13, statSync as statSync4 } from "fs";
+import { basename as basename3, isAbsolute, join as join13, relative as relative4, resolve as resolve14, sep as sep2 } from "path";
 init_database();
 var PREFIXES = {
   file: "file",
@@ -28737,7 +29227,7 @@ function backlink(kind, key, label, target = key) {
   return { kind, key, label, target };
 }
 function normalizeWorkspace(workspace) {
-  return resolve13(workspace || process.cwd());
+  return resolve14(workspace || process.cwd());
 }
 function isInside(root, absolutePath) {
   const rel = relative4(root, absolutePath);
@@ -28805,14 +29295,14 @@ function resolveFile(parsed, workspace) {
     resolution.warnings.push("path is empty or escapes the workspace");
     return resolution;
   }
-  const absolutePath = resolve13(workspace, relPath);
+  const absolutePath = resolve14(workspace, relPath);
   if (!isInside(workspace, absolutePath)) {
     resolution.path = relPath;
     resolution.warnings.push("path escapes the workspace");
     return resolution;
   }
   resolution.path = relPath;
-  if (!existsSync14(absolutePath)) {
+  if (!existsSync15(absolutePath)) {
     resolution.warnings.push("file does not exist in the local workspace");
     return resolution;
   }
@@ -28822,7 +29312,7 @@ function resolveFile(parsed, workspace) {
     return resolution;
   }
   if (parsed.line !== undefined) {
-    const lineCount = readFileSync12(absolutePath, "utf-8").split(/\r?\n/).length;
+    const lineCount = readFileSync13(absolutePath, "utf-8").split(/\r?\n/).length;
     if (parsed.line < 1 || parsed.line > lineCount) {
       resolution.warnings.push(`line ${parsed.line} is outside the file range 1-${lineCount}`);
       return resolution;
@@ -28845,7 +29335,7 @@ function walkSourceFiles(root, current = root, files = []) {
       if (SKIP_DIRS.has(entry2.name))
         continue;
     }
-    const absolutePath = join12(current, entry2.name);
+    const absolutePath = join13(current, entry2.name);
     if (entry2.isDirectory()) {
       if (!SKIP_DIRS.has(entry2.name))
         walkSourceFiles(root, absolutePath, files);
@@ -28875,7 +29365,7 @@ function resolveSymbol(parsed, workspace, maxMatches) {
   const pattern = symbolPattern(name);
   const matches = [];
   for (const file of walkSourceFiles(workspace)) {
-    const lines = readFileSync12(file, "utf-8").split(/\r?\n/);
+    const lines = readFileSync13(file, "utf-8").split(/\r?\n/);
     for (let index = 0;index < lines.length; index += 1) {
       const line = lines[index];
       const found = pattern.exec(line);
@@ -30725,7 +31215,7 @@ function getAdapterDocsFingerprint() {
 }
 // src/lib/inbox-intake.ts
 init_database();
-import { existsSync as existsSync15, readFileSync as readFileSync13 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync14 } from "fs";
 import { basename as basename4 } from "path";
 import { createHash as createHash11 } from "crypto";
 init_secret_redaction();
@@ -30771,9 +31261,9 @@ function loadRawContent(input) {
     }
   }
   if (input.file_path) {
-    if (!existsSync15(input.file_path))
+    if (!existsSync16(input.file_path))
       throw new Error(`File not found: ${input.file_path}`);
-    const raw = readFileSync13(input.file_path, "utf8");
+    const raw = readFileSync14(input.file_path, "utf8");
     const name = basename4(input.file_path).toLowerCase();
     const source_type2 = input.source_type ?? (name.includes("ci") || name.endsWith(".log") ? "ci_log" : "file");
     return {
@@ -31389,7 +31879,7 @@ function formatNlIntakePreviewText(preview) {
 }
 // src/lib/issue-importers.ts
 init_database();
-import { existsSync as existsSync16, readFileSync as readFileSync14 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync15 } from "fs";
 var ISSUE_IMPORT_SCHEMA = "todos.issue_import.v1";
 var ISSUE_SOURCES = ["github", "linear", "jira", "auto"];
 var GITHUB_LABEL_PRIORITY = {
@@ -31608,9 +32098,9 @@ function parseIssueExport(data, source9 = "auto") {
   return normalized;
 }
 function loadIssueExportFromFile(path) {
-  if (!existsSync16(path))
+  if (!existsSync17(path))
     throw new Error(`File not found: ${path}`);
-  return JSON.parse(readFileSync14(path, "utf8"));
+  return JSON.parse(readFileSync15(path, "utf8"));
 }
 function loadIssueExportInput(input) {
   if (input.file_path) {
@@ -31768,8 +32258,8 @@ todos import issues ./linear.json --source linear --dry-run
 // src/lib/run-records.ts
 init_database();
 init_secret_redaction();
-import { existsSync as existsSync17, mkdirSync as mkdirSync11, writeFileSync as writeFileSync9 } from "fs";
-import { join as join13, dirname as dirname10 } from "path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync12, writeFileSync as writeFileSync10 } from "fs";
+import { join as join14, dirname as dirname10 } from "path";
 var RUN_RECORD_SCHEMA = "todos.run_record.v1";
 var RUN_RECORD_STATUSES = ["active", "completed", "failed", "archived"];
 function parseJsonArray3(raw, fallback = []) {
@@ -31962,9 +32452,9 @@ function buildRunReplayBundle(id, db) {
 }
 function exportRunReplay(id, outputPath, db) {
   const bundle = buildRunReplayBundle(id, db);
-  const path = outputPath ?? join13(process.cwd(), ".todos", "replays", `${id.slice(0, 8)}.json`);
-  mkdirSync11(dirname10(path), { recursive: true });
-  writeFileSync9(path, JSON.stringify(bundle, null, 2));
+  const path = outputPath ?? join14(process.cwd(), ".todos", "replays", `${id.slice(0, 8)}.json`);
+  mkdirSync12(dirname10(path), { recursive: true });
+  writeFileSync10(path, JSON.stringify(bundle, null, 2));
   const d = db || getDatabase();
   d.run(`UPDATE run_records SET replay_bundle = ?, updated_at = ? WHERE id = ?`, [path, now(), id]);
   return { path, bundle };
@@ -32002,16 +32492,16 @@ function formatRunRecordMarkdown(record) {
 `;
 }
 function getDefaultReplayDir() {
-  const local = join13(process.cwd(), ".todos", "replays");
-  if (existsSync17(join13(process.cwd(), ".todos")))
+  const local = join14(process.cwd(), ".todos", "replays");
+  if (existsSync18(join14(process.cwd(), ".todos")))
     return local;
   const home = process.env["HOME"] || "~";
-  return join13(home, ".hasna", "todos", "replays");
+  return join14(home, ".hasna", "todos", "replays");
 }
 // src/lib/release-checks.ts
 init_secret_redaction();
-import { existsSync as existsSync18, readFileSync as readFileSync15, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
-import { join as join14, relative as relative5 } from "path";
+import { existsSync as existsSync19, readFileSync as readFileSync16, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
+import { join as join15, relative as relative5 } from "path";
 var RELEASE_CHECK_SCHEMA = "todos.release_check.v1";
 var FORBIDDEN_DIST_PATTERNS = [
   {
@@ -32024,16 +32514,16 @@ var FORBIDDEN_DIST_PATTERNS = [
 ];
 var REQUIRED_BINS = ["todos", "todos-mcp", "todos-serve"];
 function readPackageJson3(root) {
-  const path = join14(root, "package.json");
-  if (!existsSync18(path))
+  const path = join15(root, "package.json");
+  if (!existsSync19(path))
     throw new Error(`package.json not found in ${root}`);
-  return JSON.parse(readFileSync15(path, "utf8"));
+  return JSON.parse(readFileSync16(path, "utf8"));
 }
 function walkFiles(dir, acc = []) {
-  if (!existsSync18(dir))
+  if (!existsSync19(dir))
     return acc;
   for (const entry2 of readdirSync3(dir)) {
-    const full = join14(dir, entry2);
+    const full = join15(dir, entry2);
     const st = statSync5(full);
     if (st.isDirectory())
       walkFiles(full, acc);
@@ -32051,8 +32541,8 @@ function auditPackageContents(root) {
     checks.push({ id: "files_dist", severity: "error", message: "package.json files must include dist" });
   }
   for (const pattern of files) {
-    const target = join14(root, pattern);
-    if (!existsSync18(target)) {
+    const target = join15(root, pattern);
+    if (!existsSync19(target)) {
       checks.push({ id: `files_missing_${pattern}`, severity: "error", message: `Published file path missing: ${pattern}` });
     }
   }
@@ -32066,8 +32556,8 @@ function auditPackageContents(root) {
       checks.push({ id: `bin_${name}`, severity: "error", message: `Missing bin entry: ${name}` });
       continue;
     }
-    const binPath = join14(root, rel);
-    if (!existsSync18(binPath)) {
+    const binPath = join15(root, rel);
+    if (!existsSync19(binPath)) {
       checks.push({ id: `bin_path_${name}`, severity: "error", message: `Bin file missing: ${rel}` });
     } else {
       checks.push({ id: `bin_ok_${name}`, severity: "info", message: `Bin present: ${name} \u2192 ${rel}` });
@@ -32084,8 +32574,8 @@ function auditPackageContents(root) {
 }
 function scanDistArtifacts(root) {
   const checks = [];
-  const distDir = join14(root, "dist");
-  if (!existsSync18(distDir)) {
+  const distDir = join15(root, "dist");
+  if (!existsSync19(distDir)) {
     checks.push({ id: "dist_missing", severity: "error", message: "dist/ directory not found \u2014 run bun run build" });
     return checks;
   }
@@ -32093,7 +32583,7 @@ function scanDistArtifacts(root) {
     const rel = relative5(root, file);
     let content;
     try {
-      content = readFileSync15(file, "utf8");
+      content = readFileSync16(file, "utf8");
     } catch {
       continue;
     }
@@ -32391,15 +32881,15 @@ function renderReleaseNotesMarkdown(document) {
 // src/lib/db-backup.ts
 init_database();
 init_migrations();
-import { existsSync as existsSync19, copyFileSync, mkdirSync as mkdirSync12, readFileSync as readFileSync16, statSync as statSync6, writeFileSync as writeFileSync10, unlinkSync } from "fs";
-import { dirname as dirname11, join as join15, resolve as resolve14 } from "path";
+import { existsSync as existsSync20, copyFileSync, mkdirSync as mkdirSync13, readFileSync as readFileSync17, statSync as statSync6, writeFileSync as writeFileSync11, unlinkSync } from "fs";
+import { dirname as dirname11, join as join16, resolve as resolve15 } from "path";
 import { Database as Database3 } from "bun:sqlite";
 var DB_BACKUP_SCHEMA = "todos.db_backup.v1";
 function resolveDbPath(dbPath) {
   if (dbPath)
-    return resolve14(dbPath);
+    return resolve15(dbPath);
   if (process.env["TODOS_DB_PATH"] && process.env["TODOS_DB_PATH"] !== ":memory:") {
-    return resolve14(process.env["TODOS_DB_PATH"]);
+    return resolve15(process.env["TODOS_DB_PATH"]);
   }
   const db = getDatabase();
   const filename = db.filename;
@@ -32409,9 +32899,9 @@ function resolveDbPath(dbPath) {
 }
 function backupDatabase(outputPath, sourcePath) {
   const source9 = resolveDbPath(sourcePath);
-  if (!existsSync19(source9))
+  if (!existsSync20(source9))
     throw new Error(`Database not found: ${source9}`);
-  mkdirSync12(dirname11(outputPath), { recursive: true });
+  mkdirSync13(dirname11(outputPath), { recursive: true });
   closeDatabase();
   const src = new Database3(source9);
   try {
@@ -32419,7 +32909,7 @@ function backupDatabase(outputPath, sourcePath) {
   } catch {}
   const image = src.serialize();
   src.close();
-  writeFileSync10(outputPath, image);
+  writeFileSync11(outputPath, image);
   const method = "file_copy";
   const bytes = statSync6(outputPath).size;
   return {
@@ -32432,14 +32922,14 @@ function backupDatabase(outputPath, sourcePath) {
   };
 }
 function restoreDatabase(backupPath, targetPath) {
-  if (!existsSync19(backupPath))
+  if (!existsSync20(backupPath))
     throw new Error(`Backup not found: ${backupPath}`);
   const integrity = checkDatabaseIntegrity(backupPath);
   if (!integrity.ok) {
     throw new Error(`Backup failed integrity check: ${integrity.errors.join("; ")}`);
   }
-  const target = targetPath ? resolve14(targetPath) : resolveDbPath();
-  mkdirSync12(dirname11(target), { recursive: true });
+  const target = targetPath ? resolve15(targetPath) : resolveDbPath();
+  mkdirSync13(dirname11(target), { recursive: true });
   const staging = `${target}.restore.tmp`;
   copyFileSync(backupPath, staging);
   copyFileSync(staging, target);
@@ -32457,9 +32947,9 @@ function restoreDatabase(backupPath, targetPath) {
   };
 }
 function checkDatabaseIntegrity(dbPath) {
-  const path = dbPath ? resolve14(dbPath) : resolveDbPath();
+  const path = dbPath ? resolve15(dbPath) : resolveDbPath();
   const errors = [];
-  if (!existsSync19(path)) {
+  if (!existsSync20(path)) {
     return {
       schema_version: DB_BACKUP_SCHEMA,
       path,
@@ -32522,7 +33012,7 @@ function checkDatabaseIntegrity(dbPath) {
   };
 }
 function compactDatabase(dbPath) {
-  const path = dbPath ? resolve14(dbPath) : resolveDbPath();
+  const path = dbPath ? resolve15(dbPath) : resolveDbPath();
   const before = statSync6(path).size;
   const db = new Database3(path);
   db.exec("VACUUM");
@@ -32532,7 +33022,7 @@ function compactDatabase(dbPath) {
   return { path, bytes_before: before, bytes_after: after };
 }
 function migrationDryRun(dbPath) {
-  const path = dbPath ? resolve14(dbPath) : resolveDbPath();
+  const path = dbPath ? resolve15(dbPath) : resolveDbPath();
   const db = new Database3(path, { readonly: true });
   let current = 0;
   try {
@@ -32556,16 +33046,16 @@ function migrationDryRun(dbPath) {
   };
 }
 function defaultBackupPath(dbPath) {
-  const base = dbPath ? dirname11(resolve14(dbPath)) : dirname11(resolveDbPath());
+  const base = dbPath ? dirname11(resolve15(dbPath)) : dirname11(resolveDbPath());
   const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-  return join15(base, "backups", `todos-${stamp}.db`);
+  return join16(base, "backups", `todos-${stamp}.db`);
 }
 function readBackupManifest(backupPath) {
   const manifestPath = `${backupPath}.json`;
-  if (!existsSync19(manifestPath))
+  if (!existsSync20(manifestPath))
     return null;
   try {
-    return JSON.parse(readFileSync16(manifestPath, "utf8"));
+    return JSON.parse(readFileSync17(manifestPath, "utf8"));
   } catch {
     return null;
   }
@@ -32575,8 +33065,8 @@ function writeBackupManifest(backupPath, result) {
   writeFileSyncSafe(manifestPath, JSON.stringify(result, null, 2));
 }
 function writeFileSyncSafe(path, content) {
-  mkdirSync12(dirname11(path), { recursive: true });
-  writeFileSync10(path, content);
+  mkdirSync13(dirname11(path), { recursive: true });
+  writeFileSync11(path, content);
 }
 // src/lib/json-schemas.ts
 var JSON_SCHEMA_CATALOG_VERSION = "todos.json_schema_catalog.v1";
@@ -32639,6 +33129,7 @@ var JSON_SCHEMAS = {
   plan: def("plan", "todos.plan.v1", "Plan", ["schema_version", "id", "name", "status", "created_at", "updated_at"], {
     schema_version: { type: "string", enum: ["todos.plan.v1"] },
     id: { type: "string" },
+    slug: { type: ["string", "null"] },
     project_id: { type: ["string", "null"] },
     name: { type: "string" },
     description: { type: ["string", "null"] },
@@ -33081,17 +33572,17 @@ ${SCHEMA_ENTITIES.map((e) => `- **${e}**: \`${JSON_SCHEMAS[e].schema_version}\``
 `;
 }
 function exportSchemasToDirectory(dir) {
-  const { mkdirSync: mkdirSync13, writeFileSync: writeFileSync11 } = __require("fs");
-  const { join: join16 } = __require("path");
-  mkdirSync13(dir, { recursive: true });
+  const { mkdirSync: mkdirSync14, writeFileSync: writeFileSync12 } = __require("fs");
+  const { join: join17 } = __require("path");
+  mkdirSync14(dir, { recursive: true });
   const written = [];
   for (const entity of SCHEMA_ENTITIES) {
-    const path = join16(dir, `${entity}.${JSON_SCHEMAS[entity].schema_version.replace(/\./g, "-")}.json`);
-    writeFileSync11(path, JSON.stringify(JSON_SCHEMAS[entity], null, 2));
+    const path = join17(dir, `${entity}.${JSON_SCHEMAS[entity].schema_version.replace(/\./g, "-")}.json`);
+    writeFileSync12(path, JSON.stringify(JSON_SCHEMAS[entity], null, 2));
     written.push(path);
   }
-  const catalogPath = join16(dir, "catalog.json");
-  writeFileSync11(catalogPath, JSON.stringify({
+  const catalogPath = join17(dir, "catalog.json");
+  writeFileSync12(catalogPath, JSON.stringify({
     catalog_version: JSON_SCHEMA_CATALOG_VERSION,
     semver: SCHEMA_SEMVER,
     entities: listJsonSchemas(),
@@ -33990,7 +34481,7 @@ function getReminderDocs() {
 }
 // src/lib/import-export-bridge.ts
 init_database();
-import { readFileSync as readFileSync17, writeFileSync as writeFileSync11, mkdirSync as mkdirSync13 } from "fs";
+import { readFileSync as readFileSync18, writeFileSync as writeFileSync12, mkdirSync as mkdirSync14 } from "fs";
 import { dirname as dirname12 } from "path";
 init_secret_redaction();
 var BUNDLE_SCHEMA = "todos.bundle.v1";
@@ -34399,11 +34890,11 @@ function importBundle(bundle, options = {}, db) {
   return result;
 }
 function writeBundleFile(bundle, path) {
-  mkdirSync13(dirname12(path), { recursive: true });
-  writeFileSync11(path, JSON.stringify(bundle, null, 2), "utf8");
+  mkdirSync14(dirname12(path), { recursive: true });
+  writeFileSync12(path, JSON.stringify(bundle, null, 2), "utf8");
 }
 function readBundleFile(path) {
-  const raw = JSON.parse(readFileSync17(path, "utf8"));
+  const raw = JSON.parse(readFileSync18(path, "utf8"));
   const validation = validateBundle(raw);
   if (!validation.valid)
     throw new Error(`Invalid bundle file: ${validation.errors.join("; ")}`);
@@ -34879,7 +35370,7 @@ function createPlanWithSteps(name, steps, opts = {}, db) {
 }
 // src/lib/handoff-packets.ts
 init_database();
-import { writeFileSync as writeFileSync12, mkdirSync as mkdirSync14 } from "fs";
+import { writeFileSync as writeFileSync13, mkdirSync as mkdirSync15 } from "fs";
 import { dirname as dirname13 } from "path";
 var HANDOFF_PACKET_SCHEMA = "todos.handoff_packet.v1";
 function summarizeTask2(t) {
@@ -35054,8 +35545,8 @@ function formatHandoffPacket(packet, format = "json") {
 function exportHandoffPacket(input = {}, path, db) {
   const packet = createHandoffPacket(input, db);
   if (path) {
-    mkdirSync14(dirname13(path), { recursive: true });
-    writeFileSync12(path, formatHandoffPacket(packet, "json"), "utf8");
+    mkdirSync15(dirname13(path), { recursive: true });
+    writeFileSync13(path, formatHandoffPacket(packet, "json"), "utf8");
   }
   return packet;
 }
@@ -35658,8 +36149,8 @@ function generateCliReferenceMarkdown() {
 }
 // src/db/builtin-templates.ts
 init_database();
-import { mkdirSync as mkdirSync15, writeFileSync as writeFileSync13 } from "fs";
-import { join as join16 } from "path";
+import { mkdirSync as mkdirSync16, writeFileSync as writeFileSync14 } from "fs";
+import { join as join17 } from "path";
 var BUILTIN_TEMPLATE_LIBRARY_VERSION = "2026-05-21";
 var BUILTIN_TEMPLATE_LIBRARY_SOURCE = "bundled-local-template-library";
 var TEMPLATE_LIBRARY_SCHEMA = "todos.template_library.v1";
@@ -35932,11 +36423,11 @@ function exportBuiltinTemplateFiles() {
   }));
 }
 function writeBuiltinTemplateFiles(directory) {
-  mkdirSync15(directory, { recursive: true });
+  mkdirSync16(directory, { recursive: true });
   const files = [];
   for (const entry2 of exportBuiltinTemplateFiles()) {
-    const path = join16(directory, entry2.filename);
-    writeFileSync13(path, `${JSON.stringify(entry2.template, null, 2)}
+    const path = join17(directory, entry2.filename);
+    writeFileSync14(path, `${JSON.stringify(entry2.template, null, 2)}
 `, "utf-8");
     files.push(path);
   }
@@ -35979,7 +36470,7 @@ function initBuiltinTemplates(db) {
 }
 // src/lib/template-library.ts
 init_database();
-import { writeFileSync as writeFileSync14, readFileSync as readFileSync18, mkdirSync as mkdirSync16 } from "fs";
+import { writeFileSync as writeFileSync15, readFileSync as readFileSync19, mkdirSync as mkdirSync17 } from "fs";
 import { dirname as dirname14 } from "path";
 function listTemplateLibrary(db) {
   const d = db || getDatabase();
@@ -36022,8 +36513,8 @@ function exportTemplateLibraryCatalog(path, db) {
     templates: listTemplateLibrary(db)
   };
   if (path) {
-    mkdirSync16(dirname14(path), { recursive: true });
-    writeFileSync14(path, JSON.stringify(catalog, null, 2), "utf8");
+    mkdirSync17(dirname14(path), { recursive: true });
+    writeFileSync15(path, JSON.stringify(catalog, null, 2), "utf8");
   }
   return catalog;
 }
@@ -36040,7 +36531,7 @@ function exportInstalledTemplate(name, db) {
 }
 function importTemplateFromFile(path, db) {
   const d = db || getDatabase();
-  const raw = JSON.parse(readFileSync18(path, "utf8"));
+  const raw = JSON.parse(readFileSync19(path, "utf8"));
   const payload = raw.template ?? raw;
   const created = importTemplate(payload, d);
   return { id: created.id, name: created.name };
@@ -36218,9 +36709,9 @@ todos machines topology      # full diagnostic report
 }
 // src/lib/environment-snapshots.ts
 import { createHash as createHash12 } from "crypto";
-import { existsSync as existsSync20, readFileSync as readFileSync19, statSync as statSync7 } from "fs";
+import { existsSync as existsSync21, readFileSync as readFileSync20, statSync as statSync7 } from "fs";
 import { hostname as hostname3, platform, arch } from "os";
-import { dirname as dirname15, join as join17, resolve as resolve15 } from "path";
+import { dirname as dirname15, join as join18, resolve as resolve16 } from "path";
 import { tmpdir as tmpdir3 } from "os";
 init_database();
 init_redaction();
@@ -36245,20 +36736,20 @@ function sha2565(value) {
   return createHash12("sha256").update(value).digest("hex");
 }
 function fileRecord(root, relativePath) {
-  const path = join17(root, relativePath);
-  if (!existsSync20(path))
+  const path = join18(root, relativePath);
+  if (!existsSync21(path))
     return null;
   const stat = statSync7(path);
   if (!stat.isFile())
     return null;
-  const content = readFileSync19(path);
+  const content = readFileSync20(path);
   return { path: relativePath, sha256: sha2565(content), size_bytes: content.length };
 }
 function manifestRecord(root, relativePath) {
   const base = fileRecord(root, relativePath);
   if (!base)
     return null;
-  const parsed = readJsonFile(join17(root, relativePath));
+  const parsed = readJsonFile(join18(root, relativePath));
   if (!parsed)
     return { ...base, redacted: {} };
   const redacted = redactValue({
@@ -36353,15 +36844,15 @@ function commandEnv(env, includeValues) {
 function defaultSnapshotDir() {
   const dbPath = getDatabasePath();
   if (dbPath === ":memory:" || dbPath.startsWith("file::memory:"))
-    return join17(tmpdir3(), "hasna-todos", "environment-snapshots");
-  return join17(dirname15(resolve15(dbPath)), "environment-snapshots");
+    return join18(tmpdir3(), "hasna-todos", "environment-snapshots");
+  return join18(dirname15(resolve16(dbPath)), "environment-snapshots");
 }
 function snapshotWithId(snapshot) {
   const digest = sha2565(JSON.stringify(snapshot)).slice(0, 24);
   return { id: `env_${digest}`, ...snapshot };
 }
 function captureEnvironmentSnapshot(input = {}) {
-  const root = resolve15(input.root || process.cwd());
+  const root = resolve16(input.root || process.cwd());
   const env = input.env || process.env;
   const warnings = [];
   const manifests = MANIFEST_FILES.map((file) => manifestRecord(root, file)).filter((file) => Boolean(file));
@@ -36401,13 +36892,13 @@ function captureEnvironmentSnapshot(input = {}) {
   });
 }
 function writeEnvironmentSnapshot(snapshot, outputPath) {
-  const path = outputPath ? resolve15(outputPath) : join17(defaultSnapshotDir(), `${snapshot.id}.json`);
+  const path = outputPath ? resolve16(outputPath) : join18(defaultSnapshotDir(), `${snapshot.id}.json`);
   ensureDir2(dirname15(path));
   writeJsonFile(path, snapshot);
   return path;
 }
 function readEnvironmentSnapshot(path) {
-  const snapshot = readJsonFile(resolve15(path));
+  const snapshot = readJsonFile(resolve16(path));
   if (!snapshot || snapshot.schema_version !== 1 || typeof snapshot.id !== "string") {
     throw new Error(`Invalid environment snapshot: ${path}`);
   }
@@ -36493,8 +36984,8 @@ function compareEnvironmentSnapshotFiles(leftPath, rightPath) {
 // src/lib/decision-records.ts
 init_database();
 import { createHash as createHash13 } from "crypto";
-import { mkdirSync as mkdirSync17, writeFileSync as writeFileSync15 } from "fs";
-import { dirname as dirname16, join as join18 } from "path";
+import { mkdirSync as mkdirSync18, writeFileSync as writeFileSync16 } from "fs";
+import { dirname as dirname16, join as join19 } from "path";
 var DECISION_RECORD_SCHEMA = "todos.decision_record.v1";
 var KNOWLEDGE_SNAPSHOT_SCHEMA = "todos.knowledge_snapshot.v1";
 var DECISION_STATUSES = ["proposed", "accepted", "deprecated", "superseded", "rejected"];
@@ -36724,9 +37215,9 @@ function exportDecisionRecord(id, outputPath, format = "markdown", db) {
   if (!record)
     throw new Error(`Decision record not found: ${id}`);
   const content = format === "markdown" ? formatDecisionRecordMarkdown(record) : JSON.stringify(record, null, 2);
-  const path = outputPath ?? join18(process.cwd(), ".todos", "decisions", `${record.short_ref}.${format === "markdown" ? "md" : "json"}`);
-  mkdirSync17(dirname16(path), { recursive: true });
-  writeFileSync15(path, content, "utf8");
+  const path = outputPath ?? join19(process.cwd(), ".todos", "decisions", `${record.short_ref}.${format === "markdown" ? "md" : "json"}`);
+  mkdirSync18(dirname16(path), { recursive: true });
+  writeFileSync16(path, content, "utf8");
   return { path, content };
 }
 function buildKnowledgeSnapshotPayload(input, db) {
@@ -36872,9 +37363,9 @@ function exportKnowledgeSnapshot(id, outputPath, format = "markdown", db) {
     throw new Error(`Knowledge snapshot not found: ${id}`);
   const content = format === "markdown" ? formatKnowledgeSnapshotMarkdown(record) : JSON.stringify(record, null, 2);
   const slug = record.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
-  const path = outputPath ?? join18(process.cwd(), ".todos", "knowledge", `${slug || record.id.slice(0, 8)}.${format === "markdown" ? "md" : "json"}`);
-  mkdirSync17(dirname16(path), { recursive: true });
-  writeFileSync15(path, content, "utf8");
+  const path = outputPath ?? join19(process.cwd(), ".todos", "knowledge", `${slug || record.id.slice(0, 8)}.${format === "markdown" ? "md" : "json"}`);
+  mkdirSync18(dirname16(path), { recursive: true });
+  writeFileSync16(path, content, "utf8");
   return { path, content };
 }
 function getDecisionRecordsDocs() {
@@ -36900,7 +37391,7 @@ Schema versions:
 }
 // src/lib/report-exports.ts
 init_database();
-import { writeFileSync as writeFileSync16, mkdirSync as mkdirSync18 } from "fs";
+import { writeFileSync as writeFileSync17, mkdirSync as mkdirSync19 } from "fs";
 import { dirname as dirname17 } from "path";
 init_secret_redaction();
 var REPORT_EXPORT_SCHEMA = "todos.report_export.v1";
@@ -37133,8 +37624,8 @@ function formatReportExport(data, format) {
   return format === "html" ? formatReportHtml(data) : formatReportMarkdown(data);
 }
 function writeReportExport(data, format, path) {
-  mkdirSync18(dirname17(path), { recursive: true });
-  writeFileSync16(path, formatReportExport(data, format), "utf8");
+  mkdirSync19(dirname17(path), { recursive: true });
+  writeFileSync17(path, formatReportExport(data, format), "utf8");
 }
 function exportReport(input, db) {
   const data = buildReportExportData(input, db);
@@ -37167,8 +37658,8 @@ todos report export --kind retrospective --days 14 --format markdown --out retro
 `;
 }
 // src/lib/command-aliases.ts
-import { existsSync as existsSync21, readFileSync as readFileSync20, writeFileSync as writeFileSync17, mkdirSync as mkdirSync19 } from "fs";
-import { join as join19 } from "path";
+import { existsSync as existsSync22, readFileSync as readFileSync21, writeFileSync as writeFileSync18, mkdirSync as mkdirSync20 } from "fs";
+import { join as join20 } from "path";
 var COMMAND_ALIASES_SCHEMA = "todos.command_aliases.v1";
 var RESERVED = new Set([...listTopLevelCommands(), "help", "version", "alias", "shortcuts"]);
 var BUILTIN_SHORTCUTS = [
@@ -37187,7 +37678,7 @@ var BUILTIN_SHORTCUTS = [
   { pattern: /^reports?$/, argv: ["report", "docs"], explain: "Report export documentation" }
 ];
 function aliasesPath(cwd = process.cwd()) {
-  return join19(cwd, ".todos", "aliases.json");
+  return join20(cwd, ".todos", "aliases.json");
 }
 function emptyStore() {
   return { schema_version: COMMAND_ALIASES_SCHEMA, aliases: {}, updated_at: new Date(0).toISOString() };
@@ -37204,9 +37695,9 @@ function validateAliasName(name) {
 }
 function loadAliasStore(cwd) {
   const path = aliasesPath(cwd);
-  if (!existsSync21(path))
+  if (!existsSync22(path))
     return emptyStore();
-  const parsed = JSON.parse(readFileSync20(path, "utf8"));
+  const parsed = JSON.parse(readFileSync21(path, "utf8"));
   if (parsed.schema_version !== COMMAND_ALIASES_SCHEMA) {
     throw new Error(`Unsupported alias store schema: ${parsed.schema_version}`);
   }
@@ -37214,9 +37705,9 @@ function loadAliasStore(cwd) {
 }
 function saveAliasStore(store, cwd) {
   const path = aliasesPath(cwd);
-  mkdirSync19(join19(path, ".."), { recursive: true });
+  mkdirSync20(join20(path, ".."), { recursive: true });
   store.updated_at = new Date().toISOString();
-  writeFileSync17(path, JSON.stringify(store, null, 2), "utf8");
+  writeFileSync18(path, JSON.stringify(store, null, 2), "utf8");
 }
 function parseArgv(command) {
   const argv = [];
@@ -37862,18 +38353,18 @@ function createBranchWorkPlan(input, db) {
 }
 // src/lib/user-scaffolds.ts
 init_database();
-import { existsSync as existsSync22, readFileSync as readFileSync21, writeFileSync as writeFileSync18, mkdirSync as mkdirSync20 } from "fs";
-import { join as join20 } from "path";
+import { existsSync as existsSync23, readFileSync as readFileSync22, writeFileSync as writeFileSync19, mkdirSync as mkdirSync21 } from "fs";
+import { join as join21 } from "path";
 var USER_SCAFFOLD_SCHEMA = "todos.user_scaffold.v1";
 var SCAFFOLD_KINDS = ["task", "project", "plan", "checklist", "contract", "verification_policy"];
 function storeDir(cwd = process.cwd()) {
-  return join20(cwd, ".todos", "scaffolds");
+  return join21(cwd, ".todos", "scaffolds");
 }
 function storePath(cwd) {
-  return join20(storeDir(cwd), "store.json");
+  return join21(storeDir(cwd), "store.json");
 }
 function versionsDir(cwd) {
-  return join20(storeDir(cwd), "versions");
+  return join21(storeDir(cwd), "versions");
 }
 function slugify5(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
@@ -37883,23 +38374,23 @@ function emptyStore2() {
 }
 function loadUserScaffoldStore(cwd) {
   const path = storePath(cwd);
-  if (!existsSync22(path))
+  if (!existsSync23(path))
     return emptyStore2();
-  const parsed = JSON.parse(readFileSync21(path, "utf8"));
+  const parsed = JSON.parse(readFileSync22(path, "utf8"));
   if (parsed.schema_version !== USER_SCAFFOLD_SCHEMA) {
     throw new Error(`Unsupported scaffold store schema: ${parsed.schema_version}`);
   }
   return parsed;
 }
 function saveUserScaffoldStore(store, cwd) {
-  mkdirSync20(storeDir(cwd), { recursive: true });
+  mkdirSync21(storeDir(cwd), { recursive: true });
   store.updated_at = now();
-  writeFileSync18(storePath(cwd), JSON.stringify(store, null, 2), "utf8");
+  writeFileSync19(storePath(cwd), JSON.stringify(store, null, 2), "utf8");
 }
 function snapshotVersion(scaffold, cwd) {
-  mkdirSync20(versionsDir(cwd), { recursive: true });
-  const path = join20(versionsDir(cwd), `${scaffold.id}-v${scaffold.version}.json`);
-  writeFileSync18(path, JSON.stringify(scaffold, null, 2), "utf8");
+  mkdirSync21(versionsDir(cwd), { recursive: true });
+  const path = join21(versionsDir(cwd), `${scaffold.id}-v${scaffold.version}.json`);
+  writeFileSync19(path, JSON.stringify(scaffold, null, 2), "utf8");
 }
 function listUserScaffolds(kind, cwd) {
   const store = loadUserScaffoldStore(cwd);
@@ -38145,7 +38636,7 @@ function listLinkedTemplates(db, cwd) {
 // src/lib/agent-workflow-demo.ts
 init_database();
 import { mkdtempSync } from "fs";
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 import { tmpdir as tmpdir4 } from "os";
 var AGENT_WORKFLOW_DEMO_SCHEMA = "todos.agent_workflow_demo.v1";
 var DEMO_DEFAULT_AGENT = "demoagent";
@@ -38161,7 +38652,7 @@ function setupEphemeralDemoDb(options = {}) {
   if (options.db_path) {
     db_path = options.db_path;
   } else if (options.persist) {
-    db_path = join21(mkdtempSync(join21(tmpdir4(), "todos-demo-")), "todos.db");
+    db_path = join22(mkdtempSync(join22(tmpdir4(), "todos-demo-")), "todos.db");
   } else {
     db_path = ":memory:";
   }
@@ -40486,18 +40977,18 @@ function runSearchView(idOrName, db) {
   return { ...runSavedSearch(view.filters, view.scope, d), view };
 }
 // src/lib/claude-tasks.ts
-import { existsSync as existsSync23, readFileSync as readFileSync22, readdirSync as readdirSync4, writeFileSync as writeFileSync19 } from "fs";
-import { join as join22 } from "path";
+import { existsSync as existsSync24, readFileSync as readFileSync23, readdirSync as readdirSync4, writeFileSync as writeFileSync20 } from "fs";
+import { join as join23 } from "path";
 init_config();
 init_sync_utils();
 function getTaskListDir(taskListId) {
-  return join22(HOME, ".claude", "tasks", taskListId);
+  return join23(HOME, ".claude", "tasks", taskListId);
 }
 function readClaudeTask(dir, filename) {
-  return readJsonFile(join22(dir, filename));
+  return readJsonFile(join23(dir, filename));
 }
 function writeClaudeTask(dir, task2) {
-  writeJsonFile(join22(dir, `${task2.id}.json`), task2);
+  writeJsonFile(join23(dir, `${task2.id}.json`), task2);
 }
 function toClaudeStatus(status) {
   if (status === "pending" || status === "in_progress" || status === "completed") {
@@ -40509,14 +41000,14 @@ function toSqliteStatus(status) {
   return status;
 }
 function readPrefixCounter(dir) {
-  const path = join22(dir, ".prefix-counter");
-  if (!existsSync23(path))
+  const path = join23(dir, ".prefix-counter");
+  if (!existsSync24(path))
     return 0;
-  const val = parseInt(readFileSync22(path, "utf-8").trim(), 10);
+  const val = parseInt(readFileSync23(path, "utf-8").trim(), 10);
   return isNaN(val) ? 0 : val;
 }
 function writePrefixCounter(dir, value) {
-  writeFileSync19(join22(dir, ".prefix-counter"), String(value));
+  writeFileSync20(join23(dir, ".prefix-counter"), String(value));
 }
 function formatPrefixedSubject(title, prefix, counter) {
   const padded = String(counter).padStart(5, "0");
@@ -40543,7 +41034,7 @@ function taskToClaudeTask(task2, claudeTaskId, existingMeta) {
 }
 function pushToClaudeTaskList(taskListId, projectId, options = {}) {
   const dir = getTaskListDir(taskListId);
-  if (!existsSync23(dir))
+  if (!existsSync24(dir))
     ensureDir2(dir);
   const filter = {};
   if (projectId)
@@ -40552,7 +41043,7 @@ function pushToClaudeTaskList(taskListId, projectId, options = {}) {
   const existingByTodosId = new Map;
   const files = listJsonFiles(dir);
   for (const f of files) {
-    const path = join22(dir, f);
+    const path = join23(dir, f);
     const ct = readClaudeTask(dir, f);
     if (ct?.metadata?.["todos_id"]) {
       existingByTodosId.set(ct.metadata["todos_id"], { task: ct, mtimeMs: getFileMtimeMs(path) });
@@ -40639,7 +41130,7 @@ function pushToClaudeTaskList(taskListId, projectId, options = {}) {
 }
 function pullFromClaudeTaskList(taskListId, projectId, options = {}) {
   const dir = getTaskListDir(taskListId);
-  if (!existsSync23(dir)) {
+  if (!existsSync24(dir)) {
     return { pushed: 0, pulled: 0, errors: [`Task list directory not found: ${dir}`] };
   }
   const files = readdirSync4(dir).filter((f) => f.endsWith(".json"));
@@ -40659,7 +41150,7 @@ function pullFromClaudeTaskList(taskListId, projectId, options = {}) {
   }
   for (const f of files) {
     try {
-      const filePath = join22(dir, f);
+      const filePath = join23(dir, f);
       const ct = readClaudeTask(dir, f);
       if (!ct)
         continue;
@@ -40727,22 +41218,22 @@ function syncClaudeTaskList(taskListId, projectId, options = {}) {
 }
 
 // src/lib/agent-tasks.ts
-import { existsSync as existsSync24 } from "fs";
-import { join as join23 } from "path";
+import { existsSync as existsSync25 } from "fs";
+import { join as join24 } from "path";
 init_sync_utils();
 init_config();
 function agentBaseDir(agent) {
   const key = `TODOS_${agent.toUpperCase()}_TASKS_DIR`;
-  return process.env[key] || getAgentTasksDir(agent) || process.env["TODOS_AGENT_TASKS_DIR"] || join23(getTodosGlobalDir(), "agents");
+  return process.env[key] || getAgentTasksDir(agent) || process.env["TODOS_AGENT_TASKS_DIR"] || join24(getTodosGlobalDir(), "agents");
 }
 function getTaskListDir2(agent, taskListId) {
-  return join23(agentBaseDir(agent), agent, taskListId);
+  return join24(agentBaseDir(agent), agent, taskListId);
 }
 function readAgentTask(dir, filename) {
-  return readJsonFile(join23(dir, filename));
+  return readJsonFile(join24(dir, filename));
 }
 function writeAgentTask(dir, task2) {
-  writeJsonFile(join23(dir, `${task2.id}.json`), task2);
+  writeJsonFile(join24(dir, `${task2.id}.json`), task2);
 }
 function taskToAgentTask(task2, externalId, existingMeta) {
   return {
@@ -40767,7 +41258,7 @@ function metadataKey(agent) {
 }
 function pushToAgentTaskList(agent, taskListId, projectId, options = {}) {
   const dir = getTaskListDir2(agent, taskListId);
-  if (!existsSync24(dir))
+  if (!existsSync25(dir))
     ensureDir2(dir);
   const filter = {};
   if (projectId)
@@ -40776,7 +41267,7 @@ function pushToAgentTaskList(agent, taskListId, projectId, options = {}) {
   const existingByTodosId = new Map;
   const files = listJsonFiles(dir);
   for (const f of files) {
-    const path = join23(dir, f);
+    const path = join24(dir, f);
     const at = readAgentTask(dir, f);
     if (at?.metadata?.["todos_id"]) {
       existingByTodosId.set(at.metadata["todos_id"], { task: at, mtimeMs: getFileMtimeMs(path) });
@@ -40850,7 +41341,7 @@ function pushToAgentTaskList(agent, taskListId, projectId, options = {}) {
 }
 function pullFromAgentTaskList(agent, taskListId, projectId, options = {}) {
   const dir = getTaskListDir2(agent, taskListId);
-  if (!existsSync24(dir)) {
+  if (!existsSync25(dir)) {
     return { pushed: 0, pulled: 0, errors: [`Task list directory not found: ${dir}`] };
   }
   const files = listJsonFiles(dir);
@@ -40869,7 +41360,7 @@ function pullFromAgentTaskList(agent, taskListId, projectId, options = {}) {
   }
   for (const f of files) {
     try {
-      const filePath = join23(dir, f);
+      const filePath = join24(dir, f);
       const at = readAgentTask(dir, f);
       if (!at)
         continue;
@@ -41007,9 +41498,9 @@ function syncWithAgents(agents, taskListIdByAgent, projectId, direction = "both"
   return { pushed, pulled, errors };
 }
 // src/lib/extract.ts
-import { existsSync as existsSync25, readFileSync as readFileSync23, statSync as statSync8 } from "fs";
+import { existsSync as existsSync26, readFileSync as readFileSync24, statSync as statSync8 } from "fs";
 import { createHash as createHash14 } from "crypto";
-import { relative as relative6, resolve as resolve16, join as join24 } from "path";
+import { relative as relative6, resolve as resolve17, join as join25 } from "path";
 var EXTRACT_TAGS = ["TODO", "FIXME", "HACK", "XXX", "BUG", "NOTE"];
 var DEFAULT_EXTENSIONS = new Set([
   ".ts",
@@ -41079,12 +41570,12 @@ function normalizePathForMatch(value) {
   return value.replace(/\\/g, "/").replace(/^\.\//, "");
 }
 function readGitignorePatterns(basePath) {
-  const root = statSync8(basePath).isFile() ? resolve16(basePath, "..") : basePath;
-  const gitignorePath = join24(root, ".gitignore");
-  if (!existsSync25(gitignorePath))
+  const root = statSync8(basePath).isFile() ? resolve17(basePath, "..") : basePath;
+  const gitignorePath = join25(root, ".gitignore");
+  if (!existsSync26(gitignorePath))
     return [];
   try {
-    return readFileSync23(gitignorePath, "utf-8").split(`
+    return readFileSync24(gitignorePath, "utf-8").split(`
 `).map((line) => line.trim()).filter((line) => line && !line.startsWith("#") && !line.startsWith("!"));
   } catch {
     return [];
@@ -41215,7 +41706,7 @@ function collectFiles(basePath, extensions, excludes, respectGitignore) {
   return files.sort();
 }
 function buildCodebaseIndex(options) {
-  const basePath = resolve16(options.path);
+  const basePath = resolve17(options.path);
   const tags = options.patterns || [...EXTRACT_TAGS];
   const extensions = options.extensions ? new Set(options.extensions.map((e) => e.startsWith(".") ? e : `.${e}`)) : DEFAULT_EXTENSIONS;
   const excludes = options.exclude || [];
@@ -41223,10 +41714,10 @@ function buildCodebaseIndex(options) {
   const files = collectFiles(basePath, extensions, excludes, respectGitignore);
   const indexed = [];
   for (const file of files) {
-    const fullPath = statSync8(basePath).isFile() ? basePath : join24(basePath, file);
+    const fullPath = statSync8(basePath).isFile() ? basePath : join25(basePath, file);
     try {
-      const source9 = readFileSync23(fullPath, "utf-8");
-      const relPath = statSync8(basePath).isFile() ? relative6(resolve16(basePath, ".."), fullPath) : file;
+      const source9 = readFileSync24(fullPath, "utf-8");
+      const relPath = statSync8(basePath).isFile() ? relative6(resolve17(basePath, ".."), fullPath) : file;
       indexed.push({
         file: relPath,
         checksum: stableHash(source9).slice(0, 24),
@@ -41246,7 +41737,7 @@ function buildCodebaseIndex(options) {
   };
 }
 function extractTodos(options, db) {
-  const basePath = resolve16(options.path);
+  const basePath = resolve17(options.path);
   const tags = options.patterns || [...EXTRACT_TAGS];
   const extensions = options.extensions ? new Set(options.extensions.map((e) => e.startsWith(".") ? e : `.${e}`)) : DEFAULT_EXTENSIONS;
   const excludes = options.exclude || [];
@@ -41254,10 +41745,10 @@ function extractTodos(options, db) {
   const files = collectFiles(basePath, extensions, excludes, respectGitignore);
   const allComments = [];
   for (const file of files) {
-    const fullPath = statSync8(basePath).isFile() ? basePath : join24(basePath, file);
+    const fullPath = statSync8(basePath).isFile() ? basePath : join25(basePath, file);
     try {
-      const source9 = readFileSync23(fullPath, "utf-8");
-      const relPath = statSync8(basePath).isFile() ? relative6(resolve16(basePath, ".."), fullPath) : file;
+      const source9 = readFileSync24(fullPath, "utf-8");
+      const relPath = statSync8(basePath).isFile() ? relative6(resolve17(basePath, ".."), fullPath) : file;
       const comments = extractFromSource(source9, relPath, tags);
       allComments.push(...comments);
     } catch {}
@@ -41351,7 +41842,7 @@ async function watchSourceTodos(options, onRun) {
   const interval = Math.max(100, options.interval_ms || 2000);
   const once = options.once !== false && (!options.max_runs || options.max_runs <= 1);
   const maxRuns = options.max_runs ?? (once ? 1 : Number.POSITIVE_INFINITY);
-  const root = resolve16(options.path);
+  const root = resolve17(options.path);
   const runs = [];
   let previous = new Map;
   for (let runNumber = 1;runNumber <= maxRuns; runNumber++) {
@@ -41962,7 +42453,7 @@ function renderWorkflowStatesMarkdown(states = listWorkflowStates()) {
 // src/lib/agent-replay-simulator.ts
 init_redaction();
 import { createHash as createHash15 } from "crypto";
-import { readFileSync as readFileSync24 } from "fs";
+import { readFileSync as readFileSync25 } from "fs";
 function isObject(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -42195,7 +42686,7 @@ function simulateAgentReplay(input, options = {}) {
   };
 }
 function simulateAgentReplayFile(path, options = {}) {
-  const parsed = JSON.parse(readFileSync24(path, "utf8"));
+  const parsed = JSON.parse(readFileSync25(path, "utf8"));
   return simulateAgentReplay(parsed, options);
 }
 function renderAgentReplaySimulationMarkdown(simulation) {
@@ -42223,8 +42714,8 @@ function renderAgentReplaySimulationMarkdown(simulation) {
 // src/lib/local-extensions.ts
 init_config();
 import { createHash as createHash16, createVerify } from "crypto";
-import { existsSync as existsSync26, readdirSync as readdirSync5, readFileSync as readFileSync25, statSync as statSync9 } from "fs";
-import { basename as basename5, join as join25, resolve as resolve17 } from "path";
+import { existsSync as existsSync27, readdirSync as readdirSync5, readFileSync as readFileSync26, statSync as statSync9 } from "fs";
+import { basename as basename5, join as join26, resolve as resolve18 } from "path";
 init_redaction();
 function isObject2(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
@@ -42306,7 +42797,7 @@ function normalizeManifest(input) {
   };
 }
 function parseJson(path) {
-  return JSON.parse(readFileSync25(path, "utf8"));
+  return JSON.parse(readFileSync26(path, "utf8"));
 }
 function sha2566(bytes) {
   return `sha256:${createHash16("sha256").update(bytes).digest("hex")}`;
@@ -42504,14 +42995,14 @@ function verifyExtensionSignature(input) {
   return verifier.verify(input.public_key, decodeSignature(input.signature));
 }
 function inspectExtensionSource(source9) {
-  const resolved = resolve17(source9);
-  if (!existsSync26(resolved))
+  const resolved = resolve18(source9);
+  if (!existsSync27(resolved))
     throw new Error(`extension source not found: ${source9}`);
   const stat = statSync9(resolved);
-  const manifestPath = stat.isDirectory() ? [join25(resolved, "todos.extension.json"), join25(resolved, "extension.json")].find(existsSync26) : resolved;
+  const manifestPath = stat.isDirectory() ? [join26(resolved, "todos.extension.json"), join26(resolved, "extension.json")].find(existsSync27) : resolved;
   if (!manifestPath)
     throw new Error(`extension directory ${source9} is missing todos.extension.json`);
-  const raw = readFileSync25(manifestPath);
+  const raw = readFileSync26(manifestPath);
   const parsed = parseJson(manifestPath);
   const bundle = isObject2(parsed) && isObject2(parsed["manifest"]);
   const manifest = normalizeManifest(bundle ? parsed["manifest"] : parsed);
@@ -42602,26 +43093,26 @@ function testExtensionCompatibility(sourceOrManifest) {
 function projectExtensionSources(projectPath) {
   if (!projectPath)
     return [];
-  const root = resolve17(projectPath);
+  const root = resolve18(projectPath);
   const candidates = [
-    join25(root, "todos.extension.json"),
-    join25(root, ".todos", "todos.extension.json")
+    join26(root, "todos.extension.json"),
+    join26(root, ".todos", "todos.extension.json")
   ];
-  const extensionDir = join25(root, ".todos", "extensions");
-  if (existsSync26(extensionDir)) {
+  const extensionDir = join26(root, ".todos", "extensions");
+  if (existsSync27(extensionDir)) {
     for (const entry2 of readdirSync5(extensionDir)) {
       if (entry2.startsWith("."))
         continue;
-      const full = join25(extensionDir, entry2);
+      const full = join26(extensionDir, entry2);
       if (statSync9(full).isDirectory() || entry2.endsWith(".json"))
         candidates.push(full);
     }
   }
-  return candidates.filter(existsSync26);
+  return candidates.filter(existsSync27);
 }
 function discoverLocalExtensions(options = {}) {
   const config = loadConfig();
-  const projectPath = options.project_path ? resolve17(options.project_path) : null;
+  const projectPath = options.project_path ? resolve18(options.project_path) : null;
   const configuredSources = [
     ...config.extension_sources || [],
     ...projectPath ? config.project_overrides?.[projectPath]?.extension_sources || [] : []
@@ -42629,7 +43120,7 @@ function discoverLocalExtensions(options = {}) {
   const sources = Array.from(new Set([
     ...configuredSources,
     ...projectExtensionSources(projectPath || undefined)
-  ])).map((source9) => projectPath && !source9.startsWith("/") ? resolve17(projectPath, source9) : resolve17(source9));
+  ])).map((source9) => projectPath && !source9.startsWith("/") ? resolve18(projectPath, source9) : resolve18(source9));
   const warnings = [];
   const discovered = [];
   for (const source9 of sources) {
@@ -43478,7 +43969,7 @@ function resolveMissingTaskFindings(input, db) {
 init_redaction();
 
 // src/lib/retention-cleanup.ts
-import { existsSync as existsSync27, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync28, unlinkSync as unlinkSync2 } from "fs";
 init_database();
 var RETENTION_CLEANUP_CONFIRMATION = "delete-local-retention-data";
 var ALL_SCOPES = ["comments", "runs", "verifications", "expired_artifacts"];
@@ -43690,7 +44181,7 @@ function applyRetentionCleanup(input, db) {
   for (const artifact of report.candidates.artifact_files) {
     try {
       const path = artifactStorePath(artifact.relative_path);
-      if (!existsSync27(path)) {
+      if (!existsSync28(path)) {
         report.warnings.push(`stored artifact already missing: ${artifact.relative_path}`);
         continue;
       }
@@ -43928,8 +44419,8 @@ function renderScalePerformanceReportMarkdown(report) {
 init_database();
 init_migrations();
 init_schema();
-import { chmodSync, copyFileSync as copyFileSync2, existsSync as existsSync28, mkdirSync as mkdirSync21, statSync as statSync10 } from "fs";
-import { basename as basename6, dirname as dirname18, join as join26 } from "path";
+import { chmodSync, copyFileSync as copyFileSync2, existsSync as existsSync29, mkdirSync as mkdirSync22, statSync as statSync10 } from "fs";
+import { basename as basename6, dirname as dirname18, join as join27 } from "path";
 var REQUIRED_TABLES2 = [
   "_migrations",
   "projects",
@@ -44036,7 +44527,7 @@ function findMissingProjectRoots(db) {
       continue;
     if (!row.path.startsWith("/"))
       continue;
-    if (!existsSync28(row.path))
+    if (!existsSync29(row.path))
       missing++;
   }
   return missing;
@@ -44096,16 +44587,16 @@ function databasePermissionsAreUnsafe(dbPath) {
 function createBackup(dbPath) {
   if (dbPath === ":memory:" || dbPath.startsWith("file::memory:"))
     return;
-  if (!existsSync28(dbPath))
+  if (!existsSync29(dbPath))
     return;
   const stamp = now().replace(/[:.]/g, "-");
-  const backupDir = join26(dirname18(dbPath), `${basename6(dbPath)}.backup-${stamp}`);
+  const backupDir = join27(dirname18(dbPath), `${basename6(dbPath)}.backup-${stamp}`);
   const files = [];
-  mkdirSync21(backupDir, { recursive: true });
+  mkdirSync22(backupDir, { recursive: true });
   for (const source9 of [dbPath, `${dbPath}-wal`, `${dbPath}-shm`]) {
-    if (!existsSync28(source9))
+    if (!existsSync29(source9))
       continue;
-    const target = join26(backupDir, basename6(source9));
+    const target = join27(backupDir, basename6(source9));
     copyFileSync2(source9, target);
     files.push(target);
   }
@@ -44769,6 +45260,7 @@ export {
   writeVerificationExport,
   writeSdkIntegrationFixtures,
   writeReportExport,
+  writePlanArtifact,
   writeOnboardingFixtureFiles,
   writeLocalBackupFile,
   writeEnvironmentSnapshot,
@@ -44935,6 +45427,8 @@ export {
   resolveTaskRunId,
   resolvePlanRef,
   resolvePlanId,
+  resolvePlanArtifactProject,
+  resolvePlanArtifactPaths,
   resolvePartialId,
   resolveMissingTaskFindings,
   resolveMentions,
@@ -44965,6 +45459,7 @@ export {
   renderReleaseNotesMarkdown,
   renderReleaseCompatibilityMarkdown,
   renderPlanningForecastMarkdown,
+  renderPlanArtifactMarkdown,
   renderLocalUsageLedgerMarkdown,
   renderLocalSnapshotMarkdown,
   renderLocalReportMarkdown,
@@ -45022,6 +45517,7 @@ export {
   recordFilesTouched,
   recordEnvironmentSnapshot,
   readTesterIssueReportsPayload,
+  readPlanArtifact,
   readLocalBackupFile,
   readEnvironmentSnapshot,
   readBundleFile,
@@ -45051,6 +45547,7 @@ export {
   parseStorageMode,
   parseRecurrenceRule,
   parseQuietHours,
+  parsePlanArtifactMarkdown,
   parseNaturalLanguageTask,
   parseIssueExport,
   parseGoalCommand,
@@ -45202,6 +45699,7 @@ export {
   isAgentConflict,
   installTemplateLibrary,
   installLocalExtension,
+  inspectPlanArtifact,
   inspectGitCommit,
   inspectExtensionSource,
   initBuiltinTemplates,
@@ -45675,6 +46173,7 @@ export {
   buildRunReplayBundle,
   buildResourceSnapshot,
   buildReportExportData,
+  buildPlanArtifactSnapshot,
   buildMcpToolGroups,
   buildMachineTopologyReport,
   buildKnowledgeSnapshotPayload,
@@ -45800,6 +46299,7 @@ export {
   ProjectNotFoundError,
   PlanNotFoundError,
   PLAN_STATUSES,
+  PLAN_MARKDOWN_SCHEMA,
   PLAN_EXECUTION_SCHEMA,
   PLAN_EXECUTION_MODES,
   PARITY_SCHEMA_VERSION,