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

package/dist/surface/about.js

@@ -8,24 +8,46 @@ import { SHARKCRAFT_VERSION } from '@shrkcrft/shared';
  * `docs/`; this is the in-binary summary.
  */
 export function renderAbout() {
-    return `SharkCraft v${SHARKCRAFT_VERSION} — the safety layer beneath your AI coding agent.
+    return `SharkCraft v${SHARKCRAFT_VERSION}
 
-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
+  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).
 
-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.
+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.
 
-Try:
-  shrk check boundaries --changed-only --since main
-  shrk review packet --v3 --since main
-  shrk mcp install claude-code
+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\`.
 
-Docs: overview.md · safety-model.md · INDEX.md · demo.md
+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
 `;
 }

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,CAiCtE"}
+{"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"}

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} — the safety layer beneath your AI coding agent.`);
+    lines.push(`shrk v${SHARKCRAFT_VERSION} — deterministic context for AI coding agents.`);
     lines.push('');
     let totals = '';
     try {
@@ -21,20 +21,16 @@ export async function renderNoArgsLanding(cwd) {
     }
     lines.push(totals);
     lines.push('');
-    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('Orient:');
-    lines.push('  shrk doctor                 health check + AI-readiness score');
-    lines.push('  shrk recommend "<task>"     what command should I reach for?');
+    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('  shrk --about                the safety contract in one screen');
+    lines.push('');
+    lines.push('See:');
     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;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"}
+{"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"}

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

@@ -72,10 +72,11 @@ function fileExists(p) {
         return false;
     }
 }
-const DEFAULT_CONFIG_BODY = `import { defineSharkCraftConfig } from '@shrkcrft/config';
-
-export default defineSharkCraftConfig({
-});
+// 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 SURFACE_BLOCK_REGEX = /(^\s*surface\s*:\s*\{[\s\S]*?\}\s*,?\s*\n)/m;
 /**
@@ -120,14 +121,25 @@ export function applySurfaceTextEdit(original, surface) {
     if (SURFACE_BLOCK_REGEX.test(original)) {
         return original.replace(SURFACE_BLOCK_REGEX, block);
     }
-    // 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`);
+    // (A) `defineSharkCraftConfig({ ... })` style — insert before the `})`.
+    const closeFn = /(\n)(\}\)\s*;?\s*)$/m;
+    if (closeFn.test(original)) {
+        return original.replace(closeFn, `\n${block}$2`);
     }
-    // Fallback: append at end with a defineSharkCraftConfig wrapper.
-    return `${original}\n${DEFAULT_CONFIG_BODY.replace('})', `${block}})`)}`;
+    // (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}};`)}`;
 }
 /** Default config file path for a project. */
 export function defaultConfigFile(sharkcraftDir) {

package/package.json

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

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

@@ -1,11 +0,0 @@
-import { type ICommandHandler } from '../command-registry.js';
-export declare const pluginRenameCommand: ICommandHandler;
-export declare const pluginRemoveCommand: ICommandHandler;
-export declare const pluginLifecycleListCommand: ICommandHandler;
-export declare const pluginLifecycleInspectCommand: ICommandHandler;
-export declare const pluginLifecycleProfilesCommand: ICommandHandler;
-export declare const pluginLifecycleProfileCommand: ICommandHandler;
-export declare const pluginLifecycleDoctorCommand: ICommandHandler;
-export declare const pluginLifecycleCommand: ICommandHandler;
-export declare const pluginCommand: ICommandHandler;
-//# sourceMappingURL=plugin.command.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.command.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.command.ts"],"names":[],"mappings":"AA+BA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA2BhC,eAAO,MAAM,mBAAmB,EAAE,eAmEjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAkEjC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eAwBxC,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,eAsC3C,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,eA4B5C,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,eAkD3C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,eA0C1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAepC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAc3B,CAAC"}