@agent-teams/repository-mutation 0.0.0

package/dist/repository-mutation/adapters/node/node-repository-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-repository-path.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-repository-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,SAAiB;IACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,CACL,QAAQ,KAAK,EAAE;QACf,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CACjF,CAAC;AACJ,CAAC"}

package/dist/repository-mutation/adapters/node/node-terminal-evidence-directory.d.ts

@@ -0,0 +1,21 @@
+import { mkdir, realpath } from "node:fs/promises";
+import type { PortablePathIdentity } from "../../application/model/path-identity.js";
+export interface TerminalEvidenceDirectoryStat {
+    readonly birthtimeNs: bigint;
+    readonly dev: bigint;
+    readonly ino: bigint;
+    readonly isDirectory: () => boolean;
+    readonly isSymbolicLink: () => boolean;
+}
+export interface TerminalEvidenceDirectoryOperations {
+    readonly lstat: (path: string) => Promise<TerminalEvidenceDirectoryStat>;
+    readonly mkdir: typeof mkdir;
+    readonly realpath: typeof realpath;
+}
+export interface TerminalEvidenceDirectoryAuthority {
+    readonly identity: PortablePathIdentity;
+    readonly path: string;
+}
+export declare function ensureTerminalEvidenceDirectory(path: string, operationOverrides?: Partial<TerminalEvidenceDirectoryOperations>): Promise<TerminalEvidenceDirectoryAuthority>;
+export declare function assertTerminalEvidenceDirectory(authority: TerminalEvidenceDirectoryAuthority, operationOverrides?: Partial<TerminalEvidenceDirectoryOperations>): Promise<void>;
+//# sourceMappingURL=node-terminal-evidence-directory.d.ts.map

package/dist/repository-mutation/adapters/node/node-terminal-evidence-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-terminal-evidence-directory.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-terminal-evidence-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAErF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACzE,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,QAAQ,CAAC;CACpC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA4DD,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,MAAM,EACZ,kBAAkB,GAAE,OAAO,CAAC,mCAAmC,CAAM,GACpE,OAAO,CAAC,kCAAkC,CAAC,CAe7C;AAED,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,kCAAkC,EAC7C,kBAAkB,GAAE,OAAO,CAAC,mCAAmC,CAAM,GACpE,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/repository-mutation/adapters/node/node-terminal-evidence-directory.js

@@ -0,0 +1,59 @@
+import { lstat, mkdir, realpath } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+const nodeOperations = {
+    lstat: (path) => lstat(path, { bigint: true }),
+    mkdir,
+    realpath
+};
+function identityFromStat(metadata) {
+    return {
+        birthtimeNs: metadata.birthtimeNs,
+        dev: metadata.dev,
+        ino: metadata.ino
+    };
+}
+function identitiesEqual(left, right) {
+    return (left.birthtimeNs === right.birthtimeNs &&
+        left.dev === right.dev &&
+        left.ino === right.ino);
+}
+async function observeTerminalEvidenceDirectory(path, operations) {
+    const metadata = await operations.lstat(path);
+    if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+        throw new Error("Terminal evidence path must be a real operation-owned directory.");
+    }
+    const expectedCanonicalPath = join(await operations.realpath(dirname(path)), basename(path));
+    if ((await operations.realpath(path)) !== expectedCanonicalPath) {
+        throw new Error("Terminal evidence directory resolves outside its expected path.");
+    }
+    const identity = identityFromStat(metadata);
+    const after = await operations.lstat(path);
+    if (after.isSymbolicLink() ||
+        !after.isDirectory() ||
+        !identitiesEqual(identity, identityFromStat(after))) {
+        throw new Error("Terminal evidence directory authority changed.");
+    }
+    return identity;
+}
+export async function ensureTerminalEvidenceDirectory(path, operationOverrides = {}) {
+    const operations = { ...nodeOperations, ...operationOverrides };
+    await operations.mkdir(path, { mode: 0o700 }).catch((error) => {
+        if (!(error instanceof Error) ||
+            !("code" in error) ||
+            error.code !== "EEXIST") {
+            throw error;
+        }
+    });
+    return {
+        identity: await observeTerminalEvidenceDirectory(path, operations),
+        path
+    };
+}
+export async function assertTerminalEvidenceDirectory(authority, operationOverrides = {}) {
+    const operations = { ...nodeOperations, ...operationOverrides };
+    const identity = await observeTerminalEvidenceDirectory(authority.path, operations);
+    if (!identitiesEqual(identity, authority.identity)) {
+        throw new Error("Terminal evidence directory authority changed.");
+    }
+}
+//# sourceMappingURL=node-terminal-evidence-directory.js.map

package/dist/repository-mutation/adapters/node/node-terminal-evidence-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-terminal-evidence-directory.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-terminal-evidence-directory.ts"],"names":[],"mappings":"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"}

package/dist/repository-mutation/application/model/directory-materialization.d.ts

@@ -0,0 +1,35 @@
+import type { PortablePathIdentity } from "./path-identity.js";
+export type DirectoryCreatePolicy = "allow" | "forbid";
+export interface ProjectedDirectory {
+    readonly absolutePath: string;
+    readonly repositoryPath: string;
+}
+export interface CapturedDirectory extends ProjectedDirectory {
+    readonly identity: PortablePathIdentity;
+}
+export interface DirectoryMaterializationProjection {
+    readonly anchor: CapturedDirectory;
+    readonly createPolicy: DirectoryCreatePolicy;
+    readonly finalParent: ProjectedDirectory;
+    readonly missingDirectories: readonly ProjectedDirectory[];
+    readonly repositoryRoot: CapturedDirectory;
+}
+export interface BoundDirectoryCreation extends CapturedDirectory {
+    readonly outcome: "created-and-bound";
+    readonly parentIdentity: PortablePathIdentity;
+}
+export type UnboundDirectoryCreationRecovery = {
+    readonly outcome: "not-created";
+} | {
+    readonly observedIdentity: PortablePathIdentity;
+    readonly outcome: "ambiguous-manual";
+};
+export type DirectoryMutationErrorCode = "ALIAS_COLLISION" | "AMBIGUOUS_CREATION" | "CONCURRENT_CHANGE" | "CREATE_FORBIDDEN" | "IDENTITY_UNAVAILABLE" | "INVALID_PATH" | "NOT_DIRECTORY" | "OUTSIDE_ROOT" | "SYMLINK";
+export declare class DirectoryMutationError extends Error {
+    readonly code: DirectoryMutationErrorCode;
+    readonly manualRecoveryRequired: boolean;
+    constructor(code: DirectoryMutationErrorCode, message: string, options?: ErrorOptions & {
+        readonly manualRecoveryRequired?: boolean;
+    });
+}
+//# sourceMappingURL=directory-materialization.d.ts.map

package/dist/repository-mutation/application/model/directory-materialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-materialization.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/directory-materialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;CAC/C;AAED,MAAM,MAAM,gCAAgC,GACxC;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GACnC;IACE,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC,CAAC;AAEN,MAAM,MAAM,0BAA0B,GAClC,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,cAAc,GACd,eAAe,GACf,cAAc,GACd,SAAS,CAAC;AAEd,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IAEzC,YACE,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAE,EAMvE;CACF"}

package/dist/repository-mutation/application/model/directory-materialization.js

@@ -0,0 +1,11 @@
+export class DirectoryMutationError extends Error {
+    code;
+    manualRecoveryRequired;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "DirectoryMutationError";
+        this.code = code;
+        this.manualRecoveryRequired = options?.manualRecoveryRequired ?? false;
+    }
+}
+//# sourceMappingURL=directory-materialization.js.map

package/dist/repository-mutation/application/model/directory-materialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-materialization.js","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/directory-materialization.ts"],"names":[],"mappings":"AA4CA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,IAAI,CAA6B;IACjC,sBAAsB,CAAU;IAEzC,YACE,IAAgC,EAChC,OAAe,EACf,OAAsE;QAEtE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,sBAAsB,GAAG,OAAO,EAAE,sBAAsB,IAAI,KAAK,CAAC;IACzE,CAAC;CACF"}

package/dist/repository-mutation/application/model/exact-postimage.d.ts

@@ -0,0 +1,17 @@
+export interface ExactFilePostimage {
+    readonly bytes: Uint8Array;
+    readonly digest: string;
+    readonly mode: number;
+    readonly size: number;
+}
+export type ExactFilePostimageState = "absent" | "conflict" | "exact";
+export type AbsentFilePublicationOutcome = "already-satisfied" | "published";
+export type AbsentFilePublicationErrorCode = "CLEANUP_FAILED" | "CONFLICT" | "INVALID_ERROR" | "INVALID_POSTIMAGE" | "PUBLICATION_INVALID" | "PUBLICATION_INCOMPLETE" | "PUBLICATION_UNSUPPORTED" | "TEMPORARY_EXISTS" | "TEMPORARY_REPLACED" | "VERIFICATION_FAILED";
+export declare class AbsentFilePublicationError extends Error {
+    readonly code: AbsentFilePublicationErrorCode;
+    readonly cleanupError: unknown;
+    constructor(code: AbsentFilePublicationErrorCode, message: string, options?: ErrorOptions & {
+        readonly cleanupError?: unknown;
+    });
+}
+//# sourceMappingURL=exact-postimage.d.ts.map

package/dist/repository-mutation/application/model/exact-postimage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-postimage.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/exact-postimage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtE,MAAM,MAAM,4BAA4B,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAE7E,MAAM,MAAM,8BAA8B,GACtC,gBAAgB,GAChB,UAAU,GACV,eAAe,GACf,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,GACxB,yBAAyB,GACzB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,YACE,IAAI,EAAE,8BAA8B,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,EAM7D;CACF"}

package/dist/repository-mutation/application/model/exact-postimage.js

@@ -0,0 +1,11 @@
+export class AbsentFilePublicationError extends Error {
+    code;
+    cleanupError;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "AbsentFilePublicationError";
+        this.code = code;
+        this.cleanupError = options?.cleanupError;
+    }
+}
+//# sourceMappingURL=exact-postimage.js.map

package/dist/repository-mutation/application/model/exact-postimage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-postimage.js","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/exact-postimage.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,CAAiC;IACrC,YAAY,CAAU;IAE/B,YACE,IAAoC,EACpC,OAAe,EACf,OAA4D;QAE5D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC5C,CAAC;CACF"}

package/dist/repository-mutation/application/model/known-file-transaction-journal.d.ts

@@ -0,0 +1,69 @@
+import type { PortablePathIdentity } from "./path-identity.js";
+import type { KnownFileDigest, KnownFileTransactionPlanV1 } from "./known-file-transaction.js";
+export interface KnownFileTransactionPortableIdentityV1 {
+    readonly birthtimeNs: string;
+    readonly dev: string;
+    readonly ino: string;
+}
+export interface KnownFileTransactionRetirementV1 {
+    readonly kind: "destination" | "rollback-temporary" | "temporary";
+    readonly state: "ready" | "captured" | "unlink-authorized";
+    readonly directoryIdentity: KnownFileTransactionPortableIdentityV1;
+    readonly pathIdentity: KnownFileTransactionPortableIdentityV1;
+}
+export type KnownFileTransactionJournalOperationV1 = {
+    readonly path: string;
+    readonly state: "already-satisfied" | "pending" | "temporary-authorized";
+    readonly matchedPreimage?: number;
+    readonly rollbackTemporaryIdentity?: never;
+    readonly captureDirectoryIdentity?: never;
+    readonly capturedPreimageIdentity?: never;
+    readonly retirement?: never;
+} | {
+    readonly path: string;
+    readonly state: "temporary-ready" | "capture-authorized" | "capture-ready" | "preimage-captured" | "destination-retired" | "publishing" | "published" | "rollback-restored";
+    readonly matchedPreimage?: number;
+    readonly rollbackTemporaryIdentity?: KnownFileTransactionPortableIdentityV1;
+    readonly temporaryIdentity: KnownFileTransactionPortableIdentityV1;
+    readonly captureDirectoryIdentity?: KnownFileTransactionPortableIdentityV1;
+    readonly capturedPreimageIdentity?: KnownFileTransactionPortableIdentityV1;
+    readonly retirement?: KnownFileTransactionRetirementV1;
+};
+export interface KnownFileTransactionJournalV1 {
+    readonly schemaVersion: 1;
+    readonly plan: KnownFileTransactionPlanV1;
+    readonly operations: readonly KnownFileTransactionJournalOperationV1[];
+    readonly authorizedDirectories: readonly string[];
+    readonly createdDirectories: readonly {
+        readonly path: string;
+        readonly identity: KnownFileTransactionPortableIdentityV1;
+    }[];
+}
+export interface KnownFileTransactionEnvelopeV1 {
+    readonly schemaVersion: 6;
+    readonly format: "agent-teams.repository-mutation.transaction-envelope/v1";
+    readonly operationKind: "known-file-transaction";
+    readonly recoveryHandler: {
+        readonly id: "agent-teams.repository-mutation.known-file/v1";
+        readonly contractVersion: 1;
+    };
+    readonly ownerArtifact: {
+        readonly name: string;
+        readonly version: string;
+        readonly buildIdentity: KnownFileDigest;
+    };
+    readonly kernelArtifact: {
+        readonly name: string;
+        readonly version: string;
+        readonly buildIdentity: KnownFileDigest;
+    };
+    readonly adapterContractVersion: 1;
+    readonly payloadKind: "agent-teams.repository-mutation.known-file-journal/v1";
+    readonly state: "APPLYING" | "COMMITTED";
+    readonly payload: KnownFileTransactionJournalV1;
+    readonly payloadDigest: KnownFileDigest;
+    readonly envelopeDigest: KnownFileDigest;
+}
+export declare function serializeKnownFileIdentity(identity: PortablePathIdentity): KnownFileTransactionPortableIdentityV1;
+export declare function deserializeKnownFileIdentity(identity: KnownFileTransactionPortableIdentityV1): PortablePathIdentity;
+//# sourceMappingURL=known-file-transaction-journal.d.ts.map

package/dist/repository-mutation/application/model/known-file-transaction-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-file-transaction-journal.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/known-file-transaction-journal.ts"],"names":[],"mappings":"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"}

package/dist/repository-mutation/application/model/known-file-transaction-journal.js

@@ -0,0 +1,15 @@
+export function serializeKnownFileIdentity(identity) {
+    return Object.freeze({
+        birthtimeNs: identity.birthtimeNs.toString(),
+        dev: identity.dev.toString(),
+        ino: identity.ino.toString()
+    });
+}
+export function deserializeKnownFileIdentity(identity) {
+    return {
+        birthtimeNs: BigInt(identity.birthtimeNs),
+        dev: BigInt(identity.dev),
+        ino: BigInt(identity.ino)
+    };
+}
+//# sourceMappingURL=known-file-transaction-journal.js.map

package/dist/repository-mutation/application/model/known-file-transaction-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-file-transaction-journal.js","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/known-file-transaction-journal.ts"],"names":[],"mappings":"AAqFA,MAAM,UAAU,0BAA0B,CACxC,QAA8B;IAE9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE;QAC5C,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE;QAC5B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAgD;IAEhD,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QACzC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;KAC1B,CAAC;AACJ,CAAC"}

package/dist/repository-mutation/application/model/known-file-transaction.d.ts

@@ -0,0 +1,64 @@
+export type KnownFileDigest = `sha256:${string}`;
+export interface KnownFileImageV1 {
+    readonly contentBase64: string;
+    readonly digest: KnownFileDigest;
+    readonly mode: number;
+    readonly size: number;
+}
+export type KnownFilePreconditionV1 = {
+    readonly state: "absent";
+} | {
+    readonly state: "known-file";
+    readonly acceptedPreimages: readonly KnownFileImageV1[];
+};
+export interface KnownFileTransactionOperationV1 {
+    readonly path: string;
+    readonly precondition: KnownFilePreconditionV1;
+    readonly postimage: KnownFileImageV1;
+}
+export interface KnownFileTransactionPlanV1 {
+    readonly schemaVersion: 1;
+    readonly protocol: "agent-teams.repository-mutation.known-file/v1";
+    readonly operations: readonly KnownFileTransactionOperationV1[];
+    readonly planDigest: KnownFileDigest;
+}
+export type KnownFileTransactionOperationOutcome = "already-satisfied" | "created" | "replaced" | "rolled-back-to-absent" | "rolled-back-to-preimage";
+export interface KnownFileTransactionReceiptV1 {
+    readonly schemaVersion: 1;
+    readonly protocol: "agent-teams.repository-mutation.known-file/v1";
+    readonly planDigest: KnownFileDigest;
+    readonly outcome: "already-satisfied" | "applied" | "rolled-back";
+    readonly operations: readonly {
+        readonly path: string;
+        readonly outcome: KnownFileTransactionOperationOutcome;
+        readonly resultDigest?: KnownFileDigest;
+    }[];
+    readonly receiptDigest: KnownFileDigest;
+}
+export type KnownFileTransactionOperationInput = {
+    readonly path: string;
+    readonly precondition: {
+        readonly state: "absent";
+    };
+    readonly postimage: {
+        readonly bytes: Uint8Array;
+        readonly mode?: number;
+    };
+} | {
+    readonly path: string;
+    readonly precondition: {
+        readonly state: "known-file";
+        readonly acceptedPreimages: readonly {
+            readonly bytes: Uint8Array;
+            readonly mode: number;
+        }[];
+    };
+    readonly postimage: {
+        readonly bytes: Uint8Array;
+        readonly mode: number;
+    };
+};
+export interface CompileKnownFileTransactionPlanInput {
+    readonly operations: readonly KnownFileTransactionOperationInput[];
+}
+//# sourceMappingURL=known-file-transaction.d.ts.map

package/dist/repository-mutation/application/model/known-file-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-file-transaction.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/known-file-transaction.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,UAAU,MAAM,EAAE,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC5B;IACE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzD,CAAC;AAEN,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,+CAA+C,CAAC;IACnE,QAAQ,CAAC,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAChE,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED,MAAM,MAAM,oCAAoC,GAC5C,mBAAmB,GACnB,SAAS,GACT,UAAU,GACV,uBAAuB,GACvB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,+CAA+C,CAAC;IACnE,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,aAAa,CAAC;IAClE,QAAQ,CAAC,UAAU,EAAE,SAAS;QAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,oCAAoC,CAAC;QACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;KACzC,EAAE,CAAC;IACJ,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;CACzC;AAED,MAAM,MAAM,kCAAkC,GAC1C;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;QAC7B,QAAQ,CAAC,iBAAiB,EAAE,SAAS;YACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;YAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;SACvB,EAAE,CAAC;KACL,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEN,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,kCAAkC,EAAE,CAAC;CACpE"}

package/dist/repository-mutation/application/model/known-file-transaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=known-file-transaction.js.map

package/dist/repository-mutation/application/model/known-file-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-file-transaction.js","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/known-file-transaction.ts"],"names":[],"mappings":""}

package/dist/repository-mutation/application/model/path-identity.d.ts

@@ -0,0 +1,7 @@
+export interface PortablePathIdentity {
+    readonly birthtimeNs: bigint;
+    readonly dev: bigint;
+    readonly ino: bigint;
+}
+export type PathIdentityMatch = "different" | "match" | "missing";
+//# sourceMappingURL=path-identity.d.ts.map

package/dist/repository-mutation/application/model/path-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-identity.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/path-identity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC"}

package/dist/repository-mutation/application/model/path-identity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=path-identity.js.map

package/dist/repository-mutation/application/model/path-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-identity.js","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/path-identity.ts"],"names":[],"mappings":""}

package/dist/repository-mutation/application/model/repository-path.d.ts

@@ -0,0 +1,8 @@
+export type PortableRepositoryPathProblem = "absolute" | "backslash" | "control-character" | "empty-segment" | "invalid-character" | "invalid-segment" | "path-too-long" | "reserved-name" | "segment-too-long" | "trailing-dot" | "trailing-space";
+export declare function portableRepositoryPathProblem(repositoryPath: string): PortableRepositoryPathProblem | undefined;
+export declare function portableRepositoryPathIdentity(repositoryPath: string): string;
+export declare function findPortableRepositoryPathCollision(repositoryPaths: readonly string[]): {
+    readonly first: string;
+    readonly second: string;
+} | undefined;
+//# sourceMappingURL=repository-path.d.ts.map

package/dist/repository-mutation/application/model/repository-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-path.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/model/repository-path.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,6BAA6B,GACrC,UAAU,GACV,WAAW,GACX,mBAAmB,GACnB,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,gBAAgB,CAAC;AAYrB,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,GACrB,6BAA6B,GAAG,SAAS,CAiD3C;AAED,wBAAgB,8BAA8B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,mCAAmC,CACjD,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAWjE"}

package/dist/repository-mutation/application/model/repository-path.js

@@ -0,0 +1,74 @@
+const WINDOWS_RESERVED_NAMES = new Set([
+    "AUX",
+    "CON",
+    "NUL",
+    "PRN",
+    ...Array.from({ length: 9 }, (_unused, index) => `COM${index + 1}`),
+    ...Array.from({ length: 9 }, (_unused, index) => `LPT${index + 1}`)
+]);
+const PORTABLE_SEGMENT = /^[A-Za-z0-9._@+-]+$/u;
+function isPortableAbsolutePath(repositoryPath) {
+    return (repositoryPath.startsWith("/") ||
+        repositoryPath.startsWith("\\\\") ||
+        /^[A-Za-z]:[\\/]/u.test(repositoryPath));
+}
+export function portableRepositoryPathProblem(repositoryPath) {
+    if (repositoryPath.length > 512 ||
+        new TextEncoder().encode(repositoryPath).byteLength > 512) {
+        return "path-too-long";
+    }
+    if (isPortableAbsolutePath(repositoryPath)) {
+        return "absolute";
+    }
+    if (repositoryPath.includes("\\")) {
+        return "backslash";
+    }
+    const segments = repositoryPath.split("/");
+    for (const segment of segments) {
+        if (segment.length === 0) {
+            return "empty-segment";
+        }
+        if (segment === "." || segment === "..") {
+            return "invalid-segment";
+        }
+        if (segment.length > 255 ||
+            new TextEncoder().encode(segment).byteLength > 255) {
+            return "segment-too-long";
+        }
+        if (segment.endsWith(".")) {
+            return "trailing-dot";
+        }
+        if (segment.endsWith(" ")) {
+            return "trailing-space";
+        }
+        if (Array.from(segment).some((character) => {
+            const codePoint = character.codePointAt(0) ?? 0;
+            return codePoint < 32 || codePoint === 127;
+        })) {
+            return "control-character";
+        }
+        if (WINDOWS_RESERVED_NAMES.has((segment.split(".")[0] ?? "").toUpperCase())) {
+            return "reserved-name";
+        }
+        if (!PORTABLE_SEGMENT.test(segment)) {
+            return "invalid-character";
+        }
+    }
+    return undefined;
+}
+export function portableRepositoryPathIdentity(repositoryPath) {
+    return repositoryPath.normalize("NFC").toLowerCase();
+}
+export function findPortableRepositoryPathCollision(repositoryPaths) {
+    const observed = new Map();
+    for (const repositoryPath of repositoryPaths) {
+        const identity = portableRepositoryPathIdentity(repositoryPath);
+        const first = observed.get(identity);
+        if (first !== undefined) {
+            return { first, second: repositoryPath };
+        }
+        observed.set(identity, repositoryPath);
+    }
+    return undefined;
+}
+//# sourceMappingURL=repository-path.js.map

package/dist/repository-mutation/application/model/repository-path.js.map

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

package/dist/repository-mutation/application/policies/classify-known-file-recovery-transition.d.ts

@@ -0,0 +1,33 @@
+import type { KnownFileDigest } from "../model/known-file-transaction.js";
+import type { KnownFileTransactionEnvelopeV1 } from "../model/known-file-transaction-journal.js";
+export interface InstalledKnownFileRecoveryBuild {
+    readonly ownerArtifact: {
+        readonly name: string;
+        readonly buildIdentity: KnownFileDigest;
+        readonly version: string;
+    };
+    readonly kernelArtifact: {
+        readonly name: string;
+        readonly buildIdentity: KnownFileDigest;
+        readonly version: string;
+    };
+}
+export type KnownFileRecoveryTransition = {
+    readonly action: "reject";
+    readonly code: "KNOWN_FILE_EXACT_BUILD_REQUIRED";
+    readonly message: "The exact owner and kernel artifacts that created this journal must recover it.";
+} | {
+    readonly action: "resume-committed-cleanup";
+} | {
+    readonly action: "rollback-applying";
+};
+/**
+ * Classifies the next top-level transition for an already parsed and validated
+ * known-file v1 recovery envelope. Evidence parsing and all effects remain the
+ * responsibility of the calling adapter.
+ */
+export declare function classifyKnownFileRecoveryTransition(input: {
+    readonly envelope: KnownFileTransactionEnvelopeV1;
+    readonly installedBuild: InstalledKnownFileRecoveryBuild;
+}): KnownFileRecoveryTransition;
+//# sourceMappingURL=classify-known-file-recovery-transition.d.ts.map

package/dist/repository-mutation/application/policies/classify-known-file-recovery-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-known-file-recovery-transition.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/policies/classify-known-file-recovery-transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAEjG,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,aAAa,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACrH,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACvH;AAED,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,iCAAiC,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,iFAAiF,CAAC;CACrG,GACD;IAAE,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,+BAA+B,CAAC;CAC1D,GAAG,2BAA2B,CAe9B"}

package/dist/repository-mutation/application/policies/classify-known-file-recovery-transition.js

@@ -0,0 +1,21 @@
+/**
+ * Classifies the next top-level transition for an already parsed and validated
+ * known-file v1 recovery envelope. Evidence parsing and all effects remain the
+ * responsibility of the calling adapter.
+ */
+export function classifyKnownFileRecoveryTransition(input) {
+    if (["name", "version", "buildIdentity"].some((field) => input.envelope.ownerArtifact[field] !==
+        input.installedBuild.ownerArtifact[field] ||
+        input.envelope.kernelArtifact[field] !==
+            input.installedBuild.kernelArtifact[field])) {
+        return {
+            action: "reject",
+            code: "KNOWN_FILE_EXACT_BUILD_REQUIRED",
+            message: "The exact owner and kernel artifacts that created this journal must recover it."
+        };
+    }
+    return input.envelope.state === "COMMITTED"
+        ? { action: "resume-committed-cleanup" }
+        : { action: "rollback-applying" };
+}
+//# sourceMappingURL=classify-known-file-recovery-transition.js.map

package/dist/repository-mutation/application/policies/classify-known-file-recovery-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-known-file-recovery-transition.js","sourceRoot":"","sources":["../../../../src/repository-mutation/application/policies/classify-known-file-recovery-transition.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAGnD;IACC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACtD,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAkD,CAAC;QAC9E,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,KAAwD,CAAC;QAC9F,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAmD,CAAC;YAChF,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,KAAyD,CAAC,CAAC,EAAE,CAAC;QACpG,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,iCAAiC;YACvC,OAAO,EAAE,iFAAiF;SAC3F,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,WAAW;QACzC,CAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE;QACxC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;AACtC,CAAC"}

package/dist/repository-mutation/application/policies/known-file-transaction-envelope.d.ts

@@ -0,0 +1,9 @@
+import type { KnownFileTransactionEnvelopeV1, KnownFileTransactionJournalV1 } from "../model/known-file-transaction-journal.js";
+export declare function compileKnownFileTransactionEnvelope(input: {
+    readonly ownerArtifact: KnownFileTransactionEnvelopeV1["ownerArtifact"];
+    readonly kernelArtifact: KnownFileTransactionEnvelopeV1["kernelArtifact"];
+    readonly journal: KnownFileTransactionJournalV1;
+    readonly state: KnownFileTransactionEnvelopeV1["state"];
+}): KnownFileTransactionEnvelopeV1;
+export declare function assertKnownFileTransactionEnvelope(value: unknown): asserts value is KnownFileTransactionEnvelopeV1;
+//# sourceMappingURL=known-file-transaction-envelope.d.ts.map

package/dist/repository-mutation/application/policies/known-file-transaction-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-file-transaction-envelope.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/application/policies/known-file-transaction-envelope.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,4CAA4C,CAAC;AAsNpD,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,aAAa,EAAE,8BAA8B,CAAC,eAAe,CAAC,CAAC;IACxE,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC,gBAAgB,CAAC,CAAC;IAC1E,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC,OAAO,CAAC,CAAC;CACzD,GAAG,8BAA8B,CAejC;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,8BAA8B,CAqBjD"}