@shrkcrft/cli 0.1.0-alpha.22 → 0.1.0-alpha.24

package/dist/commands/recommend.command.js

@@ -114,10 +114,18 @@ export const recommendCommand = {
             }));
             const promotedSet = new Set(promoted.map((p) => p.command));
             const isGenericDefault = (c) => /^(bun run )?shrk (review|report|impact)\b/i.test(c);
+            // The recommender (inspector) already arbitrates the keyword recipe
+            // against the shared ranker and may have promoted a `shrk gen <template>`
+            // / `shrk task` headline (its `why` starts with "Ranker matched"). That
+            // ranker-confirmed scaffold is the engine's corrected route — keep it
+            // ahead of even the routing-hint promotion so the headline survives.
+            const isRankerPromoted = (r) => /^Ranker matched /.test(r.why);
             const existing = report.recommendations;
-            const keptNonGeneric = existing.filter((r) => !promotedSet.has(r.command) && !isGenericDefault(r.command));
-            const keptGeneric = existing.filter((r) => !promotedSet.has(r.command) && isGenericDefault(r.command));
+            const keptRankerPromoted = existing.filter((r) => !promotedSet.has(r.command) && isRankerPromoted(r));
+            const keptNonGeneric = existing.filter((r) => !promotedSet.has(r.command) && !isRankerPromoted(r) && !isGenericDefault(r.command));
+            const keptGeneric = existing.filter((r) => !promotedSet.has(r.command) && !isRankerPromoted(r) && isGenericDefault(r.command));
             report.recommendations = [
+                ...keptRankerPromoted,
                 ...promoted,
                 ...keptNonGeneric,
                 ...keptGeneric,

package/dist/commands/registry.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.command.d.ts","sourceRoot":"","sources":["../../src/commands/registry.command.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,wBAAwB,EAAE,eActC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAa7B,CAAC"}
+{"version":3,"file":"registry.command.d.ts","sourceRoot":"","sources":["../../src/commands/registry.command.ts"],"names":[],"mappings":"AAwBA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,wBAAwB,EAAE,eAetC,CAAC;AAsGF,eAAO,MAAM,eAAe,EAAE,eAuB7B,CAAC"}

package/dist/commands/registry.command.js

@@ -1,18 +1,27 @@
 /**
  * `shrk registry` commands.
  *
- *   shrk registry lifecycle [--json]
+ *   shrk registry lifecycle [--json]            # register/remove symmetry
+ *   shrk registry <name> list [--json]          # every declared id
+ *   shrk registry <name> exists <id> [--json]   # is the id taken? (exit 1 if not)
+ *   shrk registry <name> where <id> [--json]    # declaration (+ consumer) sites
+ *
+ * `<name>` resolves a `registries[]` declaration in sharkcraft.config.ts — one
+ * deterministic multi-root scan that answers "is this id taken / where is it"
+ * without an agent re-running a fragile grep.
  */
-import { buildRegistryLifecycleReport, renderRegistryLifecycleReportText, } from '@shrkcrft/inspector';
-import { flagBool, resolveCwd, } from "../command-registry.js";
+import { buildRegistryLifecycleReport, renderRegistryLifecycleReportText, resolveProjectConfig, } from '@shrkcrft/inspector';
+import { scanRegistry, registryExists, registryWhere, } from '@shrkcrft/boundaries';
+import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson } from "../output/format-output.js";
 export const registryLifecycleCommand = {
     name: 'lifecycle',
-    description: 'Scan the workspace for register*/remove* symmetry. Read-only.',
-    usage: 'shrk registry lifecycle [--json]',
+    description: 'Scan the workspace for register/remove symmetry. Read-only.',
+    usage: 'shrk registry lifecycle [--scope <dir>] [--json]',
     async run(args) {
         const cwd = resolveCwd(args);
-        const report = buildRegistryLifecycleReport({ projectRoot: cwd });
+        const scope = flagString(args, 'scope');
+        const report = buildRegistryLifecycleReport({ projectRoot: cwd, ...(scope ? { scope } : {}) });
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson(report) + '\n');
             return report.missingRemovers.length === 0 ? 0 : 1;
@@ -21,17 +30,116 @@ export const registryLifecycleCommand = {
         return report.missingRemovers.length === 0 ? 0 : 1;
     },
 };
+async function loadRegistries(cwd) {
+    const loaded = await resolveProjectConfig(cwd);
+    if (!loaded.ok)
+        return { ok: false, message: loaded.error.message };
+    return {
+        ok: true,
+        registries: loaded.value.config.registries ?? [],
+        planeDiagnostics: loaded.value.planeDiagnostics,
+    };
+}
+function findRegistry(registries, name) {
+    return registries.find((r) => r.name === name);
+}
+/** Run a `list | exists | where` query against a declared registry. */
+async function runRegistryInventory(args, name) {
+    const cwd = resolveCwd(args);
+    const json = flagBool(args, 'json');
+    const action = args.positional[1];
+    const id = args.positional[2];
+    const loaded = await loadRegistries(cwd);
+    if (!loaded.ok) {
+        if (json)
+            process.stdout.write(asJson({ error: loaded.message }) + '\n');
+        else
+            process.stderr.write(`Could not load config: ${loaded.message}\n  Run \`shrk doctor\` for details.\n`);
+        return 1;
+    }
+    const decl = findRegistry(loaded.registries, name);
+    if (!decl) {
+        const names = loaded.registries.map((r) => r.name);
+        const avail = names.length > 0 ? `Declared registries: ${names.join(', ')}.` : 'No registries declared in sharkcraft.config.ts `registries[]`.';
+        if (json)
+            process.stdout.write(asJson({ error: `unknown registry "${name}"`, available: names }) + '\n');
+        else
+            process.stderr.write(`No registry named "${name}". ${avail}\n`);
+        return 2;
+    }
+    const inventory = scanRegistry(cwd, decl);
+    if (action === 'list' || action === undefined) {
+        // Fold pack-plane merge notes (missing/invalid pack registry files, dropped
+        // collisions) into the inventory's own scan diagnostics.
+        const diagnostics = [...inventory.diagnostics, ...loaded.planeDiagnostics];
+        if (json) {
+            process.stdout.write(asJson({ name: inventory.name, count: inventory.entries.length, ids: inventory.entries.map((e) => e.id), diagnostics }) + '\n');
+            return 0;
+        }
+        process.stdout.write(`Registry "${inventory.name}"${inventory.description ? ' — ' + inventory.description : ''}\n`);
+        process.stdout.write(`  ${inventory.entries.length} id(s)\n`);
+        for (const e of inventory.entries) {
+            process.stdout.write(`  • ${e.id}  (${e.sites.length} site${e.sites.length === 1 ? '' : 's'})\n`);
+        }
+        for (const d of diagnostics)
+            process.stdout.write(`  ! ${d}\n`);
+        return 0;
+    }
+    if (action === 'exists') {
+        if (!id) {
+            process.stderr.write(`Usage: shrk registry ${name} exists <id>\n`);
+            return 2;
+        }
+        const exists = registryExists(inventory, id);
+        if (json)
+            process.stdout.write(asJson({ name: inventory.name, id, exists }) + '\n');
+        else
+            process.stdout.write(`${exists ? 'yes' : 'no'} — "${id}" is ${exists ? 'declared' : 'NOT declared'} in registry "${inventory.name}".\n`);
+        return exists ? 0 : 1;
+    }
+    if (action === 'where') {
+        if (!id) {
+            process.stderr.write(`Usage: shrk registry ${name} where <id>\n`);
+            return 2;
+        }
+        const entry = registryWhere(inventory, id);
+        if (json) {
+            process.stdout.write(asJson({ name: inventory.name, id, found: entry !== undefined, entry: entry ?? null }) + '\n');
+            return entry ? 0 : 1;
+        }
+        if (!entry) {
+            process.stdout.write(`"${id}" is not declared in registry "${inventory.name}".\n`);
+            return 1;
+        }
+        process.stdout.write(`"${id}" in registry "${inventory.name}":\n`);
+        for (const s of entry.sites)
+            process.stdout.write(`  declared  ${s.file}:${s.line}\n`);
+        for (const s of entry.consumerSites ?? [])
+            process.stdout.write(`  consumed  ${s.file}:${s.line}\n`);
+        return 0;
+    }
+    process.stderr.write(`Unknown action "${action}". Usage: shrk registry ${name} list | exists <id> | where <id>\n`);
+    return 2;
+}
 export const registryCommand = {
     name: 'registry',
-    description: 'Registry inspections (lifecycle symmetry, etc.). Read-only.',
-    usage: 'shrk registry lifecycle',
+    description: 'Registry inspections: lifecycle symmetry + declared-registry inventory. Read-only.',
+    usage: 'shrk registry lifecycle | <name> list | <name> exists <id> | <name> where <id>',
     async run(args) {
         const sub = args.positional[0];
         if (sub === 'lifecycle') {
             args.positional = args.positional.slice(1);
             return registryLifecycleCommand.run(args);
         }
-        process.stderr.write('Usage: shrk registry lifecycle\n');
+        if (sub !== undefined && sub.length > 0) {
+            // `<name> list | exists <id> | where <id>` — sub is the registry name.
+            return runRegistryInventory(args, sub);
+        }
+        const cwd = resolveCwd(args);
+        const loaded = await loadRegistries(cwd);
+        const names = loaded.ok ? loaded.registries.map((r) => r.name) : [];
+        process.stderr.write('Usage: shrk registry lifecycle | <name> list | <name> exists <id> | <name> where <id>\n' +
+            (names.length > 0 ? `Declared registries: ${names.join(', ')}.\n` : 'No registries declared (sharkcraft.config.ts `registries[]`).\n'));
         return 2;
     },
 };

package/dist/commands/report.command.js

@@ -8,7 +8,7 @@ const VALID_FORMATS = new Set(['text', 'markdown', 'html', 'json']);
 export const reportCommand = {
     name: 'report',
     description: 'Render runtime reports in text / markdown / html / json. Subcommands: adoption / session / quality / safety / review / coverage / drift / graph.',
-    usage: 'shrk report <adoption|session <id>|quality|safety|review <packet.json>|coverage|drift|graph> [--format text|markdown|html|json] [--output <path>] [--collapse-long-sections] [--max-items N] [--include-raw-json] [--json]',
+    usage: 'shrk report <adoption|session <id>|quality|safety|review <packet.json>|coverage|drift|graph> [--format text|markdown|html|json] [--output <path>] [--collapse-long-sections] [--max-items N] [--json]',
     async run(args) {
         const sub = args.positional[0];
         const sliced = { ...args, positional: args.positional.slice(1) };

package/dist/commands/reuse.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reuse.command.d.ts","sourceRoot":"","sources":["../../src/commands/reuse.command.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA4DhC,eAAO,MAAM,YAAY,EAAE,eA0J1B,CAAC"}
+{"version":3,"file":"reuse.command.d.ts","sourceRoot":"","sources":["../../src/commands/reuse.command.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA4DhC,eAAO,MAAM,YAAY,EAAE,eAqK1B,CAAC"}

package/dist/commands/reuse.command.js

@@ -1,5 +1,5 @@
 import { GraphStore, GraphQueryApi } from '@shrkcrft/graph';
-import { loadProjectConfig } from '@shrkcrft/config';
+import { resolveProjectConfig } from '@shrkcrft/inspector';
 import { flagBool, flagNumber, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
 const STOP = new Set([
@@ -49,7 +49,7 @@ export const reuseCommand = {
             process.stderr.write('Usage: shrk reuse "<what I want to build>" [--limit N] [--json]\n');
             return 2;
         }
-        const loaded = await loadProjectConfig(cwd);
+        const loaded = await resolveProjectConfig(cwd);
         if (!loaded.ok) {
             const msg = loaded.error.message;
             if (wantJson) {
@@ -61,14 +61,24 @@ export const reuseCommand = {
             return 1;
         }
         const primitives = loaded.value.config.reusePrimitives ?? [];
+        const planeDiagnostics = loaded.value.planeDiagnostics;
+        // reuse has no pre-existing diagnostics surface; expose pack-plane merge
+        // notes (missing/invalid pack primitive files, dropped collisions) so a
+        // pack contribution that failed to load isn't silently invisible.
+        const planeJson = planeDiagnostics.length > 0 ? { planeDiagnostics } : {};
+        const writePlaneNotes = () => {
+            for (const d of planeDiagnostics)
+                process.stdout.write(`  ! ${d}\n`);
+        };
         if (primitives.length === 0) {
             if (wantJson) {
-                process.stdout.write(asJson({ schema: 'sharkcraft.reuse/v1', intent, results: [] }) + '\n');
+                process.stdout.write(asJson({ schema: 'sharkcraft.reuse/v1', intent, results: [], ...planeJson }) + '\n');
                 return 0;
             }
             process.stdout.write(header(`Reuse: "${intent}"`));
             process.stdout.write('  No reuse primitives configured. Declare `reusePrimitives[]` in sharkcraft.config.ts\n' +
                 '  to map roles/intents to canonical symbols (see docs/reuse.md).\n');
+            writePlaneNotes();
             return 0;
         }
         const tokens = tokenize(intent);
@@ -82,13 +92,14 @@ export const reuseCommand = {
         if (ranked.length === 0) {
             const roles = [...new Set(primitives.flatMap((p) => p.roles))].sort();
             if (wantJson) {
-                process.stdout.write(asJson({ schema: 'sharkcraft.reuse/v1', intent, results: [], availableRoles: roles }) + '\n');
+                process.stdout.write(asJson({ schema: 'sharkcraft.reuse/v1', intent, results: [], availableRoles: roles, ...planeJson }) + '\n');
                 return 0;
             }
             process.stdout.write(header(`Reuse: "${intent}"`));
             process.stdout.write('  No primitive matched. Available roles:\n');
             for (const r of roles.slice(0, 40))
                 process.stdout.write(`    • ${r}\n`);
+            writePlaneNotes();
             return 0;
         }
         const results = ranked.map(({ p, score }) => {
@@ -149,10 +160,11 @@ export const reuseCommand = {
             return r;
         });
         if (wantJson) {
-            process.stdout.write(asJson({ schema: 'sharkcraft.reuse/v1', intent, graphIndexed: !!api, results }) + '\n');
+            process.stdout.write(asJson({ schema: 'sharkcraft.reuse/v1', intent, graphIndexed: !!api, results, ...planeJson }) + '\n');
             return 0;
         }
         process.stdout.write(header(`Reuse: "${intent}"`));
+        writePlaneNotes();
         if (!api) {
             process.stdout.write('  (code graph missing — import path/siblings/consumers limited; run `shrk graph index`)\n');
         }

package/dist/commands/review.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.command.d.ts","sourceRoot":"","sources":["../../src/commands/review.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA6GhC,eAAO,MAAM,aAAa,EAAE,eA+E3B,CAAC"}
+{"version":3,"file":"review.command.d.ts","sourceRoot":"","sources":["../../src/commands/review.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA6GhC,eAAO,MAAM,aAAa,EAAE,eAiG3B,CAAC"}

package/dist/commands/review.command.js

@@ -77,7 +77,20 @@ function scaffoldOptionsFromArgs(args) {
 export const reviewCommand = {
     name: 'review',
     description: 'Build a PR-review packet: changed files (via git), affected path conventions, relevant rules/templates/pipelines, boundary violations on those files, missing-test heuristic, verification commands. Also: `shrk review scaffold github-action` prints a workflow template with optional `--with-boundaries / --with-coverage / --with-drift / --artifact-only / --comment-placeholder` flags. `shrk review render-comment <packet.json>` renders a Markdown PR comment from a saved packet.',
-    usage: 'shrk [--cwd <dir>] review [--since <ref>] [--staged] [--files a,b] [--json] | shrk review scaffold github-action [...] | shrk review render-comment <packet.json> [--output <file>]',
+    usage: 'shrk [--cwd <dir>] review [files... | --files a,b] [--since <ref>] [--staged] [--no-untracked] [--json] | shrk review scaffold github-action [...] | shrk review render-comment <packet.json> [--output <file>]',
+    booleanFlags: new Set([
+        'json',
+        'staged',
+        'untracked',
+        'no-untracked',
+        'v2',
+        'v3',
+        'with-boundaries',
+        'with-coverage',
+        'with-drift',
+        'artifact-only',
+        'comment-placeholder',
+    ]),
     async run(args) {
         if (args.positional[0] === 'scaffold') {
             const which = args.positional[1] ?? 'github-action';
@@ -97,11 +110,16 @@ export const reviewCommand = {
         }
         const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
         const since = flagString(args, 'since');
-        const files = flagList(args, 'files');
+        // Accept files via `--files a,b` OR as bare positional args
+        // (`shrk review a.ts b.ts`). Positionals were previously dropped silently,
+        // yielding a confident "0 changed files" with exit 0.
+        const filesFlag = flagList(args, 'files');
+        const files = filesFlag.length ? filesFlag : args.positional;
         const packet = buildReviewPacket(inspection, {
             ...(since ? { since } : {}),
             ...(flagBool(args, 'staged') ? { staged: true } : {}),
             ...(files.length ? { files } : {}),
+            ...(flagBool(args, 'no-untracked') ? { untracked: false } : {}),
         });
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson(packet) + '\n');

package/dist/commands/rule-graph-subverbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-graph-subverbs.d.ts","sourceRoot":"","sources":["../../src/commands/rule-graph-subverbs.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwB,KAAK,eAAe,EAAmB,MAAM,wBAAwB,CAAC;AAGrG,eAAO,MAAM,gBAAgB,EAAE,eAc9B,CAAC"}
+{"version":3,"file":"rule-graph-subverbs.d.ts","sourceRoot":"","sources":["../../src/commands/rule-graph-subverbs.ts"],"names":[],"mappings":"AASA,OAAO,EAAwB,KAAK,eAAe,EAAmB,MAAM,wBAAwB,CAAC;AAGrG,eAAO,MAAM,gBAAgB,EAAE,eAc9B,CAAC"}

package/dist/commands/rule-graph-subverbs.js

@@ -5,7 +5,8 @@
  * because the verbs operate on a separate `.sharkcraft/bridge/` store
  * and don't conceptually belong under `shrk graph`.
  */
-import { buildBridge, RuleGraphQueryApi } from '@shrkcrft/rule-graph';
+import { buildBridge, BridgeStore, RuleGraphQueryApi } from '@shrkcrft/rule-graph';
+import { detectGraphFreshness } from '@shrkcrft/graph';
 import { flagBool, resolveCwd } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
 export const ruleGraphCommand = {
@@ -54,13 +55,39 @@ async function runStatus(args) {
         return 1;
     }
     const api = RuleGraphQueryApi.fromStores(cwd);
-    // No public counters from the API itself — just confirm it loads.
+    // The bridge maps code-graph files → asset registries, so it is stale once
+    // the underlying code graph has drifted. Reuse the already-available graph
+    // freshness signal (the same one `graph status` reports) rather than a
+    // hardcoded 'fresh'. `lastBuiltAt` comes from the bridge manifest.
+    let lastBuiltAt = null;
+    try {
+        lastBuiltAt = new BridgeStore(cwd).loadSnapshot().manifest.lastBuiltAt;
+    }
+    catch {
+        lastBuiltAt = null;
+    }
+    const fresh = detectGraphFreshness(cwd);
+    const behind = fresh.modified.length + fresh.added.length + fresh.deleted.length;
+    const state = behind > 0 ? 'stale' : 'fresh';
     if (wantJson) {
-        process.stdout.write(asJson({ ok: true, state: 'fresh' }) + '\n');
+        process.stdout.write(asJson({
+            ok: true,
+            state,
+            lastBuiltAt,
+            modifiedSinceIndex: fresh.modified.length,
+            newSinceIndex: fresh.added.length,
+            deletedSinceIndex: fresh.deleted.length,
+            ...(state === 'stale' ? { nextCommand: 'shrk rule-graph index' } : {}),
+        }) + '\n');
         return 0;
     }
     process.stdout.write(header('Rule-graph status'));
-    process.stdout.write(kv('state', 'fresh') + '\n');
+    if (lastBuiltAt)
+        process.stdout.write(kv('last built', lastBuiltAt) + '\n');
+    process.stdout.write(kv('state', state) + '\n');
+    if (state === 'stale') {
+        process.stdout.write(`! stale — ${fresh.modified.length} modified, ${fresh.added.length} new, ${fresh.deleted.length} deleted in the code graph since the bridge was built; re-run \`shrk rule-graph index\`\n`);
+    }
     void api;
     return 0;
 }

package/dist/commands/search-structural.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-structural.command.d.ts","sourceRoot":"","sources":["../../src/commands/search-structural.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAkErC,CAAC"}
+{"version":3,"file":"search-structural.command.d.ts","sourceRoot":"","sources":["../../src/commands/search-structural.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAkErC,CAAC"}

package/dist/commands/search-structural.command.js

@@ -1,7 +1,7 @@
 import { readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { applyRewritePlan, PatternRegistryStore, planRewrite, runSearch, signRewritePlan, STARTER_PATTERNS, verifySignedRewritePlan, } from '@shrkcrft/structural-search';
-import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
+import { flagBool, flagPositiveInt, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
 /**
  * `shrk search structural` — declarative AST pattern matching with
@@ -49,7 +49,7 @@ export const searchStructuralCommand = {
             process.stderr.write(`Pattern parse error: ${e.message}\n`);
             return 2;
         }
-        const limit = Number(flagString(args, 'limit') ?? '200');
+        const limit = flagPositiveInt(args, 'limit', 200);
         // Rewrite path?
         const recipeInline = flagString(args, 'rewrite');
         const recipeFile = flagString(args, 'rewrite-file');

package/dist/commands/search.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.command.d.ts","sourceRoot":"","sources":["../../src/commands/search.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA0BhC,eAAO,MAAM,aAAa,EAAE,eAuG3B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA+FrC,CAAC;AAwEF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,eASzC,CAAC"}
+{"version":3,"file":"search.command.d.ts","sourceRoot":"","sources":["../../src/commands/search.command.ts"],"names":[],"mappings":"AAiBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAkChC,eAAO,MAAM,aAAa,EAAE,eAsH3B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA+FrC,CAAC;AAwEF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,eASzC,CAAC"}

package/dist/commands/search.command.js

@@ -1,8 +1,15 @@
-import { buildSearchIndex, entrypointBanner, explainSearchTuning, inspectSharkcraft, loadConstructs, loadPlaybooks, loadSearchTuning, renderSearchText, renderTuningExplainHtml, renderTuningExplainMarkdown, searchIndex, SearchKind, SearchSource, } from '@shrkcrft/inspector';
+import { buildSearchIndex, entrypointBanner, explainSearchTuning, inspectSharkcraft, loadConstructs, loadPlaybooks, loadSearchTuning, renderSearchText, renderTuningExplainHtml, renderTuningExplainMarkdown, searchIndex, SearchKind, SearchResultKind, SearchSource, } from '@shrkcrft/inspector';
 import { flagBool, flagNumber, flagString, flagList, resolveCwd, } from "../command-registry.js";
 import { asJson } from "../output/format-output.js";
 const VALID_KINDS = new Set(Object.values(SearchKind));
 const VALID_SOURCES = new Set(Object.values(SearchSource));
+// Universal-search (v2) filter vocabularies. `--kind` is one of the
+// `SearchResultKind` enum values; `--source` is the local/pack origin the
+// engine actually filters hits by (`makeHit` only ever emits these two). Both
+// are validated up front so a typo'd value rejects loudly instead of silently
+// filtering every hit out and returning an empty result with exit 0.
+const VALID_RESULT_KINDS = Object.values(SearchResultKind);
+const VALID_RESULT_SOURCES = ['local', 'pack'];
 function parseKinds(args) {
     const list = flagList(args, 'type').concat(flagList(args, 'kind'));
     if (list.length === 0)
@@ -48,6 +55,17 @@ export const searchCommand = {
             const { buildUniversalSearch, renderUniversalSearchText, renderUniversalSearchMarkdown, } = await import('@shrkcrft/inspector');
             const kindFilter = flagString(args, 'kind');
             const sourceFilter = flagString(args, 'source');
+            // Validate the filter vocabularies BEFORE building opts — universal-search
+            // silently drops every non-matching hit, so an unknown `--kind`/`--source`
+            // would otherwise return an empty result with exit 0.
+            if (kindFilter && !VALID_RESULT_KINDS.includes(kindFilter)) {
+                process.stderr.write(`Unknown --kind ${kindFilter}. Valid: ${VALID_RESULT_KINDS.join(', ')}\n`);
+                return 2;
+            }
+            if (sourceFilter && !VALID_RESULT_SOURCES.includes(sourceFilter)) {
+                process.stderr.write(`Unknown --source ${sourceFilter}. Valid: ${VALID_RESULT_SOURCES.join(', ')}\n`);
+                return 2;
+            }
             const limit = flagNumber(args, 'limit');
             const opts = {};
             if (kindFilter)

package/dist/commands/simulate.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simulate.command.d.ts","sourceRoot":"","sources":["../../src/commands/simulate.command.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,eAAe,EAAE,eAmD7B,CAAC"}
+{"version":3,"file":"simulate.command.d.ts","sourceRoot":"","sources":["../../src/commands/simulate.command.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAKhC,eAAO,MAAM,eAAe,EAAE,eAyD7B,CAAC"}

package/dist/commands/simulate.command.js

@@ -3,10 +3,11 @@ import * as nodePath from 'node:path';
 import { inspectSharkcraft, OrchestrationMode, renderWorkflowSimulationText, simulateWorkflow, } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson } from "../output/format-output.js";
+const VALID_SIMULATION_MODES = ['conservative', 'balanced', 'aggressive'];
 export const simulateCommand = {
     name: 'simulate',
     description: 'Predict what a workflow would do without executing anything. Read-only. Optionally takes a playbook or pipeline id.',
-    usage: 'shrk simulate "<task>" [--playbook <id>] [--pipeline <id>] [--bundle] [--mode conservative|balanced|aggressive] [--json] [--output <file>]',
+    usage: 'shrk simulate "<task>" [--playbook <id>] [--pipeline <id>] [--mode conservative|balanced|aggressive] [--json] [--output <file>]',
     async run(args) {
         const task = args.positional.join(' ').trim();
         if (!task) {
@@ -18,6 +19,10 @@ export const simulateCommand = {
         const playbookId = flagString(args, 'playbook');
         const pipelineId = flagString(args, 'pipeline');
         const modeRaw = (flagString(args, 'mode') ?? '').toLowerCase();
+        // Warn on a typo'd --mode rather than silently treating it as balanced.
+        if (modeRaw && !VALID_SIMULATION_MODES.includes(modeRaw)) {
+            process.stderr.write(`Unknown --mode ${modeRaw}. Valid: ${VALID_SIMULATION_MODES.join(', ')} (defaulting to balanced).\n`);
+        }
         const mode = modeRaw === 'conservative'
             ? OrchestrationMode.Conservative
             : modeRaw === 'aggressive'

package/dist/commands/smart-context.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-context.command.d.ts","sourceRoot":"","sources":["../../src/commands/smart-context.command.ts"],"names":[],"mappings":"AAyBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAmFhC,eAAO,MAAM,mBAAmB,EAAE,eAuNjC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,EAAE,eAmF1C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,eAwBrC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,EAAE,eAkCrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAmH/C,CAAC;AA2JF;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAoH/C,CAAC;AA2JF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAgG/C,CAAC;AAyPF,4EAA4E;AAC5E,eAAO,MAAM,kCAAkC,EAAE,eAuHhD,CAAC;AAMF,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,EAAE,eAsCjD,CAAC;AAqJF,UAAU,eAAe;IACvB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAWzF"}
+{"version":3,"file":"smart-context.command.d.ts","sourceRoot":"","sources":["../../src/commands/smart-context.command.ts"],"names":[],"mappings":"AA2BA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAmFhC,eAAO,MAAM,mBAAmB,EAAE,eAmQjC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,EAAE,eAsF1C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,eAwBrC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,EAAE,eAkCrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAmH/C,CAAC;AA2JF;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAoH/C,CAAC;AA2JF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAgG/C,CAAC;AAyPF,4EAA4E;AAC5E,eAAO,MAAM,kCAAkC,EAAE,eAuHhD,CAAC;AAMF,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,EAAE,eAsCjD,CAAC;AAqJF,UAAU,eAAe;IACvB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAWzF"}