@aviaratech/ai-delivery 0.3.5 → 0.3.7

package/dist/worktreeTransition.d.ts

@@ -0,0 +1,173 @@
+import { z } from 'zod';
+import type { DeliveryContext } from './issue.js';
+import type { WorktreeEntry } from './services/worktreeRegistry.js';
+export interface TransitionEvidenceFile {
+    path: string;
+    source: string;
+    digest: string;
+    size: number;
+}
+export declare const WorktreeTransitionPlanSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"ai-delivery.worktree-transition-plan@1">;
+    planId: z.ZodString;
+    repository: z.ZodString;
+    repoRoot: z.ZodString;
+    row: z.ZodObject<{
+        branch: z.ZodString;
+        createdAt: z.ZodString;
+        identity: z.ZodString;
+        issueNumber: z.ZodNumber;
+        path: z.ZodString;
+        prNumber: z.ZodOptional<z.ZodNumber>;
+        status: z.ZodEnum<{
+            error: "error";
+            active: "active";
+            stale: "stale";
+            merged: "merged";
+            "pr-published": "pr-published";
+        }>;
+        type: z.ZodLiteral<"issue">;
+        updatedAt: z.ZodString;
+    }, z.core.$strict>;
+    purpose: z.ZodEnum<{
+        "active-resume": "active-resume";
+        "merged-cleanup": "merged-cleanup";
+    }>;
+    disposition: z.ZodEnum<{
+        remove: "remove";
+        retain: "retain";
+    }>;
+    head: z.ZodObject<{
+        sha: z.ZodString;
+        tree: z.ZodString;
+    }, z.core.$strict>;
+    terminalPrNumber: z.ZodNullable<z.ZodNumber>;
+    lineage: z.ZodArray<z.ZodObject<{
+        prNumber: z.ZodNumber;
+        headSha: z.ZodString;
+        headBranch: z.ZodString;
+        baseSha: z.ZodString;
+        baseBranch: z.ZodString;
+        mergeSha: z.ZodNullable<z.ZodString>;
+        merged: z.ZodBoolean;
+        authorLogin: z.ZodString;
+    }, z.core.$strict>>;
+    retainedHoldCommentIds: z.ZodArray<z.ZodNumber>;
+    remoteRefs: z.ZodNullable<z.ZodObject<{
+        headSha: z.ZodNullable<z.ZodString>;
+        baseSha: z.ZodString;
+    }, z.core.$strict>>;
+    holdEvidence: z.ZodArray<z.ZodObject<{
+        commentId: z.ZodNumber;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    inventory: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        source: z.ZodString;
+        digest: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strict>>;
+    inventoryId: z.ZodString;
+    historicalProducer: z.ZodLiteral<"UNKNOWN">;
+    closure: z.ZodObject<{
+        family: z.ZodLiteral<"public-ai-delivery-0.3.5-posix@1">;
+        admissionPath: z.ZodString;
+        archivePath: z.ZodString;
+        admission: z.ZodObject<{
+            admissionId: z.ZodString;
+            capability: z.ZodObject<{
+                cli: z.ZodNumber;
+                mcp: z.ZodNumber;
+            }, z.core.$strict>;
+            cliPath: z.ZodString;
+            cliSha256: z.ZodString;
+            configDigest: z.ZodString;
+            mcpLauncherPath: z.ZodString;
+            mcpLauncherSha256: z.ZodString;
+            packageDistSha256: z.ZodString;
+            packageManifestSha256: z.ZodString;
+            packageVersion: z.ZodString;
+            pluginManifestPath: z.ZodString;
+            pluginManifestSha256: z.ZodString;
+            repository: z.ZodString;
+            schemaVersion: z.ZodLiteral<"ai-delivery.runtime-admission@2">;
+            sourceArchiveSha256: z.ZodString;
+            sourceCommit: z.ZodString;
+        }, z.core.$strict>;
+        admissionBytesDigest: z.ZodString;
+        producerDigest: z.ZodString;
+        runManifestIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    currentRuntime: z.ZodObject<{
+        admissionId: z.ZodString;
+        capability: z.ZodObject<{
+            cli: z.ZodNumber;
+            mcp: z.ZodNumber;
+        }, z.core.$strict>;
+        cliPath: z.ZodString;
+        cliSha256: z.ZodString;
+        configDigest: z.ZodString;
+        mcpLauncherPath: z.ZodString;
+        mcpLauncherSha256: z.ZodString;
+        packageDistSha256: z.ZodString;
+        packageManifestSha256: z.ZodString;
+        packageVersion: z.ZodString;
+        pluginManifestPath: z.ZodString;
+        pluginManifestSha256: z.ZodString;
+        repository: z.ZodString;
+        schemaVersion: z.ZodLiteral<"ai-delivery.runtime-admission@2">;
+        sourceArchiveSha256: z.ZodString;
+        sourceCommit: z.ZodString;
+    }, z.core.$strict>;
+    policyDigest: z.ZodString;
+    operator: z.ZodObject<{
+        actorLogin: z.ZodString;
+        credentialIdentity: z.ZodString;
+    }, z.core.$strict>;
+    reviewerActor: z.ZodString;
+}, z.core.$strict>;
+export type WorktreeTransitionPlan = z.infer<typeof WorktreeTransitionPlanSchema>;
+export interface InspectWorktreeTransitionInput {
+    issueNumber: number;
+    purpose: 'active-resume' | 'merged-cleanup';
+    disposition?: 'retain' | 'remove';
+    terminalPrNumber?: number;
+    retainedHoldCommentIds?: number[];
+    retainedAdmissionPath?: string;
+    retainedArchivePath?: string;
+    runtimeEntryPath?: string;
+}
+/** Read-only, deterministic inventory. Unknown historical schemas remain opaque bytes. */
+export declare function inventoryTransitionEvidence(root: string, row: WorktreeEntry, removed?: boolean): TransitionEvidenceFile[];
+export declare function applyWorktreeTransition(context: DeliveryContext, input: {
+    authority: 'worktree:transition';
+    planPath: string;
+    expectedPlanId: string;
+    relinquishmentCommentId: number;
+    acceptanceCommentId: number;
+    runtimeEntryPath?: string;
+}): Promise<{
+    planId: string;
+    result: 'active-resumed' | 'retained' | 'removed';
+    replayed: boolean;
+    receiptPath: string;
+}>;
+export declare function worktreeRelinquishmentBody(plan: WorktreeTransitionPlan): string;
+export declare function worktreeAcceptanceBody(plan: WorktreeTransitionPlan, relinquishmentCommentId: number): string;
+/** Whole native bodies and the configured live actors are authority; local digests alone are not. */
+export declare function assertWorktreeTransitionNativeAuthority(context: DeliveryContext, plan: WorktreeTransitionPlan, ids: {
+    relinquishmentCommentId: number;
+    acceptanceCommentId: number;
+}): Promise<{
+    relinquishment: unknown;
+    acceptance: unknown;
+}>;
+export declare function inspectWorktreeTransition(context: DeliveryContext, input: InspectWorktreeTransitionInput): Promise<{
+    ready: boolean;
+    blockers: string[];
+    plan: WorktreeTransitionPlan | null;
+    inventory: TransitionEvidenceFile[];
+    relinquishmentBody?: string;
+}>;
+/** Original copies are immutable and content addressed; every source is checked again before capture. */
+export declare function preserveTransitionEvidence(directory: string, inventory: readonly TransitionEvidenceFile[]): void;