@kb-labs/devlink-cli 1.4.0

package/dist/cli/commands/backups.d.ts

@@ -0,0 +1,20 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { DevlinkBackup } from '@kb-labs/devlink-contracts';
+
+interface BackupsFlags {
+    restore?: string;
+    json?: boolean;
+}
+interface BackupsInput {
+    argv?: string[];
+    flags?: BackupsFlags;
+    restore?: string;
+    json?: boolean;
+}
+interface BackupsResult {
+    backups: DevlinkBackup[];
+    restored?: number;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, BackupsInput, BackupsResult>;
+
+export { _default as default };

package/dist/cli/commands/backups.js

@@ -0,0 +1,66 @@
+import { defineCommand, TimingTracker, useLoader } from '@kb-labs/sdk';
+import { restoreBackup, listBackups } from '@kb-labs/devlink-core';
+
+// src/cli/commands/backups.ts
+var backups_default = defineCommand({
+  id: "devlink:backups",
+  description: "List and restore backups",
+  handler: {
+    async execute(ctx, input) {
+      const tracker = new TimingTracker();
+      const flags = input.flags ?? input;
+      const outputJson = flags.json ?? false;
+      const restoreId = flags.restore;
+      const rootDir = ctx.cwd ?? process.cwd();
+      if (restoreId) {
+        const loader = useLoader(`Restoring backup ${restoreId}...`);
+        loader.start();
+        const { restored, errors } = restoreBackup(rootDir, restoreId);
+        loader.succeed(`Restored ${restored} file(s)`);
+        tracker.checkpoint("restore");
+        const backups2 = listBackups(rootDir);
+        const result2 = { backups: backups2, restored };
+        if (outputJson) {
+          ctx.ui?.json?.(result2);
+        } else {
+          ctx.ui?.success?.(`Restored ${restored} file(s) from backup ${restoreId}`, {
+            title: "DevLink \u2014 Restore Backup",
+            sections: [
+              ...errors.length > 0 ? [{ header: "Errors", items: errors }] : [],
+              { header: "Next step", items: ["Run pnpm install to apply changes"] }
+            ],
+            timing: tracker.total()
+          });
+        }
+        return { exitCode: 0, result: result2, meta: { timing: tracker.total() } };
+      }
+      const backups = listBackups(rootDir);
+      tracker.checkpoint("list");
+      const result = { backups };
+      if (outputJson) {
+        ctx.ui?.json?.(result);
+      } else {
+        if (backups.length === 0) {
+          ctx.ui?.info?.("No backups found. Backups are created automatically before each switch.");
+        } else {
+          const items = backups.map(
+            (b) => `[${b.id}] ${b.timestamp.slice(0, 19).replace("T", " ")} \u2014 ${b.description} (${b.files.length} files)`
+          );
+          ctx.ui?.success?.(`${backups.length} backup(s) available`, {
+            title: "DevLink \u2014 Backups",
+            sections: [
+              { header: "Backups (newest first)", items },
+              { header: "Restore", items: ["kb devlink backups --restore <id>"] }
+            ],
+            timing: tracker.total()
+          });
+        }
+      }
+      return { exitCode: 0, result, meta: { timing: tracker.total() } };
+    }
+  }
+});
+
+export { backups_default as default };
+//# sourceMappingURL=backups.js.map
+//# sourceMappingURL=backups.js.map

package/dist/cli/commands/backups.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/backups.ts"],"names":["backups","result"],"mappings":"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","file":"backups.js","sourcesContent":["import { defineCommand, useLoader, TimingTracker, type PluginContextV3, type CommandResult } from '@kb-labs/sdk';\nimport { listBackups, restoreBackup } from '@kb-labs/devlink-core';\nimport type { DevlinkBackup } from '@kb-labs/devlink-contracts';\n\ninterface BackupsFlags {\n  restore?: string;\n  json?: boolean;\n}\n\ninterface BackupsInput {\n  argv?: string[];\n  flags?: BackupsFlags;\n  restore?: string;\n  json?: boolean;\n}\n\ninterface BackupsResult {\n  backups: DevlinkBackup[];\n  restored?: number;\n}\n\nexport default defineCommand<unknown, BackupsInput, BackupsResult>({\n  id: 'devlink:backups',\n  description: 'List and restore backups',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: BackupsInput): Promise<CommandResult<BackupsResult>> {\n      const tracker = new TimingTracker();\n      const flags = (input.flags ?? input) as BackupsFlags;\n      const outputJson = flags.json ?? false;\n      const restoreId = flags.restore;\n\n      const rootDir = ctx.cwd ?? process.cwd();\n\n      // ─── Restore mode ────────────────────────────────────────────────────────\n      if (restoreId) {\n        const loader = useLoader(`Restoring backup ${restoreId}...`);\n        loader.start();\n\n        const { restored, errors } = restoreBackup(rootDir, restoreId);\n        loader.succeed(`Restored ${restored} file(s)`);\n        tracker.checkpoint('restore');\n\n        const backups = listBackups(rootDir);\n        const result: BackupsResult = { backups, restored };\n\n        if (outputJson) {\n          ctx.ui?.json?.(result);\n        } else {\n          ctx.ui?.success?.(`Restored ${restored} file(s) from backup ${restoreId}`, {\n            title: 'DevLink — Restore Backup',\n            sections: [\n              ...(errors.length > 0 ? [{ header: 'Errors', items: errors }] : []),\n              { header: 'Next step', items: ['Run pnpm install to apply changes'] },\n            ],\n            timing: tracker.total(),\n          });\n        }\n\n        return { exitCode: 0, result, meta: { timing: tracker.total() } };\n      }\n\n      // ─── List mode ───────────────────────────────────────────────────────────\n      const backups = listBackups(rootDir);\n      tracker.checkpoint('list');\n\n      const result: BackupsResult = { backups };\n\n      if (outputJson) {\n        ctx.ui?.json?.(result);\n      } else {\n        if (backups.length === 0) {\n          ctx.ui?.info?.('No backups found. Backups are created automatically before each switch.');\n        } else {\n          const items = backups.map(b =>\n            `[${b.id}] ${b.timestamp.slice(0, 19).replace('T', ' ')} — ${b.description} (${b.files.length} files)`\n          );\n          ctx.ui?.success?.(`${backups.length} backup(s) available`, {\n            title: 'DevLink — Backups',\n            sections: [\n              { header: 'Backups (newest first)', items },\n              { header: 'Restore', items: ['kb devlink backups --restore <id>'] },\n            ],\n            timing: tracker.total(),\n          });\n        }\n      }\n\n      return { exitCode: 0, result, meta: { timing: tracker.total() } };\n    },\n  },\n});\n"]}

package/dist/cli/commands/freeze.d.ts

@@ -0,0 +1,14 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { LockFile } from '@kb-labs/devlink-core';
+
+interface FreezeFlags {
+    json?: boolean;
+}
+interface FreezeInput {
+    argv?: string[];
+    flags?: FreezeFlags;
+    json?: boolean;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, FreezeInput, LockFile>;
+
+export { _default as default };

package/dist/cli/commands/freeze.js

@@ -0,0 +1,49 @@
+import { defineCommand, TimingTracker, useLoader } from '@kb-labs/sdk';
+import { loadState, discoverMonorepos, buildPackageMapFiltered, buildPlan, freeze } from '@kb-labs/devlink-core';
+
+// src/cli/commands/freeze.ts
+var freeze_default = defineCommand({
+  id: "devlink:freeze",
+  description: "Freeze current dependency state to lock file",
+  handler: {
+    async execute(ctx, input) {
+      const tracker = new TimingTracker();
+      const flags = input.flags ?? input;
+      const outputJson = flags.json ?? false;
+      const rootDir = ctx.cwd ?? process.cwd();
+      const loader = useLoader("Freezing current state...");
+      loader.start();
+      const state = loadState(rootDir);
+      const monorepos = discoverMonorepos(rootDir);
+      const currentMode = state.currentMode ?? "npm";
+      const packageMap = await buildPackageMapFiltered(monorepos, rootDir, void 0, currentMode);
+      const plan = buildPlan(currentMode, packageMap, monorepos, rootDir);
+      const lock = freeze(rootDir, plan);
+      loader.succeed("State frozen");
+      tracker.checkpoint("freeze");
+      if (outputJson) {
+        ctx.ui?.json?.(lock);
+      } else {
+        ctx.ui?.success?.("Current state frozen to lock file", {
+          title: "DevLink \u2014 Freeze",
+          sections: [
+            {
+              header: "Lock file",
+              items: [
+                `Mode: ${lock.plan.mode}`,
+                `Frozen at: ${lock.frozenAt}`,
+                `Location: .kb/devlink/lock.json`
+              ]
+            }
+          ],
+          timing: tracker.total()
+        });
+      }
+      return { exitCode: 0, result: lock, meta: { timing: tracker.total() } };
+    }
+  }
+});
+
+export { freeze_default as default };
+//# sourceMappingURL=freeze.js.map
+//# sourceMappingURL=freeze.js.map

package/dist/cli/commands/freeze.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/freeze.ts"],"names":[],"mappings":";;;;AAcA,IAAO,iBAAQ,aAAA,CAA8C;AAAA,EAC3D,EAAA,EAAI,gBAAA;AAAA,EACJ,WAAA,EAAa,8CAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAsD;AACxF,MAAA,MAAM,OAAA,GAAU,IAAI,aAAA,EAAc;AAClC,MAAA,MAAM,KAAA,GAAS,MAAM,KAAA,IAAS,KAAA;AAC9B,MAAA,MAAM,UAAA,GAAa,MAAM,IAAA,IAAQ,KAAA;AAEjC,MAAA,MAAM,OAAA,GAAU,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEvC,MAAA,MAAM,MAAA,GAAS,UAAU,2BAA2B,CAAA;AACpD,MAAA,MAAA,CAAO,KAAA,EAAM;AAEb,MAAA,MAAM,KAAA,GAAQ,UAAU,OAAO,CAAA;AAC/B,MAAA,MAAM,SAAA,GAAY,kBAAkB,OAAO,CAAA;AAG3C,MAAA,MAAM,WAAA,GAAc,MAAM,WAAA,IAAe,KAAA;AACzC,MAAA,MAAM,aAAa,MAAM,uBAAA,CAAwB,SAAA,EAAW,OAAA,EAAS,QAAW,WAAW,CAAA;AAC3F,MAAA,MAAM,IAAA,GAAO,SAAA,CAAU,WAAA,EAAa,UAAA,EAAY,WAAW,OAAO,CAAA;AAElE,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,OAAA,EAAS,IAAI,CAAA;AACjC,MAAA,MAAA,CAAO,QAAQ,cAAc,CAAA;AAC7B,MAAA,OAAA,CAAQ,WAAW,QAAQ,CAAA;AAE3B,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,OAAO,IAAI,CAAA;AAAA,MACrB,CAAA,MAAO;AACL,QAAA,GAAA,CAAI,EAAA,EAAI,UAAU,mCAAA,EAAqC;AAAA,UACrD,KAAA,EAAO,uBAAA;AAAA,UACP,QAAA,EAAU;AAAA,YACR;AAAA,cACE,MAAA,EAAQ,WAAA;AAAA,cACR,KAAA,EAAO;AAAA,gBACL,CAAA,MAAA,EAAS,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,CAAA;AAAA,gBACvB,CAAA,WAAA,EAAc,KAAK,QAAQ,CAAA,CAAA;AAAA,gBAC3B,CAAA,+BAAA;AAAA;AACF;AACF,WACF;AAAA,UACA,MAAA,EAAQ,QAAQ,KAAA;AAAM,SACvB,CAAA;AAAA,MACH;AAEA,MAAA,OAAO,EAAE,QAAA,EAAU,CAAA,EAAG,MAAA,EAAQ,IAAA,EAAM,IAAA,EAAM,EAAE,MAAA,EAAQ,OAAA,CAAQ,KAAA,EAAM,EAAE,EAAE;AAAA,IACxE;AAAA;AAEJ,CAAC","file":"freeze.js","sourcesContent":["import { defineCommand, useLoader, TimingTracker, type PluginContextV3, type CommandResult } from '@kb-labs/sdk';\nimport { discoverMonorepos, buildPackageMapFiltered, buildPlan, freeze, loadState } from '@kb-labs/devlink-core';\nimport type { LockFile } from '@kb-labs/devlink-core';\n\ninterface FreezeFlags {\n  json?: boolean;\n}\n\ninterface FreezeInput {\n  argv?: string[];\n  flags?: FreezeFlags;\n  json?: boolean;\n}\n\nexport default defineCommand<unknown, FreezeInput, LockFile>({\n  id: 'devlink:freeze',\n  description: 'Freeze current dependency state to lock file',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: FreezeInput): Promise<CommandResult<LockFile>> {\n      const tracker = new TimingTracker();\n      const flags = (input.flags ?? input) as FreezeFlags;\n      const outputJson = flags.json ?? false;\n\n      const rootDir = ctx.cwd ?? process.cwd();\n\n      const loader = useLoader('Freezing current state...');\n      loader.start();\n\n      const state = loadState(rootDir);\n      const monorepos = discoverMonorepos(rootDir);\n\n      // Build a plan that reflects current state (no-op plan for the current mode)\n      const currentMode = state.currentMode ?? 'npm';\n      const packageMap = await buildPackageMapFiltered(monorepos, rootDir, undefined, currentMode);\n      const plan = buildPlan(currentMode, packageMap, monorepos, rootDir);\n\n      const lock = freeze(rootDir, plan);\n      loader.succeed('State frozen');\n      tracker.checkpoint('freeze');\n\n      if (outputJson) {\n        ctx.ui?.json?.(lock);\n      } else {\n        ctx.ui?.success?.('Current state frozen to lock file', {\n          title: 'DevLink — Freeze',\n          sections: [\n            {\n              header: 'Lock file',\n              items: [\n                `Mode: ${lock.plan.mode}`,\n                `Frozen at: ${lock.frozenAt}`,\n                `Location: .kb/devlink/lock.json`,\n              ],\n            },\n          ],\n          timing: tracker.total(),\n        });\n      }\n\n      return { exitCode: 0, result: lock, meta: { timing: tracker.total() } };\n    },\n  },\n});\n"]}

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,32 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { DevlinkMode } from '@kb-labs/devlink-contracts';
+
+interface PlanFlags {
+    mode?: DevlinkMode;
+    repos?: string;
+    json?: boolean;
+    ttl?: number;
+}
+interface PlanInput {
+    argv?: string[];
+    flags?: PlanFlags;
+    mode?: DevlinkMode;
+    repos?: string;
+    json?: boolean;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, PlanInput, {
+    mode: "local" | "npm" | "auto";
+    items: {
+        monorepo: string;
+        packageJsonPath: string;
+        packageJsonRel: string;
+        depName: string;
+        from: string;
+        to: string;
+        section: "dependencies" | "devDependencies" | "peerDependencies";
+    }[];
+    timestamp: string;
+    scopedRepos?: string[] | undefined;
+}>;
+
+export { _default as default };

package/dist/cli/commands/plan.js

@@ -0,0 +1,75 @@
+import { defineCommand, TimingTracker, useLoader } from '@kb-labs/sdk';
+import { loadState, discoverMonorepos, buildPackageMapFiltered, buildPlan, groupByMonorepo } from '@kb-labs/devlink-core';
+
+// src/cli/commands/plan.ts
+var plan_default = defineCommand({
+  id: "devlink:plan",
+  description: "Preview what would change when switching mode",
+  handler: {
+    async execute(ctx, input) {
+      const tracker = new TimingTracker();
+      const flags = input.flags ?? input;
+      const outputJson = flags.json ?? false;
+      const scopedRepos = flags.repos ? flags.repos.split(",").map((s) => s.trim()) : void 0;
+      const ttlMs = (flags.ttl ?? 24) * 60 * 60 * 1e3;
+      const rootDir = ctx.cwd ?? process.cwd();
+      const loader = useLoader("Building plan...");
+      loader.start();
+      const state = loadState(rootDir);
+      const monorepos = discoverMonorepos(rootDir);
+      const targetMode = flags.mode ?? (state.currentMode === "npm" ? "local" : "npm");
+      const packageMap = await buildPackageMapFiltered(monorepos, rootDir, ttlMs, targetMode);
+      const plan = buildPlan(targetMode, packageMap, monorepos, rootDir, { scopedRepos });
+      loader.succeed(`Plan ready: ${plan.items.length} change(s)`);
+      tracker.checkpoint("plan");
+      if (outputJson) {
+        ctx.ui?.json?.(plan);
+      } else {
+        if (plan.items.length === 0) {
+          ctx.ui?.info?.("No changes needed \u2014 already in the target mode.");
+        } else {
+          const byRepo = groupByMonorepo(plan.items);
+          const uniquePkgs = new Set(plan.items.map((i) => i.depName)).size;
+          const uniqueFiles = new Set(plan.items.map((i) => i.packageJsonPath)).size;
+          const sections = [...byRepo.entries()].map(([repo, items]) => {
+            const byDep = /* @__PURE__ */ new Map();
+            for (const item of items) {
+              const existing = byDep.get(item.depName);
+              if (existing) {
+                existing.count++;
+              } else {
+                byDep.set(item.depName, { from: item.from, to: item.to, count: 1 });
+              }
+            }
+            return {
+              header: `${repo} (${byDep.size} dep${byDep.size !== 1 ? "s" : ""})`,
+              items: [...byDep.entries()].map(
+                ([dep, { from, to, count }]) => count > 1 ? `${dep}: ${from} \u2192 ${to}  \xD7${count} files` : `${dep}: ${from} \u2192 ${to}`
+              )
+            };
+          });
+          ctx.ui?.sideBox?.({
+            title: "DevLink \u2014 Plan",
+            status: "info",
+            summary: {
+              "Mode": `${state.currentMode ?? "?"} \u2192 ${targetMode}`,
+              "Packages": uniquePkgs,
+              "Files affected": uniqueFiles,
+              "Total changes": plan.items.length
+            },
+            sections: [
+              ...sections,
+              { header: "Next step", items: [`kb devlink switch --mode=${targetMode}`] }
+            ],
+            timing: tracker.total()
+          });
+        }
+      }
+      return { exitCode: 0, result: plan, meta: { timing: tracker.total() } };
+    }
+  }
+});
+
+export { plan_default as default };
+//# sourceMappingURL=plan.js.map
+//# sourceMappingURL=plan.js.map

package/dist/cli/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"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","file":"plan.js","sourcesContent":["import { defineCommand, useLoader, TimingTracker, type PluginContextV3, type CommandResult } from '@kb-labs/sdk';\nimport { discoverMonorepos, buildPackageMapFiltered, buildPlan, groupByMonorepo, loadState } from '@kb-labs/devlink-core';\nimport type { DevlinkMode, DevlinkPlan } from '@kb-labs/devlink-contracts';\n\ninterface PlanFlags {\n  mode?: DevlinkMode;\n  repos?: string;\n  json?: boolean;\n  ttl?: number;\n}\n\ninterface PlanInput {\n  argv?: string[];\n  flags?: PlanFlags;\n  mode?: DevlinkMode;\n  repos?: string;\n  json?: boolean;\n}\n\nexport default defineCommand<unknown, PlanInput, DevlinkPlan>({\n  id: 'devlink:plan',\n  description: 'Preview what would change when switching mode',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: PlanInput): Promise<CommandResult<DevlinkPlan>> {\n      const tracker = new TimingTracker();\n      const flags = (input.flags ?? input) as PlanFlags;\n      const outputJson = flags.json ?? false;\n      const scopedRepos = flags.repos ? flags.repos.split(',').map(s => s.trim()) : undefined;\n      const ttlMs = (flags.ttl ?? 24) * 60 * 60 * 1000;\n\n      const rootDir = ctx.cwd ?? process.cwd();\n\n      const loader = useLoader('Building plan...');\n      loader.start();\n\n      const state = loadState(rootDir);\n      const monorepos = discoverMonorepos(rootDir);\n\n      // Determine target mode before building package map — local mode skips npm check\n      const targetMode: DevlinkMode = flags.mode ?? (state.currentMode === 'npm' ? 'local' : 'npm');\n      const packageMap = await buildPackageMapFiltered(monorepos, rootDir, ttlMs, targetMode);\n\n      const plan = buildPlan(targetMode, packageMap, monorepos, rootDir, { scopedRepos });\n      loader.succeed(`Plan ready: ${plan.items.length} change(s)`);\n      tracker.checkpoint('plan');\n\n      if (outputJson) {\n        ctx.ui?.json?.(plan);\n      } else {\n        if (plan.items.length === 0) {\n          ctx.ui?.info?.('No changes needed — already in the target mode.');\n        } else {\n          const byRepo = groupByMonorepo(plan.items);\n          // Unique packages in npm map\n          const uniquePkgs = new Set(plan.items.map(i => i.depName)).size;\n          const uniqueFiles = new Set(plan.items.map(i => i.packageJsonPath)).size;\n\n          const sections = [...byRepo.entries()].map(([repo, items]) => {\n            // Group by depName within each repo — show \"×N files\" instead of N lines\n            const byDep = new Map<string, { from: string; to: string; count: number }>();\n            for (const item of items) {\n              const existing = byDep.get(item.depName);\n              if (existing) {\n                existing.count++;\n              } else {\n                byDep.set(item.depName, { from: item.from, to: item.to, count: 1 });\n              }\n            }\n            return {\n              header: `${repo} (${byDep.size} dep${byDep.size !== 1 ? 's' : ''})`,\n              items: [...byDep.entries()].map(([dep, { from, to, count }]) =>\n                count > 1\n                  ? `${dep}: ${from} → ${to}  ×${count} files`\n                  : `${dep}: ${from} → ${to}`\n              ),\n            };\n          });\n\n          ctx.ui?.sideBox?.({\n            title: 'DevLink — Plan',\n            status: 'info',\n            summary: {\n              'Mode': `${state.currentMode ?? '?'} → ${targetMode}`,\n              'Packages': uniquePkgs,\n              'Files affected': uniqueFiles,\n              'Total changes': plan.items.length,\n            },\n            sections: [\n              ...sections,\n              { header: 'Next step', items: [`kb devlink switch --mode=${targetMode}`] },\n            ],\n            timing: tracker.total(),\n          });\n        }\n      }\n\n      return { exitCode: 0, result: plan, meta: { timing: tracker.total() } };\n    },\n  },\n});\n"]}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,17 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { DevlinkStatus, DiagnosticIssue } from '@kb-labs/devlink-contracts';
+
+interface StatusFlags {
+    json?: boolean;
+}
+interface StatusInput {
+    argv?: string[];
+    flags?: StatusFlags;
+    json?: boolean;
+}
+interface StatusResult extends DevlinkStatus {
+    diagnostics: DiagnosticIssue[];
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, StatusInput, StatusResult>;
+
+export { _default as default };

package/dist/cli/commands/status.js

@@ -0,0 +1,97 @@
+import { defineCommand, TimingTracker, useLoader } from '@kb-labs/sdk';
+import { loadState, discoverMonorepos, buildPackageMapFiltered, analyzePackageDeps, diagnose } from '@kb-labs/devlink-core';
+
+// src/cli/commands/status.ts
+var status_default = defineCommand({
+  id: "devlink:status",
+  description: "Show current state of cross-repo dependencies with diagnostics",
+  handler: {
+    async execute(ctx, input) {
+      const tracker = new TimingTracker();
+      const flags = input.flags ?? input;
+      const outputJson = flags.json ?? false;
+      const rootDir = ctx.cwd ?? process.cwd();
+      const loader = useLoader("Analyzing dependencies...");
+      loader.start();
+      const state = loadState(rootDir);
+      const monorepos = discoverMonorepos(rootDir);
+      const packageMap = await buildPackageMapFiltered(monorepos, rootDir);
+      let totalLink = 0;
+      let totalNpm = 0;
+      let totalWorkspace = 0;
+      for (const monorepo of monorepos) {
+        for (const pkgPath of monorepo.packagePaths) {
+          const counts = analyzePackageDeps(pkgPath, packageMap);
+          totalLink += counts.linkCount;
+          totalNpm += counts.npmCount;
+          totalWorkspace += counts.workspaceCount;
+        }
+      }
+      const diagnostics = diagnose(monorepos, packageMap, rootDir);
+      loader.succeed("Analysis complete");
+      tracker.checkpoint("analysis");
+      const errors = diagnostics.filter((d) => d.severity === "error");
+      const warnings = diagnostics.filter((d) => d.severity === "warning");
+      const result = {
+        currentMode: state.currentMode,
+        lastApplied: state.lastApplied,
+        linkCount: totalLink,
+        npmCount: totalNpm,
+        workspaceCount: totalWorkspace,
+        discrepancies: [],
+        diagnostics
+      };
+      if (outputJson) {
+        ctx.ui?.json?.(result);
+      } else {
+        const sections = [
+          {
+            header: "Current mode",
+            items: [
+              `Mode: ${state.currentMode ?? "unknown"}`,
+              `Last applied: ${state.lastApplied ?? "never"}`
+            ]
+          },
+          {
+            header: "Dependency counts",
+            items: [
+              `link: (local)   : ${totalLink}`,
+              `npm (^version)  : ${totalNpm}`,
+              `workspace:*     : ${totalWorkspace}`
+            ]
+          }
+        ];
+        if (errors.length > 0) {
+          sections.push({
+            header: `\u274C Errors (${errors.length})`,
+            items: errors.slice(0, 10).map((d) => `${d.dep ?? d.file}: ${d.message}`)
+          });
+        }
+        if (warnings.length > 0) {
+          sections.push({
+            header: `\u26A0 Warnings (${warnings.length})`,
+            items: warnings.slice(0, 10).map((d) => `${d.dep ?? d.file}: ${d.message}`)
+          });
+        }
+        if (diagnostics.length === 0) {
+          sections.push({ header: "\u2705 Health", items: ["No issues detected"] });
+        } else {
+          sections.push({
+            header: "Fix",
+            items: ["Run: kb devlink switch --mode=local --install"]
+          });
+        }
+        ctx.ui?.success?.("Dependency status", {
+          title: "DevLink \u2014 Status",
+          sections,
+          timing: tracker.total()
+        });
+      }
+      return { exitCode: 0, result, meta: { timing: tracker.total() } };
+    }
+  }
+});
+
+export { status_default as default };
+//# sourceMappingURL=status.js.map
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"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","file":"status.js","sourcesContent":["import { defineCommand, useLoader, TimingTracker, type PluginContextV3, type CommandResult } from '@kb-labs/sdk';\nimport { discoverMonorepos, buildPackageMapFiltered, analyzePackageDeps, loadState, diagnose } from '@kb-labs/devlink-core';\nimport type { DevlinkStatus, DiagnosticIssue } from '@kb-labs/devlink-contracts';\n\ninterface StatusFlags {\n  json?: boolean;\n}\n\ninterface StatusInput {\n  argv?: string[];\n  flags?: StatusFlags;\n  json?: boolean;\n}\n\ninterface StatusResult extends DevlinkStatus {\n  diagnostics: DiagnosticIssue[];\n}\n\nexport default defineCommand<unknown, StatusInput, StatusResult>({\n  id: 'devlink:status',\n  description: 'Show current state of cross-repo dependencies with diagnostics',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: StatusInput): Promise<CommandResult<StatusResult>> {\n      const tracker = new TimingTracker();\n      const flags = (input.flags ?? input) as StatusFlags;\n      const outputJson = flags.json ?? false;\n\n      const rootDir = ctx.cwd ?? process.cwd();\n\n      const loader = useLoader('Analyzing dependencies...');\n      loader.start();\n\n      const state = loadState(rootDir);\n      const monorepos = discoverMonorepos(rootDir);\n      const packageMap = await buildPackageMapFiltered(monorepos, rootDir);\n\n      let totalLink = 0;\n      let totalNpm = 0;\n      let totalWorkspace = 0;\n\n      for (const monorepo of monorepos) {\n        for (const pkgPath of monorepo.packagePaths) {\n          const counts = analyzePackageDeps(pkgPath, packageMap);\n          totalLink += counts.linkCount;\n          totalNpm += counts.npmCount;\n          totalWorkspace += counts.workspaceCount;\n        }\n      }\n\n      // Run diagnostics\n      const diagnostics = diagnose(monorepos, packageMap, rootDir);\n\n      loader.succeed('Analysis complete');\n      tracker.checkpoint('analysis');\n\n      const errors = diagnostics.filter(d => d.severity === 'error');\n      const warnings = diagnostics.filter(d => d.severity === 'warning');\n\n      const result: StatusResult = {\n        currentMode: state.currentMode,\n        lastApplied: state.lastApplied,\n        linkCount: totalLink,\n        npmCount: totalNpm,\n        workspaceCount: totalWorkspace,\n        discrepancies: [],\n        diagnostics,\n      };\n\n      if (outputJson) {\n        ctx.ui?.json?.(result);\n      } else {\n        const sections = [\n          {\n            header: 'Current mode',\n            items: [\n              `Mode: ${state.currentMode ?? 'unknown'}`,\n              `Last applied: ${state.lastApplied ?? 'never'}`,\n            ],\n          },\n          {\n            header: 'Dependency counts',\n            items: [\n              `link: (local)   : ${totalLink}`,\n              `npm (^version)  : ${totalNpm}`,\n              `workspace:*     : ${totalWorkspace}`,\n            ],\n          },\n        ];\n\n        if (errors.length > 0) {\n          sections.push({\n            header: `❌ Errors (${errors.length})`,\n            items: errors.slice(0, 10).map(d => `${d.dep ?? d.file}: ${d.message}`),\n          });\n        }\n\n        if (warnings.length > 0) {\n          sections.push({\n            header: `⚠ Warnings (${warnings.length})`,\n            items: warnings.slice(0, 10).map(d => `${d.dep ?? d.file}: ${d.message}`),\n          });\n        }\n\n        if (diagnostics.length === 0) {\n          sections.push({ header: '✅ Health', items: ['No issues detected'] });\n        } else {\n          sections.push({\n            header: 'Fix',\n            items: ['Run: kb devlink switch --mode=local --install'],\n          });\n        }\n\n        ctx.ui?.success?.('Dependency status', {\n          title: 'DevLink — Status',\n          sections,\n          timing: tracker.total(),\n        });\n      }\n\n      return { exitCode: 0, result, meta: { timing: tracker.total() } };\n    },\n  },\n});\n"]}

package/dist/cli/commands/switch.d.ts

@@ -0,0 +1,31 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { DevlinkMode } from '@kb-labs/devlink-contracts';
+
+interface SwitchFlags {
+    mode: DevlinkMode;
+    'dry-run'?: boolean;
+    repos?: string;
+    yes?: boolean;
+    json?: boolean;
+    ttl?: number;
+    install?: boolean;
+    'clean-locks'?: boolean;
+}
+interface SwitchInput {
+    argv?: string[];
+    flags?: SwitchFlags;
+    mode?: DevlinkMode;
+    'dry-run'?: boolean;
+    repos?: string;
+    yes?: boolean;
+    json?: boolean;
+}
+interface SwitchResult {
+    mode: DevlinkMode;
+    changed: number;
+    dryRun: boolean;
+    backupId?: string;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, SwitchInput, SwitchResult>;
+
+export { _default as default };

package/dist/cli/commands/switch.js

@@ -0,0 +1,196 @@
+import { defineCommand, TimingTracker, useLoader } from '@kb-labs/sdk';
+import { discoverMonorepos, buildPackageMapFiltered, checkGitDirty, buildPlan, loadState, createBackup, applyPlan, updateWorkspaceYamls, saveState } from '@kb-labs/devlink-core';
+import { existsSync, unlinkSync, rmSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+
+// src/cli/commands/switch.ts
+var switch_default = defineCommand({
+  id: "devlink:switch",
+  description: "Switch cross-repo deps between link: and npm mode",
+  handler: {
+    async execute(ctx, input) {
+      const tracker = new TimingTracker();
+      const flags = input.flags ?? input;
+      const mode = flags.mode;
+      const dryRun = flags["dry-run"] ?? false;
+      const outputJson = flags.json ?? false;
+      const scopedRepos = flags.repos ? flags.repos.split(",").map((s) => s.trim()) : void 0;
+      const ttlMs = (flags.ttl ?? 24) * 60 * 60 * 1e3;
+      const rootDir = ctx.cwd ?? process.cwd();
+      const discoverLoader = useLoader("Discovering monorepos...");
+      discoverLoader.start();
+      const monorepos = discoverMonorepos(rootDir);
+      const packageMap = await buildPackageMapFiltered(monorepos, rootDir, ttlMs, mode);
+      discoverLoader.succeed(`Found ${monorepos.length} monorepos, ${Object.keys(packageMap).length} packages`);
+      tracker.checkpoint("discovery");
+      const dirtyFiles = checkGitDirty(rootDir);
+      if (dirtyFiles.length > 0) {
+        ctx.ui?.warn?.(`Working tree has ${dirtyFiles.length} uncommitted changes`);
+      }
+      const plan = buildPlan(mode, packageMap, monorepos, rootDir, { scopedRepos });
+      tracker.checkpoint("plan");
+      if (plan.items.length === 0 && !flags.install) {
+        ctx.ui?.info?.("No changes needed \u2014 dependencies are already in the requested mode.");
+        return { exitCode: 0, result: { mode, changed: 0, dryRun }, meta: { timing: tracker.total() } };
+      }
+      if (dryRun) {
+        const result2 = { mode, changed: plan.items.length, dryRun: true };
+        if (outputJson) {
+          ctx.ui?.json?.({ ...result2, items: plan.items });
+        } else {
+          const byRepo = /* @__PURE__ */ new Map();
+          for (const item of plan.items) {
+            byRepo.set(item.monorepo, (byRepo.get(item.monorepo) ?? 0) + 1);
+          }
+          const repoLines = [...byRepo.entries()].map(([repo, count]) => `${repo}: ${count} change(s)`);
+          ctx.ui?.success?.(`[dry-run] Would switch ${plan.items.length} dependencies to ${mode} mode`, {
+            title: "DevLink \u2014 Dry Run",
+            sections: [
+              { header: "Changes by repo", items: repoLines },
+              { header: "Note", items: ["No files were modified. Remove --dry-run to apply."] }
+            ],
+            timing: tracker.total()
+          });
+        }
+        return { exitCode: 0, result: result2, meta: { timing: tracker.total() } };
+      }
+      const currentState = loadState(rootDir);
+      const modeAtBackup = currentState.currentMode ?? mode;
+      const allPackageJsons = monorepos.flatMap((m) => m.packagePaths);
+      const backup = createBackup(rootDir, allPackageJsons, `pre-switch to ${mode}`, modeAtBackup);
+      const backupId = backup.id;
+      tracker.checkpoint("backup");
+      let applyResult = { applied: 0, errors: [] };
+      if (plan.items.length > 0) {
+        const applyLoader = useLoader(`Switching ${plan.items.length} dependencies to ${mode} mode...`);
+        applyLoader.start();
+        applyResult = await applyPlan(plan, { dryRun: false });
+        applyLoader.succeed(`Applied ${applyResult.applied} change(s)`);
+        tracker.checkpoint("apply");
+      }
+      const wsLoader = useLoader("Updating sub-repo workspace files...");
+      wsLoader.start();
+      const wsUpdates = updateWorkspaceYamls(monorepos, packageMap, rootDir);
+      const wsChanged = wsUpdates.reduce((sum, u) => sum + u.added.length + u.removed.length, 0);
+      wsLoader.succeed(
+        wsChanged > 0 ? `Updated ${wsUpdates.length} workspace file(s) (${wsChanged} path changes)` : "Workspace files up to date"
+      );
+      tracker.checkpoint("workspace-yaml");
+      saveState(rootDir, {
+        currentMode: mode,
+        lastApplied: (/* @__PURE__ */ new Date()).toISOString(),
+        frozenAt: currentState.frozenAt
+      });
+      const shouldClean = flags["clean-locks"] !== false;
+      let cleanedLocks = 0;
+      let cleanedNodeModules = 0;
+      if (shouldClean) {
+        const cleanLoader = useLoader("Cleaning stale lockfiles and node_modules...");
+        cleanLoader.start();
+        for (const mono of monorepos) {
+          const lockPath = join(mono.rootPath, "pnpm-lock.yaml");
+          if (existsSync(lockPath)) {
+            try {
+              unlinkSync(lockPath);
+              cleanedLocks++;
+            } catch {
+            }
+          }
+          const nmPath = join(mono.rootPath, "node_modules");
+          if (existsSync(nmPath)) {
+            try {
+              rmSync(nmPath, { recursive: true, force: true });
+              cleanedNodeModules++;
+            } catch {
+            }
+          }
+        }
+        cleanLoader.succeed(
+          `Cleaned ${cleanedLocks} lockfile(s), ${cleanedNodeModules} node_modules`
+        );
+        tracker.checkpoint("clean");
+      }
+      const shouldInstall = flags.install === true;
+      let installedRepos = 0;
+      const installErrors = [];
+      if (shouldInstall) {
+        const rootLoader = useLoader("Installing workspace root...");
+        rootLoader.start();
+        try {
+          execSync("pnpm install --no-frozen-lockfile", {
+            cwd: rootDir,
+            stdio: "pipe",
+            timeout: 18e4
+          });
+          rootLoader.succeed("Workspace root installed");
+        } catch (err) {
+          rootLoader.succeed("Workspace root install failed");
+          installErrors.push(`root: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`);
+        }
+        tracker.checkpoint("root-install");
+        const affectedRepos = new Set(plan.items.map((i) => i.monorepo));
+        const affectedMonorepos = monorepos.filter(
+          (m) => affectedRepos.has(m.name) || !existsSync(join(m.rootPath, "pnpm-lock.yaml"))
+        );
+        const repoLoader = useLoader(`Installing ${affectedMonorepos.length} sub-repo(s)...`);
+        repoLoader.start();
+        for (const mono of affectedMonorepos) {
+          try {
+            execSync("pnpm install --no-frozen-lockfile --prefer-offline", {
+              cwd: mono.rootPath,
+              stdio: "pipe",
+              timeout: 3e5
+              // 5 min per sub-repo
+            });
+            installedRepos++;
+          } catch (err) {
+            installErrors.push(`${mono.name}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`);
+          }
+        }
+        repoLoader.succeed(`Installed ${installedRepos}/${affectedMonorepos.length} sub-repo(s)${installErrors.length > 0 ? `, ${installErrors.length} failed` : ""}`);
+        tracker.checkpoint("sub-repo-install");
+      }
+      const result = {
+        mode,
+        changed: applyResult.applied,
+        dryRun: false,
+        backupId
+      };
+      if (outputJson) {
+        ctx.ui?.json?.({ ...result, cleanedLocks, wsUpdates: wsUpdates.length, installedRepos, installErrors });
+      } else {
+        const summaryItems = [
+          `Mode: ${mode}`,
+          `Changed: ${applyResult.applied} dependencies`,
+          `Backup: ${backupId}`
+        ];
+        if (wsChanged > 0) {
+          summaryItems.push(`Workspace YAMLs: ${wsUpdates.length} updated`);
+        }
+        if (cleanedLocks > 0 || cleanedNodeModules > 0) {
+          summaryItems.push(`Cleaned: ${cleanedLocks} lockfile(s), ${cleanedNodeModules} node_modules`);
+        }
+        if (shouldInstall) {
+          summaryItems.push(`Installed: root + ${installedRepos} sub-repo(s)`);
+        }
+        const sections = [
+          { header: "Summary", items: summaryItems },
+          ...applyResult.errors.length > 0 ? [{ header: "Errors", items: applyResult.errors.map((e) => `${e.file}: ${e.error}`) }] : [],
+          ...installErrors.length > 0 ? [{ header: "Install errors", items: installErrors }] : [],
+          ...!shouldInstall && applyResult.applied > 0 ? [{ header: "Next step", items: ["Re-run with --install to complete setup"] }] : []
+        ];
+        ctx.ui?.success?.(`Switched to ${mode} mode`, {
+          title: "DevLink \u2014 Switch",
+          sections,
+          timing: tracker.total()
+        });
+      }
+      return { exitCode: 0, result, meta: { timing: tracker.total() } };
+    }
+  }
+});
+
+export { switch_default as default };
+//# sourceMappingURL=switch.js.map
+//# sourceMappingURL=switch.js.map

package/dist/cli/commands/switch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/switch.ts"],"names":["result"],"mappings":"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","file":"switch.js","sourcesContent":["import { defineCommand, useLoader, TimingTracker, type PluginContextV3, type CommandResult } from '@kb-labs/sdk';\nimport { discoverMonorepos, buildPackageMapFiltered, buildPlan, applyPlan, createBackup, loadState, saveState, checkGitDirty, updateWorkspaceYamls } from '@kb-labs/devlink-core';\nimport type { DevlinkMode } from '@kb-labs/devlink-contracts';\nimport { existsSync, unlinkSync, rmSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { execSync } from 'node:child_process';\n\ninterface SwitchFlags {\n  mode: DevlinkMode;\n  'dry-run'?: boolean;\n  repos?: string;\n  yes?: boolean;\n  json?: boolean;\n  ttl?: number;\n  install?: boolean;\n  'clean-locks'?: boolean;\n}\n\ninterface SwitchInput {\n  argv?: string[];\n  flags?: SwitchFlags;\n  mode?: DevlinkMode;\n  'dry-run'?: boolean;\n  repos?: string;\n  yes?: boolean;\n  json?: boolean;\n}\n\ninterface SwitchResult {\n  mode: DevlinkMode;\n  changed: number;\n  dryRun: boolean;\n  backupId?: string;\n}\n\nexport default defineCommand<unknown, SwitchInput, SwitchResult>({\n  id: 'devlink:switch',\n  description: 'Switch cross-repo deps between link: and npm mode',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: SwitchInput): Promise<CommandResult<SwitchResult>> {\n      const tracker = new TimingTracker();\n      const flags = (input.flags ?? input) as SwitchFlags;\n      const mode = flags.mode;\n      const dryRun = flags['dry-run'] ?? false;\n      const outputJson = flags.json ?? false;\n      const scopedRepos = flags.repos ? flags.repos.split(',').map(s => s.trim()) : undefined;\n      const ttlMs = (flags.ttl ?? 24) * 60 * 60 * 1000;\n\n      const rootDir = ctx.cwd ?? process.cwd();\n\n      // 1. Discover\n      const discoverLoader = useLoader('Discovering monorepos...');\n      discoverLoader.start();\n\n      const monorepos = discoverMonorepos(rootDir);\n      const packageMap = await buildPackageMapFiltered(monorepos, rootDir, ttlMs, mode);\n      discoverLoader.succeed(`Found ${monorepos.length} monorepos, ${Object.keys(packageMap).length} packages`);\n      tracker.checkpoint('discovery');\n\n      // 2. Warn if git dirty\n      const dirtyFiles = checkGitDirty(rootDir);\n      if (dirtyFiles.length > 0) {\n        ctx.ui?.warn?.(`Working tree has ${dirtyFiles.length} uncommitted changes`);\n      }\n\n      // 3. Build plan\n      const plan = buildPlan(mode, packageMap, monorepos, rootDir, { scopedRepos });\n      tracker.checkpoint('plan');\n\n      if (plan.items.length === 0 && !flags.install) {\n        ctx.ui?.info?.('No changes needed — dependencies are already in the requested mode.');\n        return { exitCode: 0, result: { mode, changed: 0, dryRun }, meta: { timing: tracker.total() } };\n      }\n\n      // 4. Dry-run: show plan and exit\n      if (dryRun) {\n        const result: SwitchResult = { mode, changed: plan.items.length, dryRun: true };\n        if (outputJson) {\n          ctx.ui?.json?.({ ...result, items: plan.items });\n        } else {\n          const byRepo = new Map<string, number>();\n          for (const item of plan.items) {\n            byRepo.set(item.monorepo, (byRepo.get(item.monorepo) ?? 0) + 1);\n          }\n          const repoLines = [...byRepo.entries()].map(([repo, count]) => `${repo}: ${count} change(s)`);\n          ctx.ui?.success?.(`[dry-run] Would switch ${plan.items.length} dependencies to ${mode} mode`, {\n            title: 'DevLink — Dry Run',\n            sections: [\n              { header: 'Changes by repo', items: repoLines },\n              { header: 'Note', items: ['No files were modified. Remove --dry-run to apply.'] },\n            ],\n            timing: tracker.total(),\n          });\n        }\n        return { exitCode: 0, result, meta: { timing: tracker.total() } };\n      }\n\n      // 5. Always create backup (even if no deps change — install cleans node_modules)\n      const currentState = loadState(rootDir);\n      const modeAtBackup = currentState.currentMode ?? mode;\n      const allPackageJsons = monorepos.flatMap(m => m.packagePaths);\n      const backup = createBackup(rootDir, allPackageJsons, `pre-switch to ${mode}`, modeAtBackup);\n      const backupId = backup.id;\n      tracker.checkpoint('backup');\n\n      // 6. Apply dep changes (if any)\n      let applyResult = { applied: 0, skipped: 0, errors: [] as Array<{ file: string; error: string }> };\n      if (plan.items.length > 0) {\n        const applyLoader = useLoader(`Switching ${plan.items.length} dependencies to ${mode} mode...`);\n        applyLoader.start();\n        applyResult = await applyPlan(plan, { dryRun: false });\n        applyLoader.succeed(`Applied ${applyResult.applied} change(s)`);\n        tracker.checkpoint('apply');\n      }\n\n      // 7. Update sub-repo pnpm-workspace.yaml with correct cross-repo paths\n      const wsLoader = useLoader('Updating sub-repo workspace files...');\n      wsLoader.start();\n      const wsUpdates = updateWorkspaceYamls(monorepos, packageMap, rootDir);\n      const wsChanged = wsUpdates.reduce((sum, u) => sum + u.added.length + u.removed.length, 0);\n      wsLoader.succeed(wsChanged > 0\n        ? `Updated ${wsUpdates.length} workspace file(s) (${wsChanged} path changes)`\n        : 'Workspace files up to date'\n      );\n      tracker.checkpoint('workspace-yaml');\n\n      // 8. Save state\n      saveState(rootDir, {\n        currentMode: mode,\n        lastApplied: new Date().toISOString(),\n        frozenAt: currentState.frozenAt,\n      });\n\n      // 9. Clean stale lockfiles + node_modules in all sub-repos (default: true)\n      const shouldClean = flags['clean-locks'] !== false;\n      let cleanedLocks = 0;\n      let cleanedNodeModules = 0;\n      if (shouldClean) {\n        const cleanLoader = useLoader('Cleaning stale lockfiles and node_modules...');\n        cleanLoader.start();\n        for (const mono of monorepos) {\n          // Clean lockfile\n          const lockPath = join(mono.rootPath, 'pnpm-lock.yaml');\n          if (existsSync(lockPath)) {\n            try { unlinkSync(lockPath); cleanedLocks++; } catch { /* skip */ }\n          }\n          // Clean node_modules (contains stale shims with hardcoded paths)\n          const nmPath = join(mono.rootPath, 'node_modules');\n          if (existsSync(nmPath)) {\n            try { rmSync(nmPath, { recursive: true, force: true }); cleanedNodeModules++; } catch { /* skip */ }\n          }\n        }\n        cleanLoader.succeed(\n          `Cleaned ${cleanedLocks} lockfile(s), ${cleanedNodeModules} node_modules`\n        );\n        tracker.checkpoint('clean');\n      }\n\n      // 10. Install: workspace root first, then per-sub-repo\n      const shouldInstall = flags.install === true;\n      let installedRepos = 0;\n      const installErrors: string[] = [];\n      if (shouldInstall) {\n        // Phase 1: workspace root install\n        const rootLoader = useLoader('Installing workspace root...');\n        rootLoader.start();\n        try {\n          execSync('pnpm install --no-frozen-lockfile', {\n            cwd: rootDir,\n            stdio: 'pipe',\n            timeout: 180_000,\n          });\n          rootLoader.succeed('Workspace root installed');\n        } catch (err) {\n          rootLoader.succeed('Workspace root install failed');\n          installErrors.push(`root: ${err instanceof Error ? err.message.split('\\n')[0] : String(err)}`);\n        }\n        tracker.checkpoint('root-install');\n\n        // Phase 2: per-sub-repo install (affected + repos missing lockfile)\n        const affectedRepos = new Set(plan.items.map(i => i.monorepo));\n        const affectedMonorepos = monorepos.filter(m =>\n          affectedRepos.has(m.name) || !existsSync(join(m.rootPath, 'pnpm-lock.yaml'))\n        );\n        const repoLoader = useLoader(`Installing ${affectedMonorepos.length} sub-repo(s)...`);\n        repoLoader.start();\n        for (const mono of affectedMonorepos) {\n          try {\n            execSync('pnpm install --no-frozen-lockfile --prefer-offline', {\n              cwd: mono.rootPath,\n              stdio: 'pipe',\n              timeout: 300_000, // 5 min per sub-repo\n            });\n            installedRepos++;\n          } catch (err) {\n            installErrors.push(`${mono.name}: ${err instanceof Error ? err.message.split('\\n')[0] : String(err)}`);\n          }\n        }\n        repoLoader.succeed(`Installed ${installedRepos}/${affectedMonorepos.length} sub-repo(s)${installErrors.length > 0 ? `, ${installErrors.length} failed` : ''}`);\n        tracker.checkpoint('sub-repo-install');\n      }\n\n      // 11. Output\n      const result: SwitchResult = {\n        mode,\n        changed: applyResult.applied,\n        dryRun: false,\n        backupId,\n      };\n\n      if (outputJson) {\n        ctx.ui?.json?.({ ...result, cleanedLocks, wsUpdates: wsUpdates.length, installedRepos, installErrors });\n      } else {\n        const summaryItems = [\n          `Mode: ${mode}`,\n          `Changed: ${applyResult.applied} dependencies`,\n          `Backup: ${backupId}`,\n        ];\n        if (wsChanged > 0) {\n          summaryItems.push(`Workspace YAMLs: ${wsUpdates.length} updated`);\n        }\n        if (cleanedLocks > 0 || cleanedNodeModules > 0) {\n          summaryItems.push(`Cleaned: ${cleanedLocks} lockfile(s), ${cleanedNodeModules} node_modules`);\n        }\n        if (shouldInstall) {\n          summaryItems.push(`Installed: root + ${installedRepos} sub-repo(s)`);\n        }\n\n        const sections = [\n          { header: 'Summary', items: summaryItems },\n          ...(applyResult.errors.length > 0\n            ? [{ header: 'Errors', items: applyResult.errors.map(e => `${e.file}: ${e.error}`) }]\n            : []),\n          ...(installErrors.length > 0\n            ? [{ header: 'Install errors', items: installErrors }]\n            : []),\n          ...(!shouldInstall && applyResult.applied > 0\n            ? [{ header: 'Next step', items: ['Re-run with --install to complete setup'] }]\n            : []),\n        ];\n        ctx.ui?.success?.(`Switched to ${mode} mode`, {\n          title: 'DevLink — Switch',\n          sections,\n          timing: tracker.total(),\n        });\n      }\n\n      return { exitCode: 0, result, meta: { timing: tracker.total() } };\n    },\n  },\n});\n"]}

package/dist/cli/commands/undo.d.ts

@@ -0,0 +1,18 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+interface UndoFlags {
+    json?: boolean;
+}
+interface UndoInput {
+    argv?: string[];
+    flags?: UndoFlags;
+    json?: boolean;
+}
+interface UndoResult {
+    restored: number;
+    backupId: string;
+    errors: string[];
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, UndoInput, UndoResult>;
+
+export { _default as default };

package/dist/cli/commands/undo.js

@@ -0,0 +1,58 @@
+import { defineCommand, TimingTracker, useLoader } from '@kb-labs/sdk';
+import { getLastBackup, restoreBackup, loadState, saveState } from '@kb-labs/devlink-core';
+
+// src/cli/commands/undo.ts
+var undo_default = defineCommand({
+  id: "devlink:undo",
+  description: "Restore previous dependency state from last backup",
+  handler: {
+    async execute(ctx, input) {
+      const tracker = new TimingTracker();
+      const flags = input.flags ?? input;
+      const outputJson = flags.json ?? false;
+      const rootDir = ctx.cwd ?? process.cwd();
+      const backup = getLastBackup(rootDir);
+      if (!backup) {
+        ctx.ui?.error?.("No backups found. Run switch first to create a backup.");
+        return { exitCode: 1 };
+      }
+      const loader = useLoader(`Restoring from backup ${backup.id}...`);
+      loader.start();
+      const { restored, errors } = restoreBackup(rootDir, backup.id);
+      loader.succeed(`Restored ${restored} file(s)`);
+      tracker.checkpoint("restore");
+      const currentState = loadState(rootDir);
+      saveState(rootDir, {
+        ...currentState,
+        currentMode: backup.modeAtBackup,
+        lastApplied: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      const result = { restored, backupId: backup.id, errors };
+      if (outputJson) {
+        ctx.ui?.json?.(result);
+      } else {
+        ctx.ui?.success?.(`Restored from backup (mode: ${backup.modeAtBackup ?? "unknown"})`, {
+          title: "DevLink \u2014 Undo",
+          sections: [
+            {
+              header: "Summary",
+              items: [
+                `Backup ID: ${backup.id}`,
+                `Created: ${backup.timestamp}`,
+                `Restored files: ${restored}`
+              ]
+            },
+            ...errors.length > 0 ? [{ header: "Errors", items: errors }] : [],
+            { header: "Next step", items: ["Run pnpm install to apply changes"] }
+          ],
+          timing: tracker.total()
+        });
+      }
+      return { exitCode: errors.length > 0 ? 1 : 0, result, meta: { timing: tracker.total() } };
+    }
+  }
+});
+
+export { undo_default as default };
+//# sourceMappingURL=undo.js.map
+//# sourceMappingURL=undo.js.map

package/dist/cli/commands/undo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/undo.ts"],"names":[],"mappings":";;;;AAmBA,IAAO,eAAQ,aAAA,CAA8C;AAAA,EAC3D,EAAA,EAAI,cAAA;AAAA,EACJ,WAAA,EAAa,oDAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAsD;AACxF,MAAA,MAAM,OAAA,GAAU,IAAI,aAAA,EAAc;AAClC,MAAA,MAAM,KAAA,GAAS,MAAM,KAAA,IAAS,KAAA;AAC9B,MAAA,MAAM,UAAA,GAAa,MAAM,IAAA,IAAQ,KAAA;AAEjC,MAAA,MAAM,OAAA,GAAU,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEvC,MAAA,MAAM,MAAA,GAAS,cAAc,OAAO,CAAA;AACpC,MAAA,IAAI,CAAC,MAAA,EAAQ;AACX,QAAA,GAAA,CAAI,EAAA,EAAI,QAAQ,wDAAwD,CAAA;AACxE,QAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,MACvB;AAEA,MAAA,MAAM,MAAA,GAAS,SAAA,CAAU,CAAA,sBAAA,EAAyB,MAAA,CAAO,EAAE,CAAA,GAAA,CAAK,CAAA;AAChE,MAAA,MAAA,CAAO,KAAA,EAAM;AAEb,MAAA,MAAM,EAAE,QAAA,EAAU,MAAA,KAAW,aAAA,CAAc,OAAA,EAAS,OAAO,EAAE,CAAA;AAC7D,MAAA,MAAA,CAAO,OAAA,CAAQ,CAAA,SAAA,EAAY,QAAQ,CAAA,QAAA,CAAU,CAAA;AAC7C,MAAA,OAAA,CAAQ,WAAW,SAAS,CAAA;AAG5B,MAAA,MAAM,YAAA,GAAe,UAAU,OAAO,CAAA;AACtC,MAAA,SAAA,CAAU,OAAA,EAAS;AAAA,QACjB,GAAG,YAAA;AAAA,QACH,aAAa,MAAA,CAAO,YAAA;AAAA,QACpB,WAAA,EAAA,iBAAa,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,OACrC,CAAA;AAED,MAAA,MAAM,SAAqB,EAAE,QAAA,EAAU,QAAA,EAAU,MAAA,CAAO,IAAI,MAAA,EAAO;AAEnE,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,OAAO,MAAM,CAAA;AAAA,MACvB,CAAA,MAAO;AACL,QAAA,GAAA,CAAI,IAAI,OAAA,GAAU,CAAA,4BAAA,EAA+B,MAAA,CAAO,YAAA,IAAgB,SAAS,CAAA,CAAA,CAAA,EAAK;AAAA,UACpF,KAAA,EAAO,qBAAA;AAAA,UACP,QAAA,EAAU;AAAA,YACR;AAAA,cACE,MAAA,EAAQ,SAAA;AAAA,cACR,KAAA,EAAO;AAAA,gBACL,CAAA,WAAA,EAAc,OAAO,EAAE,CAAA,CAAA;AAAA,gBACvB,CAAA,SAAA,EAAY,OAAO,SAAS,CAAA,CAAA;AAAA,gBAC5B,mBAAmB,QAAQ,CAAA;AAAA;AAC7B,aACF;AAAA,YACA,GAAI,MAAA,CAAO,MAAA,GAAS,CAAA,GAAI,CAAC,EAAE,MAAA,EAAQ,QAAA,EAAU,KAAA,EAAO,MAAA,EAAQ,CAAA,GAAI,EAAC;AAAA,YACjE,EAAE,MAAA,EAAQ,WAAA,EAAa,KAAA,EAAO,CAAC,mCAAmC,CAAA;AAAE,WACtE;AAAA,UACA,MAAA,EAAQ,QAAQ,KAAA;AAAM,SACvB,CAAA;AAAA,MACH;AAEA,MAAA,OAAO,EAAE,QAAA,EAAU,MAAA,CAAO,MAAA,GAAS,IAAI,CAAA,GAAI,CAAA,EAAG,MAAA,EAAQ,IAAA,EAAM,EAAE,MAAA,EAAQ,OAAA,CAAQ,KAAA,IAAQ,EAAE;AAAA,IAC1F;AAAA;AAEJ,CAAC","file":"undo.js","sourcesContent":["import { defineCommand, useLoader, TimingTracker, type PluginContextV3, type CommandResult } from '@kb-labs/sdk';\nimport { getLastBackup, restoreBackup, saveState, loadState } from '@kb-labs/devlink-core';\n\ninterface UndoFlags {\n  json?: boolean;\n}\n\ninterface UndoInput {\n  argv?: string[];\n  flags?: UndoFlags;\n  json?: boolean;\n}\n\ninterface UndoResult {\n  restored: number;\n  backupId: string;\n  errors: string[];\n}\n\nexport default defineCommand<unknown, UndoInput, UndoResult>({\n  id: 'devlink:undo',\n  description: 'Restore previous dependency state from last backup',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: UndoInput): Promise<CommandResult<UndoResult>> {\n      const tracker = new TimingTracker();\n      const flags = (input.flags ?? input) as UndoFlags;\n      const outputJson = flags.json ?? false;\n\n      const rootDir = ctx.cwd ?? process.cwd();\n\n      const backup = getLastBackup(rootDir);\n      if (!backup) {\n        ctx.ui?.error?.('No backups found. Run switch first to create a backup.');\n        return { exitCode: 1 };\n      }\n\n      const loader = useLoader(`Restoring from backup ${backup.id}...`);\n      loader.start();\n\n      const { restored, errors } = restoreBackup(rootDir, backup.id);\n      loader.succeed(`Restored ${restored} file(s)`);\n      tracker.checkpoint('restore');\n\n      // Update state to backup's previous mode\n      const currentState = loadState(rootDir);\n      saveState(rootDir, {\n        ...currentState,\n        currentMode: backup.modeAtBackup,\n        lastApplied: new Date().toISOString(),\n      });\n\n      const result: UndoResult = { restored, backupId: backup.id, errors };\n\n      if (outputJson) {\n        ctx.ui?.json?.(result);\n      } else {\n        ctx.ui?.success?.(`Restored from backup (mode: ${backup.modeAtBackup ?? 'unknown'})`, {\n          title: 'DevLink — Undo',\n          sections: [\n            {\n              header: 'Summary',\n              items: [\n                `Backup ID: ${backup.id}`,\n                `Created: ${backup.timestamp}`,\n                `Restored files: ${restored}`,\n              ],\n            },\n            ...(errors.length > 0 ? [{ header: 'Errors', items: errors }] : []),\n            { header: 'Next step', items: ['Run pnpm install to apply changes'] },\n          ],\n          timing: tracker.total(),\n        });\n      }\n\n      return { exitCode: errors.length > 0 ? 1 : 0, result, meta: { timing: tracker.total() } };\n    },\n  },\n});\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default, default as manifest } from './manifest.js';
+import '@kb-labs/perm-presets';

package/dist/index.js

@@ -0,0 +1,127 @@
+import { combinePermissions, generateExamples, defineCommandFlags } from '@kb-labs/sdk';
+import { DEVLINK_CACHE_PREFIX, switchFlags, statusFlags, planFlags, freezeFlags, undoFlags, backupsFlags } from '@kb-labs/devlink-contracts';
+
+// src/manifest.ts
+var pluginPermissions = combinePermissions().withFs({
+  mode: "readWrite",
+  allow: ["**/package.json", ".kb/devlink/**", "**/pnpm-workspace.yaml"]
+}).withPlatform({
+  cache: [DEVLINK_CACHE_PREFIX]
+}).withQuotas({
+  timeoutMs: 18e5,
+  // 30 min — switch --install runs pnpm install in 29 sub-repos
+  memoryMb: 512
+}).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/devlink",
+  version: "1.0.0",
+  display: {
+    name: "DevLink",
+    description: "Manage cross-repo link: \u2194 npm dependencies for KB Labs monorepos.",
+    tags: ["monorepo", "devlink", "dependencies", "publish", "local-dev"]
+  },
+  platform: {
+    requires: ["storage"],
+    optional: []
+  },
+  cli: {
+    commands: [
+      {
+        id: "devlink:switch",
+        group: "devlink",
+        describe: "Switch all cross-repo deps between link: (local) and npm (CI/CD) mode",
+        longDescription: "Replaces all cross-repo @kb-labs/* dependencies across monorepos. Creates a backup before applying. Run pnpm install after switching.",
+        handler: "./cli/commands/switch.js#default",
+        handlerPath: "./cli/commands/switch.js",
+        flags: defineCommandFlags(switchFlags),
+        examples: generateExamples("switch", "devlink", [
+          { description: "Switch to npm mode (CI/CD)", flags: { mode: "npm" } },
+          { description: "Switch to local mode (development)", flags: { mode: "local" } },
+          { description: "Preview changes without applying", flags: { mode: "local", "dry-run": true } },
+          { description: "Switch specific repos only", flags: { mode: "npm", repos: "kb-labs-cli,kb-labs-core" } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:status",
+        group: "devlink",
+        describe: "Show current state of cross-repo dependencies",
+        longDescription: "Displays the current linking mode, counts of link: vs npm dependencies, and any discrepancies across all monorepos.",
+        handler: "./cli/commands/status.js#default",
+        handlerPath: "./cli/commands/status.js",
+        flags: defineCommandFlags(statusFlags),
+        examples: generateExamples("status", "devlink", [
+          { description: "Show summary status", flags: {} },
+          { description: "Verbose output with all deps", flags: { verbose: true } },
+          { description: "JSON output for scripting", flags: { json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:plan",
+        group: "devlink",
+        describe: "Preview what would change when switching mode",
+        longDescription: "Shows all dependency changes that would be made without applying them. Useful for reviewing before running switch.",
+        handler: "./cli/commands/plan.js#default",
+        handlerPath: "./cli/commands/plan.js",
+        flags: defineCommandFlags(planFlags),
+        examples: generateExamples("plan", "devlink", [
+          { description: "Plan switch to local mode", flags: { mode: "local" } },
+          { description: "Plan switch to npm mode", flags: { mode: "npm" } },
+          { description: "JSON output for scripting", flags: { mode: "npm", json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:freeze",
+        group: "devlink",
+        describe: "Freeze current dependency state to lock file",
+        longDescription: "Saves a snapshot of current dependency mode to .kb/devlink/lock.json. Use to record a stable known-good state.",
+        handler: "./cli/commands/freeze.js#default",
+        handlerPath: "./cli/commands/freeze.js",
+        flags: defineCommandFlags(freezeFlags),
+        examples: generateExamples("freeze", "devlink", [
+          { description: "Freeze current state", flags: {} },
+          { description: "JSON output", flags: { json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:undo",
+        group: "devlink",
+        describe: "Restore previous dependency state from last backup",
+        longDescription: "Restores package.json files from the most recent backup created by switch. Run pnpm install after undoing.",
+        handler: "./cli/commands/undo.js#default",
+        handlerPath: "./cli/commands/undo.js",
+        flags: defineCommandFlags(undoFlags),
+        examples: generateExamples("undo", "devlink", [
+          { description: "Undo last switch", flags: {} },
+          { description: "JSON output", flags: { json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:backups",
+        group: "devlink",
+        describe: "List and restore backups",
+        longDescription: "Lists all available backups. Use --restore <id> to restore a specific backup.",
+        handler: "./cli/commands/backups.js#default",
+        handlerPath: "./cli/commands/backups.js",
+        flags: defineCommandFlags(backupsFlags),
+        examples: generateExamples("backups", "devlink", [
+          { description: "List all backups", flags: {} },
+          { description: "JSON output", flags: { json: true } },
+          { description: "Restore specific backup", flags: { restore: "<backup-id>" } }
+        ]),
+        permissions: pluginPermissions
+      }
+    ]
+  },
+  permissions: pluginPermissions
+};
+var manifest_default = manifest;
+
+export { manifest_default as default, manifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { defineCommandFlags, combinePermissions, generateExamples } from '@kb-labs/sdk';\nimport {\n  switchFlags,\n  statusFlags,\n  planFlags,\n  freezeFlags,\n  undoFlags,\n  backupsFlags,\n  DEVLINK_CACHE_PREFIX,\n} from '@kb-labs/devlink-contracts';\n\nconst pluginPermissions = combinePermissions()\n  .withFs({\n    mode: 'readWrite',\n    allow: ['**/package.json', '.kb/devlink/**', '**/pnpm-workspace.yaml'],\n  })\n  .withPlatform({\n    cache: [DEVLINK_CACHE_PREFIX],\n  })\n  .withQuotas({\n    timeoutMs: 1800000, // 30 min — switch --install runs pnpm install in 29 sub-repos\n    memoryMb: 512,\n  })\n  .build();\n\nexport const manifest = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/devlink',\n  version: '1.0.0',\n\n  display: {\n    name: 'DevLink',\n    description: 'Manage cross-repo link: ↔ npm dependencies for KB Labs monorepos.',\n    tags: ['monorepo', 'devlink', 'dependencies', 'publish', 'local-dev'],\n  },\n\n  platform: {\n    requires: ['storage'],\n    optional: [],\n  },\n\n  cli: {\n    commands: [\n      {\n        id: 'devlink:switch',\n        group: 'devlink',\n        describe: 'Switch all cross-repo deps between link: (local) and npm (CI/CD) mode',\n        longDescription:\n          'Replaces all cross-repo @kb-labs/* dependencies across monorepos. ' +\n          'Creates a backup before applying. Run pnpm install after switching.',\n\n        handler: './cli/commands/switch.js#default',\n        handlerPath: './cli/commands/switch.js',\n\n        flags: defineCommandFlags(switchFlags),\n\n        examples: generateExamples('switch', 'devlink', [\n          { description: 'Switch to npm mode (CI/CD)', flags: { mode: 'npm' } },\n          { description: 'Switch to local mode (development)', flags: { mode: 'local' } },\n          { description: 'Preview changes without applying', flags: { mode: 'local', 'dry-run': true } },\n          { description: 'Switch specific repos only', flags: { mode: 'npm', repos: 'kb-labs-cli,kb-labs-core' } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:status',\n        group: 'devlink',\n        describe: 'Show current state of cross-repo dependencies',\n        longDescription:\n          'Displays the current linking mode, counts of link: vs npm dependencies, ' +\n          'and any discrepancies across all monorepos.',\n\n        handler: './cli/commands/status.js#default',\n        handlerPath: './cli/commands/status.js',\n\n        flags: defineCommandFlags(statusFlags),\n\n        examples: generateExamples('status', 'devlink', [\n          { description: 'Show summary status', flags: {} },\n          { description: 'Verbose output with all deps', flags: { verbose: true } },\n          { description: 'JSON output for scripting', flags: { json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:plan',\n        group: 'devlink',\n        describe: 'Preview what would change when switching mode',\n        longDescription:\n          'Shows all dependency changes that would be made without applying them. ' +\n          'Useful for reviewing before running switch.',\n\n        handler: './cli/commands/plan.js#default',\n        handlerPath: './cli/commands/plan.js',\n\n        flags: defineCommandFlags(planFlags),\n\n        examples: generateExamples('plan', 'devlink', [\n          { description: 'Plan switch to local mode', flags: { mode: 'local' } },\n          { description: 'Plan switch to npm mode', flags: { mode: 'npm' } },\n          { description: 'JSON output for scripting', flags: { mode: 'npm', json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:freeze',\n        group: 'devlink',\n        describe: 'Freeze current dependency state to lock file',\n        longDescription:\n          'Saves a snapshot of current dependency mode to .kb/devlink/lock.json. ' +\n          'Use to record a stable known-good state.',\n\n        handler: './cli/commands/freeze.js#default',\n        handlerPath: './cli/commands/freeze.js',\n\n        flags: defineCommandFlags(freezeFlags),\n\n        examples: generateExamples('freeze', 'devlink', [\n          { description: 'Freeze current state', flags: {} },\n          { description: 'JSON output', flags: { json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:undo',\n        group: 'devlink',\n        describe: 'Restore previous dependency state from last backup',\n        longDescription:\n          'Restores package.json files from the most recent backup created by switch. ' +\n          'Run pnpm install after undoing.',\n\n        handler: './cli/commands/undo.js#default',\n        handlerPath: './cli/commands/undo.js',\n\n        flags: defineCommandFlags(undoFlags),\n\n        examples: generateExamples('undo', 'devlink', [\n          { description: 'Undo last switch', flags: {} },\n          { description: 'JSON output', flags: { json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:backups',\n        group: 'devlink',\n        describe: 'List and restore backups',\n        longDescription:\n          'Lists all available backups. Use --restore <id> to restore a specific backup.',\n\n        handler: './cli/commands/backups.js#default',\n        handlerPath: './cli/commands/backups.js',\n\n        flags: defineCommandFlags(backupsFlags),\n\n        examples: generateExamples('backups', 'devlink', [\n          { description: 'List all backups', flags: {} },\n          { description: 'JSON output', flags: { json: true } },\n          { description: 'Restore specific backup', flags: { restore: '<backup-id>' } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n    ],\n  },\n\n  permissions: pluginPermissions,\n};\n\nexport default manifest;\n"]}

package/dist/manifest.d.ts

@@ -0,0 +1,40 @@
+import * as _kb_labs_perm_presets from '@kb-labs/perm-presets';
+
+declare const manifest: {
+    schema: string;
+    id: string;
+    version: string;
+    display: {
+        name: string;
+        description: string;
+        tags: string[];
+    };
+    platform: {
+        requires: string[];
+        optional: never[];
+    };
+    cli: {
+        commands: {
+            id: string;
+            group: string;
+            describe: string;
+            longDescription: string;
+            handler: string;
+            handlerPath: string;
+            flags: {
+                name: string;
+                type: "string" | "boolean" | "number" | "array";
+                alias?: string;
+                default?: unknown;
+                description?: string;
+                choices?: string[];
+                required?: boolean;
+            }[];
+            examples: string[];
+            permissions: _kb_labs_perm_presets.RuntimePermissionSpec;
+        }[];
+    };
+    permissions: _kb_labs_perm_presets.RuntimePermissionSpec;
+};
+
+export { manifest as default, manifest };

package/dist/manifest.js

@@ -0,0 +1,127 @@
+import { combinePermissions, generateExamples, defineCommandFlags } from '@kb-labs/sdk';
+import { DEVLINK_CACHE_PREFIX, switchFlags, statusFlags, planFlags, freezeFlags, undoFlags, backupsFlags } from '@kb-labs/devlink-contracts';
+
+// src/manifest.ts
+var pluginPermissions = combinePermissions().withFs({
+  mode: "readWrite",
+  allow: ["**/package.json", ".kb/devlink/**", "**/pnpm-workspace.yaml"]
+}).withPlatform({
+  cache: [DEVLINK_CACHE_PREFIX]
+}).withQuotas({
+  timeoutMs: 18e5,
+  // 30 min — switch --install runs pnpm install in 29 sub-repos
+  memoryMb: 512
+}).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/devlink",
+  version: "1.0.0",
+  display: {
+    name: "DevLink",
+    description: "Manage cross-repo link: \u2194 npm dependencies for KB Labs monorepos.",
+    tags: ["monorepo", "devlink", "dependencies", "publish", "local-dev"]
+  },
+  platform: {
+    requires: ["storage"],
+    optional: []
+  },
+  cli: {
+    commands: [
+      {
+        id: "devlink:switch",
+        group: "devlink",
+        describe: "Switch all cross-repo deps between link: (local) and npm (CI/CD) mode",
+        longDescription: "Replaces all cross-repo @kb-labs/* dependencies across monorepos. Creates a backup before applying. Run pnpm install after switching.",
+        handler: "./cli/commands/switch.js#default",
+        handlerPath: "./cli/commands/switch.js",
+        flags: defineCommandFlags(switchFlags),
+        examples: generateExamples("switch", "devlink", [
+          { description: "Switch to npm mode (CI/CD)", flags: { mode: "npm" } },
+          { description: "Switch to local mode (development)", flags: { mode: "local" } },
+          { description: "Preview changes without applying", flags: { mode: "local", "dry-run": true } },
+          { description: "Switch specific repos only", flags: { mode: "npm", repos: "kb-labs-cli,kb-labs-core" } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:status",
+        group: "devlink",
+        describe: "Show current state of cross-repo dependencies",
+        longDescription: "Displays the current linking mode, counts of link: vs npm dependencies, and any discrepancies across all monorepos.",
+        handler: "./cli/commands/status.js#default",
+        handlerPath: "./cli/commands/status.js",
+        flags: defineCommandFlags(statusFlags),
+        examples: generateExamples("status", "devlink", [
+          { description: "Show summary status", flags: {} },
+          { description: "Verbose output with all deps", flags: { verbose: true } },
+          { description: "JSON output for scripting", flags: { json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:plan",
+        group: "devlink",
+        describe: "Preview what would change when switching mode",
+        longDescription: "Shows all dependency changes that would be made without applying them. Useful for reviewing before running switch.",
+        handler: "./cli/commands/plan.js#default",
+        handlerPath: "./cli/commands/plan.js",
+        flags: defineCommandFlags(planFlags),
+        examples: generateExamples("plan", "devlink", [
+          { description: "Plan switch to local mode", flags: { mode: "local" } },
+          { description: "Plan switch to npm mode", flags: { mode: "npm" } },
+          { description: "JSON output for scripting", flags: { mode: "npm", json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:freeze",
+        group: "devlink",
+        describe: "Freeze current dependency state to lock file",
+        longDescription: "Saves a snapshot of current dependency mode to .kb/devlink/lock.json. Use to record a stable known-good state.",
+        handler: "./cli/commands/freeze.js#default",
+        handlerPath: "./cli/commands/freeze.js",
+        flags: defineCommandFlags(freezeFlags),
+        examples: generateExamples("freeze", "devlink", [
+          { description: "Freeze current state", flags: {} },
+          { description: "JSON output", flags: { json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:undo",
+        group: "devlink",
+        describe: "Restore previous dependency state from last backup",
+        longDescription: "Restores package.json files from the most recent backup created by switch. Run pnpm install after undoing.",
+        handler: "./cli/commands/undo.js#default",
+        handlerPath: "./cli/commands/undo.js",
+        flags: defineCommandFlags(undoFlags),
+        examples: generateExamples("undo", "devlink", [
+          { description: "Undo last switch", flags: {} },
+          { description: "JSON output", flags: { json: true } }
+        ]),
+        permissions: pluginPermissions
+      },
+      {
+        id: "devlink:backups",
+        group: "devlink",
+        describe: "List and restore backups",
+        longDescription: "Lists all available backups. Use --restore <id> to restore a specific backup.",
+        handler: "./cli/commands/backups.js#default",
+        handlerPath: "./cli/commands/backups.js",
+        flags: defineCommandFlags(backupsFlags),
+        examples: generateExamples("backups", "devlink", [
+          { description: "List all backups", flags: {} },
+          { description: "JSON output", flags: { json: true } },
+          { description: "Restore specific backup", flags: { restore: "<backup-id>" } }
+        ]),
+        permissions: pluginPermissions
+      }
+    ]
+  },
+  permissions: pluginPermissions
+};
+var manifest_default = manifest;
+
+export { manifest_default as default, manifest };
+//# sourceMappingURL=manifest.js.map
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":"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","file":"manifest.js","sourcesContent":["import { defineCommandFlags, combinePermissions, generateExamples } from '@kb-labs/sdk';\nimport {\n  switchFlags,\n  statusFlags,\n  planFlags,\n  freezeFlags,\n  undoFlags,\n  backupsFlags,\n  DEVLINK_CACHE_PREFIX,\n} from '@kb-labs/devlink-contracts';\n\nconst pluginPermissions = combinePermissions()\n  .withFs({\n    mode: 'readWrite',\n    allow: ['**/package.json', '.kb/devlink/**', '**/pnpm-workspace.yaml'],\n  })\n  .withPlatform({\n    cache: [DEVLINK_CACHE_PREFIX],\n  })\n  .withQuotas({\n    timeoutMs: 1800000, // 30 min — switch --install runs pnpm install in 29 sub-repos\n    memoryMb: 512,\n  })\n  .build();\n\nexport const manifest = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/devlink',\n  version: '1.0.0',\n\n  display: {\n    name: 'DevLink',\n    description: 'Manage cross-repo link: ↔ npm dependencies for KB Labs monorepos.',\n    tags: ['monorepo', 'devlink', 'dependencies', 'publish', 'local-dev'],\n  },\n\n  platform: {\n    requires: ['storage'],\n    optional: [],\n  },\n\n  cli: {\n    commands: [\n      {\n        id: 'devlink:switch',\n        group: 'devlink',\n        describe: 'Switch all cross-repo deps between link: (local) and npm (CI/CD) mode',\n        longDescription:\n          'Replaces all cross-repo @kb-labs/* dependencies across monorepos. ' +\n          'Creates a backup before applying. Run pnpm install after switching.',\n\n        handler: './cli/commands/switch.js#default',\n        handlerPath: './cli/commands/switch.js',\n\n        flags: defineCommandFlags(switchFlags),\n\n        examples: generateExamples('switch', 'devlink', [\n          { description: 'Switch to npm mode (CI/CD)', flags: { mode: 'npm' } },\n          { description: 'Switch to local mode (development)', flags: { mode: 'local' } },\n          { description: 'Preview changes without applying', flags: { mode: 'local', 'dry-run': true } },\n          { description: 'Switch specific repos only', flags: { mode: 'npm', repos: 'kb-labs-cli,kb-labs-core' } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:status',\n        group: 'devlink',\n        describe: 'Show current state of cross-repo dependencies',\n        longDescription:\n          'Displays the current linking mode, counts of link: vs npm dependencies, ' +\n          'and any discrepancies across all monorepos.',\n\n        handler: './cli/commands/status.js#default',\n        handlerPath: './cli/commands/status.js',\n\n        flags: defineCommandFlags(statusFlags),\n\n        examples: generateExamples('status', 'devlink', [\n          { description: 'Show summary status', flags: {} },\n          { description: 'Verbose output with all deps', flags: { verbose: true } },\n          { description: 'JSON output for scripting', flags: { json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:plan',\n        group: 'devlink',\n        describe: 'Preview what would change when switching mode',\n        longDescription:\n          'Shows all dependency changes that would be made without applying them. ' +\n          'Useful for reviewing before running switch.',\n\n        handler: './cli/commands/plan.js#default',\n        handlerPath: './cli/commands/plan.js',\n\n        flags: defineCommandFlags(planFlags),\n\n        examples: generateExamples('plan', 'devlink', [\n          { description: 'Plan switch to local mode', flags: { mode: 'local' } },\n          { description: 'Plan switch to npm mode', flags: { mode: 'npm' } },\n          { description: 'JSON output for scripting', flags: { mode: 'npm', json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:freeze',\n        group: 'devlink',\n        describe: 'Freeze current dependency state to lock file',\n        longDescription:\n          'Saves a snapshot of current dependency mode to .kb/devlink/lock.json. ' +\n          'Use to record a stable known-good state.',\n\n        handler: './cli/commands/freeze.js#default',\n        handlerPath: './cli/commands/freeze.js',\n\n        flags: defineCommandFlags(freezeFlags),\n\n        examples: generateExamples('freeze', 'devlink', [\n          { description: 'Freeze current state', flags: {} },\n          { description: 'JSON output', flags: { json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:undo',\n        group: 'devlink',\n        describe: 'Restore previous dependency state from last backup',\n        longDescription:\n          'Restores package.json files from the most recent backup created by switch. ' +\n          'Run pnpm install after undoing.',\n\n        handler: './cli/commands/undo.js#default',\n        handlerPath: './cli/commands/undo.js',\n\n        flags: defineCommandFlags(undoFlags),\n\n        examples: generateExamples('undo', 'devlink', [\n          { description: 'Undo last switch', flags: {} },\n          { description: 'JSON output', flags: { json: true } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n      {\n        id: 'devlink:backups',\n        group: 'devlink',\n        describe: 'List and restore backups',\n        longDescription:\n          'Lists all available backups. Use --restore <id> to restore a specific backup.',\n\n        handler: './cli/commands/backups.js#default',\n        handlerPath: './cli/commands/backups.js',\n\n        flags: defineCommandFlags(backupsFlags),\n\n        examples: generateExamples('backups', 'devlink', [\n          { description: 'List all backups', flags: {} },\n          { description: 'JSON output', flags: { json: true } },\n          { description: 'Restore specific backup', flags: { restore: '<backup-id>' } },\n        ]),\n\n        permissions: pluginPermissions,\n      },\n    ],\n  },\n\n  permissions: pluginPermissions,\n};\n\nexport default manifest;\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@kb-labs/devlink-cli",
+  "version": "1.4.0",
+  "type": "module",
+  "description": "CLI commands and manifest for DevLink plugin.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "kb": {
+    "manifest": "./dist/manifest.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin-manifest": {
+      "import": "./dist/manifest.js",
+      "types": "./dist/manifest.d.ts"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@kb-labs/devlink-contracts": "^1.0.0",
+    "@kb-labs/devlink-core": "^1.0.0",
+    "@kb-labs/sdk": "^1.4.0"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../../infra/kb-labs-devkit",
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}