@shapeshift-labs/frontier-lang-compiler 0.2.99 → 0.2.101

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

@@ -1,4 +1,4 @@
-import type { SemanticMergeReadiness } from '@shapeshift-labs/frontier-lang-kernel';
+import type { EvidenceRecord, SemanticMergeReadiness } from '@shapeshift-labs/frontier-lang-kernel';
 import type { SemanticEditProjection, SemanticEditReplay, SemanticEditScript } from './semantic-edit-script.js';
 
 export type SemanticEditBundleAdmissionStatus =
@@ -16,6 +16,8 @@ export interface SemanticEditBundleAdmissionSummary {
   readonly projections: number;
   readonly replays: number;
   readonly files: number;
+  readonly portableScripts: number;
+  readonly portableProjections: number;
   readonly acceptedClean: number;
   readonly alreadyApplied: number;
   readonly conflicts: number;
@@ -32,6 +34,11 @@ export interface SemanticEditBundleAdmissionSummary {
   readonly scriptIds: readonly string[];
   readonly projectionIds: readonly string[];
   readonly replayIds: readonly string[];
+  readonly evidenceIds: readonly string[];
+  readonly passedTestEvidence: number;
+  readonly failedTestEvidence: number;
+  readonly conflictEvidence: number;
+  readonly staleEvidence: number;
   readonly reasonCodes: readonly string[];
 }
 
@@ -68,6 +75,11 @@ export interface CreateSemanticEditBundleAdmissionInput {
   readonly semanticEditReplay?: SemanticEditReplay;
   readonly semanticEditReplays?: readonly SemanticEditReplay[] | SemanticEditReplay;
   readonly replays?: readonly SemanticEditReplay[] | SemanticEditReplay;
+  readonly evidence?: readonly EvidenceRecord[] | EvidenceRecord;
+  readonly testEvidence?: readonly EvidenceRecord[] | EvidenceRecord;
+  readonly testResults?: readonly EvidenceRecord[] | EvidenceRecord;
+  readonly gateEvidence?: readonly EvidenceRecord[] | EvidenceRecord;
+  readonly proofEvidence?: readonly EvidenceRecord[] | EvidenceRecord;
   readonly metadata?: Record<string, unknown>;
 }
 

package/dist/declarations/semantic-edit-replay-diagnostics.d.ts

@@ -0,0 +1,24 @@
+import type { SemanticEditReplayStatus } from './semantic-edit-script.js';
+
+export type SemanticEditReplayDiagnosticCategory = 'stale-anchor' | 'overlap' | 'missing-source' | 'projection-mismatch' | 'matched-source' | 'reanchored' | 'replay' | string;
+export type SemanticEditReplayDiagnosticSeverity = 'info' | 'warning' | 'error' | string;
+export type SemanticEditReplayDiagnosticScope = 'replay' | 'edit' | string;
+
+export interface SemanticEditReplayDiagnostic {
+  readonly code: string;
+  readonly category: SemanticEditReplayDiagnosticCategory;
+  readonly severity: SemanticEditReplayDiagnosticSeverity;
+  readonly scope: SemanticEditReplayDiagnosticScope;
+  readonly status?: SemanticEditReplayStatus | string;
+  readonly operationId?: string;
+  readonly sourcePath?: string;
+  readonly symbolName?: string;
+  readonly symbolKind?: string;
+  readonly editKind?: 'replace' | 'insert' | 'delete' | string;
+  readonly start?: number;
+  readonly end?: number;
+  readonly expectedHash?: string;
+  readonly actualHash?: string;
+  readonly replacementHash?: string;
+  readonly overlapOperationIds?: readonly string[];
+}

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

@@ -1,29 +1,21 @@
-import type {
-  EvidenceRecord,
-  FrontierSourceLanguage,
-  SemanticMergeReadiness,
-  SourceSpan
-} from '@shapeshift-labs/frontier-lang-kernel';
+import type { EvidenceRecord, FrontierSourceLanguage, SemanticMergeReadiness, SourceSpan } from '@shapeshift-labs/frontier-lang-kernel';
 import type { ImportNativeSourceOptions, NativeSourceImportResult } from './import-adapter-core.js';
-
-export type SemanticEditScriptOperationStatus =
-  | 'candidate'
-  | 'portable'
-  | 'already-applied'
-  | 'covered'
-  | 'needs-port'
-  | 'conflict'
-  | 'stale'
-  | 'blocked';
-
-export type SemanticEditScriptAdmissionStatus =
-  | 'auto-merge-candidate'
-  | 'needs-port'
-  | 'conflict'
-  | 'stale'
-  | 'blocked'
-  | 'evidence-only';
-
+import type { SemanticEditReplayDiagnostic } from './semantic-edit-replay-diagnostics.js';
+export type * from './semantic-edit-replay-diagnostics.js';
+export type SemanticEditScriptOperationStatus = 'candidate' | 'portable' | 'already-applied' | 'covered' | 'needs-port' | 'conflict' | 'stale' | 'blocked';
+export type SemanticEditScriptAdmissionStatus = 'auto-merge-candidate' | 'needs-port' | 'conflict' | 'stale' | 'blocked' | 'evidence-only';
+export interface SemanticEditInsertionAnchorCandidate {
+  readonly mode?: 'before' | 'after' | 'file-start' | 'file-end' | string;
+  readonly anchorKey?: string;
+  readonly anchorSymbolId?: string;
+  readonly anchorSymbolName?: string;
+  readonly anchorSymbolKind?: string;
+  readonly baseSpan?: SourceSpan;
+  readonly workerAnchorSpan?: SourceSpan;
+  readonly headSpan?: SourceSpan;
+  readonly sourcePath?: string;
+  readonly reasonCodes?: readonly string[];
+}
 export interface SemanticEditScriptOperation {
   readonly id: string;
   readonly kind: string;
@@ -39,6 +31,7 @@ export interface SemanticEditScriptOperation {
     readonly mode?: 'before' | 'after' | 'file-start' | 'file-end' | string;
     readonly anchorKey?: string; readonly anchorSymbolId?: string; readonly anchorSymbolName?: string; readonly anchorSymbolKind?: string;
     readonly baseSpan?: SourceSpan; readonly workerAnchorSpan?: SourceSpan; readonly headSpan?: SourceSpan; readonly sourcePath?: string;
+    readonly anchorCandidates?: readonly SemanticEditInsertionAnchorCandidate[];
     readonly insertedSymbolId?: string; readonly insertedSymbolName?: string; readonly insertedSymbolKind?: string;
     readonly insertedSourceSpan?: SourceSpan; readonly insertedSourcePath?: string;
     readonly reasonCodes?: readonly string[];
@@ -72,7 +65,6 @@ export interface SemanticEditScriptOperation {
   readonly evidenceIds?: readonly string[];
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface SemanticEditScriptSummary {
   readonly operations: number;
   readonly byStatus: Readonly<Record<string, number>>;
@@ -91,7 +83,6 @@ export interface SemanticEditScriptSummary {
   readonly sourceIdentityHashes?: readonly string[];
   readonly operationContentHashes?: readonly string[];
 }
-
 export interface SemanticEditScriptAdmission {
   readonly status: SemanticEditScriptAdmissionStatus;
   readonly action: 'run-gates-and-apply' | 'reanchor-or-human-port' | 'record-evidence' | 'block' | string;
@@ -103,7 +94,6 @@ export interface SemanticEditScriptAdmission {
   readonly conflictKeys: readonly string[];
   readonly evidenceIds: readonly string[];
 }
-
 export interface SemanticEditScript {
   readonly kind: 'frontier.lang.semanticEditScript';
   readonly version: 1;
@@ -125,12 +115,11 @@ export interface SemanticEditScript {
   readonly evidence: readonly EvidenceRecord[];
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface SemanticEditProjectionEdit {
   readonly operationId?: string;
   readonly status: 'applied' | 'already-applied';
   readonly kind?: string;
-  readonly editKind?: 'replace' | 'insert' | string;
+  readonly editKind?: 'replace' | 'insert' | 'delete' | string;
   readonly changeKind?: string;
   readonly anchorKey?: string;
   readonly conflictKey?: string;
@@ -163,9 +152,9 @@ export interface SemanticEditProjectionEdit {
   readonly insertionAnchorKey?: string;
   readonly insertionAnchorSymbolName?: string;
   readonly insertionAnchorSymbolKind?: string;
+  readonly insertionAnchorCandidates?: readonly SemanticEditInsertionAnchorCandidate[];
   readonly replacementText?: string;
 }
-
 export interface SemanticEditProjection {
   readonly kind: 'frontier.lang.semanticEditProjection';
   readonly version: 1;
@@ -191,23 +180,16 @@ export interface SemanticEditProjection {
   };
   readonly metadata?: Record<string, unknown>;
 }
-
-export type SemanticEditReplayStatus =
-  | 'accepted-clean'
-  | 'already-applied'
-  | 'conflict'
-  | 'stale'
-  | 'blocked'
-  | 'needs-port'
-  | 'evidence-only';
-
+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 editKind?: 'replace' | 'insert' | string;
+  readonly editKind?: 'replace' | 'insert' | 'delete' | string;
+  readonly editOrder?: number;
+  readonly sourceRangeKind?: string;
   readonly sourcePath?: string;
   readonly symbolName?: string;
   readonly symbolKind?: string;
@@ -217,8 +199,8 @@ export interface SemanticEditReplayEdit {
   readonly replacementBytes?: number;
   readonly replacementText?: string;
   readonly reasonCodes: readonly string[];
+  readonly diagnostics?: readonly SemanticEditReplayDiagnostic[];
 }
-
 export interface SemanticEditReplay {
   readonly kind: 'frontier.lang.semanticEditReplay';
   readonly version: 1;
@@ -236,6 +218,7 @@ export interface SemanticEditReplay {
   readonly edits: readonly SemanticEditReplayEdit[];
   readonly appliedOperations: readonly string[];
   readonly skippedOperations: readonly string[];
+  readonly diagnostics?: readonly SemanticEditReplayDiagnostic[];
   readonly admission: {
     readonly status: SemanticEditReplayStatus;
     readonly action: 'apply' | 'skip' | 'rerun-semantic-import' | 'human-review' | 'block' | string;
@@ -257,7 +240,6 @@ export interface SemanticEditReplay {
   };
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface ProjectSemanticEditScriptToSourceOptions {
   readonly id?: string;
   readonly script: SemanticEditScript;
@@ -266,18 +248,19 @@ export interface ProjectSemanticEditScriptToSourceOptions {
   readonly headSourcePath?: string;
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface ReplaySemanticEditProjectionOptions {
   readonly id?: string;
-  readonly projection: SemanticEditProjection;
-  readonly currentSourceText: string;
+  readonly projection?: SemanticEditProjection;
+  readonly semanticEditProjection?: SemanticEditProjection;
+  readonly currentSourceText?: string;
+  readonly headSourceText?: string;
   readonly currentSourcePath?: string;
+  readonly headSourcePath?: 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;
@@ -294,17 +277,36 @@ export interface CreateSemanticEditScriptOptions {
   readonly workerSourceText?: string;
   readonly afterSourceText?: string;
   readonly headSourceText?: string;
+  readonly baseSourcePath?: string;
+  readonly beforeSourcePath?: string;
+  readonly workerSourcePath?: string;
+  readonly afterSourcePath?: string;
   readonly headSourcePath?: string;
   readonly currentSourceText?: string;
+  readonly currentSourcePath?: string;
   readonly baseSourceHash?: string;
+  readonly beforeSourceHash?: string;
   readonly workerSourceHash?: string;
+  readonly afterSourceHash?: string;
   readonly headSourceHash?: string;
-  readonly generatedAt?: number;
+  readonly currentSourceHash?: string;
+  readonly baseMetadata?: Record<string, unknown>;
+  readonly beforeMetadata?: Record<string, unknown>;
+  readonly workerMetadata?: Record<string, unknown>;
+  readonly afterMetadata?: Record<string, unknown>;
+  readonly headMetadata?: Record<string, unknown>;
+  readonly currentMetadata?: Record<string, unknown>;
+  readonly workerChangeSetId?: string;
+  readonly headChangeSetId?: string;
+  readonly lineageInferenceId?: string;
+  readonly generatedAt?: number | string;
   readonly evidenceId?: string;
   readonly metadata?: Record<string, unknown>;
 }
-
+export interface CreateSemanticEditScriptRuntimeOptions {
+  readonly metadata?: Record<string, unknown>;
+}
 export declare const SemanticEditScriptAdmissionStatuses: readonly SemanticEditScriptAdmissionStatus[];
-export declare function createSemanticEditScript(input?: CreateSemanticEditScriptOptions): SemanticEditScript;
+export declare function createSemanticEditScript(input?: CreateSemanticEditScriptOptions, options?: CreateSemanticEditScriptRuntimeOptions): SemanticEditScript;
 export declare function projectSemanticEditScriptToSource(input: ProjectSemanticEditScriptToSourceOptions): SemanticEditProjection;
 export declare function replaySemanticEditProjection(input: ReplaySemanticEditProjectionOptions): SemanticEditReplay;

package/dist/declarations/semantic-lineage.d.ts

@@ -1,26 +1,32 @@
-import type { FrontierSourceLanguage, SourceSpan } from '@shapeshift-labs/frontier-lang-kernel';
-import type { EvidenceRecord, SemanticMergeReadiness } from '@shapeshift-labs/frontier-lang-kernel';
+import type { EvidenceRecord, FrontierSourceLanguage, SemanticMergeReadiness, SourceSpan } from '@shapeshift-labs/frontier-lang-kernel';
 import type { ImportNativeSourceOptions, NativeSourceImportResult } from './import-adapter-core.js';
-
 export type SemanticLineageEventKind = 'unchanged' | 'moved' | 'renamed' | 'split' | 'merged' | 'deleted' | 'recreated' | 'unknown' | string;
 export type SemanticLineageResolutionStatus = 'unchanged' | 'resolved' | 'ambiguous' | 'deleted' | 'recreated' | 'cycle' | 'max-depth' | 'not-found' | string;
-
 export interface SemanticAnchor {
-  readonly id?: string;
-  readonly key?: string;
-  readonly kind?: string;
-  readonly language?: FrontierSourceLanguage | string;
-  readonly sourcePath?: string;
-  readonly sourceHash?: string;
-  readonly symbolId?: string;
-  readonly symbolName?: string;
+  readonly id?: string; readonly key?: string; readonly kind?: string;
+  readonly language?: FrontierSourceLanguage | string; readonly sourcePath?: string; readonly sourceHash?: string;
+  readonly symbolId?: string; readonly symbolName?: string;
   readonly semanticPath?: readonly string[];
-  readonly signatureHash?: string;
-  readonly bodyHash?: string;
+  readonly signatureHash?: string; readonly bodyHash?: string;
   readonly sourceSpan?: SourceSpan;
+  readonly lineageEventIds?: readonly string[]; readonly terminalLineageEventIds?: readonly string[];
+  readonly lineageSourcePaths?: readonly string[]; readonly evidenceIds?: readonly string[];
+  readonly proofIds?: readonly string[]; readonly crdtOperationIds?: readonly string[]; readonly crdtHeads?: readonly string[];
+  readonly lineageEventKinds?: readonly SemanticLineageEventKind[]; readonly lineageReasonCodes?: readonly string[];
   readonly metadata?: Record<string, unknown>;
 }
-
+export interface CreateSemanticAnchorInput extends SemanticAnchor {
+  readonly ownershipKey?: string;
+  readonly conflictKey?: string;
+  readonly semanticKey?: string;
+  readonly anchorKind?: string;
+  readonly regionKind?: string;
+  readonly symbolKind?: string;
+  readonly pathSegments?: readonly string[];
+  readonly name?: string;
+  readonly hash?: string;
+  readonly span?: SourceSpan;
+}
 export interface SemanticLineageCrdtClock {
   readonly operationId?: string;
   readonly actor?: string;
@@ -30,7 +36,18 @@ export interface SemanticLineageCrdtClock {
   readonly stateVector?: Record<string, number>;
   readonly versionFrame?: Record<string, unknown>;
 }
-
+export interface SemanticLineageCrdtClockInput {
+  readonly operationId?: string;
+  readonly id?: string;
+  readonly actor?: string;
+  readonly actorId?: string;
+  readonly seq?: number;
+  readonly deps?: readonly string[] | string;
+  readonly heads?: readonly string[] | string;
+  readonly stateVector?: Record<string, number>;
+  readonly versionFrame?: Record<string, unknown>;
+  readonly frame?: Record<string, unknown>;
+}
 export interface SemanticLineageEvidence {
   readonly pathMatch?: boolean;
   readonly signatureHashMatch?: boolean;
@@ -40,7 +57,9 @@ export interface SemanticLineageEvidence {
   readonly confidence?: number;
   readonly command?: string;
 }
-
+export interface SemanticLineageEvidenceInput extends SemanticLineageEvidence {
+  readonly id?: string;
+}
 export interface SemanticLineageActor {
   readonly id?: string;
   readonly role?: string;
@@ -49,7 +68,9 @@ export interface SemanticLineageActor {
   readonly runId?: string;
   readonly metadata?: Record<string, unknown>;
 }
-
+export interface SemanticLineageActorInput extends SemanticLineageActor {
+  readonly actorId?: string;
+}
 export interface SemanticLineageEvent {
   readonly kind: 'frontier.lang.semanticLineageEvent';
   readonly version: 1;
@@ -69,34 +90,28 @@ export interface SemanticLineageEvent {
   readonly conflictKeys: readonly string[];
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface CreateSemanticLineageEventInput {
-  readonly id?: string;
-  readonly hash?: string;
-  readonly createdAt?: number | string;
-  readonly eventKind?: SemanticLineageEventKind;
-  readonly event?: SemanticLineageEventKind;
-  readonly kind?: SemanticLineageEventKind;
-  readonly from?: SemanticAnchor | string;
-  readonly fromAnchor?: SemanticAnchor | string;
-  readonly before?: SemanticAnchor | string;
-  readonly to?: readonly (SemanticAnchor | string)[] | SemanticAnchor | string;
-  readonly toAnchors?: readonly (SemanticAnchor | string)[] | SemanticAnchor | string;
-  readonly after?: readonly (SemanticAnchor | string)[] | SemanticAnchor | string;
-  readonly confidence?: number;
-  readonly actor?: SemanticLineageActor | string;
-  readonly actorId?: string;
-  readonly actorRole?: string;
-  readonly crdt?: SemanticLineageCrdtClock;
-  readonly clock?: SemanticLineageCrdtClock;
-  readonly operation?: SemanticLineageCrdtClock;
+  readonly id?: string; readonly hash?: string; readonly createdAt?: number | string;
+  readonly eventKind?: SemanticLineageEventKind; readonly event?: SemanticLineageEventKind; readonly kind?: SemanticLineageEventKind;
+  readonly from?: CreateSemanticAnchorInput | string;
+  readonly fromAnchor?: CreateSemanticAnchorInput | string;
+  readonly before?: CreateSemanticAnchorInput | string;
+  readonly to?: readonly (CreateSemanticAnchorInput | string)[] | CreateSemanticAnchorInput | string;
+  readonly toAnchors?: readonly (CreateSemanticAnchorInput | string)[] | CreateSemanticAnchorInput | string;
+  readonly after?: readonly (CreateSemanticAnchorInput | string)[] | CreateSemanticAnchorInput | string;
+  readonly confidence?: number; readonly actor?: SemanticLineageActorInput | string;
+  readonly actorId?: string; readonly actorRole?: string;
+  readonly crdt?: SemanticLineageCrdtClockInput;
+  readonly clock?: SemanticLineageCrdtClockInput;
+  readonly operation?: SemanticLineageCrdtClockInput;
   readonly operationId?: string;
   readonly seq?: number;
   readonly deps?: readonly string[] | string;
   readonly heads?: readonly string[] | string;
   readonly stateVector?: Record<string, number>;
   readonly versionFrame?: Record<string, unknown>;
-  readonly evidence?: SemanticLineageEvidence | readonly { readonly id?: string }[];
+  readonly frame?: Record<string, unknown>;
+  readonly evidence?: SemanticLineageEvidenceInput | readonly SemanticLineageEvidenceInput[];
   readonly pathMatch?: boolean;
   readonly signatureHashMatch?: boolean;
   readonly bodyHashMatch?: boolean;
@@ -110,7 +125,6 @@ export interface CreateSemanticLineageEventInput {
   readonly conflictKeys?: readonly string[] | string;
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface SemanticLineageMap {
   readonly kind: 'frontier.lang.semanticLineageMap';
   readonly version: 1;
@@ -128,7 +142,6 @@ export interface SemanticLineageMap {
     readonly eventKinds: readonly string[];
   };
 }
-
 export interface SemanticLineageResolutionQuery {
   readonly id?: string;
   readonly anchor?: SemanticAnchor | string;
@@ -142,7 +155,6 @@ export interface SemanticLineageResolutionQuery {
   readonly generatedAt?: number | string;
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface SemanticLineageResolution {
   readonly kind: 'frontier.lang.semanticLineageResolution';
   readonly version: 1;
@@ -161,6 +173,7 @@ export interface SemanticLineageResolution {
   readonly currentAnchors: readonly SemanticAnchor[];
   readonly traversedEventIds: readonly string[];
   readonly terminalEventIds: readonly string[];
+  readonly sourcePaths: readonly string[];
   readonly status: SemanticLineageResolutionStatus;
   readonly confidence?: number;
   readonly conflictKeys: readonly string[];
@@ -172,7 +185,6 @@ export interface SemanticLineageResolution {
   readonly reasonCodes: readonly string[];
   readonly metadata?: Record<string, unknown>;
 }
-
 export interface SemanticLineageQuery {
   readonly eventKind?: SemanticLineageEventKind | readonly string[];
   readonly anchorKey?: string | readonly string[];
@@ -184,7 +196,6 @@ export interface SemanticLineageQuery {
   readonly conflictKey?: string | readonly string[];
   readonly evidenceId?: string | readonly string[];
 }
-
 export interface SemanticLineageInferredAnchorSummary {
   readonly key?: string;
   readonly id?: string;
@@ -193,24 +204,24 @@ export interface SemanticLineageInferredAnchorSummary {
   readonly language?: FrontierSourceLanguage | string;
   readonly sourcePath?: string;
   readonly sourceHash?: string;
+  readonly identityHash?: string;
+  readonly semanticIdentityHash?: string;
+  readonly sourceIdentityHash?: string;
   readonly sourceSpan?: SourceSpan;
   readonly signatureHash?: string;
   readonly bodyHash?: string;
   readonly ownershipRegionKind?: string;
 }
-
 export interface SemanticLineageAmbiguousCandidate {
   readonly after: SemanticLineageInferredAnchorSummary;
   readonly confidence: number;
   readonly reasons: readonly string[];
 }
-
 export interface SemanticLineageAmbiguousMatch {
   readonly before: SemanticLineageInferredAnchorSummary;
   readonly candidates: readonly SemanticLineageAmbiguousCandidate[];
   readonly reasonCodes: readonly string[];
 }
-
 export interface SemanticLineageInferenceResult {
   readonly kind: 'frontier.lang.semanticLineageInference';
   readonly version: 1;
@@ -236,6 +247,8 @@ export interface SemanticLineageInferenceResult {
     readonly inferredEvents: number;
     readonly moved: number;
     readonly renamed: number;
+    readonly split: number;
+    readonly recreated: number;
     readonly deleted: number;
     readonly ambiguous: number;
     readonly unmatchedAdded: number;
@@ -251,7 +264,6 @@ export interface SemanticLineageInferenceResult {
     readonly [key: string]: unknown;
   };
 }
-
 export interface InferSemanticLineageEventsOptions {
   readonly id?: string;
   readonly before?: NativeSourceImportResult | ImportNativeSourceOptions;
@@ -277,11 +289,10 @@ export interface InferSemanticLineageEventsOptions {
   readonly stateVector?: Record<string, number>;
   readonly metadata?: Record<string, unknown>;
 }
-
 export declare const SemanticLineageEventKinds: readonly SemanticLineageEventKind[];
 export declare const SemanticLineageResolutionStatuses: readonly SemanticLineageResolutionStatus[];
-export declare function createSemanticAnchor(input?: SemanticAnchor | string, defaults?: Partial<SemanticAnchor>): SemanticAnchor | undefined;
-export declare function createSemanticLineageEvent(input?: CreateSemanticLineageEventInput, options?: { readonly id?: string; readonly createdAt?: number | string; readonly actor?: SemanticLineageActor | string; readonly actorId?: string; readonly actorRole?: string }): SemanticLineageEvent;
+export declare function createSemanticAnchor(input?: CreateSemanticAnchorInput | string, defaults?: Partial<SemanticAnchor>): SemanticAnchor | undefined;
+export declare function createSemanticLineageEvent(input?: CreateSemanticLineageEventInput, options?: { readonly id?: string; readonly createdAt?: number | string; readonly actor?: SemanticLineageActorInput | string; readonly actorId?: string; readonly actorRole?: string }): SemanticLineageEvent;
 export declare function createSemanticLineageMap(events?: readonly (SemanticLineageEvent | CreateSemanticLineageEventInput)[], options?: { readonly id?: string; readonly generatedAt?: number | string }): SemanticLineageMap;
 export declare function inferSemanticLineageEvents(input?: InferSemanticLineageEventsOptions, options?: { readonly metadata?: Record<string, unknown>; readonly deletedConfidence?: number }): SemanticLineageInferenceResult;
 export declare function querySemanticLineageEvents(events: SemanticLineageEvent | readonly SemanticLineageEvent[], query?: SemanticLineageQuery): readonly SemanticLineageEvent[];

package/dist/declarations/semantic-merge-candidates.d.ts

@@ -9,6 +9,41 @@ import type { NativeSourceChangeKind, NativeSourceChangeSet } from './native-dif
 import type { SemanticMergeConflictSummary } from './semantic-merge-conflicts.js';
 
 export type SemanticMergeCandidateProjectionRisk = 'low' | 'medium' | 'high' | 'unknown';
+export type SemanticMergeCandidateScoreFacetKey =
+  | 'ownership'
+  | 'staleStatus'
+  | 'testEvidence'
+  | 'overlap'
+  | 'size'
+  | 'semanticSidecarQuality';
+export type SemanticMergeCandidateScoreFacetStatus = 'strong' | 'partial' | 'weak' | 'blocked';
+
+export interface SemanticMergeCandidateScoreFacet {
+  readonly key: SemanticMergeCandidateScoreFacetKey;
+  readonly score: number;
+  readonly weight: number;
+  readonly weightedScore: number;
+  readonly status: SemanticMergeCandidateScoreFacetStatus;
+  readonly reasonCodes: readonly string[];
+  readonly signals: Record<string, unknown>;
+}
+
+export interface SemanticMergeCandidateScoreFacets {
+  readonly schema: 'frontier.lang.semanticMergeCandidateScoreFacets.v1';
+  readonly version: 1;
+  readonly higherIsBetter: true;
+  readonly value: number;
+  readonly risk: 'low' | 'medium' | 'high';
+  readonly components: Record<SemanticMergeCandidateScoreFacetKey, SemanticMergeCandidateScoreFacet>;
+  readonly summary: {
+    readonly value: number;
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly lowestScore: number;
+    readonly weakFacets: readonly SemanticMergeCandidateScoreFacetKey[];
+    readonly blockedFacets: readonly SemanticMergeCandidateScoreFacetKey[];
+    readonly availableFacets: readonly SemanticMergeCandidateScoreFacetKey[];
+  };
+}
 
 export interface SemanticMergeCandidateChangedRegion {
   readonly id?: string;
@@ -88,11 +123,13 @@ export interface SemanticMergeCandidateAdmissionRecord {
     readonly conflictKeys: readonly string[];
     readonly pairs: readonly SemanticMergeCandidateOverlapRecord[];
   };
+  readonly scoreFacets: SemanticMergeCandidateScoreFacets;
   readonly admission: {
     readonly readiness: SemanticMergeReadiness | string;
     readonly reviewRequired: boolean;
     readonly action: 'admit' | 'prioritize-review' | 'block' | string;
     readonly sortKey: number;
+    readonly scoreFacets: SemanticMergeCandidateScoreFacets;
     readonly reasonCodes: readonly string[];
     readonly conflictKeys: readonly string[];
   };
@@ -122,6 +159,7 @@ export interface SemanticMergeCandidateAdmissionRecord {
     readonly readiness: SemanticMergeReadiness | string;
     readonly projectionRisk: SemanticMergeCandidateProjectionRisk;
     readonly reviewRequired: boolean;
+    readonly scoreFacets: SemanticMergeCandidateScoreFacets['summary'];
   };
   readonly metadata?: Record<string, unknown> & {
     readonly conflictSummary?: SemanticMergeConflictSummary;
@@ -166,6 +204,7 @@ export type SemanticMergeCandidateWithAdmission = SemanticMergeCandidateRecord &
   readonly proofIds?: readonly string[];
   readonly projectionRisk?: SemanticMergeCandidateProjectionRisk;
   readonly readinessSortKey?: number;
+  readonly scoreFacets?: SemanticMergeCandidateScoreFacets;
   readonly mergeAdmission?: SemanticMergeCandidateAdmissionRecord;
 };
 

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

@@ -90,6 +90,7 @@ export interface SemanticPatchBundleAdmission {
   readonly autoApplyCandidate?: boolean;
   readonly transformAdmission?: SemanticPatchBundleTransformAdmission;
   readonly semanticEditAdmission?: SemanticEditBundleAdmission;
+  readonly evidenceAdmission?: SemanticPatchBundleEvidenceAdmission;
   readonly reasonCodes?: readonly string[];
   readonly conflictKeys?: readonly string[];
   readonly admittedAt?: number | string;
@@ -98,6 +99,18 @@ export interface SemanticPatchBundleAdmission {
   readonly metadata?: Record<string, unknown>;
 }
 
+export interface SemanticPatchBundleEvidenceAdmission {
+  readonly status: 'none' | 'ready' | 'needs-review' | 'stale' | 'blocked' | string;
+  readonly action: 'none' | 'admit' | 'review' | 'rerun-semantic-import' | 'block' | string;
+  readonly readiness: SemanticMergeReadiness | string;
+  readonly reasonCodes?: readonly string[];
+  readonly evidenceIds?: readonly string[];
+  readonly passed?: number;
+  readonly failed?: number;
+  readonly conflict?: number;
+  readonly stale?: number;
+}
+
 export interface SemanticPatchBundleTransformAdmission {
   readonly status: 'none' | 'ready' | 'needs-review' | 'blocked' | string;
   readonly action: 'none' | 'admit' | 'review' | 'block' | string;

package/dist/declarations/semantic-sidecar-admission.d.ts

@@ -8,6 +8,16 @@ export interface SemanticImportSidecarQualityWarning {
   readonly sourcePaths: readonly string[];
 }
 
+export type SemanticImportSidecarRecordClassification = 'useful' | 'expected-empty' | 'unexpectedly-empty' | 'missing' | string;
+
+export interface SemanticImportSidecarQualityRecord {
+  readonly classification: SemanticImportSidecarRecordClassification;
+  readonly reasonCode: string;
+  readonly message: string;
+  readonly action: string;
+  readonly sourcePaths: readonly string[];
+}
+
 export interface SemanticImportSidecarProofAdmissionSummary {
   readonly total: number;
   readonly obligations: number;
@@ -26,12 +36,14 @@ export interface SemanticImportSidecarProofAdmissionSummary {
 export interface SemanticImportSidecarQuality {
   readonly schema: 'frontier.lang.semanticSidecarQuality.v1';
   readonly expected: boolean;
+  readonly expectedEmpty: boolean;
   readonly expectedSatisfied: boolean;
   readonly expectedMissingReasonCodes: readonly string[];
   readonly selected: boolean;
   readonly eligible: boolean;
   readonly imported: boolean;
   readonly importCount: number;
+  readonly record: SemanticImportSidecarQualityRecord;
   readonly symbolCount: number;
   readonly ownershipRegionCount: number;
   readonly patchHintCount: number;
@@ -45,6 +57,7 @@ export interface SemanticImportSidecarQuality {
 export interface SemanticImportSidecarAdmission {
   readonly schema: 'frontier.lang.semanticSidecarAdmission.v1';
   readonly expected: boolean;
+  readonly expectedEmpty: boolean;
   readonly expectedSatisfied: boolean;
   readonly expectedMissingReasonCodes: readonly string[];
   readonly selected: boolean;
@@ -53,6 +66,7 @@ export interface SemanticImportSidecarAdmission {
   readonly importCount: number;
   readonly readiness: SemanticMergeReadiness;
   readonly action: string;
+  readonly record: SemanticImportSidecarQualityRecord;
   readonly counts: {
     readonly symbols: number;
     readonly ownershipRegions: number;