@rpamis/comet 0.3.9 → 0.4.0-beta.10

package/dist/domains/comet-native/native-mutation-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-mutation-lock.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-mutation-lock.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAmD5D,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/domains/comet-native/native-mutation-lock.js

@@ -0,0 +1,66 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { assertNoPendingNativeRootMove } from './native-config.js';
+import { acquireNativeLock, diagnoseNativeLock, releaseNativeLock, } from './native-lock.js';
+import { readNativeTransaction } from './native-transaction.js';
+async function hasUnfinishedTransaction(paths, allowedTransactionId) {
+    let entries;
+    try {
+        entries = await fs.readdir(paths.transactionsDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() || entry.isSymbolicLink())
+            continue;
+        try {
+            const transaction = await readNativeTransaction(paths, entry.name);
+            if (transaction.id !== allowedTransactionId &&
+                transaction.status !== 'committed' &&
+                transaction.status !== 'rolled-back') {
+                return true;
+            }
+        }
+        catch {
+            return true;
+        }
+    }
+    return false;
+}
+async function acquireNativeMutationLock(paths, operation) {
+    const deadline = Date.now() + 5_000;
+    const file = path.join(paths.locksDir, 'root-move.lock');
+    while (true) {
+        try {
+            return await acquireNativeLock(paths, 'root-move', operation);
+        }
+        catch (error) {
+            const cause = error.cause;
+            if (cause?.code !== 'EEXIST')
+                throw error;
+            const diagnosis = await diagnoseNativeLock(file);
+            if (diagnosis.status === 'missing')
+                continue;
+            if (diagnosis.status !== 'active' || Date.now() >= deadline)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, 5 + Math.floor(Math.random() * 11)));
+        }
+    }
+}
+export async function withNativeMutationLock(paths, operation, work, options) {
+    const lock = await acquireNativeMutationLock(paths, operation);
+    try {
+        await assertNoPendingNativeRootMove(paths.projectRoot);
+        if (await hasUnfinishedTransaction(paths, options?.allowedTransactionId)) {
+            throw new Error('Native transaction recovery is required before another mutation');
+        }
+        return await work();
+    }
+    finally {
+        await releaseNativeLock(lock);
+    }
+}
+//# sourceMappingURL=native-mutation-lock.js.map

package/dist/domains/comet-native/native-mutation-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-mutation-lock.js","sourceRoot":"","sources":["../../../domains/comet-native/native-mutation-lock.ts"],"names":[],"mappings":"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"}

package/dist/domains/comet-native/native-paths.d.ts

@@ -0,0 +1,10 @@
+import type { NativeProjectPaths } from './native-types.js';
+export declare const PROJECT_CONFIG_FILE = ".comet/config.yaml";
+export declare function discoverNativeProject(startPath: string): Promise<string>;
+export declare function normalizeArtifactRootRef(value: string): string;
+export declare function resolveArtifactRoot(projectRoot: string, value: string): Promise<string>;
+export declare function nativeProjectPaths(projectRoot: string, artifactRootRef: string): Promise<NativeProjectPaths>;
+export declare function ensureNativeDirectories(paths: NativeProjectPaths): Promise<void>;
+export declare function isInsidePath(parent: string, target: string): boolean;
+export declare function resolveContainedNativePath(root: string, target: string): Promise<string>;
+//# sourceMappingURL=native-paths.d.ts.map

package/dist/domains/comet-native/native-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-paths.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-paths.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AAoDxD,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7F;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA2B7B;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CActF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB9F"}

package/dist/domains/comet-native/native-paths.js

@@ -0,0 +1,160 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import os from 'os';
+import { normalizeWorkflowArtifactRoot } from '../workflow-contract/project-config.js';
+export const PROJECT_CONFIG_FILE = '.comet/config.yaml';
+async function isFileOrDirectory(target) {
+    try {
+        await fs.lstat(target);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function declaresNativeProjectConfig(target) {
+    try {
+        const source = await fs.readFile(target, 'utf8');
+        return /^schema:\s*comet\.project\.v1\s*$/mu.test(source);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function inside(parent, target) {
+    const relative = path.relative(parent, target);
+    return (relative === '' ||
+        (!path.isAbsolute(relative) && relative !== '..' && !relative.startsWith(`..${path.sep}`)));
+}
+async function physicalPath(target) {
+    const missing = [];
+    let cursor = target;
+    while (!(await isFileOrDirectory(cursor))) {
+        const parent = path.dirname(cursor);
+        if (parent === cursor)
+            break;
+        missing.push(path.basename(cursor));
+        cursor = parent;
+    }
+    const existing = await fs.realpath(cursor);
+    return path.resolve(existing, ...missing.reverse());
+}
+async function isSymbolicLink(target) {
+    try {
+        return (await fs.lstat(target)).isSymbolicLink();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+export async function discoverNativeProject(startPath) {
+    let cursor = path.resolve(startPath);
+    try {
+        if (!(await fs.stat(cursor)).isDirectory())
+            cursor = path.dirname(cursor);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    const fallback = cursor;
+    const home = path.resolve(os.homedir());
+    while (true) {
+        const isHomeBoundary = cursor === home && fallback !== home;
+        if (!isHomeBoundary) {
+            const configFile = path.join(cursor, ...PROJECT_CONFIG_FILE.split('/'));
+            const configMarksProject = cursor === fallback || (await declaresNativeProjectConfig(configFile));
+            if ((await isFileOrDirectory(configFile)) && configMarksProject) {
+                return cursor;
+            }
+        }
+        if (await isFileOrDirectory(path.join(cursor, '.git')))
+            return cursor;
+        const parent = path.dirname(cursor);
+        if (parent === cursor)
+            return fallback;
+        cursor = parent;
+    }
+}
+export function normalizeArtifactRootRef(value) {
+    return normalizeWorkflowArtifactRoot(value);
+}
+export async function resolveArtifactRoot(projectRoot, value) {
+    const normalized = normalizeArtifactRootRef(value);
+    const lexical = path.resolve(projectRoot, ...normalized.split('/'));
+    const physicalProject = await fs.realpath(projectRoot);
+    const physicalTarget = await physicalPath(lexical);
+    if (!inside(physicalProject, physicalTarget)) {
+        throw new Error('native.artifact_root resolves outside the project root');
+    }
+    return lexical;
+}
+export async function nativeProjectPaths(projectRoot, artifactRootRef) {
+    const normalized = normalizeArtifactRootRef(artifactRootRef);
+    const artifactRoot = await resolveArtifactRoot(projectRoot, normalized);
+    const nativeRoot = path.join(artifactRoot, 'comet');
+    if (await isSymbolicLink(nativeRoot)) {
+        throw new Error('The configured Native comet root must not be a symbolic link');
+    }
+    const [physicalArtifactRoot, physicalNativeRoot] = await Promise.all([
+        physicalPath(artifactRoot),
+        physicalPath(nativeRoot),
+    ]);
+    if (!inside(physicalArtifactRoot, physicalNativeRoot)) {
+        throw new Error('The configured Native comet root resolves outside its artifact root');
+    }
+    return {
+        projectRoot: path.resolve(projectRoot),
+        configFile: path.join(projectRoot, ...PROJECT_CONFIG_FILE.split('/')),
+        artifactRoot,
+        artifactRootRef: normalized,
+        nativeRoot,
+        specsDir: path.join(nativeRoot, 'specs'),
+        changesDir: path.join(nativeRoot, 'changes'),
+        archiveDir: path.join(nativeRoot, 'archive'),
+        runtimeDir: path.join(nativeRoot, 'runtime'),
+        locksDir: path.join(nativeRoot, 'runtime', 'locks'),
+        transactionsDir: path.join(nativeRoot, 'runtime', 'transactions'),
+    };
+}
+export async function ensureNativeDirectories(paths) {
+    const directories = [
+        paths.specsDir,
+        paths.changesDir,
+        paths.archiveDir,
+        paths.locksDir,
+        paths.transactionsDir,
+    ];
+    await Promise.all(directories.map(async (directory) => {
+        await resolveContainedNativePath(paths.nativeRoot, directory);
+        await fs.mkdir(directory, { recursive: true });
+    }));
+}
+export function isInsidePath(parent, target) {
+    return inside(path.resolve(parent), path.resolve(target));
+}
+export async function resolveContainedNativePath(root, target) {
+    const lexicalRoot = path.resolve(root);
+    const lexicalTarget = path.resolve(target);
+    if (!inside(lexicalRoot, lexicalTarget)) {
+        throw new Error(`Path is outside the Native root: ${target}`);
+    }
+    if (await isSymbolicLink(lexicalRoot)) {
+        throw new Error(`Native root must not be a symbolic link: ${root}`);
+    }
+    const [physicalRoot, physicalTarget] = await Promise.all([
+        physicalPath(lexicalRoot),
+        physicalPath(lexicalTarget),
+    ]);
+    if (!inside(physicalRoot, physicalTarget)) {
+        throw new Error(`Path resolves outside the Native root: ${target}`);
+    }
+    return lexicalTarget;
+}
+//# sourceMappingURL=native-paths.js.map

package/dist/domains/comet-native/native-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-paths.js","sourceRoot":"","sources":["../../../domains/comet-native/native-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAIvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAExD,KAAK,UAAU,iBAAiB,CAAC,MAAc;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,2BAA2B,CAAC,MAAc;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,qCAAqC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,EAAE,MAAc;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,CACL,QAAQ,KAAK,EAAE;QACf,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAC3F,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAc;IACxC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,MAAM,CAAC;IACpB,OAAO,CAAC,CAAC,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,MAAM;YAAE,MAAM;QAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACpC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAAc;IAC1C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IAC3D,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IACtE,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,MAAM,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,CAAC;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YACxE,MAAM,kBAAkB,GACtB,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,2BAA2B,CAAC,UAAU,CAAC,CAAC,CAAC;YACzE,IAAI,CAAC,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAC;gBAChE,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,IAAI,MAAM,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,MAAM,CAAC;QACtE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,QAAQ,CAAC;QACvC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,6BAA6B,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB,EAAE,KAAa;IAC1E,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,eAAuB;IAEvB,MAAM,UAAU,GAAG,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnE,YAAY,CAAC,YAAY,CAAC;QAC1B,YAAY,CAAC,UAAU,CAAC;KACzB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACtC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrE,YAAY;QACZ,eAAe,EAAE,UAAU;QAC3B,UAAU;QACV,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;QACxC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;QAC5C,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;QAC5C,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;QAC5C,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC;QACnD,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,cAAc,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAyB;IACrE,MAAM,WAAW,GAAG;QAClB,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,UAAU;QAChB,KAAK,CAAC,UAAU;QAChB,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,eAAe;KACtB,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CACf,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QAClC,MAAM,0BAA0B,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAY,EAAE,MAAc;IAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,YAAY,CAAC,WAAW,CAAC;QACzB,YAAY,CAAC,aAAa,CAAC;KAC5B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/domains/comet-native/native-progress-checkpoint.d.ts

@@ -0,0 +1,13 @@
+import type { NativeCheckpointHooks, NativeCheckpointResult, NativeProjectPaths } from './native-types.js';
+export declare function checkpointNativeChange(options: {
+    paths: NativeProjectPaths;
+    name: string;
+    summary: string;
+    nextAction: string;
+    artifacts?: readonly string[];
+    expectedRevision?: number;
+    now?: Date;
+    checkpointId?: () => string;
+    hooks?: NativeCheckpointHooks;
+}): Promise<NativeCheckpointResult>;
+//# sourceMappingURL=native-progress-checkpoint.d.ts.map

package/dist/domains/comet-native/native-progress-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-progress-checkpoint.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-progress-checkpoint.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EAEtB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAkB3B,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqGlC"}

package/dist/domains/comet-native/native-progress-checkpoint.js

@@ -0,0 +1,104 @@
+import { randomUUID } from 'crypto';
+import { NativeChangeRevisionConflictError, readNativeChange } from './native-change.js';
+import { settleNativeChangeJournalsLocked } from './native-change-recovery.js';
+import { continueNativeCheckpointLocked, prepareNativeCheckpointJournal, } from './native-checkpoint-journal.js';
+import { createNativeCheckpointManifest, hashNativeCheckpointManifest, nativeCheckpointManifestRef, readNativeProgressCheckpoint, } from './native-checkpoint-storage.js';
+import { nativeContinuation } from './native-continuation.js';
+import { sha256Text } from './native-hash.js';
+import { withNativeMutationLock } from './native-mutation-lock.js';
+import { redactNativeCredentialText } from './native-redaction.js';
+import { withNativeTransitionLock } from './native-transition-journal.js';
+function requiredText(value, label) {
+    const normalized = redactNativeCredentialText(value).trim();
+    if (normalized.length === 0 || normalized.length > 2_000) {
+        throw new Error(`${label} must be between 1 and 2000 characters`);
+    }
+    return normalized;
+}
+function expectedRevisionValue(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error('Native expected revision must be a positive integer');
+    }
+    return value;
+}
+export async function checkpointNativeChange(options) {
+    const summary = requiredText(options.summary, 'Checkpoint summary');
+    const nextAction = requiredText(options.nextAction, 'Checkpoint next action');
+    const expectedRevision = expectedRevisionValue(options.expectedRevision);
+    return withNativeMutationLock(options.paths, `checkpoint ${options.name}`, () => withNativeTransitionLock(options.paths, options.name, `checkpoint ${options.name}`, async () => {
+        await settleNativeChangeJournalsLocked(options.paths, options.name);
+        const state = await readNativeChange(options.paths, options.name);
+        const manifest = await createNativeCheckpointManifest(options.paths, options.name, options.artifacts ?? []);
+        const manifestHash = hashNativeCheckpointManifest(manifest);
+        const inputHash = sha256Text(JSON.stringify({
+            summary,
+            nextAction,
+            artifacts: manifest.artifacts,
+        }));
+        const existing = await readNativeProgressCheckpoint(options.paths, options.name);
+        if (existing?.inputHash === inputHash &&
+            existing.stateRevision === state.revision &&
+            existing.phase === state.phase) {
+            if (expectedRevision !== undefined &&
+                expectedRevision !== existing.previousRevision &&
+                expectedRevision !== state.revision) {
+                throw new NativeChangeRevisionConflictError(state.name, expectedRevision, state.revision);
+            }
+            return {
+                change: state,
+                checkpoint: existing,
+                idempotent: true,
+                expectedRevision: expectedRevision ?? existing.previousRevision,
+                previousRevision: existing.previousRevision,
+                revision: state.revision,
+                outcome: 'idempotent',
+                continuation: nativeContinuation({ state }),
+            };
+        }
+        if (expectedRevision !== undefined && state.revision !== expectedRevision) {
+            throw new NativeChangeRevisionConflictError(state.name, expectedRevision, state.revision);
+        }
+        const nextState = { ...state, revision: state.revision + 1 };
+        const checkpoint = {
+            schema: 'comet.native.progress-checkpoint.v1',
+            id: options.checkpointId?.() ?? randomUUID(),
+            change: state.name,
+            phase: state.phase,
+            previousRevision: state.revision,
+            stateRevision: nextState.revision,
+            summary,
+            nextAction,
+            inputHash,
+            manifestHash,
+            manifestRef: nativeCheckpointManifestRef(manifestHash),
+            artifactCount: manifest.artifacts.length,
+            createdAt: (options.now ?? new Date()).toISOString(),
+        };
+        const journal = await prepareNativeCheckpointJournal({
+            paths: options.paths,
+            previousState: state,
+            nextState,
+            checkpoint,
+            manifest,
+            now: options.now,
+            checkpointId: () => checkpoint.id,
+        });
+        await options.hooks?.afterPrepared?.(journal);
+        const persisted = await continueNativeCheckpointLocked(options.paths, options.name, options.hooks);
+        if (!persisted)
+            throw new Error('Native checkpoint journal disappeared before completion');
+        return {
+            change: persisted.nextState,
+            checkpoint: persisted.checkpoint,
+            idempotent: false,
+            expectedRevision: expectedRevision ?? persisted.checkpoint.previousRevision,
+            previousRevision: persisted.checkpoint.previousRevision,
+            revision: persisted.nextState.revision,
+            outcome: 'recorded',
+            continuation: nativeContinuation({ state: persisted.nextState }),
+        };
+    }));
+}
+//# sourceMappingURL=native-progress-checkpoint.js.map

package/dist/domains/comet-native/native-progress-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-progress-checkpoint.js","sourceRoot":"","sources":["../../../domains/comet-native/native-progress-checkpoint.ts"],"names":[],"mappings":"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"}

package/dist/domains/comet-native/native-protected-file.d.ts

@@ -0,0 +1,113 @@
+import { type Dirent } from 'node:fs';
+export interface NativeProtectedFileHooks {
+    afterParentChainCaptured?: () => void | Promise<void>;
+    afterOpen?: () => void | Promise<void>;
+    beforeRead?: () => void | Promise<void>;
+    beforeFinalCheck?: () => void | Promise<void>;
+    beforeTargetCommit?: () => void | Promise<void>;
+}
+export interface NativeProtectedFile {
+    bytes: Buffer;
+    hash: string;
+    size: number;
+}
+export interface NativeProtectedTextFile extends NativeProtectedFile {
+    text: string;
+}
+export declare function readNativeProtectedFile(options: {
+    root: string;
+    file: string;
+    maxBytes: number;
+    label: string;
+    forbiddenRoots?: readonly string[];
+    hooks?: NativeProtectedFileHooks;
+}): Promise<NativeProtectedFile>;
+export declare function readNativeProtectedTextFile(options: {
+    root: string;
+    file: string;
+    maxBytes: number;
+    label: string;
+    forbiddenRoots?: readonly string[];
+    hooks?: NativeProtectedFileHooks;
+}): Promise<NativeProtectedTextFile>;
+export declare function readNativeProtectedDirectory(options: {
+    root: string;
+    directory: string;
+    label: string;
+    maxEntries?: number;
+}): Promise<{
+    entries: Dirent[];
+    verify: () => Promise<void>;
+}>;
+export declare function captureNativeProtectedDirectoryGuard(options: {
+    root: string;
+    directory: string;
+    label: string;
+}): Promise<{
+    verify: () => Promise<void>;
+}>;
+export declare function quarantineNativeProtectedDirectory(options: {
+    root: string;
+    directory: string;
+    quarantine: string;
+    label: string;
+    beforeQuarantine?: () => void | Promise<void>;
+    afterQuarantine?: (quarantine: string) => void | Promise<void>;
+}): Promise<void>;
+export declare function removeNativeProtectedDirectory(options: {
+    root: string;
+    directory: string;
+    quarantine: string;
+    label: string;
+    beforeQuarantine?: () => void | Promise<void>;
+    afterQuarantine?: (quarantine: string) => void | Promise<void>;
+    beforeRemove?: (quarantine: string) => void | Promise<void>;
+}): Promise<void>;
+export declare function removeNativeProtectedFile(options: {
+    root: string;
+    file: string;
+    maxBytes: number;
+    expectedHash: string;
+    expectedSize: number;
+    label: string;
+    beforeRemove?: () => void | Promise<void>;
+}): Promise<void>;
+export declare function removeNativeProtectedEmptyDirectory(options: {
+    root: string;
+    directory: string;
+    label: string;
+    beforeRemove?: () => void | Promise<void>;
+}): Promise<void>;
+export declare function removeNativeProtectedQuarantine(options: {
+    root: string;
+    quarantine: string;
+    label: string;
+    beforeRemove?: (quarantine: string) => void | Promise<void>;
+}): Promise<void>;
+export declare function ensureNativeProtectedDirectory(options: {
+    root: string;
+    directory: string;
+    label: string;
+}): Promise<void>;
+/** Move a real directory inside one managed root while binding the source object identity. */
+export declare function moveNativeProtectedDirectory(options: {
+    root: string;
+    source: string;
+    target: string;
+    label: string;
+    beforeMove?: () => void | Promise<void>;
+}): Promise<void>;
+export declare function copyNativeProtectedFile(options: {
+    sourceRoot: string;
+    source: string;
+    targetRoot: string;
+    target: string;
+    maxBytes: number;
+    label: string;
+    expectedHash?: string;
+    expectedTargetHash?: string | null;
+    forbiddenRoots?: readonly string[];
+    exclusive?: boolean;
+    hooks?: NativeProtectedFileHooks;
+}): Promise<NativeProtectedFile>;
+//# sourceMappingURL=native-protected-file.d.ts.map

package/dist/domains/comet-native/native-protected-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-protected-file.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-protected-file.ts"],"names":[],"mappings":"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"}