@shrkcrft/cli 0.1.0-alpha.26 → 0.1.0-alpha.28

package/dist/main.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { loadDotenv } from "./env/load-dotenv.js";
-import { CommandRegistry, extractGlobalCompress, extractGlobalCwd, parseArgs, } from "./command-registry.js";
-import { argvHasStrict, promoteForStrict } from "./exit-codes.js";
+import { CommandRegistry, extractGlobalCompress, extractGlobalCwd, extractGlobalExitTrailer, parseArgs, } from "./command-registry.js";
+import { argvHasExitTrailer, argvHasStrict, emitPipeExitSignal, promoteForStrict } from "./exit-codes.js";
 import { runCommandWithCompression } from "./output/output-compression.js";
 import { initCommand } from "./commands/init.command.js";
 import { inspectCommand } from "./commands/inspect.command.js";
@@ -34,7 +34,10 @@ import { archCommand } from "./commands/arch.command.js";
 import { frameworkCommand } from "./commands/framework.command.js";
 import { apiDiffCommand } from "./commands/api-diff.command.js";
 import { gateCommand } from "./commands/gate.command.js";
-import { policyLintCommand } from "./commands/policy-lint.command.js";
+import { policyLintCommand, policyLintExplainCommand } from "./commands/policy-lint.command.js";
+import { baselineCheckCommand, baselineCommand, baselineDiffCommand, baselineExplainCommand, baselineListCommand, baselineUpdateCommand, } from "./commands/baseline.command.js";
+import { generatedCheckCommand, generatedExplainCommand, generatedListCommand, generatedUpdateCommand, } from "./commands/generated.command.js";
+import { gatesCommand, gatesCoverageCommand, gatesExplainCommand, gatesListCommand, } from "./commands/gates.command.js";
 import { wiringCommand } from "./commands/wiring.command.js";
 import { reuseCommand } from "./commands/reuse.command.js";
 import { migrateCommand } from "./commands/migrate.command.js";
@@ -44,7 +47,7 @@ import { compressCommand, expandCommand } from "./commands/compress.command.js";
 import { alignCommand, unalignCommand } from "./commands/cache-align.command.js";
 import { reviewCommand } from "./commands/review.command.js";
 import { onboardCommand } from "./commands/onboard.command.js";
-import { contradictionsCommand, generatedCommand, ingestCommand, } from "./commands/ingest.command.js";
+import { contradictionsCommand, generatedCommand, generatedProtectCommand, generatedReportCommand, ingestCommand, } from "./commands/ingest.command.js";
 import { contextBuildCommand, contextRefreshCommand, contextStatusCommand, understandTaskCommand, validateChangeCommand, } from "./commands/task-context.command.js";
 import { testCommand } from "./commands/test.command.js";
 import { planParentCommand, planReviewCommand } from "./commands/plan.command.js";
@@ -206,6 +209,26 @@ export function buildRegistry() {
     registry.register(apiDiffCommand);
     registry.register(gateCommand);
     registry.register(policyLintCommand);
+    registry.registerSubcommand('policy-lint', policyLintExplainCommand);
+    // The two shell-executing planes (baseline/generated) + the trust layer.
+    registry.register(baselineCommand);
+    registry.registerSubcommand('baseline', baselineListCommand);
+    registry.registerSubcommand('baseline', baselineCheckCommand);
+    registry.registerSubcommand('baseline', baselineDiffCommand);
+    registry.registerSubcommand('baseline', baselineUpdateCommand);
+    registry.registerSubcommand('baseline', baselineExplainCommand);
+    // `generated` already exists as the generated-code CLASSIFIER (report /
+    // protect). These add the drift GATE under the same noun.
+    registry.registerSubcommand('generated', generatedReportCommand);
+    registry.registerSubcommand('generated', generatedProtectCommand);
+    registry.registerSubcommand('generated', generatedListCommand);
+    registry.registerSubcommand('generated', generatedCheckCommand);
+    registry.registerSubcommand('generated', generatedUpdateCommand);
+    registry.registerSubcommand('generated', generatedExplainCommand);
+    registry.register(gatesCommand);
+    registry.registerSubcommand('gates', gatesListCommand);
+    registry.registerSubcommand('gates', gatesCoverageCommand);
+    registry.registerSubcommand('gates', gatesExplainCommand);
     registry.register(wiringCommand);
     registry.register(reuseCommand);
     registry.register(migrateCommand);
@@ -516,15 +539,29 @@ export async function runCli(argv) {
     // and each command's own `--strict` semantics (e.g. `check --strict`) still
     // apply beneath this (a25 §1.1).
     const strict = argvHasStrict(argv);
+    // Derive the command path from an argv with the global --exit-trailer stripped:
+    // otherwise a LEADING `--exit-trailer` makes extractCommandPath break on the '-'
+    // and return "" — zeroing out both the pipe-exit signal and the usage record.
+    const command = extractCommandPath(extractGlobalExitTrailer(probeArgv).rest);
     let exitCode = 0;
     try {
         exitCode = promoteForStrict(await runCliInner(argv), strict);
+        // Keep the honest 0/1/2 verdict readable through a trailing pipe (the shape
+        // an agent reaches for first). A no-op for non-gate verbs. Skipped inside the
+        // smart-context worker child and the --compress re-run child, whose stdout is
+        // a pipe by construction — a spurious "stdout is piped" note there (the user
+        // never piped) would be noise, not signal.
+        if (!process.env.SHRK_WORKER_EXITCODE_FILE && !process.env.SHRK_COMPRESS_CHILD) {
+            emitPipeExitSignal(command, exitCode, {
+                piped: !process.stdout.isTTY,
+                trailer: argvHasExitTrailer(argv),
+            });
+        }
         return exitCode;
     }
     finally {
         // append one local usage entry. Failure is silent.
         try {
-            const command = extractCommandPath(probeArgv);
             if (command.length > 0) {
                 const flags = sanitizeFlagNames(probeArgv);
                 const enabled = await isUsageEnabled(probeCwd ?? process.cwd());
@@ -566,8 +603,11 @@ async function runCliInner(argv) {
     const registry = buildRegistry();
     // Pre-parse the global --cwd so it can appear anywhere (incl. before the command).
     const { cwd: globalCwd, rest: cwdCleanArgv } = extractGlobalCwd(argv);
+    // Strip the global --exit-trailer here so no per-command flag-guard sees it;
+    // runCli reads it off the raw argv to decide whether to print the trailer.
+    const { rest: trailerCleanArgv } = extractGlobalExitTrailer(cwdCleanArgv);
     // Pre-parse the global --compress / --ccr output-compression flags.
-    const { directive: compressDirective, rest: cleanArgv } = extractGlobalCompress(cwdCleanArgv);
+    const { directive: compressDirective, rest: cleanArgv } = extractGlobalCompress(trailerCleanArgv);
     const [first] = cleanArgv;
     // `--compress` / `--ccr` on a real command: re-run it and compress its stdout.
     // (Meta verbs like --help/--version and bare invocations are left untouched.)

package/dist/output/output-compression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-compression.d.ts","sourceRoot":"","sources":["../../src/output/output-compression.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAQvE;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,SAAS,EAAE,wBAAwB,EACnC,GAAG,EAAE,MAAM,GACV,MAAM,CAgDR"}
+{"version":3,"file":"output-compression.d.ts","sourceRoot":"","sources":["../../src/output/output-compression.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAQvE;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,SAAS,EAAE,wBAAwB,EACnC,GAAG,EAAE,MAAM,GACV,MAAM,CAmDR"}

package/dist/output/output-compression.js

@@ -32,7 +32,10 @@ export function runCommandWithCompression(childArgv, directive, cwd) {
     const res = spawnSync(runtime, [entry, ...childArgv], {
         encoding: 'utf8',
         maxBuffer: MAX_BUFFER,
-        env: process.env,
+        // Mark the child so it suppresses the piped-stdout exit note: its stdout is
+        // captured here (always "piped") but the USER may not have piped anything —
+        // the parent decides the note from the real user-facing stdout instead.
+        env: { ...process.env, SHRK_COMPRESS_CHILD: '1' },
     });
     if (res.error) {
         process.stderr.write(`--compress: failed to run the command (${res.error.message}); emitting nothing.\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/cli",
-  "version": "0.1.0-alpha.26",
+  "version": "0.1.0-alpha.28",
   "description": "SharkCraft CLI (`shrk`): structured project intelligence for AI coding agents.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -47,38 +47,38 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.26",
-    "@shrkcrft/compress": "^0.1.0-alpha.26",
-    "@shrkcrft/config": "^0.1.0-alpha.26",
-    "@shrkcrft/workspace": "^0.1.0-alpha.26",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.26",
-    "@shrkcrft/context": "^0.1.0-alpha.26",
-    "@shrkcrft/rules": "^0.1.0-alpha.26",
-    "@shrkcrft/paths": "^0.1.0-alpha.26",
-    "@shrkcrft/templates": "^0.1.0-alpha.26",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.26",
-    "@shrkcrft/dashboard": "^0.1.0-alpha.26",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.26",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.26",
-    "@shrkcrft/presets": "^0.1.0-alpha.26",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.26",
-    "@shrkcrft/graph": "^0.1.0-alpha.26",
-    "@shrkcrft/rule-graph": "^0.1.0-alpha.26",
-    "@shrkcrft/structural-search": "^0.1.0-alpha.26",
-    "@shrkcrft/impact-engine": "^0.1.0-alpha.26",
-    "@shrkcrft/context-planner": "^0.1.0-alpha.26",
-    "@shrkcrft/architecture-guard": "^0.1.0-alpha.26",
-    "@shrkcrft/framework-scanners": "^0.1.0-alpha.26",
-    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.26",
-    "@shrkcrft/quality-gates": "^0.1.0-alpha.26",
-    "@shrkcrft/migrate": "^0.1.0-alpha.26",
-    "@shrkcrft/generator": "^0.1.0-alpha.26",
-    "@shrkcrft/importer": "^0.1.0-alpha.26",
-    "@shrkcrft/inspector": "^0.1.0-alpha.26",
-    "@shrkcrft/ai": "^0.1.0-alpha.26",
-    "@shrkcrft/embeddings": "^0.1.0-alpha.26",
-    "@shrkcrft/shared": "^0.1.0-alpha.26",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.26",
+    "@shrkcrft/core": "^0.1.0-alpha.28",
+    "@shrkcrft/compress": "^0.1.0-alpha.28",
+    "@shrkcrft/config": "^0.1.0-alpha.28",
+    "@shrkcrft/workspace": "^0.1.0-alpha.28",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.28",
+    "@shrkcrft/context": "^0.1.0-alpha.28",
+    "@shrkcrft/rules": "^0.1.0-alpha.28",
+    "@shrkcrft/paths": "^0.1.0-alpha.28",
+    "@shrkcrft/templates": "^0.1.0-alpha.28",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.28",
+    "@shrkcrft/dashboard": "^0.1.0-alpha.28",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.28",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.28",
+    "@shrkcrft/presets": "^0.1.0-alpha.28",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.28",
+    "@shrkcrft/graph": "^0.1.0-alpha.28",
+    "@shrkcrft/rule-graph": "^0.1.0-alpha.28",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.28",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.28",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.28",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.28",
+    "@shrkcrft/framework-scanners": "^0.1.0-alpha.28",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.28",
+    "@shrkcrft/quality-gates": "^0.1.0-alpha.28",
+    "@shrkcrft/migrate": "^0.1.0-alpha.28",
+    "@shrkcrft/generator": "^0.1.0-alpha.28",
+    "@shrkcrft/importer": "^0.1.0-alpha.28",
+    "@shrkcrft/inspector": "^0.1.0-alpha.28",
+    "@shrkcrft/ai": "^0.1.0-alpha.28",
+    "@shrkcrft/embeddings": "^0.1.0-alpha.28",
+    "@shrkcrft/shared": "^0.1.0-alpha.28",
+    "@shrkcrft/mcp-server": "^0.1.0-alpha.28",
     "@huggingface/transformers": "^3.7.5"
   },
   "publishConfig": {