@shrkcrft/cli 0.1.0-alpha.1 → 0.1.0-alpha.11

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

@@ -263,6 +263,87 @@ export const COMMAND_CATALOG = Object.freeze([
         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 +372,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.',
@@ -634,6 +724,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 +1038,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 +1109,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,
@@ -1108,13 +1210,7 @@ export const COMMAND_CATALOG = Object.freeze([
     }),
     entry({
         command: 'mcp serve',
-        description: 'Start the read-only MCP server (stdio or --http).',
-        category: 'meta',
-        safetyLevel: SafetyLevel.ReadOnly,
-    }),
-    entry({
-        command: 'mcp install',
-        description: 'Print the MCP config snippet + path for Claude Code / Claude Desktop / Cursor / Cline (copy-paste, no file writes).',
+        description: 'Start the read-only MCP server (stdio).',
         category: 'meta',
         safetyLevel: SafetyLevel.ReadOnly,
     }),
@@ -2266,13 +2362,6 @@ export const COMMAND_CATALOG = Object.freeze([
         safetyLevel: SafetyLevel.ReadOnly,
         mcpAvailable: true,
     }),
-    entry({
-        command: 'packs compat --fast',
-        description: 'Pack compat scan with regex-only export walker (legacy). Default is TS-AST based.',
-        category: 'packs',
-        safetyLevel: SafetyLevel.ReadOnly,
-        mcpAvailable: false,
-    }),
     entry({
         command: 'onboard adopt status --max-age-days',
         description: 'Adoption checkpoint status with custom max-age (default 30 days).',
@@ -2329,7 +2418,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,
@@ -2721,34 +2810,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.',
@@ -3150,12 +3211,99 @@ 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',
+    // 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)
@@ -3168,6 +3316,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;
 }

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({

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

@@ -0,0 +1,10 @@
+import { type ICommandHandler } from '../command-registry.js';
+/**
+ * `shrk completion <bash|zsh|fish>` — print a sourcable completion
+ * script. The list of verbs is generated from the registered
+ * `COMMAND_CATALOG` so completion can't drift from the runtime
+ * surface. Subverbs for the high-traffic groups (graph, arch,
+ * impact, gate, context, search-structural) are hand-curated.
+ */
+export declare const completionCommand: ICommandHandler;
+//# sourceMappingURL=completion.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.command.d.ts","sourceRoot":"","sources":["../../src/commands/completion.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAqC/B,CAAC"}

package/dist/commands/completion.command.js

@@ -0,0 +1,121 @@
+import { flagBool, flagString, } from "../command-registry.js";
+import { asJson } from "../output/format-output.js";
+import { COMMAND_CATALOG } from "./command-catalog.js";
+/**
+ * `shrk completion <bash|zsh|fish>` — print a sourcable completion
+ * script. The list of verbs is generated from the registered
+ * `COMMAND_CATALOG` so completion can't drift from the runtime
+ * surface. Subverbs for the high-traffic groups (graph, arch,
+ * impact, gate, context, search-structural) are hand-curated.
+ */
+export const completionCommand = {
+    name: 'completion',
+    description: 'Print a sourcable shell-completion script for the `shrk` CLI. Pipe into your shell rc: `shrk completion bash >> ~/.bashrc`.',
+    usage: 'shrk completion <bash|zsh|fish> [--json]',
+    async run(args) {
+        const shell = (args.positional[0] ?? flagString(args, 'shell') ?? 'bash').toLowerCase();
+        const wantJson = flagBool(args, 'json');
+        const verbs = collectTopLevelVerbs();
+        if (wantJson) {
+            process.stdout.write(asJson({
+                schema: 'sharkcraft.cli-completion/v1',
+                shell,
+                verbs,
+                subverbs: SUBVERBS,
+            }) + '\n');
+            return 0;
+        }
+        switch (shell) {
+            case 'bash':
+                process.stdout.write(renderBash(verbs));
+                return 0;
+            case 'zsh':
+                process.stdout.write(renderZsh(verbs));
+                return 0;
+            case 'fish':
+                process.stdout.write(renderFish(verbs));
+                return 0;
+            default:
+                process.stderr.write(`Unknown shell "${shell}". Use bash | zsh | fish.\n`);
+                return 2;
+        }
+    },
+};
+/**
+ * Subverbs the high-traffic verbs accept. Hand-curated because the
+ * runtime catalog represents them as a single CLI surface; we don't
+ * want to parse the dispatch chain at completion time.
+ */
+const SUBVERBS = Object.freeze({
+    graph: ['index', 'status', 'search', 'context', 'impact', 'callers', 'cycles', 'unresolved', 'deps', 'why', 'export'],
+    arch: ['check', 'baseline'],
+    impact: ['tests', 'graph', 'baseline'],
+    gate: ['scaffold-ci', 'scaffold-hook'],
+    context: ['build', 'refresh', 'status', 'benchmark'],
+    'search-structural': ['registry'],
+    doctor: ['suppress', 'suppressions', 'acknowledge', 'acknowledgements', 'watch'],
+});
+function collectTopLevelVerbs() {
+    const set = new Set();
+    for (const e of COMMAND_CATALOG) {
+        // `command` may carry an argument hint like 'fix preview' — keep
+        // only the first token so completion works at the top level.
+        const head = e.command.split(/\s+/)[0];
+        if (head.length > 0)
+            set.add(head);
+    }
+    return [...set].sort();
+}
+function renderBash(verbs) {
+    const verbList = verbs.join(' ');
+    const subverbCases = Object.entries(SUBVERBS)
+        .map(([verb, subs]) => `      ${verb}) COMPREPLY=($(compgen -W "${subs.join(' ')}" -- "$cur")); return 0;;`)
+        .join('\n');
+    return `# shrk bash completion. Source from ~/.bashrc:
+#   eval "$(shrk completion bash)"
+_shrk_complete() {
+  local cur prev words cword
+  _init_completion || return
+  if [ "$cword" -eq 1 ]; then
+    COMPREPLY=($(compgen -W "${verbList}" -- "$cur"))
+    return 0
+  fi
+  case "\${words[1]}" in
+${subverbCases}
+  esac
+  COMPREPLY=()
+}
+complete -F _shrk_complete shrk
+`;
+}
+function renderZsh(verbs) {
+    const verbList = verbs.join(' ');
+    const subverbCases = Object.entries(SUBVERBS)
+        .map(([verb, subs]) => `    ${verb}) compadd -- ${subs.join(' ')};;`)
+        .join('\n');
+    return `# shrk zsh completion. Source from ~/.zshrc:
+#   eval "$(shrk completion zsh)"
+_shrk() {
+  if [[ \${#words} -eq 2 ]]; then
+    compadd -- ${verbList}
+    return
+  fi
+  case "\${words[2]}" in
+${subverbCases}
+  esac
+}
+compdef _shrk shrk
+`;
+}
+function renderFish(verbs) {
+    const lines = [
+        '# shrk fish completion. Source from ~/.config/fish/completions/shrk.fish:',
+        '#   shrk completion fish > ~/.config/fish/completions/shrk.fish',
+        'complete -e -c shrk',
+        `complete -c shrk -n '__fish_use_subcommand' -a '${verbs.join(' ')}'`,
+    ];
+    for (const [verb, subs] of Object.entries(SUBVERBS)) {
+        lines.push(`complete -c shrk -n '__fish_seen_subcommand_from ${verb}' -a '${subs.join(' ')}'`);
+    }
+    return lines.join('\n') + '\n';
+}

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

@@ -1 +1 @@
-{"version":3,"file":"constructs.command.d.ts","sourceRoot":"","sources":["../../src/commands/constructs.command.ts"],"names":[],"mappings":"AA6BA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAahC,eAAO,MAAM,qBAAqB,EAAE,eAqBnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAoDlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA8DpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAmFrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmCtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAwBpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAiClC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAiBrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAiBrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA4BrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA8BrC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA0DpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA0LpC,CAAC"}
+{"version":3,"file":"constructs.command.d.ts","sourceRoot":"","sources":["../../src/commands/constructs.command.ts"],"names":[],"mappings":"AA6BA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAahC,eAAO,MAAM,qBAAqB,EAAE,eAqBnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAoDlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA8DpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAoErC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmCtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAwBpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAiClC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAiBrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAiBrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA4BrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA8BrC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA0DpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA0LpC,CAAC"}

package/dist/commands/constructs.command.js

@@ -91,7 +91,7 @@ export const constructsGetCommand = {
 };
 export const constructsTraceCommand = {
     name: 'trace',
-    description: 'Trace all files / publicApi / events / tokens belonging to a construct. --deep adds related/sandbox/test pointers when present.',
+    description: 'Trace all files / publicApi / events / tokens belonging to a construct. --deep adds related / test pointers when present.',
     usage: 'shrk constructs trace <id> [--deep] [--json]',
     async run(args) {
         const id = args.positional[0];
@@ -118,7 +118,7 @@ export const constructsTraceCommand = {
             ? {
                 related: relatedAll,
                 tags: c.tags ?? [],
-                registryHints: c.tags?.filter((t) => /(registry|composer|defaults|sandbox|demo|barrel)/i.test(t)) ?? [],
+                registryHints: c.tags?.filter((t) => /(registry|barrel)/i.test(t)) ?? [],
             }
             : undefined;
         if (flagBool(args, 'json')) {
@@ -175,28 +175,11 @@ export const constructsImpactCommand = {
         }
         const trace = traceConstruct(c);
         /**
-         * Registry touch-points are inferred from the active plugin
-         * lifecycle profile (key-table + barrels). The engine no longer
-         * hardcodes project-specific paths.
+         * Registry touch-points are not inferred — pack-contributed
+         * touch-point hints can be added in the future via the convention
+         * registry.
          */
         const registryTouchPoints = [];
-        try {
-            const { listPluginLifecycleProfiles } = await import('@shrkcrft/inspector');
-            const profiles = await listPluginLifecycleProfiles(inspection);
-            for (const entry of profiles) {
-                const p = entry.profile;
-                if (c.tags?.some((t) => /plugin-key|key-table/i.test(t)) && p.keyTable) {
-                    registryTouchPoints.push(p.keyTable.path);
-                }
-                if (c.tags?.some((t) => /barrel|public-api/i.test(t)) && p.barrels) {
-                    for (const b of p.barrels)
-                        registryTouchPoints.push(b.path);
-                }
-            }
-        }
-        catch {
-            // Best-effort enrichment; absence of profiles just means no touch-points.
-        }
         const verificationCommands = [
             'shrk check boundaries --changed-only',
             'shrk doctor',

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

@@ -1 +1 @@
-{"version":3,"file":"context.command.d.ts","sourceRoot":"","sources":["../../src/commands/context.command.ts"],"names":[],"mappings":"AASA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,cAAc,EAAE,eA6H5B,CAAC"}
+{"version":3,"file":"context.command.d.ts","sourceRoot":"","sources":["../../src/commands/context.command.ts"],"names":[],"mappings":"AAiBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,cAAc,EAAE,eAiI5B,CAAC"}