@open-agent-toolkit/cli 0.3.16 → 0.3.18

package/dist/commands/project/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/project/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACjE;AAgND,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0BT"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/project/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACjE;AAqND,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0BT"}

package/dist/commands/project/status.js

@@ -21,6 +21,9 @@ function formatProjectStatusLines(project) {
         `Phase: ${project.phase} (${project.phaseStatus})`,
         `Progress: ${project.progress.completed}/${project.progress.total}`,
         `Current task: ${project.progress.currentTaskId ?? 'none'}`,
+        ...project.blockers.map((blocker) => typeof blocker === 'string'
+            ? `Blocker: ${blocker}`
+            : `Blocker: ${blocker.task_id}: ${blocker.reason} (since ${blocker.since})`),
         `Recommendation: ${project.recommendation.skill}`,
         `Reason: ${project.recommendation.reason}`,
     ];

package/dist/commands/project/sync/ref-sync.d.ts

@@ -110,7 +110,17 @@ export declare function continueSynced(target: SyncTarget, git: GitRunner, optio
     now?: Date;
 }): Promise<PullResult>;
 export declare function abortSynced(target: SyncTarget, git: GitRunner): Promise<void>;
-export declare function commitRecordChange(repoRoot: string, pathspecs: string[], message: string, git: GitRunner, options: AllowlistedPathspecOptions): Promise<{
+interface RecordCommitSettlement {
+    commit: string;
+    marker: {
+        identity: string;
+        bytes: string;
+        ino: number;
+        dev: number;
+    };
+    finalize: () => Promise<void>;
+}
+export declare function commitRecordChange(repoRoot: string, pathspecs: string[], message: string, git: GitRunner, options: AllowlistedPathspecOptions, settlement?: RecordCommitSettlement): Promise<{
     sha: string;
 } | null>;
 export declare function preflightSyncedCheckout(target: SyncTarget, git: GitRunner): Promise<CheckoutPreflight>;
@@ -132,4 +142,5 @@ export declare function migrateSharedToSynced(target: SyncTarget, git: GitRunner
 export declare function rollbackCreatedSyncedProject(target: SyncTarget, git: GitRunner): Promise<void>;
 export declare function assertNestedWorktree(target: SyncTarget, git: GitRunner): Promise<void>;
 export declare function assertAllowlistedPathspecs(repoRoot: string, pathspecs: string[], options: AllowlistedPathspecOptions): void;
+export {};
 //# sourceMappingURL=ref-sync.d.ts.map

package/dist/commands/project/sync/ref-sync.d.ts.map

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

package/dist/commands/project/sync/ref-sync.js

@@ -1,6 +1,8 @@
-import { lstat, mkdir, readFile, readdir, realpath, rm, stat, writeFile, } from 'node:fs/promises';
+import { createHash, randomUUID } from 'node:crypto';
+import { lstat, link, mkdir, mkdtemp, open, readFile, readdir, realpath, rm, stat, writeFile, } from 'node:fs/promises';
 import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { ensureScopedRootGitignore } from '../../init/gitignore.js';
+import { commitExactPaths, } from '../../shared/exact-path-commit.js';
 import { getFrontmatterBlock } from '../../shared/frontmatter.js';
 import { canonicalizePath, completedSyncedRefName, isSyncedCheckout, resolveScopeRoot, SYNCED_REMOTE, syncedRefName, syncedRecordPath, } from '../../shared/project-scope.js';
 import { readOatLocalConfig, writeOatLocalConfig } from '../../../config/oat-config.js';
@@ -8,7 +10,7 @@ import { CliError } from '../../../errors/cli-error.js';
 import { copyDirectory } from '../../../fs/io.js';
 import YAML from 'yaml';
 import { isAtomicPushUnsupported, pushAtomicRefTransition, } from './git.js';
-import { buildSyncedRecord, readSyncedRecord, writeSyncedRecord, } from './record.js';
+import { buildSyncedRecord, readSyncedRecord, SyncedProjectRecordSchema, writeSyncedRecord, } from './record.js';
 export function classifyRemoteRefLookup(result, remote, ref) {
     if (result.code === 0)
         return 'present';
@@ -593,22 +595,126 @@ export async function abortSynced(target, git) {
     });
 }
 function normalizedPathspecs(repoRoot, pathspecs) {
-    return pathspecs.map((pathspec) => repoRelativePath(repoRoot, pathspec));
+    return [
+        ...new Set(pathspecs.map((pathspec) => repoRelativePath(repoRoot, pathspec))),
+    ].sort();
 }
-export async function commitRecordChange(repoRoot, pathspecs, message, git, options) {
+class PendingRecordCommitError extends CliError {
+    result;
+    constructor(message, result) {
+        super(message, result.outcome === 'blocked' ? 1 : 2);
+        this.result = result;
+    }
+}
+export async function commitRecordChange(repoRoot, pathspecs, message, git, options, settlement) {
     assertAllowlistedPathspecs(repoRoot, pathspecs, options);
     const normalized = normalizedPathspecs(repoRoot, pathspecs);
-    await git.run(['add', '--', ...normalized], { cwd: repoRoot });
-    const changed = await git.run(['diff', '--cached', '--quiet', '--', ...normalized], { cwd: repoRoot, allowFailure: true });
-    assertExpectedGitResult('git diff --cached --quiet', changed, [0, 1]);
-    if (changed.code === 0) {
-        return null;
+    await git.run(['rev-parse', '--is-inside-work-tree'], { cwd: repoRoot });
+    const gitDir = (await git.run(['rev-parse', '--absolute-git-dir'], { cwd: repoRoot })).stdout;
+    const pendingDir = join(gitDir, 'oat-record-commit-pending');
+    await mkdir(pendingDir, { recursive: true });
+    const operation = createHash('sha256')
+        .update(JSON.stringify([message, normalized]))
+        .digest('hex');
+    const pendingPath = join(pendingDir, `${operation}.json`);
+    for (let reservationAttempt = 0; reservationAttempt < 2; reservationAttempt++) {
+        if ((await readOptionalFile(pendingPath)) === null) {
+            if (settlement)
+                throw new CliError('The verified pending migration marker disappeared; preserve state for inspection.', 2);
+            const identity = `project-record:${operation}:${randomUUID()}`;
+            const temporary = await mkdtemp(join(pendingDir, 'reservation-'));
+            const complete = join(temporary, 'pending.json');
+            try {
+                await writeFile(complete, JSON.stringify({ identity, paths: normalized, message }));
+                try {
+                    await link(complete, pendingPath);
+                }
+                catch (error) {
+                    if (error.code !== 'EEXIST')
+                        throw error;
+                }
+            }
+            finally {
+                await rm(temporary, { recursive: true, force: true });
+            }
+        }
+        const file = await open(pendingPath, 'r');
+        const markerIdentity = await file.stat();
+        let markerBytes;
+        try {
+            markerBytes = await file.readFile('utf8');
+        }
+        finally {
+            await file.close();
+        }
+        const reservation = JSON.parse(markerBytes);
+        if (settlement &&
+            (reservation.identity !== settlement.marker.identity ||
+                markerBytes !== settlement.marker.bytes ||
+                markerIdentity.ino !== settlement.marker.ino ||
+                markerIdentity.dev !== settlement.marker.dev))
+            throw new CliError('The verified pending migration marker was replaced; replacement preserved for inspection.', 2);
+        const clearPending = async () => {
+            const current = await lstat(pendingPath).catch((error) => {
+                if (error.code === 'ENOENT')
+                    return undefined;
+                throw error;
+            });
+            if (!current)
+                return;
+            if (current.ino !== markerIdentity.ino ||
+                current.dev !== markerIdentity.dev ||
+                (await readOptionalFile(pendingPath)) !== markerBytes)
+                throw new CliError(`Verified commit exists, but the pending marker at ${pendingPath} was replaced; replacement preserved for inspection.`, 2);
+            await rm(pendingPath);
+        };
+        if (reservation.message !== message ||
+            JSON.stringify(reservation.paths) !== JSON.stringify(normalized) ||
+            !reservation.identity.startsWith(`project-record:${operation}:`))
+            throw new CliError(`Unreconciled lifecycle commit marker at ${pendingPath}; preserve it and inspect before retrying.`, 2);
+        const result = await commitExactPaths({
+            repoRoot,
+            paths: normalized,
+            message,
+            identity: reservation.identity,
+        });
+        // A public helper repair can settle Git while leaving our reservation. Only
+        // its positive prior/current publication proof authorizes retiring that
+        // reservation before one fresh generation. Never republish a superseded
+        // tree; a migration's finalization remains mandatory.
+        if (!settlement &&
+            reservationAttempt === 0 &&
+            result.outcome === 'failed' &&
+            result.settledCommit &&
+            result.settledCommit === result.commit) {
+            await clearPending();
+            continue;
+        }
+        if (settlement &&
+            ['committed', 'already-matching', 'nothing'].includes(result.outcome) &&
+            result.commit !== settlement.commit)
+            throw new CliError('Pending migration settlement did not return its verified commit; marker preserved for inspection.', 2);
+        if (result.outcome === 'nothing') {
+            await clearPending();
+            return null;
+        }
+        if ((result.outcome === 'committed' ||
+            result.outcome === 'already-matching') &&
+            result.commit) {
+            try {
+                await settlement?.finalize();
+                await clearPending();
+            }
+            catch (error) {
+                throw new PendingRecordCommitError(errorMessage(error), result);
+            }
+            return { sha: result.commit };
+        }
+        throw new PendingRecordCommitError(result.resumable === false
+            ? `Exact-path lifecycle commit ${result.outcome}: ${result.error ?? 'unverified result'}. Preserve the pending marker at ${pendingPath}${result.receipt ? ` and receipt at ${result.receipt}` : ''} for inspection and explicit provenance reconciliation before any further commit attempt.`
+            : `Exact-path lifecycle commit ${result.outcome}: ${result.error ?? 'unverified result'}. Retry after resolving the reported condition with: oat internal commit-paths --identity ${shellQuote(reservation.identity)} --message ${shellQuote(message)} -- ${normalized.map(shellQuote).join(' ')}${result.receipt ? `; receipt ${result.receipt}` : ''}.`, result);
     }
-    await git.run(['commit', '-m', message, '--', ...normalized], {
-        cwd: repoRoot,
-    });
-    const sha = (await git.run(['rev-parse', 'HEAD'], { cwd: repoRoot })).stdout;
-    return { sha };
+    throw new CliError('Lifecycle commit reservation changed repeatedly; preserve pending state for inspection.', 2);
 }
 export async function preflightSyncedCheckout(target, git) {
     const checkoutExists = await assertCanonicalSyncTargetIdentity(target);
@@ -888,14 +994,8 @@ export async function pruneSynced(target, git, options) {
             if (!options.commit) {
                 return { status: 'pruned', lifecycleCommit: null };
             }
-            await git.run([
-                'commit',
-                '-m',
-                `chore(oat): prune synced project ${target.slug}`,
-                '--',
-                relativeRecordPath,
-            ], { cwd: target.repoRoot });
-            const lifecycleCommit = (await git.run(['rev-parse', 'HEAD'], { cwd: target.repoRoot })).stdout;
+            const committed = await commitRecordChange(target.repoRoot, [relativeRecordPath], `chore(oat): prune synced project ${target.slug}`, git, { projectRoots: target });
+            const lifecycleCommit = committed?.sha ?? null;
             return { status: 'pruned', lifecycleCommit };
         }
     }
@@ -990,10 +1090,206 @@ async function readOptionalFile(path) {
         throw error;
     }
 }
+// Only the existing migration reservation can resume after its source was removed.
+// No ownership is inferred from the current staged index or a missing directory.
+async function verifyPendingMigration(target, git, options, sourcePath) {
+    const stop = () => {
+        throw new CliError('Pending migration does not positively match its retained operation, parent source tree and published synced checkout; preserve all state for inspection.', 2);
+    };
+    const sourceRelative = repoRelativePath(target.repoRoot, sourcePath);
+    if (!options.commit ||
+        canonicalizePath(sourcePath) !==
+            resolve(canonicalizePath(target.sharedRoot), target.slug))
+        stop();
+    if (await lstat(sourcePath).then(() => true, (error) => {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }))
+        stop();
+    const gitDir = (await git.run(['rev-parse', '--absolute-git-dir'], { cwd: target.repoRoot })).stdout;
+    const pendingDir = join(gitDir, 'oat-record-commit-pending');
+    const message = `chore(oat): migrate ${target.slug} to synced scope`;
+    const candidates = [];
+    for (const name of await readdir(pendingDir).catch((error) => {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    })) {
+        if (!name.endsWith('.json'))
+            continue;
+        const path = join(pendingDir, name);
+        const file = await open(path, 'r');
+        let bytes;
+        let identity;
+        try {
+            identity = await file.stat();
+            bytes = await file.readFile('utf8');
+        }
+        finally {
+            await file.close();
+        }
+        const marker = JSON.parse(bytes);
+        if (marker.message === message)
+            candidates.push({ name, path, bytes, marker, identity });
+    }
+    if (candidates.length !== 1)
+        stop();
+    const { name, path, bytes, marker, identity } = candidates[0];
+    if (!Array.isArray(marker.paths) ||
+        !marker.paths.every((value) => typeof value === 'string') ||
+        typeof marker.identity !== 'string')
+        stop();
+    const paths = normalizedPathspecs(target.repoRoot, marker.paths);
+    const operation = createHash('sha256')
+        .update(JSON.stringify([message, paths]))
+        .digest('hex');
+    const recordPath = syncedRecordPath(target.syncedRoot, target.slug);
+    const recordRelative = repoRelativePath(target.repoRoot, recordPath);
+    if (name !== `${operation}.json` ||
+        !marker.identity.startsWith(`project-record:${operation}:`) ||
+        JSON.stringify(paths) !== JSON.stringify(marker.paths) ||
+        !paths.includes(recordRelative) ||
+        paths.some((value) => value !== recordRelative &&
+            value !== '.gitignore' &&
+            !value.startsWith(`${sourceRelative}/`)))
+        stop();
+    const receiptPath = join(gitDir, 'oat-exact-path-commits', `${createHash('sha256').update(marker.identity).digest('hex')}.json`);
+    const receiptBytes = await readFile(receiptPath, 'utf8');
+    const receipt = JSON.parse(receiptBytes);
+    if (!receipt.commit ||
+        !receipt.tree ||
+        receipt.identity !== marker.identity ||
+        JSON.stringify(receipt.paths) !== JSON.stringify(paths))
+        stop();
+    const commit = receipt.commit;
+    if (!commit)
+        return stop();
+    const run = async (args, cwd = target.repoRoot) => (await git.run(['--literal-pathspecs', ...args], { cwd })).stdout;
+    if ((await run(['rev-parse', 'HEAD'])) !== commit ||
+        (await run(['show', '-s', '--format=%P', commit])) !== receipt.parent ||
+        (await run(['rev-parse', `${commit}^{tree}`])) !== receipt.tree ||
+        !(await run(['show', '-s', '--format=%B', commit])).includes(`Oat-Operation: ${createHash('sha256').update(marker.identity).digest('hex')}`))
+        stop();
+    const removed = (await run([
+        'ls-tree',
+        '-r',
+        '--name-only',
+        '-z',
+        receipt.parent,
+        '--',
+        sourceRelative,
+    ]))
+        .split('\0')
+        .filter(Boolean)
+        .sort();
+    if (!removed.length ||
+        JSON.stringify(removed) !==
+            JSON.stringify(paths.filter((value) => value.startsWith(`${sourceRelative}/`))))
+        stop();
+    if ((await run([
+        'ls-tree',
+        '-r',
+        '--name-only',
+        commit,
+        '--',
+        sourceRelative,
+    ])) !== '')
+        stop();
+    const emitted = (await run([
+        'diff-tree',
+        '--root',
+        '--no-commit-id',
+        '-r',
+        '--no-renames',
+        '--name-only',
+        '-z',
+        commit,
+    ]))
+        .split('\0')
+        .filter(Boolean);
+    if (emitted.some((value) => !paths.includes(value)))
+        stop();
+    const committedRecord = SyncedProjectRecordSchema.parse(JSON.parse(await run(['show', `${commit}:${recordRelative}`])));
+    const record = await readSyncedRecord(recordPath);
+    if (!record ||
+        record.slug !== target.slug ||
+        record.ref !== target.ref ||
+        record.remote !== target.remote ||
+        record.status !== 'active' ||
+        JSON.stringify(record) !== JSON.stringify(committedRecord))
+        stop();
+    if (!(await assertCanonicalSyncTargetIdentity(target)))
+        return stop();
+    await assertNestedWorktree(target, git);
+    const sha = await headSha(target, git);
+    const remote = await git.run(['ls-remote', '--exit-code', target.remote, target.ref], { cwd: target.repoRoot, allowFailure: true });
+    if (remote.code !== 0 ||
+        remote.stdout.split(/\s+/)[0] !== sha ||
+        (await run(['status', '--porcelain'], target.projectPath)) !== '' ||
+        (await run(['rev-parse', `${receipt.parent}:${sourceRelative}`])) !==
+            (await run(['rev-parse', 'HEAD^{tree}'], target.projectPath)))
+        return stop();
+    const currentMarker = await lstat(path);
+    if (currentMarker.ino !== identity.ino ||
+        currentMarker.dev !== identity.dev ||
+        (await readFile(path, 'utf8')) !== bytes ||
+        (await readFile(receiptPath, 'utf8')) !== receiptBytes)
+        stop();
+    return {
+        commit,
+        parent: receipt.parent,
+        paths,
+        message,
+        sha,
+        sourceRelative,
+        marker: {
+            identity: marker.identity,
+            bytes,
+            ino: identity.ino,
+            dev: identity.dev,
+        },
+    };
+}
+async function finalizePendingMigration(target, git, options, sourcePath) {
+    const { commit, paths, message, sha, sourceRelative, marker } = await verifyPendingMigration(target, git, options, sourcePath);
+    const committed = await commitRecordChange(target.repoRoot, paths, message, git, { projectRoots: target }, {
+        commit,
+        marker,
+        finalize: async () => {
+            const local = await (options.readOatLocalConfig ?? readOatLocalConfig)(target.repoRoot);
+            if (local.activeProject === sourceRelative)
+                await (options.writeOatLocalConfig ?? writeOatLocalConfig)(target.repoRoot, {
+                    ...local,
+                    activeProject: repoRelativePath(target.repoRoot, target.projectPath),
+                });
+        },
+    });
+    if (committed?.sha !== commit)
+        throw new CliError('Pending migration settlement did not return its verified commit; preserve state for inspection.', 2);
+    return {
+        status: 'migrated',
+        lifecycleCommit: commit,
+        sha,
+    };
+}
 export async function migrateSharedToSynced(target, git, options) {
     const sourcePath = resolve(options.sourcePath);
+    const sourceExists = await lstat(sourcePath).catch((error) => {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    });
+    if (!sourceExists) {
+        if ((await readSyncedRecord(syncedRecordPath(target.syncedRoot, target.slug))) === null)
+            await assertConfinedMigrationSource(target, sourcePath);
+        return finalizePendingMigration(target, git, options, sourcePath);
+    }
     await assertConfinedMigrationSource(target, sourcePath);
     const sourceRelative = repoRelativePath(target.repoRoot, sourcePath);
+    const sourceFiles = (await git.run(['--literal-pathspecs', 'ls-files', '-z', '--', sourceRelative], { cwd: target.repoRoot })).stdout
+        .split('\0')
+        .filter(Boolean);
     const recordPath = syncedRecordPath(target.syncedRoot, target.slug);
     const destinationRelative = repoRelativePath(target.repoRoot, target.projectPath);
     const gitignorePath = join(target.repoRoot, '.gitignore');
@@ -1030,6 +1326,7 @@ export async function migrateSharedToSynced(target, git, options) {
     let prePublishRemoteSha = null;
     let activeProjectUpdated = false;
     let gitignoreSelfHealStarted = false;
+    let migrationCommitPaths;
     try {
         if (needsGitignoreHeal) {
             const repair = await (options.ensureScopedRootGitignore ?? ensureScopedRootGitignore)(target.repoRoot, target.syncedRoot, 'synced', git, 'Cannot add the synced-project rule because .gitignore has staged or unstaged changes; commit or stash those changes, or add the managed rule manually, then retry migration.');
@@ -1054,7 +1351,12 @@ export async function migrateSharedToSynced(target, git, options) {
             (await readOptionalFile(gitignorePath)) !== originalGitignore;
         let lifecycleCommit = null;
         if (options.commit) {
-            const committed = await commitRecordChange(target.repoRoot, [sourcePath, recordPath, ...(gitignoreChanged ? [gitignorePath] : [])], `chore(oat): migrate ${target.slug} to synced scope`, git, { projectRoots: target });
+            migrationCommitPaths = [
+                ...sourceFiles,
+                recordPath,
+                ...(gitignoreChanged ? [gitignorePath] : []),
+            ];
+            const committed = await commitRecordChange(target.repoRoot, migrationCommitPaths, `chore(oat): migrate ${target.slug} to synced scope`, git, { projectRoots: target });
             lifecycleCommit = committed?.sha ?? null;
             await options.afterBranchCommit?.();
         }
@@ -1078,6 +1380,28 @@ export async function migrateSharedToSynced(target, git, options) {
         return { status: 'migrated', lifecycleCommit, sha: pushed.sha };
     }
     catch (error) {
+        if (error instanceof PendingRecordCommitError && error.result.commit) {
+            // committed:true is not a provenance proof: the helper can report a
+            // stored receipt's commit before validating it. Reuse the owning verifier
+            // and bind its proof to this invocation before choosing retention.
+            let retained;
+            try {
+                retained = await verifyPendingMigration(target, git, options, sourcePath);
+                if (retained.commit !== error.result.commit ||
+                    retained.parent !== preMigrationHead ||
+                    !migrationCommitPaths ||
+                    JSON.stringify(retained.paths) !==
+                        JSON.stringify(normalizedPathspecs(target.repoRoot, migrationCommitPaths)))
+                    throw new Error('Retained operation does not match this migration invocation.', { cause: error });
+            }
+            catch (verificationError) {
+                throw new CliError(`${error.message} Migration commit provenance could not be independently verified; no rollback or finalization was attempted. Preserve all current state and recovery metadata for inspection. ${errorMessage(verificationError)}`, 2);
+            }
+            // The verifier proved the removed source is absent. Restore only retained
+            // tree files; the owning finalizer will settle source deletions in the index.
+            const restorePaths = retained.paths.filter((value) => !value.startsWith(`${sourceRelative}/`));
+            throw new CliError(`${error.message} The verified migration commit and published synced checkout were retained. Inspect the hook's changes; removing the hook does not repair its changed bytes. After inspection, restore owned worktree bytes with: git --literal-pathspecs -C ${shellQuote(target.repoRoot)} restore --source ${shellQuote(retained.commit)} --worktree -- ${restorePaths.map(shellQuote).join(' ')}; then finalize with: oat --cwd ${shellQuote(target.repoRoot)} project migrate ${shellQuote(sourceRelative)} --to synced`, error.exitCode);
+        }
         const compensationFailures = [];
         const compensate = async (resource, recovery, action) => {
             try {

package/dist/commands/shared/agents-md-lock.d.ts

@@ -0,0 +1,3 @@
+/** Specific advisory serialization for cooperating AGENTS.md appenders. */
+export declare function acquireAgentsMdAppendLock(repoRoot: string, targetPath: string): Promise<() => Promise<void>>;
+//# sourceMappingURL=agents-md-lock.d.ts.map

package/dist/commands/shared/agents-md-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md-lock.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/agents-md-lock.ts"],"names":[],"mappings":"AAOA,2EAA2E;AAC3E,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA6I9B"}

package/dist/commands/shared/agents-md-lock.js

@@ -0,0 +1,130 @@
+import { randomUUID } from 'node:crypto';
+import { constants } from 'node:fs';
+import { lstat, open, unlink } from 'node:fs/promises';
+import { hostname } from 'node:os';
+import { relative } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+/** Specific advisory serialization for cooperating AGENTS.md appenders. */
+export async function acquireAgentsMdAppendLock(repoRoot, targetPath) {
+    const lockPath = `${targetPath}.oat-guidance.lock`;
+    const location = relative(repoRoot, lockPath);
+    const recovery = `Check the recorded host/PID and remove ${location} manually only after verifying its owner is gone, then rerun.`;
+    const token = randomUUID();
+    for (let attempt = 0; attempt < 40; attempt += 1) {
+        let handle;
+        try {
+            handle = await open(lockPath, constants.O_RDWR |
+                constants.O_CREAT |
+                constants.O_EXCL |
+                constants.O_NOFOLLOW |
+                constants.O_NONBLOCK, 0o600);
+        }
+        catch (error) {
+            if (!(error instanceof Error) ||
+                !('code' in error) ||
+                error.code !== 'EEXIST') {
+                throw new Error(`AGENTS.md append lock could not be acquired. ${recovery}`, { cause: error });
+            }
+            // Never steal, truncate, or follow a contender's lock, including stale locks.
+            let reader;
+            try {
+                reader = await open(lockPath, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+                const stat = await reader.stat();
+                if (!stat.isFile() || stat.nlink !== 1 || stat.size > 4096)
+                    throw new Error('Unsafe lock', { cause: error });
+                const content = await reader.readFile('utf8');
+                if (content === '' && attempt < 39) {
+                    await delay(25);
+                    continue;
+                }
+                const owner = JSON.parse(content);
+                if (typeof owner.token !== 'string' ||
+                    typeof owner.host !== 'string' ||
+                    !Number.isSafeInteger(owner.pid) ||
+                    owner.pid <= 0)
+                    throw new Error('Malformed lock', { cause: error });
+            }
+            catch (inspectionError) {
+                if (inspectionError instanceof Error &&
+                    'code' in inspectionError &&
+                    inspectionError.code === 'ENOENT')
+                    continue;
+                throw new Error(`AGENTS.md append lock is unsafe or malformed. ${recovery}`, { cause: inspectionError });
+            }
+            finally {
+                await reader?.close();
+            }
+            if (attempt < 39)
+                await delay(25);
+            continue;
+        }
+        const identity = await handle.stat();
+        const bytes = JSON.stringify({ token, host: hostname(), pid: process.pid });
+        let releasing;
+        let interrupted;
+        const onInt = () => {
+            interrupted = 'SIGINT';
+        };
+        const onTerm = () => {
+            interrupted = 'SIGTERM';
+        };
+        const release = () => {
+            releasing ??= (async () => {
+                process.removeListener('SIGINT', onInt);
+                process.removeListener('SIGTERM', onTerm);
+                try {
+                    const current = await lstat(lockPath);
+                    if (current.isFile() &&
+                        current.nlink === 1 &&
+                        current.dev === identity.dev &&
+                        current.ino === identity.ino &&
+                        current.size === Buffer.byteLength(bytes) &&
+                        (await readOwnedBytes()) === bytes) {
+                        const verified = await lstat(lockPath);
+                        if (verified.dev === identity.dev && verified.ino === identity.ino)
+                            await unlink(lockPath);
+                    }
+                }
+                catch (error) {
+                    if (!(error instanceof Error) ||
+                        !('code' in error) ||
+                        error.code !== 'ENOENT')
+                        throw error;
+                }
+                finally {
+                    await handle.close();
+                    if (interrupted)
+                        process.kill(process.pid, interrupted);
+                }
+            })().catch((error) => {
+                throw new Error(`AGENTS.md append lock cleanup failed; guidance may already have been written. ${recovery}`, { cause: error });
+            });
+            return releasing;
+        };
+        const readOwnedBytes = async () => {
+            const buffer = Buffer.alloc(Buffer.byteLength(bytes));
+            const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+            return buffer.subarray(0, bytesRead).toString('utf8');
+        };
+        try {
+            await handle.writeFile(bytes);
+        }
+        catch (error) {
+            // Initialization failed before returning ownership; remove only this inode.
+            try {
+                const current = await lstat(lockPath);
+                if (current.dev === identity.dev && current.ino === identity.ino)
+                    await unlink(lockPath);
+            }
+            finally {
+                await handle.close();
+            }
+            throw error;
+        }
+        // Cleanup runs after the critical section and on catchable termination.
+        process.once('SIGINT', onInt);
+        process.once('SIGTERM', onTerm);
+        return release;
+    }
+    throw new Error(`AGENTS.md append lock is held by another writer. ${recovery}`);
+}

package/dist/commands/shared/agents-md.d.ts.map

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