@aviaratech/ai-delivery 0.3.17 → 0.3.19

package/dist/lifecycle.test.js

@@ -15,6 +15,7 @@ import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
 import { AI_DELIVERY_MCP_TOOLS } from './mcp/tools.js';
 import { createAiDeliveryMcpServer } from './mcp/index.js';
 import { loadDeliveryConfig, parseDeliveryConfig } from './config/deliveryConfig.js';
+import * as deliveryConfiguration from './config/deliveryConfig.js';
 import { digestValue, stableJson } from './delivery/index.js';
 import { contextFor, executeTool, resumedIssueUpdate, startTrackedIssue } from './dispatch.js';
 import { defaultBaseRef, gitCommonDir } from './git.js';
@@ -23,7 +24,7 @@ import * as atomicJson from './utils/atomicJson.js';
 import { createIssue, developIssue, listIssueSubissues, readyCheck, resumeCreatedIssue, updateIssue, } from './issue.js';
 import { checkoutPr, finishIssue, listPrs, mergePr, prChecks, prInfo, publishPr, submitFormalReview } from './pr.js';
 import { addWorktreeEntry, assertNativeIssueTrackingAdmission, getIssueWorktreeStrict, removeWorktreeEntry, updateIssueWorktreeDelivery, } from './services/worktreeRegistry.js';
-import { assertDeliveryRuntimeAdmitted } from './services/deliveryAdmission.js';
+import { assertDeliveryRuntimeAdmitted, buildRuntimeAdmission, } from './services/deliveryAdmission.js';
 import { getDeliveryRecords } from './services/deliveryRecordService.js';
 import { createIssuePhaseEvidence, loadVerifiedRun, verifyIssue } from './verification.js';
 import { cleanupNonIssueWorktree, prepareIssueWorktree, preparePrWorktree, prepareStandaloneWorktree, } from './worktree.js';
@@ -369,6 +370,1360 @@ export default {
         throw error;
     }
 }
+async function sourcePhaseFixture(options = {}) {
+    const fixtureResult = await fixture(options);
+    const { root } = fixtureResult;
+    const identity = (await loadDeliveryConfig(root)).config.roles.author.identity;
+    const sdkRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+    const runtimeEntryPath = join(sdkRoot, 'dist', 'cli.js');
+    const packageVersion = JSON.parse(readFileSync(join(sdkRoot, 'package.json'), 'utf8'))
+        .version;
+    const selectedAdmission = buildRuntimeAdmission({
+        cliPath: runtimeEntryPath,
+        mcpLauncherPath: join(sdkRoot, 'plugins', 'ai-delivery', 'dist', 'mcp-launcher.js'),
+        pluginManifestPath: join(sdkRoot, 'plugins', 'ai-delivery', '.claude-plugin', 'plugin.json'),
+        packageVersion,
+        sourceArchiveSha256: digestValue('synthetic source-phase archive'),
+        sourceCommit: git(sdkRoot, 'rev-parse', 'HEAD'),
+        configuration: await loadDeliveryConfig(root),
+    });
+    writeFileSync(join(root, '.git', 'ai-delivery', 'runtime-admission.json'), JSON.stringify(selectedAdmission), {
+        mode: 0o600,
+    });
+    const row = await prepareIssueWorktree({
+        identity: options.custodianIdentity ?? identity,
+        issueNumber: 17,
+        repoRoot: root,
+    });
+    const outputRoot = join(root, '.git', 'source-phase-output');
+    const callerPath = join(root, '.git', 'source-phase-caller.mjs');
+    const authorizationPath = join(root, '.git', 'source-phase-authorization.json');
+    writeFileSync(callerPath, '// frozen synthetic source caller\n', { mode: 0o600 });
+    writeFileSync(authorizationPath, '{"source":"synthetic reviewed source allocation"}\n', { mode: 0o600 });
+    const executable = realpathSync(process.execPath);
+    const stat = lstatSync(executable);
+    const commands = [0, 1, 2].map((index) => ({
+        argv: [executable, '-e', `console.log(process.env.SOURCE_PHASE_VALUE + ':${String(index)}')`],
+        cwd: row.path,
+        executable: {
+            path: executable,
+            digest: sha256(executable),
+            device: stat.dev,
+            inode: stat.ino,
+            uid: stat.uid,
+            mode: stat.mode,
+        },
+    }));
+    const overrides = { SOURCE_PHASE_VALUE: 'frozen' };
+    const environment = { ...process.env, ...overrides };
+    delete environment.AI_DELIVERY_OUTPUT_OBSERVATION_GATE;
+    const admission = await assertDeliveryRuntimeAdmitted({ repoRoot: root, runtimeEntryPath });
+    const input = {
+        repoRoot: root,
+        issueNumber: 17,
+        identity,
+        rowDigest: digestValue(row),
+        controller: {
+            head: git(root, 'rev-parse', 'HEAD'),
+            configDigest: (await loadDeliveryConfig(root)).configDigest,
+            admissionId: admission.admissionId,
+            runtimeEntryPath,
+            packageVersion: admission.packageVersion,
+            archiveDigest: admission.sourceArchiveSha256,
+        },
+        source: {
+            path: row.path,
+            branch: row.branch,
+            head: git(row.path, 'rev-parse', 'HEAD'),
+            indexTree: git(row.path, 'write-tree'),
+            configDigest: (await loadDeliveryConfig(row.path)).configDigest,
+            dirty: [],
+            effect: { kind: 'preserve' },
+        },
+        caller: { path: callerPath, digest: sha256(callerPath) },
+        authorization: { path: authorizationPath, digest: sha256(authorizationPath) },
+        inputs: [],
+        commands,
+        commandGraphDigest: digestValue(commands),
+        environment: { digest: digestValue(environment), overrides },
+        bounds: {
+            maxAggregateRssBytes: 1024 ** 3,
+            maxNewOutputBytes: 4 * 1024 ** 2,
+            minFreeDiskBytes: 1,
+            outputRoots: [outputRoot, join(root, '.git', 'ai-delivery')],
+        },
+        completionArtifacts: [join(outputRoot, 'metadata.json')],
+    };
+    return { ...fixtureResult, runtimeEntryPath, row, outputRoot, input, selectedAdmission };
+}
+function sourcePhaseRecords(root) {
+    const directory = join(gitCommonDir(root), 'ai-delivery', 'receipts', 'source-phase@1');
+    return readdirSync(directory).flatMap((subject) => readdirSync(join(directory, subject)).map((name) => JSON.parse(readFileSync(join(directory, subject, name), 'utf8'))));
+}
+test('supported issue source phase freezes three ordered commands and reuses only the completed whole phase', async () => {
+    const { root, outputRoot, input, selectedAdmission } = await sourcePhaseFixture();
+    try {
+        const agent = await import('./agent.js');
+        assert.equal(typeof agent.withIssueSourcePhase, 'function', 'the source capability must be public');
+        assert.notEqual(selectedAdmission.sourceCommit, input.controller.head, 'producer and consumer are separate repositories');
+        let entered = 0;
+        const receipt = await agent.withIssueSourcePhase(input, async (context) => {
+            entered += 1;
+            mkdirSync(outputRoot, { mode: 0o700 });
+            writeFileSync(join(outputRoot, 'metadata.json'), '{"owned":true}\n');
+            const inherited = process.env.SOURCE_PHASE_VALUE;
+            process.env.SOURCE_PHASE_VALUE = 'changed-after-freeze';
+            try {
+                for (let index = 0; index < input.commands.length; index++) {
+                    assert.equal((await context.run(index)).toString().trim(), `frozen:${String(index)}`);
+                }
+            }
+            finally {
+                if (inherited === undefined)
+                    delete process.env.SOURCE_PHASE_VALUE;
+                else
+                    process.env.SOURCE_PHASE_VALUE = inherited;
+            }
+        });
+        assert.equal(receipt.status, 'complete');
+        assert.equal(receipt.source.head, input.source.head);
+        assert.equal(receipt.commands.length, 3);
+        assert.equal(sourcePhaseRecords(root)[0]?.status, 'complete');
+        const reused = await agent.withIssueSourcePhase(input, async () => {
+            entered += 1;
+        });
+        assert.equal(reused.recordId, receipt.recordId);
+        assert.equal(entered, 1);
+        assert.equal(readdirSync(join(gitCommonDir(root), 'ai-delivery', 'writers@1')).some((name) => name.endsWith('.json')), false);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase preserves historical custody under the configured authenticated author', async () => {
+    const { root, row, outputRoot, input } = await sourcePhaseFixture({
+        personalAuthor: true,
+        custodianIdentity: 'historical-builder',
+    });
+    const owners = join(gitCommonDir(root), 'ai-delivery', 'worktree-owners');
+    const witnessNames = readdirSync(owners);
+    const witnesses = witnessNames.map((name) => ({ path: join(owners, name), bytes: readFileSync(join(owners, name)) }));
+    const registryPath = join(root, '.issue-cli', 'worktrees.json');
+    const registryBytes = readFileSync(registryPath);
+    const registered = getIssueWorktreeStrict(input.issueNumber, root);
+    let entered = 0;
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        assert.equal(row.identity, 'historical-builder');
+        assert.equal(input.identity, 'host-author');
+        const receipt = await withIssueSourcePhase(input, async (context) => {
+            entered += 1;
+            assert.equal(context.actor.identity, input.identity);
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        });
+        assert.equal(receipt.status, 'complete');
+        assert.equal(receipt.commands.length, input.commands.length);
+        const record = sourcePhaseRecords(root).find((value) => value.recordId === receipt.recordId);
+        assert.equal(record.actor.identity, 'host-author');
+        assert.equal(record.binding.rowDigest, digestValue(registered));
+        assert.deepEqual(getIssueWorktreeStrict(input.issueNumber, root), registered);
+        assert.ok(readFileSync(registryPath).equals(registryBytes));
+        assert.deepEqual(readdirSync(owners), witnessNames);
+        for (const witness of witnesses)
+            assert.ok(readFileSync(witness.path).equals(witness.bytes));
+        const reused = await withIssueSourcePhase(input, async () => {
+            entered += 1;
+        });
+        assert.equal(reused.recordId, receipt.recordId);
+        assert.equal(entered, 1);
+        assert.deepEqual(getIssueWorktreeStrict(input.issueNumber, root), registered);
+        assert.ok(readFileSync(registryPath).equals(registryBytes));
+        for (const witness of witnesses)
+            assert.ok(readFileSync(witness.path).equals(witness.bytes));
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test.each(['author', 'issue', 'worktree', 'row', 'missing-witness', 'changed-witness'])('supported issue source phase preserves historical custody fences for wrong %s', async (mode) => {
+    const { root, row, outputRoot, input } = await sourcePhaseFixture({
+        personalAuthor: true,
+        custodianIdentity: 'historical-builder',
+    });
+    let entered = false;
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        if (mode === 'author')
+            input.identity = 'historical-builder';
+        if (mode === 'issue')
+            input.issueNumber += 1;
+        if (mode === 'worktree')
+            input.source.path = root;
+        if (mode === 'row')
+            input.rowDigest = digestValue({ ...row, identity: input.identity });
+        if (mode === 'missing-witness' || mode === 'changed-witness') {
+            const owners = join(gitCommonDir(root), 'ai-delivery', 'worktree-owners');
+            const names = readdirSync(owners);
+            assert.equal(names.length, 1);
+            const witness = join(owners, names[0]);
+            if (mode === 'missing-witness')
+                unlinkSync(witness);
+            else {
+                const stored = JSON.parse(readFileSync(witness, 'utf8'));
+                stored.ownerId = digestValue('tampered witness');
+                writeFileSync(witness, JSON.stringify(stored));
+            }
+        }
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), mode === 'author'
+            ? /actor.*binding changed/u
+            : mode === 'issue'
+                ? /canonical registry row/u
+                : mode === 'worktree' || mode === 'row'
+                    ? /exact registered issue owner/u
+                    : /ownership witness/u);
+        assert.equal(entered, false);
+        assert.equal(existsSync(outputRoot), false, 'no source command or callback output was created');
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase refuses a linked worktree as its primary controller', async () => {
+    const { root, row, input } = await sourcePhaseFixture();
+    input.repoRoot = row.path;
+    let entered = false;
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), /canonical primary controller/u);
+        assert.equal(entered, false);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase authenticates its configured author before callback entry', async () => {
+    const { root, input } = await sourcePhaseFixture();
+    let entered = false;
+    const unavailable = vi
+        .spyOn(githubClient, 'createDeliveryGitHubClients')
+        .mockRejectedValueOnce(new Error('Missing selected author credentials'));
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), /Missing selected author credentials/u);
+        assert.equal(entered, false);
+    }
+    finally {
+        unavailable.mockRestore();
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase refuses an admitted CLI from a different executing installation', async () => {
+    const { root, input, selectedAdmission } = await sourcePhaseFixture();
+    const selectedRoot = join(root, '.git', 'different-selected-runtime');
+    mkdirSync(selectedRoot);
+    const sdkRoot = dirname(dirname(input.controller.runtimeEntryPath));
+    cpSync(join(sdkRoot, 'dist'), join(selectedRoot, 'dist'), { recursive: true });
+    cpSync(join(sdkRoot, 'package.json'), join(selectedRoot, 'package.json'));
+    const admission = buildRuntimeAdmission({
+        ...selectedAdmission,
+        cliPath: join(selectedRoot, 'dist', 'cli.js'),
+        configuration: await loadDeliveryConfig(root),
+    });
+    writeFileSync(join(root, '.git', 'ai-delivery', 'runtime-admission.json'), JSON.stringify(admission), {
+        mode: 0o600,
+    });
+    input.controller.runtimeEntryPath = admission.cliPath;
+    input.controller.admissionId = admission.admissionId;
+    let entered = false;
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), /executing.*installation/u);
+        assert.equal(entered, false);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase refuses a matching existing commit without completed phase proof', async () => {
+    const { root, row, outputRoot, input } = await sourcePhaseFixture();
+    input.source.effect = { kind: 'commitOnce', parent: input.source.head, tree: input.source.indexTree };
+    const committed = git(row.path, 'commit-tree', input.source.indexTree, '-p', input.source.head, '-m', 'Previously published source');
+    git(row.path, 'update-ref', `refs/heads/${row.branch}`, committed);
+    let entered = false;
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            entered = true;
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        }), /initial source/u);
+        assert.equal(entered, false);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase cannot replay a failed command even when its callback catches the error', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    const counter = join(outputRoot, 'attempts.txt');
+    input.commands[0].argv = [
+        realpathSync(process.execPath),
+        '-e',
+        `const fs=require('fs');fs.appendFileSync(${JSON.stringify(counter)},'x');if(fs.readFileSync(${JSON.stringify(counter)},'utf8').length===1)process.exit(7);`,
+    ];
+    input.commandGraphDigest = digestValue(input.commands);
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            mkdirSync(outputRoot, { mode: 0o700 });
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            await context.run(0).catch(() => undefined);
+            await context.run(0);
+            await context.run(1);
+            await context.run(2);
+        }), /ordered|single-use|failed|command/u);
+        assert.equal(readFileSync(counter, 'utf8'), 'x');
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase retains complete rejected bootstrap metadata through corrected attempts', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    const originalGraph = input.commandGraphDigest;
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        for (let attempt = 0; attempt < 3; attempt++) {
+            input.commandGraphDigest = digestValue(`invalid graph ${String(attempt)}`);
+            await assert.rejects(withIssueSourcePhase(input, async () => {
+                assert.fail('rejected inputs must not enter callback');
+            }), /binding changed/u);
+            const records = sourcePhaseRecords(root);
+            const predecessor = records.find((record) => !records.some((later) => later.reconciliation?.phaseId === record.phaseId));
+            assert.equal(predecessor.status, 'rejected-before-work');
+            assert.ok(Number(predecessor.bootstrapBytes) >= Buffer.byteLength(`${JSON.stringify(predecessor, null, 2)}\n`), 'charge the complete retained rejection');
+            assert.ok(predecessor.binding, 'preserve rejected requested allocation and input bindings');
+            input.reconciliation = {
+                phaseId: String(predecessor.phaseId),
+                recordId: String(predecessor.recordId),
+                authorizationDigest: input.authorization.digest,
+            };
+        }
+        const rejected = sourcePhaseRecords(root);
+        const retainedBootstrap = rejected.reduce((sum, record) => sum + Number(record.bootstrapBytes), 0);
+        input.commandGraphDigest = originalGraph;
+        const completed = await withIssueSourcePhase(input, async (context) => {
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        });
+        const result = sourcePhaseRecords(root).find((record) => record.recordId === completed.recordId);
+        assert.ok(Number(result.result.newOutputBytes) >= retainedBootstrap);
+        assert.equal(sourcePhaseRecords(root).length, 4, 'retain every rejection');
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase marks changed frozen inputs unresolved after callback failure', async () => {
+    const { root, input } = await sourcePhaseFixture();
+    const frozen = join(root, '.git', 'frozen-input.json');
+    writeFileSync(frozen, '{}');
+    input.inputs = [{ path: frozen, digest: sha256(frozen) }];
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            writeFileSync(frozen, '{"changed":true}');
+            throw new Error('callback failed');
+        }), /unresolved/u);
+        assert.equal(sourcePhaseRecords(root)[0]?.status, 'unresolved');
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase reconciliation cannot forget original frozen inputs', async () => {
+    const { root, input } = await sourcePhaseFixture();
+    const frozen = join(root, '.git', 'frozen-input.json');
+    writeFileSync(frozen, '{}');
+    input.inputs = [{ path: frozen, digest: sha256(frozen) }];
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            throw new Error('quiescent failure');
+        }), /failed-quiescent/u);
+        const predecessor = sourcePhaseRecords(root)[0];
+        const baseline = predecessor.baseline;
+        input.reconciliation = {
+            phaseId: String(predecessor.phaseId),
+            recordId: String(predecessor.recordId),
+            baselineId: baseline.baselineId,
+            authorizationDigest: input.authorization.digest,
+        };
+        input.inputs = [];
+        let entered = false;
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), /compatible|retained.*input/u);
+        assert.equal(entered, false);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase stops streaming capture at its remaining cumulative allowance', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    input.bounds.maxNewOutputBytes = 128 * 1024;
+    input.commands[0].argv = [
+        realpathSync(process.execPath),
+        '-e',
+        'process.stdout.write(Buffer.alloc(256*1024,120));setInterval(()=>{},1000)',
+    ];
+    input.commandGraphDigest = digestValue(input.commands);
+    input.completionArtifacts = [];
+    const cancellation = new AbortController();
+    input.signal = cancellation.signal;
+    const diagnosticDeadline = setTimeout(() => cancellation.abort(), 3_000);
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            mkdirSync(outputRoot);
+            await context.run(0);
+        }), /captured.*allowance/u);
+        assert.equal(cancellation.signal.aborted, false, 'streaming bound stops the waiting command before diagnostic cancellation');
+        assert.equal(readdirSync(join(gitCommonDir(root), 'ai-delivery', 'writers@1')).some((name) => name.endsWith('.json')), false);
+    }
+    finally {
+        clearTimeout(diagnosticDeadline);
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase controls stale-lock compromise while a real competing writer is excluded', async () => {
+    const { root, row, outputRoot, input } = await sourcePhaseFixture({
+        personalAuthor: true,
+        custodianIdentity: 'historical-builder',
+    });
+    const paused = join(root, '.git', 'source-phase-validation-paused');
+    const originalLoad = deliveryConfiguration.loadDeliveryConfig;
+    let pauseOnce = true;
+    const slowValidation = vi.spyOn(deliveryConfiguration, 'loadDeliveryConfig').mockImplementation(async (...args) => {
+        if (pauseOnce && args[0] === root) {
+            pauseOnce = false;
+            writeFileSync(paused, 'writer fence is live');
+            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 12_500);
+        }
+        return originalLoad(...args);
+    });
+    const contender = spawn(process.execPath, [
+        '-e',
+        `(async()=>{
+    const fs=await import('node:fs');
+    while(!fs.existsSync(${JSON.stringify(paused)}))await new Promise(r=>setTimeout(r,20));
+    await new Promise(r=>setTimeout(r,11_000));
+    const {withRuntimeSetupWriter}=await import(${JSON.stringify(new URL('./verification.js', import.meta.url).href)});
+    await withRuntimeSetupWriter(${JSON.stringify(row.path)},async()=>{console.log('COMPETING_CALLBACK_ENTERED')});
+  })().catch(e=>{console.log(e.message);process.exitCode=1});`,
+    ], { stdio: ['ignore', 'pipe', 'pipe'] });
+    let contenderOutput = '';
+    let entered = false;
+    contender.stdout.on('data', (bytes) => {
+        contenderOutput += bytes.toString();
+    });
+    contender.stderr.on('data', (bytes) => {
+        contenderOutput += bytes.toString();
+    });
+    const closed = new Promise((resolve) => contender.once('close', () => resolve()));
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            entered = true;
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        }), /unresolved/u);
+        await closed;
+        assert.match(contenderOutput, /unsealed source phase/u);
+        assert.equal(entered, false, 'compromise cancels before callback entry');
+        assert.doesNotMatch(contenderOutput, /COMPETING_CALLBACK_ENTERED/u);
+        const record = sourcePhaseRecords(root)[0];
+        assert.equal(record.status, 'unresolved');
+        assert.ok(record.failure.lockRelease);
+        const writers = join(gitCommonDir(root), 'ai-delivery', 'writers@1');
+        assert.equal(readdirSync(writers).length, 0, 'writer and reclaimed lock are absent after controlled failure');
+    }
+    finally {
+        slowValidation.mockRestore();
+        if (contender.exitCode === null && contender.signalCode === null)
+            contender.kill('SIGKILL');
+        await closed;
+        rmSync(root, { recursive: true, force: true });
+    }
+}, 30_000);
+test('supported issue source phase runs fixture tests, an enabled-hook commit and classification with separate controller source', async () => {
+    const { root, row, outputRoot, input } = await sourcePhaseFixture({
+        personalAuthor: true,
+        custodianIdentity: 'historical-builder',
+    });
+    const hook = join(root, '.git', 'source-phase-hooks', 'pre-commit');
+    mkdirSync(dirname(hook));
+    writeFileSync(hook, `#!/bin/sh\nprintf 'enabled\\n' >> ${JSON.stringify(join(outputRoot, 'hook-count.txt'))}\n`, {
+        mode: 0o700,
+    });
+    writeFileSync(join(row.path, 'artifact.txt'), 'frozen staged source change\n');
+    git(row.path, 'add', 'artifact.txt');
+    input.source.indexTree = git(row.path, 'write-tree');
+    input.source.dirty = [{ path: 'artifact.txt', digest: sha256(join(row.path, 'artifact.txt')) }];
+    input.source.effect = { kind: 'commitOnce', parent: input.source.head, tree: input.source.indexTree };
+    input.inputs = [{ path: hook, digest: sha256(hook) }];
+    const gitPath = realpathSync(execFileSync('/usr/bin/which', ['git'], { encoding: 'utf8' }).trim());
+    const stat = lstatSync(gitPath);
+    input.commands[0].argv = [
+        realpathSync(process.execPath),
+        '-e',
+        "for(let i=0;i<18;i++)console.log('fixture '+i+' passed')",
+    ];
+    input.commands[1] = {
+        cwd: row.path,
+        argv: [gitPath, '-c', `core.hooksPath=${dirname(hook)}`, 'commit', '-m', 'Reviewed source phase'],
+        executable: {
+            path: gitPath,
+            digest: sha256(gitPath),
+            device: stat.dev,
+            inode: stat.ino,
+            uid: stat.uid,
+            mode: stat.mode,
+        },
+    };
+    input.commands[2].argv = [
+        realpathSync(process.execPath),
+        '-e',
+        "const c=require('child_process');if(c.execFileSync('git',['status','--porcelain'],{encoding:'utf8'}).trim())process.exit(8);console.log('source classification passed')",
+    ];
+    input.commandGraphDigest = digestValue(input.commands);
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        let entered = 0;
+        const receipt = await withIssueSourcePhase(input, async (context) => {
+            entered += 1;
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            assert.equal((await context.run(0)).toString().trim().split('\n').length, 18);
+            await context.run(1);
+            await context.run(2);
+        });
+        assert.notEqual(receipt.source.head, input.source.head);
+        assert.equal(git(root, 'rev-parse', 'HEAD'), input.controller.head);
+        assert.equal(git(row.path, 'rev-parse', 'HEAD^'), input.source.head);
+        assert.equal(receipt.source.indexTree, input.source.indexTree);
+        assert.equal(readFileSync(join(outputRoot, 'hook-count.txt'), 'utf8'), 'enabled\n');
+        const { environment, ...legacyBinding } = input;
+        assert.equal(receipt.phaseId, digestValue({ ...legacyBinding, environmentDigest: environment.digest }));
+        assert.equal(Object.hasOwn(input.source.effect, 'configDigest'), false);
+        const completedPath = join(gitCommonDir(root), 'ai-delivery', 'receipts', 'source-phase@1', digestValue(row.path).slice(7), `${receipt.phaseId.slice(7)}.json`);
+        const completedBytes = readFileSync(completedPath);
+        const completed = JSON.parse(completedBytes.toString());
+        assert.equal(Object.hasOwn(completed.binding.source.effect, 'configDigest'), false);
+        const reused = await withIssueSourcePhase(input, async () => {
+            entered += 1;
+        });
+        assert.equal(reused.recordId, receipt.recordId);
+        assert.equal(entered, 1);
+        assert.deepEqual(readFileSync(completedPath), completedBytes);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+async function sourceConfigurationTransitionFixture() {
+    const result = await sourcePhaseFixture({ personalAuthor: true, custodianIdentity: 'historical-builder' });
+    const { root, row, outputRoot, input } = result;
+    const policy = join(row.path, 'policy.mjs');
+    const original = readFileSync(policy, 'utf8');
+    const revised = `${original}\n// Declared candidate policy revision.\n`;
+    writeFileSync(policy, revised);
+    const finalConfiguration = await loadDeliveryConfig(row.path);
+    const finalPolicyDigest = sha256(policy);
+    git(row.path, 'add', 'policy.mjs');
+    const tree = git(row.path, 'write-tree');
+    writeFileSync(policy, original);
+    git(row.path, 'add', 'policy.mjs');
+    assert.equal(git(row.path, 'write-tree'), input.source.indexTree);
+    assert.equal(git(row.path, 'status', '--porcelain'), '');
+    assert.equal((await loadDeliveryConfig(row.path)).configDigest, input.source.configDigest);
+    assert.notEqual(finalConfiguration.configDigest, input.source.configDigest);
+    assert.notEqual(finalConfiguration.configDigest, finalPolicyDigest);
+    const effect = {
+        kind: 'commitOnce',
+        parent: input.source.head,
+        tree,
+        configDigest: finalConfiguration.configDigest,
+    };
+    input.source.effect = effect;
+    const hook = join(root, '.git', 'source-phase-hooks', 'pre-commit');
+    mkdirSync(dirname(hook));
+    writeFileSync(hook, `#!/bin/sh\nprintf 'enabled\\n' >> ${JSON.stringify(join(outputRoot, 'hook-count.txt'))}\n`, {
+        mode: 0o700,
+    });
+    const gitPath = realpathSync(execFileSync('/usr/bin/which', ['git'], { encoding: 'utf8' }).trim());
+    input.inputs = [hook, gitPath].map((path) => ({ path, digest: sha256(path) }));
+    const transition = `const fs=require('node:fs'),c=require('node:child_process');
+fs.writeFileSync(${JSON.stringify(policy)},${JSON.stringify(revised)});
+const git=(...args)=>c.execFileSync(${JSON.stringify(gitPath)},args,{stdio:'inherit'});
+git('add','policy.mjs');
+git('-c',${JSON.stringify(`core.hooksPath=${dirname(hook)}`)},'commit','-m','Reviewed candidate policy transition');`;
+    input.commands[1].argv = [realpathSync(process.execPath), '-e', transition];
+    input.commandGraphDigest = digestValue(input.commands);
+    return { ...result, policy, original, revised, effect, transition };
+}
+test('supported issue source phase binds initial and final resolved candidate configurations across one normal-hook commit', async () => {
+    const { root, row, outputRoot, input, effect } = await sourceConfigurationTransitionFixture();
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        let entered = 0;
+        const receipt = await withIssueSourcePhase(input, async (context) => {
+            entered += 1;
+            assert.equal(context.source.configDigest, input.source.configDigest);
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        });
+        assert.equal(receipt.source.configDigest, effect.configDigest);
+        assert.equal(receipt.source.indexTree, effect.tree);
+        assert.equal(git(row.path, 'rev-list', '--parents', '-n', '1', 'HEAD'), `${receipt.source.head} ${input.source.head}`);
+        assert.equal(git(row.path, 'status', '--porcelain'), '');
+        assert.equal(git(root, 'rev-parse', 'HEAD'), input.controller.head);
+        assert.equal((await loadDeliveryConfig(root)).configDigest, input.controller.configDigest);
+        assert.equal(readFileSync(join(outputRoot, 'hook-count.txt'), 'utf8'), 'enabled\n');
+        const completed = sourcePhaseRecords(root).find((record) => record.phaseId === receipt.phaseId);
+        assert.deepEqual(completed?.binding?.source?.effect, effect);
+        const reused = await withIssueSourcePhase(input, async () => {
+            entered += 1;
+        });
+        assert.equal(reused.recordId, receipt.recordId);
+        assert.deepEqual(sourcePhaseRecords(root).find((record) => record.phaseId === receipt.phaseId), completed);
+        assert.equal(entered, 1);
+        assert.equal(readFileSync(join(outputRoot, 'hook-count.txt'), 'utf8'), 'enabled\n');
+        for (const digest of ['initial', 'final']) {
+            const changed = structuredClone(input);
+            if (digest === 'initial')
+                changed.source.configDigest = digestValue('different initial configuration');
+            else
+                changed.source.effect = { ...effect, configDigest: digestValue('different final configuration') };
+            await assert.rejects(withIssueSourcePhase(changed, async () => assert.fail('changed binding cannot reuse completion or enter')), /initial source|configuration|reconciliation/u);
+            assert.deepEqual(sourcePhaseRecords(root).find((record) => record.phaseId === receipt.phaseId), completed);
+            assert.equal(readFileSync(join(outputRoot, 'hook-count.txt'), 'utf8'), 'enabled\n');
+        }
+        writeFileSync(join(row.path, 'policy.mjs'), 'export const deliverySettings = {};\n');
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('changed final source cannot reuse')));
+        assert.deepEqual(sourcePhaseRecords(root).find((record) => record.phaseId === receipt.phaseId), completed);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test.each(['preserve', 'invalid digest', 'unknown field'])('supported issue source phase strictly refuses a final configuration declaration with %s', async (invalid) => {
+    const { root, input, effect } = await sourceConfigurationTransitionFixture();
+    const declaration = invalid === 'preserve'
+        ? { kind: 'preserve', configDigest: effect.configDigest }
+        : invalid === 'invalid digest'
+            ? { ...effect, configDigest: 'invalid' }
+            : { ...effect, finalConfigDigest: effect.configDigest };
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase({ ...input, source: { ...input.source, effect: declaration } }, async () => assert.fail('invalid declaration cannot enter')));
+        assert.equal(existsSync(join(gitCommonDir(root), 'ai-delivery', 'receipts', 'source-phase@1')), false);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase refuses the final configuration at the initial head before work', async () => {
+    const { root, input, policy, revised } = await sourceConfigurationTransitionFixture();
+    writeFileSync(policy, revised);
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('initial head requires initial configuration')), /configuration/u);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test.each([
+    'omitted digest',
+    'wrong digest',
+    'wrong tree',
+    'wrong parent',
+    'second commit',
+    'dirty final',
+    'controller configuration',
+    'seal configuration',
+])('supported issue source phase refuses a candidate configuration transition with %s without replay', async (invalid) => {
+    const { root, row, outputRoot, input, effect, transition, policy, original } = await sourceConfigurationTransitionFixture();
+    if (invalid === 'omitted digest') {
+        input.source.effect = { kind: 'commitOnce', parent: effect.parent, tree: effect.tree };
+    }
+    else if (invalid === 'wrong digest') {
+        input.source.effect = { ...effect, configDigest: input.source.configDigest };
+    }
+    else if (invalid === 'wrong tree') {
+        input.source.effect = { ...effect, tree: input.source.indexTree };
+    }
+    else if (invalid === 'wrong parent') {
+        input.source.effect = { ...effect, parent: '1'.repeat(40) };
+    }
+    else if (invalid === 'second commit') {
+        input.commands[1].argv[2] = `${transition}\ngit('commit','--allow-empty','-m','Undeclared second commit');`;
+    }
+    else if (invalid === 'dirty final') {
+        input.commands[1].argv[2] = `${transition}\nfs.writeFileSync('artifact.txt','undeclared dirty final');`;
+    }
+    else if (invalid === 'controller configuration') {
+        input.commands[1].argv[2] = `${transition}\nfs.appendFileSync(${JSON.stringify(join(root, 'policy.mjs'))},'\\n// Undeclared controller change.\\n');`;
+    }
+    else {
+        input.commands[2].argv = [
+            realpathSync(process.execPath),
+            '-e',
+            `require('node:fs').writeFileSync(${JSON.stringify(policy)},${JSON.stringify(original)});`,
+        ];
+    }
+    input.commandGraphDigest = digestValue(input.commands);
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        let entered = 0;
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            entered += 1;
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        }), invalid === 'controller configuration' ? /repository admission/u : /configuration|parent, tree/u);
+        assert.equal(entered, 1);
+        assert.notEqual(git(row.path, 'rev-parse', 'HEAD'), input.source.head);
+        assert.equal(sourcePhaseRecords(root)[0]?.status, 'unresolved');
+        const head = git(row.path, 'rev-parse', 'HEAD');
+        const hooks = readFileSync(join(outputRoot, 'hook-count.txt'));
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('failed commit cannot replay')));
+        assert.equal(git(row.path, 'rev-parse', 'HEAD'), head);
+        assert.deepEqual(readFileSync(join(outputRoot, 'hook-count.txt')), hooks);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase never replays a commit followed by callback failure', async () => {
+    const { root, row, input } = await sourcePhaseFixture();
+    input.source.effect = { kind: 'commitOnce', parent: input.source.head, tree: input.source.indexTree };
+    input.completionArtifacts = [];
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            const committed = git(row.path, 'commit-tree', input.source.indexTree, '-p', input.source.head, '-m', 'Uncertain commit');
+            git(row.path, 'update-ref', `refs/heads/${row.branch}`, committed);
+            throw new Error('failure after commit');
+        }), /unresolved/u);
+        const old = sourcePhaseRecords(root)[0];
+        assert.equal(old.status, 'unresolved');
+        let entered = false;
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), /incomplete|Unresolved/u);
+        assert.equal(entered, false);
+        assert.deepEqual(sourcePhaseRecords(root)[0], old, 'uncertain evidence is immutable');
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase rejects skipped and concurrent commands and expires escaped capabilities', async () => {
+    for (const mode of ['skipped', 'concurrent', 'escaped']) {
+        const { root, outputRoot, input } = await sourcePhaseFixture();
+        let escaped;
+        try {
+            const { withIssueSourcePhase } = await import('./agent.js');
+            const operation = withIssueSourcePhase(input, async (context) => {
+                escaped = context.run;
+                mkdirSync(outputRoot);
+                writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+                if (mode === 'skipped')
+                    await context.run(1);
+                else if (mode === 'concurrent')
+                    await Promise.all([context.run(0), context.run(1)]);
+                else
+                    for (let index = 0; index < input.commands.length; index++)
+                        await context.run(index);
+            });
+            if (mode === 'escaped')
+                await operation;
+            else
+                await assert.rejects(operation, /ordered|single-use|cancelled|unawaited/u);
+            await assert.rejects(escaped(0), /expired/u);
+            assert.equal(readdirSync(join(gitCommonDir(root), 'ai-delivery', 'writers@1')).some((name) => name.endsWith('.json')), false);
+        }
+        finally {
+            rmSync(root, { recursive: true, force: true });
+        }
+    }
+});
+test('supported issue source phase cancels unawaited commands and preserves unrelated output', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    const unrelated = join(root, '.git', 'unrelated-preserved.txt');
+    writeFileSync(unrelated, 'another run');
+    input.commands[0].argv = [realpathSync(process.execPath), '-e', 'setInterval(()=>{},1000)'];
+    input.commandGraphDigest = digestValue(input.commands);
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            mkdirSync(outputRoot);
+            void context.run(0).catch(() => undefined);
+        }), /unawaited/u);
+        assert.equal(readFileSync(unrelated, 'utf8'), 'another run');
+        const record = sourcePhaseRecords(root)[0];
+        assert.equal(record.status, 'failed-quiescent');
+        assert.equal(record.failure.cleanup, undefined);
+        assert.equal(readdirSync(join(gitCommonDir(root), 'ai-delivery', 'writers@1')).length, 0);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase refuses interrupted intent without replay or changing its retained checkpoint', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture({ personalAuthor: true });
+    input.environment.overrides.AUTHOR_TOKEN = 'synthetic-selected-author';
+    const environment = { ...process.env };
+    delete environment.AI_DELIVERY_OUTPUT_OBSERVATION_GATE;
+    for (const [name, value] of Object.entries(input.environment.overrides)) {
+        if (value === null)
+            delete environment[name];
+        else
+            environment[name] = value;
+    }
+    input.environment.digest = digestValue(environment);
+    const completedUnit = join(outputRoot, 'completed-unit.json');
+    const child = spawn(process.execPath, [
+        '-e',
+        `(async()=>{
+    const {syntheticDiscoveryClients}=await import(${JSON.stringify(new URL('./fixtures/discovery.js', import.meta.url).href)});
+    globalThis.fetch=async(url,request)=>{
+      const address=String(url);
+      if(address.endsWith('/graphql')){
+        const body=JSON.parse(request.body);const data=await syntheticDiscoveryClients().graphql(body.query,body.variables);
+        return new Response(JSON.stringify({data}),{status:200,headers:{'content-type':'application/json'}});
+      }
+      if(address.endsWith('/user'))return new Response(JSON.stringify({login:'host-user',id:37}),{status:200,headers:{'content-type':'application/json'}});
+      throw new Error('Unexpected synthetic native request: '+address);
+    };
+    const {withIssueSourcePhase}=await import(${JSON.stringify(new URL('./agent.js', import.meta.url).href)});
+    const fs=await import('node:fs');
+    await withIssueSourcePhase(${JSON.stringify(input)},async context=>{
+      fs.mkdirSync(${JSON.stringify(outputRoot)});
+      await context.run(0);
+      fs.writeFileSync(${JSON.stringify(completedUnit)},JSON.stringify({unit:0,output:'frozen:0'}));
+      await new Promise(()=>setInterval(()=>{},1000));
+    });
+  })().catch(e=>{console.error(e.message);process.exitCode=1});`,
+    ], { env: environment, stdio: ['ignore', 'pipe', 'pipe'] });
+    let output = '';
+    const capture = (bytes) => {
+        output += bytes.toString();
+        if (output.length > 64 * 1024)
+            child.kill('SIGKILL');
+    };
+    child.stdout.on('data', capture);
+    child.stderr.on('data', capture);
+    const closed = new Promise((resolve) => child.once('close', () => resolve()));
+    try {
+        for (let attempt = 0; attempt < 500 && !existsSync(completedUnit) && child.exitCode === null; attempt++)
+            await new Promise((resolve) => setTimeout(resolve, 20));
+        assert.ok(existsSync(completedUnit), output);
+        child.kill('SIGKILL');
+        await closed;
+        assert.equal(child.signalCode, 'SIGKILL');
+        const record = sourcePhaseRecords(root)[0];
+        assert.equal(record.status, 'intent');
+        assert.equal(record.commands.length, 1);
+        const writer = join(gitCommonDir(root), 'ai-delivery', 'writers@1', `${digestValue(input.source.path).slice(7)}.json`);
+        const beforeWriter = readFileSync(writer);
+        const stale = new Date(Date.now() - 20_000);
+        utimesSync(`${writer}.lock`, stale, stale);
+        const { withIssueSourcePhase } = await import('./agent.js');
+        let entered = false;
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), /unsealed source phase/u);
+        assert.equal(entered, false);
+        assert.deepEqual(sourcePhaseRecords(root)[0], record);
+        assert.ok(readFileSync(writer).equals(beforeWriter));
+        assert.equal(readFileSync(completedUnit, 'utf8'), '{"unit":0,"output":"frozen:0"}');
+    }
+    finally {
+        if (child.exitCode === null && child.signalCode === null)
+            child.kill('SIGKILL');
+        await closed;
+        rmSync(root, { recursive: true, force: true });
+    }
+}, 20_000);
+test('supported issue source phase charges output before, between and after its frozen commands', async () => {
+    for (const timing of ['before', 'between', 'after']) {
+        const { root, outputRoot, input } = await sourcePhaseFixture();
+        const counter = join(outputRoot, 'started.txt');
+        input.bounds.maxNewOutputBytes = 64 * 1024;
+        for (let index = 0; index < input.commands.length; index++)
+            input.commands[index].argv = [
+                realpathSync(process.execPath),
+                '-e',
+                `require('fs').appendFileSync(${JSON.stringify(counter)},${JSON.stringify(String(index))})`,
+            ];
+        input.commandGraphDigest = digestValue(input.commands);
+        input.completionArtifacts = [];
+        try {
+            const { withIssueSourcePhase } = await import('./agent.js');
+            await assert.rejects(withIssueSourcePhase(input, async (context) => {
+                mkdirSync(outputRoot);
+                if (timing === 'before')
+                    writeFileSync(join(outputRoot, 'before.bin'), Buffer.alloc(80 * 1024));
+                if (timing === 'between')
+                    writeFileSync(join(outputRoot, 'first.bin'), Buffer.alloc(30 * 1024));
+                await context.run(0);
+                if (timing === 'between')
+                    writeFileSync(join(outputRoot, 'second.bin'), Buffer.alloc(40 * 1024));
+                await context.run(1);
+                await context.run(2);
+                if (timing === 'after')
+                    writeFileSync(join(outputRoot, 'after.bin'), Buffer.alloc(80 * 1024));
+            }), /output|allowance/u);
+            assert.equal(existsSync(counter) ? readFileSync(counter, 'utf8') : '', timing === 'before' ? '' : timing === 'between' ? '0' : '012');
+            assert.notEqual(sourcePhaseRecords(root)[0]?.status, 'complete');
+        }
+        finally {
+            rmSync(root, { recursive: true, force: true });
+        }
+    }
+});
+test('supported issue source phase resumes a quiescent failure with its original baseline and ends the predecessor chain', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    input.bounds.maxNewOutputBytes = 256 * 1024;
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'retained.bin'), Buffer.alloc(40 * 1024, 1));
+            throw new Error('bounded preparation failure');
+        }), /failed-quiescent/u);
+        const original = sourcePhaseRecords(root)[0];
+        const baseline = original.baseline;
+        input.reconciliation = {
+            phaseId: String(original.phaseId),
+            recordId: String(original.recordId),
+            baselineId: baseline.baselineId,
+            authorizationDigest: input.authorization.digest,
+        };
+        const nextCaller = join(root, '.git', 'next-source-caller.mjs');
+        writeFileSync(nextCaller, '// expressly authorized corrected caller\n');
+        input.caller = { path: nextCaller, digest: sha256(nextCaller) };
+        const receipt = await withIssueSourcePhase(input, async (context) => {
+            writeFileSync(join(outputRoot, 'new.bin'), Buffer.alloc(80 * 1024, 2));
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        });
+        const completed = sourcePhaseRecords(root).find((record) => record.recordId === receipt.recordId);
+        assert.equal(completed.baseline.baselineId, baseline.baselineId);
+        assert.ok(completed.result.newOutputBytes >= 120 * 1024);
+        assert.deepEqual(sourcePhaseRecords(root).find((record) => record.recordId === original.recordId), original);
+        const futureCaller = join(root, '.git', 'future-source-caller.mjs');
+        writeFileSync(futureCaller, '// independent later authorized phase\n');
+        input.caller = { path: futureCaller, digest: sha256(futureCaller) };
+        delete input.reconciliation;
+        const future = await withIssueSourcePhase(input, async (context) => {
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        });
+        assert.equal(future.status, 'complete', 'terminal success consumes its failed predecessor chain');
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase refuses changed retained output on an expressly authorized retry', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    const retained = join(outputRoot, 'retained.json');
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            mkdirSync(outputRoot);
+            writeFileSync(retained, '{"unit":1}');
+            throw new Error('quiescent failure');
+        }), /failed-quiescent/u);
+        const original = sourcePhaseRecords(root)[0];
+        input.reconciliation = {
+            phaseId: String(original.phaseId),
+            recordId: String(original.recordId),
+            baselineId: original.baseline.baselineId,
+            authorizationDigest: input.authorization.digest,
+        };
+        const graph = input.commandGraphDigest;
+        input.commandGraphDigest = digestValue('invalid intermediate retry graph');
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('invalid intermediate graph cannot enter callback')), /binding changed/u);
+        const intermediate = sourcePhaseRecords(root).find((record) => record.phaseId !== original.phaseId);
+        input.commandGraphDigest = graph;
+        input.reconciliation = {
+            ...input.reconciliation,
+            phaseId: String(intermediate.phaseId),
+            recordId: String(intermediate.recordId),
+        };
+        writeFileSync(retained, '{"unit":2}');
+        let entered = false;
+        await assert.rejects(withIssueSourcePhase(input, async () => {
+            entered = true;
+        }), /retained output artifact identity/u);
+        assert.equal(entered, false);
+        assert.deepEqual(sourcePhaseRecords(root).find((record) => record.recordId === original.recordId), original);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase cancellation cleans the observed command and descendant identities', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    const pidsPath = join(outputRoot, 'pids.json');
+    input.commands[0].argv = [
+        realpathSync(process.execPath),
+        '-e',
+        `const fs=require('fs'),cp=require('child_process');const child=cp.spawn(process.execPath,['-e','setInterval(()=>{},1000)'],{stdio:'ignore'});fs.writeFileSync(${JSON.stringify(pidsPath)},JSON.stringify({root:process.pid,descendant:child.pid}));setInterval(()=>{},1000);`,
+    ];
+    input.commandGraphDigest = digestValue(input.commands);
+    input.completionArtifacts = [];
+    const cancellation = new AbortController();
+    input.signal = cancellation.signal;
+    const { withIssueSourcePhase } = await import('./agent.js');
+    const operation = withIssueSourcePhase(input, async (context) => {
+        mkdirSync(outputRoot);
+        await context.run(0);
+    }).catch((error) => error);
+    try {
+        for (let attempt = 0; attempt < 500 && !existsSync(pidsPath); attempt++)
+            await new Promise((resolve) => setTimeout(resolve, 20));
+        assert.ok(existsSync(pidsPath));
+        const pids = JSON.parse(readFileSync(pidsPath, 'utf8'));
+        const writer = join(gitCommonDir(root), 'ai-delivery', 'writers@1', `${digestValue(input.source.path).slice(7)}.json`);
+        const observed = () => JSON.parse(readFileSync(writer, 'utf8')).command.tracked?.some((member) => member.pid === pids.descendant) === true;
+        for (let attempt = 0; attempt < 500 && !observed(); attempt++)
+            await new Promise((resolve) => setTimeout(resolve, 20));
+        assert.ok(observed(), 'record actual descendant birth identity before cancellation');
+        cancellation.abort();
+        assert.match(String(await operation), /cancelled/u);
+        for (const pid of [pids.root, pids.descendant]) {
+            const status = spawnSync('ps', ['-p', String(pid), '-o', 'stat='], { encoding: 'utf8' }).stdout.trim();
+            assert.ok(status === '' || status.startsWith('Z'), 'owned identity is no longer running');
+        }
+        const record = sourcePhaseRecords(root)[0];
+        assert.equal(record.failure.cleanup, undefined);
+        assert.equal(readdirSync(join(gitCommonDir(root), 'ai-delivery', 'writers@1')).length, 0);
+    }
+    finally {
+        cancellation.abort();
+        await operation;
+        rmSync(root, { recursive: true, force: true });
+    }
+}, 20_000);
+test('supported issue source phase reports writer and lock release failures separately from process cleanup', async () => {
+    for (const released of ['writer', 'lock']) {
+        const { root, outputRoot, input } = await sourcePhaseFixture();
+        try {
+            const { withIssueSourcePhase } = await import('./agent.js');
+            await assert.rejects(withIssueSourcePhase(input, async (context) => {
+                mkdirSync(outputRoot);
+                writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+                for (let index = 0; index < input.commands.length; index++)
+                    await context.run(index);
+                const writer = join(gitCommonDir(root), 'ai-delivery', 'writers@1', `${digestValue(input.source.path).slice(7)}.json`);
+                const state = JSON.parse(readFileSync(writer, 'utf8'));
+                assert.equal(state.owner.pid, process.pid, 'fixture only alters its own writer');
+                if (released === 'writer')
+                    unlinkSync(writer);
+                else
+                    writeFileSync(join(`${writer}.lock`, 'owned-release-obstruction'), 'fixture-owned release failure');
+            }), /unresolved/u);
+            const record = sourcePhaseRecords(root)[0];
+            const failure = record.failure;
+            assert.equal(failure.cleanup, undefined);
+            if (released === 'writer')
+                assert.ok(failure.writerRelease);
+            else {
+                assert.ok(failure.lockRelease);
+                assert.equal(failure.writerRelease, undefined);
+            }
+            assert.equal(record.status, 'unresolved');
+        }
+        finally {
+            rmSync(root, { recursive: true, force: true });
+        }
+    }
+});
+test('supported issue source phase retains exclusion through terminal sealing against a real writer', async () => {
+    for (const outcome of ['complete', 'failed-quiescent']) {
+        const { root, row, outputRoot, input } = await sourcePhaseFixture();
+        const writer = join(gitCommonDir(root), 'ai-delivery', 'writers@1', `${digestValue(row.path).slice(7)}.json`);
+        const metadata = join(outputRoot, 'metadata.json');
+        const originalLoad = deliveryConfiguration.loadDeliveryConfig;
+        let contender;
+        const inspectRelease = vi.spyOn(deliveryConfiguration, 'loadDeliveryConfig').mockImplementation(async (...args) => {
+            if (args[0] === root &&
+                contender === undefined &&
+                !existsSync(writer) &&
+                sourcePhaseRecords(root).some((record) => record.status === 'intent')) {
+                contender = spawnSync(process.execPath, [
+                    '--input-type=module',
+                    '-e',
+                    `import {writeFileSync} from 'node:fs';
+             import {withRuntimeSetupWriter} from ${JSON.stringify(new URL('./verification.js', import.meta.url).href)};
+             await withRuntimeSetupWriter(${JSON.stringify(row.path)},async()=>{
+               writeFileSync(${JSON.stringify(metadata)},'competing writer changed completion bytes');
+             });`,
+                ], { encoding: 'utf8', timeout: 10_000, maxBuffer: 64 * 1024 });
+            }
+            return originalLoad(...args);
+        });
+        try {
+            const { withIssueSourcePhase } = await import('./agent.js');
+            const phase = withIssueSourcePhase(input, async (context) => {
+                mkdirSync(outputRoot);
+                writeFileSync(metadata, '{}');
+                for (let index = 0; index < input.commands.length; index++)
+                    await context.run(index);
+                if (outcome === 'failed-quiescent')
+                    throw new Error('quiescent callback failure');
+            });
+            if (outcome === 'complete')
+                await phase;
+            else
+                await assert.rejects(phase, /failed-quiescent/u);
+            assert.ok(contender, 'competing process attempted entry after writer release and before terminal seal');
+            assert.equal(contender.error, undefined);
+            assert.equal(contender.status, 1);
+            assert.match(String(contender.stderr), /unsealed source phase/u);
+            assert.equal(readFileSync(metadata, 'utf8'), '{}');
+            assert.equal(sourcePhaseRecords(root)[0]?.status, outcome);
+            const afterSeal = spawnSync(process.execPath, [
+                '--input-type=module',
+                '-e',
+                `import {withRuntimeSetupWriter} from ${JSON.stringify(new URL('./verification.js', import.meta.url).href)};
+           await withRuntimeSetupWriter(${JSON.stringify(row.path)},async()=>console.log('writer entered after seal'));`,
+            ], { encoding: 'utf8', timeout: 10_000, maxBuffer: 64 * 1024 });
+            assert.equal(afterSeal.error, undefined);
+            assert.equal(afterSeal.status, 0, String(afterSeal.stderr));
+            assert.match(String(afterSeal.stdout), /writer entered after seal/u);
+        }
+        finally {
+            inspectRelease.mockRestore();
+            rmSync(root, { recursive: true, force: true });
+        }
+    }
+}, 30_000);
+test('supported issue source phase corrects invalid reconciliation while retaining every rejected charge', async () => {
+    for (const initial of ['rejected-before-work', 'failed-quiescent']) {
+        const { root, outputRoot, input } = await sourcePhaseFixture();
+        const graph = input.commandGraphDigest;
+        try {
+            const { withIssueSourcePhase } = await import('./agent.js');
+            if (initial === 'rejected-before-work')
+                input.commandGraphDigest = digestValue('initial invalid graph');
+            await assert.rejects(withIssueSourcePhase(input, async () => {
+                if (initial === 'rejected-before-work')
+                    assert.fail('invalid graph cannot enter callback');
+                mkdirSync(outputRoot);
+                writeFileSync(join(outputRoot, 'retained.bin'), Buffer.alloc(40 * 1024));
+                throw new Error('original quiescent failure');
+            }), initial === 'rejected-before-work' ? /binding changed/u : /failed-quiescent/u);
+            const original = sourcePhaseRecords(root)[0];
+            input.commandGraphDigest = graph;
+            const reconciliation = {
+                phaseId: String(original.phaseId),
+                recordId: String(original.recordId),
+                authorizationDigest: input.authorization.digest,
+                ...(original.baseline === undefined
+                    ? {}
+                    : { baselineId: original.baseline.baselineId }),
+            };
+            for (const invalid of ['missing', 'phase', 'record', 'authorization']) {
+                const caller = join(root, '.git', `source-phase-invalid-${invalid}.mjs`);
+                writeFileSync(caller, `// frozen ${invalid} retry caller\n`);
+                input.caller = { path: caller, digest: sha256(caller) };
+                if (invalid === 'missing')
+                    delete input.reconciliation;
+                else
+                    input.reconciliation = {
+                        ...reconciliation,
+                        ...(invalid === 'phase' ? { phaseId: digestValue('wrong predecessor phase') } : {}),
+                        ...(invalid === 'record' ? { recordId: digestValue('wrong predecessor record') } : {}),
+                        ...(invalid === 'authorization' ? { authorizationDigest: digestValue('wrong retry authorization') } : {}),
+                    };
+                await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('invalid reconciliation cannot enter callback')), /reconciliation|predecessor/u);
+            }
+            const retained = sourcePhaseRecords(root);
+            assert.equal(retained.length, 5);
+            assert.equal(retained.filter((record) => record.status === 'rejected-before-work').length, initial === 'rejected-before-work' ? 5 : 4);
+            input.reconciliation = reconciliation;
+            const completed = await withIssueSourcePhase(input, async (context) => {
+                mkdirSync(outputRoot, { recursive: true });
+                writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+                for (let index = 0; index < input.commands.length; index++)
+                    await context.run(index);
+            });
+            const finalRecords = sourcePhaseRecords(root);
+            const complete = finalRecords.find((record) => record.recordId === completed.recordId);
+            const bootstrap = retained.reduce((sum, record) => sum + Number(record.bootstrapBytes), 0);
+            assert.ok(Number(complete.result.newOutputBytes) >=
+                bootstrap + (initial === 'failed-quiescent' ? 40 * 1024 : 0));
+            for (const record of retained)
+                assert.deepEqual(finalRecords.find((current) => current.phaseId === record.phaseId), record, 'rejected and failed evidence stays immutable');
+            delete input.reconciliation;
+            const nextCaller = join(root, '.git', 'source-phase-independent-next.mjs');
+            writeFileSync(nextCaller, '// independent later authorized graph\n');
+            input.caller = { path: nextCaller, digest: sha256(nextCaller) };
+            await withIssueSourcePhase(input, async (context) => {
+                for (let index = 0; index < input.commands.length; index++)
+                    await context.run(index);
+            });
+        }
+        finally {
+            rmSync(root, { recursive: true, force: true });
+        }
+    }
+}, 40_000);
+test('supported issue source phase cannot derive a larger allocation or changed roots from rejected siblings', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    input.bounds.maxNewOutputBytes = 64 * 1024;
+    input.bounds.minFreeDiskBytes = 2;
+    const originalBounds = structuredClone(input.bounds);
+    const graph = input.commandGraphDigest;
+    const replacementRoot = join(root, '.git', 'replacement-source-output');
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        input.commandGraphDigest = digestValue('initial rejected graph with original allocation');
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('invalid graph')), /binding changed/u);
+        const original = sourcePhaseRecords(root)[0];
+        input.commandGraphDigest = graph;
+        const caller = join(root, '.git', 'source-phase-increased-request.mjs');
+        writeFileSync(caller, '// rejected request cannot grant larger bounds\n');
+        input.caller = { path: caller, digest: sha256(caller) };
+        input.bounds = {
+            maxAggregateRssBytes: 2 * originalBounds.maxAggregateRssBytes,
+            maxNewOutputBytes: 1024 * 1024,
+            minFreeDiskBytes: 1,
+            outputRoots: [replacementRoot, join(root, '.git', 'ai-delivery')],
+        };
+        input.completionArtifacts = [join(replacementRoot, 'metadata.json')];
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('missing reconciliation cannot enter')), /reconciliation|original.*allowance/u);
+        const sibling = sourcePhaseRecords(root).find((record) => record.phaseId !== original.phaseId);
+        input.reconciliation = {
+            phaseId: String(sibling.phaseId),
+            recordId: String(sibling.recordId),
+            authorizationDigest: input.authorization.digest,
+        };
+        let entered = false;
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            entered = true;
+            mkdirSync(replacementRoot);
+            writeFileSync(join(replacementRoot, 'metadata.json'), '{}');
+            writeFileSync(join(replacementRoot, 'beyond-original-allowance.bin'), Buffer.alloc(96 * 1024));
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        }), /original.*allowance|original output baseline/u);
+        assert.equal(entered, false, 'a rejected sibling cannot authorize original-bound increases or new roots');
+        input.bounds = structuredClone(originalBounds);
+        input.completionArtifacts = [join(outputRoot, 'metadata.json')];
+        const completed = await withIssueSourcePhase(input, async (context) => {
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+        });
+        const records = sourcePhaseRecords(root);
+        for (const record of records)
+            assert.deepEqual(record.allocation, originalBounds);
+        assert.equal(records.find((record) => record.recordId === completed.recordId)?.status, 'complete');
+        assert.deepEqual(records.find((record) => record.recordId === original.recordId), original);
+        assert.equal(existsSync(replacementRoot), false);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase charges invalid attempts against the original cumulative allowance', async () => {
+    const { root, input } = await sourcePhaseFixture();
+    input.bounds.maxNewOutputBytes = 32 * 1024;
+    const originalBounds = structuredClone(input.bounds);
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        input.commandGraphDigest = digestValue('invalid frozen graph');
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('invalid graph')), /binding changed/u);
+        input.bounds.maxNewOutputBytes = 1024 * 1024;
+        let exhausted;
+        for (let attempt = 0; attempt < 12; attempt++) {
+            const caller = join(root, '.git', `source-phase-missing-predecessor-${String(attempt)}.mjs`);
+            writeFileSync(caller, `// immutable invalid retry ${String(attempt)}\n`);
+            input.caller = { path: caller, digest: sha256(caller) };
+            await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('invalid retry cannot enter callback')), /reconciliation|unresolved|original.*allowance/u);
+            const record = sourcePhaseRecords(root).find((value) => value.binding?.caller?.path === caller);
+            if (record.status === 'unresolved') {
+                exhausted = record;
+                break;
+            }
+        }
+        assert.ok(exhausted, 'cumulative rejected bootstrap must exhaust the original allocation before twelve resets');
+        assert.deepEqual(exhausted.allocation, originalBounds);
+        assert.match(exhausted.failure.accounting, /original output allowance/u);
+        assert.equal(exhausted.result, undefined);
+        const count = sourcePhaseRecords(root).length;
+        const caller = join(root, '.git', 'source-phase-after-exhaustion.mjs');
+        writeFileSync(caller, '// no new persistent phase metadata after unresolved exhaustion\n');
+        input.caller = { path: caller, digest: sha256(caller) };
+        await assert.rejects(withIssueSourcePhase(input, async () => assert.fail('unresolved allowance cannot admit more work')), /[Uu]nresolved source phase/u);
+        assert.equal(sourcePhaseRecords(root).length, count);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('supported issue source phase refuses undefined callback rejection after successful commands', async () => {
+    const { root, outputRoot, input } = await sourcePhaseFixture();
+    try {
+        const { withIssueSourcePhase } = await import('./agent.js');
+        await assert.rejects(withIssueSourcePhase(input, async (context) => {
+            mkdirSync(outputRoot);
+            writeFileSync(join(outputRoot, 'metadata.json'), '{}');
+            for (let index = 0; index < input.commands.length; index++)
+                await context.run(index);
+            await Promise.reject(undefined);
+        }), /failed-quiescent/u);
+        const record = sourcePhaseRecords(root)[0];
+        assert.equal(record.status, 'failed-quiescent');
+        assert.equal(record.commands.length, 3);
+        assert.equal(record.failure.operation, 'undefined');
+        assert.equal(record.result, undefined);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
 test('published package and bundled plugin agree on the admission version', () => {
     const packageManifest = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
     const pluginManifest = JSON.parse(readFileSync(new URL('../plugins/ai-delivery/.claude-plugin/plugin.json', import.meta.url), 'utf8'));
@@ -1458,6 +2813,126 @@ test('cancelling verification stops its owned descendant and preserves an unrela
         rmSync(root, { recursive: true, force: true });
     }
 });
+test.skipIf(process.platform !== 'darwin').each(['exited group', 'live root', 'live group member'])('owned process cleanup rechecks EPERM for %s', async (disposition) => {
+    const output = realpathSync(mkdtempSync(join(tmpdir(), 'ad-group-exit-')));
+    const marker = join(output, 'processes'), release = join(output, 'release');
+    const { root } = await fixture({
+        firstStageScript: `const fs=require('node:fs');const {spawn}=require('node:child_process');
+        const descendant=${JSON.stringify(disposition)}==='live group member'?spawn(process.execPath,['-e','setInterval(()=>{},1000)'],{stdio:'ignore'}):undefined;
+        fs.writeFileSync(${JSON.stringify(marker)},JSON.stringify([process.pid,...(descendant?[descendant.pid]:[])]));
+        setInterval(()=>{if(fs.existsSync(${JSON.stringify(release)}))process.exit(0);},10);`,
+    });
+    const originalKill = process.kill.bind(process);
+    const owned = new Map();
+    const unrelated = spawn(process.execPath, ['-e', 'setInterval(()=>{},1000)'], { stdio: 'ignore' });
+    const identity = (pid) => spawnSync('/bin/ps', ['-p', String(pid), '-o', 'lstart='], { encoding: 'utf8' }).stdout.trim();
+    const unrelatedIdentity = identity(unrelated.pid);
+    let restoreKill;
+    let permissionExit;
+    const controller = new AbortController();
+    let run;
+    try {
+        const row = await prepareIssueWorktree({
+            baseRef: 'main',
+            identity: 'synthetic-author',
+            issueNumber: 17,
+            repoRoot: root,
+        });
+        writeFileSync(join(row.path, 'change.txt'), 'group exit\n');
+        git(row.path, 'add', 'change.txt');
+        git(row.path, 'commit', '-qm', 'synthetic group exit');
+        run = verifyIssue({ issueNumber: 17, repoRoot: row.path, signal: controller.signal });
+        const rejection = assert.rejects(run, (error) => {
+            assert.match(String(error), /cancelled/u);
+            if (disposition === 'exited group')
+                assert.doesNotMatch(String(error), /cleanup failed/u);
+            else
+                assert.match(String(error), /Owned process cleanup failed \(synthetic live EPERM\)/u);
+            return true;
+        });
+        const readyDeadline = Date.now() + 2_000;
+        while (!existsSync(marker) && Date.now() < readyDeadline)
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        assert.equal(existsSync(marker), true);
+        const pids = JSON.parse(readFileSync(marker, 'utf8'));
+        for (const pid of pids) {
+            const birth = identity(pid);
+            assert.ok(birth);
+            owned.set(pid, birth);
+        }
+        const leader = pids[0];
+        let observedEperm = false;
+        const kill = vi.spyOn(process, 'kill').mockImplementation((pid, signal) => {
+            assert.notEqual(pid, unrelated.pid);
+            if (pid !== -leader || signal !== 'SIGKILL')
+                return originalKill(pid, signal);
+            if (disposition !== 'live root') {
+                writeFileSync(release, 'exit');
+                const exitDeadline = Date.now() + 2_000;
+                for (;;) {
+                    assert.equal(identity(leader), owned.get(leader));
+                    const state = spawnSync('/bin/ps', ['-p', String(leader), '-o', 'stat='], {
+                        encoding: 'utf8',
+                    }).stdout.trim();
+                    if (state.startsWith('Z'))
+                        break;
+                    assert.ok(Date.now() < exitDeadline, 'owned leader did not exit at the signal boundary');
+                }
+            }
+            if (disposition === 'exited group') {
+                try {
+                    return originalKill(pid, signal);
+                }
+                catch (error) {
+                    assert.equal(error.code, 'EPERM');
+                    observedEperm = true;
+                    throw error;
+                }
+            }
+            if (disposition === 'live group member') {
+                const member = pids[1];
+                assert.equal(identity(member), owned.get(member));
+                assert.doesNotMatch(spawnSync('/bin/ps', ['-p', String(member), '-o', 'stat='], { encoding: 'utf8' }).stdout, /^\s*Z/u);
+            }
+            observedEperm = true;
+            if (disposition === 'live root')
+                permissionExit = setTimeout(() => writeFileSync(release, 'exit'), 500);
+            throw Object.assign(new Error('synthetic live EPERM'), { code: 'EPERM' });
+        });
+        restoreKill = () => kill.mockRestore();
+        controller.abort();
+        await rejection;
+        assert.equal(observedEperm, true);
+        assert.equal(identity(unrelated.pid), unrelatedIdentity);
+        assert.equal(existsSync(join(root, '.git', 'ai-delivery', 'verification@1', 'stages', 'check')), false);
+    }
+    finally {
+        restoreKill?.();
+        clearTimeout(permissionExit);
+        controller.abort();
+        for (const [pid, birth] of owned) {
+            if (identity(pid) === birth) {
+                try {
+                    originalKill(pid, 'SIGKILL');
+                }
+                catch (error) {
+                    assert.equal(error.code, 'ESRCH');
+                }
+            }
+        }
+        if (unrelated.pid !== undefined && identity(unrelated.pid) === unrelatedIdentity)
+            originalKill(unrelated.pid, 'SIGKILL');
+        await run?.catch(() => undefined);
+        await new Promise((resolve) => {
+            if (unrelated.exitCode !== null || unrelated.signalCode !== null)
+                resolve();
+            else
+                unrelated.once('close', () => resolve());
+        });
+        rmSync(root, { recursive: true, force: true });
+        rmSync(output, { recursive: true, force: true });
+    }
+});
 test.each([
     { name: 'nonzero exit', terminate: 'process.exit(7)', expected: /exit 7/u },
     { name: 'signal', terminate: "process.kill(process.pid,'SIGTERM')", expected: /signal SIGTERM/u },
@@ -3278,6 +4753,13 @@ async function syntheticLifecycle(routing) {
     const historicalActor = routing.committedDescendantContinuation ? 'host-user' : 'synthetic-author[bot]';
     let nativePrAuthor = historicalActor;
     let nativeClosingIssue = issueNumber;
+    let nativeClosingConnectionEmpty = false;
+    let nativeClosingHasNextPage = false;
+    let nativeRefsBody = `Refs #${String(issueNumber)}`;
+    let nativeTimelinePages;
+    let nativeTimelineFailurePage;
+    let nativeTimelineNextLink = false;
+    let nativeTimelineCalls = 0;
     let nativePrRepository;
     const continuationComments = [];
     const createPayloads = [];
@@ -3304,6 +4786,8 @@ async function syntheticLifecycle(routing) {
         node_id: 'PR-23',
         title: 'Synthetic change',
         html_url: 'https://example.test/pulls/23',
+        url: 'https://api.example.test/repos/example/widget/pulls/23',
+        body: nativeRefsBody,
         state: stale ? 'open' : prState,
         draft: prDraft,
         merged_at: !stale && prState === 'closed' ? mergedAt : null,
@@ -3313,16 +4797,39 @@ async function syntheticLifecycle(routing) {
         mergeable_state: 'clean',
         user: { login: nativePrAuthor, id: 37, type: routing.committedDescendantContinuation ? 'User' : 'Bot' },
         head: { sha: headSha, ref: 'issue/17', ...(nativePrRepository ? { repo: { full_name: nativePrRepository } } : {}) },
-        base: { sha: baseSha, ref: 'main', ...(nativePrRepository ? { repo: { full_name: nativePrRepository } } : {}) },
+        base: {
+            sha: baseSha,
+            ref: 'main',
+            ...(nativePrRepository
+                ? { repo: { full_name: nativePrRepository, url: `https://api.example.test/repos/${nativePrRepository}` } }
+                : {}),
+        },
+    });
+    const nativeReference = () => ({
+        event: 'cross-referenced',
+        actor: { login: historicalActor, id: 37, type: 'User' },
+        created_at: new Date(Date.parse(mergedAt) - 60_000).toISOString(),
+        source: {
+            type: 'issue',
+            issue: {
+                number: prNumber,
+                user: { login: historicalActor, id: 37, type: 'User' },
+                repository_url: 'https://api.example.test/repos/example/widget',
+                html_url: 'https://example.test/pulls/23',
+                pull_request: { url: 'https://api.example.test/repos/example/widget/pulls/23' },
+            },
+        },
     });
     const graphql = async (query, variables = {}) => {
-        if (query.includes('WorktreeTransitionLineage'))
+        if (query.includes('WorktreeTransitionLineage') || query.includes('CommittedContinuationLineage'))
             return {
                 repository: {
                     pullRequest: {
                         closingIssuesReferences: {
-                            nodes: [{ number: nativeClosingIssue, repository: { nameWithOwner: nativePrRepository } }],
-                            pageInfo,
+                            nodes: nativeClosingConnectionEmpty
+                                ? []
+                                : [{ number: nativeClosingIssue, repository: { nameWithOwner: nativePrRepository } }],
+                            pageInfo: { ...pageInfo, hasNextPage: nativeClosingHasNextPage },
                         },
                     },
                 },
@@ -3525,6 +5032,18 @@ async function syntheticLifecycle(routing) {
             throw new Error(`Unexpected REST route: ${route}`);
         },
         issues: {
+            listEventsForTimeline: async (input) => {
+                assert.equal(input.issue_number, issueNumber);
+                nativeTimelineCalls += 1;
+                if (input.page === nativeTimelineFailurePage)
+                    throw new Error('Synthetic native timeline unavailable');
+                return {
+                    headers: nativeTimelineNextLink && input.page === 1
+                        ? { link: '<https://api.example.test/repos/example/widget/issues/17/timeline?page=2>; rel="next"' }
+                        : {},
+                    data: nativeTimelinePages?.[input.page - 1] ?? (input.page === 1 ? [nativeReference()] : []),
+                };
+            },
             listComments: async () => ({ data: continuationComments }),
             getComment: async (input) => ({
                 data: continuationComments.find((comment) => comment.id === input.comment_id),
@@ -4386,6 +5905,78 @@ exec "${realGit}" "$@"
                         });
                     assert.equal(crashIndex, 2);
                 }
+                if (routing.nativeRefsContinuation) {
+                    nativeClosingConnectionEmpty = true;
+                    nativeClosingHasNextPage = true;
+                    await refuse(/Native PR lineage/u);
+                    nativeClosingHasNextPage = false;
+                    nativeClosingConnectionEmpty = false;
+                    nativeClosingIssue = 18;
+                    await refuse(/Native PR lineage/u);
+                    nativeClosingIssue = issueNumber;
+                    nativeClosingConnectionEmpty = true;
+                    for (const body of ['', 'Refs #18', 'Refs #170', 'Refs #17letters', 'Refs #17_extra', 'Mention #17']) {
+                        nativeRefsBody = body;
+                        await refuse(/Native PR lineage/u);
+                    }
+                    nativeRefsBody = `Refs #${String(issueNumber)}`;
+                    const event = nativeReference();
+                    const source = event.source;
+                    const sourceIssue = source.issue;
+                    for (const invalid of [
+                        undefined,
+                        { ...event, actor: { ...event.actor, id: 99 } },
+                        { ...event, actor: { ...event.actor, login: 'different-user' } },
+                        { ...event, actor: { ...event.actor, type: 'Bot' } },
+                        { ...event, created_at: mergedAt },
+                        { ...event, created_at: new Date(Date.parse(mergedAt) + 1000).toISOString() },
+                        { ...event, created_at: 'unknown' },
+                        { ...event, source: { ...source, type: 'pull_request' } },
+                        { ...event, source: { ...source, issue: { ...sourceIssue, number: 24 } } },
+                        {
+                            ...event,
+                            source: {
+                                ...source,
+                                issue: { ...sourceIssue, repository_url: 'https://api.example.test/repos/other/widget' },
+                            },
+                        },
+                        { ...event, source: { ...source, issue: { ...sourceIssue, html_url: 'https://example.test/pulls/24' } } },
+                        {
+                            ...event,
+                            source: {
+                                ...source,
+                                issue: {
+                                    ...sourceIssue,
+                                    pull_request: { url: 'https://api.example.test/repos/example/widget/pulls/24' },
+                                },
+                            },
+                        },
+                        { ...event, source: { ...source, issue: { ...sourceIssue, pull_request: undefined } } },
+                        { ...event, source: { ...source, issue: { ...sourceIssue, user: { ...sourceIssue.user, id: 99 } } } },
+                    ]) {
+                        nativeTimelinePages = [invalid === undefined ? [] : [invalid]];
+                        await refuse(/Native PR lineage/u);
+                    }
+                    nativeTimelinePages = [[event]];
+                    nativeTimelineFailurePage = 1;
+                    await refuse(/Synthetic native timeline unavailable/u);
+                    nativeTimelineFailurePage = 2;
+                    nativeTimelineNextLink = true;
+                    const before = nativeTimelineCalls;
+                    await refuse(/Synthetic native timeline unavailable/u);
+                    assert.equal(nativeTimelineCalls - before, 2, 'matching first page cannot hide a missing next page');
+                    nativeTimelineFailurePage = undefined;
+                    nativeTimelineNextLink = false;
+                    nativeTimelinePages = [Array.from({ length: 100 }, () => ({ event: 'commented' })), [event]];
+                    unlinkSync(witness.path);
+                    try {
+                        await refuse(/ownership witness/u);
+                    }
+                    finally {
+                        writeFileSync(witness.path, witness.bytes, { mode: 0o600 });
+                    }
+                    nativeRefsBody = `Refs #${String(issueNumber)}. Keep the issue open for retirement and supported consumer cutover.`;
+                }
                 const first = await executeTool('issue_develop', { issueNumber }, execution).catch((error) => error);
                 assert.ok(first instanceof Error);
                 assert.match(first.message, /exact native.*acceptance/u);
@@ -4834,6 +6425,13 @@ test('supported develop reconciles authenticated host custody for an already com
     assert.ok(uninterrupted.value);
     assert.deepEqual(recovered.value, uninterrupted.value);
 });
+test('supported develop preserves native Refs lineage for a committed descendant', { timeout: 0 }, async () => syntheticLifecycle({
+    remote: 'origin',
+    divergentOrigin: false,
+    committedDescendantContinuation: true,
+    nativeRefsContinuation: true,
+    interruptContinuation: false,
+}));
 test('committed descendant checkpoint publication recovers from SIGKILL before and after every rename', { timeout: 0 }, async () => syntheticLifecycle({
     remote: 'origin',
     divergentOrigin: false,
@@ -4992,7 +6590,8 @@ test.each([
         fs.symlinkSync('./other', ${JSON.stringify(intermediate)});
       }
       if (${JSON.stringify(mode)} === 'chain-cycle') {
-        fs.unlinkSync(${JSON.stringify(intermediate)}); fs.symlinkSync('./cli', ${JSON.stringify(intermediate)});
+        const replacement = ${JSON.stringify(join(output, 'next-intermediate'))};
+        fs.symlinkSync('./cli', replacement); fs.renameSync(replacement, ${JSON.stringify(intermediate)});
       }
       for (let unit = 0; unit < 32; unit++) {
         fs.appendFileSync(${JSON.stringify(join(second, 'work'))}, 'unit\\n');
@@ -5020,13 +6619,17 @@ test.each([
                             ? /unsupported file/u
                             : mode === 'permission'
                                 ? /readdir failed.*EACCES/u
-                                : mode === 'cycle' || mode === 'chain-cycle'
+                                : mode === 'cycle'
                                     ? /ELOOP/u
-                                    : /identity changed/u);
+                                    : mode === 'chain-cycle'
+                                        ? /ELOOP|alias identity changed/u
+                                        : /identity changed/u);
             assert.match(message, /First filesystem observation:.*ENOENT.*Last filesystem observation:/u);
             assert.doesNotMatch(message, /cleanup failed/u);
             return true;
         });
+        if (mode === 'cycle' || mode === 'chain-cycle')
+            assert.throws(() => realpathSync(alias), (error) => error.code === 'ELOOP');
         assert.ok(observations.some((line) => line.includes('ENOENT')));
         assert.equal(observations.some((line) => line.includes('"state":"completed"')), false);
         assert.equal(readFileSync(join(second, 'unrelated'), 'utf8'), 'preserved');