zelari-code 0.7.5 → 0.7.8

package/dist/cli/main.bundled.js

@@ -141,12 +141,13 @@ var init_skills = __esm({
         color: "#10b981",
         enabledByDefault: true,
         builtin: true,
-        requiredTools: ["createTask", "createPhase", "createMilestone", "updateTask"],
+        requiredTools: ["createPlan", "createTask", "createPhase", "createMilestone", "updateTask"],
         systemPromptFragment: `You plan projects hierarchically.
 - Decompose work into phases, then tasks within phases.
 - For each task include: title, description, priority (low|medium|high|critical), and optional tags/subtasks.
 - Define milestones to mark key deliverables.
-- When relevant, reference file paths and acceptance criteria.`
+- When relevant, reference file paths and acceptance criteria.
+- Prefer ONE createPlan call (phases with nested tasks + milestone) over many itemized createPhase/createTask calls.`
       },
       {
         id: "idea-synthesizer",
@@ -17043,6 +17044,61 @@ var init_toolSchemas = __esm({
     "use strict";
     init_tools();
     PARAM_SCHEMAS = {
+      createPlan: {
+        type: "object",
+        properties: {
+          phases: {
+            type: "array",
+            description: "Ordered list of plan phases, each with its tasks nested (aim for 3 tasks per phase)",
+            items: {
+              type: "object",
+              properties: {
+                name: { type: "string", description: "Phase name" },
+                description: { type: "string", description: "What this phase delivers and its exit criterion" },
+                order: { type: "number", description: "Position of the phase in the plan (1-based)" },
+                color: { type: "string", description: 'Hex color, e.g. "#3b82f6"' },
+                tasks: {
+                  type: "array",
+                  description: "Concrete tasks for this phase",
+                  items: {
+                    type: "object",
+                    properties: {
+                      title: { type: "string", description: "Concise verb-led task title" },
+                      description: { type: "string", description: "2-3 sentences of context" },
+                      fileRefs: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: 'File paths with line ranges, e.g. "src/App.tsx:L10-L40"'
+                      },
+                      acceptance: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Concrete, testable acceptance criteria"
+                      },
+                      qaScenario: { type: "string", description: "Step-by-step manual QA scenario" },
+                      priority: { type: "string", enum: ["low", "medium", "high", "critical"] }
+                    },
+                    required: ["title"]
+                  }
+                }
+              },
+              required: ["name"]
+            }
+          },
+          milestone: {
+            type: "object",
+            description: "The milestone this plan ships (e.g. the design-complete milestone)",
+            properties: {
+              title: { type: "string", description: "Milestone title" },
+              description: { type: "string", description: "Milestone description" },
+              targetVersion: { type: "string", description: 'Target version, e.g. "v0.1.0"' },
+              dueDate: { type: "string", description: "Due date (ISO string)" }
+            },
+            required: ["title"]
+          }
+        },
+        required: ["phases"]
+      },
       createTask: {
         type: "object",
         properties: {
@@ -17051,6 +17107,17 @@ var init_toolSchemas = __esm({
           priority: { type: "string", enum: ["low", "medium", "high", "critical"] },
           phaseId: { type: "string", description: "ID of the phase this task belongs to" },
           parentId: { type: "string", description: "ID of the parent task, if nested" },
+          fileRefs: {
+            type: "array",
+            items: { type: "string" },
+            description: 'File paths with line ranges where the work lands, e.g. "src/App.tsx:L10-L40"'
+          },
+          acceptance: {
+            type: "array",
+            items: { type: "string" },
+            description: "Concrete, testable acceptance criteria"
+          },
+          qaScenario: { type: "string", description: "Step-by-step manual QA scenario" },
           tags: { type: "array", items: { type: "string" } },
           subtasks: { type: "array", items: { type: "string" }, description: "Subtask titles" }
         },
@@ -17180,6 +17247,7 @@ var init_toolSchemas = __esm({
         properties: {
           title: { type: "string", description: "Milestone title" },
           description: { type: "string", description: "Milestone description" },
+          targetVersion: { type: "string", description: 'Target version this milestone ships, e.g. "v0.1.0"' },
           dueDate: { type: "string", description: "Due date (ISO string)" }
         },
         required: ["title"]
@@ -17543,7 +17611,7 @@ async function refreshGrokToken(options) {
   return parseTokenResponseBody(obj, accessToken);
 }
 async function openBrowser(url2) {
-  const { spawn: spawn4 } = await import("node:child_process");
+  const { spawn: spawn5 } = await import("node:child_process");
   const cmd = (() => {
     switch (process.platform) {
       case "darwin":
@@ -17556,7 +17624,7 @@ async function openBrowser(url2) {
   })();
   return new Promise((resolve, reject) => {
     try {
-      const child = spawn4(cmd.bin, cmd.args, {
+      const child = spawn5(cmd.bin, cmd.args, {
         stdio: "ignore",
         detached: true
       });
@@ -19202,6 +19270,7 @@ __export(stubs_exports, {
   createWorkspaceContext: () => createWorkspaceContext,
   createWorkspaceStubs: () => createWorkspaceStubs,
   deriveProjectName: () => projectName,
+  readPlanSummary: () => readPlanSummary,
   resolveWorkspaceRoot: () => resolveWorkspaceRoot
 });
 import { existsSync as existsSync9, readdirSync as readdirSync3, writeFileSync as writeFileSync6, readFileSync as readFileSync6, mkdirSync as mkdirSync7, renameSync as renameSync3 } from "node:fs";
@@ -19316,8 +19385,108 @@ function nextAdrId(ctx) {
 function slugify2(s) {
   return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
 }
+function addPhaseRecord(summary, input) {
+  const id = slugify2(input.name) || `phase-${input.order}`;
+  if (summary.phases.some((p3) => p3.id === id)) {
+    return { id, created: false };
+  }
+  summary.phases.push({
+    kind: "phase",
+    id,
+    name: input.name,
+    description: input.description,
+    order: input.order,
+    color: input.color
+  });
+  return { id, created: true };
+}
+function addTaskRecord(ctx, summary, phaseId, t, options) {
+  const slug = slugify2(t.title);
+  if (options.dedupe) {
+    const existing = summary.tasks.find(
+      (k) => k.phaseId === phaseId && k.id.replace(/-\d+$/, "") === `${phaseId}-${slug}`
+    );
+    if (existing) return { id: existing.id, created: false };
+  }
+  const id = `${phaseId}-${slug}-${summary.tasks.filter((k) => k.phaseId === phaseId).length + 1}`;
+  summary.tasks.push({
+    kind: "task",
+    id,
+    // v0.7.3: keep the human-readable title in plan.json so
+    // buildPlanSummary can render it in the system prompt.
+    name: t.title,
+    phaseId,
+    status: "pending",
+    priority: t.priority
+  });
+  const taskPath = join4(ctx.rootDir, "plan-tasks", `${id}.md`);
+  const meta3 = {
+    kind: "task",
+    id,
+    phaseId,
+    status: "pending",
+    priority: t.priority,
+    tags: t.fileRefs
+  };
+  const body = [
+    `# ${t.title}`,
+    "",
+    t.description,
+    "",
+    `## File references`,
+    ...t.fileRefs.map((f) => `- \`${f}\``),
+    "",
+    `## Acceptance criteria`,
+    ...t.acceptance.map((a) => `- ${a}`),
+    "",
+    `## QA scenario`,
+    "",
+    t.qaScenario || "_(not specified)_",
+    ""
+  ].join("\n");
+  ctx.storage.write(taskPath, meta3, body);
+  return { id, created: true };
+}
+function addMilestoneRecord(ctx, summary, input) {
+  const id = `m-${slugify2(input.title)}`;
+  if (summary.milestones.some((m) => m.id === id)) {
+    return { id, created: false };
+  }
+  const version2 = input.targetVersion ?? input.dueDate ?? "TBD";
+  summary.milestones.push({
+    kind: "milestone",
+    id,
+    name: input.title,
+    description: input.description,
+    dueDate: input.dueDate,
+    targetVersion: version2
+  });
+  const path22 = join4(ctx.rootDir, "milestones", `${id}.md`);
+  const meta3 = {
+    kind: "milestone",
+    id,
+    name: input.title,
+    description: input.description,
+    dueDate: input.dueDate,
+    targetVersion: version2
+  };
+  const body = [
+    `# Milestone: ${input.title}`,
+    "",
+    input.description,
+    "",
+    `Target version: ${version2}`,
+    ""
+  ].join("\n");
+  ctx.storage.write(path22, meta3, body);
+  return { id, created: true };
+}
+function readPlanSummary(ctx) {
+  return readPlan(ctx);
+}
 function createWorkspaceStubs(ctx) {
   return [
+    createPlanStub(ctx),
     createPhaseStub(ctx),
     createTaskStub(ctx),
     updateTaskStub(ctx),
@@ -19329,6 +19498,67 @@ function createWorkspaceStubs(ctx) {
     getDocumentBacklinksStub(ctx)
   ];
 }
+function createPlanStub(ctx) {
+  return {
+    name: "createPlan",
+    description: "Create the FULL project plan in one call: all phases, the tasks nested under each phase, and the target milestone. Preferred over itemized createPhase/createTask/createMilestone calls \u2014 one createPlan call persists everything atomically.",
+    category: "project",
+    parameters: [],
+    execute: async (args) => {
+      return workspaceMutex.run(`${ctx.rootDir}:plan`, () => {
+        const rawPhases = Array.isArray(args["phases"]) ? args["phases"] : [];
+        if (rawPhases.length === 0) {
+          return 'createPlan requires a non-empty "phases" array (each phase: { name, description, order, color, tasks: [{ title, description, fileRefs, acceptance, qaScenario, priority }] }).';
+        }
+        const summary = readPlan(ctx);
+        let phasesCreated = 0;
+        let tasksCreated = 0;
+        const phaseIds = [];
+        rawPhases.forEach((rawPhase, idx) => {
+          const { id: phaseId, created } = addPhaseRecord(summary, {
+            name: rawPhase["name"] ?? `Phase ${idx + 1}`,
+            description: rawPhase["description"] ?? "",
+            order: rawPhase["order"] ?? idx + 1,
+            color: rawPhase["color"] ?? "#3b82f6"
+          });
+          if (created) phasesCreated += 1;
+          phaseIds.push(phaseId);
+          const rawTasks = Array.isArray(rawPhase["tasks"]) ? rawPhase["tasks"] : [];
+          for (const rawTask of rawTasks) {
+            const { created: taskCreated } = addTaskRecord(
+              ctx,
+              summary,
+              phaseId,
+              {
+                title: rawTask["title"] ?? "New Task",
+                description: rawTask["description"] ?? "",
+                fileRefs: rawTask["fileRefs"] ?? rawTask["files"] ?? [],
+                acceptance: rawTask["acceptance"] ?? [],
+                qaScenario: rawTask["qaScenario"] ?? rawTask["qa"] ?? "",
+                priority: rawTask["priority"] ?? "medium"
+              },
+              { dedupe: true }
+            );
+            if (taskCreated) tasksCreated += 1;
+          }
+        });
+        let milestonesCreated = 0;
+        const rawMilestone = args["milestone"];
+        if (rawMilestone && typeof rawMilestone === "object") {
+          const { created } = addMilestoneRecord(ctx, summary, {
+            title: rawMilestone["title"] ?? "v0.1.0 design-complete",
+            description: rawMilestone["description"] ?? "",
+            dueDate: rawMilestone["dueDate"],
+            targetVersion: rawMilestone["targetVersion"]
+          });
+          if (created) milestonesCreated += 1;
+        }
+        writePlan(ctx, summary);
+        return `Plan created: ${phasesCreated} phases, ${tasksCreated} tasks, ${milestonesCreated} milestone(s). Phase ids: ${phaseIds.join(", ")}.`;
+      });
+    }
+  };
+}
 function createPhaseStub(ctx) {
   return {
     name: "createPhase",
@@ -19338,22 +19568,17 @@ function createPhaseStub(ctx) {
     execute: async (args) => {
       return workspaceMutex.run(`${ctx.rootDir}:plan`, () => {
         const name = args["name"] ?? "New Phase";
-        const description = args["description"] ?? "";
         const order = args["order"] ?? 0;
-        const color = args["color"] ?? "#3b82f6";
-        const id = slugify2(name) || `phase-${order}`;
         const summary = readPlan(ctx);
-        if (summary.phases.some((p3) => p3.id === id)) {
-          return `Phase "${id}" already exists.`;
-        }
-        summary.phases.push({
-          kind: "phase",
-          id,
+        const { id, created } = addPhaseRecord(summary, {
           name,
-          description,
+          description: args["description"] ?? "",
           order,
-          color
+          color: args["color"] ?? "#3b82f6"
         });
+        if (!created) {
+          return `Phase "${id}" already exists.`;
+        }
         writePlan(ctx, summary);
         return `Phase "${name}" created (id: ${id}, order: ${order}).`;
       });
@@ -19370,54 +19595,26 @@ function createTaskStub(ctx) {
       return workspaceMutex.run(`${ctx.rootDir}:plan`, () => {
         const phaseId = args["phaseId"] ?? args["phase"];
         const title = args["title"] ?? "New Task";
-        const description = args["description"] ?? "";
-        const fileRefs = args["fileRefs"] ?? args["files"] ?? [];
-        const acceptance = args["acceptance"] ?? [];
-        const qaScenario = args["qaScenario"] ?? args["qa"] ?? "";
-        const priority = args["priority"] ?? "medium";
         if (!phaseId) return "Task requires a phaseId.";
         const summary = readPlan(ctx);
         if (!summary.phases.some((p3) => p3.id === phaseId)) {
           return `Phase "${phaseId}" not found. Create it first via /createPhase.`;
         }
-        const id = `${phaseId}-${slugify2(title)}-${summary.tasks.filter((t) => t.phaseId === phaseId).length + 1}`;
-        summary.tasks.push({
-          kind: "task",
-          id,
-          // v0.7.3: keep the human-readable title in plan.json so
-          // buildPlanSummary can render it in the system prompt.
-          name: title,
+        const { id } = addTaskRecord(
+          ctx,
+          summary,
           phaseId,
-          status: "pending",
-          priority
-        });
+          {
+            title,
+            description: args["description"] ?? "",
+            fileRefs: args["fileRefs"] ?? args["files"] ?? [],
+            acceptance: args["acceptance"] ?? [],
+            qaScenario: args["qaScenario"] ?? args["qa"] ?? "",
+            priority: args["priority"] ?? "medium"
+          },
+          { dedupe: false }
+        );
         writePlan(ctx, summary);
-        const taskPath = join4(ctx.rootDir, "plan-tasks", `${id}.md`);
-        const meta3 = {
-          kind: "task",
-          id,
-          phaseId,
-          status: "pending",
-          priority,
-          tags: fileRefs
-        };
-        const body = [
-          `# ${title}`,
-          "",
-          description,
-          "",
-          `## File references`,
-          ...fileRefs.map((f) => `- \`${f}\``),
-          "",
-          `## Acceptance criteria`,
-          ...acceptance.map((a) => `- ${a}`),
-          "",
-          `## QA scenario`,
-          "",
-          qaScenario || "_(not specified)_",
-          ""
-        ].join("\n");
-        ctx.storage.write(taskPath, meta3, body);
         return `Task "${title}" created (id: ${id}) under phase "${phaseId}".`;
       });
     }
@@ -19523,39 +19720,16 @@ function createMilestoneStub(ctx) {
     execute: async (args) => {
       return workspaceMutex.run(`${ctx.rootDir}:plan`, () => {
         const title = args["title"] ?? "New Milestone";
-        const description = args["description"] ?? "";
-        const dueDate = args["dueDate"];
-        const id = `m-${slugify2(title)}`;
         const summary = readPlan(ctx);
-        if (summary.milestones.some((m) => m.id === id)) return `Milestone "${id}" already exists.`;
-        const version2 = args["targetVersion"] ?? dueDate ?? "TBD";
-        summary.milestones.push({
-          kind: "milestone",
-          id,
-          name: title,
-          description,
-          dueDate,
-          targetVersion: version2
+        const { id, created } = addMilestoneRecord(ctx, summary, {
+          title,
+          description: args["description"] ?? "",
+          dueDate: args["dueDate"],
+          targetVersion: args["targetVersion"]
         });
+        if (!created) return `Milestone "${id}" already exists.`;
         writePlan(ctx, summary);
-        const path22 = join4(ctx.rootDir, "milestones", `${id}.md`);
-        const meta3 = {
-          kind: "milestone",
-          id,
-          name: title,
-          description,
-          dueDate,
-          targetVersion: version2
-        };
-        const body = [
-          `# Milestone: ${title}`,
-          "",
-          description,
-          "",
-          `Target version: ${version2}`,
-          ""
-        ].join("\n");
-        ctx.storage.write(path22, meta3, body);
+        const version2 = summary.milestones.find((m) => m.id === id)?.targetVersion ?? "TBD";
         return `Milestone "${title}" created (id: ${id}, version: ${version2}).`;
       });
     }
@@ -19572,7 +19746,8 @@ function createDocumentStub(ctx) {
         const title = args["title"] ?? "New Document";
         const content = args["content"] ?? "";
         const tags = args["tags"] ?? [];
-        const id = slugify2(title) || `doc-${Date.now()}`;
+        const normalizedTitle = title.replace(/\.(md|markdown)\s*$/i, "");
+        const id = slugify2(normalizedTitle) || `doc-${Date.now()}`;
         const path22 = workspaceArtifact(ctx.rootDir, "docs", id);
         const meta3 = {
           kind: "doc",
@@ -19658,8 +19833,8 @@ function linkDocumentsStub(ctx) {
     parameters: [],
     execute: async (args) => {
       return workspaceMutex.run(`${ctx.rootDir}:link`, () => {
-        const fromId = args["fromId"];
-        const toId = args["toId"];
+        const fromId = args["fromId"] ?? args["sourceId"];
+        const toId = args["toId"] ?? args["targetId"] ?? args["targetPathOrTitle"];
         if (!fromId || !toId) return "linkDocuments requires fromId and toId.";
         const allFiles = [
           ...ctx.storage.listMarkdown(join4(ctx.rootDir, "decisions")),
@@ -19692,7 +19867,7 @@ function getDocumentBacklinksStub(ctx) {
     category: "analysis",
     parameters: [],
     execute: async (args) => {
-      const targetId = args["targetId"];
+      const targetId = args["targetId"] ?? args["id"];
       if (!targetId) return "getDocumentBacklinks requires targetId.";
       const allFiles = [
         ...ctx.storage.listMarkdown(join4(ctx.rootDir, "decisions")),
@@ -19820,7 +19995,7 @@ var init_mcpClient = __esm({
           {
             protocolVersion: MCP_PROTOCOL_VERSION,
             capabilities: {},
-            clientInfo: { name: "zelari-code", version: "0.7.5" }
+            clientInfo: { name: "zelari-code", version: "0.7.8" }
           },
           INIT_TIMEOUT_MS
         );
@@ -20135,7 +20310,40 @@ Example format:
 - Make dependencies explicit (task B depends on task A).
 - If the stack/platform is unknown, ask ONCE (see clarification protocol) rather than guessing.
 
-Keep plans hierarchical and practical. Stay under 250 words.${CLARIFICATION_PROTOCOL8}`,
+Keep plans hierarchical and practical. Stay under 250 words.${CLARIFICATION_PROTOCOL8}
+
+## Design-phase mandatory plan artifact
+In design-phase mode (TASK mentions design/architecture/spec, no existing codebase to edit), you MUST persist the plan through workspace tools. The plan exists ONLY if it was persisted via a tool call \u2014 prose does not count, and the post-run check will flag your run if the plan is missing.
+
+PREFERRED \u2014 emit ONE single \`createPlan\` call containing the whole plan: 4 phases, 12 concrete tasks (3 per phase), and 1 milestone, all in the same call:
+
+\`\`\`
+createPlan({
+  phases: [
+    {
+      name: "Foundation & Technical Blueprint",
+      description: "Lock the stack and the non-negotiable quality budget. Exit: baseline builds green.",
+      order: 1,
+      color: "#3b82f6",
+      tasks: [
+        { title: "Lock stack baseline", description: "2-3 sentences of context", fileRefs: ["src/main.tsx:L1-L40"], acceptance: ["App boots with strict TS", "CI build green"], qaScenario: "Run npm run build and confirm zero errors", priority: "high" },
+        { title: "Define NFR budget", description: "...", fileRefs: ["docs/nfr.md"], acceptance: ["LCP/WCAG/Lighthouse targets documented"], qaScenario: "...", priority: "high" },
+        { title: "Document design-phase exit criteria", description: "...", fileRefs: ["docs/exit-criteria.md"], acceptance: ["Each phase has a testable exit row"], qaScenario: "...", priority: "medium" }
+      ]
+    },
+    { name: "...", order: 2, tasks: [ /* 3 tasks */ ] },
+    { name: "...", order: 3, tasks: [ /* 3 tasks */ ] },
+    { name: "...", order: 4, tasks: [ /* 3 tasks */ ] }
+  ],
+  milestone: { title: "v0.1.0 design-complete", description: "All design artifacts exist and the green-light checklist passes.", targetVersion: "v0.1.0" }
+})
+\`\`\`
+
+Every task MUST include fileRefs, acceptance, and qaScenario \u2014 the QA scenario proves the task is verifiable.
+
+FALLBACK \u2014 only if you cannot batch, use the itemized tools: \`createPhase\` once per phase; each createPhase response returns the new phase id \u2014 use that exact id as \`phaseId\` in the 3 \`createTask\` calls for that phase; finish with one \`createMilestone\` ({ title, description, targetVersion }). If you forget an id, call \`searchDocuments\` (limit 1) to look it up, then continue.
+
+Do NOT output tasks as prose. The system will refuse any task that does not pass a valid phaseId.`,
         // v0.7.2: read/search the codebase to ground the plan in reality.
         tools: ["list_files", "read_file", "grep_content"],
         skills: ["project-planner", "vault-manager"]
@@ -20166,7 +20374,18 @@ Keep plans hierarchical and practical. Stay under 250 words.${CLARIFICATION_PROT
 ## Themes
 ## Top picks (with feasibility/novelty + de-risk note)
 
-Stay under 200 words.${CLARIFICATION_PROTOCOL8}`,
+Stay under 200 words.${CLARIFICATION_PROTOCOL8}
+
+## Design-phase artifact (mandatory when running council in design-phase mode)
+If the council is in design-phase mode (TASK mentions design/architecture/spec, no existing codebase to edit), you MUST also persist your ideation output as workspace documents via the \`createDocument\` tool. Emit AT LEAST 3 separate \`createDocument\` calls, each tagged with one of these categories:
+
+- \`customer-journey-map\` \u2014 2-3 personas (give them names, demographics, goals), journey table (stage \u2192 action \u2192 touchpoint \u2192 emotion), pain points per stage. This is a customer journey deliverable.
+- \`information-architecture\` \u2014 site map tree (root \u2192 section \u2192 page), navigation model (primary nav, breadcrumbs, footer), URL patterns. This is an information architecture deliverable.
+- \`design-tokens\` \u2014 color palette (semantic + hex), typography scale, spacing scale, motion principles. This is a design tokens deliverable.
+
+You may optionally add a 4th design system doc if the project warrants it.
+
+Pass the tool call as: \`createDocument({ title: "<category>", content: "<markdown body>" })\`. Do NOT summarize these into prose \u2014 they are the deliverable.`,
         // v0.7.2: explore the codebase to ground ideas in what exists.
         tools: ["list_files", "read_file"],
         skills: ["idea-synthesizer", "mind-mapper", "document-writer"]
@@ -20226,7 +20445,19 @@ Describe the proposed structure (root \u2192 branches \u2192 leaves) in text and
 ## Contradictions
 ## Top improvements
 
-Stay under 200 words. (You do not create workspace artifacts, so you do not emit a tools block \u2014 but you MAY ask the user a clarifying question if a core ambiguity blocks judgment.)${CLARIFICATION_PROTOCOL8}`,
+Stay under 200 words.${CLARIFICATION_PROTOCOL8}
+
+## Design-phase risks artifact (mandatory when running council in design-phase mode)
+When the council is in design-phase mode (TASK mentions design/architecture/spec, no existing codebase to edit), you ALSO write a \`risks\` document via the \`createDocument\` tool. This is your one allowed artifact emission. Pass the tool call as:
+
+\`\`\`
+createDocument({
+  title: "risks",
+  content: \`# Risks\\n\\n## 1. <Risk title>\\n- Impact: <high|medium|low>\\n- Likelihood: <high|medium|low>\\n- Mitigation: <one-line mitigation>\\n\\n## 2. ...\`
+})
+\`\`\`
+
+Include AT LEAST 5 risks, each scored on Impact and Likelihood, with a one-line mitigation. Cover: technical (e.g. stack risk), product (e.g. scope creep), accessibility, performance, security. Do NOT emit other workspace artifacts \u2014 your role is to evaluate, not to build.`,
         tools: [],
         skills: ["research-analyst"]
       },
@@ -20251,7 +20482,19 @@ Stay under 200 words. (You do not create workspace artifacts, so you do not emit
 - Apply Minosse's highest-value improvements; drop descoped items.
 - After making changes, verify they work (compile, run tests, etc.) when feasible.
 
-Use the tools available to you (read_file, write_file, edit_file, bash, list_files) directly as tool calls \u2014 the harness handles execution.${CLARIFICATION_PROTOCOL8}`,
+Use the tools available to you (read_file, write_file, edit_file, bash, list_files) directly as tool calls \u2014 the harness handles execution.${CLARIFICATION_PROTOCOL8}
+
+## Design-phase synthesis artifact (mandatory when running council in design-phase mode)
+When the council is in design-phase mode (TASK mentions design/architecture/spec, no existing codebase to edit), your final deliverable is a \`synthesis\` document via the \`createDocument\` tool (NOT \`write_file\` and NOT \`list_files\`):
+
+\`\`\`
+createDocument({
+  title: "synthesis",
+  content: \`# Council Synthesis\\n\\n## Executive summary\\n<2-3 paragraphs>\\n\\n## Stack and key decisions\\n- <ADR-by-ADR summary>\\n\\n## Phases\\n<1-2 line summary per phase>\\n\\n## Top risks\\n<top 3 risks from Minosse>\\n\\n## Green-light checklist\\n- [ ] All ADRs accepted\\n- [ ] Risks have mitigations\\n- [ ] Tasks have acceptance criteria\`
+})
+\`\`\`
+
+DO NOT call \`list_files\` \u2014 it is NOT a workspace tool. Use \`searchDocuments\` if you need to look something up (limit 2-3 searches, then act on the results). Your deliverable is the synthesis document; emit it via \`createDocument\`, not via prose.`,
         // v0.7.2: implementation tools — the synthesizer writes/edits files and runs commands.
         tools: ["read_file", "write_file", "edit_file", "bash", "list_files"],
         skills: ["vault-manager", "project-planner", "idea-synthesizer"]
@@ -20707,8 +20950,14 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
     };
     callbacks.onMemberCost?.(cost);
   };
-  const executableNames = config2.tools ? new Set(config2.tools.list()) : null;
-  const filterExecutable = (names) => executableNames ? names.filter((n) => executableNames.has(n)) : names;
+  const executorToolNames = config2.tools ? config2.tools.list() : [];
+  const executableNames = config2.tools ? new Set(executorToolNames) : null;
+  const filterExecutable = (names) => {
+    if (!executableNames)
+      return names;
+    const merged = Array.from(/* @__PURE__ */ new Set([...names, ...executorToolNames]));
+    return merged.filter((n) => executableNames.has(n));
+  };
   const allSpecialists = agents.filter((a) => a.id !== "lucifer" && a.id !== "minos");
   const specialists = config2.feedbackStore ? config2.feedbackStore.ranked(allSpecialists) : allSpecialists;
   const oracle = agents.find((a) => a.id === "minos");
@@ -20751,12 +21000,14 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
     let toolCalls = 0;
     let usage = null;
     let errored = false;
+    const emittedToolNames = [];
     const memberStart = Date.now();
     try {
       for await (const event of harness.run()) {
         yield event;
         if (event.type === "tool_execution_start") {
           toolCalls += 1;
+          emittedToolNames.push(event.toolName);
         }
         if (event.type === "message_end" && event.usage) {
           usage = event.usage;
@@ -20774,6 +21025,27 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
       fullText = `Error: ${err instanceof Error ? err.message : "Unknown"}`;
       errored = true;
     }
+    if (!errored && !NON_RETRY_AGENTS.has(agent.id)) {
+      const specialistCheck = enforceDesignPhaseToolEmissions(agent.id, emittedToolNames);
+      yield* applyRetryIfMissing({
+        agent,
+        check: specialistCheck,
+        requirements: DESIGN_PHASE_REQUIREMENTS[agent.id],
+        emittedToolNames,
+        executableNames,
+        sessionId,
+        userMessage,
+        agentOutputs,
+        config: config2,
+        effectiveProvider,
+        effectiveModel,
+        onToolCall: () => {
+          toolCalls += 1;
+        }
+      });
+    } else {
+      enforceDesignPhaseToolEmissions(agent.id, emittedToolNames);
+    }
     const memberDuration = Date.now() - memberStart;
     emitMemberCost({
       memberId: agent.id,
@@ -20819,7 +21091,7 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
       });
     }
   }
-  if (config2.debateMode && oracle && !completedIds.has(oracle.id)) {
+  if (oracle && !completedIds.has(oracle.id)) {
     callbacks.onAgentStart?.(oracle);
     const override = config2.agentModels?.[oracle.id];
     const effectiveProvider = override?.providerId ?? config2.provider ?? "minimax";
@@ -20852,12 +21124,14 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
     let toolCalls = 0;
     let usage = null;
     let errored = false;
+    const emittedToolNames = [];
     const memberStart = Date.now();
     try {
       for await (const event of harness.run()) {
         yield event;
         if (event.type === "tool_execution_start") {
           toolCalls += 1;
+          emittedToolNames.push(event.toolName);
         }
         if (event.type === "message_end" && event.usage) {
           usage = event.usage;
@@ -20875,6 +21149,27 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
       fullText = `Review error: ${err instanceof Error ? err.message : "Unknown"}`;
       errored = true;
     }
+    if (!errored) {
+      const oracleCheck = enforceDesignPhaseToolEmissions(oracle.id, emittedToolNames);
+      yield* applyRetryIfMissing({
+        agent: oracle,
+        check: oracleCheck,
+        requirements: DESIGN_PHASE_REQUIREMENTS[oracle.id],
+        emittedToolNames,
+        executableNames,
+        sessionId,
+        userMessage: `Review these proposals for: "${userMessage}"`,
+        agentOutputs,
+        config: config2,
+        effectiveProvider,
+        effectiveModel,
+        onToolCall: () => {
+          toolCalls += 1;
+        }
+      });
+    } else {
+      enforceDesignPhaseToolEmissions(oracle.id, emittedToolNames);
+    }
     const memberDuration = Date.now() - memberStart;
     emitMemberCost({
       memberId: oracle.id,
@@ -20948,12 +21243,14 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
     let usage = null;
     let errored = false;
     let lastErrorMessage = "";
+    const emittedToolNames = [];
     const memberStart = Date.now();
     try {
       for await (const event of chairmanHarness.run()) {
         yield event;
         if (event.type === "tool_execution_start") {
           toolCalls += 1;
+          emittedToolNames.push(event.toolName);
         }
         if (event.type === "message_end" && event.usage) {
           usage = event.usage;
@@ -20975,6 +21272,27 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
       errored = true;
       lastErrorMessage = err instanceof Error ? err.message : String(err);
     }
+    if (!errored) {
+      const chairmanCheck = enforceDesignPhaseToolEmissions(chairman.id, emittedToolNames);
+      yield* applyRetryIfMissing({
+        agent: chairman,
+        check: chairmanCheck,
+        requirements: DESIGN_PHASE_REQUIREMENTS[chairman.id],
+        emittedToolNames,
+        executableNames,
+        sessionId,
+        userMessage,
+        agentOutputs,
+        config: config2,
+        effectiveProvider,
+        effectiveModel,
+        onToolCall: () => {
+          toolCalls += 1;
+        }
+      });
+    } else {
+      enforceDesignPhaseToolEmissions(chairman.id, emittedToolNames);
+    }
     const memberDuration = Date.now() - memberStart;
     const finalSynthesis = errored && fullText.length === 0 ? `[Chairman synthesis failed: ${lastErrorMessage || "unknown error"}]` : fullText;
     callbacks.onSynthesisDone?.(finalSynthesis, void 0, void 0);
@@ -21008,7 +21326,142 @@ async function* runCouncilPure(userMessage, config2, callbacks = {}) {
     durationMs: 0
   };
 }
-var QUESTION_MARKER, QUESTION_END_MARKER;
+function checkMemberToolEmissions(_memberId, emittedToolNames, requirements) {
+  if (requirements.length === 0) {
+    return { ok: true, missing: [] };
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const name of emittedToolNames) {
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  const missing = [];
+  for (const req of requirements) {
+    const got = counts.get(req.name) ?? 0;
+    if (got < req.min) {
+      missing.push(`${req.name} (got ${got}, need >= ${req.min})`);
+    }
+  }
+  return { ok: missing.length === 0, missing };
+}
+function checkMemberToolEmissionSets(memberId, emittedToolNames, sets) {
+  if (sets.length === 0) {
+    return { ok: true, missing: [] };
+  }
+  const results = sets.map((set2) => checkMemberToolEmissions(memberId, emittedToolNames, set2));
+  if (results.some((r) => r.ok)) {
+    return { ok: true, missing: [] };
+  }
+  return results[0];
+}
+function enforceDesignPhaseToolEmissions(memberId, emittedToolNames) {
+  const sets = DESIGN_PHASE_REQUIREMENT_SETS[memberId];
+  if (!sets || sets.length === 0) {
+    return { ok: true, missing: [] };
+  }
+  const result = checkMemberToolEmissionSets(memberId, emittedToolNames, sets);
+  if (!result.ok) {
+    console.warn(`[council] member "${memberId}" did not emit required tools: ${result.missing.join(", ")}. The downstream .zelari/ deliverable may be incomplete. (A forced retry turn scoped to the missing tools follows; the deterministic complete-design fallback covers any remaining gap.)`);
+  }
+  return result;
+}
+function shouldRetryMember(missingToolNames, attemptsSoFar) {
+  if (missingToolNames.length === 0)
+    return false;
+  if (attemptsSoFar >= MAX_RETRY_PER_MEMBER)
+    return false;
+  return true;
+}
+function buildRetryPrompt(missingToolNames) {
+  const names = missingToolNames.join(", ");
+  return `You did not emit the required workspace tools: ${names}. Call ${names} NOW with concrete arguments. No prose. No search.`;
+}
+async function* runRetryTurnForMember(args) {
+  const executableMissing = args.executableTools ? args.missingToolNames.filter((n) => args.executableTools.has(n)) : args.missingToolNames;
+  if (executableMissing.length === 0) {
+    return [];
+  }
+  const retryToolNames = executableMissing;
+  const retryToolSpecs = getProviderTools(retryToolNames).map((t) => ({
+    name: t.function.name,
+    description: t.function.description,
+    parameters: t.function.parameters
+  }));
+  const baseMessages = buildAgentMessages(args.agent, args.userMessage, args.ragContext, args.workspaceContext, args.priorOutputs, args.aiConfig, args.executableTools);
+  const retryMessages = [
+    ...baseMessages,
+    { role: "user", content: buildRetryPrompt(executableMissing) }
+  ];
+  const maxToolCalls = args.minPerTool !== void 0 ? Object.entries(args.minPerTool).filter(([name]) => executableMissing.includes(name)).reduce((sum, [, min]) => sum + min, 0) : retryToolNames.length;
+  const retryHarness = new AgentHarness({
+    model: args.effectiveModel,
+    provider: args.effectiveProvider,
+    sessionId: args.sessionId,
+    messages: retryMessages,
+    tools: retryToolSpecs,
+    eventBus: args.eventBus,
+    toolRegistry: args.toolRegistry,
+    // Budget the retry so the model can satisfy every requirement in
+    // ONE tool_calls turn. For createTask min:12 this needs 12 calls.
+    maxToolCallsPerTurn: maxToolCalls,
+    memberId: args.agent.id,
+    memberName: args.agent.name,
+    providerStream: (params) => args.providerStream(params)
+  });
+  const retryEmitted = [];
+  for await (const event of retryHarness.run()) {
+    if (event.type === "tool_execution_start") {
+      retryEmitted.push(event.toolName);
+    }
+    yield event;
+  }
+  return retryEmitted;
+}
+async function* applyRetryIfMissing(args) {
+  if (args.check.ok)
+    return;
+  const missingToolNames = args.check.missing.map((m) => m.split(" ")[0]);
+  if (!shouldRetryMember(missingToolNames, 0))
+    return;
+  console.warn(`[council] ${args.agent.id} retrying missing tools: ${missingToolNames.join(", ")}`);
+  const minPerTool = {};
+  if (args.requirements) {
+    for (const req of args.requirements) {
+      if (missingToolNames.includes(req.name)) {
+        minPerTool[req.name] = req.min;
+      }
+    }
+  }
+  try {
+    const retryGenerator = runRetryTurnForMember({
+      agent: args.agent,
+      missingToolNames,
+      minPerTool,
+      executableTools: args.executableNames,
+      userMessage: args.userMessage,
+      ragContext: args.config.ragContext,
+      workspaceContext: args.config.workspaceContext,
+      priorOutputs: args.agentOutputs,
+      aiConfig: args.config.aiConfig,
+      sessionId: args.sessionId,
+      effectiveModel: args.effectiveModel,
+      effectiveProvider: args.effectiveProvider,
+      eventBus: args.config.eventBus,
+      toolRegistry: args.config.tools,
+      providerStream: args.config.providerStream
+    });
+    for await (const event of retryGenerator) {
+      if (event.type === "tool_execution_start") {
+        args.onToolCall();
+        args.emittedToolNames.push(event.toolName);
+      }
+      yield event;
+    }
+  } catch (retryErr) {
+    console.error(`[council] ${args.agent.id} retry failed:`, retryErr);
+  }
+  enforceDesignPhaseToolEmissions(args.agent.id, args.emittedToolNames);
+}
+var NON_RETRY_AGENTS, QUESTION_MARKER, QUESTION_END_MARKER, DESIGN_PHASE_REQUIREMENT_SETS, DESIGN_PHASE_REQUIREMENTS, MAX_RETRY_PER_MEMBER;
 var init_councilApi = __esm({
   "packages/core/dist/agents/councilApi.js"() {
     "use strict";
@@ -21018,8 +21471,30 @@ var init_councilApi = __esm({
     init_tools();
     init_events();
     init_AgentHarness();
+    NON_RETRY_AGENTS = /* @__PURE__ */ new Set([]);
     QUESTION_MARKER = "---QUESTION---";
     QUESTION_END_MARKER = "---END---";
+    DESIGN_PHASE_REQUIREMENT_SETS = {
+      nettun: [
+        [{ name: "createPlan", min: 1 }],
+        [
+          { name: "createPhase", min: 3 },
+          { name: "createTask", min: 6 },
+          { name: "createMilestone", min: 1 }
+        ]
+      ],
+      geryon: [
+        [{ name: "createDocument", min: 3 }]
+      ],
+      minos: [
+        [{ name: "createDocument", min: 1 }]
+      ],
+      lucifer: [
+        [{ name: "createDocument", min: 1 }]
+      ]
+    };
+    DESIGN_PHASE_REQUIREMENTS = Object.fromEntries(Object.entries(DESIGN_PHASE_REQUIREMENT_SETS).map(([id, sets]) => [id, sets[0]]));
+    MAX_RETRY_PER_MEMBER = 1;
   }
 });
 
@@ -21186,16 +21661,25 @@ var council_exports = {};
 __export(council_exports, {
   AGENT_ROLES: () => AGENT_ROLES,
   COLLABORATION_DIRECTIVE: () => COLLABORATION_DIRECTIVE,
+  DESIGN_PHASE_REQUIREMENTS: () => DESIGN_PHASE_REQUIREMENTS,
+  DESIGN_PHASE_REQUIREMENT_SETS: () => DESIGN_PHASE_REQUIREMENT_SETS,
+  MAX_RETRY_PER_MEMBER: () => MAX_RETRY_PER_MEMBER,
+  NON_RETRY_AGENTS: () => NON_RETRY_AGENTS,
   OUTPUT_QUALITY_DIRECTIVE: () => OUTPUT_QUALITY_DIRECTIVE,
   PROMPT_MODULES: () => PROMPT_MODULES,
   STRUCTURED_REASONING_DIRECTIVE: () => STRUCTURED_REASONING_DIRECTIVE,
   TOOL_USE_PROTOCOL_DIRECTIVE: () => TOOL_USE_PROTOCOL_DIRECTIVE,
   UnknownMemberError: () => UnknownMemberError,
+  applyRetryIfMissing: () => applyRetryIfMissing,
+  buildRetryPrompt: () => buildRetryPrompt,
   buildSkillDefinition: () => buildSkillDefinition,
   buildSystemPrompt: () => buildSystemPrompt,
+  checkMemberToolEmissionSets: () => checkMemberToolEmissionSets,
+  checkMemberToolEmissions: () => checkMemberToolEmissions,
   cleanAgentContent: () => cleanAgentContent,
   computeAgentSkills: () => computeAgentSkills,
   computeAgentTools: () => computeAgentTools,
+  enforceDesignPhaseToolEmissions: () => enforceDesignPhaseToolEmissions,
   getAgent: () => getAgent,
   getBasePromptModules: () => getBasePromptModules,
   getCouncilAgents: () => getCouncilAgents,
@@ -21207,6 +21691,8 @@ __export(council_exports, {
   promoteMember: () => promoteMember,
   renderSkillMarkdown: () => renderSkillMarkdown,
   runCouncilPure: () => runCouncilPure,
+  runRetryTurnForMember: () => runRetryTurnForMember,
+  shouldRetryMember: () => shouldRetryMember,
   slugify: () => slugify3,
   stripClarificationProtocol: () => stripClarificationProtocol,
   swapMembers: () => swapMembers
@@ -21256,6 +21742,12 @@ async function* dispatchCouncil(userMessage, options) {
     maxToolCallsPerTurn: options.maxToolCallsPerTurn,
     feedbackStore: options.feedbackStore
   };
+  if (!options.disableWorkspaceTools) {
+    const { setWorkspaceStubs: setWorkspaceStubs2 } = await Promise.resolve().then(() => (init_skills2(), skills_exports));
+    const { createWorkspaceContext: buildCtx, createWorkspaceStubs: buildStubs } = await Promise.resolve().then(() => (init_stubs(), stubs_exports));
+    const wsCtx = options.workspaceRoot ? buildCtx(options.workspaceRoot) : buildCtx();
+    setWorkspaceStubs2(buildStubs(wsCtx));
+  }
   yield* runCouncilPure(userMessage, config2, {});
 }
 var CouncilDispatchError;
@@ -21524,36 +22016,220 @@ var init_agentsMd = __esm({
   }
 });
 
+// src/cli/workspace/completeDesign.ts
+function curatedTasksForPhase(phase) {
+  const label = (phase.name ?? phase.id).trim();
+  const scope = phase.description?.trim() ? ` Scope: ${phase.description.trim()}` : "";
+  return [
+    {
+      title: `Specify ${label} deliverables`,
+      description: `Turn the council documents for "${label}" into a concrete specification: enumerate deliverables, interfaces, constraints, and open decisions, grounding each item in the ADRs and design docs already present in .zelari/.${scope}`,
+      fileRefs: [".zelari/docs/", ".zelari/decisions/"],
+      acceptance: [
+        `A written spec for "${label}" exists and references at least one ADR or design doc`,
+        "Every deliverable in the spec has an owner artifact (file, doc, or component) named"
+      ],
+      qaScenario: `Open the spec for "${label}" and confirm each deliverable maps to a concrete artifact and no open decision is left unresolved.`,
+      priority: "high"
+    },
+    {
+      title: `Implement ${label} deliverables`,
+      description: `Produce the artifacts the "${label}" phase promises, following the spec task of this phase and the decisions recorded in .zelari/decisions/.${scope}`,
+      fileRefs: ["src/"],
+      acceptance: [
+        `Every deliverable listed in the "${label}" spec exists and builds/renders without errors`,
+        "No implementation contradicts an accepted ADR"
+      ],
+      qaScenario: `Walk the "${label}" spec top to bottom and check each deliverable off against the produced artifact.`,
+      priority: "high"
+    },
+    {
+      title: `Verify ${label} exit criteria`,
+      description: `Run the QA pass for "${label}": execute the QA scenarios of the phase tasks, check the phase row in the synthesis green-light checklist, and record any gaps as follow-up tasks.${scope}`,
+      fileRefs: [".zelari/docs/synthesis.md"],
+      acceptance: [
+        `The "${label}" row of the synthesis green-light checklist passes`,
+        "All QA scenarios of this phase have been executed with recorded outcomes"
+      ],
+      qaScenario: `Open .zelari/docs/synthesis.md, locate the "${label}" checklist row, and confirm every criterion is checked with evidence.`,
+      priority: "medium"
+    }
+  ];
+}
+async function runBuiltinCompleteDesign(ctx) {
+  const summary = readPlanSummary(ctx);
+  if (summary.phases.length === 0) {
+    return { ran: false, tasksAdded: 0, milestonesAdded: 0, reason: "plan has no phases" };
+  }
+  const stubs = createWorkspaceStubs(ctx);
+  const createTask = stubs.find((s) => s.name === "createTask");
+  const createMilestone = stubs.find((s) => s.name === "createMilestone");
+  const stubCtx = ctx;
+  let tasksAdded = 0;
+  for (const phase of summary.phases) {
+    const existingTasks = summary.tasks.filter((t) => t.phaseId === phase.id);
+    if (existingTasks.length >= MIN_TASKS_PER_PHASE) continue;
+    const existingTitles = new Set(existingTasks.map((t) => t.name ?? ""));
+    const templates = curatedTasksForPhase(phase).filter((t) => !existingTitles.has(t.title)).slice(0, MIN_TASKS_PER_PHASE - existingTasks.length);
+    for (const t of templates) {
+      await createTask.execute(
+        {
+          phaseId: phase.id,
+          title: t.title,
+          description: t.description,
+          fileRefs: t.fileRefs,
+          acceptance: t.acceptance,
+          qaScenario: t.qaScenario,
+          priority: t.priority
+        },
+        stubCtx
+      );
+      tasksAdded += 1;
+    }
+  }
+  let milestonesAdded = 0;
+  if (summary.milestones.length === 0) {
+    await createMilestone.execute(
+      {
+        title: "v0.1.0 design-complete",
+        description: "All design-phase artifacts (phases, tasks, ADRs, design docs, risks, synthesis) exist and the green-light checklist passes.",
+        targetVersion: "v0.1.0"
+      },
+      stubCtx
+    );
+    milestonesAdded = 1;
+  }
+  return { ran: true, tasksAdded, milestonesAdded };
+}
+var MIN_TASKS_PER_PHASE;
+var init_completeDesign = __esm({
+  "src/cli/workspace/completeDesign.ts"() {
+    "use strict";
+    init_stubs();
+    MIN_TASKS_PER_PHASE = 3;
+  }
+});
+
 // src/cli/workspace/postCouncilHook.ts
 var postCouncilHook_exports = {};
 __export(postCouncilHook_exports, {
+  runCompleteDesignPostProcessor: () => runCompleteDesignPostProcessor,
   runPostCouncilHook: () => runPostCouncilHook
 });
-async function runPostCouncilHook(ctx) {
-  if (process.env["ZELARI_AGENTS_MD"] === "0") {
-    return { ran: false, changed: false, sections: [], reason: "ZELARI_AGENTS_MD=0 (disabled)" };
+import { spawn as spawn3 } from "node:child_process";
+import { existsSync as existsSync12, readFileSync as readFileSync9 } from "node:fs";
+import { join as join7 } from "node:path";
+async function runCompleteDesignPostProcessor(ctx) {
+  if (process.env["ZELARI_COMPLETE_DESIGN"] === "0") {
+    return { ran: false, reason: "ZELARI_COMPLETE_DESIGN=0 (disabled)" };
+  }
+  const planJsonPath2 = join7(ctx.rootDir, "plan.json");
+  const scriptPath = join7(ctx.projectRoot, "complete-design.mjs");
+  if (!existsSync12(planJsonPath2)) {
+    return { ran: false, reason: ".zelari/plan.json missing (not design-phase)" };
   }
+  let phaseCount = 0;
   try {
-    const result = await updateAgentsMd(ctx, ctx.projectRoot);
-    return {
-      ran: true,
-      changed: result.changed,
-      sections: result.sections,
-      ...result.reason ? { reason: result.reason } : {}
-    };
-  } catch (err) {
-    return {
+    const parsed = JSON.parse(readFileSync9(planJsonPath2, "utf8"));
+    phaseCount = Array.isArray(parsed.phases) ? parsed.phases.length : 0;
+  } catch {
+    return { ran: false, reason: ".zelari/plan.json corrupt" };
+  }
+  if (phaseCount === 0) {
+    return { ran: false, reason: ".zelari/plan.json has no phases" };
+  }
+  if (!existsSync12(scriptPath)) {
+    try {
+      const builtin = await runBuiltinCompleteDesign(ctx);
+      return {
+        ran: builtin.ran,
+        ...builtin.ran ? { exitCode: 0 } : {},
+        output: `builtin complete-design: +${builtin.tasksAdded} tasks, +${builtin.milestonesAdded} milestones`,
+        ...builtin.reason ? { reason: builtin.reason } : {}
+      };
+    } catch (err) {
+      return {
+        ran: true,
+        exitCode: -1,
+        reason: `builtin complete-design error: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
+  }
+  return await new Promise((resolveRun) => {
+    const child = spawn3(process.execPath, [scriptPath], {
+      cwd: ctx.projectRoot,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: process.env
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString("utf8");
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString("utf8");
+    });
+    child.on("error", (err) => {
+      resolveRun({
+        ran: true,
+        exitCode: -1,
+        output: stderr,
+        reason: `spawn error: ${err.message}`
+      });
+    });
+    child.on("close", (code) => {
+      const exitCode = code ?? -1;
+      const ok = exitCode === 0;
+      resolveRun({
+        ran: true,
+        exitCode,
+        output: stdout + stderr,
+        ...ok ? {} : { reason: `complete-design exited with code ${exitCode}` }
+      });
+    });
+  });
+}
+async function runPostCouncilHook(ctx) {
+  let agentsMdResult;
+  if (process.env["ZELARI_AGENTS_MD"] === "0") {
+    agentsMdResult = {
       ran: false,
       changed: false,
       sections: [],
-      reason: `error: ${err instanceof Error ? err.message : String(err)}`
+      reason: "ZELARI_AGENTS_MD=0 (disabled)"
     };
+  } else {
+    try {
+      const result = await updateAgentsMd(ctx, ctx.projectRoot);
+      agentsMdResult = {
+        ran: true,
+        changed: result.changed,
+        sections: result.sections,
+        ...result.reason ? { reason: result.reason } : {}
+      };
+    } catch (err) {
+      agentsMdResult = {
+        ran: false,
+        changed: false,
+        sections: [],
+        reason: `error: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
   }
+  const completeDesign = await runCompleteDesignPostProcessor(ctx);
+  return {
+    ran: agentsMdResult.ran || completeDesign.ran,
+    changed: agentsMdResult.changed,
+    sections: agentsMdResult.sections,
+    ...agentsMdResult.reason ? { reason: agentsMdResult.reason } : {},
+    completeDesign
+  };
 }
 var init_postCouncilHook = __esm({
   "src/cli/workspace/postCouncilHook.ts"() {
     "use strict";
     init_agentsMd();
+    init_completeDesign();
   }
 });
 
@@ -21564,8 +22240,8 @@ __export(councilFeedback_exports, {
 });
 import {
   promises as fs11,
-  existsSync as existsSync12,
-  readFileSync as readFileSync9,
+  existsSync as existsSync13,
+  readFileSync as readFileSync10,
   writeFileSync as writeFileSync8,
   mkdirSync as mkdirSync8
 } from "node:fs";
@@ -21673,9 +22349,9 @@ var init_councilFeedback = __esm({
       }
       // --- persistence ---------------------------------------------------------
       load() {
-        if (!existsSync12(this.file)) return;
+        if (!existsSync13(this.file)) return;
         try {
-          const raw = readFileSync9(this.file, "utf-8");
+          const raw = readFileSync10(this.file, "utf-8");
           const parsed = JSON.parse(raw);
           if (parsed && Array.isArray(parsed.entries)) {
             this.entries = parsed.entries.filter(
@@ -21721,7 +22397,7 @@ __export(updater_exports, {
   performUpdate: () => performUpdate
 });
 import { createRequire } from "node:module";
-import { spawn as spawn3 } from "node:child_process";
+import { spawn as spawn4 } from "node:child_process";
 import path16 from "node:path";
 import { fileURLToPath } from "node:url";
 function getCurrentVersion() {
@@ -21786,7 +22462,7 @@ async function checkForUpdate(fetcher = fetch, registryUrl) {
     updateAvailable: cmp < 0
   };
 }
-async function performUpdate(packageName = "zelari-code", executor = spawn3) {
+async function performUpdate(packageName = "zelari-code", executor = spawn4) {
   return new Promise((resolve) => {
     const args = ["install", "-g", `${packageName}@latest`];
     let stdout = "";
@@ -21831,7 +22507,7 @@ var init_updater = __esm({
 });
 
 // src/cli/main.ts
-import React9 from "react";
+import React10 from "react";
 import { render } from "ink";
 
 // src/cli/app.tsx
@@ -26651,7 +27327,7 @@ async function handlePromoteMember(ctx, memberId) {
 }
 
 // src/cli/branchManager.ts
-import { promises as fs13, existsSync as existsSync13, readFileSync as readFileSync10, writeFileSync as writeFileSync9, mkdirSync as mkdirSync9, statSync as statSync4, rmSync } from "node:fs";
+import { promises as fs13, existsSync as existsSync14, readFileSync as readFileSync11, writeFileSync as writeFileSync9, mkdirSync as mkdirSync9, statSync as statSync4, rmSync } from "node:fs";
 import path18 from "node:path";
 import os9 from "node:os";
 var META_FILENAME = "meta.json";
@@ -26673,11 +27349,11 @@ function sessionsPathFor(name, baseDir) {
 }
 function readBranchMeta(name, baseDir) {
   const metaPath = metaPathFor(name, baseDir);
-  if (!existsSync13(metaPath)) {
+  if (!existsSync14(metaPath)) {
     throw new BranchNotFoundError(`Branch "${name}" not found`);
   }
   try {
-    const raw = readFileSync10(metaPath, "utf-8");
+    const raw = readFileSync11(metaPath, "utf-8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || typeof parsed.name !== "string" || typeof parsed.createdAt !== "number" || typeof parsed.fromSessionId !== "string") {
       throw new BranchCorruptError(`Branch "${name}" meta.json is malformed`);
@@ -26733,7 +27409,7 @@ var SessionNotFoundError = class extends Error {
 };
 function branchExists(name, baseDir = getBranchesBaseDir()) {
   const bp = branchPathFor(name, baseDir);
-  return existsSync13(bp) && existsSync13(metaPathFor(name, baseDir));
+  return existsSync14(bp) && existsSync14(metaPathFor(name, baseDir));
 }
 async function createBranch(name, fromSessionId, baseDir = getBranchesBaseDir(), sessionsBaseDir = getSessionsBaseDir()) {
   if (!name || name.trim().length === 0) {
@@ -26746,7 +27422,7 @@ async function createBranch(name, fromSessionId, baseDir = getBranchesBaseDir(),
     throw new BranchAlreadyExistsError(name);
   }
   const sourcePath = path18.join(sessionsBaseDir, `${fromSessionId}.jsonl`);
-  if (!existsSync13(sourcePath)) {
+  if (!existsSync14(sourcePath)) {
     throw new SessionNotFoundError(`Source session "${fromSessionId}" not found at ${sourcePath}`);
   }
   const branchPath = branchPathFor(name, baseDir);
@@ -26779,7 +27455,7 @@ async function listBranches(baseDir = getBranchesBaseDir()) {
   const results = [];
   for (const entry of entries) {
     const metaPath = metaPathFor(entry, baseDir);
-    if (!existsSync13(metaPath)) continue;
+    if (!existsSync14(metaPath)) continue;
     try {
       const meta3 = readBranchMeta(entry, baseDir);
       const sessionCount = await countSessions(entry, baseDir);
@@ -27017,7 +27693,7 @@ async function validateApiKey(providerId, apiKey, options = {}) {
 init_providerConfig();
 
 // src/cli/modelDiscovery.ts
-import { promises as fs15, existsSync as existsSync14, readFileSync as readFileSync11 } from "node:fs";
+import { promises as fs15, existsSync as existsSync15, readFileSync as readFileSync12 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import path20 from "node:path";
 var PROVIDER_BASE_URLS = {
@@ -27033,9 +27709,9 @@ function getModelsFilePath() {
   return defaultModelsFilePath();
 }
 function loadModelsRegistry(file2 = getModelsFilePath()) {
-  if (!existsSync14(file2)) return {};
+  if (!existsSync15(file2)) return {};
   try {
-    const raw = readFileSync11(file2, "utf-8");
+    const raw = readFileSync12(file2, "utf-8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object") return {};
     return parsed;
@@ -27395,7 +28071,7 @@ import path21 from "node:path";
 import os10 from "node:os";
 
 // src/cli/skillHistory.ts
-import { promises as fs16, existsSync as existsSync15, statSync as statSync5, renameSync as renameSync4, appendFileSync as appendFileSync2, mkdirSync as mkdirSync11 } from "node:fs";
+import { promises as fs16, existsSync as existsSync16, statSync as statSync5, renameSync as renameSync4, appendFileSync as appendFileSync2, mkdirSync as mkdirSync11 } from "node:fs";
 var SKILL_HISTORY_ROTATE_BYTES = 10 * 1024 * 1024;
 async function readSkillHistory(file2) {
   let raw = "";
@@ -28019,7 +28695,7 @@ function App() {
       id: "banner-once",
       role: "system",
       ts: 0,
-      content: `zelari-code v0.7.3 \u2014 ${activeProviderSpec.id}/${activeModel}
+      content: `zelari-code v${VERSION} \u2014 ${activeProviderSpec.id}/${activeModel}
 ${skills.length} skills available. Type /help for the list, or /skill <name>.
 \u2500\u2500 skills \u2500\u2500
 ${skillList}`
@@ -28050,13 +28726,147 @@ ${skillList}`
   )));
 }
 
+// src/cli/components/SplashScreen.tsx
+import React7, { useEffect as useEffect4, useState as useState5 } from "react";
+import { Box as Box7, Text as Text7, useInput, useStdin } from "ink";
+var SPLASH_DURATION_MS = 2e3;
+var EMBLEM_LARGE = `                              =%@*-
+                            =%@@@@@#:
+                           *%%%%%%@@%-
+                         :#%%%%%%%%%@@*
+                       :*%%%%%%%%%%%%%@%*.
+                      =%%%%%%%%%%%%%%%%@@%.
+                     =%%%%%%%%%%%%%%%%%%%@%-
+                    *%%%%%%%%%%%%%%%%%%%%%@@=
+                  .#%%%%%%%%@@@@@@@@%%%%%%@@@+
+                 :#%%%%%%@@@@@@@@@@@@@@@%%%%@@+
+                -%%%%%@@@@@@@@@@@@@@@@@@@@@%%@@#.
+               -%%%%%@@@@@@@@@@@@@@@@@@@@@@@%%@@%:
+              =%%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@%@@%.
+             +%%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%@@%:
+            =%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@-
+           -%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%:
+          :%%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%
+          #%%%%%@@@@@@@@@@@@@@@%--#%@@@@@@@@@@@@@%%@@@=
+          #@@%%%%@@@@@@@@@@@@@@%:  -*@@@@@@@@@@@%%@@@@=
+           #@@%%%%@@@@@@@@@@@@@%: .. -#@@@@@@@%%%%@@@=
+            +@@@%%%@@@@@@@@@@@@%: :#=  =%@@@@%%%@@@%-
+             =@@@@%%%@@@@@@@@@@%: -%%*:  +%@@%%@@@#
+              +%@@@@%%@@@@@@@@@%: -%@@%*=.:+#@@@@#:
+          .+*@@@@@@@@@%%%@@@@@@%: -%@@@@@#-  +@@@@@@*=
+        =*%%%%@@@@@@@@@@@%%@@@@%: -#@@@@@@@*: :*@@@@@@%+=
+     -*%%%%%%%%%%@@@@@@@@@@@@@@@: -%@@@@@@@@#-  -#@@@@@@@@*
+     #%%%%%%%%%%%%%@@@@@@@@@@@@@: -#@@@@@%+-::.   *@@@@@@@@=
+    =%%%%%%%%%%%%%%%@@@@@@@@@@@@: :*+--=%#. :+++++*@@@@@@@@%
+    #@%%%%%%%%%%%%%@@@@@@@@@@@@%: .. -  -##  *@@@@@@@@@@@@@@=
+   :@@%%%%%%%%%%%%@@@@@@@@@@@@@%:  .**=  *%= :%@@@@@@@@@@@@@%
+   #@@@%%%%%%%%%%%@@@@@@@@@@@@@@- =#@@%- :**: =%@@@@@@@@@@@@@+
+  =@@@@@%%%@@%%%%@@@@@@@@@@@@@@@@@@@@@@%- :: .-#@@@@@@@@@@@@@%.
+ :@@@@@@%%@@@%%@@@@@@@@@@@@@@@@@@@@@@@@@%==*%%@@@@@@@@@@@@@@@@#
+ *@@@@@@@%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:
+:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@+
+=##########*######**##**#*********##**#*#######################*`;
+var EMBLEM_SMALL = `                    =%%*:
+                  :#%%@@@+
+                 =%%%%%%%@#.
+               .*%%%%%%%%%@%-
+              =%%%%%%%%%%%%%@*.
+             +%%%%%%@@@@@%%%%@%:
+            *%%%%@@@@@@@@@@@%%@%:
+           *%%%@@@@@@@@@@@@@@@%@%-
+         :#%%@@@@@@@@@@@@@@@@@@@@@+
+        :%%%@@@@@@@@@@@@@@@@@@@@@@@+
+        #%%@@@@@@@@@@@@@@@@@@@@@@@@@-
+       +%%@@@@@@@@@@@@#@@@@@@@@@@@@@%:
+       %%%%@@@@@@@@@@%::*@@@@@@@@@%@@=
+       -%@%%@@@@@@@@@%:.::*@@@@@%%@@*.
+        :%@@%%@@@@@@@%.:%#::*@@%@@@-
+         :#@@@%@@@@@@%.:%@%+.-#@@@=
+      :+#@@@@@@@%@@@@%.:%@@@%=.+@@@%*-
+   .*#%%%%%%@@@@@@@@@@.:%@@@@@*:.+%@@@@#-
+   +%%%%%%%%%%@@@@@@@@::##*%* :----%@@@@%.
+  .@%%%%%%%%%@@@@@@@@@:.-..-#=:%@@@@@@@@@+
+  *@@%%%%%%%%@@@@@@@@@: =#+ +#.-@@@@@@@@@@.
+ -@@@%%%%%%%@@@@@@@@@@#%@@@- -.:*@@@@@@@@@*
+ %@@@@%@@%@@@@@@@@@@@@@@@@@%**%@@@@@@@@@@@@:
+=@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*`;
+var FOOTER_ROWS = 5;
+function measure(art) {
+  const lines = art.split("\n");
+  return {
+    art,
+    width: Math.max(...lines.map((l) => l.length)),
+    height: lines.length
+  };
+}
+var VARIANTS = [measure(EMBLEM_LARGE), measure(EMBLEM_SMALL)];
+function pickSplashArt(columns, rows) {
+  for (const v of VARIANTS) {
+    if (v.width <= columns - 2 && v.height + FOOTER_ROWS <= rows) return v;
+  }
+  return null;
+}
+function shouldShowSplash(opts) {
+  if (!opts.isTTY) return false;
+  if (opts.env["ZELARI_NO_SPLASH"] === "1") return false;
+  return pickSplashArt(opts.columns, opts.rows) !== null;
+}
+function Splash({ onDone, version: version2 }) {
+  const { isRawModeSupported } = useStdin();
+  const columns = process.stdout.columns ?? 80;
+  const rows = process.stdout.rows ?? 24;
+  const picked = pickSplashArt(columns, rows);
+  useEffect4(() => {
+    const t = setTimeout(onDone, SPLASH_DURATION_MS);
+    return () => clearTimeout(t);
+  }, [onDone]);
+  useInput(
+    () => {
+      onDone();
+    },
+    { isActive: isRawModeSupported === true }
+  );
+  if (!picked) return null;
+  return /* @__PURE__ */ React7.createElement(
+    Box7,
+    {
+      flexDirection: "column",
+      alignItems: "center",
+      justifyContent: "center",
+      width: columns,
+      height: rows - 1
+    },
+    /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, picked.art),
+    /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, { bold: true, color: "white" }, "Z E L A R I   C O D E")),
+    /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, `${version2 ? `v${version2} \u2014 ` : ""}N-THEM Studio`),
+    /* @__PURE__ */ React7.createElement(Text7, { dimColor: true, italic: true }, "press any key to skip")
+  );
+}
+function SplashGate({
+  children,
+  version: version2
+}) {
+  const [show, setShow] = useState5(
+    () => shouldShowSplash({
+      isTTY: process.stdout.isTTY === true,
+      env: process.env,
+      columns: process.stdout.columns ?? 80,
+      rows: process.stdout.rows ?? 24
+    })
+  );
+  if (show) {
+    return /* @__PURE__ */ React7.createElement(Splash, { onDone: () => setShow(false), version: version2 });
+  }
+  return /* @__PURE__ */ React7.createElement(React7.Fragment, null, children);
+}
+
 // src/cli/main.ts
 init_providerConfig();
 
 // src/cli/wizard/firstRun.ts
-import { existsSync as existsSync16 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 function shouldRunWizard(input) {
-  const exists = input.exists ?? existsSync16;
+  const exists = input.exists ?? existsSync17;
   if (input.hasResetConfigFlag) {
     return { shouldRun: true, reason: "--reset-config flag forced wizard" };
   }
@@ -28091,15 +28901,15 @@ function parseWizardFlags(argv) {
 }
 
 // src/cli/wizard/runWizard.tsx
-import React8, { useEffect as useEffect4, useState as useState5 } from "react";
-import { Box as Box8, Text as Text8 } from "ink";
-import { useInput } from "ink";
+import React9, { useEffect as useEffect5, useState as useState6 } from "react";
+import { Box as Box9, Text as Text9 } from "ink";
+import { useInput as useInput2 } from "ink";
 init_keyStore();
 init_providerConfig();
 
 // src/cli/wizard/index.tsx
-import React7 from "react";
-import { Box as Box7, Text as Text7 } from "ink";
+import React8 from "react";
+import { Box as Box8, Text as Text8 } from "ink";
 
 // src/cli/wizard/useWizardState.ts
 init_providerConfig();
@@ -28214,18 +29024,17 @@ function createWizardState(opts) {
 var API_KEY_OPTIONS = ["env", "keystore", "skip"];
 
 // src/cli/wizard/index.tsx
-var VERSION = "0.7.2";
 function Frame({ children }) {
-  return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1 }, children);
+  return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1 }, children);
 }
 function Step(props) {
-  return /* @__PURE__ */ React7.createElement(Box7, null, /* @__PURE__ */ React7.createElement(Text7, { color: props.active ? "cyan" : "gray", inverse: props.active }, " ", props.index, "/", props.total, " ", props.name, " "));
+  return /* @__PURE__ */ React8.createElement(Box8, null, /* @__PURE__ */ React8.createElement(Text8, { color: props.active ? "cyan" : "gray", inverse: props.active }, " ", props.index, "/", props.total, " ", props.name, " "));
 }
 function renderProviderList(providers, cursor) {
-  return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, providers.map((p3, i) => {
+  return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column" }, providers.map((p3, i) => {
     const arrow = i === cursor ? "\u279C " : "  ";
     const color = i === cursor ? "cyan" : void 0;
-    return /* @__PURE__ */ React7.createElement(Text7, { key: p3.id, color }, arrow, p3.displayName, " ", /* @__PURE__ */ React7.createElement(Text7, { color: "gray" }, "(", p3.id, ", uses env ", p3.envVar, ")"));
+    return /* @__PURE__ */ React8.createElement(Text8, { key: p3.id, color }, arrow, p3.displayName, " ", /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "(", p3.id, ", uses env ", p3.envVar, ")"));
   }));
 }
 function renderApiKeyOptions(cursor) {
@@ -28234,37 +29043,37 @@ function renderApiKeyOptions(cursor) {
     keystore: "Save to local keyStore (encrypted)",
     skip: "Skip for now (chat will fail until key is set)"
   };
-  return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, API_KEY_OPTIONS.map((choice, i) => {
+  return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column" }, API_KEY_OPTIONS.map((choice, i) => {
     const arrow = i === cursor ? "\u279C " : "  ";
     const color = i === cursor ? "cyan" : void 0;
-    return /* @__PURE__ */ React7.createElement(Text7, { key: choice, color }, arrow, labels[choice]);
+    return /* @__PURE__ */ React8.createElement(Text8, { key: choice, color }, arrow, labels[choice]);
   }));
 }
 function Wizard({ state: state2, providers }) {
   const s = state2.state;
   if (s.committed) {
-    return /* @__PURE__ */ React7.createElement(Frame, null, /* @__PURE__ */ React7.createElement(Text7, { color: "green" }, "\u2713 Setup complete!"), /* @__PURE__ */ React7.createElement(Text7, null, "Provider: ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, s.providerId), " | ", "Model: ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, s.model), " | ", "API key: ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, s.apiKeyChoice ?? "n/a")), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, { color: "gray" }, "Launching zelari-code\u2026 (press any key)")));
+    return /* @__PURE__ */ React8.createElement(Frame, null, /* @__PURE__ */ React8.createElement(Text8, { color: "green" }, "\u2713 Setup complete!"), /* @__PURE__ */ React8.createElement(Text8, null, "Provider: ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, s.providerId), " | ", "Model: ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, s.model), " | ", "API key: ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, s.apiKeyChoice ?? "n/a")), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "Launching zelari-code\u2026 (press any key)")));
   }
-  return /* @__PURE__ */ React7.createElement(Frame, null, /* @__PURE__ */ React7.createElement(Text7, { color: "cyan", bold: true }, "zelari-code v", VERSION, " \u2014 first-time setup"), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1, marginBottom: 1, flexDirection: "row" }, /* @__PURE__ */ React7.createElement(Step, { index: 1, total: 5, name: "welcome", active: s.step === "welcome" }), /* @__PURE__ */ React7.createElement(Step, { index: 2, total: 5, name: "provider", active: s.step === "provider" }), /* @__PURE__ */ React7.createElement(Step, { index: 3, total: 5, name: "model", active: s.step === "model" }), /* @__PURE__ */ React7.createElement(Step, { index: 4, total: 5, name: "apikey", active: s.step === "apikey" }), /* @__PURE__ */ React7.createElement(Step, { index: 5, total: 5, name: "confirm", active: s.step === "confirm" })), s.step === "welcome" && /* @__PURE__ */ React7.createElement(React7.Fragment, null, /* @__PURE__ */ React7.createElement(Text7, null, "Welcome! Let's get you coding in under two minutes."), /* @__PURE__ */ React7.createElement(Text7, { color: "gray" }, "We'll pick a provider, default model, and how to handle your API key."), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, null, "Press "), /* @__PURE__ */ React7.createElement(Text7, { color: "cyan", inverse: true }, " Enter "), /* @__PURE__ */ React7.createElement(Text7, null, " to continue, or "), /* @__PURE__ */ React7.createElement(Text7, { color: "red", inverse: true }, " Q "), /* @__PURE__ */ React7.createElement(Text7, null, " to quit (re-run with "), /* @__PURE__ */ React7.createElement(Text7, { color: "gray" }, "--no-wizard"), /* @__PURE__ */ React7.createElement(Text7, null, " to skip later)."))), s.step === "provider" && /* @__PURE__ */ React7.createElement(React7.Fragment, null, /* @__PURE__ */ React7.createElement(Text7, null, "Choose your LLM provider:"), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, renderProviderList(providers, s.providerCursor)), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "model" && /* @__PURE__ */ React7.createElement(React7.Fragment, null, /* @__PURE__ */ React7.createElement(Text7, null, "Model for ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, s.providerId), ":"), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1, borderStyle: "single", borderColor: "cyan", paddingX: 1 }, /* @__PURE__ */ React7.createElement(Text7, null, s.model ?? "(empty)")), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, null, "Press ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan", inverse: true }, " Enter "), "to accept, or type a new name. ", /* @__PURE__ */ React7.createElement(Text7, { color: "gray" }, "(default kept on empty input)")))), s.step === "apikey" && /* @__PURE__ */ React7.createElement(React7.Fragment, null, /* @__PURE__ */ React7.createElement(Text7, null, "How should we handle the API key?"), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, renderApiKeyOptions(s.apiKeyCursor)), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "confirm" && /* @__PURE__ */ React7.createElement(React7.Fragment, null, /* @__PURE__ */ React7.createElement(Text7, null, "Confirm your setup:"), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React7.createElement(Text7, null, "Provider: ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, s.providerId)), /* @__PURE__ */ React7.createElement(Text7, null, "Model:    ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, s.model)), /* @__PURE__ */ React7.createElement(Text7, null, "API key:  ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, s.apiKeyChoice ?? "(unset)"))), /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, null, "Press ", /* @__PURE__ */ React7.createElement(Text7, { color: "green", inverse: true }, " Enter "), "to save and launch, or ", /* @__PURE__ */ React7.createElement(Text7, { color: "yellow", inverse: true }, " B "), "to go back."))));
+  return /* @__PURE__ */ React8.createElement(Frame, null, /* @__PURE__ */ React8.createElement(Text8, { color: "cyan", bold: true }, "zelari-code v", VERSION, " \u2014 first-time setup"), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1, marginBottom: 1, flexDirection: "row" }, /* @__PURE__ */ React8.createElement(Step, { index: 1, total: 5, name: "welcome", active: s.step === "welcome" }), /* @__PURE__ */ React8.createElement(Step, { index: 2, total: 5, name: "provider", active: s.step === "provider" }), /* @__PURE__ */ React8.createElement(Step, { index: 3, total: 5, name: "model", active: s.step === "model" }), /* @__PURE__ */ React8.createElement(Step, { index: 4, total: 5, name: "apikey", active: s.step === "apikey" }), /* @__PURE__ */ React8.createElement(Step, { index: 5, total: 5, name: "confirm", active: s.step === "confirm" })), s.step === "welcome" && /* @__PURE__ */ React8.createElement(React8.Fragment, null, /* @__PURE__ */ React8.createElement(Text8, null, "Welcome! Let's get you coding in under two minutes."), /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "We'll pick a provider, default model, and how to handle your API key."), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, null, "Press "), /* @__PURE__ */ React8.createElement(Text8, { color: "cyan", inverse: true }, " Enter "), /* @__PURE__ */ React8.createElement(Text8, null, " to continue, or "), /* @__PURE__ */ React8.createElement(Text8, { color: "red", inverse: true }, " Q "), /* @__PURE__ */ React8.createElement(Text8, null, " to quit (re-run with "), /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "--no-wizard"), /* @__PURE__ */ React8.createElement(Text8, null, " to skip later)."))), s.step === "provider" && /* @__PURE__ */ React8.createElement(React8.Fragment, null, /* @__PURE__ */ React8.createElement(Text8, null, "Choose your LLM provider:"), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, renderProviderList(providers, s.providerCursor)), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "model" && /* @__PURE__ */ React8.createElement(React8.Fragment, null, /* @__PURE__ */ React8.createElement(Text8, null, "Model for ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, s.providerId), ":"), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1, borderStyle: "single", borderColor: "cyan", paddingX: 1 }, /* @__PURE__ */ React8.createElement(Text8, null, s.model ?? "(empty)")), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, null, "Press ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan", inverse: true }, " Enter "), "to accept, or type a new name. ", /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "(default kept on empty input)")))), s.step === "apikey" && /* @__PURE__ */ React8.createElement(React8.Fragment, null, /* @__PURE__ */ React8.createElement(Text8, null, "How should we handle the API key?"), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, renderApiKeyOptions(s.apiKeyCursor)), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "\u2191/\u2193 to move, Enter to confirm"))), s.step === "confirm" && /* @__PURE__ */ React8.createElement(React8.Fragment, null, /* @__PURE__ */ React8.createElement(Text8, null, "Confirm your setup:"), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React8.createElement(Text8, null, "Provider: ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, s.providerId)), /* @__PURE__ */ React8.createElement(Text8, null, "Model:    ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, s.model)), /* @__PURE__ */ React8.createElement(Text8, null, "API key:  ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, s.apiKeyChoice ?? "(unset)"))), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, null, "Press ", /* @__PURE__ */ React8.createElement(Text8, { color: "green", inverse: true }, " Enter "), "to save and launch, or ", /* @__PURE__ */ React8.createElement(Text8, { color: "yellow", inverse: true }, " B "), "to go back."))));
 }
 
 // src/cli/wizard/runWizard.tsx
 function RunWizard(_props) {
-  const [wiz] = useState5(
+  const [wiz] = useState6(
     () => createWizardState({
       providers: PROVIDERS,
       defaultModelFor: (id) => getModelForProvider(id)
     })
   );
-  const [, force] = useState5(0);
-  useEffect4(() => {
+  const [, force] = useState6(0);
+  useEffect5(() => {
     if (typeof wiz.subscribe === "function") {
       const sub = wiz.subscribe(() => force((n) => n + 1));
       return () => sub();
     }
     return void 0;
   }, [wiz]);
-  useInput((input, key) => {
+  useInput2((input, key) => {
     if (wiz.state.committed) return;
     const s = wiz.state;
     if (key.escape) {
@@ -28321,20 +29130,20 @@ function RunWizard(_props) {
     }
   });
   if (wiz.state.committed) {
-    return /* @__PURE__ */ React8.createElement(PostCommitBridge, null);
+    return /* @__PURE__ */ React9.createElement(PostCommitBridge, null);
   }
-  return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React8.createElement(Wizard, { state: wiz, providers: PROVIDERS }));
+  return /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React9.createElement(Wizard, { state: wiz, providers: PROVIDERS }));
 }
 function PostCommitBridge() {
-  const [showApp, setShowApp] = useState5(false);
-  useEffect4(() => {
+  const [showApp, setShowApp] = useState6(false);
+  useEffect5(() => {
     const t = setTimeout(() => setShowApp(true), 1200);
     return () => clearTimeout(t);
   }, []);
   if (showApp) {
-    return /* @__PURE__ */ React8.createElement(App, null);
+    return /* @__PURE__ */ React9.createElement(App, null);
   }
-  return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React8.createElement(Box8, { borderStyle: "round", borderColor: "green", paddingX: 2, paddingY: 1, flexDirection: "column" }, /* @__PURE__ */ React8.createElement(Text8, { color: "green", bold: true }, "\u2713 Setup complete! Launching zelari-code\u2026"), /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "Press Ctrl+C any time to exit.")));
+  return /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React9.createElement(Box9, { borderStyle: "round", borderColor: "green", paddingX: 2, paddingY: 1, flexDirection: "column" }, /* @__PURE__ */ React9.createElement(Text9, { color: "green", bold: true }, "\u2713 Setup complete! Launching zelari-code\u2026"), /* @__PURE__ */ React9.createElement(Text9, { color: "gray" }, "Press Ctrl+C any time to exit.")));
 }
 
 // src/cli/headless.ts
@@ -28546,8 +29355,8 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
 
 // src/cli/skillsMd.ts
 init_skills2();
-import { existsSync as existsSync17, readdirSync as readdirSync4, readFileSync as readFileSync12 } from "node:fs";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync18, readdirSync as readdirSync4, readFileSync as readFileSync13 } from "node:fs";
+import { join as join8 } from "node:path";
 import { homedir as homedir4 } from "node:os";
 var CODING_CATEGORIES = /* @__PURE__ */ new Set([
   "plan",
@@ -28563,10 +29372,10 @@ var CODING_CATEGORIES = /* @__PURE__ */ new Set([
 ]);
 function skillMdSearchDirs(projectRoot = process.cwd()) {
   return [
-    join7(projectRoot, ".zelari", "skills"),
-    join7(projectRoot, ".claude", "skills"),
-    join7(projectRoot, ".opencode", "skills"),
-    join7(homedir4(), ".zelari-code", "skills")
+    join8(projectRoot, ".zelari", "skills"),
+    join8(projectRoot, ".claude", "skills"),
+    join8(projectRoot, ".opencode", "skills"),
+    join8(homedir4(), ".zelari-code", "skills")
   ];
 }
 function parseSkillMd(content, sourcePath) {
@@ -28624,7 +29433,7 @@ function loadSkillMdSkills(projectRoot = process.cwd(), options = {}) {
   const summary = { loaded: [], skipped: [] };
   const seen = new Set(options.existingIds ?? []);
   for (const dir of skillMdSearchDirs(projectRoot)) {
-    if (!existsSync17(dir)) continue;
+    if (!existsSync18(dir)) continue;
     let entries;
     try {
       entries = readdirSync4(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
@@ -28632,10 +29441,10 @@ function loadSkillMdSkills(projectRoot = process.cwd(), options = {}) {
       continue;
     }
     for (const entry of entries) {
-      const skillPath = join7(dir, entry, "SKILL.md");
-      if (!existsSync17(skillPath)) continue;
+      const skillPath = join8(dir, entry, "SKILL.md");
+      if (!existsSync18(skillPath)) continue;
       try {
-        const parsed = parseSkillMd(readFileSync12(skillPath, "utf8"), skillPath);
+        const parsed = parseSkillMd(readFileSync13(skillPath, "utf8"), skillPath);
         if (!parsed) {
           summary.skipped.push({ path: skillPath, reason: "missing/invalid frontmatter (name, description) or empty body" });
           continue;
@@ -28657,7 +29466,7 @@ function loadSkillMdSkills(projectRoot = process.cwd(), options = {}) {
 
 // src/cli/main.ts
 init_skills2();
-var VERSION2 = "0.7.5";
+var VERSION = "0.7.8";
 async function backgroundUpdateCheck() {
   if (process.env.ANATHEMA_DEV === "1") return;
   await new Promise((resolve) => setTimeout(resolve, 3e3));
@@ -28687,7 +29496,7 @@ async function shutdown() {
 function pickRootComponent() {
   const argv = process.argv.slice(2);
   if (argv.includes("--version") || argv.includes("-v")) {
-    console.log(`zelari-code v${VERSION2}`);
+    console.log(`zelari-code v${VERSION}`);
     process.exit(0);
   }
   if (argv.includes("--help") || argv.includes("-h")) {
@@ -28713,9 +29522,12 @@ function pickRootComponent() {
   });
   if (decision.shouldRun) {
     console.error(`[zelari-code] starting wizard: ${decision.reason}`);
-    return { kind: "wizard", element: React9.createElement(RunWizard) };
+    return { kind: "wizard", element: React10.createElement(RunWizard) };
   }
-  return { kind: "app", element: React9.createElement(App) };
+  return {
+    kind: "app",
+    element: React10.createElement(SplashGate, { version: VERSION }, React10.createElement(App))
+  };
 }
 function loadUserSkills() {
   try {
@@ -28758,6 +29570,6 @@ function main() {
 }
 main();
 export {
-  VERSION2 as VERSION
+  VERSION
 };
 //# sourceMappingURL=main.bundled.js.map