codex-workflow-v2 2.0.0-alpha.1

package/dist/src/memory.js

@@ -0,0 +1,242 @@
+import { createHash } from 'node:crypto';
+import { lstatSync, readFileSync, readdirSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { STATE_SCHEMA_VERSION, } from './contracts.js';
+import { WorkflowError } from './errors.js';
+export const KNOWLEDGE_CATEGORIES = [
+    'agent-guidance',
+    'onboarding',
+    'architecture',
+    'decisions',
+    'commands',
+    'ownership',
+    'testing',
+    'operations',
+    'domain',
+];
+const ignoredDirectories = new Set([
+    '.git',
+    '.worktrees',
+    '.test-dist',
+    'node_modules',
+    'dist',
+    'build',
+    'coverage',
+]);
+export function scanProjectKnowledge(repositoryRoot, projectId, now = new Date()) {
+    const root = realpathSync(repositoryRoot);
+    const timestamp = now.toISOString();
+    const entries = [];
+    walk(root, root, (absolute, relative) => {
+        const category = classifyKnowledgePath(relative);
+        if (!category)
+            return;
+        const scope = normalizeScope(path.posix.dirname(relative));
+        entries.push({
+            id: sourceId(category, relative),
+            category,
+            path: relative,
+            scope,
+            authority: 'supporting',
+            contentHash: hashFile(absolute),
+            discoveredBy: 'repository-scan',
+            lastVerifiedAt: timestamp,
+        });
+    });
+    entries.sort(compareSources);
+    const gaps = knowledgeGaps(entries);
+    return {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        revision: 0,
+        id: 'PROJECT-KNOWLEDGE-MAP',
+        projectId,
+        createdAt: timestamp,
+        updatedAt: timestamp,
+        kind: 'knowledge-map',
+        status: 'awaiting_approval',
+        entries,
+        gaps,
+        conflicts: [],
+        approval: null,
+    };
+}
+export function applyKnowledgeSelections(map, selections, actor, now = new Date()) {
+    const byId = new Map(map.entries.map((entry) => [entry.id, entry]));
+    const selectedIds = new Set();
+    for (const selection of selections) {
+        if (selectedIds.has(selection.sourceId)) {
+            throw new WorkflowError('INVALID_ARGUMENT', `Duplicate knowledge selection: ${selection.sourceId}`);
+        }
+        selectedIds.add(selection.sourceId);
+        if (!byId.has(selection.sourceId)) {
+            throw new WorkflowError('INVALID_ARGUMENT', `Unknown knowledge source: ${selection.sourceId}`);
+        }
+    }
+    const authority = new Map(selections.map((selection) => [selection.sourceId, selection.authority]));
+    const entries = map.entries
+        .map((entry) => ({ ...entry, authority: authority.get(entry.id) ?? entry.authority }))
+        .sort(compareSources);
+    const conflicts = knowledgeConflicts(entries);
+    const candidate = {
+        ...map,
+        entries,
+        gaps: knowledgeGaps(entries),
+        conflicts,
+        approval: null,
+        status: conflicts.length > 0 ? 'conflicted' : 'awaiting_approval',
+    };
+    if (conflicts.length > 0)
+        return candidate;
+    const mapHash = hashKnowledgeMap(candidate);
+    return {
+        ...candidate,
+        status: 'active',
+        approval: {
+            mapHash,
+            actor: actor.trim() || 'user',
+            approvedAt: now.toISOString(),
+        },
+    };
+}
+export function reconcileKnowledgeMap(current, scanned) {
+    const previous = new Map(current.entries.map((entry) => [`${entry.category}\0${entry.path}\0${entry.scope}`, entry]));
+    const entries = scanned.entries.map((entry) => {
+        const existing = previous.get(`${entry.category}\0${entry.path}\0${entry.scope}`);
+        return existing ? { ...entry, authority: existing.authority } : entry;
+    });
+    const conflicts = knowledgeConflicts(entries);
+    const candidate = {
+        ...scanned,
+        createdAt: current.createdAt,
+        entries: entries.sort(compareSources),
+        gaps: knowledgeGaps(entries),
+        conflicts,
+        status: conflicts.length > 0 ? 'conflicted' : 'awaiting_approval',
+    };
+    if (current.status !== 'active' || !current.approval)
+        return candidate;
+    return hashKnowledgeMap(candidate) === current.approval.mapHash
+        ? { ...candidate, status: 'active', approval: current.approval }
+        : { ...candidate, status: conflicts.length > 0 ? 'conflicted' : 'stale', approval: null };
+}
+export function inspectKnowledgeMap(current, scanned) {
+    const reconciled = reconcileKnowledgeMap(current, scanned);
+    return { ...reconciled, revision: current.revision, updatedAt: current.updatedAt };
+}
+export function hashKnowledgeMap(map) {
+    const stable = {
+        projectId: map.projectId,
+        entries: [...map.entries].sort(compareSources).map(({ lastVerifiedAt: _verified, ...entry }) => entry),
+        gaps: [...map.gaps].sort(compareGaps),
+        conflicts: [...map.conflicts].sort(compareConflicts),
+    };
+    return createHash('sha256').update(JSON.stringify(stable)).digest('hex');
+}
+export function selectKnowledgeSources(map, role, targetPaths = []) {
+    const targets = new Set(targetPaths.map(normalizeRelativePath));
+    const roleCategories = {
+        'scope-lead': new Set(KNOWLEDGE_CATEGORIES),
+        'technical-planner': new Set(['agent-guidance', 'onboarding', 'architecture', 'decisions', 'commands', 'ownership', 'testing', 'domain']),
+        'delivery-coordinator': new Set(['agent-guidance', 'commands', 'ownership', 'testing', 'operations']),
+        worker: new Set(['agent-guidance', 'commands', 'testing']),
+        'independent-reviewer': new Set(KNOWLEDGE_CATEGORIES),
+    };
+    return map.entries
+        .filter((entry) => entry.authority === 'canonical' || targets.has(entry.path))
+        .filter((entry) => roleCategories[role].has(entry.category) || targets.has(entry.path))
+        .map((entry) => entry.path)
+        .sort();
+}
+export function normalizeRelativePath(value) {
+    const normalized = value.replaceAll('\\', '/').replace(/^\.\//, '');
+    if (!normalized || normalized === '.' || path.posix.isAbsolute(normalized)) {
+        throw new WorkflowError('INVALID_ARGUMENT', `Knowledge path must be repository-relative: ${value}`);
+    }
+    const clean = path.posix.normalize(normalized);
+    if (clean === '..' || clean.startsWith('../')) {
+        throw new WorkflowError('INVALID_ARGUMENT', `Knowledge path escapes repository root: ${value}`);
+    }
+    return clean;
+}
+function walk(root, directory, visit) {
+    const entries = readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+        if (entry.isDirectory() && ignoredDirectories.has(entry.name))
+            continue;
+        const absolute = path.join(directory, entry.name);
+        if (entry.isSymbolicLink())
+            continue;
+        if (entry.isDirectory()) {
+            walk(root, absolute, visit);
+            continue;
+        }
+        if (!entry.isFile() || !lstatSync(absolute).isFile())
+            continue;
+        const relative = path.relative(root, absolute).replaceAll(path.sep, '/');
+        visit(absolute, normalizeRelativePath(relative));
+    }
+}
+function classifyKnowledgePath(relative) {
+    const lower = relative.toLowerCase();
+    const base = path.posix.basename(lower);
+    if (base === 'agents.md')
+        return 'agent-guidance';
+    if (/^readme(?:\.[a-z0-9_-]+)?$/.test(base))
+        return 'onboarding';
+    if (base === 'codeowners' || base === 'owners')
+        return 'ownership';
+    if (base === 'package.json' || base === 'makefile' || base === 'justfile' || /^taskfile(?:\..+)?$/.test(base))
+        return 'commands';
+    if (/(^|\/)(adr|adrs|decisions)(\/|$)/.test(lower) || /^adr[-_].+\.md$/.test(base))
+        return 'decisions';
+    if (/(^|\/)(architecture|architectures)(\/|$)/.test(lower) || /architecture.*\.md$/.test(base))
+        return 'architecture';
+    if (/(^|\/)(domain|domains)(\/|$)/.test(lower))
+        return 'domain';
+    if (/(^|\/)(operations|runbooks?)(\/|$)/.test(lower) || /^dockerfile/.test(base) || /^compose.*\.ya?ml$/.test(base))
+        return 'operations';
+    if (/(^|\/)(\.github\/workflows|tests?|testing)(\/|$)/.test(lower) || /^(vitest|jest|playwright|cypress|pytest|test).*(json|js|ts|mjs|cjs|toml|ini)$/.test(base))
+        return 'testing';
+    return null;
+}
+function knowledgeGaps(entries) {
+    const present = new Set(entries.map((entry) => entry.category));
+    return KNOWLEDGE_CATEGORIES
+        .filter((category) => !present.has(category))
+        .map((category) => ({ category, scope: '.', reason: `No ${category} source was discovered.` }));
+}
+function knowledgeConflicts(entries) {
+    const groups = new Map();
+    for (const entry of entries.filter((candidate) => candidate.authority === 'canonical')) {
+        const key = `${entry.category}\0${entry.scope}`;
+        groups.set(key, [...(groups.get(key) ?? []), entry]);
+    }
+    return [...groups.values()]
+        .filter((group) => group.length > 1)
+        .map((group) => ({
+        category: group[0].category,
+        scope: group[0].scope,
+        sourceIds: group.map((entry) => entry.id).sort(),
+        reason: 'More than one canonical source exists for the same category and scope.',
+    }))
+        .sort(compareConflicts);
+}
+function sourceId(category, relative) {
+    return `KS-${createHash('sha256').update(`${category}\0${relative}`).digest('hex').slice(0, 16)}`;
+}
+function hashFile(file) {
+    return createHash('sha256').update(readFileSync(file)).digest('hex');
+}
+function normalizeScope(value) {
+    return value === '.' || value === '' ? '.' : normalizeRelativePath(value);
+}
+function compareSources(left, right) {
+    return `${left.category}\0${left.scope}\0${left.path}`.localeCompare(`${right.category}\0${right.scope}\0${right.path}`);
+}
+function compareGaps(left, right) {
+    return `${left.category}\0${left.scope}`.localeCompare(`${right.category}\0${right.scope}`);
+}
+function compareConflicts(left, right) {
+    return `${left.category}\0${left.scope}`.localeCompare(`${right.category}\0${right.scope}`);
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/memory.js.map

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

package/dist/src/migration.d.ts

@@ -0,0 +1,46 @@
+import { FileStateStore } from './state/store.js';
+interface SnapshotFile {
+    path: string;
+    mode: number;
+    size: number;
+    sha256: string;
+    contentBase64: string;
+}
+interface LegacySnapshot {
+    format: 'codex-workflow-v1-snapshot';
+    version: 1;
+    projectId: string;
+    repositoryRootFingerprint: string;
+    git: {
+        head: string;
+        branch: string | null;
+        statusPorcelainV1: string[];
+        refs: string[];
+    };
+    files: SnapshotFile[];
+}
+export interface MigrationReport {
+    dryRun: boolean;
+    snapshotRequested: boolean;
+    projectId: string;
+    stateSchemaVersion: number;
+    entities: {
+        discoveries: number;
+        tasks: number;
+        milestones: number;
+    };
+    actions: string[];
+    legacy: {
+        detected: boolean;
+        paths: string[];
+        automaticMappingSupported: false;
+    };
+    snapshot: null | {
+        format: LegacySnapshot['format'];
+        contentHash: string;
+        file: string;
+        fileCount: number;
+    };
+}
+export declare function migrateState(repository: string, store: FileStateStore, dryRun: boolean, snapshotRequested?: boolean): MigrationReport;
+export {};

package/dist/src/migration.js

@@ -0,0 +1,112 @@
+import { createHash } from 'node:crypto';
+import { existsSync, lstatSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { gzipSync } from 'node:zlib';
+import { STATE_SCHEMA_VERSION } from './contracts.js';
+import { WorkflowError } from './errors.js';
+import { ensureDirectory } from './fs-utils.js';
+import { resolveRepositoryIdentity, runGit } from './repository.js';
+const LEGACY_CANDIDATES = ['.tasks', '.increments', '.codex-workflow.json', '.codex-workflow.lock.json'];
+export function migrateState(repository, store, dryRun, snapshotRequested = !dryRun) {
+    if (dryRun && snapshotRequested) {
+        throw new WorkflowError('INVALID_ARGUMENT', 'Choose either migration dry-run or snapshot creation.');
+    }
+    const identity = resolveRepositoryIdentity(repository);
+    store.registerProject(identity);
+    const legacyPaths = LEGACY_CANDIDATES.filter((candidate) => existsSync(path.join(identity.repositoryRoot, candidate)));
+    const report = {
+        dryRun,
+        snapshotRequested,
+        projectId: identity.projectId,
+        stateSchemaVersion: STATE_SCHEMA_VERSION,
+        entities: {
+            discoveries: store.listDiscoveries(identity.projectId).length,
+            tasks: store.listTasks(identity.projectId).length,
+            milestones: store.listMilestones(identity.projectId).length,
+        },
+        actions: [],
+        legacy: {
+            detected: legacyPaths.length > 0,
+            paths: legacyPaths,
+            automaticMappingSupported: false,
+        },
+        snapshot: null,
+    };
+    if (!snapshotRequested)
+        return report;
+    if (legacyPaths.length === 0) {
+        throw new WorkflowError('NOT_FOUND', 'No legacy V1 workflow state was detected.');
+    }
+    const snapshot = buildSnapshot(identity.repositoryRoot, identity.projectId, legacyPaths);
+    const bytes = gzipSync(Buffer.from(`${JSON.stringify(snapshot)}\n`, 'utf8'), { level: 9 });
+    const contentHash = createHash('sha256').update(bytes).digest('hex');
+    const directory = store.snapshotRoot(identity.projectId);
+    const file = path.join(directory, `${contentHash}.snapshot.json.gz`);
+    ensureDirectory(directory);
+    if (!existsSync(file))
+        writeFileSync(file, bytes, { mode: 0o600, flag: 'wx' });
+    report.actions.push('Created immutable legacy snapshot; no V1 state was imported or modified.');
+    report.snapshot = {
+        format: snapshot.format,
+        contentHash,
+        file,
+        fileCount: snapshot.files.length,
+    };
+    return report;
+}
+function buildSnapshot(repositoryRoot, projectId, legacyPaths) {
+    const files = legacyPaths.flatMap((relative) => collectFiles(repositoryRoot, relative));
+    files.sort((left, right) => left.path.localeCompare(right.path));
+    const branch = safeGit(repositoryRoot, ['symbolic-ref', '--short', 'HEAD']) || null;
+    return {
+        format: 'codex-workflow-v1-snapshot',
+        version: 1,
+        projectId,
+        repositoryRootFingerprint: createHash('sha256').update(path.resolve(repositoryRoot)).digest('hex'),
+        git: {
+            head: runGit(repositoryRoot, ['rev-parse', 'HEAD']),
+            branch,
+            statusPorcelainV1: safeGit(repositoryRoot, ['status', '--porcelain=v1', '--untracked-files=all'])
+                .split('\n')
+                .filter(Boolean)
+                .sort(),
+            refs: safeGit(repositoryRoot, ['for-each-ref', '--format=%(refname) %(objectname)'])
+                .split('\n')
+                .filter(Boolean)
+                .sort(),
+        },
+        files,
+    };
+}
+function collectFiles(repositoryRoot, relative) {
+    const absolute = path.join(repositoryRoot, relative);
+    const stat = lstatSync(absolute);
+    if (stat.isSymbolicLink()) {
+        throw new WorkflowError('TRANSITION_BLOCKED', `Legacy snapshot rejects symbolic link: ${relative}`);
+    }
+    if (stat.isDirectory()) {
+        return readdirSync(absolute)
+            .sort()
+            .flatMap((name) => collectFiles(repositoryRoot, path.join(relative, name)));
+    }
+    if (!stat.isFile()) {
+        throw new WorkflowError('TRANSITION_BLOCKED', `Legacy snapshot supports regular files only: ${relative}`);
+    }
+    const content = readFileSync(absolute);
+    return [{
+            path: relative.split(path.sep).join('/'),
+            mode: stat.mode & 0o777,
+            size: content.length,
+            sha256: createHash('sha256').update(content).digest('hex'),
+            contentBase64: content.toString('base64'),
+        }];
+}
+function safeGit(repositoryRoot, args) {
+    try {
+        return runGit(repositoryRoot, args);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=migration.js.map

package/dist/src/migration.js.map

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

package/dist/src/repository.d.ts

@@ -0,0 +1,12 @@
+export interface RepositoryIdentity {
+    projectId: string;
+    repositoryRoot: string;
+    gitCommonDir: string;
+}
+export declare function runGit(repositoryRoot: string, args: string[], allowFailure?: boolean): string;
+export declare function resolveRepositoryIdentity(repository: string): RepositoryIdentity;
+export declare function currentBranch(repositoryRoot: string): string | null;
+export declare function headCommit(repositoryRoot: string): string;
+export declare function changedFiles(repositoryRoot: string): string[];
+export declare function isClean(repositoryRoot: string): boolean;
+export declare function gitIsAncestor(repositoryRoot: string, ancestor: string, descendant: string): boolean;

package/dist/src/repository.js

@@ -0,0 +1,69 @@
+import { createHash } from 'node:crypto';
+import { realpathSync } from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { WorkflowError } from './errors.js';
+export function runGit(repositoryRoot, args, allowFailure = false) {
+    const result = spawnSync('git', ['-C', repositoryRoot, ...args], { encoding: 'utf8' });
+    if (result.status !== 0 && !allowFailure) {
+        throw new WorkflowError('COMMAND_FAILED', `git ${args.join(' ')} failed`, {
+            stdout: result.stdout.trim(),
+            stderr: result.stderr.trim(),
+            exitCode: result.status,
+        });
+    }
+    return result.stdout.trim();
+}
+export function resolveRepositoryIdentity(repository) {
+    const repositoryRoot = realpathSync(runGit(repository, ['rev-parse', '--show-toplevel']));
+    const rawCommonDir = runGit(repositoryRoot, ['rev-parse', '--git-common-dir']);
+    const commonCandidate = path.isAbsolute(rawCommonDir)
+        ? rawCommonDir
+        : path.resolve(repositoryRoot, rawCommonDir);
+    const gitCommonDir = realpathSync(commonCandidate);
+    const projectId = createHash('sha256').update(gitCommonDir).digest('hex').slice(0, 24);
+    return { projectId, repositoryRoot, gitCommonDir };
+}
+export function currentBranch(repositoryRoot) {
+    const branch = runGit(repositoryRoot, ['branch', '--show-current'], true);
+    return branch || null;
+}
+export function headCommit(repositoryRoot) {
+    return runGit(repositoryRoot, ['rev-parse', 'HEAD']);
+}
+export function changedFiles(repositoryRoot) {
+    const result = spawnSync('git', ['-C', repositoryRoot, 'status', '--porcelain=v1', '--untracked-files=all'], { encoding: 'utf8' });
+    if (result.status !== 0) {
+        throw new WorkflowError('COMMAND_FAILED', 'Unable to inspect Git working tree.', {
+            stdout: result.stdout.trim(),
+            stderr: result.stderr.trim(),
+            exitCode: result.status,
+        });
+    }
+    const output = result.stdout.trimEnd();
+    if (!output)
+        return [];
+    return output.split('\n').map((line) => {
+        const entry = line.slice(3).trim();
+        const renameTarget = entry.includes(' -> ') ? entry.split(' -> ').at(-1) : entry;
+        return renameTarget?.replaceAll('\\', '/') ?? entry;
+    });
+}
+export function isClean(repositoryRoot) {
+    return changedFiles(repositoryRoot).length === 0;
+}
+export function gitIsAncestor(repositoryRoot, ancestor, descendant) {
+    const result = spawnSync('git', ['-C', repositoryRoot, 'merge-base', '--is-ancestor', ancestor, descendant], { encoding: 'utf8' });
+    if (result.status === 0)
+        return true;
+    if (result.status === 1)
+        return false;
+    throw new WorkflowError('COMMAND_FAILED', 'Unable to verify Git ancestry.', {
+        ancestor,
+        descendant,
+        stdout: result.stdout.trim(),
+        stderr: result.stderr.trim(),
+        exitCode: result.status,
+    });
+}
+//# sourceMappingURL=repository.js.map

package/dist/src/repository.js.map

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

package/dist/src/reviewer.d.ts

@@ -0,0 +1,82 @@
+import type { ContextEnvelope, ReviewInput, TaskState } from './contracts.js';
+export interface ReviewerProcessResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+}
+export type ReviewerCommandRunner = (command: string, args: string[], options: {
+    cwd: string;
+    input: string;
+}) => ReviewerProcessResult;
+export interface StrictReviewOutput extends ReviewInput {
+    isolationProbe: 'denied' | 'written' | 'not-attempted';
+}
+export interface StrictReviewerLaunchResult {
+    review: ReviewInput;
+    verifiedIsolation: boolean;
+    command: string[];
+    processStatus: number | null;
+    stderr: string;
+    before: RepositorySeal;
+    after: RepositorySeal;
+}
+interface RepositorySeal {
+    headCommit: string;
+    changedFiles: string[];
+    contentHash: string;
+}
+declare const REVIEW_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["status", "reviewer", "summary", "findings", "isolationProbe"];
+    readonly properties: {
+        readonly status: {
+            readonly enum: readonly ["passed", "failed", "unverified"];
+        };
+        readonly reviewer: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly summary: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly isolationProbe: {
+            readonly enum: readonly ["denied", "written", "not-attempted"];
+        };
+        readonly findings: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "severity", "requirement", "summary", "evidence", "requiredAction"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly severity: {
+                        readonly enum: readonly ["critical", "major", "minor"];
+                    };
+                    readonly requirement: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly summary: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly evidence: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly requiredAction: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+            };
+        };
+    };
+};
+export declare function launchStrictReviewer(repositoryRoot: string, task: TaskState, taskRoot: string, envelope: ContextEnvelope, runner?: ReviewerCommandRunner): StrictReviewerLaunchResult;
+export { REVIEW_SCHEMA };