zelari-code 1.18.1 → 1.20.0

package/dist/cli/main.bundled.js

@@ -16596,12 +16596,20 @@ function isWslBashPath(p3) {
     return true;
   return false;
 }
+function isPowerShellPath(p3) {
+  if (!p3 || typeof p3 !== "string")
+    return false;
+  const lower = p3.toLowerCase().trim();
+  return POWERSHELL_EXES.some((exe) => lower.endsWith(exe));
+}
 function acceptBashPath(p3) {
   if (!p3 || p3.trim().length === 0)
     return null;
   const trimmed = p3.trim();
   if (isWslBashPath(trimmed))
     return null;
+  if (isPowerShellPath(trimmed))
+    return null;
   if (!existsSyncSafe(trimmed))
     return null;
   return trimmed;
@@ -16610,19 +16618,24 @@ function resolveShell(forceReResolve = false) {
   if (memoized && !forceReResolve)
     return memoized;
   if (process.platform !== "win32") {
-    memoized = { shell: true, via: "/bin/sh", isBash: false };
+    memoized = { shell: true, via: "/bin/sh", isBash: false, isPowerShell: false };
     return memoized;
   }
-  const found = resolveBashWindows();
-  if (found) {
-    memoized = { shell: found, via: `bash (${found})`, isBash: true };
+  const bashFound = resolveBashWindows();
+  if (bashFound) {
+    memoized = { shell: bashFound, via: `bash (${bashFound})`, isBash: true, isPowerShell: false };
+    return memoized;
+  }
+  const psFound = resolvePowerShellWindows();
+  if (psFound) {
+    memoized = { shell: psFound, via: `powershell (${psFound})`, isBash: false, isPowerShell: true };
     return memoized;
   }
   if (!warnedFallback) {
     warnedFallback = true;
     console.error("[zelari-code] bash tool: Git Bash not found \u2014 falling back to cmd.exe. POSIX commands (ls, which, $VAR, &&) may fail. Install Git for Windows or set ZELARI_SHELL to your bash binary for proper POSIX support.");
   }
-  memoized = { shell: true, via: "cmd.exe", isBash: false };
+  memoized = { shell: true, via: "cmd.exe", isBash: false, isPowerShell: false };
   return memoized;
 }
 function resolveBashWindows() {
@@ -16650,6 +16663,42 @@ function resolveBashWindows() {
   }
   return null;
 }
+function acceptPowerShellPath(p3) {
+  if (!p3 || p3.trim().length === 0)
+    return null;
+  const trimmed = p3.trim();
+  if (isWslBashPath(trimmed))
+    return null;
+  if (!isPowerShellPath(trimmed))
+    return null;
+  if (!existsSyncSafe(trimmed))
+    return null;
+  return trimmed;
+}
+function resolvePowerShellWindows() {
+  const fromEnv = acceptPowerShellPath(process.env.ZELARI_SHELL);
+  if (fromEnv)
+    return fromEnv;
+  for (const p3 of STANDARD_POWERSHELL_PATHS) {
+    const accepted = acceptPowerShellPath(p3);
+    if (accepted)
+      return accepted;
+  }
+  try {
+    for (const name of POWERSHELL_EXES) {
+      const result = spawnSync("where", [name], { encoding: "utf-8", windowsHide: true });
+      if (result.status === 0 && result.stdout) {
+        for (const line of result.stdout.split(/\r?\n/)) {
+          const accepted = acceptPowerShellPath(line);
+          if (accepted)
+            return accepted;
+        }
+      }
+    }
+  } catch {
+  }
+  return null;
+}
 function existsSyncSafe(p3) {
   try {
     return existsSync4(p3);
@@ -16657,7 +16706,7 @@ function existsSyncSafe(p3) {
     return false;
   }
 }
-var STANDARD_BASH_PATHS, memoized, warnedFallback;
+var STANDARD_BASH_PATHS, POWERSHELL_EXES, STANDARD_POWERSHELL_PATHS, memoized, warnedFallback;
 var init_shellResolver = __esm({
   "packages/core/dist/core/tools/builtin/shellResolver.js"() {
     "use strict";
@@ -16667,6 +16716,13 @@ var init_shellResolver = __esm({
       "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
       "C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe"
     ];
+    POWERSHELL_EXES = ["pwsh.exe", "powershell.exe"];
+    STANDARD_POWERSHELL_PATHS = [
+      "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
+      "C:\\Program Files\\PowerShell\\7\\powershell.exe",
+      "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
+      "C:\\Windows\\SysWOW64\\WindowsPowerShell\\v1.0\\powershell.exe"
+    ];
     memoized = null;
     warnedFallback = false;
   }
@@ -16731,6 +16787,14 @@ var init_shell = __esm({
               env,
               stdio: ["ignore", "pipe", "pipe"]
             });
+          } else if (resolved.isPowerShell) {
+            child = spawn(resolved.shell, ["-Command", args.command], {
+              cwd,
+              signal: ctx.signal,
+              shell: false,
+              env: baseEnv,
+              stdio: ["ignore", "pipe", "pipe"]
+            });
           } else {
             child = spawn(args.command, {
               shell: resolved.shell,
@@ -19551,7 +19615,7 @@ var init_AgentHarness = __esm({
         this.eventBus = config2.eventBus;
         this.sessionId = config2.sessionId ?? crypto.randomUUID();
         this.maxQueuedIterations = config2.maxQueuedIterations ?? 3;
-        this.maxToolLoopIterations = config2.maxToolLoopIterations ?? 30;
+        this.maxToolLoopIterations = config2.maxToolLoopIterations ?? 60;
         const soft = this.maxToolLoopIterations;
         const hardCfg = config2.maxToolLoopHardCap;
         this.maxToolLoopHardCap = typeof hardCfg === "number" && hardCfg > 0 ? Math.max(soft, hardCfg) : Math.max(soft * 3, soft + 60);
@@ -24290,6 +24354,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 +27255,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 +27459,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 +27477,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 +27730,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 +27740,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 +27821,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 +28136,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 +31890,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 +32389,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 +32437,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 +32452,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 +32488,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 +32532,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, {
@@ -32350,6 +32823,7 @@ __export(prereqChecks_exports, {
   checkAgentGit: () => checkAgentGit,
   checkAgentNode: () => checkAgentNode,
   checkMainNode: () => checkMainNode,
+  isPowerShellPath: () => isPowerShellPath2,
   isWslBashPath: () => isWslBashPath2,
   runPrereqChecks: () => runPrereqChecks
 });
@@ -32364,33 +32838,72 @@ function isWslBashPath2(p3) {
   if (n.includes("\\windowsapps\\bash.exe")) return true;
   return false;
 }
+function isPowerShellPath2(p3) {
+  if (!p3 || typeof p3 !== "string") return false;
+  const lower = p3.toLowerCase().trim();
+  return POWERSHELL_EXES2.some((exe) => lower.endsWith(exe));
+}
 function acceptBashPath2(p3) {
   if (!p3 || p3.trim().length === 0) return null;
   const trimmed = p3.trim();
   if (isWslBashPath2(trimmed)) return null;
+  if (isPowerShellPath2(trimmed)) return null;
+  if (!existsSyncSafe2(trimmed)) return null;
+  return trimmed;
+}
+function acceptPowerShellPath2(p3) {
+  if (!p3 || p3.trim().length === 0) return null;
+  const trimmed = p3.trim();
+  if (isWslBashPath2(trimmed)) return null;
+  if (!isPowerShellPath2(trimmed)) return null;
   if (!existsSyncSafe2(trimmed)) return null;
   return trimmed;
 }
+function resolvePowerShellWindowsSync() {
+  const fromEnv = acceptPowerShellPath2(process.env.ZELARI_SHELL);
+  if (fromEnv) return fromEnv;
+  for (const p3 of STANDARD_POWERSHELL_PATHS2) {
+    const accepted = acceptPowerShellPath2(p3);
+    if (accepted) return accepted;
+  }
+  try {
+    for (const name of POWERSHELL_EXES2) {
+      const result = spawnSync2("where", [name], {
+        encoding: "utf8",
+        windowsHide: true
+      });
+      if (result.status === 0 && result.stdout) {
+        for (const line of result.stdout.split(/\r?\n/)) {
+          const accepted = acceptPowerShellPath2(line);
+          if (accepted) return accepted;
+        }
+      }
+    }
+  } catch {
+  }
+  return null;
+}
 function resolveAgentShellSync() {
   if (process.platform !== "win32") {
-    return { bashPath: null, isBash: true, via: "/bin/sh" };
+    return { bashPath: null, isBash: true, isPowerShell: false, via: "/bin/sh" };
   }
   const fromEnv = acceptBashPath2(process.env.ZELARI_SHELL);
   if (fromEnv) {
-    return { bashPath: fromEnv, isBash: true, via: `bash (${fromEnv})` };
+    return { bashPath: fromEnv, isBash: true, isPowerShell: false, via: `bash (${fromEnv})` };
   }
   const fromSession = acceptBashPath2(process.env.SHELL);
   if (fromSession) {
     return {
       bashPath: fromSession,
       isBash: true,
+      isPowerShell: false,
       via: `bash (${fromSession})`
     };
   }
   for (const p3 of STANDARD_BASH_PATHS2) {
     const accepted = acceptBashPath2(p3);
     if (accepted) {
-      return { bashPath: accepted, isBash: true, via: `bash (${accepted})` };
+      return { bashPath: accepted, isBash: true, isPowerShell: false, via: `bash (${accepted})` };
     }
   }
   try {
@@ -32405,6 +32918,7 @@ function resolveAgentShellSync() {
           return {
             bashPath: accepted,
             isBash: true,
+            isPowerShell: false,
             via: `bash (${accepted})`
           };
         }
@@ -32412,7 +32926,11 @@ function resolveAgentShellSync() {
     }
   } catch {
   }
-  return { bashPath: null, isBash: false, via: "cmd.exe" };
+  const psFound = resolvePowerShellWindowsSync();
+  if (psFound) {
+    return { bashPath: psFound, isBash: false, isPowerShell: true, via: `powershell (${psFound})` };
+  }
+  return { bashPath: null, isBash: false, isPowerShell: false, via: "cmd.exe" };
 }
 function agentProbeEnv() {
   const env = { ...process.env };
@@ -32444,15 +32962,28 @@ function probeTool(tool) {
   let stdout = "";
   const env = agentProbeEnv();
   if (shell.bashPath) {
-    try {
-      const r = spawnSync2(shell.bashPath, ["-c", `${tool} --version`], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "ignore"],
-        windowsHide: true,
-        env
-      });
-      if (r.status === 0) stdout = (r.stdout || "").trim();
-    } catch {
+    if (shell.isPowerShell) {
+      try {
+        const r = spawnSync2(shell.bashPath, ["-Command", `${tool} --version`], {
+          encoding: "utf8",
+          stdio: ["ignore", "pipe", "ignore"],
+          windowsHide: true,
+          env
+        });
+        if (r.status === 0) stdout = (r.stdout || "").trim();
+      } catch {
+      }
+    } else {
+      try {
+        const r = spawnSync2(shell.bashPath, ["-c", `${tool} --version`], {
+          encoding: "utf8",
+          stdio: ["ignore", "pipe", "ignore"],
+          windowsHide: true,
+          env
+        });
+        if (r.status === 0) stdout = (r.stdout || "").trim();
+      } catch {
+      }
     }
   } else if (process.platform === "win32") {
     try {
@@ -32573,11 +33104,19 @@ function checkAgentBash() {
       message: `real bash available (${shell.via})`
     };
   }
+  if (shell.isPowerShell) {
+    return {
+      ok: true,
+      severity: "warn",
+      tool: "bash",
+      message: `PowerShell available (${shell.via}) \u2014 works as bash replacement`
+    };
+  }
   return {
     ok: false,
     severity: "warn",
     tool: "bash",
-    message: "no Git Bash \u2014 bash tool uses cmd.exe (install Git for Windows or set ZELARI_SHELL). Details: zelari-code --doctor"
+    message: "no Git Bash or PowerShell \u2014 bash tool uses cmd.exe (install Git for Windows, or set ZELARI_SHELL). Details: zelari-code --doctor"
   };
 }
 function checkMainNode() {
@@ -32638,7 +33177,7 @@ function runPrereqChecks(opts = { mode: "preflight" }) {
   void opts.mode;
   return { results, hasCriticalFail, warnings };
 }
-var MIN_NODE_MAJOR, STANDARD_BASH_PATHS2;
+var MIN_NODE_MAJOR, STANDARD_BASH_PATHS2, POWERSHELL_EXES2, STANDARD_POWERSHELL_PATHS2;
 var init_prereqChecks = __esm({
   "src/cli/utils/prereqChecks.ts"() {
     "use strict";
@@ -32649,6 +33188,13 @@ var init_prereqChecks = __esm({
       "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
       "C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe"
     ];
+    POWERSHELL_EXES2 = ["pwsh.exe", "powershell.exe"];
+    STANDARD_POWERSHELL_PATHS2 = [
+      "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
+      "C:\\Program Files\\PowerShell\\7\\powershell.exe",
+      "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
+      "C:\\Windows\\SysWOW64\\WindowsPowerShell\\v1.0\\powershell.exe"
+    ];
   }
 });
 
@@ -33055,6 +33601,43 @@ function checkPath() {
 ` + (process.platform === "win32" ? winHint : posixHint)
   );
 }
+function checkBudget() {
+  const expected = {
+    ZELARI_MAX_TOOL_LOOP_HARD: "180",
+    ZELARI_MAX_TOOL_LOOP_ITERATIONS: "60",
+    ZELARI_CONTEXT_LIMIT: "400000"
+  };
+  const missing = [];
+  const wrong = [];
+  for (const [name, target] of Object.entries(expected)) {
+    const current = process.env[name];
+    if (current === void 0 || current === "") missing.push(name);
+    else if (current !== target) wrong.push(`${name}=${current} (recommended ${target})`);
+  }
+  if (missing.length === 0 && wrong.length === 0) {
+    return OK(`budget at recommended values (hard=180, soft=60, ctx=400k)`);
+  }
+  const lines = [];
+  if (missing.length > 0) {
+    lines.push(
+      `missing: ${missing.join(", ")} \u2014 agent uses tighter in-code defaults`
+    );
+  }
+  if (wrong.length > 0) {
+    lines.push(`override: ${wrong.join("; ")}`);
+  }
+  const winHint = `         fix:  zelari-code --fix-budget   (sets all three at User scope)
+               then open a NEW terminal for the changes to take effect`;
+  const posixHint = `         fix:  export ZELARI_MAX_TOOL_LOOP_HARD=180
+               export ZELARI_MAX_TOOL_LOOP_ITERATIONS=60
+               export ZELARI_CONTEXT_LIMIT=400000
+               (add to ~/.bashrc or ~/.zshrc to persist)`;
+  return WARN(
+    `${lines.join("\n")}
+         symptom: agent stops mid-task without completing (not rate limit)
+` + (process.platform === "win32" ? winHint : posixHint)
+  );
+}
 function prereqToCheckResult(r) {
   if (r.ok) return OK(r.message);
   return r.severity === "critical" ? FAIL(r.message, "critical") : WARN(r.message);
@@ -33104,6 +33687,10 @@ async function runDoctor() {
     { name: "node (agent shell)", run: () => prereqToCheckResult(checkAgentNode()) },
     { name: "git (agent shell)", run: () => prereqToCheckResult(checkAgentGit()) },
     { name: "bash", run: () => prereqToCheckResult(checkAgentBash()) },
+    // --- tool-budget sanity (v1.20.0) ---
+    // WARNS when the recommended ZELARI_* caps are unset/overridden, so users
+    // learn why the agent stops mid-task without completing. Points to --fix-budget.
+    { name: "budget", run: () => checkBudget() },
     // --- optional tool plugins (v1.5.0) ---
     // Playwright / eslint / ruff / LSP servers. WARN-only (never critical):
     // these power edge features that degrade silently when absent. Surfaced
@@ -33254,6 +33841,85 @@ var init_fixPath = __esm({
   }
 });
 
+// src/cli/utils/fixBudget.ts
+var fixBudget_exports = {};
+__export(fixBudget_exports, {
+  RECOMMENDED_BUDGET: () => RECOMMENDED_BUDGET,
+  repairWindowsBudget: () => repairWindowsBudget
+});
+import { spawnSync as spawnSync4 } from "node:child_process";
+function powershell2(script) {
+  try {
+    const res = spawnSync4(
+      "powershell.exe",
+      ["-NoProfile", "-NonInteractive", "-Command", script],
+      { encoding: "utf8" }
+    );
+    if (res.status === 0) return (res.stdout || "").trim();
+    return "";
+  } catch {
+    return "";
+  }
+}
+function repairWindowsBudget() {
+  if (process.platform !== "win32") {
+    const lines = Object.entries(RECOMMENDED_BUDGET).map(
+      ([k, v]) => `  export ${k}=${v}`
+    );
+    return {
+      ok: false,
+      error: `--fix-budget is Windows-only. On ${process.platform}, add to your shell profile (~/.bashrc or ~/.zshrc):
+${lines.join("\n")}`
+    };
+  }
+  const applied = [];
+  const skipped = [];
+  let writeFailed = false;
+  for (const [name, target] of Object.entries(RECOMMENDED_BUDGET)) {
+    const current = powershell2(
+      `[Environment]::GetEnvironmentVariable('${name}','User')`
+    );
+    if (current === target) {
+      skipped.push(name);
+      continue;
+    }
+    powershell2(
+      `[Environment]::SetEnvironmentVariable('${name}', ${JSON.stringify(target)}, 'User')`
+    );
+    const reread = powershell2(
+      `[Environment]::GetEnvironmentVariable('${name}','User')`
+    );
+    if (reread === target) {
+      applied.push(name);
+    } else {
+      writeFailed = true;
+    }
+  }
+  if (writeFailed) {
+    return {
+      ok: false,
+      error: "PowerShell write did not take effect for at least one variable (permission denied? run as the same user that owns the install)"
+    };
+  }
+  return {
+    ok: true,
+    alreadyOk: applied.length === 0,
+    applied,
+    skipped
+  };
+}
+var RECOMMENDED_BUDGET;
+var init_fixBudget = __esm({
+  "src/cli/utils/fixBudget.ts"() {
+    "use strict";
+    RECOMMENDED_BUDGET = {
+      ZELARI_MAX_TOOL_LOOP_HARD: "180",
+      ZELARI_MAX_TOOL_LOOP_ITERATIONS: "60",
+      ZELARI_CONTEXT_LIMIT: "400000"
+    };
+  }
+});
+
 // src/cli/main.ts
 import React15 from "react";
 import { render } from "ink";
@@ -36934,14 +37600,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()) {
@@ -37142,7 +37801,7 @@ function estimateHistoryTokens(messages) {
 }
 function resolveContextLimit() {
   return envNumber(process.env.ZELARI_CONTEXT_LIMIT, {
-    default: 2e5,
+    default: 4e5,
     min: 4e3,
     max: 2e6
   });
@@ -37151,7 +37810,7 @@ function applyBudgetPolicy(history2, phase2, opts) {
   const contextLimit = resolveContextLimit();
   const warnings = [];
   let historyTurns = phase2 === "plan" ? envNumber(process.env.ZELARI_HISTORY_TURNS, { default: 8, min: 0 }) : envNumber(process.env.ZELARI_HISTORY_TURNS, { default: 6, min: 0 });
-  let maxToolLoopIterations = phase2 === "plan" ? envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 40, min: 1 }) : envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 90, min: 1 });
+  let maxToolLoopIterations = phase2 === "plan" ? envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 60, min: 1 }) : envNumber(process.env.ZELARI_MAX_TOOL_LOOP_ITERATIONS, { default: 120, min: 1 });
   let hist = history2;
   let estimated = estimateHistoryTokens(hist);
   const sessionExtra = opts?.sessionTokens ?? 0;
@@ -37371,7 +38030,7 @@ _(${req.context})_` : "") + "\n\u2192 scegli dalla lista (il turno continua dopo
         const toolList = openAiTools.map((t) => `- ${t.function.name}: ${t.function.description}`).join("\n");
         const resolvedShell = resolveShell();
         const isWindows = process.platform === "win32";
-        const shellGuidance = resolvedShell.isBash ? `The bash tool runs commands via Git Bash / MSYS2 (${resolvedShell.shell}). Write POSIX commands: ls, grep, $VAR, &&, /c/Users/... all work.` : isWindows ? `The bash tool runs commands via cmd.exe (Git Bash not found). Write Windows-native commands: use dir (not ls), %VAR% (not $VAR), avoid POSIX-only syntax.` : `The bash tool runs commands via /bin/sh.`;
+        const shellGuidance = resolvedShell.isBash ? `The bash tool runs commands via Git Bash / MSYS2 (${resolvedShell.shell}). Write POSIX commands: ls, grep, $VAR, &&, /c/Users/... all work.` : resolvedShell.isPowerShell ? `The bash tool runs commands via PowerShell (${resolvedShell.shell}). Write PowerShell syntax: ls/cat/pwd aliases work, use \`\${env:VAR}\` (not %VAR%), pipe with |, && works in PS7+.` : isWindows ? `The bash tool runs commands via cmd.exe (Git Bash not found). Write Windows-native commands: use dir (not ls), %VAR% (not $VAR), avoid POSIX-only syntax.` : `The bash tool runs commands via /bin/sh.`;
         const nonInteractiveGuidance = "The shell is NON-INTERACTIVE (stdin closed): commands that prompt for input fail immediately. Always pass non-interactive flags (--yes, -y, --template, --force). If a scaffolder still insists on prompting (e.g. `npm create vite` in a non-empty directory), do NOT retry it \u2014 scaffold into a fresh empty subdirectory and move the files, or write package.json/configs/sources yourself with write_file, then run `npm install`.";
         const planPhaseBlock = workPhase === "plan" ? [
           "# Work Phase: PLAN",
@@ -37883,8 +38542,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 +38568,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 +39078,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 +40213,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 +42878,7 @@ function emitEvent(event) {
 
 // src/cli/runHeadless.ts
 init_harness();
+init_dist();
 init_conversationContext();
 init_council();
 init_toolRegistry();
@@ -42112,6 +42888,7 @@ init_phaseState();
 init_phase();
 
 // src/cli/utils/streamScrub.ts
+init_dist();
 function createStreamScrubber() {
   let rawBuf = "";
   let emittedLen = 0;
@@ -42566,8 +43343,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,11 +43394,11 @@ 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, {
-        default: 30,
+        default: 60,
         min: 1
       }),
       ...(() => {
@@ -42695,6 +43482,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 +43503,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 +43515,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);
+          projectInstructions: composed.projectInstructions,
+          emit,
+          onEvent: async (event) => {
             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 === "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;
@@ -43429,9 +44293,31 @@ function pickRootComponent() {
     }
     process.exit(1);
   }
+  if (argv.includes("--fix-budget") || argv.includes("fix-budget")) {
+    const { repairWindowsBudget: repairWindowsBudget2 } = (init_fixBudget(), __toCommonJS(fixBudget_exports));
+    const result = repairWindowsBudget2();
+    const green = "\x1B[32m";
+    const red = "\x1B[31m";
+    const dim = "\x1B[2m";
+    const reset = "\x1B[0m";
+    if (result.ok) {
+      if (result.alreadyOk) {
+        console.log(`${green}\u2714${reset} budget variables already at recommended values (${result.skipped.join(", ")})`);
+      } else {
+        console.log(`${green}\u2714${reset} applied budget variables: ${result.applied.join(", ")}`);
+        if (result.skipped.length > 0) {
+          console.log(`${dim}already set: ${result.skipped.join(", ")}${reset}`);
+        }
+        console.log(`${dim}open a NEW terminal for the changes to take effect${reset}`);
+      }
+      process.exit(0);
+    }
+    console.error(`${red}\u2717${reset} ${result.error}`);
+    process.exit(1);
+  }
   if (argv.includes("--help") || argv.includes("-h")) {
     console.log(
-      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor            Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode agent|council|zelari  Dispatch mode (default: agent)\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --plugins-status    JSON status of optional plugins (Playwright, eslint, \u2026)\n  --plugins-install <id>  Install plugin (playwright also fetches Chromium)\n    --cwd <path>       Workspace for -D installs (default: process.cwd())\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable (required)\n    --args <json>     JSON array of args (optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
+      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor            Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --fix-budget        Set recommended ZELARI_MAX_TOOL_LOOP_HARD=180,\n                      ZELARI_MAX_TOOL_LOOP_ITERATIONS=60, ZELARI_CONTEXT_LIMIT=400000\n                      at User scope (prevents the agent stopping mid-task)\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode agent|council|zelari  Dispatch mode (default: agent)\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --plugins-status    JSON status of optional plugins (Playwright, eslint, \u2026)\n  --plugins-install <id>  Install plugin (playwright also fetches Chromium)\n    --cwd <path>       Workspace for -D installs (default: process.cwd())\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable (required)\n    --args <json>     JSON array of args (optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
     );
     process.exit(0);
   }