@shrkcrft/cli 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/commands/codemod.command.js

@@ -8,23 +8,41 @@
 import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { affectedFromCheckReport, buildCodemodAssistReport, inspectSharkcraft, parseCustomCheckReportFromFile, renderCodemodAssistMarkdown, } from '@shrkcrft/inspector';
-import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
+import { formatRuleCompact } from '@shrkcrft/rules';
+import { flagBool, flagNumber, flagString, flagList, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
 async function loadRule(args) {
     const ruleId = flagString(args, 'rule');
     if (!ruleId) {
-        process.stderr.write('Missing --rule <ruleId>\n');
+        process.stderr.write('Missing --rule <ruleId>. Run `shrk codemod list` to see available rule ids.\n');
         return null;
     }
     const cwd = resolveCwd(args);
     const inspection = await inspectSharkcraft({ cwd });
     const rule = inspection.ruleService.get(ruleId);
     if (!rule) {
-        process.stderr.write(`No rule with id "${ruleId}".\n`);
+        process.stderr.write(`No rule with id "${ruleId}". Run \`shrk codemod list\` to see available rule ids.\n`);
         return null;
     }
     return { rule, cwd };
 }
+/** `shrk codemod list` — enumerate the rule ids codemod-assist accepts. */
+async function listRules(args) {
+    const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
+    let rules = inspection.ruleService.list();
+    const top = flagNumber(args, 'top');
+    if (top !== undefined && top > 0) {
+        rules = [...rules].sort((a, b) => a.id.localeCompare(b.id)).slice(0, top);
+    }
+    if (flagBool(args, 'json')) {
+        process.stdout.write(asJson(rules.map((r) => ({ id: r.id, type: r.type, priority: r.priority, title: r.title }))) + '\n');
+        return 0;
+    }
+    process.stdout.write(header(`Codemod rules (${rules.length})`));
+    for (const r of rules)
+        process.stdout.write(formatRuleCompact(r) + '\n');
+    return 0;
+}
 async function gatherAffected(args) {
     const fromReport = flagString(args, 'from-report');
     const out = [];
@@ -57,14 +75,17 @@ function writeAssistOutputs(cwd, ruleId, markdown, scriptTemplate) {
 export const codemodCommand = {
     name: 'codemod',
     description: 'Codemod-assist (NOT a codemod engine). Inventory + risk grouping + checklist + project-script template. Never rewrites source.',
-    usage: 'shrk codemod <inventory|plan|checklist> --rule <ruleId> [--from-report <path>] [--targets a,b,c] [--write-preview] [--json]',
+    usage: 'shrk codemod <list|inventory|plan|checklist> --rule <ruleId> [--from-report <path>] [--targets a,b,c] [--write-preview] [--json]',
     async run(args) {
         const sub = args.positional[0] ?? 'plan';
-        if (!['inventory', 'plan', 'checklist'].includes(sub)) {
-            process.stderr.write('Usage: shrk codemod <inventory|plan|checklist> --rule <ruleId>\n');
+        if (!['list', 'inventory', 'plan', 'checklist'].includes(sub)) {
+            process.stderr.write('Usage: shrk codemod <list|inventory|plan|checklist> --rule <ruleId>\n');
             return 2;
         }
         const inner = { ...args, positional: args.positional.slice(1) };
+        // `list` enumerates rule ids and needs no --rule.
+        if (sub === 'list')
+            return listRules(inner);
         const loaded = await loadRule(inner);
         if (!loaded)
             return 1;

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

@@ -236,9 +236,13 @@ export declare function commandLifecycle(e: ICommandCatalogEntry): CommandLifecy
 /**
  * Default-help visibility rule. Honors an explicit
  * {@link ICommandCatalogEntry.showInDefaultHelp} when set; otherwise
- * primary + common are visible and advanced / machine / internal / legacy
- * are hidden. Deprecated and retired commands are always hidden by
- * default regardless of surface.
+ * the {@link PRIMARY_VERBS_ALLOWLIST} gates membership in the visible
+ * surface (primary + common entries whose top-level verb pays rent
+ * make the cut; everything else is hidden from `--full-help`).
+ *
+ * Deprecated, retired, aliased commands and anything in the
+ * {@link R46_OVERLAY} are always hidden regardless of allowlist
+ * membership.
  */
 export declare function defaultShowInHelp(e: ICommandCatalogEntry): boolean;
 /**
@@ -262,4 +266,12 @@ export interface ICommandSafetyMatrixRow {
 }
 export declare function buildCommandSafetyMatrix(): readonly ICommandSafetyMatrixRow[];
 export declare function renderCommandSafetyMatrixMarkdown(rows: readonly ICommandSafetyMatrixRow[]): string;
+/**
+ * The set of TOP-LEVEL command verbs in the catalogue (the first token of each
+ * entry's `command`). The single source of truth for "is `shrk <verb>` a real
+ * command" checks — e.g. the contradictions doc-vs-CLI scan, which lives in the
+ * inspector layer and so receives this set by injection rather than importing
+ * the CLI.
+ */
+export declare function cliCommandNameSet(): Set<string>;
 //# sourceMappingURL=command-catalog.d.ts.map

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

@@ -115,6 +115,16 @@ export const COMMAND_CATALOG = Object.freeze([
         intendedAudience: [CommandAudience.Human, CommandAudience.Agent, CommandAudience.Ci],
         taskRole: CommandTaskRole.Diagnose,
     }),
+    entry({
+        command: 'ai-status',
+        description: 'Report which AI provider shrk would use right now, with setup or upgrade hints. `--ping` verifies the provider actually responds.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: false,
+        surface: CommandSurface.Common,
+        intendedAudience: [CommandAudience.Human, CommandAudience.Agent],
+        taskRole: CommandTaskRole.Diagnose,
+    }),
     entry({
         command: 'context',
         description: 'Focused context for a task (rules / paths / templates). For "what should I do?" prefer `shrk recommend "<task>"`.',
@@ -256,13 +266,94 @@ export const COMMAND_CATALOG = Object.freeze([
     }),
     entry({
         command: 'graph',
-        description: 'Knowledge graph — nodes, edges, and shortest-path explanations.',
+        description: 'Knowledge graph plus code-intelligence subverbs (`index`, `status`, `search`, `context`, `impact`, `callers`, `cycles`, `unresolved`, `deps`, `why`, `export`).',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'rule-graph',
+        description: 'Bridge the code graph to asset registries (boundary rules, path conventions, templates). Sub-verbs: index, status, for <file>.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'search-structural',
+        description: 'Declarative AST pattern search over the project. Read-only; no rewrites in this round.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'plan-context',
+        description: 'Produce a deterministic, token-budgeted context pack (`sharkcraft.context-pack/v1`) for an AI coding agent.',
         category: 'core',
         safetyLevel: SafetyLevel.ReadOnly,
         mcpAvailable: true,
         surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'arch',
+        description: 'Architecture-guard checks (public-API misuse, barrel risks, cycle severity, project contracts).',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'framework',
+        description: 'Framework-aware extractors: NestJS controllers/modules/providers/routes, React components/hook usages. Sub-verbs: index, status, list, routes.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
         taskRole: CommandTaskRole.Inspect,
     }),
+    entry({
+        command: 'api-diff',
+        description: 'Compare the current public API surface to a baseline. Reports added / removed / kind-changed / moved symbols with breaking-change severity.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'gate',
+        description: 'Aggregator quality-gate: graph freshness + architecture + impact-since-ref → one pass/fail. The pre-merge gate for AI-agent-authored changes.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'migrate',
+        description: 'Run a multi-step migration: structural rewrites + shell + checks orchestrated as one replayable plan.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSource,
+        mcpAvailable: false,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Generate,
+    }),
+    entry({
+        command: 'code-intel',
+        description: 'One-shot view of code-intelligence doctor checks (graph, rule-graph, api-surface, quality-gate, migrations, architecture, impact, framework, structural-search, context-planner). Read-only.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Diagnose,
+    }),
     entry({
         command: 'check',
         description: 'Run validation checks across registries / packs / boundaries.',
@@ -291,6 +382,15 @@ export const COMMAND_CATALOG = Object.freeze([
         surface: CommandSurface.Common,
         taskRole: CommandTaskRole.Validate,
     }),
+    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.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        taskRole: CommandTaskRole.Validate,
+    }),
     entry({
         command: 'review',
         description: 'PR-review packet — changed files, affected rules, missing tests heuristic.',
@@ -338,6 +438,18 @@ export const COMMAND_CATALOG = Object.freeze([
         surface: CommandSurface.Common,
         taskRole: CommandTaskRole.Apply,
     }),
+    entry({
+        command: 'delegate',
+        description: 'Hand a mechanical edit to a local-LLM worker; the engine verifies the result and auto-reverts on failure (run|brief). Writes source only via --apply through the signed-plan + verify gate.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSource,
+        writesFiles: true,
+        writesSource: true,
+        requiresReview: true,
+        surface: CommandSurface.Advanced,
+        intendedAudience: [CommandAudience.Human, CommandAudience.Agent],
+        taskRole: CommandTaskRole.Apply,
+    }),
     // `shrk spec` intent artifact over plan/review/apply.
     entry({
         command: 'spec',
@@ -634,6 +746,11 @@ export const COMMAND_CATALOG = Object.freeze([
         category: 'task-context',
         safetyLevel: SafetyLevel.ReadOnly,
         mcpAvailable: true,
+        // Overlaps with `shrk task` (machine packet) and `shrk recommend`
+        // (human routing). Pointing at `task` as canonical so users who
+        // hit this via tab-complete see the canonical machine-pipe form.
+        overlapsWith: ['task', 'recommend'],
+        preferredCommand: 'shrk task "<task>"',
     }),
     entry({
         command: 'validate-change',
@@ -943,6 +1060,13 @@ export const COMMAND_CATALOG = Object.freeze([
         safetyLevel: SafetyLevel.ReadOnly,
         surface: CommandSurface.Common,
     }),
+    entry({
+        command: 'completion',
+        description: 'Print a sourcable shell-completion script for the `shrk` CLI (bash | zsh | fish). Pipe into your shell rc.',
+        category: 'meta',
+        safetyLevel: SafetyLevel.ReadOnly,
+        surface: CommandSurface.Common,
+    }),
     entry({
         command: 'explain',
         description: 'Universal explainer: knowledge entry, rule, template, command id, or stderr blob.',
@@ -1007,7 +1131,7 @@ export const COMMAND_CATALOG = Object.freeze([
     // `commands doctor` is honest.
     entry({
         command: 'profiles',
-        description: 'List / inspect pack-contributed profiles (plugin-lifecycle, migration, conventions, …). Subcommands: list, get, doctor, search.',
+        description: 'List / inspect pack-contributed profiles (migration, conventions, …). Subcommands: list, get, doctor, search.',
         category: 'core',
         safetyLevel: SafetyLevel.ReadOnly,
         mcpAvailable: true,
@@ -1080,6 +1204,104 @@ export const COMMAND_CATALOG = Object.freeze([
         category: 'core',
         safetyLevel: SafetyLevel.ReadOnly,
     }),
+    entry({
+        command: 'smart-context',
+        description: 'Build deterministic context and ask an AI provider to synthesise an enriched brief (default), structured plan (--plan), or two-stage development plan (--ai-plan). Opt-in; defaults to Gemini. CLAUDE.md is auto-included in the seed.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'smart-context plan-ahead',
+        description: 'Batch-generate AI-backed plans for a queue of upcoming tasks and save each under .sharkcraft/smart-context/.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'smart-context list',
+        description: 'List saved smart-context entries under .sharkcraft/smart-context/.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'smart-context show',
+        description: 'Print a saved smart-context entry by slug.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'smart-context embeddings-build',
+        description: 'Build or incrementally refresh the semantic file index used by smart-context. Downloads the embedding model on first run.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'smart-context embeddings-status',
+        description: 'Report semantic index freshness without loading the embedding model.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'spike',
+        description: 'Scaffold starter files for a saved smart-context plan\'s recommended MVP. Reads .sharkcraft/smart-context/<slug>.plan.json.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSource,
+        taskRole: CommandTaskRole.Generate,
+    }),
+    entry({
+        command: 'deps-audit',
+        description: 'Compare declared package dependencies (package.json) with actually imported specifiers (graph). Reports missing + unused deps. Read-only.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'scaffold-validate',
+        description: 'Validate that the files in a saved generation plan exist on disk and look intact (size envelope + type match). Read-only.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'move-plan',
+        description: 'Plan a file move: graph-traced importer rewrites, export touch-ups, cross-package warnings, rollback steps. Read-only.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Generate,
+    }),
+    entry({
+        command: 'watch',
+        description: 'Emit a focused-context packet on stdout JSONL each time the workspace changes. Designed to feed a parallel Claude agent.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'watch list',
+        description: 'List active shrk-watch daemons (one per task slug).',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'watch stop',
+        description: 'Stop a running shrk-watch daemon by slug.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Config,
+    }),
+    entry({
+        command: 'watch prune',
+        description: 'Remove stale shrk-watch manifests whose owning processes are no longer alive.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Config,
+    }),
     entry({
         command: 'safety audit',
         description: 'Audit the SharkCraft safety model (commands, MCP, packs, plan signing).',
@@ -1285,6 +1507,48 @@ export const COMMAND_CATALOG = Object.freeze([
         intendedAudience: [CommandAudience.Human, CommandAudience.Ci],
         taskRole: CommandTaskRole.Inspect,
     }),
+    entry({
+        command: 'compress',
+        description: 'Deterministically compress a blob (file or stdin) to cut tokens — JSON→table, logs/search/diffs→signal. Reversible via `shrk expand`.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        writesFiles: true,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        intendedAudience: [CommandAudience.Agent, CommandAudience.Human],
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'expand',
+        description: 'Retrieve the full original a `shrk compress` run cached, by its `<<ccr:KEY>>` key.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Common,
+        intendedAudience: [CommandAudience.Agent, CommandAudience.Human],
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'align',
+        description: 'Replace volatile tokens (UUIDs/JWTs/timestamps/hashes) with stable placeholders for KV-cache prefix stability; reversible via `shrk unalign`.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        writesFiles: true,
+        mcpAvailable: true,
+        surface: CommandSurface.Advanced,
+        intendedAudience: [CommandAudience.Agent, CommandAudience.Human],
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'unalign',
+        description: 'Restore the original volatile tokens in aligned text using its `--map`.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: true,
+        surface: CommandSurface.Advanced,
+        intendedAudience: [CommandAudience.Agent, CommandAudience.Human],
+        taskRole: CommandTaskRole.Context,
+    }),
     // ── Backend feature expansion ─────────────────────────────────────────
     entry({
         command: 'bundle create',
@@ -2316,7 +2580,7 @@ export const COMMAND_CATALOG = Object.freeze([
     }),
     entry({
         command: 'release smoke --matrix',
-        description: 'Run smoke scenarios across multiple repo targets (sharkcraft/dogfood/synthetic/adopter).',
+        description: 'Run smoke scenarios across multiple repo targets (sharkcraft/dogfood/synthetic/consumer).',
         category: 'release',
         safetyLevel: SafetyLevel.WritesDraftsOnly,
         writesFiles: true,
@@ -2708,34 +2972,6 @@ export const COMMAND_CATALOG = Object.freeze([
         safetyLevel: SafetyLevel.ReadOnly,
         mcpAvailable: true,
     }),
-    entry({
-        command: 'plugin rename',
-        description: 'Plan-only plugin rename (profile-driven) — emits replace ops + manual folder rename checklist.',
-        category: 'lifecycle',
-        safetyLevel: SafetyLevel.WritesDraftsOnly,
-        mcpAvailable: true,
-    }),
-    entry({
-        command: 'plugin remove',
-        description: 'Plan-only destructive plugin remove (profile-driven) — destructive; requires human approval.',
-        category: 'lifecycle',
-        safetyLevel: SafetyLevel.WritesDraftsOnly,
-        mcpAvailable: true,
-    }),
-    entry({
-        command: 'plugin lifecycle list',
-        description: 'List plugins detected under the active profile roots and key-table. Read-only.',
-        category: 'lifecycle',
-        safetyLevel: SafetyLevel.ReadOnly,
-        mcpAvailable: false,
-    }),
-    entry({
-        command: 'plugin lifecycle inspect',
-        description: 'Inspect references to a plugin across the profile layers + key-table. Read-only.',
-        category: 'lifecycle',
-        safetyLevel: SafetyLevel.ReadOnly,
-        mcpAvailable: false,
-    }),
     entry({
         command: 'helper list',
         description: 'List available helper plan generators. Read-only.',
@@ -3137,12 +3373,102 @@ export function commandLifecycle(e) {
         return CommandLifecycle.Deprecated;
     return CommandLifecycle.Active;
 }
+/**
+ * The "Primary verbs" allowlist — top-level commands that pay rent in
+ * the default help surface. Everything else stays callable but is
+ * hidden from `--full-help` and from MCP tool advertising; users find
+ * them via `shrk surface list`, `shrk help <cmd>`, or `--full-help`.
+ *
+ * Picked to cover the canonical agent-flow journeys:
+ *   - bootstrap a repo, verify it
+ *   - get a brief / context / task packet for an agent
+ *   - generate safely (plan → apply → check)
+ *   - browse what shrk knows (rules / paths / templates / presets)
+ *   - inline the rules into the agent's prompt (export, mcp, dashboard)
+ *   - daily operations (review, impact, search, explain, why, surface)
+ *
+ * Anything not in this set falls back to the legacy
+ * surface-tier-based visibility, with deprecated / retired / aliased
+ * commands hidden regardless. Adding a verb here is the explicit
+ * "this is rent-paying" decision.
+ */
+const PRIMARY_VERBS_ALLOWLIST = new Set([
+    // Bootstrap
+    'init',
+    'doctor',
+    'inspect',
+    'onboard',
+    'version',
+    'help',
+    'preflight',
+    'self-config',
+    // Per-task
+    'brief',
+    'recommend',
+    'context',
+    'task',
+    'coverage',
+    'explain',
+    'why',
+    'search',
+    'impact',
+    'graph',
+    'code-intel',
+    'compress',
+    'expand',
+    // Generate code safely
+    'gen',
+    'apply',
+    'check',
+    'quality',
+    'plan',
+    'fix',
+    // Browse / inline
+    'knowledge',
+    'rules',
+    'templates',
+    'paths',
+    'import',
+    'export',
+    // Architecture & quality gates
+    'drift',
+    'safety',
+    // Run for an agent
+    'mcp',
+    'dashboard',
+    // Ops
+    'surface',
+    'presets',
+    'review',
+    'packs',
+    'ci',
+    'commands',
+]);
+function topLevelVerb(command) {
+    // Strip leading `--cwd <dir>` / `--<flag>` tokens and angle-bracket
+    // placeholders; the canonical first verb is whatever leads.
+    const tokens = command.split(/\s+/);
+    for (const t of tokens) {
+        if (!t)
+            continue;
+        if (t.startsWith('--') || t.startsWith('-'))
+            continue;
+        if (t.startsWith('<') || t.startsWith('"'))
+            continue;
+        return t;
+    }
+    return command;
+}
 /**
  * Default-help visibility rule. Honors an explicit
  * {@link ICommandCatalogEntry.showInDefaultHelp} when set; otherwise
- * primary + common are visible and advanced / machine / internal / legacy
- * are hidden. Deprecated and retired commands are always hidden by
- * default regardless of surface.
+ * the {@link PRIMARY_VERBS_ALLOWLIST} gates membership in the visible
+ * surface (primary + common entries whose top-level verb pays rent
+ * make the cut; everything else is hidden from `--full-help`).
+ *
+ * Deprecated, retired, aliased commands and anything in the
+ * {@link R46_OVERLAY} are always hidden regardless of allowlist
+ * membership.
  */
 export function defaultShowInHelp(e) {
     if (e.showInDefaultHelp !== undefined)
@@ -3155,6 +3481,12 @@ export function defaultShowInHelp(e) {
         return false;
     if (lc === CommandLifecycle.Alias)
         return false;
+    // Allowlist gate — the top-level verb must be one of the ~30
+    // rent-paying verbs. Subcommands of an allowlisted verb inherit
+    // visibility (so `check boundaries` shows under `check`).
+    const verb = topLevelVerb(e.command);
+    if (!PRIMARY_VERBS_ALLOWLIST.has(verb))
+        return false;
     const surface = commandSurface(e);
     return surface === CommandSurface.Primary || surface === CommandSurface.Common;
 }
@@ -3240,3 +3572,24 @@ export function renderCommandSafetyMatrixMarkdown(rows) {
     }
     return lines.join('\n') + '\n';
 }
+/**
+ * The set of TOP-LEVEL command verbs in the catalogue (the first token of each
+ * entry's `command`). The single source of truth for "is `shrk <verb>` a real
+ * command" checks — e.g. the contradictions doc-vs-CLI scan, which lives in the
+ * inspector layer and so receives this set by injection rather than importing
+ * the CLI.
+ */
+export function cliCommandNameSet() {
+    const out = new Set();
+    for (const entry of COMMAND_CATALOG) {
+        const top = entry.command.split(/\s+/)[0];
+        if (top)
+            out.add(top);
+        for (const alias of entry.aliases) {
+            const aliasTop = alias.split(/\s+/)[0];
+            if (aliasTop)
+                out.add(aliasTop);
+        }
+    }
+    return out;
+}

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

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

package/dist/commands/commands.command.js

@@ -1,7 +1,7 @@
-import { flagBool, flagString, } from "../command-registry.js";
+import { flagBool, flagString } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
-import { COMMAND_CATALOG, CommandLifecycle, CommandSurface, R46_OVERLAY, SafetyLevel, buildCommandSafetyMatrix, commandLifecycle, commandSurface, commandTaskRole, defaultShowInHelp, renderCommandSafetyMatrixMarkdown, } from "./command-catalog.js";
-import { buildCommandTaxonomy, buildPrimaryCommandsReport, renderCommandTaxonomyMarkdown, renderCommandTaxonomyText, renderPrimaryCommandsText, } from '@shrkcrft/inspector';
+import { buildCommandSafetyMatrix, COMMAND_CATALOG, CommandLifecycle, commandLifecycle, CommandSurface, commandSurface, commandTaskRole, defaultShowInHelp, R46_OVERLAY, renderCommandSafetyMatrixMarkdown, SafetyLevel } from "./command-catalog.js";
+import { buildCommandTaxonomy, buildPrimaryCommandsReport, renderCommandTaxonomyMarkdown, renderCommandTaxonomyText, renderPrimaryCommandsText } from '@shrkcrft/inspector';
 export function makeCommandsCommand(registry) {
     return {
         name: 'commands',
@@ -589,7 +589,7 @@ export function buildCommandsUxReport() {
     // issue is clearly structural (none of these currently rise to error).
     for (const e of COMMAND_CATALOG) {
         const surface = commandSurface(e);
-        // (a) primary commands should declare an audience (so adopters can see
+        // (a) primary commands should declare an audience (so consumers can see
         // who the command is for at a glance).
         if (surface === CommandSurface.Primary && (!e.intendedAudience || e.intendedAudience.length === 0)) {
             issues.push({