oh-my-codex 0.15.2 → 0.16.0

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

@@ -5,14 +5,176 @@
  * PipelineStage. The execution backend is always teams — this is the
  * canonical OMX execution surface.
  */
+import { readFileSync } from 'node:fs';
+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 { decodeApprovedExecutionQuotedValue, readLatestPlanningArtifacts, readPlanningArtifacts, } from '../../planning/artifacts.js';
+import { packageRoot, sameFilePath } from '../../utils/paths.js';
+const APPROVED_TEAM_LAUNCH_PATTERN = /(?<command>(?:omx\s+team|\$team)\s+(?<ralph>ralph\s+)?(?<count>\d+)(?::(?<role>[a-z][a-z0-9-]*))?\s+(?<task>"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'))/gi;
+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;
+        return {
+            prdPath: resolvedDraftPlanPath,
+            testSpecPaths: resolvedDraftPlanPath ? matchingTestSpecPathsForPrd(artifacts, resolvedDraftPlanPath) : [],
+        };
+    }
+    return null;
+}
+function resolveApprovedTeamPlanPath(cwd, latestPlanPath, ralplanArtifacts) {
+    const artifacts = readPlanningArtifacts(cwd);
+    const resolvedLatestPlanPath = resolvePlanningPrdPath(artifacts, cwd, latestPlanPath);
+    const selection = readRuntimeLatestPlanningSelection(artifacts, cwd, ralplanArtifacts) ?? readLatestPlanningArtifacts(cwd);
+    const selectedPrdPath = selection.prdPath
+        ? resolvePlanningPrdPath(artifacts, cwd, selection.prdPath).matchedPath
+        : null;
+    if (!selectedPrdPath || selection.testSpecPaths.length === 0 || !resolvedLatestPlanPath.matchedPath) {
+        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 resolveApprovedTeamTaskFromPlanPath(cwd, latestPlanPath, ralplanArtifacts) {
+    const approvedPlanPath = resolveApprovedTeamPlanPath(cwd, latestPlanPath, ralplanArtifacts);
+    let content = '';
+    try {
+        content = readFileSync(approvedPlanPath, 'utf-8');
+    }
+    catch {
+        throw new Error(`team_exec_approved_handoff_missing:${approvedPlanPath}`);
+    }
+    const matches = [...content.matchAll(APPROVED_TEAM_LAUNCH_PATTERN)];
+    if (matches.length === 0) {
+        throw new Error(`team_exec_approved_handoff_missing:${approvedPlanPath}`);
+    }
+    if (matches.length > 1) {
+        throw new Error(`team_exec_approved_handoff_ambiguous:${approvedPlanPath}`);
+    }
+    const task = matches[0]?.groups?.task ? decodeApprovedExecutionQuotedValue(matches[0].groups.task) : null;
+    if (!task) {
+        throw new Error(`team_exec_approved_handoff_missing:${approvedPlanPath}`);
+    }
+    return task;
+}
+function resolveTeamExecTask(ctx, ralplanArtifacts) {
+    const requestedTask = resolveRequestedTask(ctx, ralplanArtifacts);
+    const latestPlanPath = typeof ralplanArtifacts?.latestPlanPath === 'string'
+        ? ralplanArtifacts.latestPlanPath.trim()
+        : '';
+    if (!latestPlanPath) {
+        return requestedTask;
+    }
+    return resolveApprovedTeamTaskFromPlanPath(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,
+        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,
+        ...(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. The stage collects the
- * plan artifacts from the previous RALPLAN stage and passes them as
- * the team task description.
+ * 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;
@@ -22,19 +184,18 @@ export function createTeamExecStage(options = {}) {
         async run(ctx) {
             const startTime = Date.now();
             try {
-                // Extract plan context from previous stage artifacts
-                const ralplanArtifacts = ctx.artifacts['ralplan'];
-                const planContext = ralplanArtifacts
-                    ? `Plan from RALPLAN stage:\n${JSON.stringify(ralplanArtifacts, null, 2)}\n\nTask: ${ctx.task}`
-                    : ctx.task;
+                const ralplanArtifacts = typeof ctx.artifacts['ralplan'] === 'object' && ctx.artifacts['ralplan'] !== null
+                    ? ctx.artifacts['ralplan']
+                    : undefined;
+                const task = resolveTeamExecTask(ctx, ralplanArtifacts);
                 const availableAgentTypes = await resolveAvailableAgentTypes(ctx.cwd);
-                const staffingPlan = buildFollowupStaffingPlan('team', ctx.task, availableAgentTypes, {
+                const staffingPlan = buildFollowupStaffingPlan('team', task, availableAgentTypes, {
                     workerCount,
                     fallbackRole: agentType,
                 });
                 // Build team execution descriptor
                 const teamDescriptor = {
-                    task: planContext,
+                    task,
                     workerCount,
                     agentType,
                     availableAgentTypes,
@@ -71,8 +232,15 @@ export function createTeamExecStage(options = {}) {
 /**
  * Build the `omx team` CLI instruction from a descriptor.
  */
-export function buildTeamInstruction(descriptor) {
-    const launchCommand = `omx team ${descriptor.workerCount}:${descriptor.agentType} ${JSON.stringify(descriptor.task)}`;
-    return `${launchCommand} # staffing=${descriptor.staffingPlan.staffingSummary} # verify=${descriptor.staffingPlan.verificationPlan.summary}`;
+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

@@ -1 +1 @@
-{"version":3,"file":"team-exec.js","sourceRoot":"","sources":["../../../src/pipeline/stages/team-exec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AAgBxC;;;;;;;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,qDAAqD;gBACrD,MAAM,gBAAgB,GAAG,GAAG,CAAC,SAAS,CAAC,SAAS,CAAwC,CAAC;gBACzF,MAAM,WAAW,GAAG,gBAAgB;oBAClC,CAAC,CAAC,6BAA6B,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa,GAAG,CAAC,IAAI,EAAE;oBAC/F,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;gBACb,MAAM,mBAAmB,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACtE,MAAM,YAAY,GAAG,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,mBAAmB,EAAE;oBACpF,WAAW;oBACX,YAAY,EAAE,SAAS;iBACxB,CAAC,CAAC;gBAEH,kCAAkC;gBAClC,MAAM,cAAc,GAAuB;oBACzC,IAAI,EAAE,WAAW;oBACjB,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;iBAC3B,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;AAoBD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAA8B;IACjE,MAAM,aAAa,GAAG,YAAY,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IACtH,OAAO,GAAG,aAAa,eAAe,UAAU,CAAC,YAAY,CAAC,eAAe,aAAa,UAAU,CAAC,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;AAC/I,CAAC"}
+{"version":3,"file":"team-exec.js","sourceRoot":"","sources":["../../../src/pipeline/stages/team-exec.ts"],"names":[],"mappings":"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"}

package/dist/planning/__tests__/artifacts.test.js

@@ -4,9 +4,14 @@ import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { isPlanningComplete, readApprovedExecutionLaunchHint, readPlanningArtifacts, readTeamDagArtifactResolution } from '../artifacts.js';
+import { decodeApprovedExecutionQuotedValue, isPlanningComplete, readApprovedExecutionLaunchHint, readLatestPlanningArtifacts, readPlanningArtifacts, readTeamDagArtifactResolution, } from '../artifacts.js';
 import { readTeamDagHandoffForLatestPlan } from '../../team/dag-schema.js';
 let tempDir;
+function encodeApprovedExecutionTask(task, quote) {
+    return quote === 'single'
+        ? `'${task.replace(/'/g, "\\'")}'`
+        : `"${task.replace(/"/g, '\\"')}"`;
+}
 async function setup() {
     tempDir = await mkdtemp(join(tmpdir(), 'omx-planning-artifacts-'));
 }
@@ -18,6 +23,16 @@ async function cleanup() {
 describe('planning artifacts', () => {
     beforeEach(async () => { await setup(); });
     afterEach(async () => { await cleanup(); });
+    it('round-trips single-quoted approved execution tasks with only escaped apostrophes normalized', () => {
+        const task = String.raw `Fix Bob's regression in C:\\tmp`;
+        assert.equal(decodeApprovedExecutionQuotedValue(encodeApprovedExecutionTask(task, 'single')), task);
+    });
+    it('round-trips double-quoted approved execution tasks without applying JSON escapes', () => {
+        const task = String.raw `Use C:\tmp and keep \n literal plus "quotes"`;
+        assert.equal(decodeApprovedExecutionQuotedValue(encodeApprovedExecutionTask(task, 'double')), task);
+        const literalEscapeTask = String.raw `Keep \t and \u1234 literal`;
+        assert.equal(decodeApprovedExecutionQuotedValue(encodeApprovedExecutionTask(literalEscapeTask, 'double')), literalEscapeTask);
+    });
     it('requires both PRD and test spec for planning completion', async () => {
         const plansDir = join(tempDir, '.omx', 'plans');
         await mkdir(plansDir, { recursive: true });
@@ -79,6 +94,75 @@ describe('planning artifacts', () => {
         assert.equal(resolution.planSlug, 'repo-aware');
         assert.deepEqual(resolution.warnings, ['missing_matching_test_spec']);
     });
+    it('prefers timestamped PRD/test-spec pairs while keeping legacy artifacts compatible', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        const specsDir = join(tempDir, '.omx', 'specs');
+        await mkdir(plansDir, { recursive: true });
+        await mkdir(specsDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-legacy.md'), '# Legacy\n\nLaunch via omx ralph "Execute legacy plan"\n');
+        await writeFile(join(plansDir, 'test-spec-legacy.md'), '# Legacy Test Spec\n');
+        await writeFile(join(plansDir, 'prd-20260427T153000Z-alpha.md'), '# Old Alpha\n\nLaunch via omx ralph "Execute old alpha plan"\n');
+        await writeFile(join(plansDir, 'test-spec-alpha.md'), '# Alpha Legacy Test Spec\n');
+        await writeFile(join(plansDir, 'prd-20260427T153100Z-alpha.md'), '# New Alpha\n\nLaunch via omx ralph "Execute new alpha plan"\n');
+        await writeFile(join(plansDir, 'test-spec-20260427T153100Z-alpha.md'), '# Alpha Timestamped Test Spec\n');
+        await writeFile(join(specsDir, 'deep-interview-alpha.md'), '# Alpha Legacy Deep Interview\n');
+        await writeFile(join(specsDir, 'deep-interview-20260427T153100Z-alpha.md'), '# Alpha Timestamped Deep Interview\n');
+        await writeFile(join(specsDir, 'deep-interview-autoresearch-20260427T153100Z-alpha.md'), '# Autoresearch Draft\n');
+        const selection = readLatestPlanningArtifacts(tempDir);
+        assert.equal(selection.prdPath, join(plansDir, 'prd-20260427T153100Z-alpha.md'));
+        assert.deepEqual(selection.testSpecPaths, [join(plansDir, 'test-spec-20260427T153100Z-alpha.md')]);
+        assert.deepEqual(selection.deepInterviewSpecPaths, [
+            join(specsDir, 'deep-interview-alpha.md'),
+            join(specsDir, 'deep-interview-20260427T153100Z-alpha.md'),
+        ]);
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'ralph');
+        assert.ok(hint);
+        assert.equal(hint?.task, 'Execute new alpha plan');
+        assert.deepEqual(hint?.testSpecPaths, [join(plansDir, 'test-spec-20260427T153100Z-alpha.md')]);
+        assert.deepEqual(hint?.deepInterviewSpecPaths, [
+            join(specsDir, 'deep-interview-alpha.md'),
+            join(specsDir, 'deep-interview-20260427T153100Z-alpha.md'),
+        ]);
+        const artifacts = readPlanningArtifacts(tempDir);
+        assert.equal(isPlanningComplete(artifacts), true);
+    });
+    it('keeps legacy test-spec compatibility aliases for non-timestamped PRDs', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-alpha.md'), '# Alpha\n\nLaunch via omx ralph "Execute alpha"\n');
+        await writeFile(join(plansDir, 'test-spec-alpha.md'), '# Alpha Test Spec\n');
+        await writeFile(join(plansDir, 'testspec-alpha.md'), '# Alpha Compatibility Test Spec\n');
+        await writeFile(join(plansDir, 'test-spec-20260427T153100Z-alpha.md'), '# Alpha Timestamped Test Spec\n');
+        const selection = readLatestPlanningArtifacts(tempDir);
+        assert.equal(selection.prdPath, join(plansDir, 'prd-alpha.md'));
+        assert.deepEqual(selection.testSpecPaths, [
+            join(plansDir, 'test-spec-alpha.md'),
+            join(plansDir, 'testspec-alpha.md'),
+        ]);
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'ralph');
+        assert.ok(hint);
+        assert.deepEqual(hint?.testSpecPaths, [
+            join(plansDir, 'test-spec-alpha.md'),
+            join(plansDir, 'testspec-alpha.md'),
+        ]);
+    });
+    it('fails closed for timestamped PRDs when only legacy slug test specs exist', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-20260427T153100Z-alpha.md'), '# Alpha\n\nLaunch via omx ralph "Execute alpha"\n');
+        await writeFile(join(plansDir, 'test-spec-alpha.md'), '# Alpha Legacy Test Spec\n');
+        const artifacts = readPlanningArtifacts(tempDir);
+        assert.equal(isPlanningComplete(artifacts), false);
+        const selection = readLatestPlanningArtifacts(tempDir);
+        assert.equal(selection.prdPath, join(plansDir, 'prd-20260427T153100Z-alpha.md'));
+        assert.deepEqual(selection.testSpecPaths, []);
+        assert.equal(readApprovedExecutionLaunchHint(tempDir, 'ralph'), null);
+        const resolution = readTeamDagArtifactResolution(tempDir);
+        assert.equal(resolution.source, 'none');
+        assert.equal(resolution.prdPath, join(plansDir, 'prd-20260427T153100Z-alpha.md'));
+        assert.equal(resolution.planSlug, '20260427T153100Z-alpha');
+        assert.deepEqual(resolution.warnings, ['missing_matching_test_spec']);
+    });
     it('parses $ralph aliases with single-quoted task text for approved launch hints', async () => {
         const plansDir = join(tempDir, '.omx', 'plans');
         const specsDir = join(tempDir, '.omx', 'specs');
@@ -185,6 +269,168 @@ describe('planning artifacts', () => {
         assert.deepEqual(hint?.testSpecPaths, [join(plansDir, 'test-spec-zeta.md')]);
         assert.deepEqual(hint?.deepInterviewSpecPaths, [join(specsDir, 'deep-interview-zeta.md')]);
     });
+    it('binds approved launch hints to the requested prd path', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        const alphaPrdPath = join(plansDir, 'prd-alpha.md');
+        await writeFile(alphaPrdPath, '# Alpha\n\nLaunch via omx ralph "Execute alpha"\n');
+        await writeFile(join(plansDir, 'test-spec-alpha.md'), '# Alpha Test Spec\n');
+        await writeFile(join(plansDir, 'prd-zeta.md'), '# Zeta\n\nLaunch via omx ralph "Execute zeta"\n');
+        await writeFile(join(plansDir, 'test-spec-zeta.md'), '# Zeta Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'ralph', { prdPath: alphaPrdPath });
+        assert.ok(hint);
+        assert.equal(hint?.task, 'Execute alpha');
+        assert.equal(hint?.sourcePath, alphaPrdPath);
+        assert.deepEqual(hint?.testSpecPaths, [join(plansDir, 'test-spec-alpha.md')]);
+    });
+    it('honors the requested Ralph task when a single plan lists multiple Ralph launch hints', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-issue-909.md'), [
+            '# PRD',
+            '',
+            'Launch via omx ralph "Execute alpha"',
+            'Launch via omx ralph "Execute beta"',
+        ].join('\n'));
+        await writeFile(join(plansDir, 'test-spec-issue-909.md'), '# Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'ralph', { task: 'Execute alpha' });
+        assert.ok(hint);
+        assert.equal(hint?.task, 'Execute alpha');
+        assert.equal(hint?.command, 'omx ralph "Execute alpha"');
+    });
+    it('fails closed for bare Ralph lookups when a single plan lists multiple Ralph launch hints', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-issue-909-bare.md'), [
+            '# PRD',
+            '',
+            'Launch via omx ralph "Execute alpha"',
+            'Launch via omx ralph "Execute beta"',
+        ].join('\n'));
+        await writeFile(join(plansDir, 'test-spec-issue-909-bare.md'), '# Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'ralph');
+        assert.equal(hint, null);
+    });
+    it('honors the requested team task when a single plan lists multiple team launch hints', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-issue-910.md'), [
+            '# PRD',
+            '',
+            'Launch via omx team 2:executor "Execute alpha"',
+            'Launch via omx team 5:debugger "Execute beta"',
+        ].join('\n'));
+        await writeFile(join(plansDir, 'test-spec-issue-910.md'), '# Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'team', { task: 'Execute alpha' });
+        assert.ok(hint);
+        assert.equal(hint?.task, 'Execute alpha');
+        assert.equal(hint?.workerCount, 2);
+        assert.equal(hint?.agentType, 'executor');
+        assert.equal(hint?.command, 'omx team 2:executor "Execute alpha"');
+    });
+    it('fails closed when a single plan repeats the same team task in multiple launch hints', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        const prdPath = join(plansDir, 'prd-issue-910-duplicate.md');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(prdPath, [
+            '# PRD',
+            '',
+            'Launch via omx team 2:executor "Execute alpha"',
+            'Launch via $team 5:debugger "Execute alpha"',
+        ].join('\n'));
+        await writeFile(join(plansDir, 'test-spec-issue-910-duplicate.md'), '# Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'team', {
+            prdPath,
+            task: 'Execute alpha',
+        });
+        assert.equal(hint, null);
+    });
+    it('rehydrates the exact team launch hint by command when one PRD repeats the same task', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        const sharedTask = 'Ship feature';
+        const primaryCommand = `omx team 2:executor ${JSON.stringify(sharedTask)}`;
+        const secondaryCommand = `$team ralph 5:debugger ${JSON.stringify(sharedTask)}`;
+        const prdPath = join(plansDir, 'prd-issue-910-command.md');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(prdPath, [
+            '# Approved plan',
+            '',
+            `Launch via ${primaryCommand}`,
+            `Launch via ${secondaryCommand}`,
+        ].join('\n'));
+        await writeFile(join(plansDir, 'test-spec-issue-910-command.md'), '# Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'team', {
+            prdPath,
+            task: sharedTask,
+            command: primaryCommand,
+        });
+        assert.ok(hint);
+        assert.equal(hint?.command, primaryCommand);
+        assert.equal(hint?.workerCount, 2);
+        assert.equal(hint?.agentType, 'executor');
+        assert.equal(hint?.linkedRalph, false);
+    });
+    it('fails closed for bare team lookups when a single plan lists multiple team launch hints', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-issue-910-bare.md'), [
+            '# PRD',
+            '',
+            'Launch via omx team 2:executor "Execute alpha"',
+            'Launch via omx team 5:debugger "Execute beta"',
+        ].join('\n'));
+        await writeFile(join(plansDir, 'test-spec-issue-910-bare.md'), '# Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'team');
+        assert.equal(hint, null);
+    });
+    it('attaches bounded approved repository context from a matching latest-plan sidecar', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-issue-2039.md'), '# PRD\n\nLaunch via omx team 3:executor "Execute approved issue 2039 plan"\n');
+        await writeFile(join(plansDir, 'test-spec-issue-2039.md'), '# Test Spec\n');
+        await writeFile(join(plansDir, 'repo-context-issue-2039.md'), 'Key files: src/planning/artifacts.ts\n'.repeat(120));
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'team');
+        assert.ok(hint?.repositoryContextSummary);
+        assert.equal(hint.repositoryContextSummary.sourcePath, join(plansDir, 'repo-context-issue-2039.md'));
+        assert.match(hint.repositoryContextSummary.content, /Key files: src\/planning\/artifacts\.ts/);
+        assert.equal(hint.repositoryContextSummary.truncated, true);
+        assert.ok(hint.repositoryContextSummary.content.split('\n').length <= 80);
+    });
+    it('prefers exact timestamped repository context sidecars for timestamped PRDs', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-20260427T153100Z-alpha.md'), '# Alpha\n\nLaunch via omx team 2:executor "Execute alpha"\n');
+        await writeFile(join(plansDir, 'test-spec-20260427T153100Z-alpha.md'), '# Alpha Test Spec\n');
+        await writeFile(join(plansDir, 'repo-context-alpha.md'), 'stale alpha context\n');
+        await writeFile(join(plansDir, 'repo-context-20260427T153100Z-alpha.md'), 'fresh alpha context\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'team');
+        assert.ok(hint?.repositoryContextSummary);
+        assert.equal(hint.repositoryContextSummary.sourcePath, join(plansDir, 'repo-context-20260427T153100Z-alpha.md'));
+        assert.equal(hint.repositoryContextSummary.content, 'fresh alpha context');
+    });
+    it('does not attach stale repository context from a different PRD slug', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-alpha.md'), '# Alpha\n\nLaunch via omx team 2:executor "Execute alpha"\n');
+        await writeFile(join(plansDir, 'test-spec-alpha.md'), '# Alpha Test Spec\n');
+        await writeFile(join(plansDir, 'repo-context-alpha.md'), 'stale alpha context\n');
+        await writeFile(join(plansDir, 'prd-zeta.md'), '# Zeta\n\nLaunch via omx team 3:executor "Execute zeta"\n');
+        await writeFile(join(plansDir, 'test-spec-zeta.md'), '# Zeta Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'team');
+        assert.ok(hint);
+        assert.equal(hint.task, 'Execute zeta');
+        assert.equal(hint.repositoryContextSummary, undefined);
+    });
+    it('falls back to an inline approved repository context section when no sidecar exists', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-inline.md'), '# PRD\n\nLaunch via omx ralph "Execute inline"\n\n## Approved Repository Context Summary\n\n- Reuse src/cli/ralph.ts.\n\n## Verification\nRun tests.\n');
+        await writeFile(join(plansDir, 'test-spec-inline.md'), '# Inline Test Spec\n');
+        const hint = readApprovedExecutionLaunchHint(tempDir, 'ralph');
+        assert.ok(hint?.repositoryContextSummary);
+        assert.equal(hint.repositoryContextSummary.sourcePath, join(plansDir, 'prd-inline.md'));
+        assert.equal(hint.repositoryContextSummary.content, '- Reuse src/cli/ralph.ts.');
+    });
     it('surfaces deep-interview specs for downstream traceability', async () => {
         const plansDir = join(tempDir, '.omx', 'plans');
         const specsDir = join(tempDir, '.omx', 'specs');
@@ -211,6 +457,20 @@ describe('planning artifacts', () => {
         assert.equal(result.planSlug, 'alpha');
         assert.equal(result.dag?.nodes[0]?.id, 'impl');
     });
+    it('prefers exact timestamped Team DAG sidecars for timestamped PRDs', async () => {
+        const plansDir = join(tempDir, '.omx', 'plans');
+        await mkdir(plansDir, { recursive: true });
+        await writeFile(join(plansDir, 'prd-20260427T153100Z-alpha.md'), '# Alpha\n');
+        await writeFile(join(plansDir, 'test-spec-20260427T153100Z-alpha.md'), '# Alpha Test\n');
+        await writeFile(join(plansDir, 'team-dag-alpha.json'), '{"source":"stale"}\n');
+        await writeFile(join(plansDir, 'team-dag-20260427T153100Z-alpha.json'), '{"source":"fresh"}\n');
+        const resolution = readTeamDagArtifactResolution(tempDir);
+        assert.equal(resolution.source, 'json-sidecar');
+        assert.equal(resolution.planSlug, '20260427T153100Z-alpha');
+        assert.equal(resolution.artifactPath, join(plansDir, 'team-dag-20260427T153100Z-alpha.json'));
+        assert.equal(resolution.content, '{"source":"fresh"}\n');
+        assert.deepEqual(resolution.warnings, []);
+    });
     it('does not overmatch sidecars for a different slug prefix', async () => {
         const plansDir = join(tempDir, '.omx', 'plans');
         await mkdir(plansDir, { recursive: true });