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

package/dist/commands/packs-new.js

@@ -1,21 +1,13 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
 import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
+import { importModuleViaLoader } from '@shrkcrft/core';
 const VALID_KINDS = new Set([
     'generic',
     'framework',
     'architecture',
     'enterprise',
-    'platform-adopter',
 ]);
 /** Pure: compute the file set to write. No IO. */
 export function planPackScaffold(input) {
@@ -108,12 +100,6 @@ export function planPackScaffold(input) {
             body: renderBoundariesAsset(),
         });
     }
-    if (input.kind === 'platform-adopter' || input.withExamples) {
-        files.push({
-            relativePath: 'src/assets/contracts/plugin-contract.example.ts',
-            body: renderPluginContractExample(),
-        });
-    }
     if (input.kind === 'enterprise') {
         files.push({
             relativePath: 'docs/review-workflow.md',
@@ -239,12 +225,6 @@ function renderKnowledgeAsset(input) {
             ['framework.overview', 'Framework overview', 'High', 'What this framework is for.'],
         ]);
     }
-    if (input.kind === 'platform-adopter') {
-        return knowledgeBody([
-            ['platform.policy', 'Policy capability', 'Medium', 'Describe the policy/capability model your platform exposes.'],
-            ['platform.adapter', 'Adapter contract', 'Medium', 'Describe the adapter contract your platform expects.'],
-        ]);
-    }
     return knowledgeBody([
         ['pack.overview', 'Pack overview', 'Medium', 'Short overview of what this pack contributes.'],
     ]);
@@ -357,17 +337,6 @@ function renderBoundariesAsset() {
         ``,
     ].join('\n');
 }
-function renderPluginContractExample() {
-    return [
-        `// Example: an adapter-style plugin contract.`,
-        `// Replace with the actual interface your platform expects.`,
-        `export interface IPluginCapability {`,
-        `  id: string;`,
-        `  invoke(input: unknown): Promise<unknown>;`,
-        `}`,
-        ``,
-    ].join('\n');
-}
 function renderEnterpriseReviewDocs() {
     return [
         `# Review workflow`,
@@ -414,11 +383,11 @@ function renderDocsOverview(input, fullName) {
 export const packsNewCommand = {
     name: 'new',
     description: 'Scaffold a new SharkCraft pack package (rules / paths / templates / pipelines / presets / boundaries). Dry-run by default — pass --write to materialize. No install, no publish, no overwrite without --force.',
-    usage: 'shrk [--cwd <dir>] packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise|platform-adopter] [--with-examples] [--write] [--force] [--json]',
+    usage: 'shrk [--cwd <dir>] packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise] [--with-examples] [--write] [--force] [--json]',
     async run(args) {
         const name = args.positional[0];
         if (!name) {
-            process.stderr.write('Usage: shrk packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise|platform-adopter] [--with-examples] [--write]\n');
+            process.stderr.write('Usage: shrk packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise] [--with-examples] [--write]\n');
             return 2;
         }
         const cwd = resolveCwd(args);
@@ -645,7 +614,7 @@ async function runRuntimePackTest(input) {
     if (existsSync(entry)) {
         try {
             const { pathToFileURL } = await import('node:url');
-            const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(entry).href + `?bust=${Date.now()}`)));
+            const mod = (await importModuleViaLoader(entry));
             const value = mod.default ?? mod;
             const shape = describeShape(value);
             modules.push({
@@ -692,7 +661,7 @@ async function runRuntimePackTest(input) {
             continue;
         try {
             const { pathToFileURL } = await import('node:url');
-            const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(full).href + `?bust=${Date.now()}`)));
+            const mod = (await importModuleViaLoader(full));
             const value = mod.default;
             const arr = Array.isArray(value) ? value : null;
             modules.push({

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

@@ -1 +1 @@
-{"version":3,"file":"packs.command.d.ts","sourceRoot":"","sources":["../../src/commands/packs.command.ts"],"names":[],"mappings":"AAqBA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAOhC,eAAO,MAAM,yBAAyB,EAAE,eAoCvC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,eAsGzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eA+CnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAuD9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAsE7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAqDjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAyFhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAqEhC,CAAC;AA4DF,eAAO,MAAM,gBAAgB,EAAE,eA+K9B,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmCtC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAyFhC,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,eA4BnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,eA+E/B,CAAC"}
+{"version":3,"file":"packs.command.d.ts","sourceRoot":"","sources":["../../src/commands/packs.command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAQhC,eAAO,MAAM,yBAAyB,EAAE,eAoCvC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,eAsGzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eA+CnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAuD9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAsE7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAqDjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAyFhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAqEhC,CAAC;AA4DF,eAAO,MAAM,gBAAgB,EAAE,eA+K9B,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmCtC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAmFhC,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,eA4BnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,eA+E/B,CAAC"}

package/dist/commands/packs.command.js

@@ -1,18 +1,10 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { pathToFileURL } from 'node:url';
 import { buildPackDoctorReport, buildPackSignatureStatusReport, checkPackSymbolCompat, explainPackSignatureStatus, inspectSharkcraft, mergePackReleaseChecks, runPackReleaseCheck, runPackReleaseChecksForReport, } from '@shrkcrft/inspector';
 import { PACK_SECRET_ENV, signPackManifest, validatePackManifest, verifyPackManifest, } from '@shrkcrft/plugin-api';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
+import { importModuleViaLoader } from '@shrkcrft/core';
 function statusLabel(valid) {
     return valid ? 'OK     ' : 'INVALID';
 }
@@ -553,7 +545,7 @@ async function loadManifestFromPath(manifestPath) {
     if (manifestPath.endsWith('.json')) {
         return JSON.parse(readFileSync(manifestPath, 'utf8'));
     }
-    const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(manifestPath).href)));
+    const mod = (await importModuleViaLoader(manifestPath));
     return (mod.default ?? mod);
 }
 export const packsSignCommand = {
@@ -773,17 +765,11 @@ export const packsCompatCommand = {
                 : nodePath.resolve(cwd, consumerRootRaw)
             : null;
         const distAware = flagBool(args, 'dist-aware');
-        const fastMode = flagBool(args, 'fast');
         // Run a release-check first; surfaces helper-missing diagnostics.
         const release = await runPackReleaseCheck(abs);
         const helperMissing = release.findings.filter((f) => f.code === 'contribution-helper-missing');
         // Symbol-level diff against the consumer's installed plugin-api.
-        const symbol = checkPackSymbolCompat({
-            packPath: abs,
-            consumerRoot,
-            distAware,
-            mode: fastMode ? 'fast' : 'ts',
-        });
+        const symbol = checkPackSymbolCompat({ packPath: abs, consumerRoot, distAware });
         const passed = helperMissing.length === 0 && symbol.compatible;
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson({

package/dist/commands/plan-context.command.d.ts

@@ -0,0 +1,11 @@
+import { type ICommandHandler } from '../command-registry.js';
+/**
+ * `shrk plan-context` — produce a deterministic, token-budgeted context
+ * pack for an AI coding agent. Reads the code graph + (optionally) the
+ * rule-graph bridge.
+ *
+ * Read-only. The pack is whatever the planner decides; the agent uses
+ * it as the starting point for its conversation.
+ */
+export declare const planContextCommand: ICommandHandler;
+//# sourceMappingURL=plan-context.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-context.command.d.ts","sourceRoot":"","sources":["../../src/commands/plan-context.command.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,eA2DhC,CAAC"}

package/dist/commands/plan-context.command.js

@@ -0,0 +1,77 @@
+import { planContext } from '@shrkcrft/context-planner';
+import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
+import { asJson, header, kv } from "../output/format-output.js";
+/**
+ * `shrk plan-context` — produce a deterministic, token-budgeted context
+ * pack for an AI coding agent. Reads the code graph + (optionally) the
+ * rule-graph bridge.
+ *
+ * Read-only. The pack is whatever the planner decides; the agent uses
+ * it as the starting point for its conversation.
+ */
+export const planContextCommand = {
+    name: 'plan-context',
+    description: 'Produce a deterministic, token-budgeted context pack (`sharkcraft.context-pack/v1`) for an AI agent: ranked files, applicable rules, likely tests, surfaced risks, do-not-touch zones.',
+    usage: 'shrk plan-context "<task>" [--budget N] [--max-files N] [--hint-file <path>] [--hint-package <prefix>] [--json]',
+    async run(args) {
+        const cwd = resolveCwd(args);
+        const wantJson = flagBool(args, 'json');
+        const task = args.positional[0];
+        if (!task) {
+            process.stderr.write(this.usage + '\n');
+            return 2;
+        }
+        const budget = Number(flagString(args, 'budget') ?? '8000');
+        const maxFiles = Number(flagString(args, 'max-files') ?? '30');
+        const hintedFiles = collectMulti(args, 'hint-file');
+        const hintedPackages = collectMulti(args, 'hint-package');
+        const pack = planContext({
+            projectRoot: cwd,
+            task,
+            budgetTokens: budget,
+            maxFiles,
+            ...(hintedFiles.length > 0 ? { hintedFiles } : {}),
+            ...(hintedPackages.length > 0 ? { hintedPackages } : {}),
+        });
+        if (wantJson) {
+            process.stdout.write(asJson(pack) + '\n');
+            return 0;
+        }
+        process.stdout.write(header(`Context pack: ${task}`));
+        process.stdout.write(kv('intent', pack.intent) + '\n');
+        process.stdout.write(kv('files', String(pack.files.length)) + '\n');
+        process.stdout.write(kv('rules', String(pack.rules.length)) + '\n');
+        process.stdout.write(kv('paths', String(pack.paths.length)) + '\n');
+        process.stdout.write(kv('templates', String(pack.templates.length)) + '\n');
+        process.stdout.write(kv('tests', String(pack.tests.length)) + '\n');
+        process.stdout.write(kv('risks', String(pack.risks.length)) + '\n');
+        process.stdout.write(kv('budget', `${pack.budget.used}/${pack.budget.requested} tokens` + (pack.budget.truncated ? ' (truncated)' : '')) + '\n');
+        if (pack.files.length > 0) {
+            process.stdout.write('\nTop files:\n');
+            for (const f of pack.files.slice(0, 15)) {
+                const reason = f.reasons[0] ? `  [${f.reasons[0]}]` : '';
+                process.stdout.write(`  ${f.score.toFixed(2)}  ${f.path}${reason}\n`);
+            }
+        }
+        if (pack.tests.length > 0) {
+            process.stdout.write('\nLikely tests:\n');
+            for (const t of pack.tests.slice(0, 5))
+                process.stdout.write(`  ${t}\n`);
+        }
+        if (pack.risks.length > 0) {
+            process.stdout.write('\nRisks:\n');
+            for (const r of pack.risks)
+                process.stdout.write(`  • [${r.kind}] ${r.label}\n`);
+        }
+        for (const d of pack.diagnostics.slice(0, 5))
+            process.stdout.write(`! ${d}\n`);
+        return 0;
+    },
+};
+function collectMulti(args, name) {
+    const list = args.multiFlags.get(name);
+    if (list)
+        return [...list];
+    const single = flagString(args, name);
+    return single ? [single] : [];
+}

package/dist/commands/profiles.command.js

@@ -1,6 +1,6 @@
 /**
  * `shrk profiles ...` — unified read-only surface for all pack-/local-
- * contributed profiles (plugin lifecycle, migration, and future kinds).
+ * contributed profiles (migration, and future kinds).
  */
 import { findProfile, inspectSharkcraft, listProfileIssues, listProfiles, ProfileKind, } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
@@ -15,7 +15,7 @@ function parseKind(value) {
 }
 export const profilesListCommand = {
     name: 'list',
-    description: 'List all registered profiles (plugin-lifecycle, migration, ...).',
+    description: 'List all registered profiles (migration, ...).',
     usage: 'shrk profiles list [--kind <kind>] [--json]',
     async run(args) {
         const cwd = resolveCwd(args);
@@ -28,7 +28,7 @@ export const profilesListCommand = {
         }
         process.stdout.write(header(`Profiles (${entries.length}${kind ? `, kind=${kind}` : ''})`));
         if (entries.length === 0) {
-            process.stdout.write('  (none — contribute via packs: pluginLifecycleProfileFiles, migrationProfileFiles, etc.)\n');
+            process.stdout.write('  (none — contribute via packs: migrationProfileFiles, etc.)\n');
             return 0;
         }
         for (const e of entries) {
@@ -132,7 +132,7 @@ export const profilesSearchCommand = {
 };
 export const profilesCommand = {
     name: 'profiles',
-    description: 'List / inspect pack-contributed profiles (plugin-lifecycle, migration, conventions, …).',
+    description: 'List / inspect pack-contributed profiles (migration, conventions, …).',
     usage: 'shrk profiles list|get|doctor|search ...',
     async run(args) {
         const sub = args.positional[0];

package/dist/commands/release.command.js

@@ -204,8 +204,8 @@ function resolveSmokeFlags(args) {
     const noAssertions = flagBool(args, 'no-assertions');
     return { assertionsEnabled: !noAssertions };
 }
-// Generic adopter target replaces the previous hardcoded project target.
-const BUILTIN_TARGET_IDS = ['sharkcraft', 'dogfood', 'synthetic', 'adopter'];
+// Generic consumer target replaces the previous hardcoded project target.
+const BUILTIN_TARGET_IDS = ['sharkcraft', 'dogfood', 'synthetic', 'consumer'];
 function resolveTargets(cwd, args, requested) {
     const want = (id) => requested.length === 0 || requested.includes(id);
     const out = [];
@@ -224,19 +224,19 @@ function resolveTargets(cwd, args, requested) {
         writeFileSync(nodePath.join(root, 'package.json'), JSON.stringify({ name: 'sharkcraft-synth', version: '0.0.0', type: 'module' }, null, 2), 'utf8');
         out.push({ id: 'synthetic', cwd: root, label: 'synthetic-fixture' });
     }
-    if (want('adopter')) {
-        const adopterRoot = flagString(args, 'adopter-root') ??
-            process.env['SHARKCRAFT_ADOPTER_ROOT'] ??
+    if (want('consumer')) {
+        const consumerRoot = flagString(args, 'consumer-root') ??
+            process.env['SHARKCRAFT_CONSUMER_ROOT'] ??
             '';
-        if (adopterRoot && existsSync(adopterRoot)) {
-            out.push({ id: 'adopter', cwd: adopterRoot, label: `adopter:${adopterRoot}` });
+        if (consumerRoot && existsSync(consumerRoot)) {
+            out.push({ id: 'consumer', cwd: consumerRoot, label: `consumer:${consumerRoot}` });
         }
         else {
             out.push({
-                id: 'adopter',
-                cwd: adopterRoot || '(unset)',
-                label: 'adopter target',
-                warning: 'Adopter root not set (pass --adopter-root or set SHARKCRAFT_ADOPTER_ROOT) — skipped.',
+                id: 'consumer',
+                cwd: consumerRoot || '(unset)',
+                label: 'consumer target',
+                warning: 'Consumer root not set (pass --consumer-root or set SHARKCRAFT_CONSUMER_ROOT) — skipped.',
             });
         }
     }
@@ -292,7 +292,7 @@ async function runReleaseSmoke(args) {
  *    examples/dogfood-target as the fixture.
  *  - `synthetic` runs the scenarios that don't depend on a prepared source
  *    (unconfigured-repo + pack-authoring).
- *  - `adopter` runs the read-only scenarios that don't write outside the
+ *  - `consumer` runs the read-only scenarios that don't write outside the
  *    fixture (e.g. an external project that consumes a SharkCraft pack).
  */
 function isScenarioApplicableTo(scenario, target) {
@@ -304,7 +304,7 @@ function isScenarioApplicableTo(scenario, target) {
     if (target.id === 'dogfood') {
         return scenario === 'dev-workflow' || scenario === 'pr-review' || scenario === 'governance';
     }
-    if (target.id === 'adopter') {
+    if (target.id === 'consumer') {
         return scenario === 'unconfigured-repo' || scenario === 'pack-authoring' || scenario === 'governance';
     }
     return true;

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

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

package/dist/commands/review.command.js

@@ -95,21 +95,8 @@ export const reviewCommand = {
         if (args.positional[0] === 'packet') {
             return runPacket(args);
         }
-        const cwd = resolveCwd(args);
-        const inspection = await inspectSharkcraft({ cwd });
+        const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
         const since = flagString(args, 'since');
-        if (since) {
-            const { verifyGitRef } = await import('@shrkcrft/inspector');
-            const verify = verifyGitRef(cwd, since);
-            if (!verify.valid) {
-                process.stderr.write(`error: --since ref "${since}" does not resolve to a commit in this repository.\n` +
-                    (verify.suggestions && verify.suggestions.length > 0
-                        ? `\nDid you mean:\n${verify.suggestions.map((s) => `  --since ${s}`).join('\n')}\n`
-                        : '') +
-                    '\nUse `git branch -a` to list available refs.\n');
-                return 2;
-            }
-        }
         const files = flagList(args, 'files');
         const packet = buildReviewPacket(inspection, {
             ...(since ? { since } : {}),
@@ -308,21 +295,8 @@ function isReviewPacketV3Shape(v) {
     return v.schema === REVIEW_PACKET_V3_SCHEMA;
 }
 async function runPacket(args) {
-    const cwd = resolveCwd(args);
-    const inspection = await inspectSharkcraft({ cwd });
+    const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
     const since = flagString(args, 'since');
-    if (since) {
-        const { verifyGitRef } = await import('@shrkcrft/inspector');
-        const verify = verifyGitRef(cwd, since);
-        if (!verify.valid) {
-            process.stderr.write(`error: --since ref "${since}" does not resolve to a commit in this repository.\n` +
-                (verify.suggestions && verify.suggestions.length > 0
-                    ? `\nDid you mean:\n${verify.suggestions.map((s) => `  --since ${s}`).join('\n')}\n`
-                    : '') +
-                '\nUse `git branch -a` to list available refs.\n');
-            return 2;
-        }
-    }
     const files = flagList(args, 'files');
     const v2 = flagBool(args, 'v2');
     const baselineFile = flagString(args, 'quality-baseline');

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

@@ -0,0 +1,3 @@
+import { type ICommandHandler } from '../command-registry.js';
+export declare const ruleGraphCommand: ICommandHandler;
+//# sourceMappingURL=rule-graph-subverbs.d.ts.map

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

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

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

@@ -0,0 +1,132 @@
+/**
+ * CLI subverbs for `@shrkcrft/rule-graph`.
+ *
+ * Sub-namespace: `shrk rule-graph <verb>`. Lives in its own command
+ * because the verbs operate on a separate `.sharkcraft/bridge/` store
+ * and don't conceptually belong under `shrk graph`.
+ */
+import { buildBridge, RuleGraphQueryApi } from '@shrkcrft/rule-graph';
+import { flagBool, resolveCwd } from "../command-registry.js";
+import { asJson, header, kv } from "../output/format-output.js";
+export const ruleGraphCommand = {
+    name: 'rule-graph',
+    description: 'Bridge the SharkCraft code graph to asset registries (boundary rules, path conventions, templates). Sub-verbs: index, status, for <file>.',
+    usage: 'shrk rule-graph index [--json] | shrk rule-graph status [--json] | shrk rule-graph for <file> [--json]',
+    async run(args) {
+        const sub = args.positional[0];
+        if (sub === 'index')
+            return runIndex(args);
+        if (sub === 'status')
+            return runStatus(args);
+        if (sub === 'for')
+            return runFor(args);
+        process.stderr.write(this.usage + '\n');
+        return 2;
+    },
+};
+async function runIndex(args) {
+    const cwd = resolveCwd(args);
+    const wantJson = flagBool(args, 'json');
+    const r = await buildBridge({ projectRoot: cwd });
+    if (wantJson) {
+        process.stdout.write(asJson({ ok: true, manifest: r.manifest, durationMs: r.durationMs }) + '\n');
+        return 0;
+    }
+    process.stdout.write(header('Rule-graph bridge'));
+    process.stdout.write(kv('schema', r.manifest.schema) + '\n');
+    process.stdout.write(kv('bridge edges', String(sumValues(r.manifest.edgesByKind))) + '\n');
+    process.stdout.write(kv('rules → files', String(r.manifest.sourceCounts['rule'] ?? 0)) + '\n');
+    process.stdout.write(kv('paths → files', String(r.manifest.sourceCounts['path'] ?? 0)) + '\n');
+    process.stdout.write(kv('templates → files', String(r.manifest.sourceCounts['template'] ?? 0)) + '\n');
+    process.stdout.write(kv('duration', `${r.durationMs}ms`) + '\n');
+    return 0;
+}
+async function runStatus(args) {
+    const cwd = resolveCwd(args);
+    const wantJson = flagBool(args, 'json');
+    const missing = RuleGraphQueryApi.missingDescription(cwd);
+    if (missing) {
+        if (wantJson) {
+            process.stdout.write(asJson({ ok: false, state: 'missing', message: missing, nextCommand: 'shrk rule-graph index' }) + '\n');
+            return 1;
+        }
+        process.stderr.write(missing + '\n');
+        return 1;
+    }
+    const api = RuleGraphQueryApi.fromStores(cwd);
+    // No public counters from the API itself — just confirm it loads.
+    if (wantJson) {
+        process.stdout.write(asJson({ ok: true, state: 'fresh' }) + '\n');
+        return 0;
+    }
+    process.stdout.write(header('Rule-graph status'));
+    process.stdout.write(kv('state', 'fresh') + '\n');
+    void api;
+    return 0;
+}
+async function runFor(args) {
+    const cwd = resolveCwd(args);
+    const wantJson = flagBool(args, 'json');
+    const file = args.positional[1];
+    if (!file) {
+        process.stderr.write('Usage: shrk rule-graph for <file>\n');
+        return 2;
+    }
+    const missing = RuleGraphQueryApi.missingDescription(cwd);
+    if (missing) {
+        if (wantJson) {
+            process.stdout.write(asJson({ ok: false, message: missing, nextCommand: 'shrk rule-graph index' }) + '\n');
+            return 1;
+        }
+        process.stderr.write(missing + '\n');
+        return 1;
+    }
+    const api = RuleGraphQueryApi.fromStores(cwd);
+    const r = api.forFile(file);
+    if (!r) {
+        const payload = { ok: false, error: 'not-found', file };
+        if (wantJson) {
+            process.stdout.write(asJson(payload) + '\n');
+            return 1;
+        }
+        process.stderr.write(`No file node for "${file}".\n`);
+        return 1;
+    }
+    const payload = {
+        schema: 'sharkcraft.rule-graph-for-file/v1',
+        file: r.path,
+        rules: r.rules.map((h) => ({ id: h.target.id, label: h.target.label, severity: h.edge.data?.['severity'] ?? undefined })),
+        paths: r.paths.map((h) => ({ id: h.target.id, label: h.target.label })),
+        templates: r.templates.map((h) => ({ id: h.target.id, label: h.target.label })),
+    };
+    if (wantJson) {
+        process.stdout.write(asJson(payload) + '\n');
+        return 0;
+    }
+    process.stdout.write(header(`Rule-graph for: ${r.path}`));
+    if (payload.rules.length > 0) {
+        process.stdout.write('\nRules (boundary):\n');
+        for (const h of payload.rules)
+            process.stdout.write(`  ${h.id} — ${h.label}${h.severity ? ' [' + h.severity + ']' : ''}\n`);
+    }
+    if (payload.paths.length > 0) {
+        process.stdout.write('\nPath conventions:\n');
+        for (const h of payload.paths)
+            process.stdout.write(`  ${h.id} — ${h.label}\n`);
+    }
+    if (payload.templates.length > 0) {
+        process.stdout.write('\nTemplates:\n');
+        for (const h of payload.templates)
+            process.stdout.write(`  ${h.id} — ${h.label}\n`);
+    }
+    if (payload.rules.length === 0 && payload.paths.length === 0 && payload.templates.length === 0) {
+        process.stdout.write('  (no bridge edges for this file)\n');
+    }
+    return 0;
+}
+function sumValues(record) {
+    let n = 0;
+    for (const v of Object.values(record))
+        n += v;
+    return n;
+}

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

@@ -0,0 +1,18 @@
+import { type ICommandHandler } from '../command-registry.js';
+/**
+ * `shrk search structural` — declarative AST pattern matching with
+ * optional rewrite mode (Wave 8). Patterns are JSON (no executable
+ * predicates) — either inline via --pattern or from a file via
+ * --pattern-file.
+ *
+ * Rewrite flow:
+ *   1. Pass `--rewrite '<json>'` (a `RewriteRecipe`) to compute a
+ *      rewrite plan.
+ *   2. Preview is shown by default (no fs writes).
+ *   3. Pass `--apply` to actually write the changes.
+ *
+ * The plan can be inspected as JSON via `--json` and replayed via
+ * `--plan-in <path>` (write the plan with `--plan-out <path>` first).
+ */
+export declare const searchStructuralCommand: ICommandHandler;
+//# sourceMappingURL=search-structural.command.d.ts.map

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

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