@shrkcrft/cli 0.1.0-alpha.7 → 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.7",
-  "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.7",
-    "@shrkcrft/config": "^0.1.0-alpha.7",
-    "@shrkcrft/workspace": "^0.1.0-alpha.7",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.7",
-    "@shrkcrft/context": "^0.1.0-alpha.7",
-    "@shrkcrft/rules": "^0.1.0-alpha.7",
-    "@shrkcrft/paths": "^0.1.0-alpha.7",
-    "@shrkcrft/templates": "^0.1.0-alpha.7",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.7",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.7",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.7",
-    "@shrkcrft/presets": "^0.1.0-alpha.7",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.7",
-    "@shrkcrft/generator": "^0.1.0-alpha.7",
-    "@shrkcrft/importer": "^0.1.0-alpha.7",
-    "@shrkcrft/inspector": "^0.1.0-alpha.7",
-    "@shrkcrft/ai": "^0.1.0-alpha.7",
-    "@shrkcrft/shared": "^0.1.0-alpha.7",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.7"
+    "@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/init/paths-advisory.d.ts

@@ -1,20 +0,0 @@
-export interface IPathsAdvisory {
-    missingPaths: readonly string[];
-    existingPaths: readonly string[];
-    /** True when an advisory comment was prepended to the file. */
-    annotated: boolean;
-    pathsFile: string;
-}
-/**
- * Scan the generated `sharkcraft/paths.ts` for `path: '<x>'` references
- * and check each `<x>` against the live workspace. When any path is
- * missing, prepend a clearly-labeled comment block listing the missing
- * paths so the user knows which defaults to adjust.
- *
- * Idempotent — if the file already starts with the advisory marker,
- * it is left untouched. Non-destructive — never edits, comments, or
- * removes the original entries. The user is expected to revise them
- * based on the advisory + `shrk onboard --dry-run` output.
- */
-export declare function annotatePathsAgainstDisk(cwd: string, sharkcraftDir: string): IPathsAdvisory;
-//# sourceMappingURL=paths-advisory.d.ts.map

package/dist/init/paths-advisory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths-advisory.d.ts","sourceRoot":"","sources":["../../src/init/paths-advisory.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,GACpB,cAAc,CAwChB"}

package/dist/init/paths-advisory.js

@@ -1,88 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import * as nodePath from 'node:path';
-const ADVISORY_MARKER = '// ⚠️ Workspace-shape advisory (added by `shrk init`):';
-/**
- * Scan the generated `sharkcraft/paths.ts` for `path: '<x>'` references
- * and check each `<x>` against the live workspace. When any path is
- * missing, prepend a clearly-labeled comment block listing the missing
- * paths so the user knows which defaults to adjust.
- *
- * Idempotent — if the file already starts with the advisory marker,
- * it is left untouched. Non-destructive — never edits, comments, or
- * removes the original entries. The user is expected to revise them
- * based on the advisory + `shrk onboard --dry-run` output.
- */
-export function annotatePathsAgainstDisk(cwd, sharkcraftDir) {
-    const pathsFile = nodePath.join(sharkcraftDir, 'paths.ts');
-    if (!existsSync(pathsFile)) {
-        return { missingPaths: [], existingPaths: [], annotated: false, pathsFile };
-    }
-    const original = readFileSync(pathsFile, 'utf8');
-    if (original.startsWith(ADVISORY_MARKER)) {
-        // Already annotated. Re-derive sets for caller diagnostics.
-        return classifyOnly(cwd, pathsFile, original);
-    }
-    const { existing, missing } = classifyPathReferences(cwd, original);
-    if (missing.length === 0) {
-        return {
-            missingPaths: [],
-            existingPaths: existing,
-            annotated: false,
-            pathsFile,
-        };
-    }
-    const lines = [
-        ADVISORY_MARKER,
-        '//',
-        '// The following paths referenced below do NOT exist in this repository:',
-        ...missing.map((p) => `//   - ${p}`),
-        '//',
-        '// They are conservative defaults from the chosen preset. Adjust them to',
-        '// match your actual layout. Run `shrk onboard --dry-run` to see what',
-        '// the inference engine detects from your workspace.',
-        '//',
-        '',
-    ];
-    writeFileSync(pathsFile, lines.join('\n') + original, 'utf8');
-    return {
-        missingPaths: missing,
-        existingPaths: existing,
-        annotated: true,
-        pathsFile,
-    };
-}
-function classifyOnly(cwd, pathsFile, original) {
-    const { existing, missing } = classifyPathReferences(cwd, original);
-    return {
-        missingPaths: missing,
-        existingPaths: existing,
-        annotated: false,
-        pathsFile,
-    };
-}
-function classifyPathReferences(cwd, source) {
-    // Match `path: '<x>'` / `path: "<x>"`. Ignore obvious code-context
-    // references (e.g. inside template literals); we only consume the
-    // first plain-string occurrence per entry.
-    const re = /\bpath\s*:\s*['"]([^'"\n]+)['"]/g;
-    const seen = new Set();
-    let m;
-    while ((m = re.exec(source)) !== null) {
-        if (m[1])
-            seen.add(m[1]);
-    }
-    const existing = [];
-    const missing = [];
-    for (const p of [...seen].sort()) {
-        if (isReachable(cwd, p))
-            existing.push(p);
-        else
-            missing.push(p);
-    }
-    return { existing, missing };
-}
-function isReachable(cwd, p) {
-    // Absolute or rooted-relative — resolve as-is.
-    const full = nodePath.isAbsolute(p) ? p : nodePath.resolve(cwd, p);
-    return existsSync(full);
-}