@rpamis/comet 0.4.0-beta.1 → 0.4.0-beta.11

package/dist/domains/comet-native/native-archive-preflight.js

@@ -0,0 +1,222 @@
+import path from 'node:path';
+import { canonicalHash } from './native-canonical-hash.js';
+export const NATIVE_ARCHIVE_PREFLIGHT_SCHEMA = 'comet.native.archive-preflight.v1';
+const PREFLIGHT_HASH_TAG = 'comet.native.archive-preflight.v1';
+const OPERATION_HASH_TAG = 'comet.native.archive-operation.v1';
+const HASH_PATTERN = /^[a-f0-9]{64}$/u;
+const NAME_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/u;
+const FINDING_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/u;
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function hash(value, label) {
+    if (typeof value !== 'string' || !HASH_PATTERN.test(value)) {
+        throw new Error(`${label} must be a SHA-256 hash`);
+    }
+    return value;
+}
+function optionalHash(value, label) {
+    return value === null ? null : hash(value, label);
+}
+function normalizedRef(value, label) {
+    const normalized = path.posix.normalize(value);
+    if (typeof value !== 'string' ||
+        value.length === 0 ||
+        value !== value.trim() ||
+        value.includes('\\') ||
+        path.posix.isAbsolute(normalized) ||
+        /^(?:[A-Za-z]:|~)/u.test(value) ||
+        value.split('/').includes('..') ||
+        normalized !== value ||
+        normalized === '.' ||
+        value.endsWith('/')) {
+        throw new Error(`${label} must be a normalized Native-relative ref`);
+    }
+    return value;
+}
+function positiveRevision(value) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error('Native archive preflight revision must be a positive integer');
+    }
+    return value;
+}
+function normalizeSpec(value, index) {
+    if (!NAME_PATTERN.test(value.capability)) {
+        throw new Error(`Native archive spec ${index} capability is invalid`);
+    }
+    if (value.operation !== 'create' &&
+        value.operation !== 'replace' &&
+        value.operation !== 'remove') {
+        throw new Error(`Native archive spec ${value.capability} operation is invalid`);
+    }
+    const expectedBaseHash = optionalHash(value.expectedBaseHash, `Native archive spec ${value.capability} expected base`);
+    const actualBaseHash = optionalHash(value.actualBaseHash, `Native archive spec ${value.capability} actual base`);
+    const proposedHash = optionalHash(value.proposedHash, `Native archive spec ${value.capability} proposed content`);
+    if (value.operation === 'create' && expectedBaseHash !== null) {
+        throw new Error(`Native archive create ${value.capability} must expect no canonical base`);
+    }
+    if (value.operation !== 'create' && expectedBaseHash === null) {
+        throw new Error(`Native archive ${value.operation} ${value.capability} requires a base hash`);
+    }
+    if ((value.operation === 'remove') !== (proposedHash === null)) {
+        throw new Error(`Native archive ${value.operation} ${value.capability} proposed hash is invalid`);
+    }
+    return {
+        capability: value.capability,
+        operation: value.operation,
+        expectedBaseHash,
+        actualBaseHash,
+        proposedHash,
+    };
+}
+function normalizeEvidence(value) {
+    if (value.result !== 'pending' && value.result !== 'pass' && value.result !== 'fail') {
+        throw new Error('Native archive verification result is invalid');
+    }
+    if (!['missing', 'invalid', 'stale', 'complete', 'partial'].includes(value.freshness)) {
+        throw new Error('Native archive verification freshness is invalid');
+    }
+    if (!Number.isSafeInteger(value.skippedAcceptanceCount) || value.skippedAcceptanceCount < 0) {
+        throw new Error('Native archive skipped acceptance count is invalid');
+    }
+    const normalized = {
+        result: value.result,
+        freshness: value.freshness,
+        contractHash: optionalHash(value.contractHash, 'Native archive contract hash'),
+        acceptanceHash: optionalHash(value.acceptanceHash, 'Native archive acceptance hash'),
+        implementationScopeHash: optionalHash(value.implementationScopeHash, 'Native archive implementation scope hash'),
+        reportHash: optionalHash(value.reportHash, 'Native archive report hash'),
+        envelopeHash: optionalHash(value.envelopeHash, 'Native archive envelope hash'),
+        partialAllowanceHash: optionalHash(value.partialAllowanceHash, 'Native archive partial allowance hash'),
+        skippedAcceptanceCount: value.skippedAcceptanceCount,
+    };
+    if ((value.freshness === 'complete' || value.freshness === 'partial') &&
+        [
+            normalized.contractHash,
+            normalized.acceptanceHash,
+            normalized.implementationScopeHash,
+            normalized.reportHash,
+            normalized.envelopeHash,
+        ].some((entry) => entry === null)) {
+        throw new Error('Fresh Native archive evidence requires every bound content hash');
+    }
+    if ((value.freshness === 'partial' && normalized.partialAllowanceHash === null) ||
+        (value.freshness === 'complete' && normalized.partialAllowanceHash !== null)) {
+        throw new Error('Native archive partial evidence allowance state is invalid');
+    }
+    return normalized;
+}
+function normalizeFindingCodes(values) {
+    if (values.length > 64)
+        throw new Error('Native archive preflight has too many findings');
+    const codes = values.map((value) => {
+        if (typeof value !== 'string' || !FINDING_PATTERN.test(value)) {
+            throw new Error(`Native archive preflight finding code is invalid: ${String(value)}`);
+        }
+        return value;
+    });
+    const normalized = [...new Set(codes)].sort(compareText);
+    if (normalized.length !== codes.length) {
+        throw new Error('Native archive preflight has duplicate finding codes');
+    }
+    return normalized;
+}
+function derivedFindings(input) {
+    const findings = [];
+    if (input.phase !== 'archive')
+        findings.push('archive-phase-required');
+    if (input.archived)
+        findings.push('change-already-archived');
+    if (input.pendingJournal)
+        findings.push('pending-journal');
+    if (input.targetExists)
+        findings.push('archive-target-exists');
+    if (input.evidence.result !== 'pass')
+        findings.push('verification-not-passed');
+    if (input.evidence.freshness === 'missing')
+        findings.push('verification-evidence-missing');
+    if (input.evidence.freshness === 'invalid')
+        findings.push('verification-evidence-invalid');
+    if (input.evidence.freshness === 'stale')
+        findings.push('verification-evidence-stale');
+    if (input.evidence.skippedAcceptanceCount > 0) {
+        findings.push('verification-acceptance-skipped');
+    }
+    for (const spec of input.specs) {
+        if (spec.actualBaseHash !== spec.expectedBaseHash)
+            findings.push('spec-base-conflict');
+    }
+    return [...new Set(findings)].sort(compareText);
+}
+/** Build a pure, content-bound Archive preview. No path is read or written here. */
+export function buildNativeArchivePreflight(input) {
+    if (!NAME_PATTERN.test(input.change))
+        throw new Error('Native archive change name is invalid');
+    if (typeof input.stateSchema !== 'string' || input.stateSchema.length === 0) {
+        throw new Error('Native archive state schema is invalid');
+    }
+    if (!Array.isArray(input.specs) || input.specs.length > 64) {
+        throw new Error('Native archive preflight exceeds its spec budget');
+    }
+    const specs = input.specs
+        .map(normalizeSpec)
+        .sort((left, right) => compareText(left.capability, right.capability));
+    if (new Set(specs.map((spec) => spec.capability)).size !== specs.length) {
+        throw new Error('Native archive preflight contains duplicate capabilities');
+    }
+    const operations = specs.map((spec) => ({
+        ...spec,
+        operationHash: canonicalHash(OPERATION_HASH_TAG, spec),
+    }));
+    const evidence = normalizeEvidence(input.evidence);
+    const findingCodes = [
+        ...new Set([
+            ...normalizeFindingCodes(input.findingCodes ?? []),
+            ...derivedFindings({
+                phase: input.phase,
+                archived: input.archived,
+                pendingJournal: input.pendingJournal,
+                targetExists: input.targetExists,
+                specs,
+                evidence,
+            }),
+        ]),
+    ].sort(compareText);
+    const revision = positiveRevision(input.revision);
+    const targetRef = normalizedRef(input.targetRef, 'Native archive target');
+    if (input.archiveConfirmation !== 'automatic' && input.archiveConfirmation !== 'required') {
+        throw new Error('Native archive confirmation must be automatic or required');
+    }
+    const facts = {
+        stateSchema: input.stateSchema,
+        change: input.change,
+        archiveConfirmation: input.archiveConfirmation,
+        revision,
+        phase: input.phase,
+        archived: input.archived,
+        pendingJournal: input.pendingJournal,
+        targetRef,
+        targetExists: input.targetExists,
+        operations,
+        evidence,
+        findingCodes,
+    };
+    return {
+        schema: NATIVE_ARCHIVE_PREFLIGHT_SCHEMA,
+        change: input.change,
+        archiveConfirmation: input.archiveConfirmation,
+        revision,
+        targetRef,
+        ready: findingCodes.length === 0,
+        evidenceFreshness: evidence.freshness,
+        operationCount: operations.length,
+        operations,
+        findingCodes,
+        preflightHash: canonicalHash(PREFLIGHT_HASH_TAG, facts),
+    };
+}
+//# sourceMappingURL=native-archive-preflight.js.map

package/dist/domains/comet-native/native-archive-preflight.js.map

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

package/dist/domains/comet-native/native-archive-transaction.d.ts

@@ -0,0 +1,20 @@
+import { nativeTransactionPaths, type NativeArchiveTransactionJournalV2, type NativeArchiveTransactionOperationV2 } from './native-transaction.js';
+import type { NativeProjectPaths } from './native-types.js';
+export interface NativeArchiveTransactionHooksV2 {
+    afterPrepared?: (journal: NativeArchiveTransactionJournalV2) => void | Promise<void>;
+    afterOperation?: (operation: NativeArchiveTransactionOperationV2, completedCount: number) => void | Promise<void>;
+    beforeArchiveChangeMove?: (operation: NativeArchiveTransactionOperationV2) => void | Promise<void>;
+    afterFinalizationStarted?: (journal: NativeArchiveTransactionJournalV2) => void | Promise<void>;
+    afterProtectedCopySourceParentCaptured?: (kind: 'stage' | 'backup' | 'apply', ref: string) => void | Promise<void>;
+    afterArchiveTargetBound?: (phase: 'apply' | 'rollback', operation: NativeArchiveTransactionOperationV2, target: string) => void | Promise<void>;
+    afterArchiveTargetQuarantined?: (phase: 'apply' | 'rollback', operation: NativeArchiveTransactionOperationV2, quarantine: string) => void | Promise<void>;
+    beforeArchiveTargetInstall?: (phase: 'apply' | 'rollback', operation: NativeArchiveTransactionOperationV2, target: string) => void | Promise<void>;
+    afterArchiveTargetInstalled?: (phase: 'apply' | 'rollback', operation: NativeArchiveTransactionOperationV2, target: string) => void | Promise<void>;
+}
+export declare function createNativeArchiveTransactionV2(paths: NativeProjectPaths, journal: NativeArchiveTransactionJournalV2): Promise<void>;
+export declare function readNativeArchiveTransactionV2(paths: NativeProjectPaths, id: string): Promise<NativeArchiveTransactionJournalV2>;
+export declare function applyNativeArchiveTransactionV2(paths: NativeProjectPaths, journal: NativeArchiveTransactionJournalV2, hooks?: NativeArchiveTransactionHooksV2): Promise<NativeArchiveTransactionJournalV2>;
+export declare function rollbackNativeArchiveTransactionV2(paths: NativeProjectPaths, journal: NativeArchiveTransactionJournalV2, hooks?: NativeArchiveTransactionHooksV2): Promise<NativeArchiveTransactionJournalV2>;
+export declare function finalizeNativeArchiveTransactionV2(paths: NativeProjectPaths, journal: NativeArchiveTransactionJournalV2, event: 'archive-finalization-started' | 'archive-finalized' | 'commit'): Promise<NativeArchiveTransactionJournalV2>;
+export declare function nativeArchiveTransactionPaths(paths: NativeProjectPaths, id: string): ReturnType<typeof nativeTransactionPaths>;
+//# sourceMappingURL=native-archive-transaction.d.ts.map

package/dist/domains/comet-native/native-archive-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-archive-transaction.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-archive-transaction.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,sBAAsB,EAItB,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACzC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,+BAA+B;IAC9C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,cAAc,CAAC,EAAE,CACf,SAAS,EAAE,mCAAmC,EAC9C,cAAc,EAAE,MAAM,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,uBAAuB,CAAC,EAAE,CACxB,SAAS,EAAE,mCAAmC,KAC3C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,sCAAsC,CAAC,EAAE,CACvC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,EAClC,GAAG,EAAE,MAAM,KACR,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,uBAAuB,CAAC,EAAE,CACxB,KAAK,EAAE,OAAO,GAAG,UAAU,EAC3B,SAAS,EAAE,mCAAmC,EAC9C,MAAM,EAAE,MAAM,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,6BAA6B,CAAC,EAAE,CAC9B,KAAK,EAAE,OAAO,GAAG,UAAU,EAC3B,SAAS,EAAE,mCAAmC,EAC9C,UAAU,EAAE,MAAM,KACf,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,0BAA0B,CAAC,EAAE,CAC3B,KAAK,EAAE,OAAO,GAAG,UAAU,EAC3B,SAAS,EAAE,mCAAmC,EAC9C,MAAM,EAAE,MAAM,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,2BAA2B,CAAC,EAAE,CAC5B,KAAK,EAAE,OAAO,GAAG,UAAU,EAC3B,SAAS,EAAE,mCAAmC,EAC9C,MAAM,EAAE,MAAM,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAoED,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,kBAAkB,EACzB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,iCAAiC,CAAC,CAa5C;AAm9BD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,iCAAiC,EAC1C,KAAK,CAAC,EAAE,+BAA+B,GACtC,OAAO,CAAC,iCAAiC,CAAC,CA2B5C;AA6RD,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,iCAAiC,EAC1C,KAAK,CAAC,EAAE,+BAA+B,GACtC,OAAO,CAAC,iCAAiC,CAAC,CAyB5C;AA8ED,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,iCAAiC,EAC1C,KAAK,EAAE,8BAA8B,GAAG,mBAAmB,GAAG,QAAQ,GACrE,OAAO,CAAC,iCAAiC,CAAC,CAI5C;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,kBAAkB,EACzB,EAAE,EAAE,MAAM,GACT,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAE3C"}