zelari-code 2.0.0-alpha.3 → 2.0.0-alpha.5

package/dist/cli/main.bundled.js

@@ -1939,40 +1939,47 @@ import os3 from "node:os";
 function getProviderConfigPath() {
   return process.env.ANATHEMA_PROVIDER_CONFIG_FILE ?? path4.join(os3.homedir(), ".tmp", "zelari-code", "provider.json");
 }
-function getProviderConfig() {
-  const envActive = process.env.ANATHEMA_ACTIVE_PROVIDER;
-  const envModel = process.env.OPENAI_MODEL;
-  const file2 = getProviderConfigPath();
-  let stored = null;
-  if (existsSync3(file2)) {
-    try {
-      const raw = readFileSync3(file2, "utf-8");
-      const parsed = JSON.parse(raw);
-      if (parsed && typeof parsed === "object" && typeof parsed.activeProviderId === "string" && parsed.modelByProvider && typeof parsed.modelByProvider === "object") {
-        stored = {
-          activeProviderId: parsed.activeProviderId,
-          modelByProvider: { ...DEFAULTS.modelByProvider, ...parsed.modelByProvider },
-          thinkingByProvider: { ...DEFAULTS.thinkingByProvider, ...parsed.thinkingByProvider },
-          customEndpoints: mergeCustomEndpoints(parsed.customEndpoints),
-          krakenVerifier: mergeKrakenVerifier(parsed.krakenVerifier)
-        };
-      }
-    } catch {
-    }
+function mergeStoredProviderConfig(parsed) {
+  if (parsed && typeof parsed === "object" && typeof parsed.activeProviderId === "string" && parsed.modelByProvider && typeof parsed.modelByProvider === "object") {
+    return {
+      activeProviderId: parsed.activeProviderId,
+      modelByProvider: { ...DEFAULTS.modelByProvider, ...parsed.modelByProvider },
+      thinkingByProvider: { ...DEFAULTS.thinkingByProvider, ...parsed.thinkingByProvider },
+      customEndpoints: mergeCustomEndpoints(parsed.customEndpoints),
+      krakenVerifier: mergeKrakenVerifier(parsed.krakenVerifier)
+    };
   }
-  const base = stored ?? {
+  return cloneDefaults();
+}
+function cloneDefaults() {
+  return {
     ...DEFAULTS,
     modelByProvider: { ...DEFAULTS.modelByProvider },
     thinkingByProvider: { ...DEFAULTS.thinkingByProvider },
     customEndpoints: { ...DEFAULTS.customEndpoints }
   };
+}
+function applyEnvOverrides(config2) {
+  const envActive = process.env.ANATHEMA_ACTIVE_PROVIDER;
+  const envModel = process.env.OPENAI_MODEL;
   if (envActive && PROVIDERS.some((p3) => p3.id === envActive)) {
-    base.activeProviderId = envActive;
+    config2.activeProviderId = envActive;
   }
   if (envModel && envModel.trim().length > 0) {
-    base.modelByProvider[base.activeProviderId] = envModel;
+    config2.modelByProvider[config2.activeProviderId] = envModel;
+  }
+  return config2;
+}
+function getProviderConfig() {
+  const file2 = getProviderConfigPath();
+  let parsed = null;
+  if (existsSync3(file2)) {
+    try {
+      parsed = JSON.parse(readFileSync3(file2, "utf-8"));
+    } catch {
+    }
   }
-  return base;
+  return applyEnvOverrides(mergeStoredProviderConfig(parsed));
 }
 function writeProviderConfig(config2) {
   const file2 = getProviderConfigPath();
@@ -2105,25 +2112,12 @@ function getActiveModel() {
 }
 async function loadProviderConfig() {
   const file2 = getProviderConfigPath();
+  let parsed = null;
   try {
-    const raw = await fs2.readFile(file2, "utf-8");
-    const parsed = JSON.parse(raw);
-    if (parsed && typeof parsed === "object" && typeof parsed.activeProviderId === "string" && parsed.modelByProvider && typeof parsed.modelByProvider === "object") {
-      return {
-        activeProviderId: parsed.activeProviderId,
-        modelByProvider: { ...DEFAULTS.modelByProvider, ...parsed.modelByProvider },
-        thinkingByProvider: { ...DEFAULTS.thinkingByProvider, ...parsed.thinkingByProvider },
-        customEndpoints: mergeCustomEndpoints(parsed.customEndpoints)
-      };
-    }
+    parsed = JSON.parse(await fs2.readFile(file2, "utf-8"));
   } catch {
   }
-  return {
-    ...DEFAULTS,
-    modelByProvider: { ...DEFAULTS.modelByProvider },
-    thinkingByProvider: { ...DEFAULTS.thinkingByProvider },
-    customEndpoints: { ...DEFAULTS.customEndpoints }
-  };
+  return applyEnvOverrides(mergeStoredProviderConfig(parsed));
 }
 var DEFAULTS;
 var init_providerConfig = __esm({
@@ -28387,6 +28381,23 @@ var init_modelSurface = __esm({
   }
 });
 
+// packages/core/dist/session/agentAdapter.js
+function derivedToAgentMessages(messages) {
+  const out = [];
+  for (const m of messages) {
+    const agent = { role: m.role, content: m.content };
+    if (m.toolCallId !== void 0)
+      agent.toolCallId = m.toolCallId;
+    out.push(agent);
+  }
+  return out;
+}
+var init_agentAdapter = __esm({
+  "packages/core/dist/session/agentAdapter.js"() {
+    "use strict";
+  }
+});
+
 // packages/core/dist/session/writer.js
 import { promises as fs9 } from "node:fs";
 import path14 from "node:path";
@@ -28841,6 +28852,7 @@ var init_session = __esm({
     "use strict";
     init_types8();
     init_modelSurface();
+    init_agentAdapter();
     init_writer();
     init_replay();
     init_store();
@@ -30170,6 +30182,7 @@ __export(dist_exports, {
   defaultPersonaParse: () => defaultPersonaParse,
   deriveMessages: () => deriveMessages,
   deriveMissionState: () => deriveMissionState,
+  derivedToAgentMessages: () => derivedToAgentMessages,
   detectAssistantTextLoop: () => detectAssistantTextLoop,
   detectAssistantTextLoopWindow: () => detectAssistantTextLoopWindow,
   detectDegradedRun: () => detectDegradedRun,
@@ -30740,6 +30753,34 @@ var init_sessionSpine = __esm({
       userMessage(text) {
         void this.append({ kind: "user.message", actor: ACTOR_USER, data: { text } });
       }
+      /**
+       * Log an assistant message outside the streaming path — legacy
+       * `--history` import (Exit-1/E1.2). Same event shape the message_end
+       * coalescer emits, so deriveMessages() treats both identically.
+       */
+      assistantMessage(text, extra) {
+        void this.append({
+          kind: "assistant.message",
+          actor: ACTOR_AGENT,
+          data: { text, ...extra }
+        });
+      }
+      /** Await all pending appends (import → derive read-back needs this). */
+      async flush() {
+        await this.chain;
+      }
+      /**
+       * Derive prior-turn model context from the on-disk log. Null when the
+       * log is missing/empty — callers decide whether that means "fresh".
+       */
+      async derivedPriorTurns() {
+        if (this.status !== "active" && this.status !== "closed") return null;
+        const report = await readSessionLog(
+          path21.join(this.sessionsDir, this.sessionId, "events.jsonl")
+        ).catch(() => null);
+        if (!report || report.events.length === 0) return null;
+        return deriveMessages(report.events);
+      }
       /** Mirror one BrainEvent (coalescing message deltas until message_end). */
       mirrorBrainEvent(ev) {
         if (this.status !== "active" || !this.writer) return;
@@ -39550,6 +39591,526 @@ var init_toolRegistry = __esm({
   }
 });
 
+// src/cli/phase.ts
+var phase_exports = {};
+__export(phase_exports, {
+  PHASES: () => PHASES,
+  PLAN_ALLOWED_WRITE_TOOLS: () => PLAN_ALLOWED_WRITE_TOOLS,
+  PLAN_BLOCKED_TOOLS: () => PLAN_BLOCKED_TOOLS,
+  describePhase: () => describePhase,
+  nextPhase: () => nextPhase,
+  parsePhase: () => parsePhase
+});
+function parsePhase(input) {
+  const v = input.trim().toLowerCase();
+  return PHASES.includes(v) ? v : null;
+}
+function nextPhase(current) {
+  return current === "plan" ? "build" : "plan";
+}
+function describePhase(phase2) {
+  switch (phase2) {
+    case "plan":
+      return "plan \u2014 explore & design only (no project writes; plan files allowed)";
+    default:
+      return "build \u2014 implement with full tools";
+  }
+}
+var PHASES, PLAN_ALLOWED_WRITE_TOOLS, PLAN_BLOCKED_TOOLS;
+var init_phase = __esm({
+  "src/cli/phase.ts"() {
+    "use strict";
+    PHASES = ["plan", "build"];
+    PLAN_ALLOWED_WRITE_TOOLS = /* @__PURE__ */ new Set([
+      // Workspace plan/docs — intentional plan-mode outputs
+      "createPlan",
+      "createTask",
+      "updateTask",
+      "createMilestone",
+      "createDocument",
+      "createDecision",
+      "linkDocuments"
+      // Soft writes that only touch .zelari / plan paths are still gated in
+      // toolRegistry by path when needed; write_file/edit_file stay DENIED.
+    ]);
+    PLAN_BLOCKED_TOOLS = /* @__PURE__ */ new Set([
+      "write_file",
+      "edit_file",
+      "apply_diff",
+      "bash"
+    ]);
+  }
+});
+
+// src/cli/mode.ts
+function nextMode(current) {
+  const i = MODES.indexOf(current);
+  return MODES[(i + 1) % MODES.length] ?? "kraken";
+}
+function parseMode(input) {
+  const v = input.trim().toLowerCase();
+  if (MODES.includes(v)) return v;
+  return MODE_ALIASES[v] ?? null;
+}
+function describeMode(mode) {
+  switch (mode) {
+    case "council":
+      return "council \u2014 multi-member plan/design (Caronte\u2026Lucifero; build needs ZELARI_COUNCIL_CAN_BUILD=1)";
+    case "zelari":
+      return "zelari \u2014 mission: plan@council \u2192 build@kraken (legacy: ZELARI_BUILD_VIA_AGENT=0)";
+    default:
+      return "kraken \u2014 super-agent lead (spawns explore/general/verify tentacles; default implementer)";
+  }
+}
+var MODES, MODE_ALIASES;
+var init_mode = __esm({
+  "src/cli/mode.ts"() {
+    "use strict";
+    MODES = ["kraken", "council", "zelari"];
+    MODE_ALIASES = {
+      agent: "kraken",
+      single: "kraken"
+    };
+  }
+});
+
+// src/cli/headless.ts
+import { readFileSync as readFileSync22 } from "node:fs";
+function defaultProfileForMode(mode) {
+  switch (mode) {
+    case "council":
+      return "council/v1";
+    case "zelari":
+      return "mission/v1";
+    default:
+      return "kraken/v1";
+  }
+}
+function parseHeadlessFlags(argv) {
+  if (!argv.includes("--headless")) {
+    return { options: null };
+  }
+  let task;
+  let output = "json";
+  let mode = "kraken";
+  let phase2 = "build";
+  let modeExplicit = false;
+  let councilFlag = false;
+  let provider;
+  let model;
+  let history2;
+  let todos2;
+  let once = false;
+  let profile;
+  let resumeSessionId;
+  let exportSessionPath;
+  let strictDone = false;
+  let krakenGraph;
+  let planOnly = process.env.ZELARI_KRAKEN_PLAN_ONLY === "1" || process.env.ZELARI_KRAKEN_PLAN_ONLY === "true";
+  let runPlan = process.env.ZELARI_KRAKEN_RUN_PLAN;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--headless") continue;
+    if (arg === "--output") {
+      const next = argv[i + 1];
+      if (next === "json" || next === "plain") {
+        output = next;
+        i++;
+      } else {
+        return {
+          options: null,
+          error: `--output requires 'json' or 'plain', got '${next ?? "(missing)"}'`
+        };
+      }
+    } else if (arg === "--task") {
+      task = argv[i + 1];
+      i++;
+    } else if (arg === "--task-file") {
+      const next = argv[i + 1];
+      if (next) {
+        try {
+          const fromFile = readFileSync22(next, "utf-8");
+          if (fromFile.trim()) task = fromFile;
+        } catch {
+        }
+      }
+      i++;
+    } else if (arg === "--council") {
+      councilFlag = true;
+    } else if (arg === "--mode") {
+      const next = argv[i + 1];
+      const parsed = next ? parseMode(next) : null;
+      if (!parsed) {
+        return {
+          options: null,
+          error: `--mode requires 'kraken', 'council', or 'zelari' (agent=alias), got '${next ?? "(missing)"}'`
+        };
+      }
+      mode = parsed;
+      modeExplicit = true;
+      i++;
+    } else if (arg === "--phase") {
+      const next = argv[i + 1];
+      const parsed = next ? parsePhase(next) : null;
+      if (!parsed) {
+        return {
+          options: null,
+          error: `--phase requires 'plan' or 'build', got '${next ?? "(missing)"}'`
+        };
+      }
+      phase2 = parsed;
+      i++;
+    } else if (arg === "--provider") {
+      provider = argv[i + 1];
+      i++;
+    } else if (arg === "--model") {
+      model = argv[i + 1];
+      i++;
+    } else if (arg === "--history" || arg === "--history-file") {
+      const next = argv[i + 1];
+      if (next) {
+        let raw = null;
+        if (arg === "--history-file") {
+          try {
+            raw = readFileSync22(next, "utf-8");
+          } catch {
+            raw = null;
+          }
+        } else {
+          raw = next;
+        }
+        if (raw) {
+          try {
+            const parsedHist = JSON.parse(raw);
+            if (Array.isArray(parsedHist)) {
+              history2 = parsedHist.filter(
+                (m) => !!m && typeof m === "object" && typeof m.role === "string"
+              ).map((m) => {
+                const role = String(m.role);
+                const raw2 = m.content;
+                const content = typeof raw2 === "string" ? raw2 : raw2 == null ? "" : typeof raw2 === "object" ? JSON.stringify(raw2) : String(raw2);
+                const msg = {
+                  role,
+                  content
+                };
+                if (typeof m.toolCallId === "string") {
+                  msg.toolCallId = m.toolCallId;
+                }
+                return msg;
+              }).filter(
+                (m) => m.role === "user" || m.role === "assistant" || m.role === "tool" || m.role === "system"
+              );
+            }
+          } catch {
+          }
+        }
+        i++;
+      }
+    } else if (arg === "--todos") {
+      const next = argv[i + 1];
+      if (next) {
+        try {
+          const parsed = JSON.parse(next);
+          if (Array.isArray(parsed)) {
+            todos2 = parsed.filter(
+              (t) => !!t && typeof t === "object" && typeof t.content === "string"
+            ).map((t) => ({
+              id: typeof t.id === "string" ? t.id : void 0,
+              content: String(t.content).slice(0, 500),
+              status: t.status
+            }));
+          }
+        } catch {
+        }
+        i++;
+      }
+    } else if (arg === "--once") {
+      once = true;
+    } else if (arg === "--profile") {
+      const next = argv[i + 1];
+      if (!next || next.startsWith("--")) {
+        return { options: null, error: `--profile requires a profile id (e.g. kraken/v1), got '${next ?? "(missing)"}'` };
+      }
+      try {
+        resolveProfile(next);
+      } catch (err) {
+        return {
+          options: null,
+          error: err instanceof Error ? err.message : String(err)
+        };
+      }
+      profile = next;
+      i++;
+    } else if (arg === "--resume") {
+      const next = argv[i + 1];
+      if (!next || next.startsWith("--")) {
+        return { options: null, error: `--resume requires a session id, got '${next ?? "(missing)"}'` };
+      }
+      resumeSessionId = next;
+      i++;
+    } else if (arg === "--export-session") {
+      const next = argv[i + 1];
+      if (!next || next.startsWith("--")) {
+        return { options: null, error: `--export-session requires a path (or - for stdout), got '${next ?? "(missing)"}'` };
+      }
+      exportSessionPath = next;
+      i++;
+    } else if (arg === "--strict-done") {
+      strictDone = true;
+    } else if (arg === "--kraken-graph") {
+      krakenGraph = argv[i + 1];
+      i++;
+    } else if (arg === "--kraken-graph-file") {
+      const next = argv[i + 1];
+      if (next) {
+        try {
+          const fromFile = readFileSync22(next, "utf-8");
+          if (fromFile.trim()) krakenGraph = fromFile;
+        } catch {
+        }
+      }
+      i++;
+    } else if (arg === "--plan-only") {
+      planOnly = true;
+    } else if (arg === "--run-plan") {
+      runPlan = argv[i + 1];
+      i++;
+    }
+  }
+  if (councilFlag && !modeExplicit) {
+    mode = "council";
+  } else if (councilFlag && modeExplicit && mode !== "council") {
+    return {
+      options: null,
+      error: `--council conflicts with --mode ${mode}`
+    };
+  }
+  if (task && krakenGraph) {
+    return { options: null, error: "--task and --kraken-graph are mutually exclusive" };
+  }
+  if ((!task || task.trim().length === 0) && (!krakenGraph || krakenGraph.trim().length === 0)) {
+    return { options: null, error: "--headless requires --task <prompt> or --kraken-graph <goal>" };
+  }
+  return {
+    options: {
+      task: task ?? "",
+      output,
+      mode,
+      phase: phase2,
+      useCouncil: mode === "council",
+      provider,
+      model,
+      ...history2 && history2.length > 0 ? { history: history2 } : {},
+      ...todos2 && todos2.length > 0 ? { todos: todos2 } : {},
+      ...once ? { once: true } : {},
+      ...profile ? { profile } : {},
+      ...resumeSessionId ? { resumeSessionId } : {},
+      ...exportSessionPath ? { exportSessionPath } : {},
+      ...strictDone ? { strictDone: true } : {},
+      ...krakenGraph ? { krakenGraph } : {},
+      ...planOnly ? { planOnly: true } : {},
+      ...runPlan ? { runPlan } : {}
+    }
+  };
+}
+async function resolveHeadlessKey(providerId) {
+  const spec = PROVIDERS.find((p3) => p3.id === providerId);
+  if (!spec) {
+    return { error: `unknown provider: '${providerId}'` };
+  }
+  const resolved = await resolveApiKeyWithMeta(providerId);
+  if (!resolved || !resolved.apiKey) {
+    return {
+      error: `no API key for provider '${providerId}'.
+Set the env var ${spec.envVar} or save a key via /login.`
+    };
+  }
+  const { resolveBaseUrl: resolveBaseUrl2 } = await Promise.resolve().then(() => (init_openai_compatible(), openai_compatible_exports));
+  return {
+    apiKey: resolved.apiKey,
+    baseUrl: resolveBaseUrl2(providerId)
+  };
+}
+function resolveHeadlessProvider(opts) {
+  const provider = opts.provider ?? getActiveProvider().id;
+  const model = opts.model ?? getModelForProvider(provider);
+  return { provider, model };
+}
+function emitEvent(event) {
+  process.stdout.write(JSON.stringify(event) + "\n");
+}
+var init_headless = __esm({
+  "src/cli/headless.ts"() {
+    "use strict";
+    init_keyStore();
+    init_providerConfig();
+    init_openai_compatible();
+    init_phase();
+    init_mode();
+    init_runtime2();
+  }
+});
+
+// src/cli/headlessSpine.ts
+var headlessSpine_exports = {};
+__export(headlessSpine_exports, {
+  derivedModelSeed: () => derivedModelSeed,
+  exportSessionById: () => exportSessionById,
+  missionStateFromSpine: () => missionStateFromSpine,
+  openHeadlessSpine: () => openHeadlessSpine,
+  resolveHeadlessProfileId: () => resolveHeadlessProfileId,
+  seedHeadlessModelHistory: () => seedHeadlessModelHistory
+});
+function resolveHeadlessProfileId(mode, explicit) {
+  if (explicit) return resolveProfile(explicit).id;
+  return defaultProfileForMode(mode ?? "kraken");
+}
+async function openHeadlessSpine(opts) {
+  const profileId = resolveHeadlessProfileId(opts.mode, opts.profile);
+  let profileTools = [];
+  try {
+    profileTools = resolveProfile(profileId).tools;
+  } catch {
+    profileTools = [];
+  }
+  const extra = {
+    profile: profileId,
+    workspace: opts.workspace ?? process.cwd(),
+    toolManifestHash: profileTools.length > 0 ? toolManifestHash(profileTools) : void 0
+  };
+  const mirrorOpts = {
+    baseDir: opts.baseDir,
+    quiet: opts.quiet,
+    extraStarted: extra
+  };
+  const spine = await SessionSpineMirror.adopt(opts.sessionId, mirrorOpts);
+  if (spine.status === "active") {
+    spine.note("headless.profile", { profile: profileId, mode: opts.mode ?? "kraken" });
+  }
+  return {
+    sessionId: opts.sessionId,
+    profileId,
+    spine,
+    observe(ev) {
+      if (ev && typeof ev === "object" && "type" in ev) {
+        spine.mirrorBrainEvent(ev);
+      }
+    },
+    userMessage(text) {
+      spine.userMessage(text);
+    },
+    verificationRun(payload) {
+      spine.verificationRun(payload);
+    },
+    missionPhase(phase2, note) {
+      spine.missionPhase(phase2, note);
+    },
+    note(text, data) {
+      spine.note(text, data);
+    },
+    async close(reason = "host-exit") {
+      await spine.close(reason);
+    },
+    async interrupt(note) {
+      if (note) spine.note("headless.interrupt", { note });
+      await spine.release();
+    },
+    async exportJson() {
+      try {
+        const store6 = new SessionStore(resolveSessionsDir({ baseDir: opts.baseDir }));
+        if (!await store6.exists(opts.sessionId)) return null;
+        return await exportSessionJson(store6, opts.sessionId);
+      } catch {
+        return null;
+      }
+    }
+  };
+}
+async function exportSessionById(sessionId2, baseDir) {
+  try {
+    const store6 = SessionStore.withDefaults(baseDir ? { baseDir } : {});
+    if (!await store6.exists(sessionId2)) {
+      return { ok: false, error: `session not found: ${sessionId2}` };
+    }
+    return { ok: true, json: await exportSessionJson(store6, sessionId2) };
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  }
+}
+async function missionStateFromSpine(sessionId2, baseDir) {
+  try {
+    const store6 = SessionStore.withDefaults(baseDir ? { baseDir } : {});
+    if (!await store6.exists(sessionId2)) return null;
+    const projection = await store6.projection(sessionId2);
+    return deriveMissionState(projection);
+  } catch {
+    return null;
+  }
+}
+async function seedHeadlessModelHistory(handle, legacy) {
+  const mirror = handle.spine;
+  const legacySeed = filterLegacySeed(legacy);
+  if (mirror.status !== "active") {
+    return { history: legacySeed, importedCount: 0, source: "legacy-fallback" };
+  }
+  const existing = await mirror.derivedPriorTurns();
+  if (existing && existing.length > 0) {
+    return { history: derivedModelSeed(existing), importedCount: 0, source: "spine" };
+  }
+  if (legacySeed.length === 0) {
+    return { history: [], importedCount: 0, source: "spine" };
+  }
+  for (const m of legacySeed) {
+    if (m.role === "user") {
+      mirror.userMessage(m.content);
+    } else {
+      mirror.assistantMessage(m.content, { imported: "legacy-history" });
+    }
+  }
+  await mirror.flush();
+  const derived = await mirror.derivedPriorTurns() ?? [];
+  return {
+    history: derivedModelSeed(derived),
+    importedCount: legacySeed.length,
+    source: "spine-import"
+  };
+}
+function filterLegacySeed(legacy) {
+  return (legacy ?? []).filter((m) => m.role === "user" || m.role === "assistant").map(
+    (m) => m.role === "assistant" && m.content ? {
+      role: "assistant",
+      content: cleanAgentContent(m.content, {
+        stripQuestion: false,
+        stripThink: false
+      })
+    } : { role: m.role, content: m.content ?? "" }
+  ).filter((m) => (m.content ?? "").trim().length > 0);
+}
+function derivedModelSeed(derived) {
+  return derivedToAgentMessages(derived).map(
+    (m) => m.role === "system" ? { role: "user", content: m.content } : m
+  ).map(
+    (m) => m.role === "assistant" && m.content ? {
+      role: "assistant",
+      content: cleanAgentContent(m.content, {
+        stripQuestion: false,
+        stripThink: false
+      })
+    } : m
+  ).filter((m) => m.role === "user" || m.role === "assistant").filter((m) => (m.content ?? "").trim().length > 0);
+}
+var init_headlessSpine = __esm({
+  "src/cli/headlessSpine.ts"() {
+    "use strict";
+    init_dist();
+    init_session();
+    init_mission2();
+    init_runtime2();
+    init_sessionSpine();
+    init_headless();
+  }
+});
+
 // src/cli/state/fileStateStore.ts
 import { createHash as createHash10, randomUUID as randomUUID2 } from "node:crypto";
 import { promises as fs21 } from "node:fs";
@@ -40502,57 +41063,6 @@ var init_phaseState = __esm({
   }
 });
 
-// src/cli/phase.ts
-var phase_exports = {};
-__export(phase_exports, {
-  PHASES: () => PHASES,
-  PLAN_ALLOWED_WRITE_TOOLS: () => PLAN_ALLOWED_WRITE_TOOLS,
-  PLAN_BLOCKED_TOOLS: () => PLAN_BLOCKED_TOOLS,
-  describePhase: () => describePhase,
-  nextPhase: () => nextPhase,
-  parsePhase: () => parsePhase
-});
-function parsePhase(input) {
-  const v = input.trim().toLowerCase();
-  return PHASES.includes(v) ? v : null;
-}
-function nextPhase(current) {
-  return current === "plan" ? "build" : "plan";
-}
-function describePhase(phase2) {
-  switch (phase2) {
-    case "plan":
-      return "plan \u2014 explore & design only (no project writes; plan files allowed)";
-    default:
-      return "build \u2014 implement with full tools";
-  }
-}
-var PHASES, PLAN_ALLOWED_WRITE_TOOLS, PLAN_BLOCKED_TOOLS;
-var init_phase = __esm({
-  "src/cli/phase.ts"() {
-    "use strict";
-    PHASES = ["plan", "build"];
-    PLAN_ALLOWED_WRITE_TOOLS = /* @__PURE__ */ new Set([
-      // Workspace plan/docs — intentional plan-mode outputs
-      "createPlan",
-      "createTask",
-      "updateTask",
-      "createMilestone",
-      "createDocument",
-      "createDecision",
-      "linkDocuments"
-      // Soft writes that only touch .zelari / plan paths are still gated in
-      // toolRegistry by path when needed; write_file/edit_file stay DENIED.
-    ]);
-    PLAN_BLOCKED_TOOLS = /* @__PURE__ */ new Set([
-      "write_file",
-      "edit_file",
-      "apply_diff",
-      "bash"
-    ]);
-  }
-});
-
 // src/cli/provider/localCli/claudeStreamJson.ts
 function textBlock(text) {
   return { type: "text", text };
@@ -40816,14 +41326,14 @@ var init_claudeProvider = __esm({
 });
 
 // src/cli/workspace/projectInstructions.ts
-import { existsSync as existsSync26, readFileSync as readFileSync22 } from "node:fs";
+import { existsSync as existsSync26, readFileSync as readFileSync23 } from "node:fs";
 import { join as join20 } from "node:path";
 function loadProjectInstructions(projectRoot = process.cwd(), maxChars = MAX_CHARS) {
   for (const name of CANDIDATES) {
     const full = join20(projectRoot, name);
     if (!existsSync26(full)) continue;
     try {
-      let raw = readFileSync22(full, "utf8");
+      let raw = readFileSync23(full, "utf8");
       raw = raw.replace(/\r\n/g, "\n").trim();
       if (!raw) continue;
       if (raw.length <= maxChars) {
@@ -40867,7 +41377,7 @@ __export(workspaceSummary_exports, {
   buildWorkspaceSummary: () => buildWorkspaceSummary,
   buildZelariReadHint: () => buildZelariReadHint
 });
-import { existsSync as existsSync27, readFileSync as readFileSync23, readdirSync as readdirSync6, statSync as statSync5 } from "node:fs";
+import { existsSync as existsSync27, readFileSync as readFileSync24, readdirSync as readdirSync6, statSync as statSync5 } from "node:fs";
 import { join as join21, relative } from "node:path";
 function buildWorkspaceSummary(projectRoot = process.cwd(), options = {}) {
   const { maxEntries = 30, maxChars = 3500, maxDeps = 24, maxScripts = 16 } = options;
@@ -40905,7 +41415,7 @@ function buildPlanSummary(projectRoot = process.cwd(), options) {
   if (!existsSync27(planPath)) return null;
   let plan;
   try {
-    plan = JSON.parse(readFileSync23(planPath, "utf8"));
+    plan = JSON.parse(readFileSync24(planPath, "utf8"));
   } catch {
     return null;
   }
@@ -41063,7 +41573,7 @@ function readPackageJson(projectRoot) {
   const p3 = join21(projectRoot, "package.json");
   if (!existsSync27(p3)) return null;
   try {
-    return JSON.parse(readFileSync23(p3, "utf8"));
+    return JSON.parse(readFileSync24(p3, "utf8"));
   } catch {
     return null;
   }
@@ -41191,7 +41701,7 @@ var composeContext_exports = {};
 __export(composeContext_exports, {
   composeProjectContext: () => composeProjectContext
 });
-import { existsSync as existsSync29, readdirSync as readdirSync7, readFileSync as readFileSync24 } from "node:fs";
+import { existsSync as existsSync29, readdirSync as readdirSync7, readFileSync as readFileSync25 } from "node:fs";
 import { join as join23 } from "node:path";
 function cap2(text, max, label) {
   if (!text || text.length <= max) return { text: text || "", truncated: false };
@@ -41332,15 +41842,15 @@ function readDurableHeadSync(projectRoot) {
   try {
     const headPath = join23(projectRoot, ".zelari", "state", "HEAD.json");
     if (!existsSync29(headPath)) return "";
-    const head = JSON.parse(readFileSync24(headPath, "utf8"));
+    const head = JSON.parse(readFileSync25(headPath, "utf8"));
     if (!head?.id) return "";
     const metaPath = join23(projectRoot, ".zelari", "state", "commits", `${head.id}.json`);
     if (!existsSync29(metaPath)) return "";
-    const meta3 = JSON.parse(readFileSync24(metaPath, "utf8"));
+    const meta3 = JSON.parse(readFileSync25(metaPath, "utf8"));
     const discPath = meta3.artifactDir ? join23(projectRoot, ".zelari", "state", meta3.artifactDir, "discoveries.json") : join23(projectRoot, ".zelari", "state", "artifacts", head.id, "discoveries.json");
     let discoveries = [];
     if (existsSync29(discPath)) {
-      discoveries = JSON.parse(readFileSync24(discPath, "utf8"));
+      discoveries = JSON.parse(readFileSync25(discPath, "utf8"));
     }
     const reusable = discoveries.filter((d) => d.reusable !== false);
     const lines = [
@@ -41373,13 +41883,13 @@ var planDetect_exports = {};
 __export(planDetect_exports, {
   hasWorkspacePlan: () => hasWorkspacePlan
 });
-import { existsSync as existsSync30, readFileSync as readFileSync25 } from "node:fs";
+import { existsSync as existsSync30, readFileSync as readFileSync26 } from "node:fs";
 import { join as join24 } from "node:path";
 function hasWorkspacePlan(projectRoot = process.cwd()) {
   const planPath = join24(resolveWorkspaceRoot(projectRoot), "plan.json");
   if (!existsSync30(planPath)) return false;
   try {
-    const parsed = JSON.parse(readFileSync25(planPath, "utf8"));
+    const parsed = JSON.parse(readFileSync26(planPath, "utf8"));
     return Array.isArray(parsed.phases) && parsed.phases.length > 0;
   } catch {
     return false;
@@ -41441,7 +41951,7 @@ import {
   existsSync as existsSync31,
   readdirSync as readdirSync8,
   writeFileSync as writeFileSync17,
-  readFileSync as readFileSync26,
+  readFileSync as readFileSync27,
   mkdirSync as mkdirSync15,
   renameSync as renameSync4
 } from "node:fs";
@@ -41462,7 +41972,7 @@ function readPlan(ctx) {
   if (existsSync31(jsonPath)) {
     try {
       const parsed = JSON.parse(
-        readFileSync26(jsonPath, "utf8")
+        readFileSync27(jsonPath, "utf8")
       );
       const { phases, tasks, milestones, ...root } = parsed;
       return {
@@ -42026,7 +42536,7 @@ function searchDocumentsStub(ctx) {
       const results = [];
       for (const file2 of files) {
         if (!existsSync31(file2)) continue;
-        const raw = readFileSync26(file2, "utf8");
+        const raw = readFileSync27(file2, "utf8");
         const content = raw.toLowerCase();
         let idx = -1;
         let matchLen = 0;
@@ -42199,10 +42709,12 @@ __export(updater_exports, {
   REGISTRY_URL: () => REGISTRY_URL,
   checkForUpdate: () => checkForUpdate,
   compareSemver: () => compareSemver,
+  distTagForVersion: () => distTagForVersion,
   fetchLatestVersion: () => fetchLatestVersion,
   getCurrentVersion: () => getCurrentVersion,
   looksLikeBrokenShim: () => looksLikeBrokenShim,
   performUpdate: () => performUpdate,
+  registryUrlForTag: () => registryUrlForTag,
   resolveBundledNpmCli: () => resolveBundledNpmCli
 });
 import { createRequire as createRequire2 } from "node:module";
@@ -42256,6 +42768,15 @@ function compareSemver(a, b) {
   if (bPre === null) return -1;
   return aPre < bPre ? -1 : 1;
 }
+function distTagForVersion(version2) {
+  if (version2.includes("-alpha.")) return "alpha";
+  if (version2.includes("-beta.")) return "beta";
+  if (version2.includes("-next.")) return "next";
+  return "latest";
+}
+function registryUrlForTag(tag = distTagForVersion(getCurrentVersion())) {
+  return `https://registry.npmjs.org/zelari-code/${tag}`;
+}
 async function fetchLatestVersion(fetcher = fetch, registryUrl = REGISTRY_URL, timeoutMs = 5e3) {
   try {
     const controller = new AbortController();
@@ -42277,7 +42798,8 @@ async function fetchLatestVersion(fetcher = fetch, registryUrl = REGISTRY_URL, t
 }
 async function checkForUpdate(fetcher = fetch, registryUrl) {
   const currentVersion = getCurrentVersion();
-  const latest = await fetchLatestVersion(fetcher, registryUrl);
+  const url2 = registryUrl ?? registryUrlForTag();
+  const latest = await fetchLatestVersion(fetcher, url2);
   if ("error" in latest) {
     return {
       currentVersion,
@@ -42293,8 +42815,9 @@ async function checkForUpdate(fetcher = fetch, registryUrl) {
     updateAvailable: cmp < 0
   };
 }
-async function performUpdate(packageName = "zelari-code", executor = spawn12, resolveNpmCli = resolveBundledNpmCli) {
-  const args = ["install", "-g", `${packageName}@latest`];
+async function performUpdate(packageName = "zelari-code", executor = spawn12, resolveNpmCli = resolveBundledNpmCli, channel) {
+  const tag = channel ?? distTagForVersion(getCurrentVersion());
+  const args = ["install", "-g", `${packageName}@${tag}`];
   const primary = await runNpm(executor, args, "shim");
   if (primary.ok) return primary;
   const npmCli = resolveNpmCli();
@@ -42522,7 +43045,7 @@ var init_mcpClient = __esm({
 import {
   existsSync as existsSync33,
   mkdirSync as mkdirSync16,
-  readFileSync as readFileSync27,
+  readFileSync as readFileSync28,
   writeFileSync as writeFileSync18
 } from "node:fs";
 import { dirname as dirname7, join as join26 } from "node:path";
@@ -42536,7 +43059,7 @@ function getProjectMcpPath(projectRoot) {
 function readFile2(path63) {
   if (!existsSync33(path63)) return {};
   try {
-    const parsed = JSON.parse(readFileSync27(path63, "utf8"));
+    const parsed = JSON.parse(readFileSync28(path63, "utf8"));
     const out = {};
     for (const [name, cfg] of Object.entries(parsed.mcpServers ?? {})) {
       if (!cfg || typeof cfg.command !== "string" || !cfg.command.trim()) continue;
@@ -42764,7 +43287,7 @@ __export(mcpManager_exports, {
   readMcpConfig: () => readMcpConfig,
   registerMcpTools: () => registerMcpTools
 });
-import { existsSync as existsSync34, readFileSync as readFileSync28 } from "node:fs";
+import { existsSync as existsSync34, readFileSync as readFileSync29 } from "node:fs";
 import { join as join27 } from "node:path";
 import { homedir as homedir11 } from "node:os";
 function readMcpConfig(projectRoot = process.cwd(), opts) {
@@ -42779,7 +43302,7 @@ function readMcpConfig(projectRoot = process.cwd(), opts) {
   for (const p3 of paths) {
     if (!existsSync34(p3)) continue;
     try {
-      const parsed = JSON.parse(readFileSync28(p3, "utf8"));
+      const parsed = JSON.parse(readFileSync29(p3, "utf8"));
       for (const [name, cfg] of Object.entries(parsed.mcpServers ?? {})) {
         if (!cfg || typeof cfg.command !== "string" || cfg.command.length === 0) continue;
         merged[name] = cfg;
@@ -43018,7 +43541,7 @@ __export(agentsMd_exports, {
   serializeAgentsMd: () => serializeAgentsMd,
   updateAgentsMd: () => updateAgentsMd
 });
-import { existsSync as existsSync35, readFileSync as readFileSync29, writeFileSync as writeFileSync19 } from "node:fs";
+import { existsSync as existsSync35, readFileSync as readFileSync30, writeFileSync as writeFileSync19 } from "node:fs";
 import { createHash as createHash11 } from "node:crypto";
 import { join as join28 } from "node:path";
 import { readFile as readFile3 } from "node:fs/promises";
@@ -43076,7 +43599,7 @@ async function genConventions(ctx) {
   const lines = [];
   const claudeMd = join28(ctx.projectRoot, "CLAUDE.MD");
   if (existsSync35(claudeMd)) {
-    const content = readFileSync29(claudeMd, "utf8");
+    const content = readFileSync30(claudeMd, "utf8");
     const match = content.match(/## Architecture rules[\s\S]+?(?=\n## |\n*$)/);
     if (match) {
       lines.push('<!-- Extracted from CLAUDE.MD "Architecture rules" -->');
@@ -43110,7 +43633,7 @@ async function genBuild(ctx) {
 async function genOpenQuestions(ctx) {
   const path63 = join28(ctx.rootDir, "risks.md");
   if (!existsSync35(path63)) return "_No open questions._";
-  const content = readFileSync29(path63, "utf8");
+  const content = readFileSync30(path63, "utf8");
   const lines = content.split("\n");
   const questions = [];
   let currentTitle = "";
@@ -43186,7 +43709,7 @@ function titleCase(id) {
 async function updateAgentsMd(ctx, projectRoot) {
   const agentsPath = join28(projectRoot, "AGENTS.MD");
   if (existsSync35(agentsPath)) {
-    const content = readFileSync29(agentsPath, "utf8");
+    const content = readFileSync30(agentsPath, "utf8");
     const hasAnyMarker = AUTO_SECTIONS.some((id) => content.includes(MARKER_OPEN(id)));
     if (!hasAnyMarker) {
       return {
@@ -43202,7 +43725,7 @@ async function updateAgentsMd(ctx, projectRoot) {
   }
   let manualContent = "";
   if (existsSync35(agentsPath)) {
-    const { manualBlocks } = parseAgentsMd(readFileSync29(agentsPath, "utf8"));
+    const { manualBlocks } = parseAgentsMd(readFileSync30(agentsPath, "utf8"));
     manualContent = manualBlocks.after;
   } else {
     const projectName2 = projectName(projectRoot);
@@ -43218,7 +43741,7 @@ async function updateAgentsMd(ctx, projectRoot) {
       ""
     ].join("\n");
   }
-  const oldContent = existsSync35(agentsPath) ? readFileSync29(agentsPath, "utf8") : "";
+  const oldContent = existsSync35(agentsPath) ? readFileSync30(agentsPath, "utf8") : "";
   const { sections: oldSections } = parseAgentsMd(oldContent);
   const changedSections = [];
   for (const id of AUTO_SECTIONS) {
@@ -43355,7 +43878,7 @@ var init_completeDesign = __esm({
 });
 
 // src/cli/workspace/planDriftCheck.ts
-import { existsSync as existsSync36, readFileSync as readFileSync30, readdirSync as readdirSync9, statSync as statSync6, writeFileSync as writeFileSync20 } from "node:fs";
+import { existsSync as existsSync36, readFileSync as readFileSync31, readdirSync as readdirSync9, statSync as statSync6, writeFileSync as writeFileSync20 } from "node:fs";
 import { join as join29 } from "node:path";
 function findCanonicalDoc(rootDir) {
   const docsDir = join29(rootDir, "docs");
@@ -43386,7 +43909,7 @@ function firstString2(v) {
 }
 function readFileSyncSafe(path63) {
   try {
-    return readFileSync30(path63, "utf8");
+    return readFileSync31(path63, "utf8");
   } catch {
     return null;
   }
@@ -43401,7 +43924,7 @@ async function runPlanDriftCheck(rootDir) {
   }
   let plan;
   try {
-    plan = JSON.parse(readFileSync30(planPath, "utf8"));
+    plan = JSON.parse(readFileSync31(planPath, "utf8"));
   } catch {
     return { ran: false, reason: ".zelari/plan.json corrupt" };
   }
@@ -43527,7 +44050,7 @@ var init_planDriftCheck = __esm({
 
 // src/cli/workspace/projectSmoke.ts
 import { spawn as spawn14 } from "node:child_process";
-import { existsSync as existsSync37, readFileSync as readFileSync31 } from "node:fs";
+import { existsSync as existsSync37, readFileSync as readFileSync32 } from "node:fs";
 import { join as join30 } from "node:path";
 function pickSmokeScript(scripts) {
   if (!scripts) return null;
@@ -43546,7 +44069,7 @@ async function runProjectSmoke(projectRoot, timeoutMs = DEFAULT_TIMEOUT_MS3) {
   }
   let scripts = {};
   try {
-    const pkg = JSON.parse(readFileSync31(pkgPath, "utf8"));
+    const pkg = JSON.parse(readFileSync32(pkgPath, "utf8"));
     scripts = pkg.scripts ?? {};
   } catch {
     return { ran: false, reason: "package.json unreadable (skipped)" };
@@ -43634,7 +44157,7 @@ __export(postCouncilHook_exports, {
   runPostCouncilHook: () => runPostCouncilHook
 });
 import { spawn as spawn15 } from "node:child_process";
-import { existsSync as existsSync38, readFileSync as readFileSync32 } from "node:fs";
+import { existsSync as existsSync38, readFileSync as readFileSync33 } from "node:fs";
 import { join as join31 } from "node:path";
 async function runCompleteDesignPostProcessor(ctx, options) {
   if (options?.runMode === "implementation") {
@@ -43656,7 +44179,7 @@ async function runCompleteDesignPostProcessor(ctx, options) {
   }
   let phaseCount = 0;
   try {
-    const parsed = JSON.parse(readFileSync32(planJsonPath2, "utf8"));
+    const parsed = JSON.parse(readFileSync33(planJsonPath2, "utf8"));
     phaseCount = Array.isArray(parsed.phases) ? parsed.phases.length : 0;
   } catch {
     return { ran: false, reason: ".zelari/plan.json corrupt" };
@@ -43891,7 +44414,7 @@ __export(councilFeedback_exports, {
 import {
   promises as fs22,
   existsSync as existsSync39,
-  readFileSync as readFileSync33,
+  readFileSync as readFileSync34,
   writeFileSync as writeFileSync21,
   mkdirSync as mkdirSync17
 } from "node:fs";
@@ -44001,7 +44524,7 @@ var init_councilFeedback = __esm({
       load() {
         if (!existsSync39(this.file)) return;
         try {
-          const raw = readFileSync33(this.file, "utf-8");
+          const raw = readFileSync34(this.file, "utf-8");
           const parsed = JSON.parse(raw);
           if (parsed && Array.isArray(parsed.entries)) {
             this.entries = parsed.entries.filter(
@@ -45375,38 +45898,6 @@ var init_brokerHandlers = __esm({
   }
 });
 
-// src/cli/mode.ts
-function nextMode(current) {
-  const i = MODES.indexOf(current);
-  return MODES[(i + 1) % MODES.length] ?? "kraken";
-}
-function parseMode(input) {
-  const v = input.trim().toLowerCase();
-  if (MODES.includes(v)) return v;
-  return MODE_ALIASES[v] ?? null;
-}
-function describeMode(mode) {
-  switch (mode) {
-    case "council":
-      return "council \u2014 multi-member plan/design (Caronte\u2026Lucifero; build needs ZELARI_COUNCIL_CAN_BUILD=1)";
-    case "zelari":
-      return "zelari \u2014 mission: plan@council \u2192 build@kraken (legacy: ZELARI_BUILD_VIA_AGENT=0)";
-    default:
-      return "kraken \u2014 super-agent lead (spawns explore/general/verify tentacles; default implementer)";
-  }
-}
-var MODES, MODE_ALIASES;
-var init_mode = __esm({
-  "src/cli/mode.ts"() {
-    "use strict";
-    MODES = ["kraken", "council", "zelari"];
-    MODE_ALIASES = {
-      agent: "kraken",
-      single: "kraken"
-    };
-  }
-});
-
 // src/cli/kraken/planner.ts
 var planner_exports = {};
 __export(planner_exports, {
@@ -47878,7 +48369,7 @@ var init_prereqChecks = __esm({
 });
 
 // src/cli/plugins/prefs.ts
-import { existsSync as existsSync42, readFileSync as readFileSync34, writeFileSync as writeFileSync22, mkdirSync as mkdirSync18 } from "node:fs";
+import { existsSync as existsSync42, readFileSync as readFileSync35, writeFileSync as writeFileSync22, mkdirSync as mkdirSync18 } from "node:fs";
 import path53 from "node:path";
 import os11 from "node:os";
 function getPluginPrefsPath() {
@@ -47888,7 +48379,7 @@ function getPluginPrefs() {
   const file2 = getPluginPrefsPath();
   try {
     if (!existsSync42(file2)) return { ...DEFAULTS2, dontAskAgain: {} };
-    const raw = readFileSync34(file2, "utf-8");
+    const raw = readFileSync35(file2, "utf-8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed === "object" && parsed.dontAskAgain && typeof parsed.dontAskAgain === "object") {
       const clean = {};
@@ -48690,7 +49181,7 @@ __export(atMentions_exports, {
   extractAtMentions: () => extractAtMentions,
   hasAtMentions: () => hasAtMentions
 });
-import { existsSync as existsSync46, readFileSync as readFileSync36, statSync as statSync9 } from "node:fs";
+import { existsSync as existsSync46, readFileSync as readFileSync37, statSync as statSync9 } from "node:fs";
 import { basename as basename3, isAbsolute as isAbsolute2, relative as relative3, resolve, sep } from "node:path";
 function isImagePath(abs) {
   const ext = abs.split(".").pop()?.toLowerCase() ?? "";
@@ -48796,7 +49287,7 @@ function resolveMention(token, cwd) {
         note: `image too large (${Math.round(st.size / 1024)} KB) \u2014 path only`
       };
     }
-    const dataBase64 = readFileSync36(abs).toString("base64");
+    const dataBase64 = readFileSync37(abs).toString("base64");
     return {
       raw: token,
       path: rel2,
@@ -48807,7 +49298,7 @@ function resolveMention(token, cwd) {
     };
   }
   try {
-    const buf = readFileSync36(abs);
+    const buf = readFileSync37(abs);
     const head = buf.subarray(0, 800).toString("utf8");
     if (!isProbablyText(abs, head)) {
       return {
@@ -48897,388 +49388,6 @@ var init_atMentions = __esm({
   }
 });
 
-// src/cli/headless.ts
-import { readFileSync as readFileSync37 } from "node:fs";
-function defaultProfileForMode(mode) {
-  switch (mode) {
-    case "council":
-      return "council/v1";
-    case "zelari":
-      return "mission/v1";
-    default:
-      return "kraken/v1";
-  }
-}
-function parseHeadlessFlags(argv) {
-  if (!argv.includes("--headless")) {
-    return { options: null };
-  }
-  let task;
-  let output = "json";
-  let mode = "kraken";
-  let phase2 = "build";
-  let modeExplicit = false;
-  let councilFlag = false;
-  let provider;
-  let model;
-  let history2;
-  let todos2;
-  let once = false;
-  let profile;
-  let resumeSessionId;
-  let exportSessionPath;
-  let strictDone = false;
-  let krakenGraph;
-  let planOnly = process.env.ZELARI_KRAKEN_PLAN_ONLY === "1" || process.env.ZELARI_KRAKEN_PLAN_ONLY === "true";
-  let runPlan = process.env.ZELARI_KRAKEN_RUN_PLAN;
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === "--headless") continue;
-    if (arg === "--output") {
-      const next = argv[i + 1];
-      if (next === "json" || next === "plain") {
-        output = next;
-        i++;
-      } else {
-        return {
-          options: null,
-          error: `--output requires 'json' or 'plain', got '${next ?? "(missing)"}'`
-        };
-      }
-    } else if (arg === "--task") {
-      task = argv[i + 1];
-      i++;
-    } else if (arg === "--task-file") {
-      const next = argv[i + 1];
-      if (next) {
-        try {
-          const fromFile = readFileSync37(next, "utf-8");
-          if (fromFile.trim()) task = fromFile;
-        } catch {
-        }
-      }
-      i++;
-    } else if (arg === "--council") {
-      councilFlag = true;
-    } else if (arg === "--mode") {
-      const next = argv[i + 1];
-      const parsed = next ? parseMode(next) : null;
-      if (!parsed) {
-        return {
-          options: null,
-          error: `--mode requires 'kraken', 'council', or 'zelari' (agent=alias), got '${next ?? "(missing)"}'`
-        };
-      }
-      mode = parsed;
-      modeExplicit = true;
-      i++;
-    } else if (arg === "--phase") {
-      const next = argv[i + 1];
-      const parsed = next ? parsePhase(next) : null;
-      if (!parsed) {
-        return {
-          options: null,
-          error: `--phase requires 'plan' or 'build', got '${next ?? "(missing)"}'`
-        };
-      }
-      phase2 = parsed;
-      i++;
-    } else if (arg === "--provider") {
-      provider = argv[i + 1];
-      i++;
-    } else if (arg === "--model") {
-      model = argv[i + 1];
-      i++;
-    } else if (arg === "--history" || arg === "--history-file") {
-      const next = argv[i + 1];
-      if (next) {
-        let raw = null;
-        if (arg === "--history-file") {
-          try {
-            raw = readFileSync37(next, "utf-8");
-          } catch {
-            raw = null;
-          }
-        } else {
-          raw = next;
-        }
-        if (raw) {
-          try {
-            const parsedHist = JSON.parse(raw);
-            if (Array.isArray(parsedHist)) {
-              history2 = parsedHist.filter(
-                (m) => !!m && typeof m === "object" && typeof m.role === "string"
-              ).map((m) => {
-                const role = String(m.role);
-                const raw2 = m.content;
-                const content = typeof raw2 === "string" ? raw2 : raw2 == null ? "" : typeof raw2 === "object" ? JSON.stringify(raw2) : String(raw2);
-                const msg = {
-                  role,
-                  content
-                };
-                if (typeof m.toolCallId === "string") {
-                  msg.toolCallId = m.toolCallId;
-                }
-                return msg;
-              }).filter(
-                (m) => m.role === "user" || m.role === "assistant" || m.role === "tool" || m.role === "system"
-              );
-            }
-          } catch {
-          }
-        }
-        i++;
-      }
-    } else if (arg === "--todos") {
-      const next = argv[i + 1];
-      if (next) {
-        try {
-          const parsed = JSON.parse(next);
-          if (Array.isArray(parsed)) {
-            todos2 = parsed.filter(
-              (t) => !!t && typeof t === "object" && typeof t.content === "string"
-            ).map((t) => ({
-              id: typeof t.id === "string" ? t.id : void 0,
-              content: String(t.content).slice(0, 500),
-              status: t.status
-            }));
-          }
-        } catch {
-        }
-        i++;
-      }
-    } else if (arg === "--once") {
-      once = true;
-    } else if (arg === "--profile") {
-      const next = argv[i + 1];
-      if (!next || next.startsWith("--")) {
-        return { options: null, error: `--profile requires a profile id (e.g. kraken/v1), got '${next ?? "(missing)"}'` };
-      }
-      try {
-        resolveProfile(next);
-      } catch (err) {
-        return {
-          options: null,
-          error: err instanceof Error ? err.message : String(err)
-        };
-      }
-      profile = next;
-      i++;
-    } else if (arg === "--resume") {
-      const next = argv[i + 1];
-      if (!next || next.startsWith("--")) {
-        return { options: null, error: `--resume requires a session id, got '${next ?? "(missing)"}'` };
-      }
-      resumeSessionId = next;
-      i++;
-    } else if (arg === "--export-session") {
-      const next = argv[i + 1];
-      if (!next || next.startsWith("--")) {
-        return { options: null, error: `--export-session requires a path (or - for stdout), got '${next ?? "(missing)"}'` };
-      }
-      exportSessionPath = next;
-      i++;
-    } else if (arg === "--strict-done") {
-      strictDone = true;
-    } else if (arg === "--kraken-graph") {
-      krakenGraph = argv[i + 1];
-      i++;
-    } else if (arg === "--kraken-graph-file") {
-      const next = argv[i + 1];
-      if (next) {
-        try {
-          const fromFile = readFileSync37(next, "utf-8");
-          if (fromFile.trim()) krakenGraph = fromFile;
-        } catch {
-        }
-      }
-      i++;
-    } else if (arg === "--plan-only") {
-      planOnly = true;
-    } else if (arg === "--run-plan") {
-      runPlan = argv[i + 1];
-      i++;
-    }
-  }
-  if (councilFlag && !modeExplicit) {
-    mode = "council";
-  } else if (councilFlag && modeExplicit && mode !== "council") {
-    return {
-      options: null,
-      error: `--council conflicts with --mode ${mode}`
-    };
-  }
-  if (task && krakenGraph) {
-    return { options: null, error: "--task and --kraken-graph are mutually exclusive" };
-  }
-  if ((!task || task.trim().length === 0) && (!krakenGraph || krakenGraph.trim().length === 0)) {
-    return { options: null, error: "--headless requires --task <prompt> or --kraken-graph <goal>" };
-  }
-  return {
-    options: {
-      task: task ?? "",
-      output,
-      mode,
-      phase: phase2,
-      useCouncil: mode === "council",
-      provider,
-      model,
-      ...history2 && history2.length > 0 ? { history: history2 } : {},
-      ...todos2 && todos2.length > 0 ? { todos: todos2 } : {},
-      ...once ? { once: true } : {},
-      ...profile ? { profile } : {},
-      ...resumeSessionId ? { resumeSessionId } : {},
-      ...exportSessionPath ? { exportSessionPath } : {},
-      ...strictDone ? { strictDone: true } : {},
-      ...krakenGraph ? { krakenGraph } : {},
-      ...planOnly ? { planOnly: true } : {},
-      ...runPlan ? { runPlan } : {}
-    }
-  };
-}
-async function resolveHeadlessKey(providerId) {
-  const spec = PROVIDERS.find((p3) => p3.id === providerId);
-  if (!spec) {
-    return { error: `unknown provider: '${providerId}'` };
-  }
-  const resolved = await resolveApiKeyWithMeta(providerId);
-  if (!resolved || !resolved.apiKey) {
-    return {
-      error: `no API key for provider '${providerId}'.
-Set the env var ${spec.envVar} or save a key via /login.`
-    };
-  }
-  const { resolveBaseUrl: resolveBaseUrl2 } = await Promise.resolve().then(() => (init_openai_compatible(), openai_compatible_exports));
-  return {
-    apiKey: resolved.apiKey,
-    baseUrl: resolveBaseUrl2(providerId)
-  };
-}
-function resolveHeadlessProvider(opts) {
-  const provider = opts.provider ?? getActiveProvider().id;
-  const model = opts.model ?? getModelForProvider(provider);
-  return { provider, model };
-}
-function emitEvent(event) {
-  process.stdout.write(JSON.stringify(event) + "\n");
-}
-var init_headless = __esm({
-  "src/cli/headless.ts"() {
-    "use strict";
-    init_keyStore();
-    init_providerConfig();
-    init_openai_compatible();
-    init_phase();
-    init_mode();
-    init_runtime2();
-  }
-});
-
-// src/cli/headlessSpine.ts
-var headlessSpine_exports = {};
-__export(headlessSpine_exports, {
-  exportSessionById: () => exportSessionById,
-  missionStateFromSpine: () => missionStateFromSpine,
-  openHeadlessSpine: () => openHeadlessSpine,
-  resolveHeadlessProfileId: () => resolveHeadlessProfileId
-});
-function resolveHeadlessProfileId(mode, explicit) {
-  if (explicit) return resolveProfile(explicit).id;
-  return defaultProfileForMode(mode ?? "kraken");
-}
-async function openHeadlessSpine(opts) {
-  const profileId = resolveHeadlessProfileId(opts.mode, opts.profile);
-  let profileTools = [];
-  try {
-    profileTools = resolveProfile(profileId).tools;
-  } catch {
-    profileTools = [];
-  }
-  const extra = {
-    profile: profileId,
-    workspace: opts.workspace ?? process.cwd(),
-    toolManifestHash: profileTools.length > 0 ? toolManifestHash(profileTools) : void 0
-  };
-  const mirrorOpts = {
-    baseDir: opts.baseDir,
-    quiet: opts.quiet,
-    extraStarted: extra
-  };
-  const spine = await SessionSpineMirror.adopt(opts.sessionId, mirrorOpts);
-  if (spine.status === "active") {
-    spine.note("headless.profile", { profile: profileId, mode: opts.mode ?? "kraken" });
-  }
-  return {
-    sessionId: opts.sessionId,
-    profileId,
-    spine,
-    observe(ev) {
-      if (ev && typeof ev === "object" && "type" in ev) {
-        spine.mirrorBrainEvent(ev);
-      }
-    },
-    userMessage(text) {
-      spine.userMessage(text);
-    },
-    verificationRun(payload) {
-      spine.verificationRun(payload);
-    },
-    missionPhase(phase2, note) {
-      spine.missionPhase(phase2, note);
-    },
-    note(text, data) {
-      spine.note(text, data);
-    },
-    async close(reason = "host-exit") {
-      await spine.close(reason);
-    },
-    async interrupt(note) {
-      if (note) spine.note("headless.interrupt", { note });
-      await spine.release();
-    },
-    async exportJson() {
-      try {
-        const store6 = new SessionStore(resolveSessionsDir({ baseDir: opts.baseDir }));
-        if (!await store6.exists(opts.sessionId)) return null;
-        return await exportSessionJson(store6, opts.sessionId);
-      } catch {
-        return null;
-      }
-    }
-  };
-}
-async function exportSessionById(sessionId2, baseDir) {
-  try {
-    const store6 = SessionStore.withDefaults(baseDir ? { baseDir } : {});
-    if (!await store6.exists(sessionId2)) {
-      return { ok: false, error: `session not found: ${sessionId2}` };
-    }
-    return { ok: true, json: await exportSessionJson(store6, sessionId2) };
-  } catch (err) {
-    return { ok: false, error: err instanceof Error ? err.message : String(err) };
-  }
-}
-async function missionStateFromSpine(sessionId2, baseDir) {
-  try {
-    const store6 = SessionStore.withDefaults(baseDir ? { baseDir } : {});
-    if (!await store6.exists(sessionId2)) return null;
-    const projection = await store6.projection(sessionId2);
-    return deriveMissionState(projection);
-  } catch {
-    return null;
-  }
-}
-var init_headlessSpine = __esm({
-  "src/cli/headlessSpine.ts"() {
-    "use strict";
-    init_session();
-    init_mission2();
-    init_runtime2();
-    init_sessionSpine();
-    init_headless();
-  }
-});
-
 // src/cli/triggerLock.ts
 var triggerLock_exports = {};
 __export(triggerLock_exports, {
@@ -55015,6 +55124,9 @@ function strictGateEventPayload(evaluation) {
   };
 }
 
+// src/cli/hooks/useChatTurn.ts
+init_headlessSpine();
+
 // src/cli/hooks/permissionPicker.ts
 init_toolPermissions();
 
@@ -55378,6 +55490,18 @@ function useChatTurn(params) {
       try {
         const anchored = maybeAnchorShortAnswer(userText);
         const effectiveUserText = anchored ?? userText;
+        let historyForModel;
+        {
+          const mirror = writerRef.current?.spine ?? null;
+          let spineSeed = null;
+          if (mirror && mirror.status === "active") {
+            const derived = await mirror.derivedPriorTurns();
+            if (derived && derived.length > 0) {
+              spineSeed = derivedModelSeed(derived);
+            }
+          }
+          historyForModel = spineSeed ?? getHistory();
+        }
         writerRef.current?.spine?.userMessage(effectiveUserText);
         const localCli = (process.env.ZELARI_LOCAL_CLI ?? "").trim();
         let localCliProvider = null;
@@ -55533,7 +55657,7 @@ _(${req.context})_` : "") + "\n\u2192 scegli dalla lista (il turno continua dopo
           });
           void writerRef.current?.append(compactionEvent);
         }
-        historySeedLen = getHistory().length;
+        historySeedLen = historyForModel.length;
         let composedWorkspace = "";
         let composedInstructions = "";
         let hasPlan = false;
@@ -55716,7 +55840,7 @@ _(${req.context})_` : "") + "\n\u2192 scegli dalla lista (il turno continua dopo
             // v1.8.0: shared rolling history (agent/council/zelari) so short
             // answers bind to prior ---QUESTION--- blocks. Possibly empty
             // when ZELARI_HISTORY_TURNS=0.
-            ...getHistory(),
+            ...historyForModel,
             { role: "user", content: effectiveUserText }
           ],
           tools: toolRegistry.toOpenAITools().map((t) => ({
@@ -58838,12 +58962,13 @@ async function handleUpdateCheck(ctx) {
   }
 }
 async function handleUpdatePerform(ctx) {
-  appendSystem(
-    ctx.setMessages,
-    "[update] running `npm install -g zelari-code@latest`..."
-  );
   try {
-    const { performUpdate: performUpdate2 } = await Promise.resolve().then(() => (init_updater(), updater_exports));
+    const { performUpdate: performUpdate2, distTagForVersion: distTagForVersion2, getCurrentVersion: getCurrentVersion2 } = await Promise.resolve().then(() => (init_updater(), updater_exports));
+    const tag = distTagForVersion2(getCurrentVersion2());
+    appendSystem(
+      ctx.setMessages,
+      `[update] running \`npm install -g zelari-code@${tag}\`...`
+    );
     const res = await performUpdate2();
     if (res.ok) {
       let prereqBlock = "";
@@ -59089,7 +59214,7 @@ async function handlePromoteMember(ctx, memberId) {
 }
 
 // src/cli/branchManager.ts
-import { promises as fs32, existsSync as existsSync44, readFileSync as readFileSync35, writeFileSync as writeFileSync23, mkdirSync as mkdirSync19, statSync as statSync7, rmSync as rmSync3 } from "node:fs";
+import { promises as fs32, existsSync as existsSync44, readFileSync as readFileSync36, writeFileSync as writeFileSync23, mkdirSync as mkdirSync19, statSync as statSync7, rmSync as rmSync3 } from "node:fs";
 import path56 from "node:path";
 import os13 from "node:os";
 var META_FILENAME = "meta.json";
@@ -59115,7 +59240,7 @@ function readBranchMeta(name, baseDir) {
     throw new BranchNotFoundError(`Branch "${name}" not found`);
   }
   try {
-    const raw = readFileSync35(metaPath, "utf-8");
+    const raw = readFileSync36(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`);
@@ -61424,6 +61549,7 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
     profile: opts.profile,
     workspace: process.cwd()
   });
+  const seededHistory = await seedHeadlessModelHistory(spine, opts.history);
   if (opts.task) spine.userMessage(opts.task);
   resetKrakenCandidates();
   resetKrakenTurnMetrics();
@@ -61573,15 +61699,7 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
       }
     ];
   }
-  const historySeed = (opts.history ?? []).filter((m) => m.role === "user" || m.role === "assistant").map(
-    (m) => m.role === "assistant" && m.content ? {
-      role: "assistant",
-      content: cleanAgentContent(m.content, {
-        stripQuestion: false,
-        stripThink: false
-      })
-    } : { role: m.role, content: m.content ?? "" }
-  ).filter((m) => (m.content ?? "").trim().length > 0);
+  const historySeed = seededHistory.history;
   const effectiveTask = buildAgentUserWithHistory(opts.task, historySeed);
   const maxToolLoop = (() => {
     const n = envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, {
@@ -61888,6 +62006,7 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
     profile: opts.profile,
     workspace: process.cwd()
   });
+  const seededHistory = await seedHeadlessModelHistory(spine, opts.history);
   if (opts.task) spine.userMessage(opts.task);
   const { shouldAllowCouncilBuild: shouldAllowCouncilBuild2 } = await Promise.resolve().then(() => (init_buildPolicy(), buildPolicy_exports));
   let councilRunMode = planModeFromOpts(opts) ? "design-phase" : "implementation";
@@ -61905,15 +62024,7 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
   );
   const { FeedbackStore: FeedbackStore2 } = await Promise.resolve().then(() => (init_councilFeedback(), councilFeedback_exports));
   const feedbackStore = new FeedbackStore2();
-  const historySeed = (opts.history ?? []).map(
-    (m) => m.role === "assistant" && m.content ? {
-      ...m,
-      content: cleanAgentContent(m.content, {
-        stripQuestion: false,
-        stripThink: false
-      })
-    } : m
-  );
+  const historySeed = seededHistory.history;
   const effectiveTask = buildCouncilTaskWithHistory(opts.task, historySeed);
   let exitCode = 0;
   const scrub = createStreamScrubber2();
@@ -62032,6 +62143,7 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
     profile: opts.profile ?? "mission/v1",
     workspace: projectRoot
   });
+  const seededHistory = await seedHeadlessModelHistory(spine, opts.history);
   if (opts.task) spine.userMessage(opts.task);
   spine.missionPhase("design", "mission-start");
   const { buildMissionBrief: buildMissionBrief2 } = await Promise.resolve().then(() => (init_council(), council_exports));
@@ -62064,15 +62176,7 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
       process.stderr.write(message + "\n");
     }
   };
-  const historySeed = (opts.history ?? []).map(
-    (m) => m.role === "assistant" && m.content ? {
-      ...m,
-      content: cleanAgentContent(m.content, {
-        stripQuestion: false,
-        stripThink: false
-      })
-    } : m
-  );
+  const historySeed = seededHistory.history;
   const missionTask = buildCouncilTaskWithHistory(opts.task, historySeed);
   emit(`[zelari] mission brief
 ${JSON.stringify({ deliverable: brief.deliverableThisMission, mvp: brief.sliceMvp?.title }, null, 0)}`);