zelari-code 0.7.5 → 0.7.9

package/dist/cli/workspace/postCouncilHook.js

@@ -1,38 +1,175 @@
 /**
  * workspace/postCouncilHook.ts — Run the AGENTS.MD auto-maintenance
- * after every council run completes.
+ * after every council run completes, then run the deterministic
+ * complete-design post-processor for design-phase workspaces.
  *
- * Used by `councilDispatcher` (Phase 4 wiring) to keep AGENTS.MD in sync
- * with the latest `.zelari/` artifacts.
+ * Used by `councilDispatcher` (Phase 4 wiring) to keep AGENTS.MD in
+ * sync with the latest `.zelari/` artifacts and to guarantee that
+ * tasks/milestones are present even when the council model (e.g.
+ * composer-2.5) refuses to emit createTask/createMilestone as real
+ * tool calls.
  */
-import { updateAgentsMd } from './agentsMd.js';
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { updateAgentsMd } from "./agentsMd.js";
+import { runBuiltinCompleteDesign } from "./completeDesign.js";
 /**
- * Run the post-council AGENTS.MD maintenance hook.
- * Returns info about what happened so the CLI can show a one-line summary
- * to the user (e.g. "AGENTS.MD updated: 2 sections changed (decisions, conventions)").
+ * v0.7.7 Opzione B / v0.7.8 — Run the deterministic complete-design
+ * post-processor if the workspace is in design-phase (`.zelari/plan.json`
+ * exists with at least one phase).
  *
- * Respects `ZELARI_AGENTS_MD=0` env var to opt out.
+ * Resolution order:
+ *   1. A workspace-local `complete-design.mjs` at the project root wins
+ *      (curated, domain-specific task templates) and is spawned as a
+ *      child process.
+ *   2. Otherwise (v0.7.8) the built-in TypeScript fallback runs: it
+ *      derives 3 tasks per phase from the REAL phases in plan.json and
+ *      guarantees a milestone — versioned with the codebase, no per-
+ *      workspace setup, immune to phase-ID drift.
+ *
+ * Errors are captured, never thrown — the post-processor is a
+ * best-effort safety net.
+ *
+ * Disabled by setting `ZELARI_COMPLETE_DESIGN=0` in the environment.
  */
-export async function runPostCouncilHook(ctx) {
-    if (process.env['ZELARI_AGENTS_MD'] === '0') {
-        return { ran: false, changed: false, sections: [], reason: 'ZELARI_AGENTS_MD=0 (disabled)' };
-    }
-    try {
-        const result = await updateAgentsMd(ctx, ctx.projectRoot);
+export async function runCompleteDesignPostProcessor(ctx, options) {
+    if (options?.runMode === "implementation") {
         return {
-            ran: true,
-            changed: result.changed,
-            sections: result.sections,
-            ...(result.reason ? { reason: result.reason } : {}),
+            ran: false,
+            reason: "implementation mode (complete-design skipped)",
         };
     }
-    catch (err) {
+    if (process.env["ZELARI_COMPLETE_DESIGN"] === "0") {
+        return { ran: false, reason: "ZELARI_COMPLETE_DESIGN=0 (disabled)" };
+    }
+    const planJsonPath = join(ctx.rootDir, "plan.json");
+    const scriptPath = join(ctx.projectRoot, "complete-design.mjs");
+    if (!existsSync(planJsonPath)) {
         return {
+            ran: false,
+            reason: ".zelari/plan.json missing (not design-phase)",
+        };
+    }
+    let phaseCount = 0;
+    try {
+        const parsed = JSON.parse(readFileSync(planJsonPath, "utf8"));
+        phaseCount = Array.isArray(parsed.phases) ? parsed.phases.length : 0;
+    }
+    catch {
+        return { ran: false, reason: ".zelari/plan.json corrupt" };
+    }
+    if (phaseCount === 0) {
+        return { ran: false, reason: ".zelari/plan.json has no phases" };
+    }
+    if (!existsSync(scriptPath)) {
+        // v0.7.8: no workspace script → run the built-in deterministic
+        // fallback instead of skipping. Same guarantees (≥3 tasks per phase,
+        // ≥1 milestone), zero per-workspace setup.
+        try {
+            const builtin = await runBuiltinCompleteDesign(ctx);
+            return {
+                ran: builtin.ran,
+                ...(builtin.ran ? { exitCode: 0 } : {}),
+                output: `builtin complete-design: +${builtin.tasksAdded} tasks, +${builtin.milestonesAdded} milestones`,
+                ...(builtin.reason ? { reason: builtin.reason } : {}),
+            };
+        }
+        catch (err) {
+            return {
+                ran: true,
+                exitCode: -1,
+                reason: `builtin complete-design error: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    return await new Promise((resolveRun) => {
+        const child = spawn(process.execPath, [scriptPath], {
+            cwd: ctx.projectRoot,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: process.env,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", (err) => {
+            resolveRun({
+                ran: true,
+                exitCode: -1,
+                output: stderr,
+                reason: `spawn error: ${err.message}`,
+            });
+        });
+        child.on("close", (code) => {
+            const exitCode = code ?? -1;
+            const ok = exitCode === 0;
+            resolveRun({
+                ran: true,
+                exitCode,
+                output: stdout + stderr,
+                ...(ok
+                    ? {}
+                    : { reason: `complete-design exited with code ${exitCode}` }),
+            });
+        });
+    });
+}
+/**
+ * Run the post-council hook pipeline:
+ *   1. AGENTS.MD auto-maintenance (can be skipped via ZELARI_AGENTS_MD=0).
+ *   2. complete-design post-processor (design-phase only, can be skipped
+ *      via ZELARI_COMPLETE_DESIGN=0).
+ *
+ * The `completeDesign` field carries the secondary result so the CLI can
+ * surface it ("complete-design: 12 tasks + 1 milestone added"). The
+ * primary `changed`/`sections` reflect the AGENTS.MD step only.
+ *
+ * Errors from either step are caught and reported in the result — the
+ * hook never throws.
+ */
+export async function runPostCouncilHook(ctx, options) {
+    // ── Step 1: AGENTS.MD maintenance ─────────────────────────────────────
+    let agentsMdResult;
+    if (process.env["ZELARI_AGENTS_MD"] === "0") {
+        agentsMdResult = {
             ran: false,
             changed: false,
             sections: [],
-            reason: `error: ${err instanceof Error ? err.message : String(err)}`,
+            reason: "ZELARI_AGENTS_MD=0 (disabled)",
         };
     }
+    else {
+        try {
+            const result = await updateAgentsMd(ctx, ctx.projectRoot);
+            agentsMdResult = {
+                ran: true,
+                changed: result.changed,
+                sections: result.sections,
+                ...(result.reason ? { reason: result.reason } : {}),
+            };
+        }
+        catch (err) {
+            agentsMdResult = {
+                ran: false,
+                changed: false,
+                sections: [],
+                reason: `error: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    // ── Step 2: complete-design post-processor ───────────────────────────
+    const completeDesign = await runCompleteDesignPostProcessor(ctx, options);
+    return {
+        ran: agentsMdResult.ran || completeDesign.ran,
+        changed: agentsMdResult.changed,
+        sections: agentsMdResult.sections,
+        ...(agentsMdResult.reason ? { reason: agentsMdResult.reason } : {}),
+        completeDesign,
+    };
 }
 //# sourceMappingURL=postCouncilHook.js.map

package/dist/cli/workspace/postCouncilHook.js.map

@@ -1 +1 @@
-{"version":3,"file":"postCouncilHook.js","sourceRoot":"","sources":["../../../src/cli/workspace/postCouncilHook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAU/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAqB;IAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,GAAG,EAAE,CAAC;QAC5C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;IAC/F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1D,OAAO;YACL,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,GAAG,EAAE,KAAK;YACV,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACrE,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"postCouncilHook.js","sourceRoot":"","sources":["../../../src/cli/workspace/postCouncilHook.ts"],"names":[],"mappings":"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"}