oh-my-codex-pennix 0.18.13

package/dist/pipeline/stages/team-exec.js

@@ -0,0 +1,266 @@
+/**
+ * Team execution stage adapter for pipeline orchestrator.
+ *
+ * Wraps the existing team mode (tmux-based Codex CLI workers) into a
+ * PipelineStage. The execution backend is always teams — this is the
+ * canonical OMX execution surface.
+ */
+import { basename, dirname, isAbsolute, join, normalize, relative, resolve } from 'node:path';
+import { buildRepoAwareTeamExecutionPlan } from '../../team/repo-aware-decomposition.js';
+import { buildTeamExecutionPlan, parseTeamArgs } from '../../cli/team.js';
+import { buildFollowupStaffingPlan, resolveAvailableAgentTypes, } from '../../team/followup-planner.js';
+import { readApprovedExecutionLaunchHintOutcome, readPlanningArtifacts, } from '../../planning/artifacts.js';
+import { buildApprovedTeamExecutionBinding, } from '../../team/approved-execution.js';
+import { packageRoot, sameFilePath } from '../../utils/paths.js';
+function resolveRequestedTask(ctx, ralplanArtifacts) {
+    const ralplanTask = typeof ralplanArtifacts?.task === 'string' ? ralplanArtifacts.task.trim() : '';
+    return ralplanTask || ctx.task;
+}
+function normalizePlanningRelativePath(rawPath) {
+    const trimmed = rawPath.trim().replace(/^`|`$/g, '').replace(/\\/g, '/');
+    const withoutDotPrefix = trimmed.startsWith('./') ? trimmed.slice(2) : trimmed;
+    return normalize(withoutDotPrefix).replace(/\\/g, '/');
+}
+function planningArtifactSlug(path, prefixPattern) {
+    const file = basename(path);
+    const match = file.match(prefixPattern);
+    return match?.groups?.slug ?? null;
+}
+function matchingTestSpecPathsForPrd(artifacts, prdPath) {
+    const prdSlug = planningArtifactSlug(prdPath, /^prd-(?<slug>.*)\.md$/i);
+    if (!prdSlug)
+        return [];
+    return artifacts.testSpecPaths.filter((testSpecPath) => planningArtifactSlug(testSpecPath, /^test-?spec-(?<slug>.*)\.md$/i) === prdSlug);
+}
+function resolvePlanningPrdPath(artifacts, cwd, rawPath) {
+    const normalizedRawPath = rawPath.trim();
+    if (isAbsolute(normalizedRawPath)) {
+        const resolvedPath = resolve(normalizedRawPath);
+        const matchedPath = artifacts.prdPaths.find((candidatePath) => sameFilePath(candidatePath, resolvedPath)) ?? null;
+        return { matchedPath, fallbackPath: resolvedPath };
+    }
+    const repoRoot = dirname(dirname(artifacts.plansDir));
+    const normalizedPath = normalizePlanningRelativePath(normalizedRawPath);
+    const resolvedPath = resolve(cwd, normalizedPath);
+    const matchedPath = artifacts.prdPaths.find((candidatePath) => {
+        const artifactPath = normalizePlanningRelativePath(candidatePath);
+        const repoRelativePath = normalizePlanningRelativePath(relative(repoRoot, candidatePath));
+        const plansRelativePath = normalizePlanningRelativePath(relative(artifacts.plansDir, candidatePath));
+        return normalizedPath === artifactPath
+            || normalizedPath === repoRelativePath
+            || normalizedPath === plansRelativePath;
+    }) ?? artifacts.prdPaths.find((candidatePath) => sameFilePath(candidatePath, resolvedPath)) ?? null;
+    return {
+        matchedPath,
+        fallbackPath: resolvedPath,
+    };
+}
+function readRuntimeLatestPlanningSelection(artifacts, cwd, ralplanArtifacts) {
+    const drafts = Array.isArray(ralplanArtifacts?.drafts) ? ralplanArtifacts.drafts : [];
+    for (let index = drafts.length - 1; index >= 0; index -= 1) {
+        const draft = drafts[index];
+        if (!draft || typeof draft !== 'object')
+            continue;
+        const draftRecord = draft;
+        const draftPlanPath = typeof draftRecord.planPath === 'string'
+            ? draftRecord.planPath.trim()
+            : '';
+        if (!draftPlanPath)
+            continue;
+        const resolvedDraftPlanPath = resolvePlanningPrdPath(artifacts, cwd, draftPlanPath).matchedPath;
+        const testSpecPaths = resolvedDraftPlanPath ? matchingTestSpecPathsForPrd(artifacts, resolvedDraftPlanPath) : [];
+        if (!resolvedDraftPlanPath || testSpecPaths.length === 0)
+            continue;
+        return {
+            prdPath: resolvedDraftPlanPath,
+            testSpecPaths,
+        };
+    }
+    return null;
+}
+function readLatestApprovedPlanningSelection(artifacts) {
+    for (let index = artifacts.prdPaths.length - 1; index >= 0; index -= 1) {
+        const prdPath = artifacts.prdPaths[index];
+        const testSpecPaths = matchingTestSpecPathsForPrd(artifacts, prdPath);
+        if (testSpecPaths.length > 0) {
+            return { prdPath, testSpecPaths };
+        }
+    }
+    return { prdPath: null, testSpecPaths: [] };
+}
+function resolveApprovedTeamPlanPath(cwd, latestPlanPath, ralplanArtifacts) {
+    const artifacts = readPlanningArtifacts(cwd);
+    const resolvedLatestPlanPath = resolvePlanningPrdPath(artifacts, cwd, latestPlanPath);
+    const latestPlanTestSpecPaths = resolvedLatestPlanPath.matchedPath
+        ? matchingTestSpecPathsForPrd(artifacts, resolvedLatestPlanPath.matchedPath)
+        : [];
+    if (!resolvedLatestPlanPath.matchedPath) {
+        throw new Error(`team_exec_approved_handoff_missing:${resolvedLatestPlanPath.fallbackPath}`);
+    }
+    if (latestPlanTestSpecPaths.length === 0) {
+        return resolvedLatestPlanPath.matchedPath;
+    }
+    const selection = readRuntimeLatestPlanningSelection(artifacts, cwd, ralplanArtifacts)
+        ?? readLatestApprovedPlanningSelection(artifacts);
+    const selectedPrdPath = selection.prdPath
+        ? resolvePlanningPrdPath(artifacts, cwd, selection.prdPath).matchedPath
+        : null;
+    if (!selectedPrdPath) {
+        throw new Error(`team_exec_approved_handoff_missing:${resolvedLatestPlanPath.fallbackPath}`);
+    }
+    if (selectedPrdPath !== resolvedLatestPlanPath.matchedPath) {
+        throw new Error(`team_exec_approved_handoff_stale:${resolvedLatestPlanPath.matchedPath}:${selectedPrdPath}`);
+    }
+    return selectedPrdPath;
+}
+function resolveApprovedTeamLaunchFromPlanPath(cwd, latestPlanPath, ralplanArtifacts) {
+    const approvedPlanPath = resolveApprovedTeamPlanPath(cwd, latestPlanPath, ralplanArtifacts);
+    const approvedHintOutcome = readApprovedExecutionLaunchHintOutcome(cwd, 'team', {
+        prdPath: approvedPlanPath,
+    });
+    if (approvedHintOutcome.status === 'ambiguous') {
+        throw new Error(`team_exec_approved_handoff_ambiguous:${approvedPlanPath}`);
+    }
+    if (approvedHintOutcome.status !== 'resolved') {
+        throw new Error(`team_exec_approved_handoff_missing:${approvedPlanPath}`);
+    }
+    return {
+        task: approvedHintOutcome.hint.task,
+        approvedExecution: buildApprovedTeamExecutionBinding(approvedHintOutcome.hint),
+    };
+}
+function resolveTeamExecLaunch(ctx, ralplanArtifacts) {
+    const requestedTask = resolveRequestedTask(ctx, ralplanArtifacts);
+    const latestPlanPath = typeof ralplanArtifacts?.latestPlanPath === 'string'
+        ? ralplanArtifacts.latestPlanPath.trim()
+        : '';
+    if (!latestPlanPath) {
+        return { task: requestedTask, approvedExecution: null };
+    }
+    return resolveApprovedTeamLaunchFromPlanPath(ctx.cwd, latestPlanPath, ralplanArtifacts);
+}
+function quotePosixShellArg(value) {
+    return `'${value.replace(/'/g, `'\"'\"'`)}'`;
+}
+function quoteWindowsCmdArg(value) {
+    return `"${value.replace(/%/g, '%%').replace(/"/g, '""')}"`;
+}
+function quoteShellArg(value, platform) {
+    return platform === 'win32' ? quoteWindowsCmdArg(value) : quotePosixShellArg(value);
+}
+function buildTeamRuntimeCliLaunchInput(descriptor) {
+    const parsed = parseTeamArgs([`${descriptor.workerCount}:${descriptor.agentType}`, descriptor.task], descriptor.cwd);
+    const executionPlan = buildRepoAwareTeamExecutionPlan({
+        task: parsed.task,
+        workerCount: parsed.workerCount,
+        agentType: parsed.agentType,
+        explicitAgentType: parsed.explicitAgentType,
+        explicitWorkerCount: parsed.explicitWorkerCount,
+        cwd: descriptor.cwd,
+        buildLegacyPlan: buildTeamExecutionPlan,
+        allowDagHandoff: parsed.allowRepoAwareDagHandoff,
+        approvedRepositoryContextSummary: parsed.approvedRepositoryContextSummary,
+    });
+    return {
+        teamName: parsed.teamName,
+        task: descriptor.task,
+        workerCount: executionPlan.workerCount,
+        agentType: descriptor.agentType,
+        tasks: executionPlan.tasks.map(({ subject, description, owner, blocked_by, depends_on, symbolic_depends_on, role, requires_code_change, filePaths, domains, lane, allocation_reason, symbolic_id, }) => ({
+            subject,
+            description,
+            ...(owner ? { owner } : {}),
+            ...(blocked_by?.length ? { blocked_by } : {}),
+            ...(depends_on?.length ? { depends_on } : {}),
+            ...(symbolic_depends_on?.length ? { symbolic_depends_on } : {}),
+            ...(role ? { role } : {}),
+            ...(requires_code_change ? { requires_code_change } : {}),
+            ...(filePaths?.length ? { filePaths } : {}),
+            ...(domains?.length ? { domains } : {}),
+            ...(lane ? { lane } : {}),
+            ...(allocation_reason ? { allocation_reason } : {}),
+            ...(symbolic_id ? { symbolic_id } : {}),
+        })),
+        cwd: descriptor.cwd,
+        approvedExecution: descriptor.approvedExecution,
+        ...(executionPlan.metadata ? { decompositionMetadata: executionPlan.metadata } : {}),
+    };
+}
+/**
+ * Create a team-exec pipeline stage.
+ *
+ * This stage delegates to the existing `omx team` infrastructure, which
+ * starts real Codex CLI workers in tmux panes. When RALPLAN names a
+ * concrete approved PRD handoff, team-exec reuses that exact task text;
+ * otherwise it stays on the generic request-task path.
+ */
+export function createTeamExecStage(options = {}) {
+    const workerCount = options.workerCount ?? 2;
+    const agentType = options.agentType ?? 'executor';
+    return {
+        name: 'team-exec',
+        async run(ctx) {
+            const startTime = Date.now();
+            try {
+                const ralplanArtifacts = typeof ctx.artifacts['ralplan'] === 'object' && ctx.artifacts['ralplan'] !== null
+                    ? ctx.artifacts['ralplan']
+                    : undefined;
+                const launch = resolveTeamExecLaunch(ctx, ralplanArtifacts);
+                const task = launch.task;
+                const availableAgentTypes = await resolveAvailableAgentTypes(ctx.cwd);
+                const staffingPlan = buildFollowupStaffingPlan('team', task, availableAgentTypes, {
+                    workerCount,
+                    fallbackRole: agentType,
+                });
+                // Build team execution descriptor
+                const teamDescriptor = {
+                    task,
+                    workerCount,
+                    agentType,
+                    availableAgentTypes,
+                    staffingPlan,
+                    useWorktrees: options.useWorktrees ?? false,
+                    cwd: ctx.cwd,
+                    extraEnv: options.extraEnv,
+                    approvedExecution: launch.approvedExecution,
+                };
+                return {
+                    status: 'completed',
+                    artifacts: {
+                        teamDescriptor,
+                        workerCount,
+                        agentType,
+                        availableAgentTypes,
+                        staffingPlan,
+                        stage: 'team-exec',
+                        instruction: buildTeamInstruction(teamDescriptor),
+                    },
+                    duration_ms: Date.now() - startTime,
+                };
+            }
+            catch (err) {
+                return {
+                    status: 'failed',
+                    artifacts: {},
+                    duration_ms: Date.now() - startTime,
+                    error: `Team execution stage failed: ${err instanceof Error ? err.message : String(err)}`,
+                };
+            }
+        },
+    };
+}
+/**
+ * Build the `omx team` CLI instruction from a descriptor.
+ */
+export function buildTeamInstruction(descriptor, options = {}) {
+    const runtimeCliInput = buildTeamRuntimeCliLaunchInput(descriptor);
+    const runtimeCliPath = join(packageRoot(), 'dist', 'team', 'runtime-cli.js');
+    const platform = options.platform ?? process.platform;
+    const encodedInput = Buffer.from(JSON.stringify(runtimeCliInput), 'utf-8').toString('base64url');
+    const launchCommand = `${quoteShellArg(process.execPath, platform)} ${quoteShellArg(runtimeCliPath, platform)} --input-json-base64 ${encodedInput}`;
+    if (platform === 'win32') {
+        return launchCommand;
+    }
+    return `${launchCommand} # task=${JSON.stringify(descriptor.task)} # staffing=${descriptor.staffingPlan.staffingSummary} # verify=${descriptor.staffingPlan.verificationPlan.summary}`;
+}
+//# sourceMappingURL=team-exec.js.map

package/dist/pipeline/stages/team-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-exec.js","sourceRoot":"","sources":["../../../src/pipeline/stages/team-exec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9F,OAAO,EAAE,+BAA+B,EAAkC,MAAM,wCAAwC,CAAC;AACzH,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,sCAAsC,EACtC,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iCAAiC,GAElC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAgBjE,SAAS,oBAAoB,CAAC,GAAiB,EAAE,gBAA0C;IACzF,MAAM,WAAW,GAAG,OAAO,gBAAgB,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnG,OAAO,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,6BAA6B,CAAC,OAAe;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzE,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/E,OAAO,SAAS,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY,EAAE,aAAqB;IAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACxC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;AACrC,CAAC;AAED,SAAS,2BAA2B,CAAC,SAA4B,EAAE,OAAe;IAChF,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;IACxE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,SAAS,CAAC,aAAa,CAAC,MAAM,CACnC,CAAC,YAAY,EAAE,EAAE,CAAC,oBAAoB,CAAC,YAAY,EAAE,+BAA+B,CAAC,KAAK,OAAO,CAClG,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,SAA4B,EAC5B,GAAW,EACX,OAAe;IAEf,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,IAAI,IAAI,CAAC;QAClH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,6BAA6B,CAAC,iBAAiB,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE;QAC5D,MAAM,YAAY,GAAG,6BAA6B,CAAC,aAAa,CAAC,CAAC;QAClE,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;QAC1F,MAAM,iBAAiB,GAAG,6BAA6B,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;QACrG,OAAO,cAAc,KAAK,YAAY;eACjC,cAAc,KAAK,gBAAgB;eACnC,cAAc,KAAK,iBAAiB,CAAC;IAC5C,CAAC,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,IAAI,IAAI,CAAC;IACpG,OAAO;QACL,WAAW;QACX,YAAY,EAAE,YAAY;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,kCAAkC,CACzC,SAA4B,EAC5B,GAAW,EACX,gBAA0C;IAE1C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,WAAW,GAAG,KAA+B,CAAC;QACpD,MAAM,aAAa,GAAG,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ;YAC5D,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC7B,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,aAAa;YAAE,SAAS;QAC7B,MAAM,qBAAqB,GAAG,sBAAsB,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,WAAW,CAAC;QAChG,MAAM,aAAa,GAAG,qBAAqB,CAAC,CAAC,CAAC,2BAA2B,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,IAAI,CAAC,qBAAqB,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnE,OAAO;YACL,OAAO,EAAE,qBAAqB;YAC9B,aAAa;SACd,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mCAAmC,CAC1C,SAA4B;IAE5B,KAAK,IAAI,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,aAAa,GAAG,2BAA2B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,2BAA2B,CAClC,GAAW,EACX,cAAsB,EACtB,gBAA0C;IAE1C,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,sBAAsB,GAAG,sBAAsB,CAAC,SAAS,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;IACtF,MAAM,uBAAuB,GAAG,sBAAsB,CAAC,WAAW;QAChE,CAAC,CAAC,2BAA2B,CAAC,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC;QAC5E,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,sCAAsC,sBAAsB,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,uBAAuB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,sBAAsB,CAAC,WAAW,CAAC;IAC5C,CAAC;IACD,MAAM,SAAS,GAAG,kCAAkC,CAAC,SAAS,EAAE,GAAG,EAAE,gBAAgB,CAAC;WACjF,mCAAmC,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO;QACvC,CAAC,CAAC,sBAAsB,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,WAAW;QACvE,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,sBAAsB,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,eAAe,KAAK,sBAAsB,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,oCAAoC,sBAAsB,CAAC,WAAW,IAAI,eAAe,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,qCAAqC,CAC5C,GAAW,EACX,cAAsB,EACtB,gBAA0C;IAE1C,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,GAAG,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC5F,MAAM,mBAAmB,GAAG,sCAAsC,CAAC,GAAG,EAAE,MAAM,EAAE;QAC9E,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IACH,IAAI,mBAAmB,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,wCAAwC,gBAAgB,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,mBAAmB,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,gBAAgB,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO;QACL,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,IAAI;QACnC,iBAAiB,EAAE,iCAAiC,CAAC,mBAAmB,CAAC,IAAI,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,GAAiB,EACjB,gBAA0C;IAE1C,MAAM,aAAa,GAAG,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,OAAO,gBAAgB,EAAE,cAAc,KAAK,QAAQ;QACzE,CAAC,CAAC,gBAAgB,CAAC,cAAc,CAAC,IAAI,EAAE;QACxC,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,qCAAqC,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;AAC1F,CAAC;AAiCD,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC;AAC/C,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,QAAyB;IAC7D,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,8BAA8B,CAAC,UAA8B;IACpE,MAAM,MAAM,GAAG,aAAa,CAC1B,CAAC,GAAG,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,EACtE,UAAU,CAAC,GAAG,CACf,CAAC;IACF,MAAM,aAAa,GAAG,+BAA+B,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,eAAe,EAAE,sBAAsB;QACvC,eAAe,EAAE,MAAM,CAAC,wBAAwB;QAChD,gCAAgC,EAAE,MAAM,CAAC,gCAAgC;KAC1E,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAC9B,OAAO,EACP,WAAW,EACX,KAAK,EACL,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,IAAI,EACJ,oBAAoB,EACpB,SAAS,EACT,OAAO,EACP,IAAI,EACJ,iBAAiB,EACjB,WAAW,GACZ,EAAE,EAAE,CAAC,CAAC;YACL,OAAO;YACP,WAAW;YACX,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAC;QACH,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;QAC/C,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAgC,EAAE;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC;IAElD,OAAO;QACL,IAAI,EAAE,WAAW;QAEjB,KAAK,CAAC,GAAG,CAAC,GAAiB;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC;gBACH,MAAM,gBAAgB,GAAG,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,IAAI;oBACxG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAA4B;oBACrD,CAAC,CAAC,SAAS,CAAC;gBACd,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;gBAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACzB,MAAM,mBAAmB,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACtE,MAAM,YAAY,GAAG,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE;oBAChF,WAAW;oBACX,YAAY,EAAE,SAAS;iBACxB,CAAC,CAAC;gBAEH,kCAAkC;gBAClC,MAAM,cAAc,GAAuB;oBACzC,IAAI;oBACJ,WAAW;oBACX,SAAS;oBACT,mBAAmB;oBACnB,YAAY;oBACZ,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK;oBAC3C,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;iBAC5C,CAAC;gBAEF,OAAO;oBACL,MAAM,EAAE,WAAW;oBACnB,SAAS,EAAE;wBACT,cAAc;wBACd,WAAW;wBACX,SAAS;wBACT,mBAAmB;wBACnB,YAAY;wBACZ,KAAK,EAAE,WAAW;wBAClB,WAAW,EAAE,oBAAoB,CAAC,cAAc,CAAC;qBAClD;oBACD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACpC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,EAAE;oBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBACnC,KAAK,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;iBAC1F,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAqBD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA8B,EAC9B,UAAuC,EAAE;IAEzC,MAAM,eAAe,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjG,MAAM,aAAa,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,wBAAwB,YAAY,EAAE,CAAC;IACpJ,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,GAAG,aAAa,WAAW,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,YAAY,CAAC,eAAe,aAAa,UAAU,CAAC,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;AACzL,CAAC"}

package/dist/pipeline/stages/ultragoal.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Ultragoal stage adapter for the default Autopilot loop.
+ *
+ * Produces a model-facing instruction for durable goal-mode execution. Team is
+ * intentionally conditional and must be launched explicitly inside an Ultragoal
+ * story when parallel execution is warranted.
+ */
+import type { PipelineStage } from '../types.js';
+export interface UltragoalDescriptor {
+    task: string;
+    cwd: string;
+    sessionId?: string;
+    ralplanArtifacts: Record<string, unknown>;
+    instruction: string;
+    teamCondition: string;
+}
+export declare function createUltragoalStage(): PipelineStage;
+export declare function buildUltragoalInstruction(task: string): string;
+//# sourceMappingURL=ultragoal.d.ts.map

package/dist/pipeline/stages/ultragoal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ultragoal.d.ts","sourceRoot":"","sources":["../../../src/pipeline/stages/ultragoal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,IAAI,aAAa,CA4BpD;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/pipeline/stages/ultragoal.js

@@ -0,0 +1,38 @@
+/**
+ * Ultragoal stage adapter for the default Autopilot loop.
+ *
+ * Produces a model-facing instruction for durable goal-mode execution. Team is
+ * intentionally conditional and must be launched explicitly inside an Ultragoal
+ * story when parallel execution is warranted.
+ */
+export function createUltragoalStage() {
+    return {
+        name: 'ultragoal',
+        async run(ctx) {
+            const startTime = Date.now();
+            const ralplanArtifacts = ctx.artifacts.ralplan;
+            const descriptor = {
+                task: ctx.task,
+                cwd: ctx.cwd,
+                sessionId: ctx.sessionId,
+                ralplanArtifacts: ralplanArtifacts ?? {},
+                instruction: buildUltragoalInstruction(ctx.task),
+                teamCondition: 'Launch $team only inside an active Ultragoal story when independent lanes or broad verification make coordinated parallel work useful; Ultragoal remains leader-owned for goal and ledger state.',
+            };
+            return {
+                status: 'completed',
+                artifacts: {
+                    stage: 'ultragoal',
+                    ultragoalDescriptor: descriptor,
+                    team_condition: descriptor.teamCondition,
+                    instruction: descriptor.instruction,
+                },
+                duration_ms: Date.now() - startTime,
+            };
+        },
+    };
+}
+export function buildUltragoalInstruction(task) {
+    return `$ultragoal ${JSON.stringify(task)}`;
+}
+//# sourceMappingURL=ultragoal.js.map

package/dist/pipeline/stages/ultragoal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ultragoal.js","sourceRoot":"","sources":["../../../src/pipeline/stages/ultragoal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,WAAW;QAEjB,KAAK,CAAC,GAAG,CAAC,GAAiB;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,gBAAgB,GAAG,GAAG,CAAC,SAAS,CAAC,OAA8C,CAAC;YACtF,MAAM,UAAU,GAAwB;gBACtC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,gBAAgB,EAAE,gBAAgB,IAAI,EAAE;gBACxC,WAAW,EAAE,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAChD,aAAa,EAAE,kMAAkM;aAClN,CAAC;YAEF,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,SAAS,EAAE;oBACT,KAAK,EAAE,WAAW;oBAClB,mBAAmB,EAAE,UAAU;oBAC/B,cAAc,EAAE,UAAU,CAAC,aAAa;oBACxC,WAAW,EAAE,UAAU,CAAC,WAAW;iBACpC;gBACD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACpC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,cAAc,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC"}

package/dist/pipeline/stages/ultraqa.d.ts

@@ -0,0 +1,33 @@
+/**
+ * UltraQA stage adapter for the default Autopilot loop.
+ *
+ * Produces a model-facing instruction for adversarial QA after clean review.
+ */
+import type { PipelineStage } from '../types.js';
+export interface UltraqaStageOptions {
+    /** Optional QA verdict injected by tests or runtime adapters. */
+    clean?: boolean;
+    /** Whether QA was explicitly skipped for a documented low-risk condition. */
+    skipped?: boolean;
+    /** Human-readable QA summary or skip reason. */
+    summary?: string;
+}
+export interface UltraqaDescriptor {
+    task: string;
+    cwd: string;
+    sessionId?: string;
+    ultragoalArtifacts: Record<string, unknown>;
+    codeReviewArtifacts: Record<string, unknown>;
+    instruction: string;
+}
+export interface UltraqaVerdict {
+    clean: boolean;
+    skipped: boolean;
+    summary: string;
+    stage: 'ultraqa';
+    artifact_path: string;
+    reason?: string;
+}
+export declare function createUltraqaStage(options?: UltraqaStageOptions): PipelineStage;
+export declare function buildUltraqaInstruction(task: string): string;
+//# sourceMappingURL=ultraqa.d.ts.map

package/dist/pipeline/stages/ultraqa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ultraqa.d.ts","sourceRoot":"","sources":["../../../src/pipeline/stages/ultraqa.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa,CAyCnF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/pipeline/stages/ultraqa.js

@@ -0,0 +1,49 @@
+/**
+ * UltraQA stage adapter for the default Autopilot loop.
+ *
+ * Produces a model-facing instruction for adversarial QA after clean review.
+ */
+export function createUltraqaStage(options = {}) {
+    return {
+        name: 'ultraqa',
+        async run(ctx) {
+            const startTime = Date.now();
+            const descriptor = {
+                task: ctx.task,
+                cwd: ctx.cwd,
+                sessionId: ctx.sessionId,
+                ultragoalArtifacts: ctx.artifacts.ultragoal ?? {},
+                codeReviewArtifacts: ctx.artifacts['code-review'] ?? {},
+                instruction: buildUltraqaInstruction(ctx.task),
+            };
+            const hasQaEvidence = options.clean !== undefined || options.skipped !== undefined;
+            const skipped = options.skipped ?? false;
+            const clean = hasQaEvidence ? (options.clean ?? skipped) : false;
+            const verdict = {
+                clean,
+                skipped,
+                summary: options.summary ?? (hasQaEvidence
+                    ? (clean ? 'UltraQA gate clean.' : 'UltraQA found issues; return to ralplan.')
+                    : 'UltraQA evidence missing; fail closed and return to ralplan.'),
+                stage: 'ultraqa',
+                artifact_path: '.omx/state/autopilot-state.json#pipeline_stage_results.ultraqa.artifacts.qa_verdict',
+                ...(skipped ? { reason: options.summary ?? 'UltraQA explicitly skipped.' } : {}),
+            };
+            return {
+                status: 'completed',
+                artifacts: {
+                    stage: 'ultraqa',
+                    ultraqaDescriptor: descriptor,
+                    qa_verdict: verdict,
+                    return_to_ralplan_reason: clean ? null : verdict.summary,
+                    instruction: descriptor.instruction,
+                },
+                duration_ms: Date.now() - startTime,
+            };
+        },
+    };
+}
+export function buildUltraqaInstruction(task) {
+    return `$ultraqa ${JSON.stringify(task)}`;
+}
+//# sourceMappingURL=ultraqa.js.map

package/dist/pipeline/stages/ultraqa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ultraqa.js","sourceRoot":"","sources":["../../../src/pipeline/stages/ultraqa.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,OAAO;QACL,IAAI,EAAE,SAAS;QAEf,KAAK,CAAC,GAAG,CAAC,GAAiB;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAsB;gBACpC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,kBAAkB,EAAG,GAAG,CAAC,SAAS,CAAC,SAAiD,IAAI,EAAE;gBAC1F,mBAAmB,EAAG,GAAG,CAAC,SAAS,CAAC,aAAa,CAAyC,IAAI,EAAE;gBAChG,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC;aAC/C,CAAC;YACF,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;YACnF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;YACzC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACjE,MAAM,OAAO,GAAmB;gBAC9B,KAAK;gBACL,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,aAAa;oBACxC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,0CAA0C,CAAC;oBAC9E,CAAC,CAAC,8DAA8D,CAAC;gBACnE,KAAK,EAAE,SAAS;gBAChB,aAAa,EAAE,qFAAqF;gBACpG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,6BAA6B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjF,CAAC;YAEF,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,SAAS,EAAE;oBACT,KAAK,EAAE,SAAS;oBAChB,iBAAiB,EAAE,UAAU;oBAC7B,UAAU,EAAE,OAAO;oBACnB,wBAAwB,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;oBACxD,WAAW,EAAE,UAAU,CAAC,WAAW;iBACpC;gBACD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACpC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,YAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/pipeline/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Pipeline stage interfaces for oh-my-codex
+ *
+ * Shared stage contracts for the default Autopilot loop.
+ * The pipeline sequences: deep-interview -> ralplan -> ultragoal -> code-review -> ultraqa.
+ */
+/**
+ * Context passed into each pipeline stage.
+ * Accumulates artifacts from prior stages so downstream stages can consume them.
+ */
+export interface StageContext {
+    /** Original task description provided by the user. */
+    task: string;
+    /** Accumulated artifacts from all prior stages keyed by producing stage name. */
+    artifacts: Record<string, unknown>;
+    /** Result of the immediately preceding stage (undefined for the first stage). */
+    previousStageResult?: StageResult;
+    /** Working directory for the pipeline run. */
+    cwd: string;
+    /** Optional session id for scoped state. */
+    sessionId?: string;
+}
+/**
+ * Result returned by each pipeline stage after execution.
+ */
+export interface StageResult {
+    status: 'completed' | 'failed' | 'skipped';
+    /** Artifacts produced by this stage (merged into StageContext.artifacts). */
+    artifacts: Record<string, unknown>;
+    /** Wall-clock duration of the stage in milliseconds. */
+    duration_ms: number;
+    /** Human-readable error description when status is 'failed'. */
+    error?: string;
+}
+/**
+ * A single stage in the pipeline. Implementations wrap concrete execution
+ * backends (deep-interview, ralplan, ultragoal, code-review, ultraqa, and legacy team/Ralph adapters) behind this uniform interface.
+ */
+export interface PipelineStage {
+    /** Unique name for this stage (e.g. 'deep-interview', 'ralplan', 'ultragoal', 'code-review'). */
+    readonly name: string;
+    /** Execute the stage. Must return a StageResult. */
+    run(ctx: StageContext): Promise<StageResult>;
+    /**
+     * Optional predicate — return true to skip this stage.
+     * Useful for conditional stages (e.g. skip ralplan if plan already exists).
+     */
+    canSkip?(ctx: StageContext): boolean;
+}
+/**
+ * Configuration for a pipeline run.
+ */
+export interface PipelineConfig {
+    /** Human-readable pipeline name (used for state files and logging). */
+    name: string;
+    /** The task description driving the pipeline. */
+    task: string;
+    /** Ordered list of stages to execute. */
+    stages: PipelineStage[];
+    /** Working directory (defaults to process.cwd()). */
+    cwd?: string;
+    /** Optional session id for scoped state persistence. */
+    sessionId?: string;
+    /**
+     * Maximum ralph verification iterations.
+     * Passed through to the ralph stage. Defaults to 10.
+     */
+    maxRalphIterations?: number;
+    /**
+     * Legacy worker count for adapters that still launch team execution. Defaults to 2.
+     */
+    workerCount?: number;
+    /** Agent type for team workers (e.g. 'executor'). Defaults to 'executor'. */
+    agentType?: string;
+    /** Callback fired on each stage transition. */
+    onStageTransition?: (from: string, to: string) => void;
+}
+/**
+ * Final result of a complete pipeline run.
+ */
+export interface PipelineResult {
+    /** Overall pipeline status. */
+    status: 'completed' | 'failed' | 'cancelled';
+    /** Per-stage results keyed by stage name. */
+    stageResults: Record<string, StageResult>;
+    /** Total wall-clock duration in milliseconds. */
+    duration_ms: number;
+    /** Merged artifact map from all stages. */
+    artifacts: Record<string, unknown>;
+    /** Error from the failing stage (if any). */
+    error?: string;
+    /** Name of the stage that failed (if any). */
+    failedStage?: string;
+}
+/**
+ * Extended ModeState fields for pipeline mode.
+ */
+export interface PipelineModeStateExtension {
+    /** Pipeline config name. */
+    pipeline_name: string;
+    /** Names of stages in execution order. */
+    pipeline_stages: string[];
+    /** Index of the currently executing stage. */
+    pipeline_stage_index: number;
+    /** Per-stage results collected so far. */
+    pipeline_stage_results: Record<string, StageResult>;
+    /** Current review cycle count; increments when code-review is not clean. */
+    review_cycle?: number;
+    /** Latest code-review verdict artifact. */
+    review_verdict?: unknown;
+    /** Latest UltraQA verdict artifact. */
+    qa_verdict?: unknown;
+    /** Reason Autopilot returned to ralplan after a non-clean review. */
+    return_to_ralplan_reason?: string | null;
+    /** Phase handoff artifacts keyed by contract names such as deep_interview, ralplan, ultragoal, code_review, and ultraqa. */
+    handoff_artifacts?: Record<string, unknown>;
+    /** Quality-gate retry ceiling; legacy name retained for API compatibility. */
+    pipeline_max_ralph_iterations: number;
+    /** Worker count for team execution. */
+    pipeline_worker_count: number;
+    /** Agent type for team workers. */
+    pipeline_agent_type: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/types.d.ts.map

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

package/dist/pipeline/types.js

@@ -0,0 +1,8 @@
+/**
+ * Pipeline stage interfaces for oh-my-codex
+ *
+ * Shared stage contracts for the default Autopilot loop.
+ * The pipeline sequences: deep-interview -> ralplan -> ultragoal -> code-review -> ultraqa.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/planning/__tests__/approved-execution-lifecycle-matrix.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=approved-execution-lifecycle-matrix.test.d.ts.map

package/dist/planning/__tests__/approved-execution-lifecycle-matrix.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approved-execution-lifecycle-matrix.test.d.ts","sourceRoot":"","sources":["../../../src/planning/__tests__/approved-execution-lifecycle-matrix.test.ts"],"names":[],"mappings":""}