@shapeshift-labs/frontier-lang-compiler 0.2.147 → 0.2.149

package/dist/js-ts-safe-merge-constants.js

@@ -19,6 +19,7 @@ export const JsTsSafeMergeConflictCodes = Object.freeze({
   malformedSyntax: 'malformed-syntax',
   sideEffectImportReorder: 'side-effect-import-reorder',
   topLevelOrderChanged: 'top-level-order-changed',
+  topLevelRenamePublicExportContract: 'top-level-rename-public-export-contract',
   changedExistingDeclaration: 'changed-existing-declaration',
   typeAliasConflict: 'type-alias-conflict',
   importShapeChanged: 'import-shape-changed',

package/dist/js-ts-safe-merge-independent-deletion-plan.js

@@ -50,6 +50,9 @@ function createIndependentTopLevelDeletionPlan(input, topLevelResult) {
   if (deletedEntry.kind !== 'declaration' || deletedEntry.declarationInfo?.exported === true) {
     return { ok: false, reasonCodes: ['exported-or-unsupported-top-level-deletion'] };
   }
+  if (isUnsupportedTopLevelDeletion(deletedEntry)) {
+    return { ok: false, reasonCodes: ['unsupported-top-level-deletion-declaration'] };
+  }
 
   const expectedWorkerKeys = base.entries
     .filter((entry) => entry.key !== deletedEntry.key)
@@ -127,6 +130,11 @@ function entriesByKey(entries) {
   return new Map(entries.map((entry) => [entry.key, entry]));
 }
 
+function isUnsupportedTopLevelDeletion(entry) {
+  if (entry.declarationInfo?.declarationKind === 'module') return true;
+  return /^\s*(?:export\s+)?declare\b/.test(entry.text ?? '');
+}
+
 function sameStringList(left, right) {
   return left.length === right.length && left.every((value, index) => value === right[index]);
 }

package/dist/js-ts-safe-merge-semantic-edit-already-applied.js

@@ -58,6 +58,7 @@ function isProjectedDeleteAlreadyAppliedReplay(input) {
     .filter((edit) => edit.editKind === 'delete')
     .map((edit) => edit.operationId));
   const staleDeletes = edits.filter(isProjectedDeleteMissingAnchor);
+  if (hasUnsafeProjectedDeleteCompanions(input, staleDeletes)) return false;
   return staleDeletes.length > 0
     && edits.every((edit) => edit.status === 'already-applied' || isProjectedDeleteMissingAnchor(edit))
     && staleDeletes.every((edit) => appliedDeleteIds.has(edit.operationId) && projectionDeleteIds.has(edit.operationId));
@@ -79,4 +80,48 @@ function alreadyAppliedDeleteEdit(edit) {
   };
 }
 
+function hasUnsafeProjectedDeleteCompanions(input, staleDeletes) {
+  const projectionEdits = input.projection?.edits ?? [];
+  if (!projectionEdits.length || !staleDeletes.length) return false;
+  const projectionDeleteById = new Map(projectionEdits
+    .filter((edit) => edit.editKind === 'delete')
+    .map((edit) => [edit.operationId, edit]));
+  for (const staleDelete of staleDeletes) {
+    const projectedDelete = projectionDeleteById.get(staleDelete.operationId);
+    const scope = memberBodyDeleteScope(projectedDelete ?? staleDelete);
+    if (!scope) continue;
+    const companions = projectionEdits.filter((edit) => (
+      edit.operationId !== staleDelete.operationId
+        && edit.editKind !== 'delete'
+        && symbolContainerName(edit.symbolName) === scope.container
+    ));
+    if (!companions.length) return true;
+    const bodyInserts = companions.filter((edit) => (
+      edit.editKind === 'insert'
+        && edit.regionKind === scope.regionKind
+        && edit.symbolKind === scope.symbolKind
+    ));
+    if (bodyInserts.length === 0) return true;
+    if (companions.some((edit) => !bodyInserts.includes(edit))) return true;
+  }
+  return false;
+}
+
+function memberBodyDeleteScope(edit) {
+  if (edit?.editKind !== 'delete' || edit?.regionKind !== 'body') return undefined;
+  const container = symbolContainerName(edit.symbolName);
+  if (!container) return undefined;
+  return {
+    container,
+    regionKind: edit.regionKind,
+    symbolKind: edit.symbolKind
+  };
+}
+
+function symbolContainerName(symbolName) {
+  const normalized = String(symbolName ?? '').split(':controlFlow:')[0];
+  const separator = normalized.lastIndexOf('.');
+  return separator === -1 ? undefined : normalized.slice(0, separator);
+}
+
 export { normalizeAlreadyAppliedDeleteReplay };

package/dist/js-ts-safe-merge-semantic-edit-artifacts.js

@@ -0,0 +1,111 @@
+import { hashSemanticValue } from '@shapeshift-labs/frontier-lang-kernel';
+import { semanticFallbackPhase } from './js-ts-safe-merge-semantic-edit-fallback-utils.js';
+import { idFragment, uniqueStrings } from './native-import-utils.js';
+
+function semanticEditArtifacts(input) {
+  const reasonCodes = semanticEditArtifactReasonCodes(input);
+  const status = reasonCodes.length ? 'blocked' : 'verified';
+  const core = {
+    kind: 'frontier.lang.jsTsSafeMergeSemanticArtifacts',
+    version: 1,
+    schema: 'frontier.lang.jsTsSafeMergeSemanticArtifacts.v1',
+    id: `js_ts_safe_merge_semantic_edit_artifacts_${idFragment(input.id)}`,
+    sourcePath: input.sourcePath,
+    language: input.language,
+    status,
+    script: input.script,
+    projection: input.projection,
+    replay: input.replay,
+    alreadyAppliedReplay: input.alreadyAppliedReplay,
+    admission: {
+      status: status === 'verified' ? 'auto-merge-candidate' : 'blocked',
+      action: status === 'verified' ? 'apply' : 'human-review',
+      reviewRequired: status !== 'verified',
+      autoApplyCandidate: status === 'verified',
+      autoMergeClaim: false,
+      semanticEquivalenceClaim: false,
+      reasonCodes
+    },
+    summary: {
+      operations: input.script.summary.operations,
+      edits: input.projection.edits.length,
+      replayStatus: input.replay.status,
+      alreadyAppliedReplayStatus: input.alreadyAppliedReplay.status,
+      projectedSourceMatchesMerged: input.projection.sourceText === input.replay.outputSourceText,
+      replayOutputMatchesMerged: input.replay.outputSourceText === input.projection.sourceText
+    },
+    evidence: [{
+      id: `evidence_${idFragment(input.id)}_js_ts_semantic_edit_replay`,
+      kind: 'js-ts-semantic-edit-replay',
+      status: status === 'verified' ? 'passed' : 'needs-review',
+      path: input.sourcePath,
+      summary: status === 'verified'
+        ? `JS/TS semantic edit replay verified ${input.script.summary.operations} operation(s).`
+        : `JS/TS semantic edit replay requires review: ${reasonCodes.join(', ')}.`
+    }],
+    metadata: {
+      autoMergeClaim: false,
+      semanticEquivalenceClaim: false,
+      source: input.stagedFallback ? semanticFallbackPhase(input.stagedFallback) : 'js-ts-semantic-edit-fallback',
+      originalReasonCodes: input.topLevelResult.admission?.reasonCodes ?? [],
+      stagedTopLevelSummary: input.stagedFallback?.stagedTopLevelResult?.summary,
+      neutralization: input.stagedFallback?.neutralization?.summary
+    }
+  };
+  return { ...core, hash: hashSemanticValue(core) };
+}
+
+function blockedSemanticEditArtifacts(input, topLevelResult, reasonCodes, error) {
+  const id = String(input.id ?? topLevelResult.id ?? 'js_ts_safe_merge');
+  const core = {
+    kind: 'frontier.lang.jsTsSafeMergeSemanticArtifacts',
+    version: 1,
+    schema: 'frontier.lang.jsTsSafeMergeSemanticArtifacts.v1',
+    id: `js_ts_safe_merge_semantic_edit_artifacts_${idFragment(id)}`,
+    sourcePath: input.sourcePath ?? topLevelResult.sourcePath,
+    language: input.language ?? topLevelResult.language ?? 'typescript',
+    status: 'blocked',
+    admission: {
+      status: 'blocked',
+      action: 'human-review',
+      reviewRequired: true,
+      autoApplyCandidate: false,
+      autoMergeClaim: false,
+      semanticEquivalenceClaim: false,
+      reasonCodes
+    },
+    summary: {
+      operations: 0,
+      edits: 0,
+      replayStatus: 'blocked',
+      alreadyAppliedReplayStatus: 'blocked',
+      projectedSourceMatchesMerged: false,
+      replayOutputMatchesMerged: false
+    },
+    metadata: {
+      source: 'js-ts-semantic-edit-fallback',
+      error: error?.message
+    }
+  };
+  return { ...core, hash: hashSemanticValue(core) };
+}
+
+function semanticEditArtifactReasonCodes(input) {
+  const scriptReady = input.script.admission.status === 'auto-merge-candidate';
+  const projectionReady = input.projection.status === 'projected';
+  const replayReady = input.replay.status === 'accepted-clean';
+  const alreadyAppliedReady = input.alreadyAppliedReplay.status === 'already-applied';
+  return uniqueStrings([
+    scriptReady ? undefined : `semantic-edit-script-${input.script.admission.status}`,
+    projectionReady ? undefined : `semantic-edit-projection-${input.projection.status}`,
+    replayReady ? undefined : `semantic-edit-replay-${input.replay.status}`,
+    input.replay.outputSourceText !== input.projection.sourceText ? 'semantic-edit-replay-output-mismatch' : undefined,
+    alreadyAppliedReady ? undefined : `semantic-edit-already-applied-${input.alreadyAppliedReplay.status}`,
+    ...(scriptReady ? [] : input.script.admission.reasonCodes),
+    ...(projectionReady ? [] : input.projection.admission.reasonCodes),
+    ...(replayReady ? [] : input.replay.admission.reasonCodes),
+    ...(alreadyAppliedReady ? [] : input.alreadyAppliedReplay.admission.reasonCodes)
+  ]);
+}
+
+export { blockedSemanticEditArtifacts, semanticEditArtifacts };

package/dist/js-ts-safe-merge-semantic-edit-fallback-utils.js

@@ -33,7 +33,18 @@ function semanticFallbackPhase(fallback) {
     : 'staged-top-level-semantic-edit-fallback';
 }
 
+function semanticFallbackCandidates(stagedFallback) {
+  if (!stagedFallback) return [undefined];
+  const headChanged = (stagedFallback.neutralization?.summary?.headChangedExistingDeclarations ?? 0) > 0;
+  const directFallback = stagedFallback.directProjectionHeadSourceText && (headChanged || stagedFallback.safeTopLevelChanges > 0)
+    ? { ...stagedFallback, projectionMode: 'direct' }
+    : undefined;
+  if (headChanged) return directFallback ? [directFallback, undefined] : [undefined];
+  return directFallback ? [stagedFallback, directFallback, undefined] : [stagedFallback];
+}
+
 export {
+  semanticFallbackCandidates,
   semanticFallbackChangedExistingDeclarations,
   semanticFallbackConflictCode,
   semanticFallbackPhase,

package/dist/js-ts-safe-merge-semantic-edit-fallback.js

@@ -1,11 +1,12 @@
-import { hashSemanticValue } from '@shapeshift-labs/frontier-lang-kernel';
 import { createSemanticEditScript } from './internal/index-impl/semanticEditScripts.js';
 import { projectSemanticEditScriptToSource } from './internal/index-impl/projectSemanticEditScriptToSource.js';
 import { replaySemanticEditProjection } from './internal/index-impl/replaySemanticEditProjection.js';
 import { JsTsSafeMergeStatuses } from './js-ts-safe-merge-constants.js';
 import { independentTopLevelDeletionFallbackResult } from './js-ts-safe-merge-independent-deletion-fallback.js';
 import { normalizeAlreadyAppliedDeleteReplay } from './js-ts-safe-merge-semantic-edit-already-applied.js';
+import { blockedSemanticEditArtifacts, semanticEditArtifacts } from './js-ts-safe-merge-semantic-edit-artifacts.js';
 import {
+  semanticFallbackCandidates,
   semanticFallbackChangedExistingDeclarations,
   semanticFallbackConflictCode,
   semanticFallbackPhase,
@@ -19,11 +20,23 @@ import {
 } from './js-ts-safe-merge-staged-declaration-replay.js';
 import { createStagedTopLevelSemanticFallback } from './js-ts-safe-merge-staged-top-level-fallback.js';
 import { createSourceShapeSemanticFallbackResult } from './js-ts-safe-merge-source-shape-fallbacks.js';
-import { idFragment, uniqueStrings } from './native-import-utils.js';
+import { analyzeTopLevelRenameAdmission } from './js-ts-safe-merge-top-level-rename-fallback.js';
+import { topLevelRenameBlockedResult } from './js-ts-safe-merge-top-level-rename-result.js';
 
 function semanticEditFallbackResult(input, topLevelResult) {
   const independentDeletionResult = independentTopLevelDeletionFallbackResult(input, topLevelResult);
   if (independentDeletionResult) return independentDeletionResult;
+  const topLevelRenameAdmission = analyzeTopLevelRenameAdmission(input, topLevelResult);
+  if (topLevelRenameAdmission?.status === 'blocked') {
+    return topLevelRenameBlockedResult(input, topLevelResult, topLevelRenameAdmission);
+  }
+  if (topLevelRenameAdmission?.status === 'candidate') {
+    const artifacts = createSemanticEditFallbackArtifacts(input, topLevelResult);
+    if (artifacts.status !== 'verified') {
+      return semanticEditFallbackBlockedResult(input, topLevelResult, artifacts, topLevelRenameAdmission);
+    }
+    return semanticEditFallbackMergedResult(input, topLevelResult, undefined, artifacts, topLevelRenameAdmission);
+  }
   if (!shouldTrySemanticEditFallback(topLevelResult)) return topLevelResult;
   const stagedFallback = createStagedTopLevelSemanticFallback(input, topLevelResult);
   const candidates = semanticFallbackCandidates(stagedFallback);
@@ -40,6 +53,10 @@ function semanticEditFallbackResult(input, topLevelResult) {
     if (sourceShapeResult) return sourceShapeResult;
     return semanticEditFallbackBlockedResult(input, topLevelResult, artifacts);
   }
+  return semanticEditFallbackMergedResult(input, topLevelResult, selectedFallback, artifacts);
+}
+
+function semanticEditFallbackMergedResult(input, topLevelResult, selectedFallback, artifacts, topLevelRenameAdmission) {
   const resultBase = selectedFallback?.stagedTopLevelResult ?? topLevelResult;
   const mergedSourceText = artifacts.projection.sourceText;
   const gates = semanticEditGates(artifacts);
@@ -68,32 +85,26 @@ function semanticEditFallbackResult(input, topLevelResult) {
       semanticEditOperations: artifacts.script.summary.operations,
       semanticEditAppliedOperations: artifacts.replay.summary.applied,
       semanticEditReplayStatus: artifacts.replay.status,
+      topLevelDeclarationRenames: topLevelRenameAdmission ? 1 : resultBase.summary?.topLevelDeclarationRenames,
       composedPhases: 2
     },
     metadata: {
       ...resultBase.metadata,
       composed: {
-        phase: semanticFallbackPhase(selectedFallback),
-        phases: selectedFallback ? ['top-level-neutralization', 'top-level-ledger', 'semantic-edit'] : ['top-level-ledger', 'semantic-edit'],
+        phase: topLevelRenameAdmission ? 'top-level-rename-semantic-edit-fallback' : semanticFallbackPhase(selectedFallback),
+        phases: topLevelRenameAdmission
+          ? ['top-level-rename-admission', 'semantic-edit']
+          : selectedFallback ? ['top-level-neutralization', 'top-level-ledger', 'semantic-edit'] : ['top-level-ledger', 'semantic-edit'],
         originalReasonCodes: topLevelResult.admission?.reasonCodes ?? [],
         stagedTopLevelSummary: selectedFallback?.stagedTopLevelResult?.summary,
-        neutralization: selectedFallback?.neutralization?.summary
+        neutralization: selectedFallback?.neutralization?.summary,
+        topLevelRenameAdmission: topLevelRenameAdmission?.summary
       }
     },
     semanticArtifacts: artifacts
   };
 }
 
-function semanticFallbackCandidates(stagedFallback) {
-  if (!stagedFallback) return [undefined];
-  const headChanged = (stagedFallback.neutralization?.summary?.headChangedExistingDeclarations ?? 0) > 0;
-  const directFallback = stagedFallback.directProjectionHeadSourceText && (headChanged || stagedFallback.safeTopLevelChanges > 0)
-    ? { ...stagedFallback, projectionMode: 'direct' }
-    : undefined;
-  if (headChanged) return directFallback ? [directFallback, undefined] : [undefined];
-  return directFallback ? [stagedFallback, directFallback, undefined] : [stagedFallback];
-}
-
 function createSemanticEditFallbackArtifacts(input, topLevelResult, stagedFallback) {
   try {
     const id = String(input.id ?? topLevelResult.id ?? 'js_ts_safe_merge');
@@ -166,112 +177,6 @@ function createSemanticEditFallbackArtifacts(input, topLevelResult, stagedFallba
   }
 }
 
-function semanticEditArtifacts(input) {
-  const reasonCodes = semanticEditArtifactReasonCodes(input);
-  const status = reasonCodes.length ? 'blocked' : 'verified';
-  const core = {
-    kind: 'frontier.lang.jsTsSafeMergeSemanticArtifacts',
-    version: 1,
-    schema: 'frontier.lang.jsTsSafeMergeSemanticArtifacts.v1',
-    id: `js_ts_safe_merge_semantic_edit_artifacts_${idFragment(input.id)}`,
-    sourcePath: input.sourcePath,
-    language: input.language,
-    status,
-    script: input.script,
-    projection: input.projection,
-    replay: input.replay,
-    alreadyAppliedReplay: input.alreadyAppliedReplay,
-    admission: {
-      status: status === 'verified' ? 'auto-merge-candidate' : 'blocked',
-      action: status === 'verified' ? 'apply' : 'human-review',
-      reviewRequired: status !== 'verified',
-      autoApplyCandidate: status === 'verified',
-      autoMergeClaim: false,
-      semanticEquivalenceClaim: false,
-      reasonCodes
-    },
-    summary: {
-      operations: input.script.summary.operations,
-      edits: input.projection.edits.length,
-      replayStatus: input.replay.status,
-      alreadyAppliedReplayStatus: input.alreadyAppliedReplay.status,
-      projectedSourceMatchesMerged: input.projection.sourceText === input.replay.outputSourceText,
-      replayOutputMatchesMerged: input.replay.outputSourceText === input.projection.sourceText
-    },
-    evidence: [{
-      id: `evidence_${idFragment(input.id)}_js_ts_semantic_edit_replay`,
-      kind: 'js-ts-semantic-edit-replay',
-      status: status === 'verified' ? 'passed' : 'needs-review',
-      path: input.sourcePath,
-      summary: status === 'verified'
-        ? `JS/TS semantic edit replay verified ${input.script.summary.operations} operation(s).`
-        : `JS/TS semantic edit replay requires review: ${reasonCodes.join(', ')}.`
-    }],
-    metadata: {
-      autoMergeClaim: false,
-      semanticEquivalenceClaim: false,
-      source: input.stagedFallback ? semanticFallbackPhase(input.stagedFallback) : 'js-ts-semantic-edit-fallback',
-      originalReasonCodes: input.topLevelResult.admission?.reasonCodes ?? [],
-      stagedTopLevelSummary: input.stagedFallback?.stagedTopLevelResult?.summary,
-      neutralization: input.stagedFallback?.neutralization?.summary
-    }
-  };
-  return { ...core, hash: hashSemanticValue(core) };
-}
-
-function semanticEditArtifactReasonCodes(input) {
-  const scriptReady = input.script.admission.status === 'auto-merge-candidate';
-  const projectionReady = input.projection.status === 'projected';
-  const replayReady = input.replay.status === 'accepted-clean';
-  const alreadyAppliedReady = input.alreadyAppliedReplay.status === 'already-applied';
-  return uniqueStrings([
-    scriptReady ? undefined : `semantic-edit-script-${input.script.admission.status}`,
-    projectionReady ? undefined : `semantic-edit-projection-${input.projection.status}`,
-    replayReady ? undefined : `semantic-edit-replay-${input.replay.status}`,
-    input.replay.outputSourceText !== input.projection.sourceText ? 'semantic-edit-replay-output-mismatch' : undefined,
-    alreadyAppliedReady ? undefined : `semantic-edit-already-applied-${input.alreadyAppliedReplay.status}`,
-    ...(scriptReady ? [] : input.script.admission.reasonCodes),
-    ...(projectionReady ? [] : input.projection.admission.reasonCodes),
-    ...(replayReady ? [] : input.replay.admission.reasonCodes),
-    ...(alreadyAppliedReady ? [] : input.alreadyAppliedReplay.admission.reasonCodes)
-  ]);
-}
-
-function blockedSemanticEditArtifacts(input, topLevelResult, reasonCodes, error) {
-  const id = String(input.id ?? topLevelResult.id ?? 'js_ts_safe_merge');
-  const core = {
-    kind: 'frontier.lang.jsTsSafeMergeSemanticArtifacts',
-    version: 1,
-    schema: 'frontier.lang.jsTsSafeMergeSemanticArtifacts.v1',
-    id: `js_ts_safe_merge_semantic_edit_artifacts_${idFragment(id)}`,
-    sourcePath: input.sourcePath ?? topLevelResult.sourcePath,
-    language: input.language ?? topLevelResult.language ?? 'typescript',
-    status: 'blocked',
-    admission: {
-      status: 'blocked',
-      action: 'human-review',
-      reviewRequired: true,
-      autoApplyCandidate: false,
-      autoMergeClaim: false,
-      semanticEquivalenceClaim: false,
-      reasonCodes
-    },
-    summary: {
-      operations: 0,
-      edits: 0,
-      replayStatus: 'blocked',
-      alreadyAppliedReplayStatus: 'blocked',
-      projectedSourceMatchesMerged: false,
-      replayOutputMatchesMerged: false
-    },
-    metadata: {
-      source: 'js-ts-semantic-edit-fallback',
-      error: error?.message
-    }
-  };
-  return { ...core, hash: hashSemanticValue(core) };
-}
-
 function semanticEditFallbackBlockedResult(input, topLevelResult, artifacts) {
   const reasonCodes = artifacts.admission.reasonCodes.length
     ? artifacts.admission.reasonCodes

package/dist/js-ts-safe-merge-top-level-rename-fallback.js

@@ -0,0 +1,149 @@
+import { JsTsSafeMergeConflictCodes } from './js-ts-safe-merge-constants.js';
+import { createMergeContext, sameStatementText } from './js-ts-safe-merge-context.js';
+import { scanJsTsTopLevelLedger, validateLedgerUniqueness } from './js-ts-safe-merge-ledger.js';
+import { uniqueStrings } from './native-import-utils.js';
+
+const supportedRenameDeclarationKinds = new Set(['function', 'class', 'type']);
+
+function analyzeTopLevelRenameAdmission(input, topLevelResult) {
+  const originalReasonCodes = topLevelResult?.admission?.reasonCodes ?? [];
+  if (!originalReasonCodes.includes(JsTsSafeMergeConflictCodes.topLevelOrderChanged)) return undefined;
+  if (typeof input.baseSourceText !== 'string'
+    || typeof input.workerSourceText !== 'string'
+    || typeof input.headSourceText !== 'string') {
+    return undefined;
+  }
+
+  const context = createMergeContext(input);
+  const base = scanJsTsTopLevelLedger(input.baseSourceText, 'base', context);
+  const worker = scanJsTsTopLevelLedger(input.workerSourceText, 'worker', context);
+  const head = scanJsTsTopLevelLedger(input.headSourceText, 'head', context);
+  if (!context.conflicts.length) {
+    validateLedgerUniqueness(base, context);
+    validateLedgerUniqueness(worker, context);
+    validateLedgerUniqueness(head, context);
+  }
+  if (context.conflicts.length) return undefined;
+
+  const candidate = topLevelRenameCandidate(base, worker, head);
+  if (!candidate) return undefined;
+
+  const publicContractReasonCodes = publicContractRenameReasonCodes(base, worker, head, candidate);
+  if (publicContractReasonCodes.length) {
+    return {
+      status: 'blocked',
+      reasonCodes: publicContractReasonCodes,
+      summary: candidateSummary(candidate, publicContractReasonCodes),
+      ledgers: { base, worker, head }
+    };
+  }
+
+  return {
+    status: 'candidate',
+    reasonCodes: ['top-level-rename-source-shape-matches'],
+    summary: candidateSummary(candidate, ['top-level-rename-source-shape-matches']),
+    ledgers: { base, worker, head }
+  };
+}
+
+function topLevelRenameCandidate(base, worker, head) {
+  const baseByKey = entriesByKey(base.entries);
+  const workerByKey = entriesByKey(worker.entries);
+  const baseKeys = base.entries.map((entry) => entry.key);
+  const missingBaseDeclarations = base.entries
+    .filter((entry) => !workerByKey.has(entry.key))
+    .filter(isSupportedRenameDeclaration);
+  const addedWorkerDeclarations = worker.entries
+    .filter((entry) => !baseByKey.has(entry.key))
+    .filter(isSupportedRenameDeclaration);
+
+  if (missingBaseDeclarations.length !== 1 || addedWorkerDeclarations.length !== 1) return undefined;
+  const fromEntry = missingBaseDeclarations[0];
+  const toEntry = addedWorkerDeclarations[0];
+  const fromName = fromEntry.names?.[0];
+  const toName = toEntry.names?.[0];
+  if (!fromName || !toName || fromName === toName) return undefined;
+  if (fromEntry.declarationInfo?.declarationKind !== toEntry.declarationInfo?.declarationKind) return undefined;
+  if (!sameStatementText(renameDeclarationText(fromEntry.text, fromEntry.declarationInfo.declarationKind, fromName, toName), toEntry.text)) {
+    return undefined;
+  }
+
+  const workerProjectedBaseKeys = worker.entries.map((entry) => entry.key === toEntry.key ? fromEntry.key : entry.key);
+  if (!sameStringList(workerProjectedBaseKeys, baseKeys)) return undefined;
+  const headProjectedBaseKeys = head.entries
+    .filter((entry) => baseByKey.has(entry.key))
+    .map((entry) => entry.key);
+  if (!sameStringList(headProjectedBaseKeys, baseKeys)) return undefined;
+  if (head.entries.length !== base.entries.length) return undefined;
+
+  return {
+    fromEntry,
+    toEntry,
+    fromName,
+    toName,
+    declarationKind: fromEntry.declarationInfo.declarationKind
+  };
+}
+
+function isSupportedRenameDeclaration(entry) {
+  return entry?.kind === 'declaration'
+    && entry.names?.length === 1
+    && supportedRenameDeclarationKinds.has(entry.declarationInfo?.declarationKind)
+    && !entry.declarationInfo.defaultExport
+    && !/^\s*(?:export\s+)?declare\b/.test(entry.text ?? '');
+}
+
+function publicContractRenameReasonCodes(base, worker, head, candidate) {
+  const directExport = candidate.fromEntry.declarationInfo?.exported === true
+    || candidate.toEntry.declarationInfo?.exported === true;
+  const exportListMention = [base, worker, head]
+    .some((ledger) => ledger.entries
+      .some((entry) => entry.kind === 'export' && mentionsName(entry.text, candidate.fromName, candidate.toName)));
+  return directExport || exportListMention
+    ? [JsTsSafeMergeConflictCodes.topLevelRenamePublicExportContract]
+    : [];
+}
+
+function mentionsName(text, ...names) {
+  return names.some((name) => new RegExp(`\\b${escapeRegExp(name)}\\b`).test(text ?? ''));
+}
+
+function renameDeclarationText(text, declarationKind, fromName, toName) {
+  if (typeof text !== 'string') return undefined;
+  const escaped = escapeRegExp(fromName);
+  const replacement = `$1${toName}`;
+  if (declarationKind === 'function') {
+    return text.replace(new RegExp(`^((?:export\\s+)?(?:async\\s+)?function\\*?\\s+)${escaped}\\b`), replacement);
+  }
+  if (declarationKind === 'class') {
+    return text.replace(new RegExp(`^((?:export\\s+)?(?:abstract\\s+)?class\\s+)${escaped}\\b`), replacement);
+  }
+  if (declarationKind === 'type') {
+    return text.replace(new RegExp(`^((?:export\\s+)?type\\s+)${escaped}\\b`), replacement);
+  }
+  return undefined;
+}
+
+function candidateSummary(candidate, reasonCodes) {
+  return {
+    fromName: candidate.fromName,
+    toName: candidate.toName,
+    declarationKind: candidate.declarationKind,
+    exported: candidate.fromEntry.declarationInfo?.exported === true || candidate.toEntry.declarationInfo?.exported === true,
+    reasonCodes: uniqueStrings(reasonCodes)
+  };
+}
+
+function entriesByKey(entries) {
+  return new Map(entries.map((entry) => [entry.key, entry]));
+}
+
+function sameStringList(left, right) {
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+
+function escapeRegExp(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+export { analyzeTopLevelRenameAdmission };

package/dist/js-ts-safe-merge-top-level-rename-result.js

@@ -0,0 +1,44 @@
+import { JsTsSafeMergeConflictCodes, JsTsSafeMergeGateIds } from './js-ts-safe-merge-constants.js';
+import { uniqueStrings } from './native-import-utils.js';
+
+function topLevelRenameBlockedResult(input, topLevelResult, topLevelRenameAdmission) {
+  const reasonCodes = uniqueStrings([
+    ...(topLevelResult.admission?.reasonCodes ?? []),
+    ...(topLevelRenameAdmission.reasonCodes ?? [])
+  ]);
+  const conflict = {
+    code: JsTsSafeMergeConflictCodes.topLevelRenamePublicExportContract,
+    gateId: JsTsSafeMergeGateIds.stableExistingDeclarations,
+    message: 'Top-level rename changes a public export contract without project-level evidence.',
+    side: 'worker',
+    sourcePath: input.sourcePath ?? topLevelResult.sourcePath,
+    details: {
+      ...topLevelRenameAdmission.summary,
+      reasonCodes: topLevelRenameAdmission.reasonCodes
+    }
+  };
+  return {
+    ...topLevelResult,
+    conflicts: [...(topLevelResult.conflicts ?? []), conflict],
+    admission: {
+      status: 'blocked',
+      action: 'human-review',
+      reviewRequired: true,
+      autoApplyCandidate: false,
+      autoMergeClaim: false,
+      semanticEquivalenceClaim: false,
+      reasonCodes
+    },
+    summary: {
+      ...topLevelResult.summary,
+      conflicts: (topLevelResult.conflicts?.length ?? 0) + 1,
+      topLevelDeclarationRenames: 1
+    },
+    metadata: {
+      ...topLevelResult.metadata,
+      topLevelRenameAdmission: topLevelRenameAdmission.summary
+    }
+  };
+}
+
+export { topLevelRenameBlockedResult };

package/dist/js-ts-safe-project-merge-graph-conflicts.js

@@ -6,6 +6,7 @@ function outputProjectGraphConflicts(projectSymbolGraph) {
   const limitConflicts = Array.isArray(projectSymbolGraph?.limitConflicts) ? projectSymbolGraph.limitConflicts : [];
   projectSymbolGraph = projectSymbolGraph?.projectSymbolGraph ?? projectSymbolGraph;
   const importEdges = Array.isArray(projectSymbolGraph?.importEdges) ? projectSymbolGraph.importEdges : [];
+  const exportEdges = Array.isArray(projectSymbolGraph?.exportEdges) ? projectSymbolGraph.exportEdges : [];
   const missingModuleGroups = new Map();
   const missingSymbolGroups = new Map();
   for (const edge of importEdges) {
@@ -16,7 +17,7 @@ function outputProjectGraphConflicts(projectSymbolGraph) {
       missingModuleGroups.set(key, group);
       continue;
     }
-    if (isMissingProjectImportTargetEdge(edge)) {
+    if (isMissingProjectImportTargetEdge(edge, exportEdges)) {
       const key = [edge.sourcePath, edge.moduleSpecifier, projectImportTargetName(edge), edge.resolvedModulePath].join('\u0000');
       const group = missingSymbolGroups.get(key) ?? [];
       group.push(edge);
@@ -81,8 +82,11 @@ function isMissingProjectImportEdge(edge) {
   return typeof edge?.resolutionKind === 'string' && edge.resolutionKind.endsWith('-missing');
 }
 
-function isMissingProjectImportTargetEdge(edge) {
-  return hasResolvedProjectModule(edge) && Boolean(projectImportTargetName(edge)) && !edge.resolvedTargetSymbolId;
+function isMissingProjectImportTargetEdge(edge, exportEdges = []) {
+  return hasResolvedProjectModule(edge)
+    && Boolean(projectImportTargetName(edge))
+    && !edge.resolvedTargetSymbolId
+    && !commonJsRequireResolvedByExportAssignment(edge, exportEdges);
 }
 
 function hasResolvedProjectModule(edge) {
@@ -96,6 +100,23 @@ function projectImportTargetName(edge) {
   return String(name);
 }
 
+function commonJsRequireResolvedByExportAssignment(edge, exportEdges) {
+  if (edge?.importKind !== 'commonjs-require' || projectImportTargetName(edge) !== 'default') return false;
+  return exportEdges.some((exportEdge) => exportEdge?.exportKind === 'assignment'
+    && exportEdge.exportedName === 'module.exports'
+    && sameProjectDocument(edge, exportEdge));
+}
+
+function sameProjectDocument(importEdge, exportEdge) {
+  if (importEdge?.targetDocumentId && exportEdge?.sourceDocumentId) {
+    return importEdge.targetDocumentId === exportEdge.sourceDocumentId;
+  }
+  if (importEdge?.resolvedModulePath && exportEdge?.sourcePath) {
+    return importEdge.resolvedModulePath === exportEdge.sourcePath;
+  }
+  return false;
+}
+
 function duplicateReExportIdentityConflicts(records = []) {
   const groups = new Map();
   for (const record of records) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-lang-compiler",
-  "version": "0.2.147",
+  "version": "0.2.149",
   "description": "Compiler facade for Frontier Lang source documents and language projection adapters.",
   "type": "module",
   "main": "./dist/index.js",