@shrkcrft/cli 0.1.0-alpha.16 → 0.1.0-alpha.18

package/dist/output/output-compression.js

@@ -0,0 +1,60 @@
+import { spawnSync } from 'node:child_process';
+import { compressContent } from '@shrkcrft/compress';
+import { openCcrStore } from "./ccr-store-config.js";
+import { resolveCompressType } from "./resolve-compress-type.js";
+// Command output can be large (a full knowledge dump, a wide graph). Allow up to
+// 64 MiB of captured stdout before spawnSync gives up.
+const MAX_BUFFER = 64 * 1024 * 1024;
+/**
+ * Implements the global `--compress` / `--ccr` flag: run a `shrk` command in a
+ * child process, capture its stdout, and emit a deterministically-compressed
+ * version (with the original cached for `shrk expand`). The command's own
+ * stderr is forwarded verbatim and its exit code is preserved.
+ *
+ * A SUBPROCESS (not in-process `process.stdout` capture) on purpose: some
+ * commands call `process.exit`, which would discard a buffered in-process
+ * capture mid-write; re-running the command isolates that and still yields the
+ * full output + real exit status. `childArgv` has already had the compress
+ * flags stripped, so the child never recurses.
+ */
+export function runCommandWithCompression(childArgv, directive, cwd) {
+    const runtime = process.argv[0];
+    const entry = process.argv[1];
+    if (!runtime || !entry) {
+        process.stderr.write('--compress: cannot determine the shrk entry point to re-run; emitting uncompressed.\n');
+        return 1;
+    }
+    // Resolve an explicit --compress-type up front so a typo is reported loudly
+    // (not silently auto-detected), even if the command ends up printing nothing.
+    const resolvedType = resolveCompressType(directive.type);
+    if (resolvedType.warning)
+        process.stderr.write(`${resolvedType.warning}\n`);
+    const res = spawnSync(runtime, [entry, ...childArgv], {
+        encoding: 'utf8',
+        maxBuffer: MAX_BUFFER,
+        env: process.env,
+    });
+    if (res.error) {
+        process.stderr.write(`--compress: failed to run the command (${res.error.message}); emitting nothing.\n`);
+        return 1;
+    }
+    // Forward the command's own stderr (warnings, summaries, errors) untouched.
+    if (res.stderr)
+        process.stderr.write(res.stderr);
+    const captured = res.stdout ?? '';
+    const code = res.status ?? (res.signal ? 1 : 0);
+    // Nothing on stdout (or the command failed) → don't fabricate output.
+    if (captured.length === 0)
+        return code;
+    const opts = { store: openCcrStore(cwd) };
+    if (directive.query)
+        opts.query = directive.query;
+    if (resolvedType.type)
+        opts.contentType = resolvedType.type;
+    const result = compressContent(captured, opts);
+    process.stdout.write(result.compressed.endsWith('\n') ? result.compressed : `${result.compressed}\n`);
+    const pct = Math.round(result.savings.ratio * 100);
+    const cached = result.ccrKey ? ` · original cached (shrk expand ${result.ccrKey})` : '';
+    process.stderr.write(`[--compress] ${result.strategy}: ~${result.savings.before} → ~${result.savings.after} tokens (−${pct}%, est.)${cached}\n`);
+    return code;
+}

package/dist/output/resolve-compress-type.d.ts

@@ -0,0 +1,22 @@
+import { EContentType } from '@shrkcrft/compress';
+/** Outcome of resolving a raw `--compress-type` string. */
+export interface IResolvedCompressType {
+    /** The forced content type — set only when the raw value named a valid one. */
+    type?: EContentType;
+    /**
+     * A user-facing warning, set when the raw value was non-empty but
+     * unrecognized. The caller surfaces it (on stderr) so an explicit-but-typo'd
+     * `--compress-type` is reported rather than silently dropped.
+     */
+    warning?: string;
+}
+/**
+ * Resolve a raw `--compress-type` flag value into a forced {@link EContentType}.
+ *
+ * An unrecognized, non-empty value is NOT silently ignored (the old behavior):
+ * it yields a `warning` listing the valid types, so the caller can tell the
+ * user their explicit choice was dropped before falling back to auto-detection.
+ * A missing or empty value is a no-op (auto-detect, no warning).
+ */
+export declare function resolveCompressType(raw: string | undefined): IResolvedCompressType;
+//# sourceMappingURL=resolve-compress-type.d.ts.map

package/dist/output/resolve-compress-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-compress-type.d.ts","sourceRoot":"","sources":["../../src/output/resolve-compress-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,qBAAqB,CAOlF"}

package/dist/output/resolve-compress-type.js

@@ -0,0 +1,21 @@
+import { EContentType } from '@shrkcrft/compress';
+/** The valid `--compress-type` values: the EContentType wire strings. */
+const VALID_TYPES = new Set(Object.values(EContentType));
+/**
+ * Resolve a raw `--compress-type` flag value into a forced {@link EContentType}.
+ *
+ * An unrecognized, non-empty value is NOT silently ignored (the old behavior):
+ * it yields a `warning` listing the valid types, so the caller can tell the
+ * user their explicit choice was dropped before falling back to auto-detection.
+ * A missing or empty value is a no-op (auto-detect, no warning).
+ */
+export function resolveCompressType(raw) {
+    if (raw === undefined || raw === '')
+        return {};
+    if (VALID_TYPES.has(raw))
+        return { type: raw };
+    const valid = [...VALID_TYPES].sort().join(', ');
+    return {
+        warning: `--compress: unknown --compress-type "${raw}"; auto-detecting instead. Valid types: ${valid}.`,
+    };
+}

package/dist/validation/run-validation-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-validation-loop.d.ts","sourceRoot":"","sources":["../../src/validation/run-validation-loop.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,2EAA2E;IAC3E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAqGnC"}
+{"version":3,"file":"run-validation-loop.d.ts","sourceRoot":"","sources":["../../src/validation/run-validation-loop.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,2EAA2E;IAC3E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAyGnC"}

package/dist/validation/run-validation-loop.js

@@ -25,7 +25,11 @@ export async function runValidationLoop(options) {
         const ver = cfg?.verificationCommands ?? [];
         const wantIds = new Set(options.verificationIds);
         for (const v of ver) {
-            const shouldRun = options.allVerifications || wantIds.has(v.id);
+            // `--all-verifications` auto-runs commands, so it must respect the
+            // explicit `trusted: false` opt-out (a command the project marked
+            // untrusted must not be executed en masse). An explicit `--verification
+            // <id>` still runs it — naming it by id IS the opt-in.
+            const shouldRun = (options.allVerifications && v.trusted !== false) || wantIds.has(v.id);
             if (!shouldRun)
                 continue;
             commands.push({ id: v.id, command: v.command, trusted: v.trusted !== false });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/cli",
-  "version": "0.1.0-alpha.16",
+  "version": "0.1.0-alpha.18",
   "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.16",
-    "@shrkcrft/compress": "^0.1.0-alpha.16",
-    "@shrkcrft/config": "^0.1.0-alpha.16",
-    "@shrkcrft/workspace": "^0.1.0-alpha.16",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.16",
-    "@shrkcrft/context": "^0.1.0-alpha.16",
-    "@shrkcrft/rules": "^0.1.0-alpha.16",
-    "@shrkcrft/paths": "^0.1.0-alpha.16",
-    "@shrkcrft/templates": "^0.1.0-alpha.16",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.16",
-    "@shrkcrft/dashboard": "^0.1.0-alpha.16",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.16",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.16",
-    "@shrkcrft/presets": "^0.1.0-alpha.16",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.16",
-    "@shrkcrft/graph": "^0.1.0-alpha.16",
-    "@shrkcrft/rule-graph": "^0.1.0-alpha.16",
-    "@shrkcrft/structural-search": "^0.1.0-alpha.16",
-    "@shrkcrft/impact-engine": "^0.1.0-alpha.16",
-    "@shrkcrft/context-planner": "^0.1.0-alpha.16",
-    "@shrkcrft/architecture-guard": "^0.1.0-alpha.16",
-    "@shrkcrft/framework-scanners": "^0.1.0-alpha.16",
-    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.16",
-    "@shrkcrft/quality-gates": "^0.1.0-alpha.16",
-    "@shrkcrft/migrate": "^0.1.0-alpha.16",
-    "@shrkcrft/generator": "^0.1.0-alpha.16",
-    "@shrkcrft/importer": "^0.1.0-alpha.16",
-    "@shrkcrft/inspector": "^0.1.0-alpha.16",
-    "@shrkcrft/ai": "^0.1.0-alpha.16",
-    "@shrkcrft/embeddings": "^0.1.0-alpha.16",
-    "@shrkcrft/shared": "^0.1.0-alpha.16",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.16",
+    "@shrkcrft/core": "^0.1.0-alpha.18",
+    "@shrkcrft/compress": "^0.1.0-alpha.18",
+    "@shrkcrft/config": "^0.1.0-alpha.18",
+    "@shrkcrft/workspace": "^0.1.0-alpha.18",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.18",
+    "@shrkcrft/context": "^0.1.0-alpha.18",
+    "@shrkcrft/rules": "^0.1.0-alpha.18",
+    "@shrkcrft/paths": "^0.1.0-alpha.18",
+    "@shrkcrft/templates": "^0.1.0-alpha.18",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.18",
+    "@shrkcrft/dashboard": "^0.1.0-alpha.18",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.18",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.18",
+    "@shrkcrft/presets": "^0.1.0-alpha.18",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.18",
+    "@shrkcrft/graph": "^0.1.0-alpha.18",
+    "@shrkcrft/rule-graph": "^0.1.0-alpha.18",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.18",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.18",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.18",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.18",
+    "@shrkcrft/framework-scanners": "^0.1.0-alpha.18",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.18",
+    "@shrkcrft/quality-gates": "^0.1.0-alpha.18",
+    "@shrkcrft/migrate": "^0.1.0-alpha.18",
+    "@shrkcrft/generator": "^0.1.0-alpha.18",
+    "@shrkcrft/importer": "^0.1.0-alpha.18",
+    "@shrkcrft/inspector": "^0.1.0-alpha.18",
+    "@shrkcrft/ai": "^0.1.0-alpha.18",
+    "@shrkcrft/embeddings": "^0.1.0-alpha.18",
+    "@shrkcrft/shared": "^0.1.0-alpha.18",
+    "@shrkcrft/mcp-server": "^0.1.0-alpha.18",
     "@huggingface/transformers": "^3.7.5"
   },
   "publishConfig": {