@rpamis/comet 0.3.9 → 0.4.0-beta.10

package/dist/domains/comet-native/native-conflict-radar.js

@@ -0,0 +1,326 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { canonicalHash, canonicalJson } from './native-canonical-hash.js';
+export const NATIVE_CONFLICT_RADAR_SCHEMA = 'comet.native.conflict-radar.v1';
+export const NATIVE_CONFLICT_RADAR_LIMITS = Object.freeze({
+    maxChanges: 32,
+    maxSpecsPerChange: 64,
+    maxArtifactsPerChange: 128,
+    maxTotalSpecs: 512,
+    maxTotalArtifacts: 1_024,
+    maxSignalsPerRelationship: 8,
+    maxRelationships: 256,
+    maxSerializedBytes: 64 * 1_024,
+    maxNameBytes: 128,
+    maxCapabilityBytes: 128,
+    maxArtifactPathBytes: 512,
+});
+const RADAR_HASH_TAG = 'comet.native.conflict-radar.v1';
+const SIGNAL_SET_HASH_TAG = 'comet.native.conflict-radar-signals.v1';
+const HASH_PATTERN = /^[a-f0-9]{64}$/u;
+const NAME_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/u;
+const CHANGE_KEYS = new Set([
+    'name',
+    'revision',
+    'specs',
+    'declaredArtifacts',
+    'workspaceIdentityHash',
+]);
+const SPEC_KEYS = new Set(['capability', 'operation', 'baseHash']);
+const ARTIFACT_KEYS = new Set(['path', 'kind']);
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function byteLength(value) {
+    return Buffer.byteLength(value, 'utf8');
+}
+function strictRecord(value, keys, label) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    const unknown = Object.keys(record).filter((key) => !keys.has(key));
+    if (unknown.length > 0)
+        throw new Error(`${label} has unknown field(s): ${unknown.join(', ')}`);
+    return record;
+}
+function boundedText(value, label, maxBytes) {
+    if (typeof value !== 'string' || value.length === 0 || value !== value.trim()) {
+        throw new Error(`${label} must be a non-empty trimmed string`);
+    }
+    if (byteLength(value) > maxBytes)
+        throw new Error(`${label} exceeds its byte budget`);
+    return value;
+}
+function normalizedProjectPath(value, label) {
+    const candidate = boundedText(value, label, NATIVE_CONFLICT_RADAR_LIMITS.maxArtifactPathBytes);
+    const normalized = path.posix.normalize(candidate);
+    if (candidate.includes('\\') ||
+        Array.from(candidate).some((character) => {
+            const code = character.codePointAt(0) ?? 0;
+            return code <= 0x1f || code === 0x7f;
+        }) ||
+        /^(?:[A-Za-z]:|~)/u.test(candidate) ||
+        path.posix.isAbsolute(normalized) ||
+        candidate.split('/').includes('..') ||
+        normalized !== candidate ||
+        normalized === '.' ||
+        candidate.endsWith('/')) {
+        throw new Error(`${label} must be a normalized project-relative path`);
+    }
+    return candidate;
+}
+function normalizedHash(value, label) {
+    if (typeof value !== 'string' || !HASH_PATTERN.test(value)) {
+        throw new Error(`${label} must be a SHA-256 hash`);
+    }
+    return value;
+}
+function normalizeSpec(value, label) {
+    const record = strictRecord(value, SPEC_KEYS, label);
+    const capability = boundedText(record.capability, `${label} capability`, NATIVE_CONFLICT_RADAR_LIMITS.maxCapabilityBytes);
+    if (!NAME_PATTERN.test(capability))
+        throw new Error(`${label} capability is invalid`);
+    if (record.operation !== 'create' &&
+        record.operation !== 'replace' &&
+        record.operation !== 'remove') {
+        throw new Error(`${label} operation is invalid`);
+    }
+    const baseHash = record.baseHash === null
+        ? null
+        : normalizedHash(record.baseHash, `${label} canonical base hash`);
+    if (record.operation === 'create' && baseHash !== null) {
+        throw new Error(`${label} create operation requires a null canonical base hash`);
+    }
+    if (record.operation !== 'create' && baseHash === null) {
+        throw new Error(`${label} ${record.operation} operation requires a canonical base hash`);
+    }
+    return { capability, operation: record.operation, baseHash };
+}
+function normalizeArtifact(value, label) {
+    const record = strictRecord(value, ARTIFACT_KEYS, label);
+    if (record.kind !== 'file' && record.kind !== 'directory') {
+        throw new Error(`${label} kind is invalid`);
+    }
+    return { path: normalizedProjectPath(record.path, `${label} path`), kind: record.kind };
+}
+function normalizeChange(value, index) {
+    const record = strictRecord(value, CHANGE_KEYS, `Conflict radar change ${index}`);
+    const name = boundedText(record.name, `Conflict radar change ${index} name`, NATIVE_CONFLICT_RADAR_LIMITS.maxNameBytes);
+    if (!NAME_PATTERN.test(name))
+        throw new Error(`Conflict radar change ${index} name is invalid`);
+    if (!Number.isSafeInteger(record.revision) || record.revision < 1) {
+        throw new Error(`Conflict radar change ${name} revision must be a positive safe integer`);
+    }
+    if (!Array.isArray(record.specs)) {
+        throw new Error(`Conflict radar change ${name} specs must be an array`);
+    }
+    if (record.specs.length > NATIVE_CONFLICT_RADAR_LIMITS.maxSpecsPerChange) {
+        throw new Error(`Conflict radar change ${name} exceeds the spec budget`);
+    }
+    if (!Array.isArray(record.declaredArtifacts)) {
+        throw new Error(`Conflict radar change ${name} declared artifacts must be an array`);
+    }
+    if (record.declaredArtifacts.length > NATIVE_CONFLICT_RADAR_LIMITS.maxArtifactsPerChange) {
+        throw new Error(`Conflict radar change ${name} exceeds the declared artifact budget`);
+    }
+    const specs = record.specs
+        .map((spec, specIndex) => normalizeSpec(spec, `Conflict radar change ${name} spec ${specIndex}`))
+        .sort((left, right) => compareText(left.capability, right.capability));
+    if (new Set(specs.map((spec) => spec.capability)).size !== specs.length) {
+        throw new Error(`Conflict radar change ${name} has duplicate capabilities`);
+    }
+    const declaredArtifacts = record.declaredArtifacts
+        .map((artifact, artifactIndex) => normalizeArtifact(artifact, `Conflict radar change ${name} artifact ${artifactIndex}`))
+        .sort((left, right) => compareText(left.path, right.path) || compareText(left.kind, right.kind));
+    const artifactPaths = declaredArtifacts.map((artifact) => artifact.path);
+    if (new Set(artifactPaths).size !== artifactPaths.length) {
+        throw new Error(`Conflict radar change ${name} has duplicate or conflicting artifact paths`);
+    }
+    const workspaceIdentityHash = record.workspaceIdentityHash === undefined || record.workspaceIdentityHash === null
+        ? null
+        : normalizedHash(record.workspaceIdentityHash, `Conflict radar change ${name} workspace identity hash`);
+    return {
+        name,
+        revision: record.revision,
+        specs,
+        declaredArtifacts,
+        workspaceIdentityHash,
+    };
+}
+function normalizeChanges(input) {
+    if (!Array.isArray(input))
+        throw new Error('Native conflict radar input must be an array');
+    if (input.length > NATIVE_CONFLICT_RADAR_LIMITS.maxChanges) {
+        throw new Error('Native conflict radar exceeds the change budget');
+    }
+    const changes = input
+        .map(normalizeChange)
+        .sort((left, right) => compareText(left.name, right.name));
+    if (new Set(changes.map((change) => change.name)).size !== changes.length) {
+        throw new Error('Native conflict radar contains duplicate change names');
+    }
+    const specCount = changes.reduce((total, change) => total + change.specs.length, 0);
+    if (specCount > NATIVE_CONFLICT_RADAR_LIMITS.maxTotalSpecs) {
+        throw new Error('Native conflict radar exceeds the total spec budget');
+    }
+    const artifactCount = changes.reduce((total, change) => total + change.declaredArtifacts.length, 0);
+    if (artifactCount > NATIVE_CONFLICT_RADAR_LIMITS.maxTotalArtifacts) {
+        throw new Error('Native conflict radar exceeds the total declared artifact budget');
+    }
+    return changes;
+}
+function capabilitySignal(left, right) {
+    const sameCanonicalBase = left.baseHash !== null && left.baseHash === right.baseHash;
+    const certainty = left.operation === 'create' || right.operation === 'create' || sameCanonicalBase
+        ? 'definite-conflict'
+        : 'possible-overlap';
+    return {
+        kind: 'capability',
+        certainty,
+        capability: left.capability,
+        leftOperation: left.operation,
+        rightOperation: right.operation,
+        leftBaseHash: left.baseHash,
+        rightBaseHash: right.baseHash,
+    };
+}
+function artifactOverlap(left, right) {
+    const leftOwnsRight = left.kind === 'directory' &&
+        (right.path === left.path || right.path.startsWith(`${left.path}/`));
+    const rightOwnsLeft = right.kind === 'directory' &&
+        (left.path === right.path || left.path.startsWith(`${right.path}/`));
+    const sameFile = left.kind === 'file' && right.kind === 'file' && left.path === right.path;
+    if (!leftOwnsRight && !rightOwnsLeft && !sameFile)
+        return null;
+    return {
+        kind: 'artifact',
+        certainty: sameFile ? 'definite-conflict' : 'possible-overlap',
+        leftArtifact: left,
+        rightArtifact: right,
+    };
+}
+function workspaceRelationship(left, right) {
+    if (left.workspaceIdentityHash === null || right.workspaceIdentityHash === null)
+        return 'unknown';
+    return left.workspaceIdentityHash === right.workspaceIdentityHash ? 'same' : 'different';
+}
+function relationship(left, right) {
+    const visibleSignals = [];
+    const signalHasher = createHash('sha256').update(`${SIGNAL_SET_HASH_TAG}\n[`);
+    let signalCount = 0;
+    let hasDefiniteConflict = false;
+    const addSignal = (signal) => {
+        if (signalCount > 0)
+            signalHasher.update(',');
+        signalHasher.update(canonicalJson(signal));
+        signalCount += 1;
+        if (signal.certainty === 'definite-conflict')
+            hasDefiniteConflict = true;
+        if (visibleSignals.length < NATIVE_CONFLICT_RADAR_LIMITS.maxSignalsPerRelationship) {
+            visibleSignals.push(signal);
+        }
+    };
+    const rightSpecs = new Map(right.specs.map((spec) => [spec.capability, spec]));
+    for (const leftSpec of left.specs) {
+        const rightSpec = rightSpecs.get(leftSpec.capability);
+        if (rightSpec)
+            addSignal(capabilitySignal(leftSpec, rightSpec));
+    }
+    for (const leftArtifact of left.declaredArtifacts) {
+        for (const rightArtifact of right.declaredArtifacts) {
+            const signal = artifactOverlap(leftArtifact, rightArtifact);
+            if (signal)
+                addSignal(signal);
+        }
+    }
+    const classification = hasDefiniteConflict
+        ? 'definite-conflict'
+        : signalCount > 0
+            ? 'possible-overlap'
+            : 'disjoint';
+    signalHasher.update(']');
+    return {
+        left: left.name,
+        right: right.name,
+        classification,
+        workspaceRelationship: workspaceRelationship(left, right),
+        signalCount,
+        signalHash: signalHasher.digest('hex'),
+        signals: visibleSignals,
+        signalsTruncated: visibleSignals.length !== signalCount,
+    };
+}
+function classificationRank(value) {
+    if (value === 'definite-conflict')
+        return 0;
+    if (value === 'possible-overlap')
+        return 1;
+    return 2;
+}
+function compareRelationships(left, right) {
+    return (classificationRank(left.classification) - classificationRank(right.classification) ||
+        compareText(left.left, right.left) ||
+        compareText(left.right, right.right));
+}
+function snapshot(changes, allRelationships, relationships, radarHash) {
+    const counts = {
+        definiteConflict: allRelationships.filter(({ classification }) => classification === 'definite-conflict').length,
+        possibleOverlap: allRelationships.filter(({ classification }) => classification === 'possible-overlap').length,
+        disjoint: allRelationships.filter(({ classification }) => classification === 'disjoint').length,
+    };
+    return {
+        schema: NATIVE_CONFLICT_RADAR_SCHEMA,
+        workspaceIdentityAdvisoryOnly: true,
+        changeCount: changes.length,
+        relationshipCount: allRelationships.length,
+        counts,
+        relationships,
+        relationshipsTruncated: relationships.length !== allRelationships.length,
+        omittedRelationshipCount: allRelationships.length - relationships.length,
+        radarHash,
+    };
+}
+/**
+ * Compare already-visible changes from one physical Native root.
+ *
+ * Collection and filesystem identity stay outside this pure module. Workspace identity is an
+ * optional advisory projection and cannot change conflict classification.
+ */
+export function buildNativeConflictRadar(input) {
+    const changes = normalizeChanges(input);
+    const allRelationships = [];
+    for (let leftIndex = 0; leftIndex < changes.length; leftIndex += 1) {
+        for (let rightIndex = leftIndex + 1; rightIndex < changes.length; rightIndex += 1) {
+            allRelationships.push(relationship(changes[leftIndex], changes[rightIndex]));
+        }
+    }
+    allRelationships.sort(compareRelationships);
+    const hashRelationships = allRelationships.map((value) => ({
+        left: value.left,
+        right: value.right,
+        classification: value.classification,
+        workspaceRelationship: value.workspaceRelationship,
+        signalCount: value.signalCount,
+        signalHash: value.signalHash,
+    }));
+    const radarHash = canonicalHash(RADAR_HASH_TAG, { changes, relationships: hashRelationships });
+    let relationships = allRelationships
+        .slice(0, NATIVE_CONFLICT_RADAR_LIMITS.maxRelationships)
+        .map((value) => ({ ...value, signals: [...value.signals] }));
+    let result = snapshot(changes, allRelationships, relationships, radarHash);
+    while (relationships.length > 0 &&
+        byteLength(JSON.stringify(result)) > NATIVE_CONFLICT_RADAR_LIMITS.maxSerializedBytes) {
+        relationships = relationships.slice(0, -1);
+        result = snapshot(changes, allRelationships, relationships, radarHash);
+    }
+    if (byteLength(JSON.stringify(result)) > NATIVE_CONFLICT_RADAR_LIMITS.maxSerializedBytes) {
+        throw new Error('Native conflict radar summary exceeds its serialized output budget');
+    }
+    return result;
+}
+//# sourceMappingURL=native-conflict-radar.js.map

package/dist/domains/comet-native/native-conflict-radar.js.map

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

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

@@ -0,0 +1,12 @@
+import type { NativeArchiveConfirmation, NativeChangeState, NativeClarificationMode, NativeContinuation, NativeStructuredFinding } from './native-types.js';
+export declare function nativeContinuation(options: {
+    state: NativeChangeState;
+    findings?: readonly NativeStructuredFinding[];
+    archiveReady?: boolean;
+    evidenceRetreat?: boolean;
+    done?: boolean;
+    clarificationMode?: NativeClarificationMode;
+    archiveConfirmation?: NativeArchiveConfirmation;
+    archivePreflightHash?: string;
+}): NativeContinuation;
+//# sourceMappingURL=native-continuation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-continuation.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-continuation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAmB3B,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,kBAAkB,CAiMrB"}

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

@@ -0,0 +1,201 @@
+import { isNativeWorkspaceAdvisoryCode } from './native-workspace.js';
+const REPAIR_CODES = /^(?:run-|trajectory-|checkpoint-(?:missing|mismatch|invalid|progress-invalid)|transition-(?:incomplete|invalid))/u;
+function requiredPhaseInputs(state) {
+    if (state.phase === 'shape') {
+        return ['summary', 'shared-understanding-confirmation'];
+    }
+    if (state.phase === 'build') {
+        return state.approval === 'confirmed'
+            ? ['summary', 'artifact-or-no-code-reason']
+            : ['summary', 'artifact-or-no-code-reason', 'shared-understanding-confirmation'];
+    }
+    if (state.phase === 'verify')
+        return ['summary', 'verification-result', 'verification-report'];
+    return [];
+}
+export function nativeContinuation(options) {
+    const findings = options.findings ?? [];
+    const actionableFindings = findings.filter((finding) => !isNativeWorkspaceAdvisoryCode(finding.code));
+    const decision = actionableFindings.find((finding) => finding.requiresUserDecision);
+    const repair = actionableFindings.find((finding) => finding.repairCommand !== null || REPAIR_CODES.test(finding.code));
+    const stagnationStop = actionableFindings.find((finding) => finding.code === 'repair-stagnation-stop' ||
+        finding.code === 'repair-iteration-limit' ||
+        finding.code === 'repair-override-exhausted');
+    const requiredInputs = [
+        ...new Set(actionableFindings.map((finding) => finding.requiredAction)),
+    ].sort();
+    if (options.done) {
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: 'done',
+            action: 'none',
+            command: null,
+            requiresUserDecision: false,
+            requiredInputs: [],
+        };
+    }
+    if (decision) {
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: 'await-user',
+            action: 'work-phase',
+            command: null,
+            requiresUserDecision: true,
+            requiredInputs,
+        };
+    }
+    if (stagnationStop) {
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: 'blocked',
+            action: 'work-phase',
+            command: null,
+            requiresUserDecision: false,
+            requiredInputs: ['implementation-progress-or-repair-override'],
+        };
+    }
+    if (repair) {
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: 'blocked',
+            action: 'repair',
+            command: repair.repairCommand,
+            requiresUserDecision: false,
+            requiredInputs,
+        };
+    }
+    if (options.evidenceRetreat) {
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: 'continue',
+            action: 'advance-phase',
+            command: `comet native next ${options.state.name} --summary "<summary>"`,
+            requiresUserDecision: false,
+            requiredInputs: ['summary'],
+        };
+    }
+    if (options.state.phase === 'build' && options.state.verification_result === 'fail') {
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: 'continue',
+            action: 'work-phase',
+            command: null,
+            requiresUserDecision: false,
+            requiredInputs: ['repair-verification-gaps'],
+        };
+    }
+    if (actionableFindings.length > 0) {
+        if (options.state.phase === 'archive') {
+            return {
+                schema: 'comet.native.continuation.v1',
+                skill: 'comet-native',
+                change: options.state.name,
+                phase: options.state.phase,
+                revision: options.state.revision,
+                disposition: 'blocked',
+                action: 'none',
+                command: null,
+                requiresUserDecision: false,
+                requiredInputs,
+            };
+        }
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: 'continue',
+            action: 'work-phase',
+            command: null,
+            requiresUserDecision: false,
+            requiredInputs,
+        };
+    }
+    if (options.state.phase === 'archive') {
+        if (options.archiveReady && options.archivePreflightHash) {
+            if (!/^[a-f0-9]{64}$/u.test(options.archivePreflightHash)) {
+                throw new Error('Native Archive continuation preflight must be a SHA-256 hash');
+            }
+            if (options.archiveConfirmation === 'required') {
+                return {
+                    schema: 'comet.native.continuation.v1',
+                    skill: 'comet-native',
+                    change: options.state.name,
+                    phase: options.state.phase,
+                    revision: options.state.revision,
+                    disposition: 'await-user',
+                    action: 'archive',
+                    command: null,
+                    requiresUserDecision: true,
+                    requiredInputs: ['archive-confirmation'],
+                };
+            }
+            return {
+                schema: 'comet.native.continuation.v1',
+                skill: 'comet-native',
+                change: options.state.name,
+                phase: options.state.phase,
+                revision: options.state.revision,
+                disposition: 'continue',
+                action: 'archive',
+                command: `comet native archive ${options.state.name} --expect-preflight ${options.archivePreflightHash}`,
+                requiresUserDecision: false,
+                requiredInputs: [],
+            };
+        }
+        return {
+            schema: 'comet.native.continuation.v1',
+            skill: 'comet-native',
+            change: options.state.name,
+            phase: options.state.phase,
+            revision: options.state.revision,
+            disposition: options.archiveReady ? 'continue' : 'blocked',
+            action: options.archiveReady ? 'archive' : 'none',
+            command: options.archiveReady ? `comet native archive ${options.state.name} --dry-run` : null,
+            requiresUserDecision: false,
+            requiredInputs: options.archiveReady ? [] : ['archive-readiness'],
+        };
+    }
+    const confirmationSuffix = options.state.phase === 'shape' ||
+        (options.state.phase === 'build' && options.state.approval !== 'confirmed')
+        ? ' --confirmed'
+        : '';
+    return {
+        schema: 'comet.native.continuation.v1',
+        skill: 'comet-native',
+        change: options.state.name,
+        phase: options.state.phase,
+        revision: options.state.revision,
+        disposition: 'continue',
+        action: 'advance-phase',
+        command: `comet native next ${options.state.name} --summary "<summary>"${confirmationSuffix}`,
+        requiresUserDecision: false,
+        requiredInputs: requiredPhaseInputs(options.state),
+    };
+}
+//# sourceMappingURL=native-continuation.js.map

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

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

package/dist/domains/comet-native/native-contract-files.d.ts

@@ -0,0 +1,24 @@
+import { type NativeContractSnapshot } from './native-contract.js';
+import type { NativeSpecChange } from './native-types.js';
+export declare const NATIVE_CONTRACT_FILE_LIMITS: {
+    readonly maxSpecs: 64;
+    readonly maxFileBytes: number;
+    readonly maxTotalBytes: number;
+};
+export interface NativeCollectedContract {
+    contract: NativeContractSnapshot;
+    sourceCount: number;
+    totalBytes: number;
+}
+/**
+ * Read the bounded change artifacts that form the user-visible contract.
+ *
+ * The collector returns hashes and derived acceptance only; source contents do not escape this
+ * seam. Canonical specs are represented by the frozen base hashes already in each spec change.
+ */
+export declare function collectNativeContractFiles(options: {
+    changeDir: string;
+    briefRef: string;
+    specChanges: readonly NativeSpecChange[];
+}): Promise<NativeCollectedContract>;
+//# sourceMappingURL=native-contract-files.d.ts.map

package/dist/domains/comet-native/native-contract-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-contract-files.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-contract-files.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC1C,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAmDnC"}