@shapeshift-labs/frontier-lang-compiler 0.2.58 → 0.2.59

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

@@ -24,6 +24,9 @@ export interface SemanticImportSidecarProofAdmissionSummary {
 
 export interface SemanticImportSidecarQuality {
   readonly schema: 'frontier.lang.semanticSidecarQuality.v1';
+  readonly expected: boolean;
+  readonly expectedSatisfied: boolean;
+  readonly expectedMissingReasonCodes: readonly string[];
   readonly selected: boolean;
   readonly eligible: boolean;
   readonly imported: boolean;
@@ -40,6 +43,9 @@ export interface SemanticImportSidecarQuality {
 
 export interface SemanticImportSidecarAdmission {
   readonly schema: 'frontier.lang.semanticSidecarAdmission.v1';
+  readonly expected: boolean;
+  readonly expectedSatisfied: boolean;
+  readonly expectedMissingReasonCodes: readonly string[];
   readonly selected: boolean;
   readonly eligible: boolean;
   readonly imported: boolean;

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

@@ -304,8 +304,8 @@ export interface SemanticImportSidecar {
     readonly dependencyRelations: number; readonly dependencyPredicates: readonly string[];
     readonly patchHints: number;
     readonly evidenceWarnings: number;
-    readonly readiness: SemanticMergeReadiness;
-    readonly emptySemanticIndex: boolean;
+    readonly semanticImportExpected: boolean; readonly semanticImportExpectedSatisfied: boolean; readonly semanticImportExpectedMissingReasonCodes: readonly string[];
+    readonly readiness: SemanticMergeReadiness; readonly emptySemanticIndex: boolean;
   };
   readonly metadata?: Record<string, unknown>;
 }
@@ -314,6 +314,6 @@ export interface SemanticImportSidecarOptions {
   readonly id?: string;
   readonly generatedAt?: number;
   readonly regionPrefix?: string;
-  readonly targetPath?: string;
+  readonly targetPath?: string; readonly expected?: boolean; readonly semanticImportExpected?: boolean;
   readonly metadata?: Record<string, unknown>;
 }

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

@@ -28,6 +28,7 @@ export function createSemanticImportSidecar(importResult, options = {}) {
   );
   const patchHints = ownershipRegions.map((region) => semanticPatchHintForRegion(region, readiness, options));
   const quality = createSemanticImportSidecarQuality({
+    expected: options.expected === true || options.semanticImportExpected === true,
     importEntries,
     symbols,
     ownershipRegions,
@@ -102,6 +103,9 @@ export function createSemanticImportSidecar(importResult, options = {}) {
       dependencyPredicates: dependencies.predicates,
       patchHints: patchHints.length,
       evidenceWarnings: quality.emptyEvidenceWarnings.length,
+      semanticImportExpected: quality.expected,
+      semanticImportExpectedSatisfied: quality.expectedSatisfied,
+      semanticImportExpectedMissingReasonCodes: quality.expectedMissingReasonCodes,
       readiness,
       emptySemanticIndex: symbols.length === 0
     },

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

@@ -14,15 +14,28 @@ function sidecarQualityWarning(code, message, action, sourcePaths) {
 
 export function createSemanticImportSidecarQuality(input) {
   const { importEntries, symbols, ownershipRegions, patchHints, proofSpec, evidence, readiness } = input;
+  const expected = input.expected === true;
   const sourcePaths = sidecarSourcePaths(importEntries);
   const importCount = importEntries.length;
   const warnings = [];
+  if (expected && importCount === 0) warnings.push(sidecarQualityWarning(
+    'expected-semantic-import-missing',
+    'Semantic import was expected but no import entries were selected.',
+    'check-semantic-import-include-globs-and-workspace-paths',
+    sourcePaths
+  ));
   if (importCount === 0) warnings.push(sidecarQualityWarning(
     'missing-imports',
     'Semantic sidecar has no import entries; run native import before merge admission.',
     'run-native-import',
     sourcePaths
   ));
+  if (expected && importCount > 0 && symbols.length === 0) warnings.push(sidecarQualityWarning(
+    'expected-semantic-import-empty',
+    'Semantic import was expected but selected imports produced zero semantic symbols.',
+    'rerun-importer-with-semantic-source-selection',
+    sourcePaths
+  ));
   if (importCount > 0 && symbols.length === 0) warnings.push(sidecarQualityWarning(
     'empty-semantic-index',
     'Semantic sidecar has import entries but no semantic symbols.',
@@ -86,9 +99,21 @@ export function createSemanticImportSidecarQuality(input) {
   const emptyEvidenceWarnings = warnings.filter((warning) => (
     warning.code === 'empty-evidence' ||
     warning.code === 'empty-semantic-index' ||
+    warning.code === 'expected-semantic-import-empty' ||
+    warning.code === 'expected-semantic-import-missing' ||
     warning.code === 'missing-ownership-regions' ||
     warning.code === 'missing-patch-hints'
   ));
+  const expectedMissingReasonCodes = expected
+    ? emptyEvidenceWarnings.map((warning) => warning.code)
+    : [];
+  const expectedSatisfied = !expected || (
+    importCount > 0 &&
+    symbols.length > 0 &&
+    ownershipRegions.length > 0 &&
+    patchHints.length > 0 &&
+    evidence.length > 0
+  );
   const proofSummary = {
     total: proofSpec.total,
     obligations: proofSpec.obligations,
@@ -104,6 +129,9 @@ export function createSemanticImportSidecarQuality(input) {
   };
   return {
     schema: 'frontier.lang.semanticSidecarQuality.v1',
+    expected,
+    expectedSatisfied,
+    expectedMissingReasonCodes,
     selected: importCount > 0,
     eligible: importCount > 0 && emptyEvidenceWarnings.length === 0 && proofSpec.failed === 0 && readiness !== 'blocked',
     imported: importCount > 0,
@@ -122,6 +150,9 @@ export function createSemanticImportSidecarQuality(input) {
 export function createSemanticImportSidecarAdmission(quality, readiness) {
   return {
     schema: 'frontier.lang.semanticSidecarAdmission.v1',
+    expected: quality.expected,
+    expectedSatisfied: quality.expectedSatisfied,
+    expectedMissingReasonCodes: quality.expectedMissingReasonCodes,
     selected: quality.selected,
     eligible: quality.eligible,
     imported: quality.imported,

package/package.json

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