zelari-code 1.18.1 → 1.19.0

package/dist/cli/main.bundled.js

@@ -24290,6 +24290,53 @@ var init_fileStateStore = __esm({
   }
 });
 
+// packages/core/dist/shared/eventBus.js
+var init_eventBus = __esm({
+  "packages/core/dist/shared/eventBus.js"() {
+    "use strict";
+  }
+});
+
+// packages/core/dist/events/index.js
+var init_events2 = __esm({
+  "packages/core/dist/events/index.js"() {
+    "use strict";
+    init_events();
+    init_eventBus();
+  }
+});
+
+// packages/core/dist/types/context.js
+var init_context = __esm({
+  "packages/core/dist/types/context.js"() {
+    "use strict";
+  }
+});
+
+// packages/core/dist/types/systemTypes.js
+var init_systemTypes = __esm({
+  "packages/core/dist/types/systemTypes.js"() {
+    "use strict";
+  }
+});
+
+// packages/core/dist/types/knowledge.js
+var init_knowledge = __esm({
+  "packages/core/dist/types/knowledge.js"() {
+    "use strict";
+  }
+});
+
+// packages/core/dist/types/index.js
+var init_types = __esm({
+  "packages/core/dist/types/index.js"() {
+    "use strict";
+    init_context();
+    init_systemTypes();
+    init_knowledge();
+  }
+});
+
 // packages/core/dist/agents/roles.js
 function resolveRoleSystemPrompt(agent, runMode = "implementation") {
   const parts = [agent.systemPrompt];
@@ -27144,7 +27191,7 @@ var init_missionBrief = __esm({
 });
 
 // packages/core/dist/council/verification/types.js
-var init_types = __esm({
+var init_types2 = __esm({
   "packages/core/dist/council/verification/types.js"() {
     "use strict";
   }
@@ -27348,7 +27395,7 @@ var init_autofix = __esm({
 var init_verification = __esm({
   "packages/core/dist/council/verification/index.js"() {
     "use strict";
-    init_types();
+    init_types2();
     init_runChecks();
     init_honesty();
     init_parseCssMotion();
@@ -27366,7 +27413,7 @@ var init_verification = __esm({
 });
 
 // packages/core/dist/council/lessons/types.js
-var init_types2 = __esm({
+var init_types3 = __esm({
   "packages/core/dist/council/lessons/types.js"() {
     "use strict";
   }
@@ -27619,7 +27666,7 @@ var init_recallLessons = __esm({
 var init_lessons = __esm({
   "packages/core/dist/council/lessons/index.js"() {
     "use strict";
-    init_types2();
+    init_types3();
     init_io();
     init_isAnswerLeak();
     init_signatures();
@@ -27629,7 +27676,7 @@ var init_lessons = __esm({
 });
 
 // packages/core/dist/council/completion/types.js
-var init_types3 = __esm({
+var init_types4 = __esm({
   "packages/core/dist/council/completion/types.js"() {
     "use strict";
   }
@@ -27710,7 +27757,7 @@ var init_buildCompletion = __esm({
 var init_completion2 = __esm({
   "packages/core/dist/council/completion/index.js"() {
     "use strict";
-    init_types3();
+    init_types4();
     init_buildCompletion();
   }
 });
@@ -28025,6 +28072,34 @@ var init_council = __esm({
   }
 });
 
+// packages/core/dist/memory/types.js
+var init_types5 = __esm({
+  "packages/core/dist/memory/types.js"() {
+    "use strict";
+  }
+});
+
+// packages/core/dist/state/index.js
+var init_state = __esm({
+  "packages/core/dist/state/index.js"() {
+    "use strict";
+  }
+});
+
+// packages/core/dist/index.js
+var init_dist = __esm({
+  "packages/core/dist/index.js"() {
+    "use strict";
+    init_events2();
+    init_types();
+    init_harness();
+    init_council();
+    init_skills2();
+    init_types5();
+    init_state();
+  }
+});
+
 // src/cli/utils/envNumber.ts
 function envNumber(raw, opts) {
   const { default: def, min, max } = opts;
@@ -31751,6 +31826,45 @@ var init_councilFeedback = __esm({
   }
 });
 
+// src/cli/buildPolicy.ts
+var buildPolicy_exports = {};
+__export(buildPolicy_exports, {
+  describeBuildPolicy: () => describeBuildPolicy,
+  resolveAgentMissionToolBudget: () => resolveAgentMissionToolBudget,
+  shouldAllowCouncilBuild: () => shouldAllowCouncilBuild,
+  shouldBuildViaAgent: () => shouldBuildViaAgent
+});
+function shouldBuildViaAgent(env = process.env) {
+  if (shouldAllowCouncilBuild(env)) return false;
+  if (env.ZELARI_BUILD_VIA_AGENT === "0") return false;
+  return true;
+}
+function shouldAllowCouncilBuild(env = process.env) {
+  return env.ZELARI_COUNCIL_CAN_BUILD === "1";
+}
+function resolveAgentMissionToolBudget(env = process.env) {
+  const raw = env.ZELARI_MODE_MAX_TOOLS_AGENT;
+  if (raw === void 0 || raw === "") return DEFAULT_AGENT_TOOL_BUDGET;
+  const n = Number.parseInt(raw, 10);
+  return Number.isFinite(n) && n > 0 ? n : DEFAULT_AGENT_TOOL_BUDGET;
+}
+function describeBuildPolicy(env = process.env) {
+  const viaAgent = shouldBuildViaAgent(env);
+  const councilBuild = shouldAllowCouncilBuild(env);
+  const parts = [
+    viaAgent ? "zelari build@agent (default)" : "zelari build@council (legacy)",
+    councilBuild ? "council may implement" : "council plan-only unless ZELARI_COUNCIL_CAN_BUILD=1"
+  ];
+  return parts.join(" \xB7 ");
+}
+var DEFAULT_AGENT_TOOL_BUDGET;
+var init_buildPolicy = __esm({
+  "src/cli/buildPolicy.ts"() {
+    "use strict";
+    DEFAULT_AGENT_TOOL_BUDGET = 40;
+  }
+});
+
 // src/cli/checkpoint/checkpointManager.ts
 import { execFile as execFile2 } from "node:child_process";
 import { promisify } from "node:util";
@@ -32211,6 +32325,10 @@ async function runZelariMission(userMessage, brief, deps) {
       deps.emit(
         `[zelari] design-phase (fuori budget) \xB7 step ${step} \xB7 slice ${brief.sliceMvp.id}`
       );
+    } else if (deps.buildViaAgent) {
+      deps.emit(
+        `[zelari] implementazione ${implStep}/${maxIter} \xB7 step ${step} \xB7 build@agent \xB7 slice ${brief.sliceMvp.id}`
+      );
     } else if (implementerRetry) {
       deps.emit(
         `[zelari] implementazione ${implStep}/${maxIter} \xB7 step ${step} \xB7 roster ridotto (Minosse+Lucifero) \xB7 slice ${brief.sliceMvp.id}`
@@ -32255,7 +32373,14 @@ async function runZelariMission(userMessage, brief, deps) {
         iteration: step
       }
     );
-    state2.lastCompletionOk = result.completionOk;
+    let completionOk = result.completionOk;
+    if (runMode === "implementation" && completionOk && typeof result.writeCount === "number" && result.writeCount === 0) {
+      completionOk = false;
+      deps.emit(
+        "[zelari] completion.ok ignored: implementation slice wrote 0 project files"
+      );
+    }
+    state2.lastCompletionOk = completionOk;
     state2.updatedAt = now().toISOString();
     if (runMode === "design-phase") {
       pendingDesign = false;
@@ -32263,7 +32388,7 @@ async function runZelariMission(userMessage, brief, deps) {
       continue;
     }
     const wrote = typeof result.writeCount === "number" && result.writeCount > 0;
-    if (result.completionOk || wrote) {
+    if (completionOk || wrote) {
       const hard = result.completionOk === true;
       const commitRes = await tryStateCommit({
         projectRoot: deps.projectRoot,
@@ -32299,7 +32424,7 @@ async function runZelariMission(userMessage, brief, deps) {
         deps.emit(`[zelari] state commit skipped: ${commitRes.error}`);
       }
     }
-    if (result.completionOk) {
+    if (completionOk) {
       state2.status = "success";
       await writeMissionState(deps.projectRoot, state2);
       deps.emit(
@@ -32343,6 +32468,290 @@ var init_zelariMission = __esm({
   }
 });
 
+// src/cli/missionSlice.ts
+var missionSlice_exports = {};
+__export(missionSlice_exports, {
+  AGENT_MISSION_IMPLEMENTER_PREAMBLE: () => AGENT_MISSION_IMPLEMENTER_PREAMBLE,
+  buildAgentMissionUserPrompt: () => buildAgentMissionUserPrompt,
+  createWriteCounter: () => createWriteCounter,
+  runAgentMissionSlice: () => runAgentMissionSlice
+});
+function createWriteCounter() {
+  const state2 = { successfulWrites: 0, emittedWrites: 0 };
+  const pending = /* @__PURE__ */ new Map();
+  return {
+    state: state2,
+    onEvent(event) {
+      if (event.type === "tool_execution_start") {
+        const name = event.toolName ?? event.name ?? "";
+        const id = event.toolCallId ?? "";
+        if (id && name) pending.set(id, name);
+        if (MUTATING.has(name)) state2.emittedWrites += 1;
+        return;
+      }
+      if (event.type === "tool_execution_end") {
+        const id = event.toolCallId ?? "";
+        const name = pending.get(id) ?? event.toolName ?? event.name ?? "";
+        if (id) pending.delete(id);
+        if (!MUTATING.has(name) || event.isError) return;
+        const result = String(event.result ?? "");
+        const zeroEdit = name === "edit_file" && /occurrencesReplaced["']?\s*[:=]\s*0\b|0 occurrence|no changes/i.test(
+          result
+        );
+        if (!zeroEdit) state2.successfulWrites += 1;
+      }
+    }
+  };
+}
+function buildAgentMissionUserPrompt(slicePrompt, ragContext) {
+  const body = `${AGENT_MISSION_IMPLEMENTER_PREAMBLE}
+
+${slicePrompt}`;
+  if (ragContext?.trim()) {
+    return `${body}
+
+## Memory context
+${ragContext.trim()}`;
+  }
+  return body;
+}
+async function runAgentMissionSlice(deps) {
+  const env = deps.env ?? process.env;
+  const provider = deps.provider ?? "openai-compatible";
+  const sessionId = deps.sessionId ?? crypto.randomUUID();
+  const maxToolCalls = resolveAgentMissionToolBudget(env);
+  const maxToolLoop = envNumber(env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, {
+    default: 30,
+    min: 1
+  });
+  const maxToolLoopHard = envNumber(env.ZELARI_MAX_TOOL_LOOP_HARD, {
+    default: 0,
+    min: 0
+  });
+  const writeRetry = deps.writeRetry !== false;
+  const toolSpecs = deps.toolRegistry.toOpenAITools().map((t) => ({
+    name: t.function.name,
+    description: t.function.description,
+    parameters: t.function.parameters
+  }));
+  const toolNames = toolSpecs.map((t) => t.name);
+  let languageDirective;
+  try {
+    languageDirective = buildLanguagePolicyModuleFor(deps.slicePrompt).content;
+  } catch {
+    languageDirective = "# Response Language\nReply in the user's language when possible, otherwise Italian.";
+  }
+  const rolePrompt = [
+    "# Platform",
+    `platform: ${process.platform}`,
+    `shell: ${process.platform === "win32" ? "cmd.exe / Git Bash (auto-detected)" : "/bin/sh"}`,
+    "",
+    "# Working Directory",
+    `You are running in: ${deps.projectRoot}`,
+    "All relative file paths are resolved against this directory.",
+    "The shell is NON-INTERACTIVE (stdin closed): pass non-interactive flags (--yes, --force, --template).",
+    "",
+    "# Work phase: BUILD (Zelari mission implementation slice)",
+    "IMPLEMENT ON DISK. Prior design under .zelari/ is a SPEC, not proof of delivery.",
+    "You MUST call write_file and/or edit_file before claiming done."
+  ].join("\n");
+  const headlessRole = {
+    id: "mission-agent",
+    name: "Zelari Code",
+    codename: "zelari-build",
+    role: "mission implementer",
+    color: "#00d9a3",
+    avatar: "\u25C6",
+    tools: toolNames,
+    systemPrompt: rolePrompt
+  };
+  let systemPrompt;
+  try {
+    systemPrompt = buildSystemPrompt(
+      headlessRole,
+      {
+        tools: getAllTools(),
+        toolNames,
+        mode: "agent",
+        projectInstructions: deps.projectInstructions || void 0,
+        workspaceContext: deps.workspaceContext || void 0,
+        ragContext: void 0,
+        aiConfig: {
+          enabledSkills: [],
+          enabledTools: toolNames,
+          customPromptModules: [
+            SINGLE_AGENT_IDENTITY_MODULE,
+            {
+              type: "language-policy",
+              title: "Response Language",
+              priority: 5,
+              content: languageDirective
+            }
+          ],
+          agentSkillConfigs: []
+        }
+      }
+    );
+  } catch {
+    systemPrompt = [
+      "You are zelari-code, implementing a mission slice. Write real files.",
+      languageDirective,
+      deps.workspaceContext ?? ""
+    ].filter(Boolean).join("\n\n");
+  }
+  const userContent = buildAgentMissionUserPrompt(
+    deps.slicePrompt,
+    deps.ragContext
+  );
+  async function runPass(messages, passId) {
+    const counter = createWriteCounter();
+    const harness = new AgentHarness({
+      model: deps.model,
+      provider,
+      sessionId: passId,
+      messages,
+      tools: toolSpecs,
+      toolRegistry: deps.toolRegistry,
+      providerStream: deps.providerStream,
+      cwd: deps.projectRoot,
+      maxToolCallsPerTurn: maxToolCalls,
+      maxToolLoopIterations: maxToolLoop,
+      ...maxToolLoopHard > 0 ? { maxToolLoopHardCap: maxToolLoopHard } : {}
+    });
+    let text = "";
+    let errored2 = false;
+    try {
+      for await (const event of harness.run()) {
+        counter.onEvent(event);
+        if (deps.onEvent) await deps.onEvent(event);
+        if (event.type === "message_delta" && typeof event.delta === "string") {
+          text += event.delta;
+        }
+        if (event.type === "agent_end" && event.reason === "error") {
+          errored2 = true;
+        }
+        if (event.type === "error" && event.severity === "fatal") {
+          errored2 = true;
+        }
+      }
+    } catch {
+      errored2 = true;
+    }
+    if (!text.trim()) {
+      const all = harness.getMessages();
+      for (let i = all.length - 1; i >= 0; i--) {
+        const m = all[i];
+        if (m?.role === "assistant" && (m.content ?? "").trim()) {
+          text = m.content ?? "";
+          break;
+        }
+      }
+    }
+    return {
+      text,
+      successfulWrites: counter.state.successfulWrites,
+      emittedWrites: counter.state.emittedWrites,
+      errored: errored2,
+      messages: harness.getMessages()
+    };
+  }
+  const initial = [
+    { role: "system", content: systemPrompt },
+    { role: "user", content: userContent }
+  ];
+  let pass = await runPass(initial, sessionId);
+  let totalWrites = pass.successfulWrites;
+  let totalEmitted = pass.emittedWrites;
+  let synthesisText = pass.text;
+  let errored = pass.errored;
+  if (writeRetry && totalWrites === 0 && !errored) {
+    deps.emit?.(
+      "[zelari] build@agent: 0 write \u2014 forcing implementation retry"
+    );
+    const retryPrompt = buildImplementationWriteRetryPrompt(deps.slicePrompt);
+    const retryMessages = [
+      { role: "system", content: systemPrompt },
+      ...pass.messages.filter((m) => m.role !== "system"),
+      { role: "user", content: retryPrompt }
+    ];
+    const retry = await runPass(retryMessages, `${sessionId}-write-retry`);
+    totalWrites += retry.successfulWrites;
+    totalEmitted += retry.emittedWrites;
+    if (retry.text.trim()) {
+      synthesisText = synthesisText ? `${synthesisText}
+
+${retry.text}` : retry.text;
+    }
+    errored = errored || retry.errored;
+  }
+  const cleaned = cleanAgentContent(synthesisText, {
+    stripQuestion: false,
+    stripThink: false
+  });
+  let completionOk = false;
+  let degraded = false;
+  if (deps.runCompletionHook) {
+    try {
+      const hook = await deps.runCompletionHook({
+        synthesisText: cleaned,
+        writeCount: totalWrites,
+        errored
+      });
+      completionOk = hook.completionOk;
+      degraded = hook.degraded;
+    } catch {
+    }
+  }
+  if (!deps.runCompletionHook) {
+    const d = detectDegradedRun({
+      chairmanErrored: errored,
+      luciferWriteCount: totalWrites,
+      synthesisText: cleaned,
+      runMode: "implementation"
+    });
+    degraded = d.degraded;
+    completionOk = totalWrites > 0 && !errored && !degraded;
+  }
+  if (totalWrites === 0) {
+    if (completionOk) {
+      deps.emit?.(
+        "[zelari] build@agent: completion.ok overridden \u2014 0 project writes (not done)"
+      );
+    }
+    completionOk = false;
+    const d = detectDegradedRun({
+      chairmanErrored: errored,
+      luciferWriteCount: 0,
+      synthesisText: cleaned || "completato",
+      runMode: "implementation"
+    });
+    if (d.degraded) degraded = true;
+    else degraded = true;
+  }
+  void totalEmitted;
+  return {
+    completionOk,
+    ran: true,
+    synthesisText: cleaned || void 0,
+    writeCount: totalWrites,
+    degraded
+  };
+}
+var MUTATING, AGENT_MISSION_IMPLEMENTER_PREAMBLE;
+var init_missionSlice = __esm({
+  "src/cli/missionSlice.ts"() {
+    "use strict";
+    init_harness();
+    init_skills2();
+    init_council();
+    init_dist();
+    init_buildPolicy();
+    init_envNumber();
+    MUTATING = /* @__PURE__ */ new Set(["write_file", "edit_file", "apply_diff"]);
+    AGENT_MISSION_IMPLEMENTER_PREAMBLE = "You are the sole implementer for this Zelari mission slice. A multi-agent council may already have produced a plan under `.zelari/` \u2014 treat it as a SPEC to apply on disk. You MUST create or modify real project files with write_file / edit_file. Prose without successful writes is a failed slice.";
+  }
+});
+
 // src/cli/utils/prereqChecks.ts
 var prereqChecks_exports = {};
 __export(prereqChecks_exports, {
@@ -36934,14 +37343,7 @@ init_keyStore();
 init_toolRegistry();
 init_skills2();
 init_fileStateStore();
-
-// packages/core/dist/events/index.js
-init_events();
-
-// packages/core/dist/index.js
-init_harness();
-init_council();
-init_skills2();
+init_dist();
 
 // src/cli/hooks/messageHelpers.ts
 function appendSystem(setMessages, content, ts = Date.now()) {
@@ -37883,8 +38285,23 @@ _(${req.context})_` : "") + "\n\u2192 scegli dalla lista (il membro riprende dop
       onCancel: () => finish(null)
     });
   }) : void 0;
+  let phaseRunMode = overrides.runMode ?? (workPhase === "plan" ? "design-phase" : "implementation");
+  let softGatedToDesign = false;
+  if (phaseRunMode === "implementation") {
+    const { shouldAllowCouncilBuild: shouldAllowCouncilBuild2 } = await Promise.resolve().then(() => (init_buildPolicy(), buildPolicy_exports));
+    const allowed = overrides.allowCouncilBuild === true || shouldAllowCouncilBuild2();
+    if (!allowed) {
+      phaseRunMode = "design-phase";
+      softGatedToDesign = true;
+      appendSystem(
+        setMessages,
+        "[council] build soft-gate: implementation disabled for free-form council (experiment: multi-agent = plan). Forced design-phase + plan tools. Set ZELARI_COUNCIL_CAN_BUILD=1 to let Lucifero implement, or use mode agent/zelari for on-disk work.",
+        Date.now()
+      );
+    }
+  }
   const { registry: councilToolRegistry } = createBuiltinToolRegistry({
-    planMode: workPhase === "plan",
+    planMode: workPhase === "plan" || softGatedToDesign,
     onAskUser: onAskUserCouncil
   });
   const workspaceCtx = createWorkspaceContext2();
@@ -37894,7 +38311,6 @@ _(${req.context})_` : "") + "\n\u2192 scegli dalla lista (il membro riprende dop
     if (!td) continue;
     councilToolRegistry.register(td);
   }
-  const phaseRunMode = overrides.runMode ?? (workPhase === "plan" ? "design-phase" : "implementation");
   try {
     const { registerMcpTools: registerMcpTools2 } = await Promise.resolve().then(() => (init_mcpManager(), mcpManager_exports));
     const mcp = await registerMcpTools2(councilToolRegistry, process.cwd(), {
@@ -38405,30 +38821,132 @@ async function runZelariMissionInTui(userMessage, deps, emit) {
     default: 30,
     min: 1
   });
+  const { shouldBuildViaAgent: shouldBuildViaAgent2 } = await Promise.resolve().then(() => (init_buildPolicy(), buildPolicy_exports));
+  const buildViaAgent = shouldBuildViaAgent2();
+  if (buildViaAgent) {
+    emit(
+      "[zelari] policy: design@council \xB7 build@agent (ZELARI_BUILD_VIA_AGENT; set=0 for legacy council impl)"
+    );
+  }
   try {
     await runZelariMission2(userMessage, brief, {
       projectRoot,
       memory,
       emit,
+      buildViaAgent,
       runSlice: async ({
         userMessage: slicePrompt,
         runMode,
         ragContext,
         implementerRetry
       }) => {
-        const r = await dispatchCouncilPromptImpl(slicePrompt, deps, {
-          ragContext,
-          runMode,
-          maxToolCallsChairman: chairmanBudget,
-          ...implementerRetry ? { skipSpecialists: true } : {}
+        if (runMode === "design-phase" || !buildViaAgent) {
+          const r = await dispatchCouncilPromptImpl(slicePrompt, deps, {
+            ragContext,
+            runMode,
+            maxToolCallsChairman: chairmanBudget,
+            ...implementerRetry ? { skipSpecialists: true } : {},
+            // Mission may need Lucifero to write even when free-form council is plan-only.
+            allowCouncilBuild: true
+          });
+          return {
+            completionOk: r.completionOk,
+            ran: r.ran,
+            synthesisText: r.synthesisText,
+            writeCount: r.writeCount,
+            degraded: r.degraded
+          };
+        }
+        const { runAgentMissionSlice: runAgentMissionSlice2 } = await Promise.resolve().then(() => (init_missionSlice(), missionSlice_exports));
+        const { composeProjectContext: composeProjectContext2 } = await Promise.resolve().then(() => (init_composeContext(), composeContext_exports));
+        const { loadDurableContext: loadDurableContext2 } = await Promise.resolve().then(() => (init_loadDurableContext(), loadDurableContext_exports));
+        const { createWorkspaceContext: createWorkspaceContext2 } = await Promise.resolve().then(() => (init_stubs(), stubs_exports));
+        const { runPostCouncilHook: runPostCouncilHook2 } = await Promise.resolve().then(() => (init_postCouncilHook(), postCouncilHook_exports));
+        const { detectDegradedRun: detectDegradedRun2 } = await Promise.resolve().then(() => (init_council(), council_exports));
+        const envConfig2 = await providerFromEnv();
+        if (!envConfig2) {
+          emit(
+            "[zelari] build@agent aborted: missing API key for active provider"
+          );
+          return { completionOk: false, ran: false };
+        }
+        const { registry: toolRegistry } = createBuiltinToolRegistry({
+          planMode: false
         });
-        return {
-          completionOk: r.completionOk,
-          ran: r.ran,
-          synthesisText: r.synthesisText,
-          writeCount: r.writeCount,
-          degraded: r.degraded
-        };
+        try {
+          const { registerMcpTools: registerMcpTools2 } = await Promise.resolve().then(() => (init_mcpManager(), mcpManager_exports));
+          await registerMcpTools2(toolRegistry, projectRoot);
+        } catch {
+        }
+        const durableState = await loadDurableContext2(projectRoot);
+        const composed = composeProjectContext2({
+          mode: "zelari",
+          cwd: projectRoot,
+          userMessage: slicePrompt,
+          memoryHits: ragContext,
+          durableState: durableState || void 0,
+          includeLessons: true,
+          includeDurableState: false
+        });
+        for (const w of composed.warnings) {
+          emit(w);
+        }
+        const workspaceCtx = createWorkspaceContext2(projectRoot);
+        const { setMessages: setMessages2, writerRef, setBusy } = deps;
+        setBusy(true);
+        try {
+          return await runAgentMissionSlice2({
+            projectRoot,
+            model: envConfig2.model,
+            provider: "openai-compatible",
+            providerStream: openaiCompatibleProvider(envConfig2),
+            toolRegistry,
+            slicePrompt,
+            ragContext: composed.ragContext ?? ragContext,
+            workspaceContext: composed.workspaceContext,
+            projectInstructions: composed.projectInstructions,
+            emit,
+            onEvent: async (event) => {
+              if (writerRef.current) await writerRef.current.append(event);
+              if (event.type === "tool_execution_start") {
+                const name = event.toolName ?? "tool";
+                appendSystem(
+                  setMessages2,
+                  `[build@agent] \u2192 ${name}`,
+                  Date.now()
+                );
+              }
+            },
+            runCompletionHook: async ({ synthesisText, writeCount, errored }) => {
+              const d = detectDegradedRun2({
+                chairmanErrored: errored,
+                luciferWriteCount: writeCount,
+                synthesisText,
+                runMode: "implementation"
+              });
+              if (d.degraded) {
+                appendSystem(
+                  setMessages2,
+                  `[zelari] DEGRADED_RUN \u2014 ${d.reasons.join("; ")}`,
+                  Date.now()
+                );
+              }
+              const hook = await runPostCouncilHook2(workspaceCtx, {
+                runMode: "implementation",
+                userMessage,
+                synthesisText: synthesisText || void 0,
+                degradedRun: d.degraded,
+                degradedReasons: d.reasons
+              });
+              return {
+                completionOk: hook.completion?.completion?.ok ?? false,
+                degraded: d.degraded
+              };
+            }
+          });
+        } finally {
+          setBusy(false);
+        }
       }
     });
   } catch (err) {
@@ -39438,11 +39956,11 @@ function parseMode(input) {
 function describeMode(mode) {
   switch (mode) {
     case "council":
-      return "council \u2014 6-member pipeline (Caronte\u2026Lucifero)";
+      return "council \u2014 multi-member plan/design (Caronte\u2026Lucifero; build needs ZELARI_COUNCIL_CAN_BUILD=1)";
     case "zelari":
-      return "zelari \u2014 autonomous multi-run mission";
+      return "zelari \u2014 mission: plan@council \u2192 build@agent (legacy: ZELARI_BUILD_VIA_AGENT=0)";
     default:
-      return "agent \u2014 single LLM turn";
+      return "agent \u2014 single LLM turn (default implementer)";
   }
 }
 
@@ -42103,6 +42621,7 @@ function emitEvent(event) {
 
 // src/cli/runHeadless.ts
 init_harness();
+init_dist();
 init_conversationContext();
 init_council();
 init_toolRegistry();
@@ -42112,6 +42631,7 @@ init_phaseState();
 init_phase();
 
 // src/cli/utils/streamScrub.ts
+init_dist();
 function createStreamScrubber() {
   let rawBuf = "";
   let emittedLen = 0;
@@ -42566,8 +43086,18 @@ async function buildCouncilToolRegistry(planMode, opts) {
 async function runHeadlessCouncil(opts, provider, model, providerStream) {
   const { dispatchCouncil: dispatchCouncil2 } = await Promise.resolve().then(() => (init_councilDispatcher(), councilDispatcher_exports));
   const sessionId = crypto.randomUUID();
+  const { shouldAllowCouncilBuild: shouldAllowCouncilBuild2 } = await Promise.resolve().then(() => (init_buildPolicy(), buildPolicy_exports));
+  let councilRunMode = planModeFromOpts(opts) ? "design-phase" : "implementation";
+  let softGated = false;
+  if (councilRunMode === "implementation" && !shouldAllowCouncilBuild2()) {
+    councilRunMode = "design-phase";
+    softGated = true;
+    process.stderr.write(
+      "[zelari-code --headless] council build soft-gate: forced design-phase (set ZELARI_COUNCIL_CAN_BUILD=1 to allow Lucifero implement)\n"
+    );
+  }
   const { toolRegistry } = await buildCouncilToolRegistry(
-    planModeFromOpts(opts),
+    planModeFromOpts(opts) || softGated,
     opts
   );
   const { FeedbackStore: FeedbackStore2 } = await Promise.resolve().then(() => (init_councilFeedback(), councilFeedback_exports));
@@ -42607,7 +43137,7 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
       sessionId,
       tools: toolRegistry,
       feedbackStore,
-      runMode: planModeFromOpts(opts) ? "design-phase" : "implementation",
+      runMode: councilRunMode,
       workspaceContext: composed.workspaceContext,
       ...composed.ragContext ? { ragContext: composed.ragContext } : {},
       maxToolLoopIterations: envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, {
@@ -42695,6 +43225,8 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
     default: 30,
     min: 1
   });
+  const { shouldBuildViaAgent: shouldBuildViaAgent2 } = await Promise.resolve().then(() => (init_buildPolicy(), buildPolicy_exports));
+  const buildViaAgent = shouldBuildViaAgent2();
   const emit = (message) => {
     if (opts.output === "json") {
       emitEvent({ type: "log", message });
@@ -42714,6 +43246,11 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
   const missionTask = buildCouncilTaskWithHistory(opts.task, historySeed);
   emit(`[zelari] mission brief
 ${JSON.stringify({ deliverable: brief.deliverableThisMission, mvp: brief.sliceMvp?.title }, null, 0)}`);
+  if (buildViaAgent) {
+    emit(
+      "[zelari] policy: design@council \xB7 build@agent (set ZELARI_BUILD_VIA_AGENT=0 for legacy)"
+    );
+  }
   let exitCode = 0;
   let lastMissionAssistant = "";
   try {
@@ -42721,129 +43258,199 @@ ${JSON.stringify({ deliverable: brief.deliverableThisMission, mvp: brief.sliceMv
       projectRoot,
       memory,
       emit,
+      buildViaAgent,
       runSlice: async ({
         userMessage: slicePrompt,
         runMode,
         ragContext,
         implementerRetry
       }) => {
-        const sessionId = crypto.randomUUID();
-        const fullPrompt = ragContext ? `${slicePrompt}
+        const effectiveRunMode = planModeFromOpts(opts) ? "design-phase" : runMode;
+        if (effectiveRunMode === "design-phase" || !buildViaAgent) {
+          const sessionId = crypto.randomUUID();
+          const fullPrompt = ragContext ? `${slicePrompt}
 
 ## Memory context
 ${ragContext}` : slicePrompt;
-        let synthesisText = "";
-        let writeCount = 0;
-        let chairmanErrored = false;
-        let membersCompleted = 0;
-        const scrub = createStreamScrubber();
+          let synthesisText = "";
+          let writeCount = 0;
+          let chairmanErrored = false;
+          let membersCompleted = 0;
+          const scrub = createStreamScrubber();
+          const { composeProjectContext: composeProjectContext3 } = await Promise.resolve().then(() => (init_composeContext(), composeContext_exports));
+          const { loadDurableContext: loadDurableContext3 } = await Promise.resolve().then(() => (init_loadDurableContext(), loadDurableContext_exports));
+          const memOnly = ragContext?.trim() ? ragContext : void 0;
+          const durableState2 = await loadDurableContext3(projectRoot);
+          const composed2 = composeProjectContext3({
+            mode: "zelari",
+            cwd: projectRoot,
+            userMessage: slicePrompt,
+            memoryHits: memOnly,
+            durableState: durableState2 || void 0,
+            includeLessons: true,
+            includeDurableState: false
+          });
+          for await (const event of dispatchCouncil2(fullPrompt, {
+            apiKey: "REDACTED",
+            model,
+            provider: "openai-compatible",
+            providerStream,
+            sessionId,
+            tools: toolRegistry,
+            feedbackStore,
+            runMode: effectiveRunMode,
+            maxToolCallsChairman: chairmanBudget,
+            ...implementerRetry ? { skipSpecialists: true } : {},
+            workspaceContext: composed2.workspaceContext,
+            ...composed2.ragContext ? { ragContext: composed2.ragContext } : {},
+            maxToolLoopIterations: envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, {
+              default: 30,
+              min: 1
+            }),
+            ...(() => {
+              const hard = envNumber(process.env.ZELARI_MAX_TOOL_LOOP_HARD, {
+                default: 0,
+                min: 0
+              });
+              return hard > 0 ? { maxToolLoopHardCap: hard } : {};
+            })()
+          })) {
+            if (event.type === "message_start") {
+              scrub.reset();
+            }
+            if (event.type === "message_delta" && typeof event.delta === "string") {
+              synthesisText += event.delta;
+              const cleanDelta = scrub.push(event.delta);
+              if (opts.output === "json") {
+                if (cleanDelta.length > 0) emitEvent({ ...event, delta: cleanDelta });
+              } else if (opts.output === "plain" && cleanDelta.length > 0) {
+                process.stdout.write(cleanDelta);
+              }
+            } else if (opts.output === "json") {
+              emitEvent(event);
+            }
+            if (event.type === "tool_execution_end") {
+              const name = event.toolName ?? event.name ?? "";
+              if (name === "write_file" || name === "edit_file" || name === "apply_diff") {
+                writeCount += 1;
+              }
+            }
+            if (event.type === "agent_end") {
+              membersCompleted += 1;
+              if (event.reason === "error") chairmanErrored = true;
+            }
+            if (event.type === "error" && event.severity === "fatal") {
+              chairmanErrored = true;
+              exitCode = 2;
+            }
+          }
+          let completionOk = false;
+          let degraded = false;
+          try {
+            const { detectDegradedRun: detectDegradedRun3 } = await Promise.resolve().then(() => (init_council(), council_exports));
+            const d = detectDegradedRun3({
+              chairmanErrored,
+              councilAborted: false,
+              luciferWriteCount: writeCount,
+              synthesisText,
+              runMode: effectiveRunMode
+            });
+            degraded = d.degraded;
+            const hook = await runPostCouncilHook2(workspaceCtx, {
+              runMode: effectiveRunMode,
+              userMessage: opts.task,
+              synthesisText: synthesisText || void 0,
+              degradedRun: d.degraded,
+              degradedReasons: d.reasons
+            });
+            completionOk = hook.completion?.completion?.ok ?? false;
+            if (completionOk) {
+              emit(`[zelari] slice completion ok`);
+            }
+          } catch {
+          }
+          if (synthesisText.trim()) {
+            lastMissionAssistant = cleanAgentContent(synthesisText, {
+              stripQuestion: false,
+              stripThink: false
+            });
+          }
+          return {
+            completionOk,
+            ran: membersCompleted > 0 || synthesisText.length > 0,
+            synthesisText: synthesisText || void 0,
+            writeCount,
+            degraded
+          };
+        }
+        const { runAgentMissionSlice: runAgentMissionSlice2 } = await Promise.resolve().then(() => (init_missionSlice(), missionSlice_exports));
+        const { createBuiltinToolRegistry: createBuiltinToolRegistry2 } = await Promise.resolve().then(() => (init_toolRegistry(), toolRegistry_exports));
         const { composeProjectContext: composeProjectContext2 } = await Promise.resolve().then(() => (init_composeContext(), composeContext_exports));
         const { loadDurableContext: loadDurableContext2 } = await Promise.resolve().then(() => (init_loadDurableContext(), loadDurableContext_exports));
-        const memOnly = ragContext?.trim() ? ragContext : void 0;
+        const { detectDegradedRun: detectDegradedRun2 } = await Promise.resolve().then(() => (init_council(), council_exports));
+        const { registry: agentRegistry } = createBuiltinToolRegistry2({
+          planMode: false
+        });
+        await registerHeadlessMcp(agentRegistry, opts);
         const durableState = await loadDurableContext2(projectRoot);
         const composed = composeProjectContext2({
           mode: "zelari",
           cwd: projectRoot,
           userMessage: slicePrompt,
-          memoryHits: memOnly,
+          memoryHits: ragContext?.trim() ? ragContext : void 0,
           durableState: durableState || void 0,
           includeLessons: true,
           includeDurableState: false
         });
-        for await (const event of dispatchCouncil2(fullPrompt, {
-          apiKey: "REDACTED",
+        const sliceResult = await runAgentMissionSlice2({
+          projectRoot,
           model,
           provider: "openai-compatible",
           providerStream,
-          sessionId,
-          tools: toolRegistry,
-          feedbackStore,
-          runMode: planModeFromOpts(opts) ? "design-phase" : runMode,
-          maxToolCallsChairman: chairmanBudget,
-          ...implementerRetry ? { skipSpecialists: true } : {},
+          toolRegistry: agentRegistry,
+          slicePrompt,
+          ragContext: composed.ragContext ?? ragContext,
           workspaceContext: composed.workspaceContext,
-          ...composed.ragContext ? { ragContext: composed.ragContext } : {},
-          maxToolLoopIterations: envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, {
-            default: 30,
-            min: 1
-          }),
-          ...(() => {
-            const hard = envNumber(process.env.ZELARI_MAX_TOOL_LOOP_HARD, {
-              default: 0,
-              min: 0
-            });
-            return hard > 0 ? { maxToolLoopHardCap: hard } : {};
-          })()
-        })) {
-          if (event.type === "message_start") {
-            scrub.reset();
-          }
-          if (event.type === "message_delta" && typeof event.delta === "string") {
-            synthesisText += event.delta;
-            const cleanDelta = scrub.push(event.delta);
-            if (opts.output === "json") {
-              if (cleanDelta.length > 0) emitEvent({ ...event, delta: cleanDelta });
-            } else if (opts.output === "plain" && cleanDelta.length > 0) {
-              process.stdout.write(cleanDelta);
-            }
-          } else {
+          projectInstructions: composed.projectInstructions,
+          emit,
+          onEvent: async (event) => {
             if (opts.output === "json") {
-              emitEvent(event);
+              if (event.type === "message_delta" && typeof event.delta === "string") {
+                emitEvent(event);
+              } else {
+                emitEvent(event);
+              }
+            } else if (opts.output === "plain" && event.type === "message_delta" && typeof event.delta === "string") {
+              process.stdout.write(event.delta);
             }
-          }
-          if (event.type === "tool_execution_end") {
-            const name = event.toolName ?? event.name ?? "";
-            if (name === "write_file" || name === "edit_file" || name === "apply_diff") {
-              writeCount += 1;
+          },
+          runCompletionHook: async ({ synthesisText, writeCount, errored }) => {
+            const d = detectDegradedRun2({
+              chairmanErrored: errored,
+              luciferWriteCount: writeCount,
+              synthesisText,
+              runMode: "implementation"
+            });
+            const hook = await runPostCouncilHook2(workspaceCtx, {
+              runMode: "implementation",
+              userMessage: opts.task,
+              synthesisText: synthesisText || void 0,
+              degradedRun: d.degraded,
+              degradedReasons: d.reasons
+            });
+            if (hook.completion?.completion?.ok) {
+              emit(`[zelari] slice completion ok`);
             }
+            return {
+              completionOk: hook.completion?.completion?.ok ?? false,
+              degraded: d.degraded
+            };
           }
-          if (event.type === "agent_end") {
-            membersCompleted += 1;
-            if (event.reason === "error") chairmanErrored = true;
-          }
-          if (event.type === "error" && event.severity === "fatal") {
-            chairmanErrored = true;
-            exitCode = 2;
-          }
-        }
-        let completionOk = false;
-        let degraded = false;
-        try {
-          const { detectDegradedRun: detectDegradedRun2 } = await Promise.resolve().then(() => (init_council(), council_exports));
-          const d = detectDegradedRun2({
-            chairmanErrored,
-            councilAborted: false,
-            luciferWriteCount: writeCount,
-            synthesisText,
-            runMode
-          });
-          degraded = d.degraded;
-          const hook = await runPostCouncilHook2(workspaceCtx, {
-            runMode,
-            userMessage: opts.task,
-            synthesisText: synthesisText || void 0,
-            degradedRun: d.degraded,
-            degradedReasons: d.reasons
-          });
-          completionOk = hook.completion?.completion?.ok ?? false;
-          if (completionOk) {
-            emit(`[zelari] slice completion ok`);
-          }
-        } catch {
-        }
-        if (synthesisText.trim()) {
-          lastMissionAssistant = cleanAgentContent(synthesisText, {
-            stripQuestion: false,
-            stripThink: false
-          });
+        });
+        if (sliceResult.synthesisText?.trim()) {
+          lastMissionAssistant = sliceResult.synthesisText;
         }
-        return {
-          completionOk,
-          ran: membersCompleted > 0 || synthesisText.length > 0,
-          synthesisText: synthesisText || void 0,
-          writeCount,
-          degraded
-        };
+        return sliceResult;
       }
     });
     if (state2.status === "error") exitCode = exitCode || 3;