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

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

@@ -1 +1 @@
-{"version":3,"file":"graph.command.d.ts","sourceRoot":"","sources":["../../src/commands/graph.command.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAehC,eAAO,MAAM,YAAY,EAAE,eA6L1B,CAAC"}
+{"version":3,"file":"graph.command.d.ts","sourceRoot":"","sources":["../../src/commands/graph.command.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA4BhC,eAAO,MAAM,YAAY,EAAE,eA+M1B,CAAC"}

package/dist/commands/graph.command.js

@@ -3,6 +3,7 @@ import * as nodePath from 'node:path';
 import { analyzeImportGraph, buildKnowledgeGraph, findGraphPath, getGraphNode, inspectSharkcraft, } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
+import { runGraphCallers, runGraphContext, runGraphCycles, runGraphDeps, runGraphHubs, runGraphImpact, runGraphIndex, runGraphPath, runGraphSearch, runGraphStatus, runGraphUnresolved, } from "./graph-code-subverbs.js";
 const KNOWN_KINDS = [
     'knowledge',
     'rule',
@@ -16,9 +17,37 @@ const KNOWN_KINDS = [
 ];
 export const graphCommand = {
     name: 'graph',
-    description: 'Show the SharkCraft knowledge graph: nodes (knowledge/rules/paths/templates/pipelines/presets/packs/boundaries) and edges (related-template, preset-references, pipeline-step-references, …). Supports text|json|dot|mermaid output and an `export` subcommand for writing to file.',
-    usage: 'shrk [--cwd <dir>] graph [<id>] [--type <kind>] [--format text|json|dot|mermaid] [--output <file>] [--json] | shrk graph export --format dot|mermaid --output <file>',
+    description: 'Show the SharkCraft knowledge graph and the code-intelligence graph surface. Use `shrk graph <id>` for asset-graph nodes and `shrk graph index|status|search|context|impact|path|hubs|callers|cycles|unresolved|deps|why|export` for code-graph workflows.',
+    usage: 'shrk [--cwd <dir>] graph [<id>] [--type <kind>] [--format text|json|dot|mermaid] [--output <file>] [--json]\n' +
+        'shrk graph index|status|search|context|impact|path|hubs|callers|cycles|unresolved|deps|why|export ...\n' +
+        'shrk graph path <from> <to>   — is code A wired to code B? (shortest import/call path)\n' +
+        'shrk graph hubs [--limit N] [--path <dir>]   — most-depended-on symbols/files (load-bearing code; scope to a subsystem)',
     async run(args) {
+        // Code-intelligence subverbs (R65) don't need the knowledge graph —
+        // dispatch them before the expensive inspection so they stay fast.
+        const earlySub = args.positional[0];
+        if (earlySub === 'index')
+            return runGraphIndex(args);
+        if (earlySub === 'status')
+            return runGraphStatus(args);
+        if (earlySub === 'search')
+            return runGraphSearch(args);
+        if (earlySub === 'context')
+            return runGraphContext(args);
+        if (earlySub === 'impact')
+            return runGraphImpact(args);
+        if (earlySub === 'path')
+            return runGraphPath(args);
+        if (earlySub === 'hubs')
+            return runGraphHubs(args);
+        if (earlySub === 'callers')
+            return runGraphCallers(args);
+        if (earlySub === 'cycles')
+            return runGraphCycles(args);
+        if (earlySub === 'unresolved')
+            return runGraphUnresolved(args);
+        if (earlySub === 'deps')
+            return runGraphDeps({ ...args, positional: args.positional.slice(1) });
         const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
         const graph = buildKnowledgeGraph(inspection);
         const sub = args.positional[0];

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

@@ -1,8 +1,9 @@
 import type { CommandRegistry } from '../command-registry.js';
 /**
- * Short product start screen for bare `shrk` / `shrk --help`. Pruned
- * to the core tier set; extended verbs live one link away via
- * `shrk surface list`.
+ * Product start screen for bare `shrk` / `shrk --help`. Shows the
+ * curated ~20-command "starter" surface organized by workflow phase.
+ * Everything else stays callable; users see the full ~70-verb catalog
+ * via `shrk --full-help` or browse it through `shrk surface list`.
  *
  * Returns the lines (without trailing newline). Pulled into a function
  * so tests can assert on the structure without grepping stdout.

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

@@ -1 +1 @@
-{"version":3,"file":"help.command.d.ts","sourceRoot":"","sources":["../../src/commands/help.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAuB1C;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe;;;;cAK3C;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;KAAE,GAAG,MAAM;EA2FpF"}
+{"version":3,"file":"help.command.d.ts","sourceRoot":"","sources":["../../src/commands/help.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAqB9D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAwC1C;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe;;;;cAK3C;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;KAAE,GAAG,MAAM;EA2HpF"}

package/dist/commands/help.command.js

@@ -1,8 +1,26 @@
 import { header } from "../output/format-output.js";
+import { COMMAND_CATALOG, defaultShowInHelp } from "./command-catalog.js";
+const EXTRA_HELP_LINES = Object.freeze({
+    graph: [
+        '',
+        'Code-intelligence subverbs:',
+        '  graph index      — build or refresh the code graph',
+        '  graph status     — freshness, counts, and unresolved-import summary',
+        '  graph search     — find files/symbols/packages in the code graph',
+        '  graph context    — inspect one file or symbol with bridge enrichment',
+        '  graph impact     — reverse dependent closure for a file or symbol',
+        '  graph callers    — files that call/reference a symbol',
+        '  graph cycles     — list import cycles',
+        '  graph unresolved — list unresolved imports grouped by file',
+        '  graph deps       — inbound/outbound package dependencies',
+        '  graph why        — shortest-path explanation in the knowledge graph',
+    ],
+});
 /**
- * Short product start screen for bare `shrk` / `shrk --help`. Pruned
- * to the core tier set; extended verbs live one link away via
- * `shrk surface list`.
+ * Product start screen for bare `shrk` / `shrk --help`. Shows the
+ * curated ~20-command "starter" surface organized by workflow phase.
+ * Everything else stays callable; users see the full ~70-verb catalog
+ * via `shrk --full-help` or browse it through `shrk surface list`.
  *
  * Returns the lines (without trailing newline). Pulled into a function
  * so tests can assert on the structure without grepping stdout.
@@ -12,20 +30,37 @@ export function renderStartScreen() {
     lines.push('SharkCraft CLI — deterministic, local-first project intelligence for AI coding agents.');
     lines.push('Usage: shrk [--cwd <dir>] <command> [...args]');
     lines.push('');
-    lines.push('Core (always on):');
-    lines.push('  $ shrk recommend "<task>"        — what should I do?');
+    lines.push('Bootstrap:');
+    lines.push('  $ shrk init --infer --write      — scan the repo + populate sharkcraft/ from real signals (new repos)');
     lines.push('  $ shrk doctor                    — is the workspace healthy?');
-    lines.push('  $ shrk context --task "<task>"   — focused context for a task');
-    lines.push('  $ shrk init                      — create sharkcraft/ + config skeleton');
-    lines.push('  $ shrk check boundaries          — boundary enforcement');
-    lines.push('  $ shrk surface list              — every command grouped by tier');
+    lines.push('  $ shrk onboard                   — analyze an existing repo (advisory)');
+    lines.push('');
+    lines.push('Use it for a task:');
+    lines.push('  $ shrk recommend "<task>"        — what should I do?');
+    lines.push('  $ shrk context --task "<task>"   — token-budgeted relevant context');
+    lines.push('  $ shrk task "<task>"             — full AI-ready task packet (JSON)');
+    lines.push('  $ shrk why <file>                — which rules govern this file');
+    lines.push('  $ shrk impact <file>             — blast radius: what breaks if I change this');
+    lines.push('');
+    lines.push('Generate code safely:');
+    lines.push('  $ shrk gen <template> <name>     — generate from template (dry-run by default)');
+    lines.push('  $ shrk apply <plan.json>         — apply a reviewed plan (CLI is the only write path)');
+    lines.push('  $ shrk check boundaries          — enforce layer / import boundaries');
+    lines.push('  $ shrk quality                   — pre-PR gate (doctor + boundaries + coverage + drift)');
+    lines.push('');
+    lines.push('Browse what shrk knows:');
+    lines.push('  $ shrk graph status              — code-graph freshness and health');
+    lines.push('  $ shrk coverage                  — what knowledge is missing');
+    lines.push('  $ shrk knowledge list            — knowledge entries');
+    lines.push('');
+    lines.push('Run shrk for an agent:');
+    lines.push('  $ shrk mcp serve                 — start the MCP server (stdio) for live queries');
+    lines.push('  $ shrk dashboard                 — start the local read-only dashboard');
     lines.push('');
-    lines.push('Discover the rest (extended tier — always callable):');
-    lines.push('  $ shrk surface list              — full surface, grouped by tier and profile');
-    lines.push('  $ shrk surface profiles          — named profiles (small-app / monorepo / ci / agent / pack-author)');
-    lines.push('  $ shrk surface explain <cmd>     — why a command has its current tier');
+    lines.push('Discover the rest (everything stays callable — this screen shows ~17 of ~70 verbs):');
+    lines.push('  $ shrk surface list              — full catalog by tier');
     lines.push('  $ shrk help <command>            — usage for a specific command');
-    lines.push('  $ shrk --full-help               — the long, exhaustive help');
+    lines.push('  $ shrk --full-help               — long, exhaustive help');
     lines.push('  $ shrk --about                   — what shrk is and is not');
     lines.push('');
     lines.push('Free-form input is fine — `shrk "<task>"` routes to `shrk recommend`.');
@@ -48,10 +83,13 @@ export function makeHelpCommand(registry) {
                     ? args.positional[0].split(/\s+/).filter(Boolean)
                     : args.positional.filter(Boolean);
                 const { handler, matchedPath, node } = registry.resolve(tokens);
-                if (handler && matchedPath.join(' ') === tokens.join(' ')) {
+                if (handler && matchedPath.join(' ') === tokens.join(' ') && node.children.size === 0) {
                     // Exact match on a callable command.
                     const canonical = registry.listCommandAliases().get(tokens[0]);
                     process.stdout.write(`${matchedPath.join(' ')} — ${handler.description}\n${handler.usage}\n`);
+                    const extra = EXTRA_HELP_LINES[matchedPath.join(' ')];
+                    if (extra)
+                        process.stdout.write(extra.join('\n') + '\n');
                     if (canonical && tokens.length === 1) {
                         process.stdout.write(`(alias for: ${canonical})\n`);
                     }
@@ -89,13 +127,41 @@ export function makeHelpCommand(registry) {
                 process.stdout.write(renderStartScreen());
                 return 0;
             }
+            const wantsAll = args.flags.get('all') === true;
             process.stdout.write(`SharkCraft CLI — structured project intelligence for AI coding agents\n`);
             process.stdout.write(`Usage: shrk [--cwd <dir>] <command> [...args]\n`);
+            // The catalog has ~360 entries; only ~30 top-level verbs pay
+            // rent (see PRIMARY_VERBS_ALLOWLIST in command-catalog.ts).
+            // Default --full-help filters to that set; `--full-help --all`
+            // dumps the entire catalog for power users.
+            const visibleVerbs = new Set();
+            if (!wantsAll) {
+                for (const entry of COMMAND_CATALOG) {
+                    if (defaultShowInHelp(entry)) {
+                        const verb = entry.command.split(/\s+/)[0] ?? '';
+                        if (verb)
+                            visibleVerbs.add(verb);
+                    }
+                }
+            }
+            const visibleTopLevel = registry.list().filter((c) => {
+                if (wantsAll)
+                    return true;
+                return visibleVerbs.has(c.name);
+            });
             process.stdout.write(header('Top-level commands'));
-            for (const c of registry.list()) {
+            for (const c of visibleTopLevel) {
                 process.stdout.write(`  ${c.name.padEnd(10)} — ${c.description}\n`);
             }
-            // Show each canonical group once.
+            if (!wantsAll) {
+                const hiddenCount = registry.list().length - visibleTopLevel.length;
+                if (hiddenCount > 0) {
+                    process.stdout.write(`\n  …and ${hiddenCount} more, hidden from default help. Run \`shrk --full-help --all\` to see them, ` +
+                        `or \`shrk surface list\` to browse by tier.\n`);
+                }
+            }
+            // Show each canonical group once — also filtered by the allowlist
+            // unless --all was passed.
             const canonicalGroups = [];
             const aliasMap = registry.listGroupAliases();
             const seen = new Set();
@@ -103,7 +169,9 @@ export function makeHelpCommand(registry) {
                 const canonical = aliasMap.get(g) ?? g;
                 if (!seen.has(canonical)) {
                     seen.add(canonical);
-                    canonicalGroups.push(canonical);
+                    if (wantsAll || visibleVerbs.has(canonical)) {
+                        canonicalGroups.push(canonical);
+                    }
                 }
             }
             const aliasesByCanonical = new Map();

package/dist/commands/helper.command.js

@@ -85,7 +85,7 @@ export const helperPlanCommand = {
         // profile is available. Today the helper-registry detects this inside
         // buildHelperPlan via requireProfile(); we surface a friendly message.
         if ('requiresProfile' in def && def.requiresProfile) {
-            process.stderr.write(`Helper "${id}" requires a plugin-lifecycle profile. Available:\n  $ shrk plugin lifecycle profiles\n`);
+            process.stderr.write(`Helper "${id}" requires a registered profile. Available:\n  $ shrk profiles list\n`);
             // Still try to build the plan; the registry throws with the same idea.
         }
         const cwd = resolveCwd(args);

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

@@ -1 +1 @@
-{"version":3,"file":"impact.command.d.ts","sourceRoot":"","sources":["../../src/commands/impact.command.ts"],"names":[],"mappings":"AAsBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA0QhC,eAAO,MAAM,aAAa,EAAE,eAoV3B,CAAC"}
+{"version":3,"file":"impact.command.d.ts","sourceRoot":"","sources":["../../src/commands/impact.command.ts"],"names":[],"mappings":"AAsBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA0VhC,eAAO,MAAM,aAAa,EAAE,eA8V3B,CAAC"}

package/dist/commands/impact.command.js

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { analyzeImpact, analyzeTestImpact, findSymbolInProject, FuzzyImpactSourceKind, getChangedFiles, ImpactInputKind, inspectSharkcraft, QueryMatchKind, readFeatureBundle, renderImpactGraph, renderImpactHtml, renderImpactMarkdown, renderImpactText, resolveFuzzyImpact, warmConstructCache, } from '@shrkcrft/inspector';
 import { flagBool, flagNumber, flagString, flagList, resolveCwd, } from "../command-registry.js";
-import { asJson, header } from "../output/format-output.js";
+import { asJson, header, kv } from "../output/format-output.js";
 function collectFiles(args, cwd) {
     const diagnostics = [];
     const explicitFiles = flagList(args, 'files');
@@ -199,6 +199,85 @@ async function emitCodemodPlan(opts) {
     }
     return 0;
 }
+/**
+ * --via-graph adapter: takes the same input flags as `shrk impact` and
+ * routes through `@shrkcrft/impact-engine` for the v3 graph-backed
+ * payload. Defers to that engine; emits a clean error when the graph
+ * isn't indexed yet.
+ */
+async function runViaGraph(args) {
+    const cwd = resolveCwd(args);
+    const wantJson = flagBool(args, 'json') || flagString(args, 'format') === 'json';
+    const positional = args.positional[0];
+    const viaGraphRaw = args.flags.get('via-graph');
+    const files = flagList(args, 'files');
+    const since = flagString(args, 'since');
+    const symbol = flagString(args, 'symbol');
+    const fileFlag = flagString(args, 'file');
+    const limit = flagNumber(args, 'limit') ?? 200;
+    const maxDepth = flagNumber(args, 'max-depth') ?? 5;
+    const target = positional ?? fileFlag ?? (typeof viaGraphRaw === 'string' ? viaGraphRaw : undefined);
+    const inputs = files.length > 0
+        ? { kind: 'files', files }
+        : symbol
+            ? { kind: 'symbol', symbolId: symbol }
+            : since
+                ? { kind: 'gitref', ref: since }
+                : target
+                    ? { kind: 'files', files: [target] }
+                    : undefined;
+    if (!inputs) {
+        process.stderr.write('Usage: shrk impact --via-graph <fileOrQuery> | --symbol <name> | --files a,b | --since <ref>\n');
+        return 2;
+    }
+    const { analyzeGraphImpact, ImpactReportStore, snapshotImpactAnalysis } = await import('@shrkcrft/impact-engine');
+    const analysis = analyzeGraphImpact(inputs, { projectRoot: cwd, limit, maxDepth });
+    // Persist a compact snapshot for the doctor + dashboard to read.
+    // `--no-persist` opts out (useful when scripting against many trees
+    // or when stdout is the only sink the caller cares about).
+    const noPersist = flagBool(args, 'no-persist');
+    if (!noPersist) {
+        try {
+            const summary = inputs.kind === 'files'
+                ? inputs.files.slice(0, 3).join(', ') + (inputs.files.length > 3 ? '…' : '')
+                : inputs.kind === 'symbol'
+                    ? `symbol:${inputs.symbolId}`
+                    : `gitref:${inputs.ref}`;
+            new ImpactReportStore(cwd).write(snapshotImpactAnalysis(analysis, summary));
+        }
+        catch {
+            // best-effort — never fail the command on a persistence error
+        }
+    }
+    if (wantJson) {
+        process.stdout.write(asJson(analysis) + '\n');
+        return 0;
+    }
+    process.stdout.write(header(`Impact (graph): ${target ?? symbol ?? files.join(',') ?? since}`));
+    process.stdout.write(`  risk: ${analysis.risk}\n`);
+    process.stdout.write(`  direct dependents: ${analysis.directDependents.length}\n`);
+    process.stdout.write(`  transitive dependents: ${analysis.transitiveDependents.length}\n`);
+    process.stdout.write(`  affected symbols: ${analysis.affectedSymbols.length}\n`);
+    process.stdout.write(`  caller files: ${analysis.affectedCallerFiles.length}\n`);
+    process.stdout.write(`  affected packages: ${analysis.affectedPackages.length}\n`);
+    process.stdout.write(`  affected rules: ${analysis.affectedRules.length}\n`);
+    process.stdout.write(`  affected templates: ${analysis.affectedTemplates.length}\n`);
+    process.stdout.write(`  likely tests: ${analysis.likelyTests.length}\n`);
+    process.stdout.write(`  public API touched: ${analysis.publicApiTouched ? 'yes' : 'no'}\n`);
+    if (analysis.riskReasons.length > 0) {
+        process.stdout.write('\nRisk reasons:\n');
+        for (const r of analysis.riskReasons)
+            process.stdout.write(`  • ${r}\n`);
+    }
+    if (analysis.validationScope.length > 0) {
+        process.stdout.write('\nRun before merging:\n');
+        for (const c of analysis.validationScope)
+            process.stdout.write(`  $ ${c}\n`);
+    }
+    for (const d of analysis.diagnostics.slice(0, 5))
+        process.stdout.write(`! ${d}\n`);
+    return 0;
+}
 export const impactCommand = {
     name: 'impact',
     description: 'Architecture impact analysis: direct + transitive dependents, risk + suggested commands. Supports fuzzy <query> resolution. Read-only.',
@@ -210,6 +289,16 @@ export const impactCommand = {
         if (args.positional[0] === 'graph') {
             return runImpactGraph({ ...args, positional: args.positional.slice(1) });
         }
+        if (args.positional[0] === 'baseline') {
+            return runImpactBaseline({ ...args, positional: args.positional.slice(1) });
+        }
+        // --via-graph: route through @shrkcrft/impact-engine for the v3
+        // graph-backed payload (sharkcraft.graph-impact-analysis/v3). Keeps
+        // the legacy v2 inspector path as the default so existing
+        // consumers don't shift.
+        if (args.flags.has('via-graph')) {
+            return runViaGraph(args);
+        }
         const cwd = resolveCwd(args);
         const inspection = await inspectSharkcraft({ cwd });
         // Warm construct cache so fuzzy resolution can map plugin keys / events /
@@ -817,3 +906,84 @@ function renderResolutionMd(r) {
 }
 // Sentinel — keep `QueryMatchKind` import alive for tooling. Used inside fuzzy-impact.ts.
 void QueryMatchKind;
+async function runImpactBaseline(args) {
+    const cwd = resolveCwd(args);
+    const wantJson = flagBool(args, 'json');
+    const verb = args.positional[0] ?? 'show';
+    const { ImpactReportStore, diffImpactReports } = await import('@shrkcrft/impact-engine');
+    const store = new ImpactReportStore(cwd);
+    if (verb === 'write') {
+        const last = store.read();
+        if (!last) {
+            const msg = `No recent impact run at ${store.absPath}. Run \`shrk impact --via-graph <target>\` first.\n`;
+            if (wantJson) {
+                process.stdout.write(asJson({ ok: false, error: 'no-last-run' }) + '\n');
+                return 1;
+            }
+            process.stderr.write(msg);
+            return 1;
+        }
+        store.writeBaseline(last);
+        if (wantJson) {
+            process.stdout.write(asJson({ wrote: store.baselinePath, baseline: last }) + '\n');
+            return 0;
+        }
+        process.stdout.write(`Impact baseline written → ${store.baselinePath}\n`);
+        process.stdout.write(`  Input: ${last.inputSummary}\n` +
+            `  Risk:  ${last.risk}\n` +
+            `  Dependents: ${last.directDependentCount} direct, ${last.transitiveDependentCount} transitive\n` +
+            `  Packages:   ${last.affectedPackageCount}\n`);
+        return 0;
+    }
+    if (verb === 'show') {
+        const baseline = store.readBaseline();
+        if (!baseline) {
+            const msg = `No baseline at ${store.baselinePath}. Run \`shrk impact baseline write\` to freeze the current run.\n`;
+            if (wantJson) {
+                process.stdout.write(asJson({ baseline: null, path: store.baselinePath }) + '\n');
+                return 1;
+            }
+            process.stderr.write(msg);
+            return 1;
+        }
+        const last = store.read();
+        if (wantJson) {
+            process.stdout.write(asJson({
+                path: store.baselinePath,
+                baseline,
+                ...(last ? { last, delta: diffImpactReports(baseline, last) } : {}),
+            }) + '\n');
+            return 0;
+        }
+        process.stdout.write(header('Impact baseline'));
+        process.stdout.write(kv('path', store.baselinePath) + '\n');
+        process.stdout.write(kv('input', baseline.inputSummary) + '\n');
+        process.stdout.write(kv('risk', baseline.risk) + '\n');
+        process.stdout.write(kv('dependents', `${baseline.directDependentCount} direct, ${baseline.transitiveDependentCount} transitive`) + '\n');
+        process.stdout.write(kv('packages', String(baseline.affectedPackageCount)) + '\n');
+        if (last) {
+            const d = diffImpactReports(baseline, last);
+            process.stdout.write('\nDelta (last − baseline): ' +
+                `dependents ${d.dependentDelta >= 0 ? '+' : ''}${d.dependentDelta}, ` +
+                `packages ${d.packageDelta >= 0 ? '+' : ''}${d.packageDelta}` +
+                (d.riskDrift ? `, risk ${d.riskDrift}` : '') +
+                (d.worsened ? '  ✗ worsened' : '  ✓ within baseline') +
+                '\n');
+        }
+        else {
+            process.stdout.write('\n(no recent `last.json` — run `shrk impact --via-graph` to populate it.)\n');
+        }
+        return 0;
+    }
+    if (verb === 'clear') {
+        const removed = store.clearBaseline();
+        if (wantJson) {
+            process.stdout.write(asJson({ removed, path: store.baselinePath }) + '\n');
+            return 0;
+        }
+        process.stdout.write(removed ? `Baseline removed: ${store.baselinePath}\n` : 'No baseline to remove.\n');
+        return 0;
+    }
+    process.stderr.write('Usage: shrk impact baseline <write|show|clear> [--json]\n');
+    return 2;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"import.command.d.ts","sourceRoot":"","sources":["../../src/commands/import.command.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAyBhC,eAAO,MAAM,aAAa,EAAE,eA8G3B,CAAC"}
+{"version":3,"file":"import.command.d.ts","sourceRoot":"","sources":["../../src/commands/import.command.ts"],"names":[],"mappings":"AAUA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAyBhC,eAAO,MAAM,aAAa,EAAE,eA8H3B,CAAC"}

package/dist/commands/import.command.js

@@ -1,8 +1,8 @@
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { emitKnowledgeTs, importAgentsMd, importClaudeMd, importCursorRules, } from '@shrkcrft/importer';
+import { emitKnowledgeTs, importAgentsMd, importClaudeMd, importCursorRules, synthesizePopulatedFromImport, } from '@shrkcrft/importer';
 import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
-import { asJson, header, kv } from "../output/format-output.js";
+import { asJson, bullet, header, kv } from "../output/format-output.js";
 function repeatedFlagList(args, name) {
     return flagList(args, name, { dedupe: true });
 }
@@ -22,8 +22,8 @@ function defaultOutput(format) {
 }
 export const importCommand = {
     name: 'import',
-    description: 'Parse existing agent rule files (AGENTS.md / CLAUDE.md / .cursor/rules) into a structured @shrkcrft/knowledge TypeScript draft. Dry-run by default; --write saves the draft to sharkcraft/imports/.',
-    usage: 'shrk [--cwd <dir>] import <format> [<path>] [--prefix <id>] [--tag <t>] [--scope <s>] [--output <file>] [--write] [--force] [--json]',
+    description: 'Parse existing agent rule files (AGENTS.md / CLAUDE.md / .cursor/rules) into shrk\'s structure. By default (`--write`), saves a single draft TS file under sharkcraft/imports/ for the user to adopt by hand. Pass `--populate` to route entries directly into sharkcraft/rules.ts + paths.ts + knowledge.ts (by type) with a confidence triage report — same shape as `shrk init --infer`. Both modes dry-run by default.',
+    usage: 'shrk [--cwd <dir>] import <format> [<path>] [--prefix <id>] [--tag <t>] [--scope <s>] [--output <file>] [--write] [--populate] [--force] [--json]',
     async run(args) {
         const format = args.positional[0];
         if (!format || !KNOWN_FORMATS.includes(format)) {
@@ -57,9 +57,24 @@ export const importCommand = {
         }
         const outPath = nodePath.resolve(cwd, flagString(args, 'output') ?? flagString(args, 'out') ?? defaultOutput(fmt));
         const write = flagBool(args, 'write');
+        const populate = flagBool(args, 'populate');
         const tsSource = emitKnowledgeTs(result.entries, {
             sourceLabel: `${fmt} (${result.sourceFiles.join(', ') || path})`,
         });
+        // ── `--populate` path: distribute entries into populated
+        //    sharkcraft/* files (rules.ts / paths.ts / knowledge.ts) with
+        //    confidence triage. Mirrors `shrk init --infer`'s contract.
+        if (populate) {
+            return runPopulateImport({
+                cwd,
+                fmt,
+                path,
+                result,
+                write,
+                force: flagBool(args, 'force'),
+                wantJson: flagBool(args, 'json'),
+            });
+        }
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson({
                 format: fmt,
@@ -113,3 +128,104 @@ export const importCommand = {
         return 0;
     },
 };
+/**
+ * `shrk import <format> --populate` path. Routes parsed entries
+ * into populated `sharkcraft/*.ts` files by KnowledgeType, with
+ * confidence triage and a companion `.imported-report.md`. Same
+ * shape as `shrk init --infer`.
+ */
+function runPopulateImport(args) {
+    const { cwd, fmt, path, result, write, force, wantJson } = args;
+    const sharkcraftDir = nodePath.join(cwd, 'sharkcraft');
+    const projectName = readProjectName(cwd) ?? 'project';
+    const description = `Imported from ${fmt} (${path})`;
+    const populated = synthesizePopulatedFromImport(result.entries, {
+        projectName,
+        description,
+        sourceLabel: `${fmt} (${result.sourceFiles.join(', ') || path})`,
+    });
+    if (wantJson) {
+        process.stdout.write(asJson({
+            format: fmt,
+            source: path,
+            mode: write ? 'populate' : 'populate-dry-run',
+            sharkcraftDir,
+            entryCount: result.entries.length,
+            warnings: result.warnings,
+            files: populated.files.map((f) => ({ path: f.path, kind: f.kind })),
+            report: populated.report,
+        }) + '\n');
+        return 0;
+    }
+    process.stdout.write(header(`Import (${fmt}) — populate`));
+    process.stdout.write(kv('source', path) + '\n');
+    process.stdout.write(kv('files read', String(result.sourceFiles.length)) + '\n');
+    process.stdout.write(kv('entries parsed', String(result.entries.length)) + '\n');
+    process.stdout.write(kv('target', sharkcraftDir) + '\n');
+    process.stdout.write(kv('mode', write ? 'write' : 'dry-run (preview only)') + '\n\n');
+    process.stdout.write(`Triage: ${populated.report.adoptedHigh.length} adopted directly · ` +
+        `${populated.report.adoptedMedium.length} marked for review · ` +
+        `${populated.report.dropped.length} dropped (in report).\n\n`);
+    if (result.warnings.length > 0) {
+        process.stdout.write(header('Parser warnings'));
+        for (const w of result.warnings) {
+            process.stdout.write(`  ${w.origin}: ${w.message}\n`);
+        }
+        process.stdout.write('\n');
+    }
+    if (!write) {
+        process.stdout.write('Would write:\n');
+        for (const f of populated.files)
+            process.stdout.write(bullet(f.path) + '\n');
+        process.stdout.write('\nRe-run with --write to persist.\n');
+        return 0;
+    }
+    const written = [];
+    const skipped = [];
+    for (const file of populated.files) {
+        const fullPath = nodePath.join(sharkcraftDir, file.path);
+        mkdirSync(nodePath.dirname(fullPath), { recursive: true });
+        if (existsSync(fullPath) && !force) {
+            skipped.push(file.path);
+            continue;
+        }
+        writeFileSync(fullPath, file.content, 'utf8');
+        written.push(file.path);
+    }
+    if (written.length) {
+        process.stdout.write('Wrote:\n');
+        for (const p of written)
+            process.stdout.write(bullet(p) + '\n');
+    }
+    if (skipped.length) {
+        process.stdout.write('\nSkipped (already exist; use --force to overwrite):\n');
+        for (const p of skipped)
+            process.stdout.write(bullet(p) + '\n');
+    }
+    process.stdout.write(`\nRead the import report: \`${nodePath.join('sharkcraft', '.imported-report.md')}\`\n` +
+        `It lists what was adopted high-confidence, what's marked for your review, ` +
+        `and what \`shrk import\` deliberately doesn't recover from markdown.\n`);
+    process.stdout.write('\nNext:\n');
+    process.stdout.write(bullet('$ shrk doctor                            — verify the populated setup') + '\n');
+    process.stdout.write(bullet('$ shrk brief                             — single-page brief Claude reads first') + '\n');
+    process.stdout.write(bullet('$ shrk export claude-skill --write       — inline the rules into Claude\'s prompt') + '\n');
+    return 0;
+}
+/**
+ * Best-effort read of `package.json#name` for use as `projectName`
+ * in the generated config. Falls back to undefined; the synthesizer
+ * uses 'project' as a default.
+ */
+function readProjectName(cwd) {
+    const pkgPath = nodePath.join(cwd, 'package.json');
+    try {
+        if (!existsSync(pkgPath))
+            return undefined;
+        const raw = readFileSync(pkgPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed.name ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"ingest.command.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.command.ts"],"names":[],"mappings":"AAyCA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAOhC,eAAO,MAAM,aAAa,EAAE,eA4B3B,CAAC;AAmZF,eAAO,MAAM,qBAAqB,EAAE,eAenC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eA8B9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAkC9B,CAAC"}
+{"version":3,"file":"ingest.command.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.command.ts"],"names":[],"mappings":"AA0CA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAOhC,eAAO,MAAM,aAAa,EAAE,eA4B3B,CAAC;AAmZF,eAAO,MAAM,qBAAqB,EAAE,eAkBnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eA8B9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAkC9B,CAAC"}

package/dist/commands/ingest.command.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
+import { cliCommandNameSet } from "./command-catalog.js";
 import { applyIngestPlan, buildContradictionReport, buildGeneratedCodeReport, buildIngestAdoptionPlan, buildIngestApplyPlan, buildRepositoryKnowledgeModel, buildStabilityMap, inspectSharkcraft, IngestAdoptionStatus, IngestDepth, IngestSection, loadIngestApplyPlan, renderContradictionReportHtml, renderContradictionReportJson, renderContradictionReportMarkdown, renderContradictionReportText, renderGeneratedCodeReportJson, renderGeneratedCodeReportMarkdown, renderGeneratedCodeReportText, renderIngestAdoptionPatch, renderIngestAdoptionPlanMarkdown, renderIngestApplyReviewMarkdown, renderRepositoryKnowledgeModelHtml, renderRepositoryKnowledgeModelJson, renderRepositoryKnowledgeModelMarkdown, renderRepositoryKnowledgeModelText, renderStabilityMapJson, renderStabilityMapMarkdown, renderStabilityMapText, saveIngestApplyPlan, signIngestApplyPlan, writeIngestAdoption, writeIngestDrafts, } from '@shrkcrft/inspector';
 import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
@@ -442,7 +443,10 @@ export const contradictionsCommand = {
         const cwd = resolveCwd(args);
         const format = parseFormat(flagString(args, 'format'));
         const inspection = await inspectSharkcraft({ cwd });
-        const report = buildContradictionReport({ inspection });
+        const report = buildContradictionReport({
+            inspection,
+            cliCommandNames: cliCommandNameSet(),
+        });
         if (format === 'json')
             process.stdout.write(renderContradictionReportJson(report) + '\n');
         else if (format === 'markdown')

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

@@ -1 +1 @@
-{"version":3,"file":"init.command.d.ts","sourceRoot":"","sources":["../../src/commands/init.command.ts"],"names":[],"mappings":"AAeA,OAAO,EAAwB,KAAK,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AAuQjH,eAAO,MAAM,WAAW,EAAE,eA2FzB,CAAC"}
+{"version":3,"file":"init.command.d.ts","sourceRoot":"","sources":["../../src/commands/init.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwB,KAAK,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AAuSjH,eAAO,MAAM,WAAW,EAAE,eA2HzB,CAAC"}