@zhuk/spego 0.8.0 → 0.10.1

package/dist/orchestration/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/orchestration/emit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,WAAmB;IAC/D,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,0BAA0B,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACjF,CAAC"}

package/dist/orchestration/engine.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Top-level orchestration entrypoint.
+ *
+ * Reads a named OpenSpec change read-only, then runs the manager → swarm →
+ * verifier pipeline through the OpenCode REST API and returns a structured
+ * outcome. OpenSpec lifecycle state (apply/verify/sync/archive) is never
+ * mutated; only the working tree may change as workers implement sub-tasks.
+ */
+import type { OpenCodeApi } from './client.js';
+import type { ExecutionMode, OrchestrationOutcome } from './types.js';
+export declare const AGENT_MANAGER = "ultramanager";
+export declare const AGENT_WORKER = "ultraworker";
+export declare const AGENT_VERIFIER = "ultraverifier";
+export interface OrchestrateOptions {
+    projectRoot: string;
+    changeName: string;
+    mode?: ExecutionMode;
+    skipVerify?: boolean;
+    /** Inject a backend for testing; defaults to a real {@link OpenCodeClient}. */
+    client?: OpenCodeApi;
+    env?: Record<string, string | undefined>;
+}
+export declare function orchestrateChange(opts: OrchestrateOptions): Promise<OrchestrationOutcome>;

package/dist/orchestration/engine.js

@@ -0,0 +1,136 @@
+/**
+ * Top-level orchestration entrypoint.
+ *
+ * Reads a named OpenSpec change read-only, then runs the manager → swarm →
+ * verifier pipeline through the OpenCode REST API and returns a structured
+ * outcome. OpenSpec lifecycle state (apply/verify/sync/archive) is never
+ * mutated; only the working tree may change as workers implement sub-tasks.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveWorkspacePaths } from '../workspace/paths.js';
+import { readConfig } from '../workspace/config.js';
+import { discoverChanges } from '../delivery/openspec-discover.js';
+import { SpegoError } from '../errors.js';
+import { OpenCodeClient } from './client.js';
+import { resolveOrchestrationConfig, assertModelsConfigured } from './config.js';
+import { ensureWorkDir, saveArtifact, appendLog } from './artifacts.js';
+import { runManager } from './manager.js';
+import { runWorker } from './worker.js';
+import { runVerifier } from './verifier.js';
+import { runSwarm } from './scheduler.js';
+export const AGENT_MANAGER = 'ultramanager';
+export const AGENT_WORKER = 'ultraworker';
+export const AGENT_VERIFIER = 'ultraverifier';
+async function readMaybe(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+async function buildRequirement(projectRoot, relPath) {
+    const dir = path.join(projectRoot, relPath);
+    const proposal = await readMaybe(path.join(dir, 'proposal.md'));
+    const design = await readMaybe(path.join(dir, 'design.md'));
+    const tasks = await readMaybe(path.join(dir, 'tasks.md'));
+    let specSections = '';
+    try {
+        const specsDir = path.join(dir, 'specs');
+        const entries = await fs.readdir(specsDir, { recursive: true });
+        const mdFiles = entries.filter((e) => e.endsWith('.md')).sort();
+        if (mdFiles.length > 0) {
+            const parts = await Promise.all(mdFiles.map(async (f) => {
+                const content = await readMaybe(path.join(specsDir, f));
+                return content.trim()
+                    ? `### ${path.basename(f, '.md')}\n\n${content.trim()}`
+                    : '';
+            }));
+            specSections = parts.filter(Boolean).join('\n\n');
+        }
+    }
+    catch {
+        // specs dir may not exist
+    }
+    return [
+        '# Change requirement',
+        proposal.trim(),
+        design.trim() ? `## Design\n\n${design.trim()}` : '',
+        specSections ? `## Specs\n\n${specSections}` : '',
+        tasks.trim() ? `## Planned tasks\n\n${tasks.trim()}` : '',
+    ]
+        .filter(Boolean)
+        .join('\n\n');
+}
+export async function orchestrateChange(opts) {
+    const projectRoot = path.resolve(opts.projectRoot);
+    const wsPaths = resolveWorkspacePaths(projectRoot);
+    const config = await readConfig(wsPaths.configPath);
+    const rc = resolveOrchestrationConfig(config, opts.env);
+    const changes = await discoverChanges(projectRoot);
+    const change = changes.find((c) => c.name === opts.changeName && !c.archived);
+    if (!change) {
+        throw new SpegoError('CHANGE_NOT_FOUND', `OpenSpec change "${opts.changeName}" not found`, {
+            changeName: opts.changeName,
+        });
+    }
+    assertModelsConfigured(rc);
+    const requirement = await buildRequirement(projectRoot, change.relPath);
+    const workDirAbs = await ensureWorkDir(projectRoot, path.join(rc.workDir, change.name));
+    await saveArtifact(workDirAbs, 'requirement.md', requirement);
+    const client = opts.client ??
+        new OpenCodeClient({ baseUrl: rc.serverUrl, username: rc.username, password: rc.password });
+    await client.health();
+    const breakdown = await runManager(client, {
+        requirement,
+        model: rc.models.manager,
+        agentName: AGENT_MANAGER,
+        workDirAbs,
+    });
+    await appendLog(workDirAbs, `manager: ${breakdown.subtasks.length} sub-tasks (mode=${breakdown.executionMode})`);
+    const swarm = await runSwarm(breakdown, {
+        mode: opts.mode,
+        maxParallel: rc.maxParallel,
+        runTask: (task) => runWorker(client, task, breakdown, {
+            model: rc.models.worker,
+            agentName: AGENT_WORKER,
+            projectRoot,
+            workDirAbs,
+        }),
+    });
+    for (const warning of swarm.warnings)
+        await appendLog(workDirAbs, `warning: ${warning}`);
+    let verdict;
+    if (opts.skipVerify) {
+        verdict = {
+            passed: swarm.results.every((r) => r.success),
+            testOutput: '',
+            failingCriteria: [],
+            regressions: [],
+            notes: 'Verification skipped.',
+            skipped: true,
+        };
+        await saveArtifact(workDirAbs, 'verdict.json', verdict);
+    }
+    else {
+        verdict = await runVerifier(client, breakdown, swarm.results, {
+            model: rc.models.verifier,
+            agentName: AGENT_VERIFIER,
+            workDirAbs,
+        });
+    }
+    const tasksSucceeded = swarm.results.filter((r) => r.success).length;
+    await appendLog(workDirAbs, `done: ${tasksSucceeded}/${swarm.results.length} succeeded; verdict=${verdict.passed ? 'PASS' : 'FAIL'}`);
+    return {
+        changeName: change.name,
+        goal: breakdown.goal,
+        executionMode: opts.mode ?? breakdown.executionMode,
+        tasksTotal: swarm.results.length,
+        tasksSucceeded,
+        results: swarm.results,
+        verdict,
+        warnings: swarm.warnings,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/orchestration/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/orchestration/engine.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/file-gate.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Per-task file gate.
+ *
+ * Each worker may persist edits only to the files listed in its sub-task
+ * allow-list. Anything outside the list is reverted and the sub-task is
+ * marked failed. Detection is pure (and unit-tested); reverting is delegated
+ * to an injected callback so the policy stays decoupled from git/fs IO.
+ */
+/** Return the changed paths that fall outside the allow-list. */
+export declare function detectFileGateViolations(changedPaths: string[], allowed: string[]): string[];
+export interface FileGateResult {
+    violations: string[];
+}
+/** Detect violations, revert each one through the supplied callback, and report them. */
+export declare function enforceFileGate(opts: {
+    changedPaths: string[];
+    allowed: string[];
+    revert: (path: string) => Promise<void> | void;
+}): Promise<FileGateResult>;

package/dist/orchestration/file-gate.js

@@ -0,0 +1,25 @@
+/**
+ * Per-task file gate.
+ *
+ * Each worker may persist edits only to the files listed in its sub-task
+ * allow-list. Anything outside the list is reverted and the sub-task is
+ * marked failed. Detection is pure (and unit-tested); reverting is delegated
+ * to an injected callback so the policy stays decoupled from git/fs IO.
+ */
+function normalizePath(p) {
+    return p.replace(/^\.\//, '').replace(/\\/g, '/').replace(/^\/+/, '');
+}
+/** Return the changed paths that fall outside the allow-list. */
+export function detectFileGateViolations(changedPaths, allowed) {
+    const allow = new Set(allowed.map(normalizePath));
+    return changedPaths.filter((p) => !allow.has(normalizePath(p)));
+}
+/** Detect violations, revert each one through the supplied callback, and report them. */
+export async function enforceFileGate(opts) {
+    const violations = detectFileGateViolations(opts.changedPaths, opts.allowed);
+    for (const violation of violations) {
+        await opts.revert(violation);
+    }
+    return { violations };
+}
+//# sourceMappingURL=file-gate.js.map

package/dist/orchestration/file-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-gate.js","sourceRoot":"","sources":["../../src/orchestration/file-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,SAAS,aAAa,CAAC,CAAS;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,wBAAwB,CAAC,YAAsB,EAAE,OAAiB;IAChF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAMD,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAIrC;IACC,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

package/dist/orchestration/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Public surface for the ultracode multi-agent orchestration capability.
+ */
+export { orchestrateChange, AGENT_MANAGER, AGENT_WORKER, AGENT_VERIFIER } from './engine.js';
+export type { OrchestrateOptions } from './engine.js';
+export { OpenCodeClient, extractText } from './client.js';
+export type { OpenCodeApi, OpenCodeClientOptions, SendMessageInput, OpenCodeMessageResponse } from './client.js';
+export { resolveOrchestrationConfig, assertModelsConfigured } from './config.js';
+export { parseBreakdown, stripJsonFences } from './schema.js';
+export { buildDependencyTiers } from './tiers.js';
+export type { DependencyTiers } from './tiers.js';
+export { runSwarm } from './scheduler.js';
+export type { SwarmOptions, SwarmOutcome } from './scheduler.js';
+export { detectFileGateViolations, enforceFileGate } from './file-gate.js';
+export type { FileGateResult } from './file-gate.js';
+export { ORCHESTRATION_AGENT_ASSETS } from './agents.js';
+export type { OrchestrationAsset } from './agents.js';
+export type { ExecutionMode, SubTask, TaskBreakdown, SubtaskResult, Verdict, OrchestrationModels, OrchestrationRuntimeConfig, OrchestrationOutcome, } from './types.js';

package/dist/orchestration/index.js

@@ -0,0 +1,12 @@
+/**
+ * Public surface for the ultracode multi-agent orchestration capability.
+ */
+export { orchestrateChange, AGENT_MANAGER, AGENT_WORKER, AGENT_VERIFIER } from './engine.js';
+export { OpenCodeClient, extractText } from './client.js';
+export { resolveOrchestrationConfig, assertModelsConfigured } from './config.js';
+export { parseBreakdown, stripJsonFences } from './schema.js';
+export { buildDependencyTiers } from './tiers.js';
+export { runSwarm } from './scheduler.js';
+export { detectFileGateViolations, enforceFileGate } from './file-gate.js';
+export { ORCHESTRATION_AGENT_ASSETS } from './agents.js';
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

package/dist/orchestration/manager.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Manager step: send the requirement to the manager agent, validate the
+ * returned breakdown against the schema, persist it, and return the model.
+ */
+import type { OpenCodeApi } from './client.js';
+import type { TaskBreakdown } from './types.js';
+export interface ManagerOptions {
+    requirement: string;
+    model: string;
+    agentName: string;
+    workDirAbs: string;
+}
+export declare function runManager(api: OpenCodeApi, opts: ManagerOptions): Promise<TaskBreakdown>;

package/dist/orchestration/manager.js

@@ -0,0 +1,26 @@
+/**
+ * Manager step: send the requirement to the manager agent, validate the
+ * returned breakdown against the schema, persist it, and return the model.
+ */
+import { extractText } from './client.js';
+import { parseBreakdown } from './schema.js';
+import { MANAGER_SYSTEM_PROMPT } from './prompts.js';
+import { saveArtifact } from './artifacts.js';
+export async function runManager(api, opts) {
+    const session = await api.createSession('spego-orchestrate-manager');
+    try {
+        const response = await api.sendMessage(session.id, {
+            text: opts.requirement,
+            model: opts.model,
+            agent: opts.agentName,
+            system: MANAGER_SYSTEM_PROMPT,
+        });
+        const breakdown = parseBreakdown(extractText(response));
+        await saveArtifact(opts.workDirAbs, 'breakdown.json', breakdown);
+        return breakdown;
+    }
+    finally {
+        await api.deleteSession(session.id).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/orchestration/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/orchestration/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAU9C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAgB,EAAE,IAAoB;IACrE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,2BAA2B,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE;YACjD,IAAI,EAAE,IAAI,CAAC,WAAW;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,SAAS;YACrB,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxD,MAAM,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;QACjE,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/orchestration/prompts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * System prompts for the orchestration agents, ported from the ultracode
+ * reference implementation. The manager emits a strict snake_case JSON
+ * contract; the worker reports a status marker; the verifier emits a verdict.
+ */
+import type { SubTask, TaskBreakdown } from './types.js';
+export declare const MANAGER_SYSTEM_PROMPT = "You are UltraManager, a senior software architect responsible for decomposing a coding task into precise, parallelisable sub-tasks.\n\nOutput ONLY valid JSON matching this schema \u2014 no prose, no markdown fences:\n{\n  \"goal\": \"<one sentence>\",\n  \"context_summary\": \"<=200 words summarising relevant codebase context>\",\n  \"execution_mode\": \"sequential\" | \"parallel\" | \"adaptive\",\n  \"test_command\": \"<shell command to run the full test suite>\",\n  \"language\": \"<primary language>\",\n  \"subtasks\": [\n    {\n      \"id\": \"<snake_case unique id>\",\n      \"title\": \"<=60 chars>\",\n      \"description\": \"<clear implementation instructions>\",\n      \"files\": [\"<relative paths the worker may modify>\"],\n      \"acceptance_criteria\": [\"<verifiable criterion>\"],\n      \"depends_on\": [\"<other subtask id>\"],\n      \"priority\": 0\n    }\n  ]\n}\n\nRules:\n- Each subtask must be self-contained enough to be implemented in one agent session.\n- Minimise cross-task file overlap to allow safe parallel execution.\n- If tasks share files, list them as depends_on (sequential chain).\n- acceptance_criteria must be executable assertions, not vague goals.\n- Do NOT include any text outside the JSON object.";
+export declare const VERIFIER_SYSTEM_PROMPT = "You are UltraVerifier, a QA agent responsible for final validation.\nYou will receive a JSON summary of all completed sub-tasks and their changed files.\nYour job:\n1. Run the full test suite using the provided test command.\n2. Check that every acceptance criterion is satisfied.\n3. Report any regressions or missing criteria.\n4. Output ONLY a structured JSON verdict (no prose, no fences):\n{\n  \"passed\": true | false,\n  \"test_output\": \"<truncated stdout>\",\n  \"failing_criteria\": [\"<criterion text>\"],\n  \"regressions\": [\"<regression description>\"],\n  \"notes\": \"<optional free text>\"\n}";
+export declare function renderWorkerPrompt(task: SubTask, breakdown: TaskBreakdown): string;
+export declare function renderVerifierPrompt(payload: unknown): string;

package/dist/orchestration/prompts.js

@@ -0,0 +1,71 @@
+/**
+ * System prompts for the orchestration agents, ported from the ultracode
+ * reference implementation. The manager emits a strict snake_case JSON
+ * contract; the worker reports a status marker; the verifier emits a verdict.
+ */
+export const MANAGER_SYSTEM_PROMPT = `You are UltraManager, a senior software architect responsible for decomposing a coding task into precise, parallelisable sub-tasks.
+
+Output ONLY valid JSON matching this schema — no prose, no markdown fences:
+{
+  "goal": "<one sentence>",
+  "context_summary": "<=200 words summarising relevant codebase context>",
+  "execution_mode": "sequential" | "parallel" | "adaptive",
+  "test_command": "<shell command to run the full test suite>",
+  "language": "<primary language>",
+  "subtasks": [
+    {
+      "id": "<snake_case unique id>",
+      "title": "<=60 chars>",
+      "description": "<clear implementation instructions>",
+      "files": ["<relative paths the worker may modify>"],
+      "acceptance_criteria": ["<verifiable criterion>"],
+      "depends_on": ["<other subtask id>"],
+      "priority": 0
+    }
+  ]
+}
+
+Rules:
+- Each subtask must be self-contained enough to be implemented in one agent session.
+- Minimise cross-task file overlap to allow safe parallel execution.
+- If tasks share files, list them as depends_on (sequential chain).
+- acceptance_criteria must be executable assertions, not vague goals.
+- Do NOT include any text outside the JSON object.`;
+export const VERIFIER_SYSTEM_PROMPT = `You are UltraVerifier, a QA agent responsible for final validation.
+You will receive a JSON summary of all completed sub-tasks and their changed files.
+Your job:
+1. Run the full test suite using the provided test command.
+2. Check that every acceptance criterion is satisfied.
+3. Report any regressions or missing criteria.
+4. Output ONLY a structured JSON verdict (no prose, no fences):
+{
+  "passed": true | false,
+  "test_output": "<truncated stdout>",
+  "failing_criteria": ["<criterion text>"],
+  "regressions": ["<regression description>"],
+  "notes": "<optional free text>"
+}`;
+export function renderWorkerPrompt(task, breakdown) {
+    return `You are UltraWorker, a focused implementation agent.
+You will implement a single sub-task precisely.
+
+Codebase context:
+${breakdown.contextSummary}
+
+Task spec (JSON):
+${JSON.stringify(task, null, 2)}
+
+Rules:
+- Modify ONLY the files listed in the \`files\` array.
+- After implementing, run the test command to verify your changes:
+    ${breakdown.testCommand || '(no test command provided)'}
+- If tests fail, fix them (max 3 attempts) before reporting done.
+- End your final message with exactly:
+    ULTRAWORKER_STATUS: SUCCESS
+  or
+    ULTRAWORKER_STATUS: FAILED - <reason>`;
+}
+export function renderVerifierPrompt(payload) {
+    return `Here is the multi-agent execution summary. Run the test suite and emit your verdict JSON.\n\n${JSON.stringify(payload, null, 2)}`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/orchestration/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/orchestration/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;mDA2Bc,CAAC;AAEpD,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;EAapC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,IAAa,EAAE,SAAwB;IACxE,OAAO;;;;EAIP,SAAS,CAAC,cAAc;;;EAGxB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;MAKzB,SAAS,CAAC,WAAW,IAAI,4BAA4B;;;;;0CAKjB,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO,gGAAgG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAC5I,CAAC"}

package/dist/orchestration/scheduler.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Swarm scheduler. Executes sub-tasks in `sequential`, `parallel`, or
+ * `adaptive` mode, honoring `dependsOn` edges and bounding concurrency.
+ *
+ * The actual per-task work is injected via `runTask`, keeping the scheduler
+ * free of any OpenCode/IO coupling and trivially unit-testable.
+ */
+import type { ExecutionMode, SubTask, SubtaskResult, TaskBreakdown } from './types.js';
+export interface SwarmOptions {
+    mode?: ExecutionMode;
+    maxParallel: number;
+    runTask: (task: SubTask) => Promise<SubtaskResult>;
+}
+export interface SwarmOutcome {
+    results: SubtaskResult[];
+    warnings: string[];
+}
+export declare function runSwarm(breakdown: TaskBreakdown, opts: SwarmOptions): Promise<SwarmOutcome>;

package/dist/orchestration/scheduler.js

@@ -0,0 +1,49 @@
+/**
+ * Swarm scheduler. Executes sub-tasks in `sequential`, `parallel`, or
+ * `adaptive` mode, honoring `dependsOn` edges and bounding concurrency.
+ *
+ * The actual per-task work is injected via `runTask`, keeping the scheduler
+ * free of any OpenCode/IO coupling and trivially unit-testable.
+ */
+import { buildDependencyTiers } from './tiers.js';
+async function mapWithConcurrency(items, limit, fn) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const workerCount = Math.max(1, Math.min(limit, items.length));
+    const workers = Array.from({ length: workerCount }, async () => {
+        while (cursor < items.length) {
+            const index = cursor++;
+            const item = items[index];
+            if (item === undefined)
+                continue;
+            results[index] = await fn(item);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+export async function runSwarm(breakdown, opts) {
+    const mode = opts.mode ?? breakdown.executionMode;
+    const tasks = [...breakdown.subtasks].sort((a, b) => a.priority - b.priority);
+    const warnings = [];
+    const { tiers, hadCycle } = buildDependencyTiers(tasks);
+    if (hadCycle) {
+        warnings.push('Dependency cycle detected — affected sub-tasks ran sequentially');
+    }
+    if (mode === 'sequential') {
+        const ordered = tiers.flat();
+        const results = [];
+        for (const task of ordered) {
+            results.push(await opts.runTask(task));
+        }
+        return { results, warnings };
+    }
+    // parallel + adaptive: run dependency tiers sequentially, parallel within each tier.
+    const results = [];
+    for (const tier of tiers) {
+        const tierResults = await mapWithConcurrency(tier, opts.maxParallel, opts.runTask);
+        results.push(...tierResults);
+    }
+    return { results, warnings };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/orchestration/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/orchestration/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAclD,KAAK,UAAU,kBAAkB,CAC/B,KAAU,EACV,KAAa,EACb,EAA2B;IAE3B,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,IAAI,EAAE;QAC7D,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAS;YACjC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAwB,EAAE,IAAkB;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,aAAa,CAAC;IAClD,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,qFAAqF;IACrF,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/orchestration/schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Schema validation and parsing for the manager's TaskBreakdown contract.
+ *
+ * The manager is instructed to emit snake_case JSON. This module strips any
+ * markdown code fences, parses the JSON, validates it against a zod schema,
+ * and normalizes it into the camelCase {@link TaskBreakdown} model.
+ */
+import type { TaskBreakdown } from './types.js';
+/** Remove a leading/trailing ```json … ``` markdown fence if present. */
+export declare function stripJsonFences(text: string): string;
+/** Parse and validate raw manager output into a {@link TaskBreakdown}. */
+export declare function parseBreakdown(raw: string): TaskBreakdown;

package/dist/orchestration/schema.js

@@ -0,0 +1,78 @@
+/**
+ * Schema validation and parsing for the manager's TaskBreakdown contract.
+ *
+ * The manager is instructed to emit snake_case JSON. This module strips any
+ * markdown code fences, parses the JSON, validates it against a zod schema,
+ * and normalizes it into the camelCase {@link TaskBreakdown} model.
+ */
+import { z } from 'zod';
+import { SpegoError } from '../errors.js';
+const subTaskSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string().default(''),
+    description: z.string().default(''),
+    files: z.array(z.string()).default([]),
+    acceptance_criteria: z.array(z.string()).default([]),
+    depends_on: z.array(z.string()).default([]),
+    priority: z.number().int().default(0),
+    model_override: z.string().optional(),
+})
+    .transform((s) => ({
+    id: s.id,
+    title: s.title,
+    description: s.description,
+    files: s.files,
+    acceptanceCriteria: s.acceptance_criteria,
+    dependsOn: s.depends_on,
+    priority: s.priority,
+    modelOverride: s.model_override,
+}));
+const breakdownSchema = z
+    .object({
+    goal: z.string().min(1),
+    context_summary: z.string().default(''),
+    execution_mode: z.enum(['sequential', 'parallel', 'adaptive']).default('adaptive'),
+    test_command: z.string().default(''),
+    language: z.string().default('unknown'),
+    subtasks: z.array(subTaskSchema).min(1),
+})
+    .transform((b) => ({
+    goal: b.goal,
+    contextSummary: b.context_summary,
+    executionMode: b.execution_mode,
+    testCommand: b.test_command,
+    language: b.language,
+    subtasks: b.subtasks,
+}));
+/** Remove a leading/trailing ```json … ``` markdown fence if present. */
+export function stripJsonFences(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('```'))
+        return trimmed;
+    const lines = trimmed.split('\n');
+    const inner = lines[lines.length - 1]?.startsWith('```') ? lines.slice(1, -1) : lines.slice(1);
+    return inner.join('\n').trim();
+}
+/** Parse and validate raw manager output into a {@link TaskBreakdown}. */
+export function parseBreakdown(raw) {
+    const stripped = stripJsonFences(raw);
+    let data;
+    try {
+        data = JSON.parse(stripped);
+    }
+    catch (err) {
+        throw new SpegoError('ORCHESTRATION_INVALID_BREAKDOWN', 'Manager returned non-JSON output', {
+            cause: err.message,
+            raw: raw.slice(0, 500),
+        });
+    }
+    const parsed = breakdownSchema.safeParse(data);
+    if (!parsed.success) {
+        throw new SpegoError('ORCHESTRATION_INVALID_BREAKDOWN', 'Manager breakdown failed schema validation', {
+            issues: parsed.error.issues,
+        });
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=schema.js.map

package/dist/orchestration/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/orchestration/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjB,EAAE,EAAE,CAAC,CAAC,EAAE;IACR,KAAK,EAAE,CAAC,CAAC,KAAK;IACd,WAAW,EAAE,CAAC,CAAC,WAAW;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;IACd,kBAAkB,EAAE,CAAC,CAAC,mBAAmB;IACzC,SAAS,EAAE,CAAC,CAAC,UAAU;IACvB,QAAQ,EAAE,CAAC,CAAC,QAAQ;IACpB,aAAa,EAAE,CAAC,CAAC,cAAc;CAChC,CAAC,CAAC,CAAC;AAEN,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAClF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACxC,CAAC;KACD,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC,IAAI;IACZ,cAAc,EAAE,CAAC,CAAC,eAAe;IACjC,aAAa,EAAE,CAAC,CAAC,cAAc;IAC/B,WAAW,EAAE,CAAC,CAAC,YAAY;IAC3B,QAAQ,EAAE,CAAC,CAAC,QAAQ;IACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;CACrB,CAAC,CAAC,CAAC;AAEN,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,iCAAiC,EAAE,kCAAkC,EAAE;YAC1F,KAAK,EAAG,GAAa,CAAC,OAAO;YAC7B,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACvB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,UAAU,CAAC,iCAAiC,EAAE,4CAA4C,EAAE;YACpG,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/orchestration/tiers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dependency-tier construction for the swarm scheduler.
+ *
+ * Uses Kahn's algorithm to group sub-tasks into tiers: tasks within a tier
+ * have no dependency on one another and can run in parallel. When a cycle is
+ * detected, the remaining tasks are emitted as single-task tiers so they run
+ * sequentially rather than concurrently.
+ */
+import type { SubTask } from './types.js';
+export interface DependencyTiers {
+    tiers: SubTask[][];
+    hadCycle: boolean;
+}
+export declare function buildDependencyTiers(tasks: SubTask[]): DependencyTiers;