@aviaratech/ai-delivery 0.3.22 → 0.3.24

package/dist/stdoutRegression.test.js

@@ -0,0 +1,326 @@
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { Console } from 'node:console';
+import { mkdtempSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Octokit } from '@octokit/rest';
+import { afterEach, test, vi } from 'vitest';
+import { parseDeliveryConfig } from './config/deliveryConfig.js';
+import { syntheticDiscoveryConfig } from './fixtures/discovery.js';
+import { replaceParentIssue } from './github/relationships.js';
+import { CLIError, handleCommandError, logDebug, logError, logInfo, logProgress, logSuccess, logWarn, setLogsSuppressed, } from './logger.js';
+import { addWorktreeEntry, removeWorktreeEntry } from './services/worktreeRegistry.js';
+// Project/field metadata is unrelated to stream routing. Keep these provider
+// adapters local while exercising real parent linking, issue start and dispatch.
+vi.mock('./github/nativeIssueMetadata.js', async (importOriginal) => ({
+    ...(await importOriginal()),
+    getConfiguredNativeIssueMetadata: async () => ({ points: 2 }),
+    setConfiguredNativeIssueMetadata: async () => ({ points: 2 }),
+    clearConfiguredNativeIssuePoints: async () => { },
+}));
+vi.mock('./github/projectDelivery.js', async (importOriginal) => ({
+    ...(await importOriginal()),
+    getIssueProjectStatus: async () => null,
+    syncIssueProjectStatus: async () => null,
+}));
+afterEach(() => {
+    vi.restoreAllMocks();
+    vi.unstubAllEnvs();
+    setLogsSuppressed(false);
+});
+function fixture(developmentFails = false) {
+    const root = realpathSync(mkdtempSync(join(tmpdir(), 'ai-delivery-stdout-')));
+    const git = (...args) => execFileSync('git', args, { cwd: root, encoding: 'utf8' }).trim();
+    git('init', '-q', '-b', 'main');
+    git('config', 'user.name', 'Synthetic Delivery');
+    git('config', 'user.email', 'delivery@example.test');
+    writeFileSync(join(root, 'artifact.txt'), 'synthetic\n');
+    git('add', 'artifact.txt');
+    git('commit', '-qm', 'synthetic base');
+    git('remote', 'add', 'origin', 'https://github.com/example/widget.git');
+    git('update-ref', 'refs/remotes/origin/main', git('rev-parse', 'HEAD'));
+    git('symbolic-ref', 'refs/remotes/origin/HEAD', 'refs/remotes/origin/main');
+    let parent = null;
+    const issue = {
+        id: 170,
+        number: 17,
+        node_id: 'ISSUE-17',
+        title: 'Synthetic change',
+        body: '## Outcome\nDeliver a verified synthetic change to the local repository.\n\n## Scope\n- `artifact.txt`\n\n## Acceptance Criteria\n- [ ] Change works\n- [ ] Review passes\n\n## Verification\nRun `node --version`.',
+        state: 'open',
+        html_url: 'https://github.com/example/widget/issues/17',
+        labels: [],
+        type: { name: 'Task' },
+    };
+    const rest = new Octokit();
+    Object.assign(rest.issues, {
+        get: async ({ issue_number }) => ({
+            data: issue_number === 17
+                ? { ...issue, state: developmentFails ? 'closed' : 'open' }
+                : { ...issue, number: issue_number, id: issue_number * 10, node_id: `ISSUE-${String(issue_number)}` },
+        }),
+        create: async () => ({ data: issue }),
+        listForRepo: async () => ({ data: [] }),
+        update: async () => ({ data: issue }),
+        listSubIssues: async () => ({ data: parent === null ? [] : [issue] }),
+        addSubIssue: async ({ issue_number }) => {
+            parent = issue_number;
+            return { data: issue };
+        },
+    });
+    Object.assign(rest, { paginate: async () => (parent === null ? [] : [issue]) });
+    const clients = {
+        authSource: 'personal',
+        role: 'author',
+        rest,
+        graphql: (async (query) => {
+            const page = { nodes: [], pageInfo: { endCursor: null, hasNextPage: false } };
+            if (query.includes('blockedBy(')) {
+                return {
+                    repository: {
+                        issue: {
+                            blockedBy: page,
+                            parent: parent === null
+                                ? null
+                                : { id: 'ISSUE-5', number: parent, repository: { nameWithOwner: 'example/widget' } },
+                        },
+                    },
+                };
+            }
+            if (query.includes('blocking('))
+                return { repository: { issue: { blocking: page } } };
+            if (query.includes('subIssues('))
+                return { repository: { issue: { subIssues: page } } };
+            throw new Error('Unexpected synthetic stdout query.');
+        }),
+    };
+    const config = parseDeliveryConfig({
+        ...syntheticDiscoveryConfig,
+        schemaVersion: 'ai-delivery.config@2',
+        policy: { contract: 'RepositoryDeliveryPolicy@1', module: './policy.mjs' },
+        roles: {
+            author: { identity: 'host-author', authSource: 'personal', credentialEnv: { token: 'AUTHOR_TOKEN' } },
+            reviewer: {
+                identity: 'synthetic-reviewer',
+                credentialEnv: {
+                    appId: 'REVIEWER_APP_ID',
+                    installationId: 'REVIEWER_INSTALLATION_ID',
+                    privateKeyPath: 'REVIEWER_KEY_PATH',
+                },
+            },
+        },
+        commandPolicy: {
+            checks: { format: 'REQUIRED', gitClean: 'REQUIRED', lint: 'REQUIRED', test: 'REQUIRED', typecheck: 'REQUIRED' },
+            timeoutsMs: { lint: 60000, test: 60000, typecheck: 60000 },
+        },
+    });
+    return {
+        context: { root, repo: { owner: 'example', repo: 'widget' }, clients, config },
+        cleanup: () => rmSync(root, { recursive: true, force: true }),
+    };
+}
+function captureStreams() {
+    const output = { stdout: '', stderr: '' };
+    const previousConsole = globalThis.console;
+    // Vitest intercepts console calls before they reach process streams. Use a
+    // native console so the byte-level capture matches an actual CLI process.
+    globalThis.console = new Console(process.stdout, process.stderr);
+    const out = vi.spyOn(process.stdout, 'write').mockImplementation((value) => {
+        output.stdout += String(value);
+        return true;
+    });
+    const err = vi.spyOn(process.stderr, 'write').mockImplementation((value) => {
+        output.stderr += String(value);
+        return true;
+    });
+    return {
+        output,
+        restore: () => {
+            out.mockRestore();
+            err.mockRestore();
+            globalThis.console = previousConsole;
+        },
+    };
+}
+test('parent replacement emits its diagnostic on stderr without writing any stdout bytes', async () => {
+    const f = fixture();
+    const capture = captureStreams();
+    try {
+        await replaceParentIssue({ ...f.context.clients, repo: f.context.repo, issueNumber: 17, parentIssueNumber: 5 });
+        assert.equal(capture.output.stdout, '');
+        assert.match(capture.output.stderr, /Linked issue #17 as sub-issue of issue #5\./u);
+    }
+    finally {
+        capture.restore();
+        f.cleanup();
+    }
+});
+test.each(['add', 'remove'])('registry %s emits its diagnostic without writing any stdout bytes', async (operation) => {
+    const f = fixture();
+    const row = {
+        path: join(f.context.root, '.worktrees', 'synthetic'),
+        branch: 'issue/17',
+        type: 'issue',
+        issueNumber: 17,
+        identity: 'host-author',
+        status: 'active',
+        createdAt: '2026-10-08T00:00:00Z',
+        updatedAt: '2026-10-08T00:00:00Z',
+    };
+    const capture = captureStreams();
+    try {
+        await addWorktreeEntry(row, f.context.root);
+        if (operation === 'remove') {
+            capture.output.stdout = '';
+            capture.output.stderr = '';
+            assert.equal(await removeWorktreeEntry(row.path, f.context.root), true);
+        }
+        assert.equal(capture.output.stdout, '');
+        assert.match(capture.output.stderr, operation === 'add' ? /Added to worktree registry:/u : /Removed from worktree registry:/u);
+    }
+    finally {
+        capture.restore();
+        f.cleanup();
+    }
+});
+async function runCli(context, args) {
+    vi.resetModules();
+    const configuration = await import('./config/deliveryConfig.js');
+    const issues = await import('./issue.js');
+    const admission = await import('./services/deliveryAdmission.js');
+    const prs = await import('./pr.js');
+    const dispatch = await import('./dispatch.js');
+    vi.spyOn(configuration, 'loadDeliverySettings').mockResolvedValue({
+        ...context.config,
+        configPath: 'synthetic-user.json',
+        checkoutRoots: [],
+        overrides: { schemaVersion: 'ai-delivery.config@2' },
+        sourceDigest: 'synthetic',
+    });
+    vi.spyOn(issues, 'loadDeliveryContext').mockResolvedValue(context);
+    // Synthetic authorization seams: these tests exercise streams, not live access.
+    vi.spyOn(admission, 'assertDeliveryRuntimeAdmitted').mockResolvedValue({});
+    vi.spyOn(prs, 'preflightReviewRoute').mockResolvedValue({});
+    const argv = process.argv;
+    const exitCode = process.exitCode;
+    const capture = captureStreams();
+    let completed = () => { };
+    let failed = () => { };
+    const resultWritten = new Promise((resolve, reject) => {
+        completed = resolve;
+        failed = reject;
+    });
+    const execute = dispatch.executeTool;
+    vi.spyOn(dispatch, 'executeTool').mockImplementation(async (...input) => {
+        try {
+            return await execute(...input);
+        }
+        catch (error) {
+            failed(error);
+            throw error;
+        }
+    });
+    vi.spyOn(process.stdout, 'write').mockImplementation((value) => {
+        capture.output.stdout += String(value);
+        // Wait for the result, not the earlier diagnostic chunk that reproduces #74.
+        if (String(value).startsWith('{'))
+            completed();
+        return true;
+    });
+    try {
+        process.exitCode = undefined;
+        process.argv = [process.execPath, 'ai-delivery', '--repo-root', context.root, '--identity', 'host-author', ...args];
+        await import('./cli.js');
+        await resultWritten;
+        return { ...capture.output, exitCode: process.exitCode };
+    }
+    finally {
+        capture.restore();
+        vi.restoreAllMocks();
+        process.argv = argv;
+        process.exitCode = exitCode;
+    }
+}
+test('parent update through the CLI entry produces one parseable JSON result', async () => {
+    const f = fixture();
+    try {
+        const output = await runCli(f.context, ['update', '--issue', '17', '--parent', '5']);
+        const result = JSON.parse(output.stdout);
+        assert.equal(result.issueNumber, 17);
+        assert.equal(result.parentIssueNumber, 5);
+        assert.equal(output.exitCode, undefined);
+        assert.match(output.stderr, /Linked issue #17 as sub-issue of issue #5\./u);
+    }
+    finally {
+        f.cleanup();
+    }
+});
+test('failed remote branch start after parent linking preserves parseable CLI recovery JSON and nonzero exit', async () => {
+    const f = fixture(true);
+    try {
+        const output = await runCli(f.context, [
+            'start',
+            '--title',
+            'Synthetic change',
+            '--body',
+            '## Outcome\nDeliver a verified synthetic change to the local repository.\n\n## Scope\n- `artifact.txt`\n\n## Acceptance Criteria\n- [ ] Change works\n- [ ] Review passes\n\n## Verification\nRun `node --version`.',
+            '--parent',
+            '5',
+        ]);
+        const result = JSON.parse(output.stdout);
+        assert.equal(result.status, 'created-not-started');
+        assert.equal(result.createdIssue.number, 17);
+        assert.equal(result.failure.phase, 'branch-or-journal');
+        assert.match(result.failure.message, /open GitHub issue/u);
+        assert.equal(result.safeResume.arguments.issueNumber, 17);
+        assert.equal(result.safeResume.arguments.parentIssueNumber, 5);
+        assert.equal(result.safeResume.arguments.resumeCreated, true);
+        assert.equal(output.exitCode, 1);
+        assert.match(output.stderr, /Linked issue #17 as sub-issue of issue #5\./u);
+    }
+    finally {
+        f.cleanup();
+    }
+});
+test('all enabled diagnostics preserve their content on stderr', () => {
+    vi.stubEnv('DEBUG', '1');
+    const capture = captureStreams();
+    try {
+        logDebug('debug proof');
+        logInfo('info proof');
+        logSuccess('success proof');
+        logWarn('warning proof');
+        logError('error proof');
+        logProgress('progress proof');
+        handleCommandError(new CLIError('failure proof', { hint: 'retry proof' }));
+        assert.equal(capture.output.stdout, '');
+        for (const message of ['debug', 'info', 'success', 'warning', 'error', 'progress', 'failure', 'retry']) {
+            assert.match(capture.output.stderr, new RegExp(`${message} proof`, 'u'));
+        }
+    }
+    finally {
+        capture.restore();
+    }
+});
+test('MCP suppression still silences diagnostics while retaining errors and recovery hints on stderr', () => {
+    vi.stubEnv('DEBUG', 'true');
+    setLogsSuppressed(true);
+    const capture = captureStreams();
+    try {
+        logDebug('hidden');
+        logInfo('hidden');
+        logSuccess('hidden');
+        logWarn('hidden');
+        logProgress('hidden');
+        handleCommandError(new CLIError('visible error', { hint: 'visible recovery' }));
+        assert.equal(capture.output.stdout, '');
+        assert.doesNotMatch(capture.output.stderr, /hidden/u);
+        assert.match(capture.output.stderr, /visible error/u);
+        assert.match(capture.output.stderr, /visible recovery/u);
+    }
+    finally {
+        capture.restore();
+    }
+});
+//# sourceMappingURL=stdoutRegression.test.js.map

package/dist/stdoutRegression.test.js.map

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

package/dist/verification.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { type RepositoryApprovalBinding, type RepositoryClassificationReceipt, type RepositoryDeliveryEvidence, type RepositoryMergeReadback, type RepositoryStageAggregate, type RepositoryStageReceipt } from './delivery/index.js';
+import { type RepositoryClassificationReceipt, type RepositoryStageAggregate, type RepositoryStageReceipt } from './delivery/legacy.js';
 export interface VerificationRun {
     aggregate: RepositoryStageAggregate;
     classification: RepositoryClassificationReceipt;
@@ -35,8 +35,58 @@ declare const ResourceSummarySchema: z.ZodObject<{
     sampleCount: z.ZodNumber;
 }, z.core.$strict>;
 export type VerificationResourceSummary = z.infer<typeof ResourceSummarySchema>;
+interface ResourceSample {
+    aggregateRssBytes: number;
+    freeDiskBytes: number;
+    newOutputBytes?: number;
+    ownedProcessCount: number;
+}
+declare const OutputGateSchema: z.ZodObject<{
+    directory: z.ZodString;
+    id: z.ZodUUID;
+    owner: z.ZodObject<{
+        pid: z.ZodNumber;
+        identity: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type OutputGate = z.infer<typeof OutputGateSchema>;
 /** Run a real filesystem-negative fixture between strict scans; the callback must clean it up before returning. */
 export declare function withVerificationFilesystemFixture<T>(operation: () => T | Promise<T>): Promise<T>;
+interface OutputBaseline {
+    gate?: OutputGate;
+    baselineId: string;
+    files: Map<string, number>;
+    links: Map<string, {
+        identity: string;
+        target: string;
+        missing: boolean;
+    }>;
+    roots: string[];
+}
+interface ObservedProcess {
+    identity: string;
+    pgid: number;
+    pid: number;
+    ppid: number;
+    rssBytes: number;
+    status: string;
+}
+export interface OwnedProcessState {
+    rootIdentity?: string;
+    rootPid: number;
+    sampled: boolean;
+    tracked: Map<number, ObservedProcess>;
+}
+export declare function processSnapshot(): Map<number, ObservedProcess>;
+export declare function confirmOwnedCleanup(state: OwnedProcessState): Promise<void>;
+/** Signal only birth identities established by this command, including observed detached children. */
+export declare function terminateOwnedProcesses(state: OwnedProcessState): void;
+interface VerificationWriter {
+    starting(): void;
+    observed(state: OwnedProcessState): void;
+    idle(): void;
+    assertQuiescent(): void;
+}
 /** @internal Durable transition evidence must precede changes to the existing writer slot. */
 export interface WorktreeTransitionWriterLeaseInput {
     repoRoot: string;
@@ -71,30 +121,16 @@ export declare function retainedWorktreeTransitionDependencyManifests(distDirect
 }[];
 /** @internal Original manifests validate as history and cannot authorize current verification. */
 export declare function readWorktreeTransitionRun(bytes: Buffer): VerificationRun;
-export declare function verifyIssue(input: {
-    personalAuth?: boolean;
-    admittedResourceClasses?: readonly string[];
-    issueNumber: number;
-    repoRoot: string;
-    resourceBounds?: VerificationResourceBounds;
-    signal?: AbortSignal;
-}): Promise<VerificationRun>;
-export declare function createIssuePhaseEvidence(input: {
-    personalAuth?: boolean;
-    approval?: RepositoryApprovalBinding;
-    issueNumber: number;
-    mergeReadback?: RepositoryMergeReadback;
-    phase: 'verify' | 'publish' | 'merge';
-    repoRoot: string;
-}): Promise<RepositoryDeliveryEvidence>;
-export declare function loadVerifiedRun(repoRoot: string, issueNumber: number): VerificationRun;
-/** @internal Preservation-only read; the continuation owner validates custody and terminal lineage. */
-export declare function loadHistoricalMergedRun(repoRoot: string, headSha: string): {
-    run: VerificationRun;
-    path: string;
-};
-/** Recover an exact merged run after worktree removal interrupted terminal recording. */
-export declare function loadRemovedMergedRun(primaryRepoRoot: string, issueNumber: number): VerificationRun;
+export declare function runStageCommand(repoRoot: string, argv: readonly string[], abortSignal?: AbortSignal, onRunning?: (capturedOutputBytes: number, resource?: ResourceSample, reason?: string) => void, resourceBounds?: VerificationResourceBounds, baseline?: OutputBaseline, onResourceSample?: (sample: ResourceSample) => void, writer?: VerificationWriter, execution?: {
+    environment: NodeJS.ProcessEnv;
+    cwd?: string;
+    maxCapturedOutputBytes?: number;
+    includeControllerTree?: boolean;
+    onCaptured?(bytes: number): void;
+    onCleanupFailure?(reason: string): void;
+    failedOutput?(bytes: Buffer): string;
+    stdoutOnly?: boolean;
+}): Promise<Buffer>;
 declare const SourceArtifactSchema: z.ZodObject<{
     path: z.ZodString;
     digest: z.ZodString;
@@ -230,11 +266,10 @@ declare const IssueSourcePhaseReceiptSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type IssueSourcePhaseReceipt = z.infer<typeof IssueSourcePhaseReceiptSchema>;
-/** Run an authorized, frozen source graph under the registered issue's existing writer fence. */
-export declare function withIssueSourcePhase(supplied: IssueSourcePhaseInput, operation: (context: IssueSourcePhaseContext) => Promise<void>): Promise<IssueSourcePhaseReceipt>;
 /** @internal Runtime setup shares the existing writer, ownership handshake and bounded command runner. */
 export declare function withRuntimeSetupWriter<T>(root: string, operation: (runner: {
     assertQuiescent(): void;
+    bindCapturedOutput(stageId: string): void;
     checkResources: () => Promise<void>;
     signal: AbortSignal;
     run(argv: readonly string[], bounds: VerificationResourceBounds, signal?: AbortSignal, environment?: NodeJS.ProcessEnv, cwd?: string): Promise<Buffer>;