@shrkcrft/cli 0.1.0-alpha.21 → 0.1.0-alpha.23

package/dist/command-registry.d.ts

@@ -149,6 +149,15 @@ export declare function resolveCwd(args: ParsedArgs): string;
 export declare function flagString(args: ParsedArgs, name: string): string | undefined;
 export declare function flagBool(args: ParsedArgs, name: string): boolean;
 export declare function flagNumber(args: ParsedArgs, name: string): number | undefined;
+/**
+ * Parse a `--limit`/`--depth`-style flag as a positive integer, falling back to
+ * `fallback` when the flag is absent OR malformed (non-numeric, NaN, <= 0,
+ * non-integer). Guards the `Number(flagString(...))` footgun where a
+ * fat-fingered `--limit abc` becomes NaN and silently yields empty-or-unbounded
+ * results (`[].slice(0, NaN) === []`, `x >= NaN === false`). Use everywhere a
+ * count/cap is read from a flag.
+ */
+export declare function flagPositiveInt(args: ParsedArgs, name: string, fallback: number): number;
 /**
  * Canonical multi-value flag parser.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"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"}

package/dist/command-registry.js

@@ -396,6 +396,21 @@ export function flagNumber(args, name) {
     const n = Number(v);
     return Number.isFinite(n) ? n : undefined;
 }
+/**
+ * Parse a `--limit`/`--depth`-style flag as a positive integer, falling back to
+ * `fallback` when the flag is absent OR malformed (non-numeric, NaN, <= 0,
+ * non-integer). Guards the `Number(flagString(...))` footgun where a
+ * fat-fingered `--limit abc` becomes NaN and silently yields empty-or-unbounded
+ * results (`[].slice(0, NaN) === []`, `x >= NaN === false`). Use everywhere a
+ * count/cap is read from a flag.
+ */
+export function flagPositiveInt(args, name, fallback) {
+    const v = args.flags.get(name);
+    if (typeof v !== 'string')
+        return fallback;
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : fallback;
+}
 export function flagList(args, name, options = {}) {
     const split = options.split ?? 'always';
     const raw = args.multiFlags.get(name) ?? [];

package/dist/commands/ai-status.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-status.command.d.ts","sourceRoot":"","sources":["../../src/commands/ai-status.command.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,EAAE,eAkD7B,CAAC"}
+{"version":3,"file":"ai-status.command.d.ts","sourceRoot":"","sources":["../../src/commands/ai-status.command.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,EAAE,eA+D7B,CAAC"}

package/dist/commands/ai-status.command.js

@@ -34,9 +34,15 @@ export const aiStatusCommand = {
                 ? await pingProvider(selection.provider, pingTimeoutMs)
                 : { ok: false, reason: 'no provider reachable — nothing to ping', elapsedMs: 0 };
         }
+        // Freshness-shaped signal, consistent with the other status commands:
+        // the LLM wiring is `fresh` when a provider is reachable (and the optional
+        // ping succeeded), else `stale` — i.e. shrk is on the deterministic
+        // baseline and the setup hints apply.
+        const state = ai.reachable && (!ping || ping.ok) ? 'fresh' : 'stale';
         if (json) {
             process.stdout.write(asJson({
                 ai,
+                state,
                 ...(ping ? { ping } : {}),
             }) + '\n');
             return ai.reachable && (!ping || ping.ok) ? 0 : 1;
@@ -45,6 +51,10 @@ export const aiStatusCommand = {
         process.stdout.write(kv('reachable', ai.reachable ? 'yes' : 'no') + '\n');
         process.stdout.write(kv('requested provider', ai.requestedProvider) + '\n');
         process.stdout.write(kv('resolved provider', ai.providerId ?? '(none)') + '\n');
+        process.stdout.write(kv('state', state) + '\n');
+        if (state === 'stale') {
+            process.stdout.write('! stale — no AI provider reachable; running on the deterministic baseline. See the setup hints below.\n');
+        }
         if (ping) {
             process.stdout.write(kv('ping', ping.ok
                 ? `ok in ${ping.elapsedMs}ms` + (ping.model ? ` (model: ${ping.model})` : '')

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

@@ -1 +1 @@
-{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../src/commands/apply.command.ts"],"names":[],"mappings":"AAqDA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAyLhC,eAAO,MAAM,YAAY,EAAE,eAisB1B,CAAC"}
+{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../src/commands/apply.command.ts"],"names":[],"mappings":"AAqDA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAyLhC,eAAO,MAAM,YAAY,EAAE,eAwsB1B,CAAC"}

package/dist/commands/apply.command.js

@@ -407,7 +407,12 @@ export const applyCommand = {
             livePlan = result.value.plan;
         }
         const diff = diffPlanChanges(saved, livePlan);
-        if (diff.length > 0 && !allowDivergent && !force) {
+        // Divergence acceptance is decoupled from the overwrite strategy: only the
+        // explicit --allow-divergent waives a divergence refusal. --force selects
+        // the overwrite strategy and must NOT double as a silent divergence bypass
+        // (a signed-but-drifted plan would otherwise apply while printing
+        // "Signature: verified"). A user who wants both passes --force --allow-divergent.
+        if (diff.length > 0 && !allowDivergent) {
             if (!wantJson) {
                 process.stdout.write('Plan diverged from the saved version:\n');
                 for (const d of diff) {
@@ -462,7 +467,9 @@ export const applyCommand = {
         // continue to carry their structured folderOps verbatim.
         const liveFolderOps = plannedFolderOps;
         const folderOpDiff = diffPlanFolderOps(saved, liveFolderOps);
-        if (folderOpDiff.length > 0 && !allowDivergent && !force) {
+        // Same decoupling as the file-op divergence gate above: --force is the
+        // overwrite strategy only; --allow-divergent is the explicit waiver.
+        if (folderOpDiff.length > 0 && !allowDivergent) {
             if (!wantJson) {
                 process.stdout.write('Folder-op set diverged from the saved version:\n');
                 for (const d of folderOpDiff) {

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

@@ -1 +1 @@
-{"version":3,"file":"ask.command.d.ts","sourceRoot":"","sources":["../../src/commands/ask.command.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,UAAU,EAAE,eA6DxB,CAAC"}
+{"version":3,"file":"ask.command.d.ts","sourceRoot":"","sources":["../../src/commands/ask.command.ts"],"names":[],"mappings":"AAYA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,UAAU,EAAE,eA8DxB,CAAC"}

package/dist/commands/ask.command.js

@@ -1,4 +1,4 @@
-import { inspectSharkcraft, buildProjectOverview, renderOverviewText } from '@shrkcrft/inspector';
+import { inspectSharkcraft, buildProjectOverview, renderOverviewText, contextTuningBoostFor, } from '@shrkcrft/inspector';
 import { buildContext } from '@shrkcrft/context';
 import { AiMessageRole, buildPromptMessages, selectAiProvider, } from '@shrkcrft/ai';
 import { flagBool, flagNumber, flagString, resolveCwd, } from "../command-registry.js";
@@ -24,6 +24,7 @@ export const askCommand = {
             task: question,
             maxTokens,
             projectOverview: renderOverviewText(overview),
+            boostFor: contextTuningBoostFor(inspection, question),
         });
         const messages = buildPromptMessages({
             systemPreamble: 'You are an AI engineer working in a SharkCraft-instrumented repository. Use the supplied repository context as authoritative ground truth. Quote knowledge entry ids you used.',

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

@@ -1 +1 @@
-{"version":3,"file":"changes.command.d.ts","sourceRoot":"","sources":["../../src/commands/changes.command.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAqHhC,eAAO,MAAM,cAAc,EAAE,eAoB5B,CAAC"}
+{"version":3,"file":"changes.command.d.ts","sourceRoot":"","sources":["../../src/commands/changes.command.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA2HhC,eAAO,MAAM,cAAc,EAAE,eAwB5B,CAAC"}

package/dist/commands/changes.command.js

@@ -14,7 +14,11 @@ async function runChangesSummary(args) {
     const inspection = await inspectSharkcraft({ cwd });
     const since = flagString(args, 'since');
     const staged = flagBool(args, 'staged');
-    const files = flagList(args, 'files');
+    // `--files a,b` OR bare positional args after the subverb
+    // (`shrk changes summary a.ts b.ts`). Positionals were dropped silently
+    // before, yielding a confident full-diff / "0 files" with exit 0.
+    const filesFlag = flagList(args, 'files');
+    const files = filesFlag.length ? filesFlag : args.positional;
     // Optional round / label propagated into the report.
     const roundLabel = flagString(args, 'round') ?? flagString(args, 'label');
     const opts = {};
@@ -79,7 +83,9 @@ async function runChangesAcceptanceReplay(args) {
     const inspection = await inspectSharkcraft({ cwd });
     const since = flagString(args, 'since');
     const staged = flagBool(args, 'staged');
-    const files = flagList(args, 'files');
+    // `--files a,b` OR bare positional args after the subverb (see above).
+    const filesFlag = flagList(args, 'files');
+    const files = filesFlag.length ? filesFlag : args.positional;
     const roundLabel = flagString(args, 'round') ?? flagString(args, 'label');
     const profileRaw = flagString(args, 'profile') ?? 'changed-only';
     const profile = (() => {
@@ -136,12 +142,16 @@ async function runChangesAcceptanceReplay(args) {
 export const changesCommand = {
     name: 'changes',
     description: 'Changes summary — grouped diff over --since/--staged/--files. Supports --round label and `changes acceptance-replay`. Read-only.',
-    usage: 'shrk changes <summary|impact|report|acceptance-replay> [--since <ref>] [--staged] [--files a,b,c] [--round <name>] [--profile changed-only|standard|strict] [--format text|markdown|json] [--output <file>]',
+    usage: 'shrk changes <summary|impact|report|acceptance-replay> [files... | --files a,b,c] [--since <ref>] [--staged] [--round <name>] [--profile changed-only|standard|strict] [--format text|markdown|json] [--output <file>]',
+    booleanFlags: new Set(['json', 'staged']),
     async run(args) {
         const sub = args.positional[0];
         const sliced = { ...args, positional: args.positional.slice(1) };
+        // Always dispatch on the sliced args so positionals AFTER the subverb
+        // become the file list (handled in the runners). Passing the un-sliced
+        // `args` here used to leak the subverb token (e.g. "summary") forward.
         if (sub === 'summary' || sub === undefined)
-            return runChangesSummary(sliced.positional.length > 0 ? sliced : args);
+            return runChangesSummary(sliced);
         if (sub === 'report')
             return runChangesSummary(sliced);
         if (sub === 'impact')

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

@@ -1 +1 @@
-{"version":3,"file":"check.command.d.ts","sourceRoot":"","sources":["../../src/commands/check.command.ts"],"names":[],"mappings":"AAmBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAikBhC,eAAO,MAAM,YAAY,EAAE,eA0D1B,CAAC"}
+{"version":3,"file":"check.command.d.ts","sourceRoot":"","sources":["../../src/commands/check.command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAurBhC,eAAO,MAAM,YAAY,EAAE,eAyE1B,CAAC"}

package/dist/commands/check.command.js

@@ -1,4 +1,4 @@
-import { buildAiReadinessReport, buildImportHygieneReport, buildPackDoctorReport, ChangedScopeMode, diagnoseActionHints, emitImportHygieneAllowlistDraft, filterViolationsToChangedScope, ImportHygieneFindingKind, inspectSharkcraft, isTodoReason, renderImportHygieneText, resolveChangedFiles, runDoctor, suggestBoundaryFixes, } from '@shrkcrft/inspector';
+import { buildAiReadinessReport, buildImportHygieneReport, buildPackDoctorReport, ChangedScopeMode, diagnoseActionHints, emitImportHygieneAllowlistDraft, filterViolationsToChangedScope, ImportHygieneFindingKind, inspectSharkcraft, isTodoReason, renderImportHygieneText, resolveChangedFiles, resolveProjectConfig, runDoctor, suggestBoundaryFixes, } from '@shrkcrft/inspector';
 import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { flagBool, flagNumber, flagString, flagVars, resolveCwd, } from "../command-registry.js";
@@ -6,7 +6,7 @@ import { asJson, header, kv } from "../output/format-output.js";
 import { maybeRunInWatchMode } from "../output/watch-loop.js";
 import { validateTemplateVariables } from '@shrkcrft/templates';
 import { FileChangeType, planGeneration } from '@shrkcrft/generator';
-import { evaluateBoundaries, loadTsconfigPaths, scanImports, summarizeImports, } from '@shrkcrft/boundaries';
+import { evaluateBoundaries, loadTsconfigPaths, runWiring, scanImports, summarizeImports, } from '@shrkcrft/boundaries';
 function knowledgeGroup(inspection) {
     const dup = inspection.validationIssues.filter((i) => i.code === 'duplicate-id');
     const missing = inspection.validationIssues.filter((i) => i.code !== 'duplicate-id');
@@ -517,20 +517,136 @@ async function checkBoundariesOnce(args) {
     return failed ? 1 : 0;
 }
 // ────────────────────────────────────────────────────────────────────────
+// ────────────────────────────────────────────────────────────────────────
+// Subcommand: wiring — "declared but not wired" completeness checks
+// ────────────────────────────────────────────────────────────────────────
+async function checkWiring(args) {
+    const cwd = resolveCwd(args);
+    const wantJson = flagBool(args, 'json');
+    const changedOnly = flagBool(args, 'changed-only');
+    const since = flagString(args, 'since');
+    const only = flagString(args, 'only');
+    // Distinguish "config is invalid" from "config valid with no wiring rules":
+    // an invalid config (e.g. a malformed wiringRule) must NOT fail open with a
+    // misleading "no rules configured" + exit 0.
+    const loaded = await resolveProjectConfig(cwd);
+    if (!loaded.ok) {
+        const msg = loaded.error.message;
+        if (wantJson) {
+            process.stdout.write(asJson({ schema: 'sharkcraft.wiring/v1', error: msg, rules: [], violations: [], diagnostics: [msg], verdict: 'errors' }) + '\n');
+            return 1;
+        }
+        process.stdout.write(header('Wiring check'));
+        process.stdout.write(`  ✗ Could not load config: ${msg}\n  Run \`shrk doctor\` for details.\n`);
+        return 1;
+    }
+    const rules = loaded.value.config.wiringRules ?? [];
+    const planeDiagnostics = loaded.value.planeDiagnostics;
+    if (rules.length === 0) {
+        if (wantJson) {
+            process.stdout.write(asJson({ schema: 'sharkcraft.wiring/v1', rules: [], violations: [], verdict: 'pass' }) + '\n');
+            return 0;
+        }
+        process.stdout.write(header('Wiring check'));
+        process.stdout.write('  No wiring rules configured. Declare `wiringRules[]` in sharkcraft.config.ts to enable\n' +
+            '  cross-file "declared but not wired" checks (see docs/wiring.md).\n');
+        return 0;
+    }
+    let changedFiles;
+    if (changedOnly || since) {
+        const changed = resolveChangedFiles({
+            projectRoot: cwd,
+            ...(since ? { since } : {}),
+            ...(changedOnly && !since ? { includeWorktree: true } : {}),
+        });
+        changedFiles = changed.files;
+    }
+    const reportRaw = runWiring(cwd, rules, {
+        ...(changedOnly || since ? { changedOnly: true, changedFiles: changedFiles ?? [] } : {}),
+        ...(only ? { only: only.split(',').map((s) => s.trim()).filter(Boolean) } : {}),
+    });
+    // Surface pack-plane merge notes (missing/invalid pack rule files, dropped
+    // collisions) alongside the rule engine's own misconfiguration diagnostics.
+    const report = planeDiagnostics.length > 0
+        ? { ...reportRaw, diagnostics: [...reportRaw.diagnostics, ...planeDiagnostics] }
+        : reportRaw;
+    if (wantJson) {
+        process.stdout.write(asJson(report) + '\n');
+        return report.verdict === 'errors' ? 1 : 0;
+    }
+    process.stdout.write(header('Wiring check'));
+    // `evaluated` counts rules that actually ran a comparison (globs matched >0
+    // files). When 0 rules evaluated but rules ARE configured, say so loudly —
+    // "checked nothing" must never read as the green "every token is wired" pass.
+    if (report.evaluated === 0) {
+        process.stdout.write(`  ! Nothing evaluated — ${report.rules.length} rule(s) configured but none matched files in scope` +
+            (changedOnly || since ? ' (changed-only).\n' : '.\n'));
+        return 0;
+    }
+    process.stdout.write(kv('rules evaluated', `${report.evaluated} of ${report.rules.length}`) + '\n');
+    const errors = report.violations.filter((v) => v.severity === 'error').length;
+    const warnings = report.violations.filter((v) => v.severity === 'warning').length;
+    process.stdout.write(kv('violations', `${errors} error(s), ${warnings} warning(s)`) + '\n');
+    // Misconfigured rules (uncompilable pattern / no capture group) — surface
+    // them loudly; a broken rule must never read as a silent green.
+    if (report.diagnostics.length > 0) {
+        process.stdout.write('\nMisconfigured rules:\n');
+        for (const d of report.diagnostics)
+            process.stdout.write(`  ! ${d}\n`);
+    }
+    if (report.violations.length === 0 && report.diagnostics.length === 0) {
+        process.stdout.write('\nNo wiring violations — every declared token is registered. ✓\n');
+        return 0;
+    }
+    if (report.violations.length === 0) {
+        return report.verdict === 'errors' ? 1 : 0;
+    }
+    // Group by rule for a readable report.
+    for (const r of report.rules) {
+        if (r.violations.length === 0)
+            continue;
+        process.stdout.write(`\n[${r.severity}] ${r.ruleId}${r.description ? ' — ' + r.description : ''}\n`);
+        process.stdout.write(`  declared ${r.declaredCount} / registered ${r.registeredCount} — ${r.violations.length} not wired:\n`);
+        for (const v of r.violations.slice(0, 50)) {
+            process.stdout.write(`    • ${v.token}  (${v.file}:${v.line})\n`);
+        }
+        if (r.violations.length > 50) {
+            process.stdout.write(`    … (${r.violations.length - 50} more)\n`);
+        }
+        const hint = r.violations.find((v) => v.hint)?.hint;
+        if (hint)
+            process.stdout.write(`    → ${hint}\n`);
+    }
+    return report.verdict === 'errors' ? 1 : 0;
+}
 // Main shrk check + subcommands
 // ────────────────────────────────────────────────────────────────────────
 export const checkCommand = {
     name: 'check',
     description: 'Run SharkCraft-level validation across knowledge / rules / templates / pipelines / packs / action hints / doctor. `check boundaries [--watch [--paths a,b] [--debounce N] [--once]]` re-runs the boundary scan on file changes.',
-    usage: 'shrk [--cwd <dir>] check [packs|pipelines|knowledge|generation|boundaries|imports] [--strict] [--min-score <0-100>] [--json] [--watch [--paths <list>] [--debounce N] [--once]]',
+    usage: 'shrk [--cwd <dir>] check [packs|pipelines|knowledge|generation|boundaries|imports|wiring] [--strict] [--min-score <0-100>] [--changed-only] [--since <ref>] [--only <ids>] [--json] [--watch [--paths <list>] [--debounce N] [--once]]',
     async run(args) {
         const sub = args.positional[0];
+        // `check generation <id> <name>` legitimately takes extra positionals;
+        // every other subverb (boundaries/imports/wiring/…) and the full sweep are
+        // flag-driven. Reject stray positional file args instead of silently
+        // dropping them and reporting a confident green — pass files via --files.
+        if (sub !== 'generation') {
+            const extras = args.positional.slice(1);
+            if (extras.length > 0) {
+                process.stderr.write(`Unexpected positional argument(s): ${extras.join(', ')}. ` +
+                    `Use --files a.ts,b.ts (or --changed-only) instead of passing files positionally.\n`);
+                return 2;
+            }
+        }
         if (sub === 'generation')
             return checkGeneration(args);
         if (sub === 'boundaries')
             return checkBoundaries(args);
         if (sub === 'imports' || sub === 'import-hygiene')
             return checkImports(args);
+        if (sub === 'wiring')
+            return checkWiring(args);
         if (sub === 'registry-lifecycle') {
             const cwd = resolveCwd(args);
             const { buildRegistryLifecycleReport, renderRegistryLifecycleReportText } = await import('@shrkcrft/inspector');

package/dist/commands/command-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../src/commands/command-catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../src/commands/command-catalog.ts"],"names":[],"mappings":"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"}

package/dist/commands/command-catalog.js

@@ -382,6 +382,30 @@ export const COMMAND_CATALOG = Object.freeze([
         surface: CommandSurface.Common,
         taskRole: CommandTaskRole.Validate,
     }),
+    entry({
+        command: 'check wiring',
+        description: 'Completeness checks: flags config-defined "declared but not wired" tokens (a declared value/identifier set that must be a subset of a registered set). Generic + deterministic; rules from sharkcraft.config.ts wiringRules[]. [--changed-only] [--only <ids>] [--json]',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'policy-lint',
+        description: 'Lint template/markup, stylesheet, and AOT-invisible TS surfaces against config-defined policyRules[] — sees `.html` files AND inline `template:` strings that tsc/AOT cannot. Deterministic; no AI. [--surface template|style|ts] [--changed-only] [--only <ids>] [--json]',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'reuse',
+        description: 'Intent → the canonical primitive to reuse: matches your intent against config reusePrimitives[] then resolves the symbol through the code graph (transitive star-barrels) to its import path, sibling exports, and real consumer files to copy. Read-only; no AI.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Search,
+    }),
     entry({
         command: 'diff-check',
         description: 'Self-check current git diff against boundary + import-hygiene rules. Single-call composite for agents to validate edits before declaring done. Read-only.',
@@ -3182,6 +3206,206 @@ export const COMMAND_CATALOG = Object.freeze([
         intendedAudience: [CommandAudience.Human, CommandAudience.Maintainer],
         taskRole: CommandTaskRole.Inspect,
     }),
+    // ── D3-2: registered command groups that resolved live but had ZERO
+    // catalog entries, so `shrk commands doctor` was blind to them and
+    // `shrk help <group>` had no metadata. One canonical row per registered
+    // sub-verb. Everything is ReadOnly except `checks run --execute`
+    // (RunsShell) and `audit project-coupling` (RunsShell, advanced).
+    // `mcpAvailable` mirrors a real read-only MCP tool where one exists.
+    //
+    // paths — path-convention registry
+    // (MCP: list_path_conventions / get_path_convention / search_path_conventions).
+    entry({
+        command: 'paths list',
+        description: 'List path conventions.',
+        category: 'paths',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'paths get',
+        description: 'Get one path convention by id.',
+        category: 'paths',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'paths search',
+        description: 'Search path conventions by scope / query.',
+        category: 'paths',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Search,
+    }),
+    entry({
+        command: 'paths best',
+        description: 'Pick the best path convention for a task.',
+        category: 'paths',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    // pipelines — pipeline registry
+    // (MCP: list_pipelines / get_pipeline / get_pipeline_context / create_pipeline_plan).
+    entry({
+        command: 'pipelines list',
+        description: 'List available pipelines.',
+        category: 'pipelines',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'pipelines get',
+        description: 'Show one pipeline by id.',
+        category: 'pipelines',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'pipelines context',
+        description: 'Token-budgeted context for a pipeline + task.',
+        category: 'pipelines',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'pipelines plan',
+        description: 'Render a pipeline as an ordered step plan for a task.',
+        category: 'pipelines',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'pipelines script',
+        description: 'Render a pipeline as a runnable bash-style preview script (no execution).',
+        category: 'pipelines',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'pipelines next',
+        description: 'Show the next recommended step in a pipeline for a task.',
+        category: 'pipelines',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'pipelines vars',
+        description: 'List the variables a pipeline consumes.',
+        category: 'pipelines',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    // checks — custom-check registry declared by rules (metadata.checks[]).
+    entry({
+        command: 'checks list',
+        description: 'List custom checks declared by rules (metadata.checks[]). Read-only.',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'checks doctor',
+        description: 'Validate custom-check descriptors (missing fields, duplicate ids).',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Diagnose,
+    }),
+    entry({
+        command: 'checks run',
+        description: 'Preview a custom check. Read-only by default — pass --execute to run it.',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'checks run --execute',
+        description: 'Actually invoke the custom check command (runs the configured shell command).',
+        category: 'checks',
+        safetyLevel: SafetyLevel.RunsShell,
+        runsShell: true,
+        requiresReview: true,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'checks parse-report',
+        description: 'Parse a check report file into the canonical finding shape. Read-only.',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'checks import',
+        description: 'Import an external tool report into the universal check-result protocol. Read-only.',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'checks aggregate',
+        description: 'Aggregate multiple check reports into one verdict. Read-only.',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'checks report',
+        description: 'Render aggregated check results in the chosen format. Read-only.',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'checks convert',
+        description: 'Convert a check report between supported formats. Read-only.',
+        category: 'checks',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    // audit — project-specific coupling audit (MCP: get_project_coupling_report).
+    // RunsShell/advanced per the brief: the report/plan modes materialise
+    // artifacts and the audit is a heavyweight, opt-in surface.
+    entry({
+        command: 'audit project-coupling',
+        description: 'Audit / plan / report project-specific coupling. Pass --token to scan for identifiers; the engine ships zero built-in tokens.',
+        category: 'analysis',
+        safetyLevel: SafetyLevel.RunsShell,
+        runsShell: true,
+        mcpAvailable: true,
+        surface: CommandSurface.Advanced,
+        intendedAudience: [CommandAudience.Human, CommandAudience.Agent],
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    // ownership — CODEOWNERS / sharkcraft ownership registry
+    // (MCP: get_ownership / match_owners).
+    entry({
+        command: 'ownership list',
+        description: 'List ownership rules from CODEOWNERS / sharkcraft/ownership.ts.',
+        category: 'ownership',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'ownership for',
+        description: 'Show the ownership match for a single file.',
+        category: 'ownership',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'ownership affected',
+        description: 'Show owners affected by --since <ref>, --bundle <id>, or --files a,b.',
+        category: 'ownership',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
 ]);
 /** Return every canonical command string in the catalog. */
 export function listCatalogCommandStrings() {

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

@@ -1,5 +1,20 @@
 import { type CommandRegistry, type ICommandHandler } from '../command-registry.js';
+import { type ISurfaceProfile } from '../surface/profiles.js';
+import { type ICommandCatalogEntry } from './command-catalog.js';
 export declare function makeCommandsCommand(registry: CommandRegistry): ICommandHandler;
+export interface ICommandsProfileView {
+    profile: ISurfaceProfile;
+    entries: readonly ICommandCatalogEntry[];
+    hidden: readonly string[];
+    catalogTotal: number;
+}
+/**
+ * Pure: render the catalog as a surface profile sees it. Every command the
+ * profile lists in `hidden` is filtered out of `entries` (commands stay
+ * callable — this is a listing filter, not a disable). Returns undefined when
+ * the profile id is unknown. Exported for tests.
+ */
+export declare function buildCommandsProfileView(profileId: string, packProfiles?: readonly ISurfaceProfile[]): ICommandsProfileView | undefined;
 export interface IRetirementPlanGroup {
     reason: 'deprecated' | 'aliases' | 'machine-in-help' | 'overlapping' | 'missing-replacedBy' | 'legacy-no-removeAfter';
     entries: readonly {