botmux 2.111.0 → 2.112.0

package/dist/workflows/migration/v2-run-archive-schema.d.ts.map

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

package/dist/workflows/migration/v2-run-archive-schema.js

@@ -0,0 +1,113 @@
+/** Persisted contract for the one-time v2 workflow-run archive. */
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { canonicalJsonStringify } from '../../utils/canonical-json.js';
+export const V2_RUN_ARCHIVE_SCHEMA_VERSION = 1;
+export const V2_RUN_ARCHIVE_KIND = 'botmux-v2-workflow-run-archive';
+export const V2_RUN_ARCHIVE_COMMIT_SCHEMA_VERSION = 1;
+export const V2_RUN_RETIREMENT_SCHEMA_VERSION = 1;
+export const V2_RUN_RETIREMENT_KIND = 'botmux-v2-workflow-run-retirement';
+const Sha256Schema = z.string().regex(/^sha256:[0-9a-f]{64}$/);
+const RelativePathSchema = z.string().min(1).max(4096).refine((value) => !value.startsWith('/') &&
+    !value.startsWith('\\') &&
+    !value.includes('\\') &&
+    value.split('/').every((segment) => segment !== '' && segment !== '.' && segment !== '..'), 'must be a normalized relative POSIX path');
+export const V2RunArchiveFileSchema = z.object({
+    path: RelativePathSchema,
+    bytes: z.number().int().nonnegative(),
+    sha256: Sha256Schema,
+}).strict();
+export const V2RunArchiveWarningSchema = z.object({
+    code: z.string().min(1).max(128),
+    message: z.string().min(1).max(2048),
+}).strict();
+const TerminalStatusSchema = z.enum(['succeeded', 'failed', 'cancelled']);
+export const V2RunArchiveVerdictSchema = z.object({
+    status: TerminalStatusSchema,
+    workflowId: z.string().min(1),
+    revisionId: z.string().min(1).optional(),
+    lastSeq: z.number().int().positive(),
+    updatedAt: z.number().finite(),
+    dangling: z.object({
+        activities: z.number().int().nonnegative(),
+        effectAttempted: z.number().int().nonnegative(),
+        waits: z.number().int().nonnegative(),
+        cancels: z.number().int().nonnegative(),
+    }).strict(),
+    liveTerminalSidecars: z.number().int().nonnegative(),
+}).strict();
+export const V2RunArchiveRunSchema = z.object({
+    runId: z.string().min(1).max(128),
+    rawRoot: RelativePathSchema,
+    projectionPath: RelativePathSchema,
+    projectionSha256: Sha256Schema,
+    presence: z.object({
+        workflowJson: z.boolean(),
+        chatBindingJson: z.boolean(),
+        attemptsDir: z.boolean(),
+        blobsDir: z.boolean(),
+    }).strict(),
+    missingOptional: z.array(z.enum(['chat-binding.json', 'attempts'])),
+    warnings: z.array(V2RunArchiveWarningSchema),
+    verdict: V2RunArchiveVerdictSchema,
+}).strict();
+export const V2RunArchiveResidualSchema = z.object({
+    name: z.string().min(1),
+    sourceType: z.enum(['directory', 'file']),
+    reason: z.enum(['directory-without-events', 'top-level-file']),
+    rawRoot: RelativePathSchema,
+    fileCount: z.number().int().nonnegative(),
+    totalBytes: z.number().int().nonnegative(),
+    treeSha256: Sha256Schema,
+}).strict();
+export const V2RunArchiveContentSchema = z.object({
+    runs: z.array(V2RunArchiveRunSchema),
+    residuals: z.array(V2RunArchiveResidualSchema),
+    payloadDirectories: z.array(RelativePathSchema),
+    payloadFiles: z.array(V2RunArchiveFileSchema),
+}).strict();
+export const V2RunArchiveManifestSchema = z.object({
+    schemaVersion: z.literal(V2_RUN_ARCHIVE_SCHEMA_VERSION),
+    kind: z.literal(V2_RUN_ARCHIVE_KIND),
+    archiveId: Sha256Schema,
+    createdAt: z.string().datetime(),
+    sourceRunsDir: z.string().min(1),
+    containsSensitiveData: z.literal(true),
+    content: V2RunArchiveContentSchema,
+}).strict();
+export const V2RunArchiveCommitMarkerSchema = z.object({
+    schemaVersion: z.literal(V2_RUN_ARCHIVE_COMMIT_SCHEMA_VERSION),
+    archiveId: Sha256Schema,
+    manifestSha256: Sha256Schema,
+}).strict();
+export const V2RunRetirementReceiptSchema = z.object({
+    schemaVersion: z.literal(V2_RUN_RETIREMENT_SCHEMA_VERSION),
+    kind: z.literal(V2_RUN_RETIREMENT_KIND),
+    archiveId: Sha256Schema,
+    manifestSha256: Sha256Schema,
+    sourceRunsDir: z.string().min(1),
+    quarantineDir: z.string().min(1),
+    retiredAt: z.string().datetime(),
+}).strict();
+export function sha256Ref(data) {
+    return `sha256:${createHash('sha256').update(data).digest('hex')}`;
+}
+export function v2RunArchiveId(content) {
+    return sha256Ref(canonicalJsonStringify(content));
+}
+export function archiveDirectoryName(archiveId) {
+    if (!/^sha256:[0-9a-f]{64}$/.test(archiveId)) {
+        throw new Error(`Invalid v2 run archive id: ${archiveId}`);
+    }
+    return archiveId.replace(':', '-');
+}
+export function parseV2RunArchiveManifest(value) {
+    return V2RunArchiveManifestSchema.parse(value);
+}
+export function parseV2RunArchiveCommitMarker(value) {
+    return V2RunArchiveCommitMarkerSchema.parse(value);
+}
+export function parseV2RunRetirementReceipt(value) {
+    return V2RunRetirementReceiptSchema.parse(value);
+}
+//# sourceMappingURL=v2-run-archive-schema.js.map

package/dist/workflows/migration/v2-run-archive-schema.js.map

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

package/dist/workflows/migration/v2-run-archive.d.ts

@@ -0,0 +1,92 @@
+/**
+ * One-time, read-only-to-the-source archive for retired v2 workflow runs.
+ *
+ * The archive deliberately stores both the byte-exact legacy tree and the
+ * current ops projection.  The legacy replay implementation can be deleted only
+ * after `verifyV2RunArchive(..., { sourceRunsDir })` proves that both views
+ * still match the live source.
+ */
+import { type V2RunArchiveContent, type V2RunArchiveManifest, type V2RunRetirementReceipt } from './v2-run-archive-schema.js';
+export type V2RunArchiveCommitPhase = 'after-first-capture' | 'after-copy' | 'after-second-capture' | 'after-manifest' | 'after-publish' | 'after-commit-marker';
+export type V2RunRetirementPhase = 'after-first-source-verification' | 'before-source-rename' | 'after-source-rename' | 'after-quarantine-verification' | 'after-retirement-receipt';
+export declare class V2RunArchiveError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export interface V2RunArchivePlan {
+    sourceRunsDir: string;
+    content: V2RunArchiveContent;
+    runCount: number;
+    residualCount: number;
+    totalPayloadBytes: number;
+}
+export interface CommitV2RunArchiveInput {
+    runsDir: string;
+    archiveBaseDir: string;
+    now?: Date;
+    /** Crash-injection seam. Production callers omit it. */
+    onPhase?: (phase: V2RunArchiveCommitPhase) => void | Promise<void>;
+}
+export interface CommitV2RunArchiveResult {
+    archiveDir: string;
+    manifest: V2RunArchiveManifest;
+    reused: boolean;
+    verification: V2RunArchiveVerification;
+}
+export interface V2RunArchiveVerification {
+    archiveDir: string;
+    manifest: V2RunArchiveManifest;
+    staticVerified: true;
+    sourceVerified: boolean;
+    fileCount: number;
+    totalBytes: number;
+}
+export interface VerifyV2RunArchiveInput {
+    archiveDir: string;
+    /** When provided, also require byte/projection parity with the live source. */
+    sourceRunsDir?: string;
+    /** Publication recovery uses static verification before COMMITTED exists. */
+    allowMissingCommitMarker?: boolean;
+}
+export interface RetireV2RunSourceInput {
+    runsDir: string;
+    archiveBaseDir: string;
+    archiveDir: string;
+    daemonStoppedAcknowledged: boolean;
+    now?: Date;
+    /** Crash/race-injection seam. Production callers omit it. */
+    onPhase?: (phase: V2RunRetirementPhase) => void | Promise<void>;
+}
+export type RetireV2RunSourceResult = {
+    status: 'nothing_to_retire';
+    sourceRunsDir: string;
+} | {
+    status: 'retired' | 'already_retired';
+    archiveDir: string;
+    quarantineDir: string;
+    receiptPath: string;
+    receipt: V2RunRetirementReceipt;
+    verification: V2RunArchiveVerification;
+};
+/**
+ * Publication and retirement deliberately share one non-reentrant lock.
+ * Keep all callers on this helper so a basename change cannot split the
+ * serialization domain and never call it from inside another invocation.
+ */
+export declare function withV2RunArchivePublicationLock<T>(archiveBaseDir: string, fn: () => Promise<T>): Promise<T>;
+export declare function planV2RunArchive(input: {
+    runsDir: string;
+}): Promise<V2RunArchivePlan>;
+export declare function commitV2RunArchive(input: CommitV2RunArchiveInput): Promise<CommitV2RunArchiveResult>;
+/**
+ * Linearize v2 run-source retirement without deleting bytes.
+ *
+ * The advisory publication lock coordinates Botmux archive/retire commands,
+ * but it cannot stop an old daemon from appending to an already-open journal.
+ * Therefore non-empty retirement additionally requires an explicit operator
+ * acknowledgement that all v2 writers are stopped, verifies source parity
+ * twice immediately before rename, and verifies the relocated tree once more.
+ */
+export declare function retireV2RunSource(input: RetireV2RunSourceInput): Promise<RetireV2RunSourceResult>;
+export declare function verifyV2RunArchive(input: VerifyV2RunArchiveInput): Promise<V2RunArchiveVerification>;
+//# sourceMappingURL=v2-run-archive.d.ts.map

package/dist/workflows/migration/v2-run-archive.d.ts.map

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