oh-my-codex 0.15.2 → 0.16.0

package/dist/goal-workflows/__tests__/artifacts.test.js

@@ -0,0 +1,96 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { createGoalWorkflowRun, readGoalWorkflowRun, transitionGoalWorkflowRun, } from '../artifacts.js';
+import { buildGoalWorkflowHandoff } from '../handoff.js';
+import { assertGoalWorkflowCanComplete, normalizeGoalWorkflowValidation, GoalWorkflowValidationError, } from '../validation.js';
+async function withTempRepo(run) {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-goal-workflow-'));
+    try {
+        return await run(cwd);
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+}
+describe('goal-workflow artifacts', () => {
+    it('creates durable status and ledger artifacts under .omx/goals', async () => {
+        await withTempRepo(async (cwd) => {
+            const run = await createGoalWorkflowRun(cwd, {
+                workflow: 'performance-goal',
+                slug: 'Latency Pass',
+                objective: 'Reduce p95 latency below 100ms.',
+                now: new Date('2026-05-04T10:00:00Z'),
+            });
+            assert.equal(run.artifactDir, '.omx/goals/performance-goal/latency-pass');
+            assert.equal(run.status, 'pending');
+            assert.equal((await readGoalWorkflowRun(cwd, 'performance-goal', 'latency-pass')).objective, 'Reduce p95 latency below 100ms.');
+            const ledger = await readFile(join(cwd, '.omx/goals/performance-goal/latency-pass/ledger.jsonl'), 'utf-8');
+            assert.match(ledger, /"event":"workflow_created"/);
+        });
+    });
+    it('requires a real validation artifact when entering validation_passed', async () => {
+        await withTempRepo(async (cwd) => {
+            await createGoalWorkflowRun(cwd, { workflow: 'scrum-goal', slug: 'strict', objective: 'Strictly validate release.' });
+            await assert.rejects(() => transitionGoalWorkflowRun(cwd, 'scrum-goal', 'strict', { status: 'validation_passed' }), /Completion requires a validation artifact/);
+            const placeholder = normalizeGoalWorkflowValidation({
+                status: 'pass',
+                summary: 'TODO placeholder evaluator says pass.',
+                artifactPath: '.omx/goals/scrum-goal/strict/audit.json',
+            });
+            await assert.rejects(() => transitionGoalWorkflowRun(cwd, 'scrum-goal', 'strict', { status: 'validation_passed', validation: placeholder }), /real validation evidence/);
+            const missingArtifact = normalizeGoalWorkflowValidation({
+                status: 'pass',
+                summary: 'Leader audit passed with concrete test output.',
+                artifactPath: '   ',
+            });
+            await assert.rejects(() => transitionGoalWorkflowRun(cwd, 'scrum-goal', 'strict', { status: 'validation_passed', validation: missingArtifact }), /validation artifact path/);
+        });
+    });
+    it('blocks completion until validation passes and records ledger transitions', async () => {
+        await withTempRepo(async (cwd) => {
+            await createGoalWorkflowRun(cwd, { workflow: 'scrum-goal', slug: 'release', objective: 'Ship release.' });
+            await transitionGoalWorkflowRun(cwd, 'scrum-goal', 'release', { status: 'in_progress', now: new Date('2026-05-04T10:01:00Z') });
+            await assert.rejects(() => transitionGoalWorkflowRun(cwd, 'scrum-goal', 'release', { status: 'complete', evidence: 'looks done' }), /passing validation artifact/);
+            const validation = normalizeGoalWorkflowValidation({
+                status: 'pass',
+                summary: 'Worker evidence matrix passed leader audit.',
+                artifactPath: '.omx/goals/scrum-goal/release/audit.json',
+                checkedAt: new Date('2026-05-04T10:02:00Z'),
+            });
+            assertGoalWorkflowCanComplete(validation);
+            await transitionGoalWorkflowRun(cwd, 'scrum-goal', 'release', { status: 'validation_passed', validation });
+            const completed = await transitionGoalWorkflowRun(cwd, 'scrum-goal', 'release', { status: 'complete', evidence: 'audit passed' });
+            assert.equal(completed.status, 'complete');
+            const ledger = await readFile(join(cwd, '.omx/goals/scrum-goal/release/ledger.jsonl'), 'utf-8');
+            assert.match(ledger, /"event":"goal_started"/);
+            assert.match(ledger, /"event":"validation_passed"/);
+            assert.match(ledger, /"event":"goal_completed"/);
+        });
+    });
+});
+describe('goal-workflow handoff and validation', () => {
+    it('renders truthful Codex goal handoff instructions for degraded mode', async () => {
+        await withTempRepo(async (cwd) => {
+            const run = await createGoalWorkflowRun(cwd, { workflow: 'autoresearch-goal', objective: 'Research safe rollout options.' });
+            const handoff = buildGoalWorkflowHandoff({ run, degradedMode: true });
+            assert.match(handoff, /call get_goal/i);
+            assert.match(handoff, /Call create_goal only if no active goal exists/i);
+            assert.match(handoff, /update_goal\(\{status: "complete"\}\) only after/i);
+            assert.match(handoff, /fresh complete snapshot/i);
+            assert.match(handoff, /did not mutate hidden Codex goal state/i);
+            assert.match(handoff, /Research safe rollout options/);
+        });
+    });
+    it('rejects placeholder validation evidence', () => {
+        const validation = normalizeGoalWorkflowValidation({
+            status: true,
+            summary: 'TODO placeholder evaluator says pass.',
+            artifactPath: '.omx/goals/demo/evaluator.json',
+        });
+        assert.throws(() => assertGoalWorkflowCanComplete(validation), GoalWorkflowValidationError);
+    });
+});
+//# sourceMappingURL=artifacts.test.js.map

package/dist/goal-workflows/__tests__/artifacts.test.js.map

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

package/dist/goal-workflows/__tests__/codex-goal-snapshot.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=codex-goal-snapshot.test.d.ts.map

package/dist/goal-workflows/__tests__/codex-goal-snapshot.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-goal-snapshot.test.d.ts","sourceRoot":"","sources":["../../../src/goal-workflows/__tests__/codex-goal-snapshot.test.ts"],"names":[],"mappings":""}

package/dist/goal-workflows/__tests__/codex-goal-snapshot.test.js

@@ -0,0 +1,54 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { CodexGoalSnapshotError, parseCodexGoalSnapshot, readCodexGoalSnapshotInput, reconcileCodexGoalSnapshot, } from '../codex-goal-snapshot.js';
+describe('codex goal snapshot reconciliation', () => {
+    it('normalizes get_goal JSON shape', () => {
+        const snapshot = parseCodexGoalSnapshot({
+            goal: { objective: 'Ship the feature', status: 'completed', token_budget: 1000 },
+            remainingTokens: 25,
+        });
+        assert.equal(snapshot.available, true);
+        assert.equal(snapshot.objective, 'Ship the feature');
+        assert.equal(snapshot.status, 'complete');
+        assert.equal(snapshot.tokenBudget, 1000);
+        assert.equal(snapshot.remainingTokens, 25);
+    });
+    it('reports absent snapshots as warnings unless required', () => {
+        const optional = reconcileCodexGoalSnapshot(null, { expectedObjective: 'Ship' });
+        assert.equal(optional.ok, true);
+        assert.match(optional.warnings.join('\n'), /call get_goal/);
+        const required = reconcileCodexGoalSnapshot(null, { expectedObjective: 'Ship', requireSnapshot: true });
+        assert.equal(required.ok, false);
+        assert.match(required.errors.join('\n'), /call get_goal/);
+    });
+    it('detects objective mismatches and incomplete completion proof', () => {
+        const mismatch = reconcileCodexGoalSnapshot(parseCodexGoalSnapshot({ goal: { objective: 'Different', status: 'active' } }), { expectedObjective: 'Expected', requireSnapshot: true, requireComplete: true });
+        assert.equal(mismatch.ok, false);
+        assert.match(mismatch.errors.join('\n'), /objective mismatch/);
+        assert.match(mismatch.errors.join('\n'), /not complete/);
+    });
+    it('accepts compatible complete proof', () => {
+        const result = reconcileCodexGoalSnapshot(parseCodexGoalSnapshot({ goal: { objective: 'Expected objective', status: 'complete' } }), { expectedObjective: 'Expected objective', requireSnapshot: true, requireComplete: true });
+        assert.equal(result.ok, true);
+        assert.deepEqual(result.errors, []);
+    });
+    it('reads inline JSON and path input but rejects malformed sources', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-codex-goal-snapshot-'));
+        try {
+            const fromJson = await readCodexGoalSnapshotInput('{"goal":{"objective":"A","status":"active"}}', cwd);
+            assert.equal(fromJson?.objective, 'A');
+            await writeFile(join(cwd, 'goal.json'), '{"goal":{"objective":"B","status":"complete"}}');
+            const fromPath = await readCodexGoalSnapshotInput('goal.json', cwd);
+            assert.equal(fromPath?.objective, 'B');
+            await assert.rejects(() => readCodexGoalSnapshotInput('{not-json}', cwd), CodexGoalSnapshotError);
+            await assert.rejects(() => readCodexGoalSnapshotInput('missing.json', cwd), /neither valid JSON nor a readable path/);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=codex-goal-snapshot.test.js.map

package/dist/goal-workflows/__tests__/codex-goal-snapshot.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-goal-snapshot.test.js","sourceRoot":"","sources":["../../../src/goal-workflows/__tests__/codex-goal-snapshot.test.ts"],"names":[],"mappings":"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"}

package/dist/goal-workflows/artifacts.d.ts

@@ -0,0 +1,62 @@
+export declare const GOAL_WORKFLOWS_DIR = ".omx/goals";
+export declare const GOAL_WORKFLOW_STATUS = "status.json";
+export declare const GOAL_WORKFLOW_LEDGER = "ledger.jsonl";
+export type GoalWorkflowStatus = 'pending' | 'in_progress' | 'validation_passed' | 'blocked' | 'failed' | 'complete';
+export type GoalWorkflowLedgerEvent = 'workflow_created' | 'goal_started' | 'validation_passed' | 'validation_failed' | 'goal_handoff_emitted' | 'goal_completed' | 'goal_failed';
+export interface GoalWorkflowRun {
+    version: 1;
+    workflow: string;
+    slug: string;
+    objective: string;
+    status: GoalWorkflowStatus;
+    createdAt: string;
+    updatedAt: string;
+    artifactDir: string;
+    statusPath: string;
+    ledgerPath: string;
+    metadata?: Record<string, unknown>;
+    validation?: GoalWorkflowValidationSummary;
+    evidence?: string;
+}
+export interface GoalWorkflowValidationSummary {
+    status: Extract<GoalWorkflowStatus, 'validation_passed' | 'blocked' | 'failed'>;
+    summary: string;
+    artifactPath?: string;
+    checkedAt: string;
+}
+export interface GoalWorkflowLedgerEntry {
+    ts: string;
+    event: GoalWorkflowLedgerEvent;
+    status?: GoalWorkflowStatus;
+    message?: string;
+    evidence?: string;
+    validation?: GoalWorkflowValidationSummary;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateGoalWorkflowRunOptions {
+    workflow: string;
+    slug?: string;
+    objective: string;
+    metadata?: Record<string, unknown>;
+    now?: Date;
+    force?: boolean;
+}
+export interface TransitionGoalWorkflowOptions {
+    status: Exclude<GoalWorkflowStatus, 'pending'>;
+    message?: string;
+    evidence?: string;
+    validation?: GoalWorkflowValidationSummary;
+    metadata?: Record<string, unknown>;
+    now?: Date;
+}
+export declare class GoalWorkflowError extends Error {
+}
+export declare function normalizeGoalWorkflowSegment(value: string, fallback?: string): string;
+export declare function goalWorkflowDir(cwd: string, workflow: string, slug: string): string;
+export declare function goalWorkflowStatusPath(cwd: string, workflow: string, slug: string): string;
+export declare function goalWorkflowLedgerPath(cwd: string, workflow: string, slug: string): string;
+export declare function appendGoalWorkflowLedger(cwd: string, run: GoalWorkflowRun, entry: GoalWorkflowLedgerEntry): Promise<void>;
+export declare function createGoalWorkflowRun(cwd: string, options: CreateGoalWorkflowRunOptions): Promise<GoalWorkflowRun>;
+export declare function readGoalWorkflowRun(cwd: string, workflow: string, slug: string): Promise<GoalWorkflowRun>;
+export declare function transitionGoalWorkflowRun(cwd: string, workflow: string, slug: string, options: TransitionGoalWorkflowOptions): Promise<GoalWorkflowRun>;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/goal-workflows/artifacts.d.ts.map

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

package/dist/goal-workflows/artifacts.js

@@ -0,0 +1,132 @@
+import { existsSync } from 'node:fs';
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { assertGoalWorkflowCanComplete } from './validation.js';
+export const GOAL_WORKFLOWS_DIR = '.omx/goals';
+export const GOAL_WORKFLOW_STATUS = 'status.json';
+export const GOAL_WORKFLOW_LEDGER = 'ledger.jsonl';
+export class GoalWorkflowError extends Error {
+}
+function iso(now = new Date()) {
+    return now.toISOString();
+}
+function cleanSegment(value, fallback) {
+    const segment = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 72)
+        .replace(/-+$/g, '');
+    return segment || fallback;
+}
+function slugFromObjective(objective) {
+    const firstLine = objective.split(/\r?\n/).map((line) => line.trim()).find(Boolean) ?? 'goal-workflow';
+    return cleanSegment(firstLine, 'goal-workflow');
+}
+function repoRelative(cwd, path) {
+    return relative(cwd, path).split('\\').join('/');
+}
+export function normalizeGoalWorkflowSegment(value, fallback = 'workflow') {
+    return cleanSegment(value, fallback);
+}
+export function goalWorkflowDir(cwd, workflow, slug) {
+    return join(cwd, GOAL_WORKFLOWS_DIR, normalizeGoalWorkflowSegment(workflow), normalizeGoalWorkflowSegment(slug, 'goal-workflow'));
+}
+export function goalWorkflowStatusPath(cwd, workflow, slug) {
+    return join(goalWorkflowDir(cwd, workflow, slug), GOAL_WORKFLOW_STATUS);
+}
+export function goalWorkflowLedgerPath(cwd, workflow, slug) {
+    return join(goalWorkflowDir(cwd, workflow, slug), GOAL_WORKFLOW_LEDGER);
+}
+export async function appendGoalWorkflowLedger(cwd, run, entry) {
+    await mkdir(join(cwd, run.artifactDir), { recursive: true });
+    await appendFile(join(cwd, run.ledgerPath), `${JSON.stringify(entry)}\n`);
+}
+async function writeRun(cwd, run) {
+    await mkdir(join(cwd, run.artifactDir), { recursive: true });
+    await writeFile(join(cwd, run.statusPath), `${JSON.stringify(run, null, 2)}\n`);
+}
+export async function createGoalWorkflowRun(cwd, options) {
+    if (!options.objective.trim())
+        throw new GoalWorkflowError('Missing goal workflow objective.');
+    const workflow = normalizeGoalWorkflowSegment(options.workflow);
+    const slug = normalizeGoalWorkflowSegment(options.slug ?? slugFromObjective(options.objective), 'goal-workflow');
+    const statusPath = goalWorkflowStatusPath(cwd, workflow, slug);
+    if (!options.force && existsSync(statusPath)) {
+        throw new GoalWorkflowError(`Refusing to overwrite existing ${repoRelative(cwd, statusPath)}; pass force to recreate it.`);
+    }
+    const now = iso(options.now);
+    const artifactDir = repoRelative(cwd, goalWorkflowDir(cwd, workflow, slug));
+    const run = {
+        version: 1,
+        workflow,
+        slug,
+        objective: options.objective.trim(),
+        status: 'pending',
+        createdAt: now,
+        updatedAt: now,
+        artifactDir,
+        statusPath: `${artifactDir}/${GOAL_WORKFLOW_STATUS}`,
+        ledgerPath: `${artifactDir}/${GOAL_WORKFLOW_LEDGER}`,
+        metadata: options.metadata,
+    };
+    await writeRun(cwd, run);
+    await writeFile(join(cwd, run.ledgerPath), '');
+    await appendGoalWorkflowLedger(cwd, run, { ts: now, event: 'workflow_created', status: run.status, message: 'Goal workflow created' });
+    return run;
+}
+export async function readGoalWorkflowRun(cwd, workflow, slug) {
+    const path = goalWorkflowStatusPath(cwd, workflow, slug);
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch {
+        throw new GoalWorkflowError(`No goal workflow run found at ${repoRelative(cwd, path)}.`);
+    }
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== 1 || !parsed.workflow || !parsed.slug || !parsed.objective) {
+        throw new GoalWorkflowError(`Invalid goal workflow run at ${repoRelative(cwd, path)}.`);
+    }
+    return parsed;
+}
+function eventForStatus(status) {
+    switch (status) {
+        case 'in_progress': return 'goal_started';
+        case 'validation_passed': return 'validation_passed';
+        case 'blocked':
+        case 'failed': return 'goal_failed';
+        case 'complete': return 'goal_completed';
+    }
+}
+export async function transitionGoalWorkflowRun(cwd, workflow, slug, options) {
+    const run = await readGoalWorkflowRun(cwd, workflow, slug);
+    if (options.status === 'validation_passed') {
+        assertGoalWorkflowCanComplete(options.validation);
+    }
+    if (options.status === 'complete') {
+        if (run.status !== 'validation_passed') {
+            throw new GoalWorkflowError('Goal workflow completion requires a passing validation artifact first.');
+        }
+        assertGoalWorkflowCanComplete(run.validation);
+    }
+    const now = iso(options.now);
+    run.status = options.status;
+    run.updatedAt = now;
+    run.evidence = options.evidence ?? run.evidence;
+    run.metadata = { ...run.metadata, ...options.metadata };
+    if (options.validation)
+        run.validation = options.validation;
+    await writeRun(cwd, run);
+    await appendGoalWorkflowLedger(cwd, run, {
+        ts: now,
+        event: eventForStatus(options.status),
+        status: run.status,
+        message: options.message,
+        evidence: options.evidence,
+        validation: options.validation,
+        metadata: options.metadata,
+    });
+    return run;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/goal-workflows/artifacts.js.map

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

package/dist/goal-workflows/codex-goal-snapshot.d.ts

@@ -0,0 +1,28 @@
+export type CodexGoalSnapshotStatus = 'active' | 'complete' | 'cancelled' | 'failed' | 'unknown';
+export interface CodexGoalSnapshot {
+    available: boolean;
+    objective?: string;
+    status?: CodexGoalSnapshotStatus;
+    tokenBudget?: number;
+    remainingTokens?: number | null;
+    raw: unknown;
+}
+export interface CodexGoalReconciliation {
+    ok: boolean;
+    snapshot: CodexGoalSnapshot;
+    warnings: string[];
+    errors: string[];
+}
+export interface ReconcileCodexGoalOptions {
+    expectedObjective: string;
+    allowedStatuses?: readonly CodexGoalSnapshotStatus[];
+    requireSnapshot?: boolean;
+    requireComplete?: boolean;
+}
+export declare class CodexGoalSnapshotError extends Error {
+}
+export declare function parseCodexGoalSnapshot(value: unknown): CodexGoalSnapshot;
+export declare function readCodexGoalSnapshotInput(raw: string | undefined, cwd?: string): Promise<CodexGoalSnapshot | null>;
+export declare function reconcileCodexGoalSnapshot(snapshot: CodexGoalSnapshot | null | undefined, options: ReconcileCodexGoalOptions): CodexGoalReconciliation;
+export declare function formatCodexGoalReconciliation(reconciliation: CodexGoalReconciliation): string;
+//# sourceMappingURL=codex-goal-snapshot.d.ts.map

package/dist/goal-workflows/codex-goal-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-goal-snapshot.d.ts","sourceRoot":"","sources":["../../src/goal-workflows/codex-goal-snapshot.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AA2BpD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA+BxE;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAgBhI;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,EAAE,yBAAyB,GACjC,uBAAuB,CA8BzB;AAED,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,uBAAuB,GAAG,MAAM,CAG7F"}

package/dist/goal-workflows/codex-goal-snapshot.js

@@ -0,0 +1,110 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export class CodexGoalSnapshotError extends Error {
+}
+function safeObject(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function safeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function safeNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function normalizeStatus(value) {
+    const status = safeString(value).toLowerCase();
+    if (status === 'complete' || status === 'completed' || status === 'done')
+        return 'complete';
+    if (status === 'cancelled' || status === 'canceled')
+        return 'cancelled';
+    if (status === 'failed' || status === 'failure')
+        return 'failed';
+    if (status === 'active' || status === 'in_progress' || status === 'pending' || status === 'running')
+        return 'active';
+    return 'unknown';
+}
+function normalizeObjective(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+export function parseCodexGoalSnapshot(value) {
+    const root = safeObject(value);
+    const goalValue = Object.hasOwn(root, 'goal') ? root.goal : value;
+    if (goalValue === null || goalValue === undefined || goalValue === false) {
+        return { available: false, raw: value };
+    }
+    const goal = safeObject(goalValue);
+    const objective = safeString(goal.objective
+        ?? goal.goal
+        ?? goal.description
+        ?? root.objective);
+    const status = normalizeStatus(goal.status ?? root.status);
+    const tokenBudget = safeNumber(goal.token_budget
+        ?? goal.tokenBudget
+        ?? root.token_budget
+        ?? root.tokenBudget);
+    const remainingTokens = safeNumber(root.remainingTokens ?? root.remaining_tokens);
+    return {
+        available: Boolean(objective || status !== 'unknown'),
+        ...(objective ? { objective } : {}),
+        status,
+        ...(tokenBudget !== undefined ? { tokenBudget } : {}),
+        remainingTokens: remainingTokens ?? null,
+        raw: value,
+    };
+}
+export async function readCodexGoalSnapshotInput(raw, cwd = process.cwd()) {
+    if (!raw?.trim())
+        return null;
+    const trimmed = raw.trim();
+    try {
+        return parseCodexGoalSnapshot(JSON.parse(trimmed));
+    }
+    catch {
+        const path = resolve(cwd, trimmed);
+        if (!existsSync(path)) {
+            throw new CodexGoalSnapshotError(`Codex goal snapshot is neither valid JSON nor a readable path: ${trimmed}`);
+        }
+        try {
+            return parseCodexGoalSnapshot(JSON.parse(await readFile(path, 'utf-8')));
+        }
+        catch (error) {
+            throw new CodexGoalSnapshotError(`Codex goal snapshot path does not contain valid JSON: ${trimmed}${error instanceof Error ? ` (${error.message})` : ''}`);
+        }
+    }
+}
+export function reconcileCodexGoalSnapshot(snapshot, options) {
+    const effectiveSnapshot = snapshot ?? { available: false, raw: null };
+    const errors = [];
+    const warnings = [];
+    if (!effectiveSnapshot.available) {
+        const message = 'Codex goal snapshot is absent or reports no active goal; call get_goal and pass its JSON with --codex-goal-json.';
+        if (options.requireSnapshot)
+            errors.push(message);
+        else
+            warnings.push(message);
+        return { ok: errors.length === 0, snapshot: effectiveSnapshot, warnings, errors };
+    }
+    const expected = normalizeObjective(options.expectedObjective);
+    const actual = normalizeObjective(effectiveSnapshot.objective ?? '');
+    if (!actual) {
+        errors.push('Codex goal snapshot is missing objective text.');
+    }
+    else if (actual !== expected) {
+        errors.push(`Codex goal objective mismatch: expected "${expected}", got "${actual}".`);
+    }
+    const allowed = options.allowedStatuses ?? (options.requireComplete ? ['complete'] : ['active', 'complete']);
+    const actualStatus = effectiveSnapshot.status ?? 'unknown';
+    if (!allowed.includes(actualStatus)) {
+        errors.push(`Codex goal status mismatch: expected ${allowed.join(' or ')}, got ${actualStatus}.`);
+    }
+    if (options.requireComplete && actualStatus !== 'complete') {
+        errors.push(`Codex goal is not complete; call update_goal({status: "complete"}) only after the objective is actually complete, then pass the fresh get_goal JSON.`);
+    }
+    return { ok: errors.length === 0, snapshot: effectiveSnapshot, warnings, errors };
+}
+export function formatCodexGoalReconciliation(reconciliation) {
+    const parts = [...reconciliation.errors, ...reconciliation.warnings];
+    return parts.join(' ');
+}
+//# sourceMappingURL=codex-goal-snapshot.js.map

package/dist/goal-workflows/codex-goal-snapshot.js.map

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

package/dist/goal-workflows/handoff.d.ts

@@ -0,0 +1,10 @@
+import type { GoalWorkflowRun } from './artifacts.js';
+export interface GoalWorkflowHandoffOptions {
+    run: GoalWorkflowRun;
+    title?: string;
+    tokenBudget?: number;
+    completionCommand?: string;
+    degradedMode?: boolean;
+}
+export declare function buildGoalWorkflowHandoff(options: GoalWorkflowHandoffOptions): string;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/goal-workflows/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/goal-workflows/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CA6BpF"}

package/dist/goal-workflows/handoff.js

@@ -0,0 +1,31 @@
+export function buildGoalWorkflowHandoff(options) {
+    const createPayload = {
+        objective: options.run.objective,
+        ...(options.tokenBudget ? { token_budget: options.tokenBudget } : {}),
+    };
+    return [
+        options.title ?? `${options.run.workflow} goal-workflow handoff`,
+        `Status: ${options.run.status}`,
+        `Artifacts: ${options.run.artifactDir}`,
+        `Ledger: ${options.run.ledgerPath}`,
+        '',
+        'Codex goal integration constraints:',
+        '- First call get_goal to inspect the active Codex thread goal.',
+        '- Call create_goal only if no active goal exists and this handoff is the explicit objective to start.',
+        '- If a different active Codex goal exists, finish, checkpoint, or ask the leader before replacing focus.',
+        '- Work only this objective until the workflow-specific completion audit passes.',
+        '- Call update_goal({status: "complete"}) only after the OMX completion audit and validation artifacts pass, then call get_goal again for a fresh complete snapshot.',
+        options.completionCommand ? `- Then record OMX completion evidence with the fresh snapshot: ${options.completionCommand}` : '- Then record OMX completion evidence in the workflow ledger/status artifacts with the fresh get_goal snapshot when the workflow supports --codex-goal-json.',
+        '',
+        options.degradedMode
+            ? 'Degraded-mode warning: this shell-rendered handoff did not mutate hidden Codex goal state; the active agent must use get_goal/create_goal/update_goal when those tools are available.'
+            : 'Truth boundary: OMX owns durable workflow artifacts; Codex owns active-thread focus/accounting.',
+        '',
+        'create_goal payload:',
+        JSON.stringify(createPayload, null, 2),
+        '',
+        'Objective:',
+        options.run.objective,
+    ].join('\n');
+}
+//# sourceMappingURL=handoff.js.map

package/dist/goal-workflows/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/goal-workflows/handoff.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,wBAAwB,CAAC,OAAmC;IAC1E,MAAM,aAAa,GAAG;QACpB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;QAChC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC;IACF,OAAO;QACL,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,wBAAwB;QAChE,WAAW,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAC/B,cAAc,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE;QACvC,WAAW,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE;QACnC,EAAE;QACF,qCAAqC;QACrC,gEAAgE;QAChE,uGAAuG;QACvG,0GAA0G;QAC1G,iFAAiF;QACjF,qKAAqK;QACrK,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,kEAAkE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,8JAA8J;QAC1R,EAAE;QACF,OAAO,CAAC,YAAY;YAClB,CAAC,CAAC,uLAAuL;YACzL,CAAC,CAAC,iGAAiG;QACrG,EAAE;QACF,sBAAsB;QACtB,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,EAAE;QACF,YAAY;QACZ,OAAO,CAAC,GAAG,CAAC,SAAS;KACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/goal-workflows/validation.d.ts

@@ -0,0 +1,13 @@
+import type { GoalWorkflowValidationSummary } from './artifacts.js';
+export type GoalWorkflowValidationStatus = 'pass' | 'fail' | 'blocker';
+export interface GoalWorkflowValidationInput {
+    status: GoalWorkflowValidationStatus | boolean;
+    summary: string;
+    artifactPath?: string;
+    checkedAt?: Date;
+}
+export declare class GoalWorkflowValidationError extends Error {
+}
+export declare function normalizeGoalWorkflowValidation(input: GoalWorkflowValidationInput): GoalWorkflowValidationSummary;
+export declare function assertGoalWorkflowCanComplete(validation: GoalWorkflowValidationSummary | undefined): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/goal-workflows/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/goal-workflows/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,qBAAa,2BAA4B,SAAQ,KAAK;CAAG;AAUzD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,2BAA2B,GAAG,6BAA6B,CAajH;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,6BAA6B,GAAG,SAAS,GAAG,IAAI,CASzG"}