@rpamis/comet 0.4.0-beta.5 → 0.4.0-beta.7

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

@@ -0,0 +1,159 @@
+import { createHash } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { sha256Text } from './native-hash.js';
+import { readNativeProtectedDirectory, readNativeProtectedFile } from './native-protected-file.js';
+const TREE_HASH_TAG = 'comet.native.archive-tree.v1';
+export const NATIVE_ARCHIVE_CONTENT_LIMITS = {
+    maxDepth: 128,
+    maxEntries: 20_000,
+    maxFileBytes: 64 * 1024 * 1024,
+    maxTotalBytes: 256 * 1024 * 1024,
+    maxManifestBytes: 16 * 1024 * 1024,
+    maxRefBytes: 4 * 1024,
+};
+function normalizedLimits(limits) {
+    const resolved = { ...NATIVE_ARCHIVE_CONTENT_LIMITS, ...limits };
+    for (const [name, value] of Object.entries(resolved)) {
+        if (!Number.isSafeInteger(value) || value <= 0) {
+            throw new Error(`Native Archive content limit ${name} must be a positive safe integer`);
+        }
+    }
+    return resolved;
+}
+function directorySnapshot(entries) {
+    return JSON.stringify(entries
+        .map((entry) => ({
+        name: entry.name,
+        kind: entry.isDirectory()
+            ? 'directory'
+            : entry.isFile()
+                ? 'file'
+                : entry.isSymbolicLink()
+                    ? 'symlink'
+                    : 'other',
+    }))
+        .sort((left, right) => left.name.localeCompare(right.name)));
+}
+function appendTreeEntry(entries, entry, budget, limits) {
+    budget.entryCount += 1;
+    if (budget.entryCount > limits.maxEntries) {
+        throw new Error(`Native Archive content exceeds ${limits.maxEntries} entries`);
+    }
+    if (Buffer.byteLength(entry.ref, 'utf8') > limits.maxRefBytes) {
+        throw new Error(`Native Archive content ref exceeds ${limits.maxRefBytes} bytes: ${entry.ref}`);
+    }
+    const entryBytes = Buffer.byteLength(JSON.stringify(entry), 'utf8');
+    budget.manifestBytes += entryBytes + (entries.length === 0 ? 0 : 1);
+    if (budget.manifestBytes + 2 > limits.maxManifestBytes) {
+        throw new Error(`Native Archive content manifest exceeds ${limits.maxManifestBytes} bytes`);
+    }
+    entries.push(entry);
+}
+async function walkArchiveTree(root, directory, entries, budget, limits, depth) {
+    if (depth > limits.maxDepth) {
+        throw new Error(`Native Archive content exceeds depth ${limits.maxDepth}`);
+    }
+    const protectedDirectory = await readNativeProtectedDirectory({
+        root,
+        directory,
+        label: `Native Archive content directory ${path.relative(root, directory) || '.'}`,
+        maxEntries: limits.maxEntries,
+    });
+    const beforeSnapshot = directorySnapshot(protectedDirectory.entries);
+    const children = [...protectedDirectory.entries];
+    children.sort((left, right) => left.name.localeCompare(right.name));
+    for (const child of children) {
+        await protectedDirectory.verify();
+        const target = path.join(directory, child.name);
+        const ref = path.relative(root, target).replaceAll('\\', '/');
+        const stat = await fs.lstat(target);
+        if (child.isSymbolicLink() || stat.isSymbolicLink()) {
+            throw new Error(`Native Archive content must not contain symlinks or junctions: ${ref}`);
+        }
+        if (child.isDirectory() && stat.isDirectory()) {
+            appendTreeEntry(entries, { ref, kind: 'directory' }, budget, limits);
+            await walkArchiveTree(root, target, entries, budget, limits, depth + 1);
+            continue;
+        }
+        if (!child.isFile() || !stat.isFile()) {
+            throw new Error(`Native Archive content must contain only files and directories: ${ref}`);
+        }
+        const snapshot = await readNativeProtectedFile({
+            root,
+            file: target,
+            maxBytes: limits.maxFileBytes,
+            label: `Native Archive content file ${ref}`,
+        });
+        budget.totalBytes += snapshot.size;
+        if (budget.totalBytes > limits.maxTotalBytes) {
+            throw new Error(`Native Archive content exceeds ${limits.maxTotalBytes} total file bytes`);
+        }
+        appendTreeEntry(entries, { ref, kind: 'file', hash: snapshot.hash, size: snapshot.size }, budget, limits);
+        await protectedDirectory.verify();
+    }
+    await protectedDirectory.verify();
+    const afterDirectory = await readNativeProtectedDirectory({
+        root,
+        directory,
+        label: `Native Archive content directory ${path.relative(root, directory) || '.'}`,
+        maxEntries: limits.maxEntries,
+    });
+    if (directorySnapshot(afterDirectory.entries) !== beforeSnapshot) {
+        throw new Error(`Native Archive content directory changed while reading: ${path.relative(root, directory) || '.'}`);
+    }
+    await Promise.all([protectedDirectory.verify(), afterDirectory.verify()]);
+}
+/** Hash the complete change tree without embedding its absolute location. */
+export async function hashNativeArchiveTree(directory, requestedLimits = {}) {
+    const limits = normalizedLimits(requestedLimits);
+    directory = path.resolve(directory);
+    const stat = await fs.lstat(directory);
+    if (!stat.isDirectory() || stat.isSymbolicLink()) {
+        throw new Error(`Native Archive move source must be a real directory: ${directory}`);
+    }
+    const entries = [];
+    const budget = { entryCount: 0, totalBytes: 0, manifestBytes: 0 };
+    await walkArchiveTree(directory, directory, entries, budget, limits, 0);
+    const manifest = JSON.stringify(entries);
+    if (Buffer.byteLength(manifest, 'utf8') > limits.maxManifestBytes) {
+        throw new Error(`Native Archive content manifest exceeds ${limits.maxManifestBytes} bytes`);
+    }
+    return sha256Text(`${TREE_HASH_TAG}\0${manifest}`);
+}
+export async function inspectNativeArchiveContent(target, requestedLimits = {}) {
+    const limits = normalizedLimits(requestedLimits);
+    target = path.resolve(target);
+    let stat;
+    try {
+        stat = await fs.lstat(target);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    if (stat.isSymbolicLink()) {
+        throw new Error(`Native Archive transaction path must not be a symlink or junction: ${target}`);
+    }
+    if (stat.isFile()) {
+        const snapshot = await readNativeProtectedFile({
+            root: path.dirname(target),
+            file: target,
+            maxBytes: limits.maxFileBytes,
+            label: `Native Archive transaction file ${path.basename(target)}`,
+        });
+        return { kind: 'file', hash: snapshot.hash };
+    }
+    if (stat.isDirectory()) {
+        return { kind: 'directory', hash: await hashNativeArchiveTree(target, limits) };
+    }
+    throw new Error(`Native Archive transaction path has an unsupported file type: ${target}`);
+}
+export function isNativeArchiveHash(value) {
+    return typeof value === 'string' && /^[a-f0-9]{64}$/u.test(value);
+}
+export function hashNativeArchiveBytes(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=native-archive-content.js.map

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

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

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

@@ -0,0 +1,9 @@
+import { type NativeArchivePreflight } from './native-archive-preflight.js';
+import type { NativeProjectPaths } from './native-types.js';
+/** Collect the single read-only Archive view reused by CLI, commit, status, and Dashboard. */
+export declare function inspectNativeArchivePreflight(options: {
+    paths: NativeProjectPaths;
+    name: string;
+    now?: Date;
+}): Promise<NativeArchivePreflight>;
+//# sourceMappingURL=native-archive-inspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-archive-inspection.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-archive-inspection.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,+BAA+B,CAAC;AAYvC,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,mBAAmB,CAAC;AA4D9E,8FAA8F;AAC9F,wBAAsB,6BAA6B,CAAC,OAAO,EAAE;IAC3D,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAsClC"}

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

@@ -0,0 +1,94 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { buildNativeArchivePreflight, } from './native-archive-preflight.js';
+import { readNativeBoundedTextFile } from './native-bounded-file.js';
+import { inspectNativeChangeConflicts } from './native-conflict-inspection.js';
+import { hasPendingNativeCheckpointRecovery, hasPendingNativeSchemaMigration, nativeChangeDir, readNativeChange, } from './native-change.js';
+import { canonicalSpecPath } from './native-artifacts.js';
+import { isInsidePath } from './native-paths.js';
+import { nativeTransitionJournalFile } from './native-transition-journal.js';
+import { inspectNativeVerificationFreshness } from './native-verification-runtime.js';
+function archiveTargetRef(name, now) {
+    return `archive/${now.toISOString().slice(0, 10)}-${name}`;
+}
+async function exists(target) {
+    try {
+        await fs.lstat(target);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function optionalBoundedHash(root, ref) {
+    try {
+        return (await readNativeBoundedTextFile({ root, ref })).hash;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+async function specFact(paths, name, change) {
+    const canonical = canonicalSpecPath(paths, change.capability);
+    if (!isInsidePath(paths.nativeRoot, canonical)) {
+        throw new Error(`Native canonical spec escapes its root: ${change.capability}`);
+    }
+    const canonicalRef = path.relative(paths.nativeRoot, canonical).replaceAll('\\', '/');
+    const actualBaseHash = await optionalBoundedHash(paths.nativeRoot, canonicalRef);
+    let proposedHash = null;
+    if (change.operation !== 'remove') {
+        if (!change.source)
+            throw new Error(`Native proposed spec is missing: ${change.capability}`);
+        proposedHash = (await readNativeBoundedTextFile({
+            root: nativeChangeDir(paths, name),
+            ref: change.source,
+        })).hash;
+    }
+    return {
+        capability: change.capability,
+        operation: change.operation,
+        expectedBaseHash: change.operation === 'create' ? null : change.base_hash,
+        actualBaseHash,
+        proposedHash,
+    };
+}
+async function hasPendingTransition(paths, name) {
+    return exists(nativeTransitionJournalFile(paths, name));
+}
+/** Collect the single read-only Archive view reused by CLI, commit, status, and Dashboard. */
+export async function inspectNativeArchivePreflight(options) {
+    const now = options.now ?? new Date();
+    const state = await readNativeChange(options.paths, options.name);
+    const targetRef = archiveTargetRef(state.name, now);
+    const target = path.resolve(options.paths.nativeRoot, ...targetRef.split('/'));
+    if (!isInsidePath(options.paths.nativeRoot, target)) {
+        throw new Error('Native archive target escapes its root');
+    }
+    const [specs, evidence, conflicts, pendingSchema, pendingCheckpoint, pendingTransition, targetExists,] = await Promise.all([
+        Promise.all(state.spec_changes.map((change) => specFact(options.paths, state.name, change))),
+        inspectNativeVerificationFreshness({ paths: options.paths, state, now }),
+        inspectNativeChangeConflicts(options.paths, state.name),
+        hasPendingNativeSchemaMigration(options.paths, state.name),
+        hasPendingNativeCheckpointRecovery(options.paths, state.name),
+        hasPendingTransition(options.paths, state.name),
+        exists(target),
+    ]);
+    return buildNativeArchivePreflight({
+        change: state.name,
+        stateSchema: state.schema,
+        revision: state.revision,
+        phase: state.phase,
+        archived: state.archived,
+        pendingJournal: pendingSchema || pendingCheckpoint || pendingTransition,
+        targetRef,
+        targetExists,
+        specs,
+        evidence: evidence.evidence,
+        findingCodes: [...evidence.findingCodes, ...conflicts.findingCodes],
+    });
+}
+//# sourceMappingURL=native-archive-inspection.js.map

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

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

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

@@ -0,0 +1,52 @@
+import type { NativePhase, NativeSpecOperation } from './native-types.js';
+export declare const NATIVE_ARCHIVE_PREFLIGHT_SCHEMA: "comet.native.archive-preflight.v1";
+export type NativeVerificationFreshness = 'missing' | 'invalid' | 'stale' | 'complete' | 'partial';
+export interface NativeArchiveSpecFact {
+    capability: string;
+    operation: NativeSpecOperation;
+    expectedBaseHash: string | null;
+    actualBaseHash: string | null;
+    proposedHash: string | null;
+}
+export interface NativeArchiveEvidenceFact {
+    result: 'pending' | 'pass' | 'fail';
+    freshness: NativeVerificationFreshness;
+    contractHash: string | null;
+    acceptanceHash: string | null;
+    implementationScopeHash: string | null;
+    reportHash: string | null;
+    envelopeHash: string | null;
+    partialAllowanceHash: string | null;
+    skippedAcceptanceCount: number;
+}
+export interface NativeArchivePreflightInput {
+    change: string;
+    stateSchema: string;
+    revision: number;
+    phase: NativePhase;
+    archived: boolean;
+    pendingJournal: boolean;
+    targetRef: string;
+    targetExists: boolean;
+    specs: readonly NativeArchiveSpecFact[];
+    evidence: NativeArchiveEvidenceFact;
+    findingCodes?: readonly string[];
+}
+export interface NativeArchiveOperationPreview extends NativeArchiveSpecFact {
+    operationHash: string;
+}
+export interface NativeArchivePreflight {
+    schema: typeof NATIVE_ARCHIVE_PREFLIGHT_SCHEMA;
+    change: string;
+    revision: number;
+    targetRef: string;
+    ready: boolean;
+    evidenceFreshness: NativeVerificationFreshness;
+    operationCount: number;
+    operations: NativeArchiveOperationPreview[];
+    findingCodes: string[];
+    preflightHash: string;
+}
+/** Build a pure, content-bound Archive preview. No path is read or written here. */
+export declare function buildNativeArchivePreflight(input: NativeArchivePreflightInput): NativeArchivePreflight;
+//# sourceMappingURL=native-archive-preflight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-archive-preflight.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-archive-preflight.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,eAAO,MAAM,+BAA+B,EAAG,mCAA4C,CAAC;AAQ5F,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,SAAS,EAAE,2BAA2B,CAAC;IACvC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,+BAA+B,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,2BAA2B,CAAC;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,6BAA6B,EAAE,CAAC;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AA8KD,oFAAoF;AACpF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CA2DxB"}

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

@@ -0,0 +1,214 @@
+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');
+    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');
+    const facts = {
+        stateSchema: input.stateSchema,
+        change: input.change,
+        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,
+        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,19 @@
+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>;
+    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":"AAeA,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,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;AAk9BD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,iCAAiC,EAC1C,KAAK,CAAC,EAAE,+BAA+B,GACtC,OAAO,CAAC,iCAAiC,CAAC,CAwB5C;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"}