@shapeshift-labs/frontier-lang-compiler 0.2.33 → 0.2.35

package/README.md

@@ -465,8 +465,8 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-workflow`](https://www.npmjs.com/package/@shapeshift-labs/frontier-workflow): Serializable durable workflow/process manifests for Frontier apps, including steps, waits, approvals, timers, retries, expected patches, compensation, records, timelines, and registry graph output.
 - [`@shapeshift-labs/frontier-worker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-worker): Serializable worker and edge task descriptors for Frontier apps, including queues, idempotency keys, retry and timeout policy, declared reads/writes/effects, snapshots, patch outputs, produced assets, execution records, logs, trace links, proof hashes, dedupe indexes, and registry graph output.
 - [`@shapeshift-labs/frontier-queue`](https://www.npmjs.com/package/@shapeshift-labs/frontier-queue): Serializable durable queue state, leases, retries, dedupe keys, patch-carrying jobs, dead-letter records, replay evidence, and queue inspection for Frontier apps.
-- [`@shapeshift-labs/frontier-swarm`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm): Hierarchical swarm plans, lanes, compute profiles, ownership policy, semantic ownership regions, task queues, event streams, run records, merge bundles, merge indexes, queue overlays, merge admission, changed-path checks, and proof artifacts for Frontier agent work.
-- [`@shapeshift-labs/frontier-swarm-codex`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-codex): Node Codex CLI adapter for Frontier swarm plans, including prompt rendering, worktree and snapshot workspaces, Codex argument compatibility, browser resource allocation, JSONL capture, verification commands, pid-backed stop, collect/apply workflows, merge indexes, queue overlays, merge bundles, and result artifacts.
+- [`@shapeshift-labs/frontier-swarm`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm): Hierarchical swarm plans, lanes, compute profiles, ownership policy, semantic ownership regions, task queues, event streams, run records, merge bundles, merge indexes, queue overlays, merge admission, coordinator dashboards, changed-path checks, and proof artifacts for Frontier agent work.
+- [`@shapeshift-labs/frontier-swarm-codex`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-codex): Node Codex CLI adapter for Frontier swarm plans, including prompt rendering, worktree and snapshot workspaces, Codex argument compatibility, browser resource allocation, JSONL capture, verification commands, pid-backed stop, collect/apply workflows, merge indexes, queue overlays, merge bundles, normalized job evidence, coordinator query artifacts, and result artifacts.
 - [`@shapeshift-labs/frontier-lang-kernel`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kernel): Runtime-neutral semantic source graph, type/lattice/extern declarations, patch bundles, replay, hashing, evidence records, and merge-admission kernel for Frontier Lang.
 - [`@shapeshift-labs/frontier-lang-parser`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-parser): Dependency-light Frontier Lang parser for modules, entities, state, actions, effects, types, externs, targets, and lattice declarations.
 - [`@shapeshift-labs/frontier-lang-checker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-checker): Checker and diagnostics for Frontier Lang semantic documents, including type symbols, effects, regions, lattice laws, CRDT metadata, and patch evidence.
@@ -476,6 +476,7 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-lang-python`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-python): Python projection adapter for Frontier Lang semantic documents, including dataclasses, typed patch records, and action stubs.
 - [`@shapeshift-labs/frontier-lang-c`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-c): C header projection adapter for Frontier Lang semantic documents, including structs and action prototypes.
 - [`@shapeshift-labs/frontier-lang-swift`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-swift): Swift source-language importer package for Frontier Lang semantic documents, including package-level metadata, SwiftSyntax adapter helpers, native import results, and semantic sidecar generation for SwiftSyntax/SwiftParser-shaped syntax trees.
+- [`@shapeshift-labs/frontier-lang-kotlin`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kotlin): Kotlin PSI source-language importer package for Frontier Lang semantic documents, including package-level metadata, Kotlin PSI adapter helpers, native import results, and semantic sidecar generation for Kotlin PSI/KtFile-shaped syntax trees.
 - [`@shapeshift-labs/frontier-lang-java`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-java): Java source-language importer package for Frontier Lang semantic documents, including package-level metadata, Java AST adapter helpers, native import results, and semantic sidecar generation for javac/JDT/JavaParser-shaped ASTs.
 - [`@shapeshift-labs/frontier-lang-go`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-go): Go source-language importer package for Frontier Lang semantic documents, including package-level metadata, Go AST adapter helpers, native import results, and semantic sidecar generation for go/ast File or Package trees.
 - [`@shapeshift-labs/frontier-lang-csharp`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-csharp): C# Roslyn source-language importer package for Frontier Lang semantic documents, including package-level metadata, Roslyn adapter helpers, native import results, and semantic sidecar generation for SyntaxTree/SyntaxNode-shaped ASTs.
@@ -568,6 +569,7 @@ Package source repositories:
 - [`siliconjungle/-shapeshift-labs-frontier-lang-c`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-c)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-compiler`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-compiler)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-swift`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-swift)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-kotlin`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-kotlin)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-java`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-java)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-go`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-go)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-csharp`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-csharp)

package/bench/smoke.mjs

@@ -10,6 +10,7 @@ import {
   createKotlinPsiNativeImporterAdapter,
   createNativeImportCoverageMatrix,
   createNativeParserAstFormatMatrix,
+  createNativeParserFeatureMatrix,
   createProjectionTargetLossMatrix,
   createNativeSourcePreservation,
   createPythonAstNativeImporterAdapter,
@@ -20,6 +21,7 @@ import {
   importExternalSemanticIndex,
   importNativeSource,
   projectNativeImportToSource,
+  queryNativeParserFeatureMatrix,
   runNativeImporterAdapter,
   summarizeNativeImportFeatureEvidence
 } from '../dist/index.js';
@@ -121,6 +123,19 @@ const parserFormatMatrix = createNativeParserAstFormatMatrix({
 });
 const parserFormatMatrixDurationMs = performance.now() - parserFormatMatrixStart;
 
+const parserFeatureMatrixStart = performance.now();
+const parserFeatureMatrix = createNativeParserFeatureMatrix({
+  imports: nativeImportResults,
+  adapters: [estreeAdapter, createPythonAstNativeImporterAdapter(), createRustSynNativeImporterAdapter(), createClangAstNativeImporterAdapter(), createGoAstNativeImporterAdapter(), createJavaAstNativeImporterAdapter(), kotlinPsiAdapter, createCSharpRoslynNativeImporterAdapter(), createSwiftSyntaxNativeImporterAdapter()],
+  requiredFeatures: ['syntax', 'semantic', 'sourcePreservation']
+});
+const parserFeatureQuery = queryNativeParserFeatureMatrix(parserFeatureMatrix, {
+  language: 'javascript',
+  parser: 'estree',
+  requiredFeatures: ['syntax', 'semantic', 'sourcePreservation']
+});
+const parserFeatureMatrixDurationMs = performance.now() - parserFeatureMatrixStart;
+
 const projectionMatrixStart = performance.now();
 const projectionLossMatrix = createProjectionTargetLossMatrix({ imports: nativeImportResults });
 const projectionMatrixDurationMs = performance.now() - projectionMatrixStart;
@@ -280,6 +295,11 @@ console.log(JSON.stringify({
   parserFormatMatrixImports: parserFormatMatrix.summary.imports,
   parserFormatMatrixNativeAstNodes: parserFormatMatrix.summary.nativeAstNodes,
   parserFormatMatrixDurationMs: Number(parserFormatMatrixDurationMs.toFixed(2)),
+  parserFeatureMatrixParsers: parserFeatureMatrix.summary.parsers,
+  parserFeatureMatrixMergeReady: parserFeatureMatrix.summary.mergeReady,
+  parserFeatureMatrixSyntaxFull: parserFeatureMatrix.summary.byFeatureStatus.syntax?.full ?? 0,
+  parserFeatureQueryMergeReady: parserFeatureQuery.merge.mergeReady,
+  parserFeatureMatrixDurationMs: Number(parserFeatureMatrixDurationMs.toFixed(2)),
   projectionMatrixLanguages: projectionLossMatrix.summary.languages,
   projectionMatrixMissingAdapters: projectionLossMatrix.summary.missingAdapters,
   projectionMatrixUnsupportedTargetFeatures: projectionLossMatrix.summary.unsupportedTargetFeatures,

package/dist/index.d.ts

@@ -18,6 +18,8 @@ import type {
   SemanticPatchBundle,
   SourceMapMappingRecord,
   SourceMapRecord,
+  SourcePreservationLevel,
+  SourcePreservationRecord,
   SourceSpan
 } from '@shapeshift-labs/frontier-lang-kernel';
 import type { Diagnostic } from '@shapeshift-labs/frontier-lang-checker';
@@ -318,6 +320,161 @@ export interface NativeParserAstFormatMatrixOptions {
   readonly generatedAt?: number;
 }
 
+export type NativeParserFeatureCategory =
+  | 'syntax'
+  | 'semantic'
+  | 'type'
+  | 'controlFlow'
+  | 'macroMetaprogramming'
+  | 'sourcePreservation'
+  | string;
+
+export type NativeParserFeatureCoverageStatus =
+  | 'full'
+  | 'partial'
+  | 'evidence-required'
+  | 'missing'
+  | 'blocked'
+  | 'not-applicable'
+  | string;
+
+export interface NativeParserFeatureCoverage {
+  readonly category: NativeParserFeatureCategory;
+  readonly status: NativeParserFeatureCoverageStatus;
+  readonly readiness: SemanticMergeReadiness;
+  readonly mergeReady: boolean;
+  readonly supported: boolean;
+  readonly capabilities: Readonly<Record<string, unknown>>;
+  readonly gaps: readonly string[];
+  readonly lossKinds: Readonly<Record<string, number>>;
+  readonly reasons: readonly string[];
+  readonly notes: readonly string[];
+}
+
+export interface NativeParserFeatureCoverageMap {
+  readonly syntax: NativeParserFeatureCoverage;
+  readonly semantic: NativeParserFeatureCoverage;
+  readonly type: NativeParserFeatureCoverage;
+  readonly controlFlow: NativeParserFeatureCoverage;
+  readonly macroMetaprogramming: NativeParserFeatureCoverage;
+  readonly sourcePreservation: NativeParserFeatureCoverage;
+  readonly [category: string]: NativeParserFeatureCoverage;
+}
+
+export interface NativeParserFeatureMergeAssessment {
+  readonly mergeReady: boolean;
+  readonly readiness: SemanticMergeReadiness;
+  readonly requiredFeatures: readonly NativeParserFeatureCategory[];
+  readonly minimumReadiness: SemanticMergeReadiness;
+  readonly blockingFeatures: readonly NativeParserFeatureCategory[];
+  readonly reviewFeatures: readonly NativeParserFeatureCategory[];
+  readonly reasons: readonly string[];
+}
+
+export interface NativeParserFeatureParserRow {
+  readonly language: FrontierSourceLanguage | string;
+  readonly aliases: readonly string[];
+  readonly parser: string;
+  readonly parserFormat: string;
+  readonly parserAliases: readonly string[];
+  readonly parserAdapters: readonly string[];
+  readonly extensions: readonly string[];
+  readonly supportsLightweightScan: boolean;
+  readonly projectionTargets: readonly (FrontierCompileTarget | string)[];
+  readonly knownLossKinds: readonly NativeImportKnownLossKind[];
+  readonly defaultReadiness: SemanticMergeReadiness;
+  readonly notes: readonly string[];
+  readonly adapters: {
+    readonly total: number;
+    readonly ids: readonly string[];
+    readonly versions: readonly string[];
+    readonly exactness: readonly NativeImporterAdapterExactness[];
+    readonly coverage: NativeImporterAdapterCoverageAggregate;
+  };
+  readonly imports: {
+    readonly total: number;
+    readonly sourcePaths: readonly string[];
+    readonly readiness: SemanticMergeReadiness;
+    readonly readinessReasons: readonly string[];
+    readonly nativeAstNodes: number;
+    readonly symbols: number;
+    readonly references: number;
+    readonly types: number;
+    readonly controlFlow: number;
+    readonly sourceMaps: number;
+    readonly sourceMapMappings: number;
+    readonly losses: number;
+    readonly lossKinds: Readonly<Record<string, number>>;
+    readonly lossCategories: readonly NativeImportTaxonomyKind[];
+    readonly sourcePreservation: NativeImportSourcePreservationContract;
+  };
+  readonly features: NativeParserFeatureCoverageMap;
+  readonly merge: NativeParserFeatureMergeAssessment;
+}
+
+export interface NativeParserFeatureLanguageSummary {
+  readonly language: FrontierSourceLanguage | string;
+  readonly aliases: readonly string[];
+  readonly parserRows: number;
+  readonly parsers: readonly string[];
+  readonly imports: number;
+  readonly adapters: number;
+  readonly mergeReadyParsers: readonly string[];
+  readonly readiness: SemanticMergeReadiness;
+}
+
+export interface NativeParserFeatureMatrix {
+  readonly kind: 'frontier.lang.nativeParserFeatureMatrix';
+  readonly version: 1;
+  readonly generatedAt: number;
+  readonly parsers: readonly NativeParserFeatureParserRow[];
+  readonly languages: readonly NativeParserFeatureLanguageSummary[];
+  readonly summary: {
+    readonly languages: number;
+    readonly parsers: number;
+    readonly imports: number;
+    readonly adapters: number;
+    readonly mergeReady: number;
+    readonly byReadiness: Readonly<Record<SemanticMergeReadiness, number>>;
+    readonly byFeatureStatus: Readonly<Record<NativeParserFeatureCategory, Readonly<Record<NativeParserFeatureCoverageStatus, number>>>>;
+    readonly byFeatureReadiness: Readonly<Record<NativeParserFeatureCategory, Readonly<Record<SemanticMergeReadiness, number>>>>;
+  };
+  readonly metadata: {
+    readonly categories: readonly NativeParserFeatureCategory[];
+    readonly statuses: readonly NativeParserFeatureCoverageStatus[];
+    readonly requiredFeatures: readonly NativeParserFeatureCategory[];
+    readonly minimumReadiness: SemanticMergeReadiness;
+    readonly note: string;
+  };
+}
+
+export interface NativeParserFeatureMatrixOptions {
+  readonly languages?: readonly NativeImportLanguageProfile[];
+  readonly imports?: readonly NativeSourceImportResult[];
+  readonly adapters?: readonly NativeImporterAdapter[];
+  readonly requiredFeatures?: readonly NativeParserFeatureCategory[];
+  readonly minimumReadiness?: SemanticMergeReadiness;
+  readonly includeEmptyParsers?: boolean;
+  readonly generatedAt?: number;
+}
+
+export interface NativeParserFeatureMatrixQuery {
+  readonly language?: FrontierSourceLanguage | string;
+  readonly parser?: string;
+  readonly requiredFeatures?: readonly NativeParserFeatureCategory[];
+  readonly minimumReadiness?: SemanticMergeReadiness;
+}
+
+export interface NativeParserFeatureMatrixQueryResult {
+  readonly kind: 'frontier.lang.nativeParserFeatureQuery';
+  readonly version: 1;
+  readonly found: boolean;
+  readonly language?: FrontierSourceLanguage | string;
+  readonly parser?: string;
+  readonly row?: NativeParserFeatureParserRow;
+  readonly merge: NativeParserFeatureMergeAssessment;
+}
+
 export interface NativeImporterAdapterCoverageAggregate {
   readonly total: number;
   readonly declared: Readonly<Record<string, number>>;
@@ -804,11 +961,31 @@ export interface SemanticImportSidecarImportEntry {
   readonly symbolCount: number;
   readonly sourceMapCount: number;
   readonly sourceMapMappingCount: number;
+  readonly sourcePreservationRecordCount: number;
+  readonly sourcePreservationLevels: readonly SourcePreservationLevel[];
   readonly readiness: SemanticMergeReadiness;
   readonly emptySemanticIndex: boolean;
   readonly regionTaxonomy?: SemanticImportRegionTaxonomySummary;
 }
 
+export interface SemanticImportSidecarSourcePreservationRecord {
+  readonly id: string;
+  readonly level: SourcePreservationLevel;
+  readonly precision?: string;
+  readonly sourceMapId?: string;
+  readonly sourceMapMappingId?: string;
+  readonly semanticNodeId?: string;
+  readonly nativeSourceId?: string;
+  readonly nativeAstNodeId?: string;
+  readonly semanticSymbolId?: string;
+  readonly semanticOccurrenceId?: string;
+  readonly sourcePath?: string;
+  readonly generatedPath?: string;
+  readonly lossIds: readonly string[];
+  readonly evidenceIds: readonly string[];
+  readonly reasons: readonly string[];
+}
+
 export interface SemanticImportSidecar {
   readonly kind: 'frontier.lang.semanticImportSidecar';
   readonly version: 1;
@@ -824,6 +1001,19 @@ export interface SemanticImportSidecar {
     readonly mappings: number;
     readonly ids: readonly string[];
   };
+  readonly sourcePreservation: {
+    readonly total: number;
+    readonly ids: readonly string[];
+    readonly byLevel: Readonly<Record<string, number>>;
+    readonly exact: number;
+    readonly declaration: number;
+    readonly estimated: number;
+    readonly blocked: number;
+    readonly sourcePaths: readonly string[];
+    readonly sourceMapIds: readonly string[];
+    readonly sourceMapMappingIds: readonly string[];
+    readonly records: readonly SemanticImportSidecarSourcePreservationRecord[];
+  };
   readonly patchHints: readonly SemanticImportPatchHint[];
   readonly mergeCandidates: readonly {
     readonly id?: string;
@@ -852,6 +1042,7 @@ export interface SemanticImportSidecar {
     readonly ownershipRegions: number;
     readonly regionKinds: number;
     readonly sourceMapMappings: number;
+    readonly sourcePreservationRecords: number;
     readonly readiness: SemanticMergeReadiness;
     readonly emptySemanticIndex: boolean;
   };
@@ -1237,10 +1428,14 @@ export interface ImportNativeSourceOptions {
   readonly metadata?: Record<string, unknown>;
 }
 
-export type NativeSourceImportResult = LanguageImportResult & {
+export type NativeSourceImportResult = Omit<LanguageImportResult, 'metadata'> & {
   readonly nativeSource: NativeSourceNode;
   readonly semanticIndex?: SemanticIndexRecord;
   readonly universalAst: FrontierUniversalAstEnvelope;
+  readonly metadata?: Record<string, unknown> & {
+    readonly sourcePreservationRecords?: readonly SourcePreservationRecord[];
+    readonly kernelSourcePreservationRecords?: readonly SourcePreservationRecord[];
+  };
 };
 
 export type ExternalSemanticIndexFormat =
@@ -1942,6 +2137,8 @@ export declare const NativeImportTaxonomyKinds: readonly NativeImportTaxonomyKin
 export declare const NativeImportLossKinds: readonly NativeImportKnownLossKind[];
 export declare const NativeImportRegionTaxonomyKinds: readonly NativeImportRegionTaxonomyKind[];
 export declare const ProjectionTargetLossClasses: readonly ProjectionTargetLossClass[];
+export declare const NativeParserFeatureCategories: readonly NativeParserFeatureCategory[];
+export declare const NativeParserFeatureCoverageStatuses: readonly NativeParserFeatureCoverageStatus[];
 export declare const NativeImportReadinessBySeverity: Readonly<Record<NativeImportLossSummary['highestSeverity'], SemanticMergeReadiness>>;
 export declare const NativeImportFeatureEvidencePolicies: Readonly<Record<string, NativeImportFeatureEvidencePolicy>>;
 export declare const NativeImportLanguageProfiles: readonly NativeImportLanguageProfile[];
@@ -1965,6 +2162,8 @@ export declare function classifyNativeImportRoundtripReadiness(importResult: Nat
 export declare function createNativeImportCoverageMatrix(options?: NativeImportCoverageMatrixOptions): NativeImportCoverageMatrix;
 export declare function getNativeParserAstFormatProfile(format?: string): NativeParserAstFormatProfile | undefined;
 export declare function createNativeParserAstFormatMatrix(options?: NativeParserAstFormatMatrixOptions): NativeParserAstFormatMatrix;
+export declare function createNativeParserFeatureMatrix(options?: NativeParserFeatureMatrixOptions): NativeParserFeatureMatrix;
+export declare function queryNativeParserFeatureMatrix(matrixOrOptions?: NativeParserFeatureMatrix | NativeParserFeatureMatrixOptions, query?: NativeParserFeatureMatrixQuery): NativeParserFeatureMatrixQueryResult;
 export declare function createProjectionTargetLossMatrix(options?: ProjectionTargetLossMatrixOptions): ProjectionTargetLossMatrix;
 export declare function createNativeSourcePreservation(options: CreateNativeSourcePreservationOptions): NativeSourcePreservation;
 export declare function createSemanticImportSidecar(importResult: NativeSourceImportResult | NativeProjectImportResult, options?: SemanticImportSidecarOptions): SemanticImportSidecar;