codex-workflow-v2 2.0.0-alpha.1

package/dist/src/git.js

@@ -0,0 +1,115 @@
+import { spawnSync } from 'node:child_process';
+import { WorkflowError } from './errors.js';
+import { changedFiles, currentBranch, headCommit, isClean, runGit } from './repository.js';
+import { pathAllowed } from './domain/validation.js';
+const PROTECTED_BRANCHES = new Set(['main', 'master', 'develop', 'staging', 'production']);
+export function startLocalTaskBranch(repositoryRoot, branch, baseBranch) {
+    if (!isClean(repositoryRoot)) {
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', 'Task start requires a clean checkout.', {
+            changedFiles: changedFiles(repositoryRoot),
+        });
+    }
+    if (currentBranch(repositoryRoot) !== baseBranch) {
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', `Task start must run from ${baseBranch}.`);
+    }
+    if (PROTECTED_BRANCHES.has(branch)) {
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', `Task branch is protected: ${branch}`);
+    }
+    const baseCommit = headCommit(repositoryRoot);
+    runGit(repositoryRoot, ['switch', '-c', branch]);
+    return baseCommit;
+}
+export function runChecks(repositoryRoot, commands) {
+    return commands.map((command) => {
+        const result = spawnSync('/bin/sh', ['-lc', command], {
+            cwd: repositoryRoot,
+            encoding: 'utf8',
+            env: process.env,
+        });
+        const output = `${result.stdout}${result.stderr}`.trim().slice(-12_000);
+        return {
+            command,
+            passed: result.status === 0,
+            exitCode: result.status ?? 1,
+            output,
+        };
+    });
+}
+export function commitStep(repositoryRoot, taskId, stepId, title, allowedWrites) {
+    const files = changedFiles(repositoryRoot);
+    if (files.length === 0)
+        throw new WorkflowError('TRANSITION_BLOCKED', `${stepId} has no changed files.`);
+    const unexpected = files.filter((file) => !pathAllowed(file, allowedWrites));
+    if (unexpected.length > 0) {
+        throw new WorkflowError('TRANSITION_BLOCKED', `${stepId} changed files outside allowedWrites.`, { unexpected });
+    }
+    runGit(repositoryRoot, ['add', '--', ...files]);
+    runGit(repositoryRoot, [
+        'commit',
+        '-m',
+        `${taskId}/${stepId}: ${title}`,
+        '-m',
+        `Task: ${taskId}\nStep: ${stepId}`,
+    ]);
+    return { commitSha: headCommit(repositoryRoot), files };
+}
+export function mergeTaskBranch(repositoryRoot, taskBranch, baseBranch) {
+    if (!isClean(repositoryRoot))
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', 'Merge requires a clean checkout.');
+    if (currentBranch(repositoryRoot) !== taskBranch) {
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', `Expected current task branch ${taskBranch}.`);
+    }
+    runGit(repositoryRoot, ['switch', baseBranch]);
+    const result = spawnSync('git', ['-C', repositoryRoot, 'merge', '--no-ff', taskBranch, '-m', `${taskBranch}: merge task`], {
+        encoding: 'utf8',
+    });
+    if (result.status !== 0) {
+        spawnSync('git', ['-C', repositoryRoot, 'merge', '--abort'], { encoding: 'utf8' });
+        runGit(repositoryRoot, ['switch', taskBranch]);
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', `Merge conflict while merging ${taskBranch}.`, {
+            stdout: result.stdout.trim(),
+            stderr: result.stderr.trim(),
+        });
+    }
+    return headCommit(repositoryRoot);
+}
+export function syncBaseIntoTask(repositoryRoot, taskBranch, baseBranch) {
+    if (!isClean(repositoryRoot))
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', 'Base sync requires a clean checkout.');
+    if (currentBranch(repositoryRoot) !== taskBranch) {
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', `Expected current task branch ${taskBranch}.`);
+    }
+    const result = spawnSync('git', ['-C', repositoryRoot, 'merge', '--no-edit', baseBranch], { encoding: 'utf8' });
+    if (result.status !== 0) {
+        spawnSync('git', ['-C', repositoryRoot, 'merge', '--abort'], { encoding: 'utf8' });
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', `Base sync conflict from ${baseBranch}.`, {
+            stdout: result.stdout.trim(),
+            stderr: result.stderr.trim(),
+        });
+    }
+    return {
+        baseCommit: runGit(repositoryRoot, ['rev-parse', baseBranch]),
+        syncCommit: headCommit(repositoryRoot),
+    };
+}
+export function validateTaskHistory(repositoryRoot, task) {
+    if (!task.baseCommit)
+        throw new WorkflowError('STATE_CORRUPT', `Task ${task.id} has no base commit.`);
+    const actualOutput = runGit(repositoryRoot, ['rev-list', '--reverse', `${task.baseCommit}..HEAD`]);
+    const actual = actualOutput ? actualOutput.split('\n') : [];
+    const expected = [
+        ...task.steps.flatMap((step) => (step.evidence ? [step.evidence.commitSha] : [])),
+        ...task.systemCommits,
+    ];
+    const missing = expected.filter((commit) => !actual.includes(commit));
+    const unexpected = actual.filter((commit) => !expected.includes(commit));
+    if (missing.length > 0 || unexpected.length > 0 || actual.length !== expected.length) {
+        throw new WorkflowError('GIT_PRECONDITION_FAILED', 'Task branch history does not match recorded Step evidence.', {
+            missing,
+            unexpected,
+            baseCommit: task.baseCommit,
+            headCommit: headCommit(repositoryRoot),
+        });
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/src/git.js.map

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

package/dist/src/graph.d.ts

@@ -0,0 +1,28 @@
+import type { GraphBinding, GraphKind, GraphMode, GraphRefreshEvidence, GraphRefreshRequest } from './contracts.js';
+export interface GraphManifest {
+    packageName: string;
+    packageVersion: string;
+    protocolVersion: number;
+    stateSchemaVersion: number;
+    createdAt: string;
+    files: Array<{
+        path: string;
+        sha256: string;
+    }>;
+}
+export declare function graphViewRoot(): string;
+export declare function prepareGraphView(target?: string): {
+    root: string;
+    manifest: GraphManifest;
+};
+export declare function inspectGraphView(target?: string): {
+    present: boolean;
+    current: boolean;
+    root: string;
+};
+export declare function createGraphRefreshRequest(repositoryRoot: string, projectId: string, graphKind: GraphKind, mode?: GraphMode, now?: Date): GraphRefreshRequest;
+export declare function bindGraphEvidence(projectId: string, request: GraphRefreshRequest, evidence: GraphRefreshEvidence, existing: GraphBinding | null, now?: Date): GraphBinding;
+export declare function fallbackGraphBinding(projectId: string, request: GraphRefreshRequest, reason: string, existing: GraphBinding | null, now?: Date): GraphBinding;
+export declare function inspectGraphBinding(binding: GraphBinding, request: GraphRefreshRequest): GraphBinding;
+export declare function validateGraphRequestCurrent(request: GraphRefreshRequest, current: GraphRefreshRequest): void;
+export declare function hashGraphManifest(manifest: GraphManifest): string;

package/dist/src/graph.js

@@ -0,0 +1,263 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { STATE_SCHEMA_VERSION, PROTOCOL_VERSION } from './contracts.js';
+import { WorkflowError } from './errors.js';
+import { writeJsonAtomic } from './fs-utils.js';
+import { headCommit } from './repository.js';
+import { PACKAGE_NAME, PACKAGE_VERSION } from './version.js';
+export function graphViewRoot() {
+    const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+    return path.join(codexHome, 'workflow-cache', 'codex-workflow', PACKAGE_VERSION);
+}
+export function prepareGraphView(target = graphViewRoot()) {
+    const packageRoot = resolvePackageRoot();
+    const temporary = `${target}.tmp-${randomUUID()}`;
+    rmSync(temporary, { recursive: true, force: true });
+    mkdirSync(temporary, { recursive: true, mode: 0o700 });
+    try {
+        for (const relative of ['dist/src', 'roles', 'references', 'schemas']) {
+            const source = path.join(packageRoot, relative);
+            if (!existsSync(source)) {
+                throw new WorkflowError('NOT_FOUND', `Graph source is missing from package: ${relative}`);
+            }
+            copyTreeWithoutSymlinks(source, path.join(temporary, relative));
+        }
+        const files = listFiles(temporary).map((file) => ({
+            path: path.relative(temporary, file).replaceAll('\\', '/'),
+            sha256: createHash('sha256').update(readFileSync(file)).digest('hex'),
+        }));
+        const manifest = {
+            packageName: PACKAGE_NAME,
+            packageVersion: PACKAGE_VERSION,
+            protocolVersion: PROTOCOL_VERSION,
+            stateSchemaVersion: STATE_SCHEMA_VERSION,
+            createdAt: new Date().toISOString(),
+            files,
+        };
+        writeJsonAtomic(path.join(temporary, 'manifest.json'), manifest);
+        rmSync(target, { recursive: true, force: true });
+        mkdirSync(path.dirname(target), { recursive: true, mode: 0o700 });
+        renameSync(temporary, target);
+        return { root: target, manifest };
+    }
+    finally {
+        rmSync(temporary, { recursive: true, force: true });
+    }
+}
+export function inspectGraphView(target = graphViewRoot()) {
+    const manifestFile = path.join(target, 'manifest.json');
+    if (!existsSync(manifestFile))
+        return { present: false, current: false, root: target };
+    try {
+        const manifest = JSON.parse(readFileSync(manifestFile, 'utf8'));
+        return {
+            present: true,
+            current: manifest.packageName === PACKAGE_NAME &&
+                manifest.packageVersion === PACKAGE_VERSION &&
+                manifest.protocolVersion === PROTOCOL_VERSION &&
+                manifest.stateSchemaVersion === STATE_SCHEMA_VERSION,
+            root: target,
+        };
+    }
+    catch {
+        return { present: true, current: false, root: target };
+    }
+}
+export function createGraphRefreshRequest(repositoryRoot, projectId, graphKind, mode = 'moderate', now = new Date()) {
+    if (graphKind === 'product') {
+        const sourceRoot = path.resolve(repositoryRoot);
+        return {
+            protocolVersion: PROTOCOL_VERSION,
+            requestId: randomUUID(),
+            projectId,
+            graphKind,
+            sourceRoot,
+            rootFingerprint: createHash('sha256').update(`${projectId}\0${sourceRoot}`).digest('hex'),
+            indexedHead: headCommit(sourceRoot),
+            packageVersion: null,
+            manifestHash: null,
+            mode,
+            persistence: false,
+            issuedAt: now.toISOString(),
+        };
+    }
+    const prepared = prepareGraphView();
+    const manifestHash = hashGraphManifest(prepared.manifest);
+    return {
+        protocolVersion: PROTOCOL_VERSION,
+        requestId: randomUUID(),
+        projectId,
+        graphKind,
+        sourceRoot: prepared.root,
+        rootFingerprint: createHash('sha256').update(`${PACKAGE_NAME}\0${PACKAGE_VERSION}\0${manifestHash}`).digest('hex'),
+        indexedHead: null,
+        packageVersion: PACKAGE_VERSION,
+        manifestHash,
+        mode,
+        persistence: false,
+        issuedAt: now.toISOString(),
+    };
+}
+export function bindGraphEvidence(projectId, request, evidence, existing, now = new Date()) {
+    validateGraphEvidence(request, evidence);
+    const timestamp = now.toISOString();
+    const snapshot = {
+        projectKey: evidence.projectKey,
+        rootFingerprint: evidence.rootFingerprint,
+        indexedHead: evidence.indexedHead,
+        packageVersion: evidence.packageVersion,
+        manifestHash: evidence.manifestHash,
+        mode: evidence.mode,
+        status: evidence.status,
+        nodeCount: evidence.nodeCount,
+        edgeCount: evidence.edgeCount,
+        observedAt: evidence.observedAt,
+        evidenceHash: createHash('sha256').update(JSON.stringify(evidence)).digest('hex'),
+        fallbackReason: null,
+    };
+    const retainPrevious = request.graphKind === 'workflow' && existing?.packageVersion !== snapshot.packageVersion;
+    return {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        revision: existing?.revision ?? 0,
+        id: `GRAPH-${request.graphKind}`,
+        projectId,
+        createdAt: existing?.createdAt ?? timestamp,
+        updatedAt: timestamp,
+        kind: 'graph-binding',
+        graphKind: request.graphKind,
+        provider: 'codebase-memory-mcp',
+        ...snapshot,
+        previous: retainPrevious && existing ? graphSnapshot(existing) : existing?.previous ?? null,
+    };
+}
+export function fallbackGraphBinding(projectId, request, reason, existing, now = new Date()) {
+    if (!reason.trim())
+        throw new WorkflowError('INVALID_ARGUMENT', 'Graph fallback requires a reason.');
+    const timestamp = now.toISOString();
+    const evidenceHash = createHash('sha256')
+        .update(JSON.stringify({ requestId: request.requestId, reason: reason.trim(), observedAt: timestamp }))
+        .digest('hex');
+    return {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        revision: existing?.revision ?? 0,
+        id: `GRAPH-${request.graphKind}`,
+        projectId,
+        createdAt: existing?.createdAt ?? timestamp,
+        updatedAt: timestamp,
+        kind: 'graph-binding',
+        graphKind: request.graphKind,
+        provider: 'codebase-memory-mcp',
+        projectKey: existing?.projectKey ?? null,
+        rootFingerprint: request.rootFingerprint,
+        indexedHead: request.indexedHead,
+        packageVersion: request.packageVersion,
+        manifestHash: request.manifestHash,
+        mode: request.mode,
+        status: 'fallback',
+        nodeCount: existing?.nodeCount ?? null,
+        edgeCount: existing?.edgeCount ?? null,
+        observedAt: timestamp,
+        evidenceHash,
+        fallbackReason: reason.trim(),
+        previous: existing?.previous ?? null,
+    };
+}
+export function inspectGraphBinding(binding, request) {
+    const stale = binding.rootFingerprint !== request.rootFingerprint ||
+        binding.mode !== request.mode ||
+        binding.indexedHead !== request.indexedHead ||
+        binding.packageVersion !== request.packageVersion ||
+        binding.manifestHash !== request.manifestHash;
+    return stale && binding.status === 'ready' ? { ...binding, status: 'stale' } : binding;
+}
+export function validateGraphRequestCurrent(request, current) {
+    const fields = [
+        'projectId',
+        'graphKind',
+        'sourceRoot',
+        'rootFingerprint',
+        'indexedHead',
+        'packageVersion',
+        'manifestHash',
+        'mode',
+        'persistence',
+    ];
+    const stale = fields.filter((field) => request[field] !== current[field]);
+    if (request.protocolVersion !== PROTOCOL_VERSION || stale.length > 0) {
+        throw new WorkflowError('STATE_CONFLICT', 'Graph refresh request is stale or incompatible.', { stale });
+    }
+}
+export function hashGraphManifest(manifest) {
+    return createHash('sha256').update(JSON.stringify({
+        packageName: manifest.packageName,
+        packageVersion: manifest.packageVersion,
+        protocolVersion: manifest.protocolVersion,
+        stateSchemaVersion: manifest.stateSchemaVersion,
+        files: manifest.files,
+    })).digest('hex');
+}
+function validateGraphEvidence(request, evidence) {
+    const invalid = evidence.requestId !== request.requestId ||
+        evidence.provider !== 'codebase-memory-mcp' ||
+        evidence.rootFingerprint !== request.rootFingerprint ||
+        evidence.indexedHead !== request.indexedHead ||
+        evidence.packageVersion !== request.packageVersion ||
+        evidence.manifestHash !== request.manifestHash ||
+        evidence.mode !== request.mode;
+    if (invalid || !evidence.projectKey.trim()) {
+        throw new WorkflowError('INVALID_ARGUMENT', 'Graph evidence does not match the refresh request.');
+    }
+}
+function graphSnapshot(binding) {
+    return {
+        projectKey: binding.projectKey,
+        rootFingerprint: binding.rootFingerprint,
+        indexedHead: binding.indexedHead,
+        packageVersion: binding.packageVersion,
+        manifestHash: binding.manifestHash,
+        mode: binding.mode,
+        status: binding.status,
+        nodeCount: binding.nodeCount,
+        edgeCount: binding.edgeCount,
+        observedAt: binding.observedAt,
+        evidenceHash: binding.evidenceHash,
+        fallbackReason: binding.fallbackReason,
+    };
+}
+function resolvePackageRoot() {
+    let cursor = path.dirname(fileURLToPath(import.meta.url));
+    for (let depth = 0; depth < 4; depth += 1) {
+        const packageFile = path.join(cursor, 'package.json');
+        if (existsSync(packageFile)) {
+            const parsed = JSON.parse(readFileSync(packageFile, 'utf8'));
+            if (parsed.name === PACKAGE_NAME)
+                return cursor;
+        }
+        cursor = path.dirname(cursor);
+    }
+    throw new WorkflowError('NOT_FOUND', `Cannot resolve installed ${PACKAGE_NAME} package root.`);
+}
+function copyTreeWithoutSymlinks(source, destination) {
+    const metadata = lstatSync(source);
+    if (metadata.isSymbolicLink()) {
+        throw new WorkflowError('STATE_CORRUPT', `Graph source must not be a symlink: ${source}`);
+    }
+    if (metadata.isDirectory()) {
+        mkdirSync(destination, { recursive: true, mode: 0o700 });
+        for (const entry of readdirSync(source)) {
+            copyTreeWithoutSymlinks(path.join(source, entry), path.join(destination, entry));
+        }
+        return;
+    }
+    copyFileSync(source, destination);
+}
+function listFiles(root) {
+    return readdirSync(root, { withFileTypes: true }).flatMap((entry) => {
+        const target = path.join(root, entry.name);
+        return entry.isDirectory() ? listFiles(target) : [target];
+    }).sort();
+}
+//# sourceMappingURL=graph.js.map

package/dist/src/graph.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+export * from './contracts.js';
+export * from './errors.js';
+export * from './diagnostics.js';
+export * from './graph.js';
+export * from './memory.js';
+export * from './migration.js';
+export * from './repository.js';
+export * from './reviewer.js';
+export * from './state/lock.js';
+export * from './state/store.js';
+export * from './workflow.js';
+export * from './version.js';

package/dist/src/index.js

@@ -0,0 +1,13 @@
+export * from './contracts.js';
+export * from './errors.js';
+export * from './diagnostics.js';
+export * from './graph.js';
+export * from './memory.js';
+export * from './migration.js';
+export * from './repository.js';
+export * from './reviewer.js';
+export * from './state/lock.js';
+export * from './state/store.js';
+export * from './workflow.js';
+export * from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/src/memory.d.ts

@@ -0,0 +1,9 @@
+import { type KnowledgeCategory, type KnowledgeSelection, type ProjectKnowledgeMap, type WorkflowRole } from './contracts.js';
+export declare const KNOWLEDGE_CATEGORIES: readonly KnowledgeCategory[];
+export declare function scanProjectKnowledge(repositoryRoot: string, projectId: string, now?: Date): ProjectKnowledgeMap;
+export declare function applyKnowledgeSelections(map: ProjectKnowledgeMap, selections: KnowledgeSelection[], actor: string, now?: Date): ProjectKnowledgeMap;
+export declare function reconcileKnowledgeMap(current: ProjectKnowledgeMap, scanned: ProjectKnowledgeMap): ProjectKnowledgeMap;
+export declare function inspectKnowledgeMap(current: ProjectKnowledgeMap, scanned: ProjectKnowledgeMap): ProjectKnowledgeMap;
+export declare function hashKnowledgeMap(map: Pick<ProjectKnowledgeMap, 'projectId' | 'entries' | 'gaps' | 'conflicts'>): string;
+export declare function selectKnowledgeSources(map: ProjectKnowledgeMap, role: WorkflowRole, targetPaths?: string[]): string[];
+export declare function normalizeRelativePath(value: string): string;