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

package/dist/output/watch-loop.d.ts

@@ -27,11 +27,19 @@ export interface IWatchPlan {
 }
 export declare function buildWatchPlan(options: IWatchLoopOptions, steps: readonly string[]): IWatchPlan;
 import type { ParsedArgs } from '../command-registry.js';
+export interface IWatchModeOptions {
+    /**
+     * Paths to watch when the user does not pass `--paths`. Defaults to
+     * `['sharkcraft']` if omitted. Use this for commands that scan code
+     * outside `sharkcraft/` (e.g. `check boundaries` scans the whole repo).
+     */
+    defaultPaths?: readonly string[];
+}
 /**
  * Run a command's `run` function inside a watch loop when --watch is set.
  *
  * @returns null if --watch is not set (caller proceeds as before), otherwise
  * the exit code of the watch loop.
  */
-export declare function maybeRunInWatchMode(args: ParsedArgs, runner: (innerArgs: ParsedArgs) => Promise<number>): Promise<number | null>;
+export declare function maybeRunInWatchMode(args: ParsedArgs, runner: (innerArgs: ParsedArgs) => Promise<number>, options?: IWatchModeOptions): Promise<number | null>;
 //# sourceMappingURL=watch-loop.d.ts.map

package/dist/output/watch-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-loop.d.ts","sourceRoot":"","sources":["../../src/output/watch-loop.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6DjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,0BAA0B,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,UAAU,CAYZ;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,GACjD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BxB"}
+{"version":3,"file":"watch-loop.d.ts","sourceRoot":"","sources":["../../src/output/watch-loop.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6DjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,0BAA0B,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,UAAU,CAYZ;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,EAClD,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCxB"}

package/dist/output/watch-loop.js

@@ -81,31 +81,41 @@ export function buildWatchPlan(options, steps) {
         steps,
     };
 }
-import { flagBool, flagNumber, resolveCwd } from "../command-registry.js";
+import { flagBool, flagNumber, flagString, resolveCwd } from "../command-registry.js";
 /**
  * Run a command's `run` function inside a watch loop when --watch is set.
  *
  * @returns null if --watch is not set (caller proceeds as before), otherwise
  * the exit code of the watch loop.
  */
-export async function maybeRunInWatchMode(args, runner) {
+export async function maybeRunInWatchMode(args, runner, options = {}) {
     if (!flagBool(args, 'watch'))
         return null;
     const cwd = resolveCwd(args);
     const debounce = flagNumber(args, 'debounce') ?? 300;
     const once = flagBool(args, 'once');
+    const pathsFlag = flagString(args, 'paths');
+    const userPaths = pathsFlag
+        ? pathsFlag.split(',').map((s) => s.trim()).filter((s) => s.length > 0)
+        : [];
+    const paths = userPaths.length > 0
+        ? userPaths
+        : options.defaultPaths && options.defaultPaths.length > 0
+            ? options.defaultPaths
+            : ['sharkcraft'];
     // Strip --watch so the inner snapshot doesn't recurse.
     const innerFlags = new Map(args.flags);
     innerFlags.delete('watch');
     innerFlags.delete('once');
     innerFlags.delete('debounce');
+    innerFlags.delete('paths');
     const innerArgs = {
         positional: args.positional,
         flags: innerFlags,
         multiFlags: args.multiFlags,
         ...(args.globalCwd ? { globalCwd: args.globalCwd } : {}),
     };
-    return runWatchLoop({ cwd, debounce, once }, {
+    return runWatchLoop({ cwd, debounce, once, paths }, {
         snapshot: async () => {
             const ts = new Date().toLocaleTimeString();
             process.stdout.write(`\n[watch] ${ts}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/cli",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "description": "SharkCraft CLI (`shrk`): structured project intelligence for AI coding agents.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -47,25 +47,25 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.6",
-    "@shrkcrft/config": "^0.1.0-alpha.6",
-    "@shrkcrft/workspace": "^0.1.0-alpha.6",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.6",
-    "@shrkcrft/context": "^0.1.0-alpha.6",
-    "@shrkcrft/rules": "^0.1.0-alpha.6",
-    "@shrkcrft/paths": "^0.1.0-alpha.6",
-    "@shrkcrft/templates": "^0.1.0-alpha.6",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.6",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.6",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.6",
-    "@shrkcrft/presets": "^0.1.0-alpha.6",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.6",
-    "@shrkcrft/generator": "^0.1.0-alpha.6",
-    "@shrkcrft/importer": "^0.1.0-alpha.6",
-    "@shrkcrft/inspector": "^0.1.0-alpha.6",
-    "@shrkcrft/ai": "^0.1.0-alpha.6",
-    "@shrkcrft/shared": "^0.1.0-alpha.6",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.6"
+    "@shrkcrft/core": "^0.1.0-alpha.8",
+    "@shrkcrft/config": "^0.1.0-alpha.8",
+    "@shrkcrft/workspace": "^0.1.0-alpha.8",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.8",
+    "@shrkcrft/context": "^0.1.0-alpha.8",
+    "@shrkcrft/rules": "^0.1.0-alpha.8",
+    "@shrkcrft/paths": "^0.1.0-alpha.8",
+    "@shrkcrft/templates": "^0.1.0-alpha.8",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.8",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.8",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.8",
+    "@shrkcrft/presets": "^0.1.0-alpha.8",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.8",
+    "@shrkcrft/generator": "^0.1.0-alpha.8",
+    "@shrkcrft/importer": "^0.1.0-alpha.8",
+    "@shrkcrft/inspector": "^0.1.0-alpha.8",
+    "@shrkcrft/ai": "^0.1.0-alpha.8",
+    "@shrkcrft/shared": "^0.1.0-alpha.8",
+    "@shrkcrft/mcp-server": "^0.1.0-alpha.8"
   },
   "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"}

package/dist/commands/plugin.command.js

@@ -1,394 +0,0 @@
-/**
- * `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;
-    },
-};