@shrkcrft/cli 0.1.0-alpha.8 → 0.1.0-alpha.9

package/dist/surface/about.js

@@ -8,46 +8,24 @@ import { SHARKCRAFT_VERSION } from '@shrkcrft/shared';
  * `docs/`; this is the in-binary summary.
  */
 export function renderAbout() {
-    return `SharkCraft v${SHARKCRAFT_VERSION}
+    return `SharkCraft v${SHARKCRAFT_VERSION} — the safety layer beneath your AI coding agent.
 
-What it is
-  A deterministic, local-first toolkit that gives AI coding agents
-  durable project context. Ships as a CLI (\`shrk\`) — the only write
-  path — plus a read-only MCP server, plus a library of structured
-  assets (knowledge, rules, paths, templates, pipelines, presets,
-  boundaries).
+Three structural guarantees (not prompts):
+  - MCP is read-only. Agents cannot write through it.
+  - Writes flow through signed plans. \`shrk apply --verify-signature\`
+    refuses on divergence.
+  - Boundaries are mechanical. \`shrk check boundaries --changed-only\`
+    fails only on violations the current diff introduced.
 
-What it is NOT
-  There is no AI inside the engine. Every output is a pure function
-  of the workspace + the asset registries. The agent uses the engine;
-  the engine never calls a model.
+On top of that: typed rules, paths, templates, pipelines, presets — so
+the agent hallucinates less inside the bounds the safety surface enforces.
+No AI inside the engine; every output is a pure function of the workspace.
 
-The safety contract
-  - All write paths are preview-first. \`--apply\` is opt-in, scoped,
-    and idempotent.
-  - MCP is read-only. Every MCP tool returns data + a next-command
-    hint; the human runs the CLI for any write.
-  - Apply requires \`--verify-signature\` for signed plans, refuses
-    on divergence unless \`--allow-divergent\`.
+Try:
+  shrk check boundaries --changed-only --since main
+  shrk review packet --v3 --since main
+  shrk mcp install claude-code
 
-Calibration to project size
-  Surface tiers (\`shrk surface list\`):
-    - core         always on
-    - extended     visible in --help, callable
-    - experimental hidden until enabled (\`shrk surface enable\`)
-  Project shape (\`shrk doctor\`) drives the default surface for a
-  fresh repo.
-
-Where to read more
-  docs/overview.md        what SharkCraft is and isn't
-  docs/philosophy.md      the non-negotiable design rules
-  docs/surface-tiers.md   the tier model
-  docs/safety-model.md    plan / review / apply contract
-
-Quick start
-  shrk doctor             health check
-  shrk task "<what>"      full task packet (rules + templates + commands)
-  shrk recommend "<what>" what command should I reach for?
-  shrk surface list       what is available in this repo
+Docs: overview.md · safety-model.md · INDEX.md · demo.md
 `;
 }

package/dist/surface/no-args-landing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-args-landing.d.ts","sourceRoot":"","sources":["../../src/surface/no-args-landing.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BtE"}
+{"version":3,"file":"no-args-landing.d.ts","sourceRoot":"","sources":["../../src/surface/no-args-landing.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCtE"}

package/dist/surface/no-args-landing.js

@@ -8,7 +8,7 @@ import { buildSurfaceSummary } from "./surface-summary.js";
  */
 export async function renderNoArgsLanding(cwd) {
     const lines = [];
-    lines.push(`shrk v${SHARKCRAFT_VERSION} — deterministic context for AI coding agents.`);
+    lines.push(`shrk v${SHARKCRAFT_VERSION} — the safety layer beneath your AI coding agent.`);
     lines.push('');
     let totals = '';
     try {
@@ -21,16 +21,20 @@ export async function renderNoArgsLanding(cwd) {
     }
     lines.push(totals);
     lines.push('');
-    lines.push('Most useful next:');
-    lines.push('  shrk doctor                 health check');
-    lines.push('  shrk task "<what>"          full packet for a task');
-    lines.push('  shrk recommend "<what>"     what should I do?');
-    lines.push('  shrk surface list           what is available in this repo');
+    lines.push('Prove it in 60 seconds:');
+    lines.push('  shrk check boundaries --changed-only --since main');
+    lines.push('                              fail only on violations the diff introduced');
+    lines.push('  shrk review packet --v3 --since main');
+    lines.push('                              structured packet for an AI PR reviewer');
+    lines.push('  shrk apply --verify-signature <plan.json>');
+    lines.push('                              signed-plan write — refuses on divergence');
     lines.push('');
-    lines.push('See:');
+    lines.push('Orient:');
+    lines.push('  shrk doctor                 health check + AI-readiness score');
+    lines.push('  shrk recommend "<task>"     what command should I reach for?');
+    lines.push('  shrk surface list           what is available in this repo');
+    lines.push('  shrk --about                the safety contract in one screen');
     lines.push('  shrk --help                 every visible command');
-    lines.push('  shrk surface explain <cmd>  why a command is/is not visible');
-    lines.push('  shrk --about                what shrk is and is not');
     lines.push('');
     return lines.join('\n');
 }

package/dist/surface/surface-config-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface-config-writer.d.ts","sourceRoot":"","sources":["../../src/surface/surface-config-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,kBAAkB,CA0BpB;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,GACvB,yBAAyB,CAe3B;AAoBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAO,GAAG,MAAM,CAsBjF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CA6BtF;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE/D"}
+{"version":3,"file":"surface-config-writer.d.ts","sourceRoot":"","sources":["../../src/surface/surface-config-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,kBAAkB,CA0BpB;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,GACvB,yBAAyB,CAe3B;AAmBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAO,GAAG,MAAM,CAsBjF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAgBtF;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/surface/surface-config-writer.js

@@ -72,11 +72,10 @@ function fileExists(p) {
         return false;
     }
 }
-// Plain default export — no @shrkcrft/* import required. The config
-// loader (packages/config/src/config-loader.ts) validates by shape, so a
-// literal object works the same as a `defineSharkCraftConfig()` call.
-const DEFAULT_CONFIG_BODY = `export default {
-};
+const DEFAULT_CONFIG_BODY = `import { defineSharkCraftConfig } from '@shrkcrft/config';
+
+export default defineSharkCraftConfig({
+});
 `;
 const SURFACE_BLOCK_REGEX = /(^\s*surface\s*:\s*\{[\s\S]*?\}\s*,?\s*\n)/m;
 /**
@@ -121,25 +120,14 @@ export function applySurfaceTextEdit(original, surface) {
     if (SURFACE_BLOCK_REGEX.test(original)) {
         return original.replace(SURFACE_BLOCK_REGEX, block);
     }
-    // (A) `defineSharkCraftConfig({ ... })` style — insert before the `})`.
-    const closeFn = /(\n)(\}\)\s*;?\s*)$/m;
-    if (closeFn.test(original)) {
-        return original.replace(closeFn, `\n${block}$2`);
+    // Insert before the closing `})` / `});` of the config object.
+    // Prefer the last `})` so nested objects don't trip us up.
+    const closeRegex = /(\n)(\}\)\s*;?\s*)$/m;
+    if (closeRegex.test(original)) {
+        return original.replace(closeRegex, `\n${block}$2`);
     }
-    // (B) `const config = { ... };\nexport default config;` plain style —
-    // insert before the `};` that closes the literal.
-    const closePlain = /(\n)(\};?\s*\nexport\s+default\s+\w+\s*;?\s*\n*)$/m;
-    if (closePlain.test(original)) {
-        return original.replace(closePlain, `\n${block}$2`);
-    }
-    // (C) `export default { ... };` direct style — insert before the `};`.
-    const closeDirect = /(\n)(\};?\s*\n*)$/m;
-    if (closeDirect.test(original)) {
-        return original.replace(closeDirect, `\n${block}$2`);
-    }
-    // Fallback: append at end with a plain default-exported config (no
-    // `@shrkcrft/*` import required).
-    return `${original}\n${DEFAULT_CONFIG_BODY.replace('};', `${block}};`)}`;
+    // Fallback: append at end with a defineSharkCraftConfig wrapper.
+    return `${original}\n${DEFAULT_CONFIG_BODY.replace('})', `${block}})`)}`;
 }
 /** Default config file path for a project. */
 export function defaultConfigFile(sharkcraftDir) {

package/package.json

@@ -1,16 +1,15 @@
 {
   "name": "@shrkcrft/cli",
-  "version": "0.1.0-alpha.8",
-  "description": "SharkCraft CLI (`shrk`): structured project intelligence for AI coding agents.",
+  "version": "0.1.0-alpha.9",
+  "description": "SharkCraft CLI (`shrk`): the safety layer beneath your AI coding agent.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
@@ -25,12 +24,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/shrkcrft/sharkcraft.git",
+    "url": "git+https://github.com/sharkcraft/sharkcraft.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://github.com/shrkcrft/sharkcraft",
+  "homepage": "https://github.com/sharkcraft/sharkcraft",
   "bugs": {
-    "url": "https://github.com/shrkcrft/sharkcraft/issues"
+    "url": "https://github.com/sharkcraft/sharkcraft/issues"
   },
   "keywords": [
     "sharkcraft",
@@ -47,25 +46,25 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.8",
-    "@shrkcrft/config": "^0.1.0-alpha.8",
-    "@shrkcrft/workspace": "^0.1.0-alpha.8",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.8",
-    "@shrkcrft/context": "^0.1.0-alpha.8",
-    "@shrkcrft/rules": "^0.1.0-alpha.8",
-    "@shrkcrft/paths": "^0.1.0-alpha.8",
-    "@shrkcrft/templates": "^0.1.0-alpha.8",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.8",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.8",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.8",
-    "@shrkcrft/presets": "^0.1.0-alpha.8",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.8",
-    "@shrkcrft/generator": "^0.1.0-alpha.8",
-    "@shrkcrft/importer": "^0.1.0-alpha.8",
-    "@shrkcrft/inspector": "^0.1.0-alpha.8",
-    "@shrkcrft/ai": "^0.1.0-alpha.8",
-    "@shrkcrft/shared": "^0.1.0-alpha.8",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.8"
+    "@shrkcrft/core": "^0.1.0-alpha.9",
+    "@shrkcrft/config": "^0.1.0-alpha.9",
+    "@shrkcrft/workspace": "^0.1.0-alpha.9",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.9",
+    "@shrkcrft/context": "^0.1.0-alpha.9",
+    "@shrkcrft/rules": "^0.1.0-alpha.9",
+    "@shrkcrft/paths": "^0.1.0-alpha.9",
+    "@shrkcrft/templates": "^0.1.0-alpha.9",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.9",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.9",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.9",
+    "@shrkcrft/presets": "^0.1.0-alpha.9",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.9",
+    "@shrkcrft/generator": "^0.1.0-alpha.9",
+    "@shrkcrft/importer": "^0.1.0-alpha.9",
+    "@shrkcrft/inspector": "^0.1.0-alpha.9",
+    "@shrkcrft/ai": "^0.1.0-alpha.9",
+    "@shrkcrft/shared": "^0.1.0-alpha.9",
+    "@shrkcrft/mcp-server": "^0.1.0-alpha.9"
   },
   "publishConfig": {
     "access": "public"

package/dist/commands/diff-check.command.d.ts

@@ -1,30 +0,0 @@
-/**
- * `shrk diff-check` — agent self-validation after edits.
- *
- * The story this command tells:
- *   1. An AI agent (Claude Code, Cursor, etc.) makes some file changes.
- *   2. Before declaring "done", the agent runs `shrk diff-check`.
- *   3. The command scopes both the boundary check and the
- *      import-hygiene check to only the files the agent touched in the
- *      current git diff.
- *   4. The output is a single agent-friendly JSON envelope with a
- *      verdict (ok / warnings / errors) and a one-line next action.
- *
- * Why a new command instead of "just run `shrk check boundaries
- * --changed-only` and `shrk check imports --changed-only`":
- *
- *   - One command instead of two — agents reliably run the *one* tool
- *     they're told to run; chained-command workflows get skipped.
- *   - One verdict — no need to OR two separate JSON outputs.
- *   - Stable, narrow schema — designed for agent consumption, not
- *     human terminals. Won't grow flags over time.
- *   - Concrete `nextAction` line — the agent knows exactly what to do
- *     next (declare done, fix N things, or re-run after a manual fix).
- *
- * This is a pure composer — all real logic stays in
- * `@shrkcrft/inspector` and `@shrkcrft/boundaries`. We just stitch
- * their outputs together with consistent scoping.
- */
-import { type ICommandHandler } from '../command-registry.js';
-export declare const diffCheckCommand: ICommandHandler;
-//# sourceMappingURL=diff-check.command.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"diff-check.command.d.ts","sourceRoot":"","sources":["../../src/commands/diff-check.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAcH,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA0GhC,eAAO,MAAM,gBAAgB,EAAE,eAiI9B,CAAC"}

package/dist/commands/diff-check.command.js

@@ -1,210 +0,0 @@
-/**
- * `shrk diff-check` — agent self-validation after edits.
- *
- * The story this command tells:
- *   1. An AI agent (Claude Code, Cursor, etc.) makes some file changes.
- *   2. Before declaring "done", the agent runs `shrk diff-check`.
- *   3. The command scopes both the boundary check and the
- *      import-hygiene check to only the files the agent touched in the
- *      current git diff.
- *   4. The output is a single agent-friendly JSON envelope with a
- *      verdict (ok / warnings / errors) and a one-line next action.
- *
- * Why a new command instead of "just run `shrk check boundaries
- * --changed-only` and `shrk check imports --changed-only`":
- *
- *   - One command instead of two — agents reliably run the *one* tool
- *     they're told to run; chained-command workflows get skipped.
- *   - One verdict — no need to OR two separate JSON outputs.
- *   - Stable, narrow schema — designed for agent consumption, not
- *     human terminals. Won't grow flags over time.
- *   - Concrete `nextAction` line — the agent knows exactly what to do
- *     next (declare done, fix N things, or re-run after a manual fix).
- *
- * This is a pure composer — all real logic stays in
- * `@shrkcrft/inspector` and `@shrkcrft/boundaries`. We just stitch
- * their outputs together with consistent scoping.
- */
-import { buildImportHygieneReport, filterViolationsToChangedScope, inspectSharkcraft, resolveChangedFiles, } from '@shrkcrft/inspector';
-import { evaluateBoundaries, loadTsconfigPaths, scanImports, } from '@shrkcrft/boundaries';
-import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
-import { asJson, bullet, header, kv } from "../output/format-output.js";
-const SCHEMA = 'sharkcraft.diff-check/v1';
-function resolveScope(args, cwd) {
-    const staged = flagBool(args, 'staged');
-    const since = flagString(args, 'since');
-    const filesRaw = flagString(args, 'files');
-    const files = filesRaw
-        ? filesRaw.split(',').map((s) => s.trim()).filter((s) => s.length > 0)
-        : [];
-    if (files.length > 0) {
-        return { mode: 'files', options: { projectRoot: cwd, files } };
-    }
-    if (staged) {
-        return { mode: 'staged', options: { projectRoot: cwd, staged: true } };
-    }
-    if (since) {
-        return { mode: 'since', options: { projectRoot: cwd, since } };
-    }
-    // Default: worktree (== `--changed-only` from `shrk check boundaries`).
-    return {
-        mode: 'worktree',
-        options: { projectRoot: cwd, includeWorktree: true },
-    };
-}
-function deriveVerdict(env) {
-    const bErr = env.boundaries.counts.error;
-    const bWarn = env.boundaries.counts.warning;
-    const iErr = env.imports.verdict === 'errors' ? (env.imports.counts.error ?? env.imports.findings.length) : 0;
-    const iWarn = env.imports.verdict === 'warnings' ? (env.imports.counts.warning ?? env.imports.findings.length) : 0;
-    if (env.scope.fileCount === 0) {
-        return {
-            verdict: 'ok',
-            summary: 'No files changed in the current diff scope.',
-            nextAction: 'Nothing to check. If you expected changes, verify your `--staged` / `--since <ref>` flag or save your edits first.',
-        };
-    }
-    if (bErr > 0 || iErr > 0) {
-        const parts = [];
-        if (bErr > 0)
-            parts.push(`${bErr} boundary violation${bErr === 1 ? '' : 's'}`);
-        if (iErr > 0)
-            parts.push(`${iErr} import-hygiene error${iErr === 1 ? '' : 's'}`);
-        return {
-            verdict: 'errors',
-            summary: `Diff fails the gate: ${parts.join(', ')}.`,
-            nextAction: 'Fix every error in `boundaries.violations` and `imports.findings` (look at each entry\'s `suggestedFix` line), then re-run `shrk diff-check`.',
-        };
-    }
-    if (bWarn > 0 || iWarn > 0) {
-        const parts = [];
-        if (bWarn > 0)
-            parts.push(`${bWarn} boundary warning${bWarn === 1 ? '' : 's'}`);
-        if (iWarn > 0)
-            parts.push(`${iWarn} import-hygiene warning${iWarn === 1 ? '' : 's'}`);
-        return {
-            verdict: 'warnings',
-            summary: `Diff passes the gate with ${parts.join(', ')}.`,
-            nextAction: 'Safe to declare done. Review warnings if the diff touches a sensitive area; otherwise these are non-blocking.',
-        };
-    }
-    return {
-        verdict: 'ok',
-        summary: `Diff passes the gate (${env.scope.fileCount} file${env.scope.fileCount === 1 ? '' : 's'}, 0 violations).`,
-        nextAction: 'Safe to declare done.',
-    };
-}
-export const diffCheckCommand = {
-    name: 'diff-check',
-    description: 'Self-check the current git diff against this project\'s boundary + import-hygiene rules. Single-call composite of `shrk check boundaries --changed-only` + `shrk check imports --changed-only`, with one verdict and one nextAction line. Designed for AI agents to run after editing — pass --json for the structured envelope.',
-    usage: 'shrk [--cwd <dir>] diff-check [--staged | --since <ref> | --files a.ts,b.ts] [--json]',
-    async run(args) {
-        const cwd = resolveCwd(args);
-        const wantJson = flagBool(args, 'json');
-        const { mode, options: scopeOptions } = resolveScope(args, cwd);
-        // 1. Resolve the changed file set once. Both engines re-use it.
-        const changed = resolveChangedFiles(scopeOptions);
-        const changedFiles = changed.files;
-        // 2. Boundary engine — only if rules exist.
-        const inspection = await inspectSharkcraft({ cwd });
-        const rules = inspection.boundaryRegistry.list();
-        let boundaryBlock = {
-            ran: false,
-            rulesEvaluated: 0,
-            counts: { error: 0, warning: 0, info: 0 },
-            violations: [],
-        };
-        if (rules.length > 0 && changedFiles.length > 0) {
-            const scan = scanImports({ projectRoot: cwd });
-            const tsconfigPaths = loadTsconfigPaths(cwd);
-            const evalResult = evaluateBoundaries(scan, rules, {
-                ...(tsconfigPaths.aliases.size > 0 ? { tsconfigPaths } : {}),
-            });
-            const filtered = filterViolationsToChangedScope(evalResult.violations, scopeOptions);
-            boundaryBlock = {
-                ran: true,
-                rulesEvaluated: evalResult.rulesEvaluated,
-                counts: {
-                    error: filtered.includedViolations.filter((v) => v.severity === 'error').length,
-                    warning: filtered.includedViolations.filter((v) => v.severity === 'warning').length,
-                    info: filtered.includedViolations.filter((v) => v.severity === 'info').length,
-                },
-                violations: filtered.includedViolations,
-            };
-        }
-        else if (rules.length > 0 && changedFiles.length === 0) {
-            boundaryBlock = { ...boundaryBlock, ran: true, rulesEvaluated: rules.length };
-        }
-        // 3. Import-hygiene engine — always runs, but scoped to changed files.
-        let importsBlock = {
-            ran: false,
-            verdict: 'skipped',
-            counts: {},
-            findings: [],
-        };
-        if (changedFiles.length > 0) {
-            const report = buildImportHygieneReport(cwd, { files: changedFiles });
-            importsBlock = {
-                ran: true,
-                verdict: report.verdict,
-                counts: report.counts ?? {},
-                findings: report.findings,
-            };
-        }
-        // 4. Build envelope + derive verdict.
-        const partial = {
-            schema: SCHEMA,
-            generatedAt: new Date().toISOString(),
-            scope: {
-                mode,
-                files: changedFiles,
-                fileCount: changedFiles.length,
-            },
-            boundaries: boundaryBlock,
-            imports: importsBlock,
-        };
-        const { verdict, summary, nextAction } = deriveVerdict(partial);
-        const envelope = { ...partial, verdict, summary, nextAction };
-        // 5. Render.
-        if (wantJson) {
-            process.stdout.write(asJson(envelope) + '\n');
-            return verdict === 'errors' ? 1 : 0;
-        }
-        process.stdout.write(header('Diff check'));
-        process.stdout.write(kv('scope', `${envelope.scope.mode} (${envelope.scope.fileCount} file${envelope.scope.fileCount === 1 ? '' : 's'})`) + '\n');
-        process.stdout.write(kv('boundaries', envelope.boundaries.ran
-            ? `${envelope.boundaries.counts.error} errors, ${envelope.boundaries.counts.warning} warnings`
-            : '(no rules configured or no scoped files)') + '\n');
-        process.stdout.write(kv('imports', envelope.imports.ran
-            ? `verdict=${envelope.imports.verdict} (${envelope.imports.findings.length} finding${envelope.imports.findings.length === 1 ? '' : 's'})`
-            : '(no scoped files)') + '\n');
-        process.stdout.write(kv('verdict', envelope.verdict) + '\n');
-        process.stdout.write('\n');
-        process.stdout.write(envelope.summary + '\n');
-        if (envelope.boundaries.violations.length > 0) {
-            process.stdout.write('\nBoundary violations:\n');
-            for (const v of envelope.boundaries.violations.slice(0, 10)) {
-                const file = String(v.file ?? '');
-                const rule = String(v.ruleId ?? '');
-                const fix = v.suggestedFix ? ` — ${String(v.suggestedFix)}` : '';
-                process.stdout.write(bullet(`${rule} in ${file}${fix}`) + '\n');
-            }
-            if (envelope.boundaries.violations.length > 10) {
-                process.stdout.write(`  … and ${envelope.boundaries.violations.length - 10} more (pass --json for full list).\n`);
-            }
-        }
-        if (envelope.imports.findings.length > 0) {
-            process.stdout.write('\nImport findings:\n');
-            for (const f of envelope.imports.findings.slice(0, 10)) {
-                const file = String(f.path ?? f.file ?? '');
-                const kind = String(f.kind ?? '');
-                process.stdout.write(bullet(`${kind} in ${file}`) + '\n');
-            }
-            if (envelope.imports.findings.length > 10) {
-                process.stdout.write(`  … and ${envelope.imports.findings.length - 10} more (pass --json for full list).\n`);
-            }
-        }
-        process.stdout.write(`\nNext: ${envelope.nextAction}\n`);
-        return verdict === 'errors' ? 1 : 0;
-    },
-};

package/dist/export/claude-commands-export.d.ts

@@ -1,60 +0,0 @@
-/**
- * `.claude/commands/` generator — emits per-project slash commands
- * for Claude Code. Companion to `claude-skill` export, but with a
- * different inversion semantics:
- *
- *   - **claude-skill** loads rules into Claude's prompt automatically
- *     based on description match. Passive — Claude reads the rules.
- *   - **claude-commands** registers slash commands the USER invokes
- *     (`/new-service`, `/check-changes`). Active — the command IS the
- *     recipe; Claude follows it step-by-step.
- *
- * Generated commands fall into two buckets:
- *
- * **Static commands** (always present, project-agnostic recipes):
- *   - `/follow-shrk` — short reminder of the apply-gate flow.
- *   - `/check-changes` — runs `shrk check boundaries --changed-only`
- *     scoped to the current diff and reports back.
- *   - `/shrk-brief` — runs `shrk brief` and uses the output for the
- *     current task.
- *   - `/explain-file <path>` — per-file rules / paths / boundary
- *     lookup (pairs with `shrk advise <path>` from Phase 3).
- *
- * **Per-template commands** (one per id in `sharkcraft/templates.ts`):
- *   - `/new-<template-id>` — Claude runs `shrk gen <template-id>
- *     <name> --dry-run --save-plan ...`, reviews the plan, and
- *     applies via `shrk apply ... --verify-signature --validate`.
- *
- * Generated files are self-contained markdown — no `@shrkcrft/*`
- * imports, no shell expansions. Each one is a complete "recipe in a
- * file" that Claude Code reads when the user types the slash command.
- */
-import type { ISharkcraftInspection } from '@shrkcrft/inspector';
-export interface IClaudeCommandFile {
-    /** Path relative to project root (e.g. `.claude/commands/new-service.md`). */
-    path: string;
-    /** Full markdown body, including YAML frontmatter. */
-    content: string;
-    /** The slash name users type (e.g. `new-service` → `/new-service`). */
-    slash: string;
-    /** Why this command was generated — surfaces in the dry-run summary. */
-    source: 'static' | 'template';
-}
-export interface IClaudeCommandsResult {
-    files: readonly IClaudeCommandFile[];
-}
-export interface IClaudeCommandsOptions {
-    /**
-     * Cap on the number of per-template commands to emit. Default 20.
-     * Templates are sorted by id; the first N are kept.
-     */
-    maxTemplateCommands?: number;
-}
-/**
- * Build the full set of `.claude/commands/*.md` files for a project.
- *
- * Pure — caller writes the bytes. Same shape as the `synthesize-*`
- * functions in this codebase: input inspection → output file list.
- */
-export declare function buildClaudeCommands(inspection: ISharkcraftInspection, options?: IClaudeCommandsOptions): IClaudeCommandsResult;
-//# sourceMappingURL=claude-commands-export.d.ts.map

package/dist/export/claude-commands-export.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-commands-export.d.ts","sourceRoot":"","sources":["../../src/export/claude-commands-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtC;AA0MD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAsDvB"}