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

package/README.md

@@ -12,8 +12,12 @@ frontier-lang project-native native-import.json --source-only --out restored.ts
 frontier-lang native-compile native-import.json --target rust --emit-on-blocked --source-only --out todo.rs
 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
 ```
 
+`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.
+
 ## Related Packages
 
 The published Frontier package family is generated from one shared package catalog so READMEs stay in sync across packages:
@@ -208,7 +212,7 @@ npm install -g @shapeshift-labs/frontier-lang-cli
 frontier-lang check examples/todo.frontier
 ```
 
-Commands: `parse`, `check`, `hash`, `ast`, `capabilities`, `to-json`, `from-json`, `import`, `project-native`, `native-compile`, `native-coverage`, `native-capabilities`, `native-diff`, `roundtrip`, `corpus-roundtrip`, `emit`, `emit-ts`, `emit-js`, `emit-rust`, `emit-python`, and `emit-c`.
+Commands: `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`, and `emit-c`.
 
 ```sh
 frontier-lang emit app.frontier --target rust --out app.rs

package/bench/smoke.mjs

@@ -20,4 +20,10 @@ for (let index = 0; index < 25; index += 1) {
   await runCli(['native-compile', nativePath, '--target', index % 2 ? 'javascript' : 'rust', '--emit-on-blocked'], { log: (value = '') => lines.push(String(value)) });
   nativeBytes += lines.join('\n').length;
 }
-console.log(JSON.stringify({ emits: 100, nativeCompiles: 25, bytes, nativeBytes, durationMs: Number((performance.now() - start).toFixed(2)) }));
+let sliceBytes = 0;
+for (let index = 0; index < 25; index += 1) {
+  const lines = [];
+  await runCli(['slice', nativePath, '--symbol', 'addTodo', '--focused-command', 'npm test -- addTodo'], { log: (value = '') => lines.push(String(value)) });
+  sliceBytes += lines.join('\n').length;
+}
+console.log(JSON.stringify({ emits: 100, nativeCompiles: 25, slices: 25, bytes, nativeBytes, sliceBytes, durationMs: Number((performance.now() - start).toFixed(2)) }));

package/dist/index.js

@@ -12,14 +12,18 @@ import {
   createNativeSourcePreservation,
   createNativeImportCoverageMatrix,
   createSemanticImportSidecar,
+  createSemanticSlice,
   createUniversalAstFromDocument,
   createUniversalCapabilityMatrix,
   diffNativeSources,
   importNativeSource,
   projectNativeImportToSource,
   projectFrontierAst,
+  readSemanticSliceJson,
   readUniversalAstJson,
   resolveCapabilityAdapters,
+  testSemanticSlice,
+  writeSemanticSliceJson,
   writeUniversalAstJson
 } from '@shapeshift-labs/frontier-lang-compiler';
 
@@ -116,6 +120,37 @@ export async function runCli(argv = process.argv.slice(2), io = console) {
       metadata: { cli: true, beforePath: file, afterPath }
     }));
   }
+  if (command === 'slice') {
+    const imported = readNativeImportForProjection(file, source, rest);
+    const slice = createSemanticSlice(imported, {
+      id: readOption(rest, '--id'),
+      entryRefs: sliceEntryRefs(rest),
+      includeDependencies: !rest.includes('--no-deps'),
+      maxDependencyDepth: readIntegerOption(rest, '--max-depth'),
+      includeSourceText: !rest.includes('--no-source-text'),
+      maxExcerptBytes: readIntegerOption(rest, '--max-excerpt-bytes'),
+      focusedCommands: readOptions(rest, '--focused-command'),
+      fixtureHints: readOptions(rest, '--fixture-hint'),
+      metadata: { cli: true, inputPath: file }
+    });
+    if (rest.includes('--json-stable')) {
+      const json = writeSemanticSliceJson(slice);
+      const outIndex = rest.indexOf('--out');
+      if (outIndex >= 0 && rest[outIndex + 1]) writeFileSync(rest[outIndex + 1], json + '\n');
+      else io.log(json);
+      return;
+    }
+    return outputMaybeFile(io, rest, slice);
+  }
+  if (command === 'test-slice') {
+    const slice = readSemanticSliceJson(source);
+    return outputMaybeFile(io, rest, testSemanticSlice(slice, {
+      id: readOption(rest, '--id'),
+      requireSourceMapLinks: !rest.includes('--no-source-map-links'),
+      currentSources: readCurrentSources(rest),
+      metadata: { cli: true, inputPath: file }
+    }));
+  }
   const document = file ? parseFrontierFile(file, source) : parseFrontierSource(source);
   if (command === 'to-json') {
     return io.log(writeUniversalAstJson(createUniversalAstFromDocument(document, {
@@ -366,6 +401,27 @@ function nativeCapabilityLanguages(imported, args) {
   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;
@@ -388,8 +444,15 @@ 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|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] [--ast] [--sidecar] [--sidecar-only] [--source-only] [--stubs] [--emit-on-blocked] [--all-languages] [--out file] [--strict-effects]'); }
+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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-lang-cli",
-  "version": "0.3.31",
+  "version": "0.3.33",
   "description": "Command line interface for parsing, checking, hashing, and emitting Frontier Lang projects.",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,10 +27,11 @@
     "fuzz": "npm run build && node fuzz/smoke.mjs",
     "bench": "npm run build && node bench/smoke.mjs",
     "prepare": "npm run build",
-    "prepack": "npm test",
+    "prepack": "npm run lint && npm test",
     "pack:dry": "npm pack --dry-run",
     "readme:packages": "node benchmarks/package-readme-sections.mjs",
-    "readme:packages:check": "node benchmarks/package-readme-sections.mjs --check"
+    "readme:packages:check": "node benchmarks/package-readme-sections.mjs --check",
+    "lint": "node scripts/strict-source-policy.mjs"
   },
   "keywords": [
     "frontier",
@@ -53,10 +54,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@shapeshift-labs/frontier-lang-checker": "0.3.4",
-    "@shapeshift-labs/frontier-lang-compiler": "0.2.39",
-    "@shapeshift-labs/frontier-lang-kernel": "0.3.8",
-    "@shapeshift-labs/frontier-lang-parser": "0.3.4"
+    "@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"
   },
   "bin": {
     "frontier-lang": "dist/index.js"