@shapeshift-labs/frontier-lang-cli 0.3.33 → 0.3.35

package/README.md

@@ -14,10 +14,13 @@ frontier-lang native-coverage src/todo.ts
 frontier-lang native-capabilities src/todo.ts --target rust
 frontier-lang slice src/parser.ts --symbol parseExpression --focused-command "npm test -- parser-expression" --out parser.slice.json
 frontier-lang test-slice parser.slice.json --source src/parser.ts
+frontier-lang corpus-roundtrip ./src --target rust --out corpus-evidence.json
 ```
 
 `slice` extracts a `frontier.lang.semanticSlice` for a symbol, ownership region, native node, or source path. The slice includes source-map links, source hashes, conflict keys, focused commands, fixture hints, and merge-admission metadata so Frontier Swarm workers can operate on surgical context instead of full repo copies. `test-slice` validates that the slice is non-empty, refs resolved, conflict keys exist, source maps are present unless disabled, and supplied current source files still match the recorded hashes.
 
+`corpus-roundtrip` scans a file, manifest, or directory and records native-source import, universal AST JSON, source preservation, projection review, semantic sidecar quality, and merge-signal summaries for mixed-language conversion evidence.
+
 ## Related Packages
 
 The published Frontier package family is generated from one shared package catalog so READMEs stay in sync across packages:
@@ -66,7 +69,7 @@ The published Frontier package family is generated from one shared package catal
 - [`@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.
 - [`@shapeshift-labs/frontier-lang-clang`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-clang): Clang AST source-language importer package for Frontier Lang semantic documents, including package-level metadata, Clang AST JSON adapter helpers, native import results, and semantic sidecar generation for C/C++ translation units.
-- [`@shapeshift-labs/frontier-lang`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang): Umbrella package for Frontier Lang kernel, parser, checker, compiler facade, universal AST helpers, and projection adapters.
+- [`@shapeshift-labs/frontier-lang`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang): Umbrella package for Frontier Lang kernel, parser, checker, compiler facade, universal AST helpers, projection adapters, and source-language importer adapters.
 - [`@shapeshift-labs/frontier-kv`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv): Serializable in-memory key/value state for Frontier apps, including TTL, versioned compare-and-set, batched patch mutations, scans, watchers, snapshots, JSONL event evidence, and replay verification.
 - [`@shapeshift-labs/frontier-kv-locks`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv-locks): Lease-style lock records on top of Frontier KV, including acquire, renew, release, fencing tokens, expiration, owner evidence, and replayable lock events.
 - [`@shapeshift-labs/frontier-kv-rate-limit`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv-rate-limit): Patch-native rate limit buckets for Frontier KV, including fixed windows, sliding windows, token buckets, deterministic refill, consume evidence, and reset records.

package/dist/cli-output.js

@@ -0,0 +1,12 @@
+import { writeFileSync } from 'node:fs';
+
+export function output(io, value) {
+  io.log(JSON.stringify(value, null, 2));
+}
+
+export function outputMaybeFile(io, args, value) {
+  const json = JSON.stringify(value, null, 2);
+  const outIndex = args.indexOf('--out');
+  if (outIndex >= 0 && args[outIndex + 1]) writeFileSync(args[outIndex + 1], json + '\n');
+  else io.log(json);
+}

package/dist/corpus-roundtrip.js

@@ -0,0 +1,155 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { parseFrontierFile } from '@shapeshift-labs/frontier-lang-parser';
+import {
+  compileFrontierDocument,
+  createSemanticImportSidecar,
+  createUniversalAstFromDocument,
+  importNativeSource,
+  projectNativeImportToSource,
+  readUniversalAstJson,
+  writeUniversalAstJson
+} from '@shapeshift-labs/frontier-lang-compiler';
+import { idFragment, inferLanguage, readOption } from './options.js';
+
+export function runCorpusRoundtrip(inputPath, args) {
+  const target = readOption(args, '--target') ?? 'typescript';
+  const entries = collectCorpusEntries(inputPath);
+  const files = entries.map((entry) => corpusRoundtripFile(entry, { target, parser: readOption(args, '--parser') }));
+  const failed = files.filter((fileResult) => !fileResult.ok);
+  return {
+    kind: 'frontier.lang.corpusRoundtrip',
+    version: 1,
+    inputPath,
+    target,
+    total: files.length,
+    passed: files.length - failed.length,
+    failed: failed.length,
+    sourceMapCount: files.reduce((sum, fileResult) => sum + (fileResult.sourceMapCount ?? 0), 0),
+    lossCount: files.reduce((sum, fileResult) => sum + (fileResult.lossCount ?? 0), 0),
+    sourcePreservationCount: files.filter((fileResult) => fileResult.sourcePreservationId).length,
+    semanticImpactRecords: files.reduce((sum, fileResult) => sum + (fileResult.semanticImpactRecords ?? 0), 0),
+    weakMergeSignals: files.reduce((sum, fileResult) => sum + (fileResult.weakMergeSignals ?? 0), 0),
+    reviewRequiredMergeSignals: files.reduce((sum, fileResult) => sum + (fileResult.reviewRequiredMergeSignals ?? 0), 0),
+    projectionReviewRequired: files.filter((fileResult) => fileResult.projectionReviewRequired).length,
+    projectionModes: files.reduce((counts, fileResult) => incrementCount(counts, fileResult.projectionMode), {}),
+    projectionReviewStatuses: files.reduce((counts, fileResult) => incrementCount(counts, fileResult.projectionReviewStatus), {}),
+    readiness: files.reduce((counts, fileResult) => {
+      for (const readiness of fileResult.mergeReadiness ?? []) counts[readiness] = (counts[readiness] ?? 0) + 1;
+      return counts;
+    }, {}),
+    files
+  };
+}
+
+function corpusRoundtripFile(entry, options) {
+  const path = entry.path;
+  try {
+    const source = readFileSync(path, 'utf8');
+    const language = entry.language ?? inferLanguage(path);
+    if (/\.frontier$/i.test(path)) return corpusFrontierFile(path, source, options);
+    const imported = importNativeSource({ language, parser: entry.parser ?? options.parser, sourcePath: path, sourceText: source });
+    const projection = projectNativeImportToSource(imported);
+    const sidecar = createSemanticImportSidecar(imported);
+    const projectionReview = projection.metadata?.projectionReview;
+    const encoded = writeUniversalAstJson(imported.universalAst);
+    const decoded = readUniversalAstJson(encoded);
+    return {
+      path,
+      language,
+      kind: 'nativeSource',
+      ok: decoded.document.id === imported.document.id,
+      sourceMapCount: imported.sourceMaps?.length ?? 0,
+      sourceMapMappingCount: (imported.sourceMaps ?? []).reduce((sum, sourceMap) => sum + (sourceMap.mappings?.length ?? 0), 0),
+      lossCount: imported.losses?.length ?? 0,
+      evidenceCount: imported.evidence?.length ?? 0,
+      symbolCount: imported.semanticIndex?.symbols?.length ?? 0,
+      occurrenceCount: imported.semanticIndex?.occurrences?.length ?? 0,
+      sourcePreservationId: imported.metadata?.sourcePreservationId,
+      sourcePreservationExact: imported.metadata?.sourcePreservation?.summary?.exactSourceAvailable === true,
+      projectionMode: projection.mode,
+      projectionReadiness: projection.readiness?.readiness,
+      projectionReviewStatus: projectionReview?.status,
+      projectionReviewRequired: projectionReview?.reviewRequired === true,
+      projectionReviewFallbackReasons: projectionReview?.fallbackReasons ?? [],
+      projectionLossCount: projection.losses?.length ?? 0,
+      semanticImpactRecords: sidecar.semanticImpact?.summary?.total ?? 0,
+      weakMergeSignals: sidecar.semanticImpact?.summary?.weakMergeSignals ?? 0,
+      reviewRequiredMergeSignals: sidecar.semanticImpact?.summary?.reviewRequiredMergeSignals ?? 0,
+      mergeSignalQueryKeys: sidecar.semanticImpact?.summary?.mergeSignalQueryKeys ?? [],
+      sidecarQuality: {
+        imported: sidecar.quality?.imported === true,
+        eligible: sidecar.quality?.eligible === true,
+        warnings: sidecar.quality?.warnings?.length ?? 0
+      },
+      mergeReadiness: (imported.mergeCandidates ?? []).map((candidate) => candidate.readiness),
+      jsonBytes: encoded.length
+    };
+  } catch (error) {
+    return { path, language: entry.language ?? inferLanguage(path), kind: 'error', ok: false, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+function corpusFrontierFile(path, source, options) {
+  const document = parseFrontierFile(path, source);
+  const envelope = createUniversalAstFromDocument(document, {
+    evidence: [{ id: `frontier_lang_cli_corpus_${idFragment(path)}`, kind: 'test', status: 'passed', path, summary: 'Corpus Frontier source parsed into universal AST.' }]
+  });
+  const encoded = writeUniversalAstJson(envelope);
+  const decoded = readUniversalAstJson(encoded);
+  const result = compileFrontierDocument(decoded.document, { target: options.target });
+  return {
+    path,
+    language: 'frontier',
+    kind: 'frontierSource',
+    ok: result.ok && decoded.document.id === document.id,
+    hash: result.hash,
+    sourceMapCount: envelope.sourceMaps?.length ?? 0,
+    lossCount: envelope.losses?.length ?? 0,
+    evidenceCount: envelope.evidence?.length ?? 0,
+    diagnostics: result.diagnostics,
+    outputBytes: result.output.length,
+    jsonBytes: encoded.length
+  };
+}
+
+function collectCorpusEntries(inputPath) {
+  const absolute = resolve(inputPath);
+  const stat = statSync(absolute);
+  if (stat.isDirectory()) return collectCorpusDirectory(absolute).map((path) => ({ path }));
+  if (/\.json$/i.test(absolute)) return readCorpusManifest(absolute);
+  return [{ path: absolute }];
+}
+
+function collectCorpusDirectory(root) {
+  const files = [];
+  for (const item of readdirSync(root, { withFileTypes: true })) {
+    const path = join(root, item.name);
+    if (item.isDirectory()) {
+      if (!isIgnoredCorpusDirectory(item.name)) files.push(...collectCorpusDirectory(path));
+      continue;
+    }
+    if (item.isFile() && isCorpusSourceFile(path)) files.push(path);
+  }
+  return files.sort();
+}
+
+function readCorpusManifest(path) {
+  const manifest = JSON.parse(readFileSync(path, 'utf8'));
+  const base = dirname(path);
+  const rawEntries = Array.isArray(manifest) ? manifest : manifest.files ?? manifest.entries ?? [];
+  return rawEntries.map((entry) => typeof entry === 'string' ? { path: resolve(base, entry) } : { ...entry, path: resolve(base, entry.path ?? entry.file) });
+}
+
+function isIgnoredCorpusDirectory(name) {
+  return name === 'node_modules' || name === '.git' || name === 'dist' || name === 'coverage' || name === '.next';
+}
+
+function isCorpusSourceFile(path) {
+  return /\.(frontier|[cm]?tsx?|m?jsx?|rs|py|c|h|hpp|cpp|cc|cxx|go|java|kt|cs|swift|php|rb|rake)$/i.test(path);
+}
+
+function incrementCount(counts, key) {
+  if (key) counts[key] = (counts[key] ?? 0) + 1;
+  return counts;
+}

package/dist/help.js

@@ -0,0 +1,3 @@
+export function help(io) {
+  io.log('frontier-lang <parse|check|hash|ast|capabilities|to-json|from-json|import|project-native|native-compile|native-coverage|native-capabilities|native-diff|slice|test-slice|roundtrip|corpus-roundtrip|emit|emit-ts|emit-js|emit-rust|emit-python|emit-c> <file> [--after file] [--target target] [--language language] [--parser parser] [--platform platform] [--symbol name] [--region key] [--ref ref] [--source file] [--focused-command command] [--fixture-hint hint] [--ast] [--sidecar] [--sidecar-only] [--source-only] [--stubs] [--emit-on-blocked] [--all-languages] [--out file] [--strict-effects]');
+}

package/dist/index.js

@@ -1,15 +1,12 @@
 #!/usr/bin/env node
-import { readdirSync, readFileSync, realpathSync, statSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
+import { readFileSync, realpathSync, writeFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { parseFrontierFile, parseFrontierSource } from '@shapeshift-labs/frontier-lang-parser';
 import { checkDocument } from '@shapeshift-labs/frontier-lang-checker';
 import { hashDocumentBase } from '@shapeshift-labs/frontier-lang-kernel';
 import {
-  NativeImportLanguageProfiles,
   compileNativeSource,
   compileFrontierDocument,
-  createNativeSourcePreservation,
   createNativeImportCoverageMatrix,
   createSemanticImportSidecar,
   createSemanticSlice,
@@ -26,6 +23,24 @@ import {
   writeSemanticSliceJson,
   writeUniversalAstJson
 } from '@shapeshift-labs/frontier-lang-compiler';
+import { output, outputMaybeFile } from './cli-output.js';
+import { runCorpusRoundtrip } from './corpus-roundtrip.js';
+import { help } from './help.js';
+import {
+  importNativeFile,
+  nativeCapabilityLanguages,
+  readCurrentSources,
+  readNativeImportForProjection,
+  sliceEntryRefs
+} from './native-helpers.js';
+import {
+  idFragment,
+  inferLanguage,
+  readIntegerOption,
+  readOption,
+  readOptions,
+  tryParseJson
+} from './options.js';
 
 export async function runCli(argv = process.argv.slice(2), io = console) {
   const [command, file, ...rest] = argv;
@@ -200,291 +215,6 @@ export async function runCli(argv = process.argv.slice(2), io = console) {
   }
   throw new Error(`Unknown command: ${command}`);
 }
-function output(io, value) { io.log(JSON.stringify(value, null, 2)); }
-function outputMaybeFile(io, args, value) {
-  const json = JSON.stringify(value, null, 2);
-  const outIndex = args.indexOf('--out');
-  if (outIndex >= 0 && args[outIndex + 1]) writeFileSync(args[outIndex + 1], json + '\n'); else io.log(json);
-}
-function runCorpusRoundtrip(inputPath, args) {
-  const target = readOption(args, '--target') ?? 'typescript';
-  const entries = collectCorpusEntries(inputPath);
-  const files = entries.map((entry) => corpusRoundtripFile(entry, { target, parser: readOption(args, '--parser') }));
-  const failed = files.filter((fileResult) => !fileResult.ok);
-  return {
-    kind: 'frontier.lang.corpusRoundtrip',
-    version: 1,
-    inputPath,
-    target,
-    total: files.length,
-    passed: files.length - failed.length,
-    failed: failed.length,
-    sourceMapCount: files.reduce((sum, fileResult) => sum + (fileResult.sourceMapCount ?? 0), 0),
-    lossCount: files.reduce((sum, fileResult) => sum + (fileResult.lossCount ?? 0), 0),
-    sourcePreservationCount: files.filter((fileResult) => fileResult.sourcePreservationId).length,
-    projectionModes: files.reduce((counts, fileResult) => {
-      if (fileResult.projectionMode) counts[fileResult.projectionMode] = (counts[fileResult.projectionMode] ?? 0) + 1;
-      return counts;
-    }, {}),
-    readiness: files.reduce((counts, fileResult) => {
-      for (const readiness of fileResult.mergeReadiness ?? []) counts[readiness] = (counts[readiness] ?? 0) + 1;
-      return counts;
-    }, {}),
-    files
-  };
-}
-
-function corpusRoundtripFile(entry, options) {
-  const path = entry.path;
-  try {
-    const source = readFileSync(path, 'utf8');
-    const language = entry.language ?? inferLanguage(path);
-    if (/\.frontier$/i.test(path)) {
-      const document = parseFrontierFile(path, source);
-      const envelope = createUniversalAstFromDocument(document, {
-        evidence: [{ id: `frontier_lang_cli_corpus_${idFragment(path)}`, kind: 'test', status: 'passed', path, summary: 'Corpus Frontier source parsed into universal AST.' }]
-      });
-      const encoded = writeUniversalAstJson(envelope);
-      const decoded = readUniversalAstJson(encoded);
-      const result = compileFrontierDocument(decoded.document, { target: options.target });
-      return {
-        path,
-        language: 'frontier',
-        kind: 'frontierSource',
-        ok: result.ok && decoded.document.id === document.id,
-        hash: result.hash,
-        sourceMapCount: envelope.sourceMaps?.length ?? 0,
-        lossCount: envelope.losses?.length ?? 0,
-        evidenceCount: envelope.evidence?.length ?? 0,
-        diagnostics: result.diagnostics,
-        outputBytes: result.output.length,
-        jsonBytes: encoded.length
-      };
-    }
-    const imported = importNativeSource({
-      language,
-      parser: entry.parser ?? options.parser,
-      sourcePath: path,
-      sourceText: source
-    });
-    const projection = projectNativeImportToSource(imported);
-    const encoded = writeUniversalAstJson(imported.universalAst);
-    const decoded = readUniversalAstJson(encoded);
-    return {
-      path,
-      language,
-      kind: 'nativeSource',
-      ok: decoded.document.id === imported.document.id,
-      sourceMapCount: imported.sourceMaps?.length ?? 0,
-      sourceMapMappingCount: (imported.sourceMaps ?? []).reduce((sum, sourceMap) => sum + (sourceMap.mappings?.length ?? 0), 0),
-      lossCount: imported.losses?.length ?? 0,
-      evidenceCount: imported.evidence?.length ?? 0,
-      symbolCount: imported.semanticIndex?.symbols?.length ?? 0,
-      occurrenceCount: imported.semanticIndex?.occurrences?.length ?? 0,
-      sourcePreservationId: imported.metadata?.sourcePreservationId,
-      sourcePreservationExact: imported.metadata?.sourcePreservation?.summary?.exactSourceAvailable === true,
-      projectionMode: projection.mode,
-      projectionReadiness: projection.readiness?.readiness,
-      projectionLossCount: projection.losses?.length ?? 0,
-      mergeReadiness: (imported.mergeCandidates ?? []).map((candidate) => candidate.readiness),
-      jsonBytes: encoded.length
-    };
-  } catch (error) {
-    return {
-      path,
-      language: entry.language ?? inferLanguage(path),
-      kind: 'error',
-      ok: false,
-      error: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
-
-function collectCorpusEntries(inputPath) {
-  const absolute = resolve(inputPath);
-  const stat = statSync(absolute);
-  if (stat.isDirectory()) {
-    return collectCorpusDirectory(absolute).map((path) => ({ path }));
-  }
-  if (/\.json$/i.test(absolute)) {
-    return readCorpusManifest(absolute);
-  }
-  return [{ path: absolute }];
-}
-
-function collectCorpusDirectory(root) {
-  const files = [];
-  for (const item of readdirSync(root, { withFileTypes: true })) {
-    const path = join(root, item.name);
-    if (item.isDirectory()) {
-      if (!isIgnoredCorpusDirectory(item.name)) files.push(...collectCorpusDirectory(path));
-      continue;
-    }
-    if (item.isFile() && isCorpusSourceFile(path)) files.push(path);
-  }
-  return files.sort();
-}
-
-function readCorpusManifest(path) {
-  const manifest = JSON.parse(readFileSync(path, 'utf8'));
-  const base = dirname(path);
-  const rawEntries = Array.isArray(manifest) ? manifest : manifest.files ?? manifest.entries ?? [];
-  return rawEntries.map((entry) => {
-    if (typeof entry === 'string') return { path: resolve(base, entry) };
-    return {
-      ...entry,
-      path: resolve(base, entry.path ?? entry.file)
-    };
-  });
-}
-
-function importNativeFile(file, source, args, defaults = {}) {
-  const language = defaults.language ?? readOption(args, '--language') ?? inferLanguage(file);
-  const sourceHash = readOption(args, '--source-hash');
-  const sourcePreservation = sourcePreservationOptionsRequested(args)
-    ? createNativeSourcePreservation({
-      language,
-      sourcePath: file,
-      sourceHash,
-      sourceText: source,
-      includeSourceText: !args.includes('--omit-source-text'),
-      includeTokens: !args.includes('--no-tokens'),
-      includeTrivia: !args.includes('--no-trivia'),
-      includeDirectives: !args.includes('--no-directives'),
-      maxTokens: readIntegerOption(args, '--max-tokens'),
-      maxTrivia: readIntegerOption(args, '--max-trivia'),
-      maxDirectives: readIntegerOption(args, '--max-directives'),
-      metadata: { cli: true }
-    })
-    : undefined;
-  return importNativeSource({
-    language,
-    parser: readOption(args, '--parser'),
-    sourcePath: file,
-    sourceHash,
-    sourceText: source,
-    sourcePreservation,
-    nativeAstMetadata: { sourceBytes: source.length }
-  });
-}
-
-function readNativeImportForProjection(file, source, args) {
-  const parsed = tryParseJson(source);
-  if (!parsed) return importNativeFile(file, source, args);
-  if (parsed.kind === 'frontier.lang.universalAst') {
-    const nativeSource = parsed.nativeSources?.[0];
-    return {
-      id: parsed.metadata?.nativeImportId ?? `import_${idFragment(parsed.id)}`,
-      language: parsed.metadata?.sourceLanguage ?? nativeSource?.language ?? readOption(args, '--language') ?? inferLanguage(file),
-      sourcePath: parsed.metadata?.sourcePath ?? nativeSource?.sourcePath,
-      universalAst: parsed,
-      nativeSource,
-      nativeAst: nativeSource?.ast,
-      semanticIndex: parsed.semanticIndex,
-      sourceMaps: parsed.sourceMaps,
-      losses: parsed.losses,
-      evidence: parsed.evidence,
-      metadata: parsed.metadata ?? {}
-    };
-  }
-  return parsed;
-}
-
-function nativeCapabilityLanguages(imported, args) {
-  if (args.includes('--all-languages')) return undefined;
-  const language = imported?.language;
-  if (!language) return undefined;
-  const normalized = String(language).toLowerCase();
-  const matches = NativeImportLanguageProfiles.filter((profile) => (
-    profile.language === normalized || profile.aliases?.includes(normalized)
-  ));
-  return matches.length ? matches : undefined;
-}
-
-function sliceEntryRefs(args) {
-  return [
-    ...readOptions(args, '--ref'),
-    ...readOptions(args, '--semantic-ref'),
-    ...readOptions(args, '--symbol').map((value) => `symbol:${value}`),
-    ...readOptions(args, '--region').map((value) => `region:${value}`),
-    ...readOptions(args, '--native-node').map((value) => `native:${value}`),
-    ...readOptions(args, '--path').map((value) => `path:${value}`)
-  ];
-}
-
-function readCurrentSources(args) {
-  const paths = readOptions(args, '--source');
-  if (!paths.length) return undefined;
-  const currentSources = {};
-  for (const sourcePath of paths) {
-    currentSources[sourcePath] = readFileSync(sourcePath, 'utf8');
-  }
-  return currentSources;
-}
-
-function tryParseJson(source) {
-  const trimmed = source.trim();
-  if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) return undefined;
-  try {
-    return JSON.parse(trimmed);
-  } catch {
-    return undefined;
-  }
-}
-
-function isIgnoredCorpusDirectory(name) {
-  return name === 'node_modules' || name === '.git' || name === 'dist' || name === 'coverage' || name === '.next';
-}
-
-function isCorpusSourceFile(path) {
-  return /\.(frontier|[cm]?tsx?|m?jsx?|rs|py|c|h|hpp|cpp|cc|cxx|go|java|kt|cs|swift|php|rb|rake)$/i.test(path);
-}
-
-function idFragment(value) {
-  return String(value ?? 'unknown').replace(/[^A-Za-z0-9]+/g, '_').replace(/^_+|_+$/g, '').toLowerCase() || 'unknown';
-}
-
-function help(io) { io.log('frontier-lang <parse|check|hash|ast|capabilities|to-json|from-json|import|project-native|native-compile|native-coverage|native-capabilities|native-diff|slice|test-slice|roundtrip|corpus-roundtrip|emit|emit-ts|emit-js|emit-rust|emit-python|emit-c> <file> [--after file] [--target target] [--language language] [--parser parser] [--platform platform] [--symbol name] [--region key] [--ref ref] [--source file] [--focused-command command] [--fixture-hint hint] [--ast] [--sidecar] [--sidecar-only] [--source-only] [--stubs] [--emit-on-blocked] [--all-languages] [--out file] [--strict-effects]'); }
-function readOption(args, flag) { const index = args.indexOf(flag); return index >= 0 ? args[index + 1] : undefined; }
-function readOptions(args, flag) {
-  const values = [];
-  for (let index = 0; index < args.length; index += 1) {
-    if (args[index] === flag && args[index + 1]) values.push(args[index + 1]);
-  }
-  return values;
-}
-function readIntegerOption(args, flag) {
-  const value = readOption(args, flag);
-  if (value === undefined) return undefined;
-  const parsed = Number.parseInt(value, 10);
-  return Number.isFinite(parsed) ? parsed : undefined;
-}
-function sourcePreservationOptionsRequested(args) {
-  return args.includes('--omit-source-text')
-    || args.includes('--no-tokens')
-    || args.includes('--no-trivia')
-    || args.includes('--no-directives')
-    || args.includes('--max-tokens')
-    || args.includes('--max-trivia')
-    || args.includes('--max-directives');
-}
-function inferLanguage(file) {
-  if (!file) return 'unknown';
-  if (/\.[cm]?tsx?$/.test(file)) return 'typescript';
-  if (/\.m?jsx?$/.test(file)) return 'javascript';
-  if (/\.rs$/.test(file)) return 'rust';
-  if (/\.py$/.test(file)) return 'python';
-  if (/\.c$/.test(file)) return 'c';
-  if (/\.cpp$|\.cc$|\.cxx$|\.hpp$|\.h$/.test(file)) return 'cpp';
-  if (/\.go$/.test(file)) return 'go';
-  if (/\.java$/.test(file)) return 'java';
-  if (/\.kt$/.test(file)) return 'kotlin';
-  if (/\.cs$/.test(file)) return 'csharp';
-  if (/\.swift$/.test(file)) return 'swift';
-  if (/\.php$/.test(file)) return 'php';
-  if (/\.rb$|\.rake$/.test(file)) return 'ruby';
-  return 'unknown';
-}
 
 function isDirectInvocation() {
   if (!process.argv[1]) return false;

package/dist/native-helpers.js

@@ -0,0 +1,97 @@
+import { readFileSync } from 'node:fs';
+import {
+  NativeImportLanguageProfiles,
+  createNativeSourcePreservation,
+  importNativeSource
+} from '@shapeshift-labs/frontier-lang-compiler';
+import {
+  idFragment,
+  inferLanguage,
+  readIntegerOption,
+  readOption,
+  readOptions,
+  sourcePreservationOptionsRequested,
+  tryParseJson
+} from './options.js';
+
+export function importNativeFile(file, source, args, defaults = {}) {
+  const language = defaults.language ?? readOption(args, '--language') ?? inferLanguage(file);
+  const sourceHash = readOption(args, '--source-hash');
+  const sourcePreservation = sourcePreservationOptionsRequested(args)
+    ? createNativeSourcePreservation({
+      language,
+      sourcePath: file,
+      sourceHash,
+      sourceText: source,
+      includeSourceText: !args.includes('--omit-source-text'),
+      includeTokens: !args.includes('--no-tokens'),
+      includeTrivia: !args.includes('--no-trivia'),
+      includeDirectives: !args.includes('--no-directives'),
+      maxTokens: readIntegerOption(args, '--max-tokens'),
+      maxTrivia: readIntegerOption(args, '--max-trivia'),
+      maxDirectives: readIntegerOption(args, '--max-directives'),
+      metadata: { cli: true }
+    })
+    : undefined;
+  return importNativeSource({
+    language,
+    parser: readOption(args, '--parser'),
+    sourcePath: file,
+    sourceHash,
+    sourceText: source,
+    sourcePreservation,
+    nativeAstMetadata: { sourceBytes: source.length }
+  });
+}
+
+export function readNativeImportForProjection(file, source, args) {
+  const parsed = tryParseJson(source);
+  if (!parsed) return importNativeFile(file, source, args);
+  if (parsed.kind === 'frontier.lang.universalAst') {
+    const nativeSource = parsed.nativeSources?.[0];
+    return {
+      id: parsed.metadata?.nativeImportId ?? `import_${idFragment(parsed.id)}`,
+      language: parsed.metadata?.sourceLanguage ?? nativeSource?.language ?? readOption(args, '--language') ?? inferLanguage(file),
+      sourcePath: parsed.metadata?.sourcePath ?? nativeSource?.sourcePath,
+      universalAst: parsed,
+      nativeSource,
+      nativeAst: nativeSource?.ast,
+      semanticIndex: parsed.semanticIndex,
+      sourceMaps: parsed.sourceMaps,
+      losses: parsed.losses,
+      evidence: parsed.evidence,
+      metadata: parsed.metadata ?? {}
+    };
+  }
+  return parsed;
+}
+
+export function nativeCapabilityLanguages(imported, args) {
+  if (args.includes('--all-languages')) return undefined;
+  const language = imported?.language;
+  if (!language) return undefined;
+  const normalized = String(language).toLowerCase();
+  const matches = NativeImportLanguageProfiles.filter((profile) => (
+    profile.language === normalized || profile.aliases?.includes(normalized)
+  ));
+  return matches.length ? matches : undefined;
+}
+
+export function sliceEntryRefs(args) {
+  return [
+    ...readOptions(args, '--ref'),
+    ...readOptions(args, '--semantic-ref'),
+    ...readOptions(args, '--symbol').map((value) => `symbol:${value}`),
+    ...readOptions(args, '--region').map((value) => `region:${value}`),
+    ...readOptions(args, '--native-node').map((value) => `native:${value}`),
+    ...readOptions(args, '--path').map((value) => `path:${value}`)
+  ];
+}
+
+export function readCurrentSources(args) {
+  const paths = readOptions(args, '--source');
+  if (!paths.length) return undefined;
+  const currentSources = {};
+  for (const sourcePath of paths) currentSources[sourcePath] = readFileSync(sourcePath, 'utf8');
+  return currentSources;
+}

package/dist/options.js

@@ -0,0 +1,61 @@
+export function readOption(args, flag) {
+  const index = args.indexOf(flag);
+  return index >= 0 ? args[index + 1] : undefined;
+}
+
+export function readOptions(args, flag) {
+  const values = [];
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === flag && args[index + 1]) values.push(args[index + 1]);
+  }
+  return values;
+}
+
+export function readIntegerOption(args, flag) {
+  const value = readOption(args, flag);
+  if (value === undefined) return undefined;
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+
+export function sourcePreservationOptionsRequested(args) {
+  return args.includes('--omit-source-text')
+    || args.includes('--no-tokens')
+    || args.includes('--no-trivia')
+    || args.includes('--no-directives')
+    || args.includes('--max-tokens')
+    || args.includes('--max-trivia')
+    || args.includes('--max-directives');
+}
+
+export function tryParseJson(source) {
+  const trimmed = source.trim();
+  if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) return undefined;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return undefined;
+  }
+}
+
+export function idFragment(value) {
+  return String(value ?? 'unknown').replace(/[^A-Za-z0-9]+/g, '_').replace(/^_+|_+$/g, '').toLowerCase() || 'unknown';
+}
+
+export function inferLanguage(file) {
+  if (!file) return 'unknown';
+  if (/\.[cm]?tsx?$/.test(file)) return 'typescript';
+  if (/\.m?jsx?$/.test(file)) return 'javascript';
+  if (/\.rs$/.test(file)) return 'rust';
+  if (/\.py$/.test(file)) return 'python';
+  if (/\.c$/.test(file)) return 'c';
+  if (/\.cpp$|\.cc$|\.cxx$|\.hpp$|\.h$/.test(file)) return 'cpp';
+  if (/\.go$/.test(file)) return 'go';
+  if (/\.java$/.test(file)) return 'java';
+  if (/\.kt$/.test(file)) return 'kotlin';
+  if (/\.cs$/.test(file)) return 'csharp';
+  if (/\.swift$/.test(file)) return 'swift';
+  if (/\.php$/.test(file)) return 'php';
+  if (/\.rb$|\.rake$/.test(file)) return 'ruby';
+  return 'unknown';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-lang-cli",
-  "version": "0.3.33",
+  "version": "0.3.35",
   "description": "Command line interface for parsing, checking, hashing, and emitting Frontier Lang projects.",
   "type": "module",
   "main": "./dist/index.js",
@@ -54,10 +54,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@shapeshift-labs/frontier-lang-checker": "0.3.5",
-    "@shapeshift-labs/frontier-lang-compiler": "0.2.41",
-    "@shapeshift-labs/frontier-lang-kernel": "0.3.9",
-    "@shapeshift-labs/frontier-lang-parser": "0.3.5"
+    "@shapeshift-labs/frontier-lang-checker": "0.3.7",
+    "@shapeshift-labs/frontier-lang-compiler": "0.2.71",
+    "@shapeshift-labs/frontier-lang-kernel": "0.3.12",
+    "@shapeshift-labs/frontier-lang-parser": "0.3.7"
   },
   "bin": {
     "frontier-lang": "dist/index.js"