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

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

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

package/dist/commands/plugin.command.js

@@ -0,0 +1,394 @@
+/**
+ * `shrk plugin` commands, driven by pack/local lifecycle profiles.
+ *
+ * shrk plugin rename <old> <new> [--profile <id>] [--output <plan.json>] [--json]
+ * shrk plugin remove <name>      [--profile <id>] [--output <plan.json>] [--json]
+ * shrk plugin lifecycle list      [--profile <id>] [--json]
+ * shrk plugin lifecycle inspect <name> [--profile <id>] [--json]
+ * shrk plugin lifecycle profiles  [--json]
+ * shrk plugin lifecycle profile <id> [--json]
+ * shrk plugin lifecycle doctor    [--profile <id>] [--json]
+ *
+ * Every command is plan-only by default. Source is never written by these
+ * commands — humans run the regular plan-apply flow with --verify-signature
+ * after reviewing the produced plan.
+ */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { buildPluginLifecycleListing, buildPluginRemovePlan, buildPluginRenamePlan, checkPluginLifecycleProfileHealth, inspectSharkcraft, listPluginLifecycleProfiles, listPluginLifecycleProfileIssues, pluginLifecyclePlanToSavedPlan, renderPluginLifecyclePlanText, resolvePluginLifecycleProfile, } from '@shrkcrft/inspector';
+import { savePlanToFile, signPlan } from '@shrkcrft/generator';
+import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
+import { asJson, header } from "../output/format-output.js";
+function writePlanFile(content, outputArg, cwd) {
+    const abs = nodePath.isAbsolute(outputArg) ? outputArg : nodePath.resolve(cwd, outputArg);
+    mkdirSync(nodePath.dirname(abs), { recursive: true });
+    writeFileSync(abs, content + '\n', 'utf8');
+    return abs;
+}
+async function resolveProfileOrError(cwd, args) {
+    const inspection = await inspectSharkcraft({ cwd });
+    const profileId = flagString(args, 'profile');
+    const resolved = await resolvePluginLifecycleProfile(inspection, {
+        profileId,
+        allowSingleDefault: true,
+    });
+    if (!resolved.entry) {
+        process.stderr.write(`${resolved.error}\n`);
+        return { exitCode: 2 };
+    }
+    return { entry: resolved.entry };
+}
+export const pluginRenameCommand = {
+    name: 'rename',
+    description: 'Generate a plan-only rename plan for a plugin (profile-driven). Never writes source. Plan covers the profile key-table + barrels + folder ops (with --emit-folder-ops). Pass --save-plan <file> to emit a saved plan applicable through `shrk apply --allow-folder-ops`.',
+    usage: 'shrk plugin rename <old> <new> [--profile <id>] [--output <plan.json>] [--emit-folder-ops] [--save-plan <file>] [--sign] [--json]',
+    async run(args) {
+        const oldName = args.positional[0];
+        const newName = args.positional[1];
+        if (!oldName || !newName) {
+            process.stderr.write('Usage: shrk plugin rename <old> <new> [--profile <id>]\n');
+            return 2;
+        }
+        const cwd = resolveCwd(args);
+        const resolved = await resolveProfileOrError(cwd, args);
+        if (!resolved.entry)
+            return resolved.exitCode ?? 2;
+        const plan = buildPluginRenamePlan({
+            projectRoot: cwd,
+            profile: resolved.entry.profile,
+            oldName,
+            newName,
+            ...(flagBool(args, 'emit-folder-ops') ? { emitFolderOps: true } : {}),
+        });
+        const output = flagString(args, 'output');
+        const savePlanPath = flagString(args, 'save-plan');
+        if (savePlanPath) {
+            const saved = pluginLifecyclePlanToSavedPlan(plan, cwd);
+            let toWrite = saved;
+            if (flagBool(args, 'sign')) {
+                const signed = signPlan(toWrite);
+                if (signed.ok)
+                    toWrite = signed.value;
+            }
+            const abs = nodePath.isAbsolute(savePlanPath)
+                ? savePlanPath
+                : nodePath.resolve(cwd, savePlanPath);
+            const writeResult = savePlanToFile(toWrite, abs);
+            if (!writeResult.ok) {
+                process.stderr.write(`Failed to save plan: ${writeResult.error.message}\n`);
+                return 1;
+            }
+            if (!flagBool(args, 'json')) {
+                process.stdout.write(renderPluginLifecyclePlanText(plan));
+                process.stdout.write(`\nSaved plan to ${abs}\nApply: shrk apply ${abs} --allow-folder-ops${plan.action === 'remove' ? ' --allow-delete-folder' : ''} --verify-signature\n`);
+            }
+            else {
+                process.stdout.write(asJson({ saved: abs, plan }) + '\n');
+            }
+            return 0;
+        }
+        if (flagBool(args, 'json')) {
+            const body = asJson(plan);
+            if (output) {
+                const abs = writePlanFile(body, output, cwd);
+                process.stdout.write(`Wrote ${abs}\n`);
+            }
+            else {
+                process.stdout.write(body + '\n');
+            }
+            return 0;
+        }
+        process.stdout.write(renderPluginLifecyclePlanText(plan));
+        if (output) {
+            const abs = writePlanFile(asJson(plan), output, cwd);
+            process.stdout.write(`\nSaved plan to ${abs}\n`);
+        }
+        return 0;
+    },
+};
+export const pluginRemoveCommand = {
+    name: 'remove',
+    description: 'Generate a plan-only remove plan for a plugin (profile-driven). Destructive; requires human approval. Source is never written. Pass --save-plan <file> to emit a saved plan applicable through `shrk apply --allow-folder-ops --allow-delete-folder`.',
+    usage: 'shrk plugin remove <name> [--profile <id>] [--output <plan.json>] [--emit-folder-ops] [--save-plan <file>] [--sign] [--json]',
+    async run(args) {
+        const name = args.positional[0];
+        if (!name) {
+            process.stderr.write('Usage: shrk plugin remove <name> [--profile <id>]\n');
+            return 2;
+        }
+        const cwd = resolveCwd(args);
+        const resolved = await resolveProfileOrError(cwd, args);
+        if (!resolved.entry)
+            return resolved.exitCode ?? 2;
+        const plan = buildPluginRemovePlan({
+            projectRoot: cwd,
+            profile: resolved.entry.profile,
+            oldName: name,
+            ...(flagBool(args, 'emit-folder-ops') ? { emitFolderOps: true } : {}),
+        });
+        const output = flagString(args, 'output');
+        const savePlanPath = flagString(args, 'save-plan');
+        if (savePlanPath) {
+            const saved = pluginLifecyclePlanToSavedPlan(plan, cwd);
+            let toWrite = saved;
+            if (flagBool(args, 'sign')) {
+                const signed = signPlan(toWrite);
+                if (signed.ok)
+                    toWrite = signed.value;
+            }
+            const abs = nodePath.isAbsolute(savePlanPath)
+                ? savePlanPath
+                : nodePath.resolve(cwd, savePlanPath);
+            const writeResult = savePlanToFile(toWrite, abs);
+            if (!writeResult.ok) {
+                process.stderr.write(`Failed to save plan: ${writeResult.error.message}\n`);
+                return 1;
+            }
+            if (!flagBool(args, 'json')) {
+                process.stdout.write(renderPluginLifecyclePlanText(plan));
+                process.stdout.write(`\n⚠ DESTRUCTIVE — saved plan written to ${abs}\nApply: shrk apply ${abs} --allow-folder-ops --allow-delete-folder --verify-signature\n`);
+            }
+            else {
+                process.stdout.write(asJson({ saved: abs, plan }) + '\n');
+            }
+            return 0;
+        }
+        if (flagBool(args, 'json')) {
+            const body = asJson(plan);
+            if (output) {
+                const abs = writePlanFile(body, output, cwd);
+                process.stdout.write(`Wrote ${abs}\n`);
+            }
+            else {
+                process.stdout.write(body + '\n');
+            }
+            return 0;
+        }
+        process.stdout.write(renderPluginLifecyclePlanText(plan));
+        process.stdout.write('\n⚠ DESTRUCTIVE — human approval required before any of these steps.\n');
+        if (output) {
+            const abs = writePlanFile(asJson(plan), output, cwd);
+            process.stdout.write(`\nSaved plan to ${abs}\n`);
+        }
+        return 0;
+    },
+};
+export const pluginLifecycleListCommand = {
+    name: 'list',
+    description: 'List plugins detected under the profile plugin roots + profile key-table entries.',
+    usage: 'shrk plugin lifecycle list [--profile <id>] [--json]',
+    async run(args) {
+        const cwd = resolveCwd(args);
+        const resolved = await resolveProfileOrError(cwd, args);
+        if (!resolved.entry)
+            return resolved.exitCode ?? 2;
+        const listing = buildPluginLifecycleListing({ projectRoot: cwd, profile: resolved.entry.profile });
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(listing) + '\n');
+            return 0;
+        }
+        process.stdout.write(header(`Plugins by layer (profile=${resolved.entry.profile.id})`));
+        for (const [layer, names] of Object.entries(listing.pluginsByLayer)) {
+            process.stdout.write(`  ${layer} (${names.length})\n`);
+            for (const n of names)
+                process.stdout.write(`    • ${n}\n`);
+        }
+        process.stdout.write(header('Key table'));
+        for (const k of listing.pluginKeys) {
+            process.stdout.write(`  ${k.key.padEnd(28)} '${k.value}'\n`);
+        }
+        return 0;
+    },
+};
+export const pluginLifecycleInspectCommand = {
+    name: 'inspect',
+    description: 'Inspect a plugin: which layers reference it, key-table entry, barrels.',
+    usage: 'shrk plugin lifecycle inspect <name> [--profile <id>] [--json]',
+    async run(args) {
+        const name = args.positional[0];
+        if (!name) {
+            process.stderr.write('Usage: shrk plugin lifecycle inspect <name>\n');
+            return 2;
+        }
+        const cwd = resolveCwd(args);
+        const resolved = await resolveProfileOrError(cwd, args);
+        if (!resolved.entry)
+            return resolved.exitCode ?? 2;
+        const listing = buildPluginLifecycleListing({ projectRoot: cwd, profile: resolved.entry.profile });
+        const presentInLayers = Object.entries(listing.pluginsByLayer)
+            .filter(([, names]) => names.includes(name))
+            .map(([layer]) => layer);
+        const keyEntry = listing.pluginKeys.find((k) => k.value === name);
+        const report = {
+            name,
+            profile: resolved.entry.profile.id,
+            presentInLayers,
+            pluginKeysEntry: keyEntry ?? null,
+        };
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(report) + '\n');
+            return 0;
+        }
+        process.stdout.write(header(`Plugin inspect: ${name}`));
+        process.stdout.write(`  profile      ${resolved.entry.profile.id}\n`);
+        process.stdout.write(`  layers       ${presentInLayers.length > 0 ? presentInLayers.join(', ') : '(none)'}\n`);
+        process.stdout.write(`  key entry    ${keyEntry ? `${keyEntry.key} = '${keyEntry.value}'` : '(not registered)'}\n`);
+        return 0;
+    },
+};
+export const pluginLifecycleProfilesCommand = {
+    name: 'profiles',
+    description: 'List registered plugin lifecycle profiles (pack + local).',
+    usage: 'shrk plugin lifecycle profiles [--json]',
+    async run(args) {
+        const cwd = resolveCwd(args);
+        const inspection = await inspectSharkcraft({ cwd });
+        const entries = await listPluginLifecycleProfiles(inspection);
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(entries) + '\n');
+            return 0;
+        }
+        process.stdout.write(header('Plugin lifecycle profiles'));
+        if (entries.length === 0) {
+            process.stdout.write('  (none registered — contribute via a pack manifest "pluginLifecycleProfileFiles" entry or sharkcraft/plugin-lifecycle-profiles.ts)\n');
+            return 0;
+        }
+        for (const e of entries) {
+            const src = e.source === 'pack' ? `pack:${e.packageName}` : e.source;
+            process.stdout.write(`  • ${e.profile.id.padEnd(20)} ${e.profile.title}  [${src}]\n`);
+            if (e.profile.description) {
+                process.stdout.write(`      ${e.profile.description}\n`);
+            }
+        }
+        return 0;
+    },
+};
+export const pluginLifecycleProfileCommand = {
+    name: 'profile',
+    description: 'Show a single plugin lifecycle profile.',
+    usage: 'shrk plugin lifecycle profile <id> [--json]',
+    async run(args) {
+        const id = args.positional[0];
+        if (!id) {
+            process.stderr.write('Usage: shrk plugin lifecycle profile <id>\n');
+            return 2;
+        }
+        const cwd = resolveCwd(args);
+        const inspection = await inspectSharkcraft({ cwd });
+        const entries = await listPluginLifecycleProfiles(inspection);
+        const entry = entries.find((e) => e.profile.id === id);
+        if (!entry) {
+            process.stderr.write(`Unknown profile "${id}". Available: ${entries.length === 0 ? '(none)' : entries.map((e) => e.profile.id).join(', ')}.\n`);
+            return 2;
+        }
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(entry) + '\n');
+            return 0;
+        }
+        process.stdout.write(header(`Profile ${entry.profile.id}`));
+        process.stdout.write(`  title         ${entry.profile.title}\n`);
+        if (entry.profile.description)
+            process.stdout.write(`  description   ${entry.profile.description}\n`);
+        process.stdout.write(`  source        ${entry.source}${entry.packageName ? ' (' + entry.packageName + ')' : ''}\n`);
+        process.stdout.write(`  sourceFile    ${entry.sourceFile}\n`);
+        process.stdout.write(`  pluginRoots:\n`);
+        for (const r of entry.profile.pluginRoots) {
+            process.stdout.write(`    • ${r.id.padEnd(12)} ${r.path}${r.kind ? ' [' + r.kind + ']' : ''}\n`);
+        }
+        if (entry.profile.barrels && entry.profile.barrels.length > 0) {
+            process.stdout.write(`  barrels:\n`);
+            for (const b of entry.profile.barrels) {
+                process.stdout.write(`    • ${b.id.padEnd(12)} ${b.path}\n`);
+            }
+        }
+        if (entry.profile.keyTable) {
+            process.stdout.write(`  keyTable      ${entry.profile.keyTable.path} (key=${entry.profile.keyTable.keyCase} value=${entry.profile.keyTable.valueCase})\n`);
+        }
+        if (entry.profile.validationCommands && entry.profile.validationCommands.length > 0) {
+            process.stdout.write(`  validation:\n`);
+            for (const c of entry.profile.validationCommands)
+                process.stdout.write(`    $ ${c}\n`);
+        }
+        return 0;
+    },
+};
+export const pluginLifecycleDoctorCommand = {
+    name: 'doctor',
+    description: 'Lifecycle-profile doctor: surface load issues + check profile paths exist.',
+    usage: 'shrk plugin lifecycle doctor [--profile <id>] [--json]',
+    async run(args) {
+        const cwd = resolveCwd(args);
+        const inspection = await inspectSharkcraft({ cwd });
+        const profileId = flagString(args, 'profile');
+        const issues = [...(await listPluginLifecycleProfileIssues(inspection))];
+        const healthByProfile = {};
+        const entries = await listPluginLifecycleProfiles(inspection);
+        const targets = profileId ? entries.filter((e) => e.profile.id === profileId) : entries;
+        if (profileId && targets.length === 0) {
+            process.stderr.write(`Unknown profile "${profileId}". Available: ${entries.map((e) => e.profile.id).join(', ') || '(none)'}.\n`);
+            return 2;
+        }
+        for (const e of targets) {
+            healthByProfile[e.profile.id] = checkPluginLifecycleProfileHealth(cwd, e.profile);
+        }
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson({ registryIssues: issues, healthByProfile }) + '\n');
+            return 0;
+        }
+        process.stdout.write(header('Lifecycle profile doctor'));
+        if (issues.length === 0) {
+            process.stdout.write('  Registry: ok (no load issues)\n');
+        }
+        else {
+            process.stdout.write(`  Registry issues (${issues.length}):\n`);
+            for (const i of issues) {
+                process.stdout.write(`    ${i.severity.padEnd(7)} [${i.code}] ${i.message}\n`);
+            }
+        }
+        for (const [id, checks] of Object.entries(healthByProfile)) {
+            process.stdout.write(`\n  ${id}:\n`);
+            for (const c of checks) {
+                process.stdout.write(`    ${c.severity.padEnd(7)} ${c.message}\n`);
+            }
+        }
+        return 0;
+    },
+};
+export const pluginLifecycleCommand = {
+    name: 'lifecycle',
+    description: 'Inspect / list profile-driven plugins; manage lifecycle profiles.',
+    usage: 'shrk plugin lifecycle list|inspect|profiles|profile|doctor ...',
+    async run(args) {
+        const sub = args.positional[0];
+        args.positional = args.positional.slice(1);
+        if (sub === 'list')
+            return pluginLifecycleListCommand.run(args);
+        if (sub === 'inspect')
+            return pluginLifecycleInspectCommand.run(args);
+        if (sub === 'profiles')
+            return pluginLifecycleProfilesCommand.run(args);
+        if (sub === 'profile')
+            return pluginLifecycleProfileCommand.run(args);
+        if (sub === 'doctor')
+            return pluginLifecycleDoctorCommand.run(args);
+        process.stderr.write('Usage: shrk plugin lifecycle list|inspect|profiles|profile|doctor ...\n');
+        return 2;
+    },
+};
+export const pluginCommand = {
+    name: 'plugin',
+    description: 'Plugin lifecycle helpers (profile-driven). Plan-only — every command emits a structured plan that a human must review and apply.',
+    usage: 'shrk plugin rename|remove|lifecycle ...',
+    async run(args) {
+        const sub = args.positional[0];
+        args.positional = args.positional.slice(1);
+        if (sub === 'rename')
+            return pluginRenameCommand.run(args);
+        if (sub === 'remove')
+            return pluginRemoveCommand.run(args);
+        if (sub === 'lifecycle')
+            return pluginLifecycleCommand.run(args);
+        process.stderr.write('Usage: shrk plugin rename|remove|lifecycle ...\n');
+        return 2;
+    },
+};

package/dist/commands/profiles.command.js

@@ -1,6 +1,6 @@
 /**
  * `shrk profiles ...` — unified read-only surface for all pack-/local-
- * contributed profiles (migration, and future kinds).
+ * contributed profiles (plugin lifecycle, 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 (migration, ...).',
+    description: 'List all registered profiles (plugin-lifecycle, 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: migrationProfileFiles, etc.)\n');
+            process.stdout.write('  (none — contribute via packs: pluginLifecycleProfileFiles, 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 (migration, conventions, …).',
+    description: 'List / inspect pack-contributed profiles (plugin-lifecycle, 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 consumer target replaces the previous hardcoded project target.
-const BUILTIN_TARGET_IDS = ['sharkcraft', 'dogfood', 'synthetic', 'consumer'];
+// Generic adopter target replaces the previous hardcoded project target.
+const BUILTIN_TARGET_IDS = ['sharkcraft', 'dogfood', 'synthetic', 'adopter'];
 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('consumer')) {
-        const consumerRoot = flagString(args, 'consumer-root') ??
-            process.env['SHARKCRAFT_CONSUMER_ROOT'] ??
+    if (want('adopter')) {
+        const adopterRoot = flagString(args, 'adopter-root') ??
+            process.env['SHARKCRAFT_ADOPTER_ROOT'] ??
             '';
-        if (consumerRoot && existsSync(consumerRoot)) {
-            out.push({ id: 'consumer', cwd: consumerRoot, label: `consumer:${consumerRoot}` });
+        if (adopterRoot && existsSync(adopterRoot)) {
+            out.push({ id: 'adopter', cwd: adopterRoot, label: `adopter:${adopterRoot}` });
         }
         else {
             out.push({
-                id: 'consumer',
-                cwd: consumerRoot || '(unset)',
-                label: 'consumer target',
-                warning: 'Consumer root not set (pass --consumer-root or set SHARKCRAFT_CONSUMER_ROOT) — skipped.',
+                id: 'adopter',
+                cwd: adopterRoot || '(unset)',
+                label: 'adopter target',
+                warning: 'Adopter root not set (pass --adopter-root or set SHARKCRAFT_ADOPTER_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).
- *  - `consumer` runs the read-only scenarios that don't write outside the
+ *  - `adopter` 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 === 'consumer') {
+    if (target.id === 'adopter') {
         return scenario === 'unconfigured-repo' || scenario === 'pack-authoring' || scenario === 'governance';
     }
     return true;

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

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

package/dist/commands/review.command.js

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

package/dist/commands/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, 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, plugin lifecycle 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,6 +399,22 @@ 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/export-formats.d.ts

@@ -1,5 +1,5 @@
 import type { ISharkcraftInspection } from '@shrkcrft/inspector';
-export type ExportFormat = 'agents-md' | 'claude-md' | 'claude-skill' | 'cursor-rules' | 'copilot-instructions';
+export type ExportFormat = 'agents-md' | 'claude-md' | 'cursor-rules' | 'copilot-instructions';
 export interface ExportOptions {
     format: ExportFormat;
     /** Optional task to scope the export. */

package/dist/export/export-formats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-formats.d.ts","sourceRoot":"","sources":["../../src/export/export-formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,WAAW,GACX,cAAc,GACd,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqPD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,qBAAqB,EACjC,OAAO,EAAE,aAAa,GACrB,YAAY,CAmCd;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAQnE;AAED,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAMpD,CAAC"}
+{"version":3,"file":"export-formats.d.ts","sourceRoot":"","sources":["../../src/export/export-formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,WAAW,GACX,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqHD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,qBAAqB,EACjC,OAAO,EAAE,aAAa,GACrB,YAAY,CAsBd;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAOnE;AAED,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAKpD,CAAC"}