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

package/dist/commands/init.command.js

@@ -179,10 +179,10 @@ async function applyPresetInit(cwd, mode) {
         renderPathsAdvisory(pathsAdvisory);
     }
     process.stdout.write('\nNext:\n');
-    for (const cmd of preset.recommendedNextCommands ?? [
-        'shrk doctor',
-        'shrk context --task "<task>"',
-    ]) {
+    process.stdout.write(bullet('$ shrk doctor                            — verify the setup (shape-aware verdict)') + '\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 via .claude/skills/') + '\n');
+    for (const cmd of preset.recommendedNextCommands ?? []) {
         process.stdout.write(bullet(`$ ${cmd}`) + '\n');
     }
     process.stdout.write(bullet('Start the MCP server: `shrk mcp serve` (or run it via Claude Code)') + '\n');
@@ -243,13 +243,23 @@ function applyLegacyInit(cwd, force) {
 }
 export const initCommand = {
     name: 'init',
-    description: 'Initialize a sharkcraft/ folder in the current repository. Pass --preset <id> to apply a built-in preset (default: generic). Use --zero-config or --preset auto to detect the workspace and pick a preset automatically. Use --legacy for the full pre-preset seed.',
-    usage: 'shrk init [--preset <id|auto>] [--zero-config] [--dry-run] [--write] [--legacy] [--force] [--merge] [--suggest-only] [--no-gitignore] [--surface-profile <id>]',
+    description: 'Initialize a sharkcraft/ folder in the current repository. Pass --preset <id> to apply a built-in preset (default: generic). Use --zero-config or --preset auto to detect the workspace and pick a preset automatically. Use --legacy for the full pre-preset seed. Pass --infer to scan the repo and populate sharkcraft/* with the real signals it finds (paths from disk, rules from tsconfig/package.json, boundaries from layer structure) — combines with --preset to add inferred entries on top of the preset baseline. Pass --with-claude-skill to also generate .claude/skills/<name>/SKILL.md so Claude Code picks up the rules automatically.',
+    usage: 'shrk init [--preset <id|auto>] [--zero-config] [--infer] [--dry-run] [--write] [--with-claude-skill] [--legacy] [--force] [--merge] [--suggest-only] [--no-gitignore] [--surface-profile <id>]',
     async run(args) {
         const force = flagBool(args, 'force');
         const merge = flagBool(args, 'merge');
         const cwd = resolveCwd(args);
+        const wantInfer = flagBool(args, 'infer');
         const skipGitignore = flagBool(args, 'no-gitignore');
+        // `--infer` mode short-circuits the preset path entirely. The
+        // inferred output IS the populated sharkcraft/*, no preset
+        // baseline to merge against. This is the cleaner contract: the
+        // user opted into "scan my repo and tell me what's there", and
+        // adding a preset's static defaults on top would muddy the
+        // confidence reporting in .inferred-report.md.
+        if (wantInfer) {
+            return runInferInit(cwd, args, force);
+        }
         if (flagBool(args, 'legacy')) {
             const code = applyLegacyInit(cwd, force);
             if (code === 0 && !skipGitignore) {
@@ -310,7 +320,7 @@ export const initCommand = {
         if (dryRun) {
             process.stdout.write(`Surface profile: ${surfaceDecision.profile} (${surfaceDecision.source}) — ${surfaceDecision.reason}\n`);
         }
-        return applyPresetInit(cwd, {
+        const presetCode = await applyPresetInit(cwd, {
             presetId,
             dryRun,
             force,
@@ -320,5 +330,139 @@ export const initCommand = {
             surfaceProfile: surfaceDecision.profile,
             surfaceProfileReason: surfaceDecision.reason,
         });
+        // `--with-claude-skill` chains the claude-skill export onto the init
+        // so a fresh user goes from `npx shrk init --with-claude-skill --write`
+        // to a working .claude/skills/<name>/SKILL.md in one step. Skipped in
+        // dry-run + when init itself didn't succeed.
+        if (presetCode === 0 &&
+            !dryRun &&
+            (flagBool(args, 'with-claude-skill') || flagBool(args, 'with-skill'))) {
+            const skillCode = await runClaudeSkillExportAfterInit(cwd, force);
+            // Init success is what we report; skill failure is logged but
+            // doesn't fail the init exit code (otherwise users would see a
+            // half-applied repo with a non-zero exit and panic).
+            if (skillCode !== 0) {
+                process.stderr.write('\n(claude-skill export failed — re-run `shrk export claude-skill --write` to retry.)\n');
+            }
+        }
+        return presetCode;
     },
 };
+/**
+ * Chain the claude-skill export onto a successful init. Loads the
+ * exporter lazily (it depends on inspectSharkcraft which has its own
+ * caching) and writes the skill file using the same `--force` semantics
+ * as init itself.
+ */
+/**
+ * `shrk init --infer` — scan the repo and populate `sharkcraft/*`
+ * with the real signals it finds, instead of writing preset defaults.
+ *
+ * Pipeline:
+ *   1. `inspectSharkcraft({ cwd })` builds the full inspection.
+ *   2. `buildOnboardingPlan(inspection)` extracts inferred paths,
+ *      rules, boundaries, pipelines, verification commands.
+ *   3. `synthesizeFromOnboarding(plan)` triages each entry by
+ *      confidence and emits populated `sharkcraft/*.ts` files plus
+ *      a companion `.inferred-report.md` + `.inferred-report.json`.
+ *   4. Writer respects `--dry-run` / `--write` / `--force` /
+ *      `--with-claude-skill` semantics consistently with the
+ *      preset-init path.
+ *
+ * Honest-by-default: every adopted entry is tagged with its source
+ * signal; medium-confidence rows get a `// TODO: review` marker; low-
+ * confidence rows are dropped from the populated files and listed in
+ * the report so the user knows exactly what was inferred vs needs
+ * authoring.
+ */
+async function runInferInit(cwd, args, force) {
+    const { inspectSharkcraft, buildOnboardingPlan, synthesizeFromOnboarding } = await import('@shrkcrft/inspector');
+    const dryRun = !flagBool(args, 'write');
+    const sharkcraftDir = nodePath.join(cwd, 'sharkcraft');
+    process.stdout.write(header('SharkCraft init — infer'));
+    process.stdout.write(`Folder: ${sharkcraftDir}\n`);
+    const inspection = await inspectSharkcraft({ cwd });
+    const plan = buildOnboardingPlan(inspection);
+    const result = synthesizeFromOnboarding(plan);
+    // Summary block — print BEFORE writing so the user can ctrl-C if the
+    // confidence triage doesn't look right.
+    process.stdout.write(`\nDetected profiles: ${plan.projectSummary.profiles.join(', ') || '(none)'}\n`);
+    process.stdout.write(`Inference triage: ${result.report.adoptedHigh.length} adopted directly · ` +
+        `${result.report.adoptedMedium.length} marked for review · ` +
+        `${result.report.dropped.length} dropped (in report).\n\n`);
+    const written = [];
+    const skipped = [];
+    const wouldWrite = [];
+    for (const file of result.files) {
+        const fullPath = nodePath.join(sharkcraftDir, file.path);
+        if (dryRun) {
+            wouldWrite.push(file.path);
+            continue;
+        }
+        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 (dryRun) {
+        process.stdout.write('Would write:\n');
+        for (const p of wouldWrite)
+            process.stdout.write(bullet(p) + '\n');
+        process.stdout.write('\nRe-run with --write to persist.\n');
+        return 0;
+    }
+    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 confidence report: \`${nodePath.join('sharkcraft', '.inferred-report.md')}\`\n` +
+        `It lists what was adopted high-confidence, what's marked for your review, ` +
+        `and what shrk can't infer (project-specific decisions you should author by hand).\n`);
+    process.stdout.write('\nNext:\n');
+    process.stdout.write(bullet('$ shrk doctor                            — verify the setup (shape-aware verdict)') + '\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');
+    // Chain claude-skill if requested.
+    if (flagBool(args, 'with-claude-skill') || flagBool(args, 'with-skill')) {
+        const skillCode = await runClaudeSkillExportAfterInit(cwd, force);
+        if (skillCode !== 0) {
+            process.stderr.write('\n(claude-skill export failed — re-run `shrk export claude-skill --write` to retry.)\n');
+        }
+    }
+    // Gitignore + paths advisory same as preset path.
+    const skipGitignore = flagBool(args, 'no-gitignore');
+    if (!skipGitignore) {
+        const patch = ensureSharkcraftGitignore({ cwd, dryRun: false });
+        if (patch.added.length > 0) {
+            process.stdout.write('\n' + renderGitignorePatch(patch, false));
+        }
+    }
+    return 0;
+}
+async function runClaudeSkillExportAfterInit(cwd, force) {
+    const { inspectSharkcraft } = await import('@shrkcrft/inspector');
+    const { renderExport } = await import("../export/export-formats.js");
+    const inspection = await inspectSharkcraft({ cwd });
+    const result = renderExport(inspection, { format: 'claude-skill' });
+    const outputPath = nodePath.join(cwd, result.suggestedPath);
+    mkdirSync(nodePath.dirname(outputPath), { recursive: true });
+    if (existsSync(outputPath) && !force) {
+        process.stdout.write(`\nSkipped claude-skill export — ${result.suggestedPath} already exists. Pass --force to overwrite, or run \`shrk export claude-skill --write --force\`.\n`);
+        return 0;
+    }
+    writeFileSync(outputPath, result.content, 'utf8');
+    process.stdout.write('\n');
+    process.stdout.write(header('Claude-skill exported'));
+    process.stdout.write(`Wrote ${result.suggestedPath}\n` +
+        `  → Claude Code will auto-load this skill in any session opened against this repo.\n`);
+    return 0;
+}

package/dist/commands/packs-new.d.ts

@@ -1,5 +1,5 @@
 import { type ICommandHandler } from '../command-registry.js';
-export type PackKind = 'generic' | 'framework' | 'architecture' | 'enterprise' | 'platform-adopter';
+export type PackKind = 'generic' | 'framework' | 'architecture' | 'enterprise';
 interface IScaffoldFile {
     /** Path relative to the new pack root. */
     relativePath: string;

package/dist/commands/packs-new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packs-new.d.ts","sourceRoot":"","sources":["../../src/commands/packs-new.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,GAAG,kBAAkB,CAAC;AAUpG,UAAU,aAAa;IACrB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CA+G/E;AA4TD,eAAO,MAAM,eAAe,EAAE,eAoG7B,CAAC;AAUF,eAAO,MAAM,gBAAgB,EAAE,eAqI9B,CAAC"}
+{"version":3,"file":"packs-new.d.ts","sourceRoot":"","sources":["../../src/commands/packs-new.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,CAAC;AAS/E,UAAU,aAAa;IACrB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAyG/E;AA0SD,eAAO,MAAM,eAAe,EAAE,eAoG7B,CAAC;AAUF,eAAO,MAAM,gBAAgB,EAAE,eAqI9B,CAAC"}

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,eAmFhC,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 = {

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/search.command.js

@@ -27,7 +27,7 @@ function parseSources(args) {
 }
 export const searchCommand = {
     name: 'search',
-    description: 'Universal search across commands, MCP tools, knowledge, rules, paths, conventions, templates, helpers, playbooks, constructs, policies, decisions, scaffold patterns, contract templates, migration profiles, plugin lifecycle profiles, feedback rules, task routing hints, docs, recent reports. Default emits the 7-section unified output; pass --legacy for the flat output.',
+    description: 'Universal search across commands, MCP tools, knowledge, rules, paths, conventions, templates, helpers, playbooks, constructs, policies, decisions, scaffold patterns, contract templates, migration profiles, feedback rules, task routing hints, docs, recent reports. Default emits the 7-section unified output; pass --legacy for the flat output.',
     usage: 'shrk search <query> [--kind <kind>] [--source local|pack|...] [--limit N] [--explain] [--commands-only] [--actions-only] [--format text|markdown|json] [--legacy]',
     async run(args) {
         // Sub-dispatch for `shrk search tuning [list|doctor]`.

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

@@ -399,22 +399,6 @@ async function collectLikelyFilesV2(input) {
             }
         }
     }
-    // Boost files that sit on registered plugin-lifecycle profile barrels.
-    try {
-        const { listPluginLifecycleProfiles } = await import('@shrkcrft/inspector');
-        const profiles = await listPluginLifecycleProfiles(inspection);
-        for (const entry of profiles) {
-            for (const b of entry.profile.barrels ?? []) {
-                for (const f of [...scoreByPath.keys()]) {
-                    if (f.includes(b.path))
-                        bump(f, 3, `lifecycle profile barrel: ${b.id}`);
-                }
-            }
-        }
-    }
-    catch {
-        // Profile registry unavailable — skip the boost.
-    }
     // 10) Tests — files that look like they test the matched files.
     const tests = [];
     for (const f of [...scoreByPath.keys()]) {

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

@@ -0,0 +1,60 @@
+/**
+ * `.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

@@ -0,0 +1 @@
+{"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"}