@shapeshift-labs/frontier-lang-compiler 0.2.90 → 0.2.92

package/README.md

@@ -933,6 +933,7 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-realtime-server`](https://www.npmjs.com/package/@shapeshift-labs/frontier-realtime-server): Authoritative realtime room, tick, command validation, rate-limit, session, and snapshot-history runtime.
 - [`@shapeshift-labs/frontier-realtime-websocket`](https://www.npmjs.com/package/@shapeshift-labs/frontier-realtime-websocket): WebSocket client, wire, and Node room-server transport for Frontier realtime.
 - [`@shapeshift-labs/frontier-game`](https://www.npmjs.com/package/@shapeshift-labs/frontier-game): Game-facing entity, component, player, room, ownership, spatial interest, rollback, physics, and replication helpers above realtime.
+- [`@shapeshift-labs/loom`](https://www.npmjs.com/package/@shapeshift-labs/loom): Repo-level semantic collaboration CLI for .loom workspaces, including init, scan, status, graph snapshots, projection plans, Frontier Lang delegation, Frontier Swarm delegation, and Frontier Framework delegation.
 
 Package source repositories:
 
@@ -1026,3 +1027,4 @@ Package source repositories:
 - [`siliconjungle/-shapeshift-labs-frontier-realtime-server`](https://github.com/siliconjungle/-shapeshift-labs-frontier-realtime-server)
 - [`siliconjungle/-shapeshift-labs-frontier-realtime-websocket`](https://github.com/siliconjungle/-shapeshift-labs-frontier-realtime-websocket)
 - [`siliconjungle/-shapeshift-labs-frontier-game`](https://github.com/siliconjungle/-shapeshift-labs-frontier-game)
+- [`siliconjungle/-shapeshift-labs-loom`](https://github.com/siliconjungle/-shapeshift-labs-loom)

package/dist/declarations/semantic-edit-script.d.ts

@@ -191,6 +191,71 @@ export interface SemanticEditProjection {
   readonly metadata?: Record<string, unknown>;
 }
 
+export type SemanticEditReplayStatus =
+  | 'accepted-clean'
+  | 'already-applied'
+  | 'conflict'
+  | 'stale'
+  | 'blocked'
+  | 'needs-port'
+  | 'evidence-only';
+
+export interface SemanticEditReplayEdit {
+  readonly operationId?: string;
+  readonly semanticKey?: string;
+  readonly semanticIdentityHash?: string;
+  readonly sourceIdentityHash?: string;
+  readonly editContentHash?: string;
+  readonly sourcePath?: string;
+  readonly symbolName?: string;
+  readonly symbolKind?: string;
+  readonly status: 'applied' | 'already-applied' | 'conflict' | 'stale' | 'blocked' | string;
+  readonly start?: number;
+  readonly end?: number;
+  readonly replacementBytes?: number;
+  readonly replacementText?: string;
+  readonly reasonCodes: readonly string[];
+}
+
+export interface SemanticEditReplay {
+  readonly kind: 'frontier.lang.semanticEditReplay';
+  readonly version: 1;
+  readonly schema: 'frontier.lang.semanticEditReplay.v1';
+  readonly id: string;
+  readonly hash: string;
+  readonly projectionId?: string;
+  readonly scriptId?: string;
+  readonly sourcePath?: string;
+  readonly language?: FrontierSourceLanguage | string;
+  readonly currentHash?: string;
+  readonly projectedHash?: string;
+  readonly outputHash?: string;
+  readonly status: SemanticEditReplayStatus;
+  readonly edits: readonly SemanticEditReplayEdit[];
+  readonly appliedOperations: readonly string[];
+  readonly skippedOperations: readonly string[];
+  readonly admission: {
+    readonly status: SemanticEditReplayStatus;
+    readonly action: 'apply' | 'skip' | 'rerun-semantic-import' | 'human-review' | 'block' | string;
+    readonly reviewRequired: boolean;
+    readonly autoApplyCandidate: boolean;
+    readonly autoMergeClaim: false;
+    readonly semanticEquivalenceClaim: false;
+    readonly reasonCodes: readonly string[];
+  };
+  readonly outputSourceText?: string;
+  readonly summary: {
+    readonly edits: number;
+    readonly applied: number;
+    readonly alreadyApplied: number;
+    readonly conflicts: number;
+    readonly stale: number;
+    readonly blocked: number;
+    readonly reasonCodes: readonly string[];
+  };
+  readonly metadata?: Record<string, unknown>;
+}
+
 export interface ProjectSemanticEditScriptToSourceOptions {
   readonly id?: string;
   readonly script: SemanticEditScript;
@@ -200,6 +265,17 @@ export interface ProjectSemanticEditScriptToSourceOptions {
   readonly metadata?: Record<string, unknown>;
 }
 
+export interface ReplaySemanticEditProjectionOptions {
+  readonly id?: string;
+  readonly projection: SemanticEditProjection;
+  readonly currentSourceText: string;
+  readonly currentSourcePath?: string;
+  readonly currentSourceHash?: string;
+  readonly language?: FrontierSourceLanguage | string;
+  readonly parser?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+
 export interface CreateSemanticEditScriptOptions {
   readonly id?: string;
   readonly language?: FrontierSourceLanguage | string;
@@ -229,3 +305,4 @@ export interface CreateSemanticEditScriptOptions {
 export declare const SemanticEditScriptAdmissionStatuses: readonly SemanticEditScriptAdmissionStatus[];
 export declare function createSemanticEditScript(input?: CreateSemanticEditScriptOptions): SemanticEditScript;
 export declare function projectSemanticEditScriptToSource(input: ProjectSemanticEditScriptToSourceOptions): SemanticEditProjection;
+export declare function replaySemanticEditProjection(input: ReplaySemanticEditProjectionOptions): SemanticEditReplay;

package/dist/declarations/semantic-patch-bundle.d.ts

@@ -81,6 +81,8 @@ export interface SemanticPatchBundleAdmission {
   readonly readiness: SemanticMergeReadiness | string;
   readonly reviewRequired: boolean;
   readonly autoMergeClaim: false;
+  readonly autoApplyCandidate?: boolean;
+  readonly transformAdmission?: SemanticPatchBundleTransformAdmission;
   readonly reasonCodes?: readonly string[];
   readonly conflictKeys?: readonly string[];
   readonly admittedAt?: number | string;
@@ -89,6 +91,23 @@ export interface SemanticPatchBundleAdmission {
   readonly metadata?: Record<string, unknown>;
 }
 
+export interface SemanticPatchBundleTransformAdmission {
+  readonly status: 'none' | 'ready' | 'needs-review' | 'blocked' | string;
+  readonly action: 'none' | 'admit' | 'review' | 'block' | string;
+  readonly readiness: SemanticMergeReadiness | string;
+  readonly crossLanguage?: boolean;
+  readonly reasonCodes?: readonly string[];
+  readonly transformIds?: readonly string[];
+  readonly transformKeys?: readonly string[];
+  readonly contentHashes?: readonly string[];
+  readonly projectionIdentityHashes?: readonly string[];
+  readonly sourceLanguages?: readonly string[];
+  readonly targetLanguages?: readonly string[];
+  readonly sourcePaths?: readonly string[];
+  readonly targetPaths?: readonly string[];
+  readonly evidenceIds?: readonly string[];
+}
+
 export interface SemanticPatchBundleRecordIndex {
   readonly baseHashes: readonly string[];
   readonly targetHashes: readonly string[];
@@ -116,6 +135,8 @@ export interface SemanticPatchBundleRecordIndex {
   readonly semanticTransformIdentityHashes: readonly string[];
   readonly semanticTransformContentHashes: readonly string[];
   readonly projectionIdentityHashes: readonly string[];
+  readonly semanticTransformReadinesses: readonly string[];
+  readonly semanticTransformEvidenceIds: readonly string[];
   readonly transformSourceLanguages: readonly string[];
   readonly transformTargetLanguages: readonly string[];
   readonly transformSourcePaths: readonly string[];
@@ -263,6 +284,10 @@ export interface SemanticPatchBundleRecordQuery {
   readonly semanticTransformContentHashes?: readonly string[];
   readonly projectionIdentityHash?: string | readonly string[];
   readonly projectionIdentityHashes?: readonly string[];
+  readonly semanticTransformReadiness?: string | readonly string[];
+  readonly semanticTransformReadinesses?: readonly string[];
+  readonly semanticTransformEvidenceId?: string | readonly string[];
+  readonly semanticTransformEvidenceIds?: readonly string[];
   readonly transformSourceLanguage?: string | readonly string[];
   readonly transformSourceLanguages?: readonly string[];
   readonly transformTargetLanguage?: string | readonly string[];

package/dist/index.js

@@ -73,6 +73,7 @@ export { createSemanticMergeCandidateAdmissionRecord, decorateSemanticMergeCandi
 export { querySemanticMergeConflictClasses, SemanticMergeConflictClasses, semanticMergeConflictRiskScore, sortSemanticMergeCandidatesByConflictRisk, summarizeSemanticMergeConflicts } from './internal/index-impl/semanticMergeConflicts.js';
 export { createSemanticEditScript, SemanticEditScriptAdmissionStatuses } from './internal/index-impl/semanticEditScripts.js';
 export { projectSemanticEditScriptToSource } from './internal/index-impl/projectSemanticEditScriptToSource.js';
+export { replaySemanticEditProjection } from './internal/index-impl/replaySemanticEditProjection.js';
 export { queryUniversalConversionPlan } from './internal/index-impl/queryUniversalConversionPlan.js';
 export { createSemanticAnchor, createSemanticLineageEvent, createSemanticLineageMap, querySemanticLineageEvents, SemanticLineageEventKinds } from './internal/index-impl/semanticLineageRecords.js';
 export { resolveSemanticLineage, resolveSemanticLineageBatch, SemanticLineageResolutionStatuses } from './internal/index-impl/semanticLineageResolutionRecords.js';

package/dist/internal/index-impl/replaySemanticEditProjection.js

@@ -0,0 +1,191 @@
+import { hashSemanticValue } from '@shapeshift-labs/frontier-lang-kernel';
+import { idFragment, normalizeNativeLanguageId, uniqueStrings } from '../../native-import-utils.js';
+import { createSemanticImportSidecar } from './createSemanticImportSidecar.js';
+import { mapDiffSymbols } from './mapDiffSymbols.js';
+import { normalizeNativeDiffImport } from './normalizeNativeDiffImport.js';
+
+export function replaySemanticEditProjection(input = {}) {
+  const projection = input.projection ?? input.semanticEditProjection;
+  if (!projection) throw new Error('replaySemanticEditProjection requires a projection');
+  const currentSourceText = input.currentSourceText ?? input.headSourceText;
+  const sourcePath = input.currentSourcePath ?? input.headSourcePath ?? projection.sourcePath;
+  const language = normalizeNativeLanguageId(input.language ?? projection.language);
+  const reasonCodes = baseReasonCodes(projection, currentSourceText);
+  const currentHash = typeof currentSourceText === 'string' ? hashSemanticValue(currentSourceText) : undefined;
+  if (input.currentSourceHash && currentHash !== input.currentSourceHash) reasonCodes.push('current-source-hash-mismatch');
+  const currentSymbols = currentSourceText && isJavaScriptLike(language)
+    ? currentSymbolIndex({ currentSourceText, sourcePath, language, parser: input.parser })
+    : [];
+  const edits = projection.status === 'projected' && typeof currentSourceText === 'string'
+    ? (projection.edits ?? []).map((edit) => replayProjectionEdit(edit, { currentSourceText, currentSymbols }))
+    : [];
+  const status = replayStatus(reasonCodes, edits, projection);
+  const outputSourceText = replayOutputSource(status, currentSourceText, edits);
+  const core = {
+    kind: 'frontier.lang.semanticEditReplay',
+    version: 1,
+    schema: 'frontier.lang.semanticEditReplay.v1',
+    id: input.id ?? `semantic_edit_replay_${idFragment(projection.id ?? sourcePath ?? language ?? 'projection')}`,
+    projectionId: projection.id,
+    scriptId: projection.scriptId,
+    sourcePath,
+    language,
+    currentHash,
+    projectedHash: projection.projectedHash,
+    outputHash: outputSourceText === undefined ? undefined : hashSemanticValue(outputSourceText),
+    status,
+    edits,
+    appliedOperations: edits.filter((edit) => edit.status === 'applied').map((edit) => edit.operationId).filter(Boolean),
+    skippedOperations: edits.filter((edit) => edit.status !== 'applied').map((edit) => edit.operationId).filter(Boolean),
+    admission: replayAdmission(status, reasonCodes, edits),
+    outputSourceText,
+    summary: replaySummary(edits, reasonCodes),
+    metadata: compactRecord({
+      autoMergeClaim: false,
+      semanticEquivalenceClaim: false,
+      anchorMode: currentSymbols.length ? 'javascript-like-symbols' : 'offsets',
+      ...input.metadata
+    })
+  };
+  return { ...core, hash: hashSemanticValue(core) };
+}
+
+function replayProjectionEdit(edit, context) {
+  if (edit.status === 'already-applied') return replayEditRecord(edit, 'already-applied', undefined, ['projection-edit-already-applied']);
+  if (typeof edit.replacementText !== 'string') return replayEditRecord(edit, 'blocked', undefined, ['missing-replacement-text']);
+  const offset = checkRange(edit, { start: edit.headStart, end: edit.headEnd }, context.currentSourceText, 'head-offset');
+  if (offset) return replayEditRecord(edit, offset.status, offset.range, [offset.reason]);
+  const symbol = findCurrentSymbol(edit, context.currentSymbols);
+  const spanRange = spanOffsets(context.currentSourceText, symbol?.sourceSpan);
+  const anchored = checkRange(edit, spanRange, context.currentSourceText, 'current-symbol-anchor');
+  if (anchored) return replayEditRecord(edit, anchored.status, anchored.range, [anchored.reason, 'offset-reanchored-by-symbol']);
+  return replayEditRecord(edit, symbol ? 'conflict' : 'stale', spanRange, [
+    symbol ? 'current-symbol-anchor-content-mismatch' : 'current-symbol-anchor-missing'
+  ]);
+}
+
+function checkRange(edit, range, sourceText, label) {
+  if (!range || range.end < range.start) return undefined;
+  const current = sourceText.slice(range.start, range.end);
+  const currentHash = hashSemanticValue(current);
+  if (edit.deletedTextHash && currentHash === edit.deletedTextHash) return { status: 'applied', range, reason: `${label}-matches-deleted` };
+  if (edit.replacementTextHash && currentHash === edit.replacementTextHash) return { status: 'already-applied', range, reason: `${label}-matches-replacement` };
+  if (current === edit.replacementText) return { status: 'already-applied', range, reason: `${label}-matches-replacement-text` };
+  return undefined;
+}
+
+function replayEditRecord(edit, status, range, reasonCodes) {
+  return compactRecord({
+    operationId: edit.operationId,
+    semanticKey: edit.semanticKey,
+    semanticIdentityHash: edit.semanticIdentityHash,
+    sourceIdentityHash: edit.sourceIdentityHash,
+    editContentHash: edit.editContentHash,
+    sourcePath: edit.targetSourcePath ?? edit.sourcePath,
+    symbolName: edit.targetSymbolName ?? edit.symbolName,
+    symbolKind: edit.targetSymbolKind ?? edit.symbolKind,
+    status,
+    start: range?.start,
+    end: range?.end,
+    replacementBytes: edit.replacementBytes,
+    replacementText: edit.replacementText,
+    reasonCodes: reasonList(reasonCodes)
+  });
+}
+
+function currentSymbolIndex(input) {
+  const imported = normalizeNativeDiffImport({
+    language: input.language,
+    sourcePath: input.sourcePath,
+    sourceText: input.currentSourceText,
+    parser: input.parser
+  }, input, 'current');
+  return [...mapDiffSymbols(imported, createSemanticImportSidecar(imported)).values()];
+}
+
+function findCurrentSymbol(edit, symbols) {
+  const exact = symbols.find((symbol) => [symbol.ownershipKey, symbol.key, symbol.id].some((key) => key && [
+    edit.anchorKey,
+    edit.targetAnchorKey,
+    edit.symbolId
+  ].includes(key)));
+  if (exact) return exact;
+  const name = edit.targetSymbolName ?? edit.symbolName;
+  const kind = edit.targetSymbolKind ?? edit.symbolKind;
+  return symbols.find((symbol) => symbol.name === name && (!kind || symbol.kind === kind));
+}
+
+function replayStatus(reasonCodes, edits, projection) {
+  if (reasonCodes.some((reason) => reason !== 'current-source-hash-mismatch')) return 'blocked';
+  if (!edits.length && !(projection.edits ?? []).length) return 'evidence-only';
+  if (edits.some((edit) => edit.status === 'blocked')) return 'blocked';
+  if (edits.some((edit) => edit.status === 'conflict')) return 'conflict';
+  if (edits.some((edit) => edit.status === 'stale')) return 'stale';
+  if (edits.every((edit) => edit.status === 'already-applied')) return 'already-applied';
+  return edits.every((edit) => edit.status === 'applied' || edit.status === 'already-applied') ? 'accepted-clean' : 'needs-port';
+}
+
+function replayAdmission(status, reasonCodes, edits) {
+  const apply = status === 'accepted-clean';
+  return {
+    status,
+    action: apply ? 'apply' : status === 'already-applied' ? 'skip' : status === 'stale' ? 'rerun-semantic-import' : status === 'blocked' ? 'block' : 'human-review',
+    reviewRequired: !apply,
+    autoApplyCandidate: apply,
+    autoMergeClaim: false,
+    semanticEquivalenceClaim: false,
+    reasonCodes: reasonList([...reasonCodes, ...edits.flatMap((edit) => edit.reasonCodes ?? [])])
+  };
+}
+
+function replaySummary(edits, reasonCodes) {
+  return {
+    edits: edits.length,
+    applied: edits.filter((edit) => edit.status === 'applied').length,
+    alreadyApplied: edits.filter((edit) => edit.status === 'already-applied').length,
+    conflicts: edits.filter((edit) => edit.status === 'conflict').length,
+    stale: edits.filter((edit) => edit.status === 'stale').length,
+    blocked: edits.filter((edit) => edit.status === 'blocked').length,
+    reasonCodes: reasonList([...reasonCodes, ...edits.flatMap((edit) => edit.reasonCodes ?? [])])
+  };
+}
+
+function replayOutputSource(status, sourceText, edits) {
+  if (typeof sourceText !== 'string') return undefined;
+  if (status === 'already-applied') return sourceText;
+  if (status !== 'accepted-clean') return undefined;
+  return edits.filter((edit) => edit.status === 'applied')
+    .sort((left, right) => right.start - left.start)
+    .reduce((text, edit) => text.slice(0, edit.start) + editReplacement(edit, edits) + text.slice(edit.end), sourceText);
+}
+
+function editReplacement(edit, edits) {
+  return edits.find((candidate) => candidate.operationId === edit.operationId)?.replacementText ?? '';
+}
+
+function baseReasonCodes(projection, currentSourceText) {
+  return reasonList([
+    projection.status !== 'projected' ? 'projection-not-projected' : undefined,
+    projection.admission?.status !== 'auto-merge-candidate' ? 'projection-not-auto-merge-candidate' : undefined,
+    typeof currentSourceText !== 'string' ? 'missing-current-source-text' : undefined
+  ]);
+}
+
+function spanOffsets(sourceText, span) {
+  if (typeof sourceText !== 'string' || !span) return undefined;
+  if (typeof span.start === 'number' && typeof span.end === 'number' && span.end >= span.start) return { start: span.start, end: span.end };
+  if (typeof span.startLine !== 'number') return undefined;
+  const starts = [0];
+  for (let index = 0; index < sourceText.length; index += 1) if (sourceText[index] === '\n') starts.push(index + 1);
+  const startLine = Math.max(1, span.startLine);
+  const endLine = Math.max(startLine, typeof span.endLine === 'number' ? span.endLine : startLine);
+  const lineStart = starts[startLine - 1];
+  const endLineStart = starts[endLine - 1];
+  if (lineStart === undefined || endLineStart === undefined) return undefined;
+  const lineEnd = starts[endLine] === undefined ? sourceText.length : starts[endLine] - 1;
+  return { start: lineStart + Math.max(0, (span.startColumn ?? 1) - 1), end: endLineStart + (span.endColumn === undefined ? lineEnd - endLineStart : Math.max(0, span.endColumn - 1)) };
+}
+
+function isJavaScriptLike(language) { return language === 'javascript' || language === 'typescript'; }
+function reasonList(values) { return uniqueStrings((values ?? []).filter(Boolean)); }
+function compactRecord(value) { return Object.fromEntries(Object.entries(value ?? {}).filter(([, entry]) => entry !== undefined && (!Array.isArray(entry) || entry.length > 0))); }

package/dist/internal/index-impl/semanticPatchBundleAdmission.js

@@ -0,0 +1,97 @@
+import { normalizeSemanticMergeReadiness, uniqueStrings } from '../../native-import-utils.js';
+
+export function createSemanticPatchBundleAdmission(input = {}, context = {}) {
+  const transformAdmission = semanticTransformAdmission(context);
+  const fallbackReadiness = transformAdmission.readiness === 'ready' ? 'ready' : context.readiness;
+  const readiness = normalizeSemanticMergeReadiness(input.readiness ?? fallbackReadiness) ?? input.readiness ?? fallbackReadiness;
+  const status = input.status ?? admissionStatusForReadiness(readiness, transformAdmission);
+  const autoApplyCandidate = input.autoApplyCandidate ?? (status === 'admitted' && transformAdmission.action === 'admit');
+  return compactRecord({
+    status,
+    readiness,
+    reviewRequired: input.reviewRequired ?? status !== 'admitted',
+    autoMergeClaim: false,
+    autoApplyCandidate,
+    transformAdmission,
+    reasonCodes: uniqueStrings([
+      ...strings(input.reasonCodes),
+      ...strings(context.source?.reasons),
+      ...strings(context.mergeCandidate?.reasons),
+      ...transformAdmission.reasonCodes
+    ]),
+    conflictKeys: uniqueStrings([...strings(input.conflictKeys), ...context.conflictKeys]),
+    admittedAt: input.admittedAt,
+    reviewerId: input.reviewerId,
+    evidenceIds: uniqueStrings([...strings(input.evidenceIds), ...strings(transformAdmission.evidenceIds)]),
+    metadata: input.metadata
+  });
+}
+
+function semanticTransformAdmission(context) {
+  const records = array(context.semanticTransformIdentities);
+  const index = context.semanticTransformIndex ?? {};
+  if (!records.length && !strings(index.semanticTransformIds).length) {
+    return { status: 'none', action: 'none', readiness: 'needs-review', reasonCodes: [] };
+  }
+  const readinesses = uniqueStrings([...strings(index.semanticTransformReadinesses), ...records.map((record) => record.readiness)]);
+  const normalizedReadinesses = uniqueStrings(readinesses.map(transformReadiness).filter(Boolean));
+  const blocked = normalizedReadinesses.includes('blocked');
+  const complete = strings(index.semanticTransformContentHashes).length > 0 &&
+    strings(index.projectionIdentityHashes).length > 0 &&
+    strings(index.transformSourceLanguages).length > 0 &&
+    strings(index.transformTargetLanguages).length > 0 &&
+    strings(index.transformSourcePaths).length > 0 &&
+    strings(index.transformTargetPaths).length > 0;
+  const ready = !blocked && complete && (normalizedReadinesses.length === 0 || normalizedReadinesses.every((entry) => entry === 'ready'));
+  const status = blocked ? 'blocked' : ready ? 'ready' : 'needs-review';
+  return compactRecord({
+    status,
+    action: blocked ? 'block' : ready ? 'admit' : 'review',
+    readiness: blocked ? 'blocked' : ready ? 'ready' : 'needs-review',
+    crossLanguage: hasCrossLanguageTransform(index),
+    reasonCodes: transformReasonCodes({ blocked, complete, ready, readinesses, index }),
+    transformIds: strings(index.semanticTransformIds),
+    transformKeys: strings(index.semanticTransformKeys),
+    contentHashes: strings(index.semanticTransformContentHashes),
+    projectionIdentityHashes: strings(index.projectionIdentityHashes),
+    sourceLanguages: strings(index.transformSourceLanguages),
+    targetLanguages: strings(index.transformTargetLanguages),
+    sourcePaths: strings(index.transformSourcePaths),
+    targetPaths: strings(index.transformTargetPaths),
+    evidenceIds: strings(index.semanticTransformEvidenceIds)
+  });
+}
+
+function transformReasonCodes(input) {
+  return uniqueStrings([
+    input.blocked ? 'transform-readiness-blocked' : undefined,
+    !input.complete ? 'transform-evidence-incomplete' : undefined,
+    input.ready ? 'transform-auto-apply-candidate' : undefined,
+    ...input.readinesses.map((readiness) => `transform-readiness:${readiness}`)
+  ]);
+}
+
+function transformReadiness(value) {
+  const normalized = normalizeSemanticMergeReadiness(value);
+  if (normalized) return normalized === 'ready-with-losses' ? 'needs-review' : normalized;
+  const status = String(value ?? '').toLowerCase();
+  if (['auto-merge-candidate', 'portable', 'projected', 'applied'].includes(status)) return 'ready';
+  if (['conflict', 'blocked', 'stale', 'rejected'].includes(status)) return 'blocked';
+  if (['needs-port', 'review', 'needs-review', 'candidate'].includes(status)) return 'needs-review';
+  return undefined;
+}
+
+function admissionStatusForReadiness(readiness, transformAdmission) {
+  if (readiness === 'blocked') return 'blocked';
+  if (transformAdmission.action === 'admit' && readiness === 'ready') return 'admitted';
+  return readiness === 'needs-review' ? 'needs-review' : 'proposed';
+}
+
+function hasCrossLanguageTransform(index) {
+  const source = new Set(strings(index.transformSourceLanguages));
+  return strings(index.transformTargetLanguages).some((target) => !source.has(target));
+}
+
+function array(value) { if (value === undefined || value === null) return []; return Array.isArray(value) ? value : [value]; }
+function strings(value) { return array(value).map((entry) => String(entry ?? '')).filter(Boolean); }
+function compactRecord(value) { return Object.fromEntries(Object.entries(value ?? {}).filter(([, entry]) => entry !== undefined && (!Array.isArray(entry) || entry.length > 0))); }

package/dist/internal/index-impl/semanticPatchBundleRecords.js

@@ -1,4 +1,5 @@
 import{idFragment,normalizeSemanticMergeReadiness,uniqueStrings}from'../../native-import-utils.js';
+import{createSemanticPatchBundleAdmission}from'./semanticPatchBundleAdmission.js';
 import{normalizeSemanticTransformIdentityRecords,semanticTransformInputs,semanticTransformRecordIndex,semanticTransformSummary}from'./semanticTransformIdentityRecords.js';
 
 export const SemanticPatchBundleAdmissionStatuses=Object.freeze(['proposed','queued','admitted','needs-review','blocked','rejected']);
@@ -42,7 +43,7 @@ export function createSemanticPatchBundleRecord(input={},options={}){
     ...changedRegions.flatMap((region)=>[region.conflictKey,...array(region.admission?.conflictKeys)]),
     ...(source.metadata?.semanticMergeConflictSummary?.conflictKeys??[])
   ]);
-  const admission=normalizeAdmission(options.admission??source.admission,{readiness,conflictKeys,source,mergeCandidate});
+  const admission=createSemanticPatchBundleAdmission(options.admission??source.admission,{readiness,conflictKeys,source,mergeCandidate,semanticTransformIndex,semanticTransformIdentities});
   const id=options.id??(source.kind==='frontier.lang.semanticPatchBundleRecord'?source.id:undefined)
     ??`semantic_patch_bundle_${idFragment(firstString(source.id,patchId,mergeCandidateId,source.sourcePath,source.language,'record'))}`;
   const language=options.language??source.language??mergeCandidate?.language??sources.find((item)=>item.language)?.language;
@@ -184,23 +185,6 @@ function normalizeSourceMapLinks(links){
   return result;
 }
 
-function normalizeAdmission(input={},context){
-  const readiness=normalizeSemanticMergeReadiness(input.readiness??context.readiness)??input.readiness??context.readiness;
-  const status=input.status??admissionStatusForReadiness(readiness);
-  return compactRecord({
-    status,
-    readiness,
-    reviewRequired:input.reviewRequired??status!=='admitted',
-    autoMergeClaim:false,
-    reasonCodes:uniqueStrings([...strings(input.reasonCodes),...strings(context.source.reasons),...strings(context.mergeCandidate?.reasons)]),
-    conflictKeys:uniqueStrings([...strings(input.conflictKeys),...context.conflictKeys]),
-    admittedAt:input.admittedAt,
-    reviewerId:input.reviewerId,
-    evidenceIds:uniqueStrings(input.evidenceIds),
-    metadata:input.metadata
-  });
-}
-
 function recordIndex(parts){
   const semanticEditIndex=parts.semanticEditIndex??semanticEditRecordIndex([],[]);
   const semanticTransformIndex=parts.semanticTransformIndex??semanticTransformRecordIndex([],parts);
@@ -231,6 +215,8 @@ function recordIndex(parts){
     semanticTransformIdentityHashes:semanticTransformIndex.semanticTransformIdentityHashes,
     semanticTransformContentHashes:semanticTransformIndex.semanticTransformContentHashes,
     projectionIdentityHashes:semanticTransformIndex.projectionIdentityHashes,
+    semanticTransformReadinesses:semanticTransformIndex.semanticTransformReadinesses,
+    semanticTransformEvidenceIds:semanticTransformIndex.semanticTransformEvidenceIds,
     transformSourceLanguages:semanticTransformIndex.transformSourceLanguages,
     transformTargetLanguages:semanticTransformIndex.transformTargetLanguages,
     transformSourcePaths:semanticTransformIndex.transformSourcePaths,
@@ -273,6 +259,8 @@ function matchesRecord(record,query){
     &&matchAny(queryValues(query.semanticTransformIdentityHash,query.semanticTransformIdentityHashes),index.semanticTransformIdentityHashes)
     &&matchAny(queryValues(query.semanticTransformContentHash,query.semanticTransformContentHashes),index.semanticTransformContentHashes)
     &&matchAny(queryValues(query.projectionIdentityHash,query.projectionIdentityHashes),index.projectionIdentityHashes)
+    &&matchAny(queryValues(query.semanticTransformReadiness,query.semanticTransformReadinesses),index.semanticTransformReadinesses)
+    &&matchAny(queryValues(query.semanticTransformEvidenceId,query.semanticTransformEvidenceIds),index.semanticTransformEvidenceIds)
     &&matchAny(queryValues(query.transformSourceLanguage,query.transformSourceLanguages),index.transformSourceLanguages)
     &&matchAny(queryValues(query.transformTargetLanguage,query.transformTargetLanguages),index.transformTargetLanguages)
     &&matchAny(queryValues(query.transformSourcePath,query.transformSourcePaths),index.transformSourcePaths)
@@ -281,7 +269,6 @@ function matchesRecord(record,query){
     &&matchAny(queryValues(query.admissionStatus,query.admissionStatuses),index.admissionStatuses);
 }
 
-function admissionStatusForReadiness(readiness){return readiness==='blocked'?'blocked':readiness==='needs-review'?'needs-review':'proposed';}
 function semanticEditRecordIndex(scripts,projections,source={}){
   const operations=scripts.flatMap((script)=>array(script.operations));
   const edits=projections.flatMap((projection)=>array(projection.edits));

package/dist/internal/index-impl/semanticTransformIdentityRecords.js

@@ -104,6 +104,8 @@ export function semanticTransformRecordIndex(records, source = {}) {
     semanticTransformIdentityHashes: uniqueStrings([...strings(source.semanticTransformIdentityHashes), ...strings(index.semanticTransformIdentityHashes), ...records.map((record) => record.transformIdentityHash)]),
     semanticTransformContentHashes: uniqueStrings([...strings(source.semanticTransformContentHashes), ...strings(index.semanticTransformContentHashes), ...records.map((record) => record.transformContentHash)]),
     projectionIdentityHashes: uniqueStrings([...strings(source.projectionIdentityHashes), ...strings(index.projectionIdentityHashes), ...records.map((record) => record.projectionIdentityHash)]),
+    semanticTransformReadinesses: uniqueStrings([...strings(source.semanticTransformReadinesses), ...strings(index.semanticTransformReadinesses), ...records.map((record) => record.readiness)]),
+    semanticTransformEvidenceIds: uniqueStrings([...strings(source.semanticTransformEvidenceIds), ...strings(index.semanticTransformEvidenceIds), ...records.flatMap((record) => record.evidenceIds)]),
     transformSourceLanguages: uniqueStrings([...strings(source.transformSourceLanguages), ...strings(index.transformSourceLanguages), ...records.map((record) => record.sourceLanguage)]),
     transformTargetLanguages: uniqueStrings([...strings(source.transformTargetLanguages), ...strings(index.transformTargetLanguages), ...records.map((record) => record.targetLanguage)]),
     transformSourcePaths: uniqueStrings([...strings(source.transformSourcePaths), ...strings(index.transformSourcePaths), ...records.map((record) => record.sourcePath)]),
@@ -119,6 +121,8 @@ export function semanticTransformSummary(index) {
     identityHashes: index.semanticTransformIdentityHashes,
     contentHashes: index.semanticTransformContentHashes,
     projectionIdentityHashes: index.projectionIdentityHashes,
+    readinesses: index.semanticTransformReadinesses,
+    evidenceIds: index.semanticTransformEvidenceIds,
     sourceLanguages: index.transformSourceLanguages,
     targetLanguages: index.transformTargetLanguages,
     targetPaths: index.transformTargetPaths

package/package.json

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