@rpamis/comet 0.4.0-beta.6 → 0.4.0-beta.8

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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI1E,MAAM,CAAC,MAAM,4BAA4B,GAAG,gCAAyC,CAAC;AAEtF,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,CAAC;IACxD,UAAU,EAAE,EAAE;IACd,iBAAiB,EAAE,EAAE;IACrB,qBAAqB,EAAE,GAAG;IAC1B,aAAa,EAAE,GAAG;IAClB,iBAAiB,EAAE,KAAK;IACxB,yBAAyB,EAAE,CAAC;IAC5B,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,EAAE,GAAG,KAAK;IAC9B,YAAY,EAAE,GAAG;IACjB,kBAAkB,EAAE,GAAG;IACvB,oBAAoB,EAAE,GAAG;CAC1B,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,gCAAgC,CAAC;AACxD,MAAM,mBAAmB,GAAG,wCAAwC,CAAC;AACrE,MAAM,YAAY,GAAG,iBAAiB,CAAC;AACvC,MAAM,YAAY,GAAG,kCAAkC,CAAC;AACxD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM;IACN,UAAU;IACV,OAAO;IACP,mBAAmB;IACnB,uBAAuB;CACxB,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AACnE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AA6EhD,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,IAAyB,EAAE,KAAa;IAC5E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa,EAAE,QAAgB;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qCAAqC,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,KAAa;IAC1D,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,oBAAoB,CAAC,CAAC;IAC/F,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,IACE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC;QACvC,CAAC,CAAC;QACF,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QACjC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnC,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,GAAG;QAClB,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EACvB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6CAA6C,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,yBAAyB,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAsD,EAAE,KAAa;IAC1F,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,WAAW,CAC5B,MAAM,CAAC,UAAU,EACjB,GAAG,KAAK,aAAa,EACrB,4BAA4B,CAAC,kBAAkB,CAChD,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;IACtF,IACE,MAAM,CAAC,SAAS,KAAK,QAAQ;QAC7B,MAAM,CAAC,SAAS,KAAK,SAAS;QAC9B,MAAM,CAAC,SAAS,KAAK,QAAQ,EAC7B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,uBAAuB,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,KAAK,IAAI;QACtB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,KAAK,sBAAsB,CAAC,CAAC;IACtE,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,uDAAuD,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,SAAS,2CAA2C,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ,EAA2B,CAAC;AACxF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA6B,EAAE,KAAa;IACrE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kBAAkB,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,eAAe,CAAC,KAAqC,EAAE,KAAa;IAC3E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,yBAAyB,KAAK,EAAE,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,WAAW,CACtB,MAAM,CAAC,IAAI,EACX,yBAAyB,KAAK,OAAO,EACrC,4BAA4B,CAAC,YAAY,CAC1C,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,kBAAkB,CAAC,CAAC;IAChG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAK,MAAM,CAAC,QAAmB,GAAG,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,2CAA2C,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,yBAAyB,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,4BAA4B,CAAC,iBAAiB,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,0BAA0B,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,sCAAsC,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,4BAA4B,CAAC,qBAAqB,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,uCAAuC,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,KAAK,GAAI,MAAM,CAAC,KAAiD;SACpE,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CACvB,aAAa,CAAC,IAAI,EAAE,yBAAyB,IAAI,SAAS,SAAS,EAAE,CAAC,CACvE;SACA,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACzE,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,6BAA6B,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,iBAAiB,GAAI,MAAM,CAAC,iBAA8C;SAC7E,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,CAC/B,iBAAiB,CAAC,QAAQ,EAAE,yBAAyB,IAAI,aAAa,aAAa,EAAE,CAAC,CACvF;SACA,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1F,CAAC;IACJ,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,8CAA8C,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,qBAAqB,GACzB,MAAM,CAAC,qBAAqB,KAAK,SAAS,IAAI,MAAM,CAAC,qBAAqB,KAAK,IAAI;QACjF,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,cAAc,CACZ,MAAM,CAAC,qBAAqB,EAC5B,yBAAyB,IAAI,0BAA0B,CACxD,CAAC;IACR,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,QAAkB;QACnC,KAAK;QACL,iBAAiB;QACjB,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAgD;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC3F,IAAI,KAAK,CAAC,MAAM,GAAG,4BAA4B,CAAC,UAAU,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,OAAO,GAAG,KAAK;SAClB,GAAG,CAAC,eAAe,CAAC;SACpB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,SAAS,GAAG,4BAA4B,CAAC,aAAa,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAClC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAC1D,CAAC,CACF,CAAC;IACF,IAAI,aAAa,GAAG,4BAA4B,CAAC,iBAAiB,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CACvB,IAAoB,EACpB,KAAqB;IAErB,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC;IACrF,MAAM,SAAS,GACb,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,iBAAiB;QAC9E,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,kBAAkB,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,SAAS;QAC7B,cAAc,EAAE,KAAK,CAAC,SAAS;QAC/B,YAAY,EAAE,IAAI,CAAC,QAAQ;QAC3B,aAAa,EAAE,KAAK,CAAC,QAAQ;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,IAA4B,EAC5B,KAA6B;IAE7B,MAAM,aAAa,GACjB,IAAI,CAAC,IAAI,KAAK,WAAW;QACzB,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,GACjB,KAAK,CAAC,IAAI,KAAK,WAAW;QAC1B,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;IAC3F,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB;QAC9D,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAsB,EACtB,KAAuB;IAEvB,IAAI,IAAI,CAAC,qBAAqB,KAAK,IAAI,IAAI,KAAK,CAAC,qBAAqB,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClG,OAAO,IAAI,CAAC,qBAAqB,KAAK,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;AAC3F,CAAC;AAED,SAAS,YAAY,CAAC,IAAsB,EAAE,KAAuB;IACnE,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,mBAAmB,KAAK,CAAC,CAAC;IAC9E,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,MAAM,SAAS,GAAG,CAAC,MAA4B,EAAE,EAAE;QACjD,IAAI,WAAW,GAAG,CAAC;YAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9C,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,WAAW,IAAI,CAAC,CAAC;QACjB,IAAI,MAAM,CAAC,SAAS,KAAK,mBAAmB;YAAE,mBAAmB,GAAG,IAAI,CAAC;QACzE,IAAI,cAAc,CAAC,MAAM,GAAG,4BAA4B,CAAC,yBAAyB,EAAE,CAAC;YACnF,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/E,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,SAAS;YAAE,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClD,KAAK,MAAM,aAAa,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAC5D,IAAI,MAAM;gBAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAAG,mBAAmB;QACxC,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,WAAW,GAAG,CAAC;YACf,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,UAAU,CAAC;IACjB,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,cAAc;QACd,qBAAqB,EAAE,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC;QACzD,WAAW;QACX,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;QACtC,OAAO,EAAE,cAAc;QACvB,gBAAgB,EAAE,cAAc,CAAC,MAAM,KAAK,WAAW;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAmC;IAC7D,IAAI,KAAK,KAAK,mBAAmB;QAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,kBAAkB;QAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAsB,EAAE,KAAuB;IAC3E,OAAO,CACL,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,cAAc,CAAC;QAClF,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CACf,OAA2B,EAC3B,gBAAoC,EACpC,aAA2C,EAC3C,SAAiB;IAEjB,MAAM,MAAM,GAAG;QACb,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,CACvC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,cAAc,KAAK,mBAAmB,CAC/D,CAAC,MAAM;QACR,eAAe,EAAE,gBAAgB,CAAC,MAAM,CACtC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,cAAc,KAAK,kBAAkB,CAC9D,CAAC,MAAM;QACR,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC,MAAM;KAChG,CAAC;IACF,OAAO;QACL,MAAM,EAAE,4BAA4B;QACpC,6BAA6B,EAAE,IAAI;QACnC,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,iBAAiB,EAAE,gBAAgB,CAAC,MAAM;QAC1C,MAAM;QACN,aAAa;QACb,sBAAsB,EAAE,aAAa,CAAC,MAAM,KAAK,gBAAgB,CAAC,MAAM;QACxE,wBAAwB,EAAE,gBAAgB,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM;QACxE,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAgD;IAEhD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,gBAAgB,GAAuB,EAAE,CAAC;IAChD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACnE,KAAK,IAAI,UAAU,GAAG,SAAS,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,UAAU,IAAI,CAAC,EAAE,CAAC;YAClF,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,gBAAgB,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC5C,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;QAClD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC,CAAC;IACJ,MAAM,SAAS,GAAG,aAAa,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/F,IAAI,aAAa,GAAG,gBAAgB;SACjC,KAAK,CAAC,CAAC,EAAE,4BAA4B,CAAC,gBAAgB,CAAC;SACvD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,IAAI,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAC3E,OACE,aAAa,CAAC,MAAM,GAAG,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,4BAA4B,CAAC,kBAAkB,EACpF,CAAC;QACD,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,4BAA4B,CAAC,kBAAkB,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { NativeChangeState, NativeContinuation, NativeStructuredFinding } from './native-types.js';
+export declare function nativeContinuation(options: {
+    state: NativeChangeState;
+    findings?: readonly NativeStructuredFinding[];
+    archiveReady?: boolean;
+    evidenceRetreat?: boolean;
+    done?: boolean;
+}): 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,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAa3B,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;CAChB,GAAG,kBAAkB,CA4IrB"}

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

@@ -0,0 +1,146 @@
+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'];
+    if (state.phase === 'build')
+        return ['summary', 'artifact-or-no-code-reason'];
+    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');
+    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 (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') {
+        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'],
+        };
+    }
+    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: 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"}

package/dist/domains/comet-native/native-contract-files.js

@@ -0,0 +1,66 @@
+import { DEFAULT_NATIVE_ARTIFACT_MAX_BYTES, readNativeBoundedTextFile, } from './native-bounded-file.js';
+import { buildNativeContractSnapshot, } from './native-contract.js';
+export const NATIVE_CONTRACT_FILE_LIMITS = {
+    maxSpecs: 64,
+    maxFileBytes: DEFAULT_NATIVE_ARTIFACT_MAX_BYTES,
+    maxTotalBytes: 4 * 1024 * 1024,
+};
+/**
+ * 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 async function collectNativeContractFiles(options) {
+    if (options.specChanges.length > NATIVE_CONTRACT_FILE_LIMITS.maxSpecs) {
+        throw new Error('Native contract exceeds its spec-count budget');
+    }
+    const brief = await readNativeBoundedTextFile({
+        root: options.changeDir,
+        ref: options.briefRef,
+        maxBytes: NATIVE_CONTRACT_FILE_LIMITS.maxFileBytes,
+    });
+    let totalBytes = brief.size;
+    const specs = [];
+    for (const change of options.specChanges) {
+        if (change.operation === 'remove') {
+            specs.push({
+                capability: change.capability,
+                operation: 'remove',
+                source: null,
+                baseHash: change.base_hash,
+                markdown: null,
+            });
+            continue;
+        }
+        if (!change.source) {
+            throw new Error(`Native contract ${change.capability} has no proposed spec source`);
+        }
+        const source = await readNativeBoundedTextFile({
+            root: options.changeDir,
+            ref: change.source,
+            maxBytes: NATIVE_CONTRACT_FILE_LIMITS.maxFileBytes,
+        });
+        totalBytes += source.size;
+        if (totalBytes > NATIVE_CONTRACT_FILE_LIMITS.maxTotalBytes) {
+            throw new Error('Native contract exceeds its total byte budget');
+        }
+        specs.push({
+            capability: change.capability,
+            operation: change.operation,
+            source: source.ref,
+            baseHash: change.base_hash,
+            markdown: source.text,
+        });
+    }
+    return {
+        contract: buildNativeContractSnapshot({
+            briefSource: brief.ref,
+            briefMarkdown: brief.text,
+            specs,
+        }),
+        sourceCount: specs.filter((spec) => spec.source !== null).length + 1,
+        totalBytes,
+    };
+}
+//# sourceMappingURL=native-contract-files.js.map

package/dist/domains/comet-native/native-contract-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-contract-files.js","sourceRoot":"","sources":["../../../domains/comet-native/native-contract-files.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2BAA2B,GAG5B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,iCAAiC;IAC/C,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;CACtB,CAAC;AAQX;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAIhD;IACC,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,2BAA2B,CAAC,QAAQ,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC;QAC5C,IAAI,EAAE,OAAO,CAAC,SAAS;QACvB,GAAG,EAAE,OAAO,CAAC,QAAQ;QACrB,QAAQ,EAAE,2BAA2B,CAAC,YAAY;KACnD,CAAC,CAAC;IACH,IAAI,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;IAC5B,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC;gBACT,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,MAAM,CAAC,SAAS;gBAC1B,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,UAAU,8BAA8B,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;YAC7C,IAAI,EAAE,OAAO,CAAC,SAAS;YACvB,GAAG,EAAE,MAAM,CAAC,MAAM;YAClB,QAAQ,EAAE,2BAA2B,CAAC,YAAY;SACnD,CAAC,CAAC;QACH,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC;QAC1B,IAAI,UAAU,GAAG,2BAA2B,CAAC,aAAa,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC;YACT,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,GAAG;YAClB,QAAQ,EAAE,MAAM,CAAC,SAAS;YAC1B,QAAQ,EAAE,MAAM,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,2BAA2B,CAAC;YACpC,WAAW,EAAE,KAAK,CAAC,GAAG;YACtB,aAAa,EAAE,KAAK,CAAC,IAAI;YACzB,KAAK;SACN,CAAC;QACF,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QACpE,UAAU;KACX,CAAC;AACJ,CAAC"}