@kb-labs/cli-commands 2.89.0 → 2.94.0

package/dist/{discover-Cz7X5bQp.d.ts → discover-CCE84_5E.d.ts}

@@ -1,4 +1,4 @@
-import { ManifestV3 } from '@kb-labs/plugin-contracts';
+import { ManifestV3, PluginContextV3 } from '@kb-labs/plugin-contracts';
 
 /**
  * @kb-labs/cli-commands/registry
@@ -27,12 +27,15 @@ interface CommandManifest {
     permissions?: string[];
     telemetry?: 'opt-in' | 'off';
     manifestV2?: ManifestV3;
+    pkgRoot?: string;
+    /** Internal flag: true for synthetic "unavailable" manifests that must not be cached. */
+    _synthetic?: boolean;
 }
 interface FlagDefinition {
     name: string;
     type: "string" | "boolean" | "number" | "array";
     alias?: string;
-    default?: any;
+    default?: unknown;
     description?: string;
     describe?: string;
     choices?: string[];
@@ -50,17 +53,20 @@ interface RegisteredCommand {
     shadowed: boolean;
     pkgRoot?: string;
     packageName?: string;
+    /** Lifecycle dispose hook, set by manifest module if it exports `dispose`. */
+    _disposeHook?: () => Promise<void>;
 }
 interface CommandModule {
-    run: (ctx: any, argv: string[], flags: Record<string, any>) => Promise<number | void>;
+    run: (ctx: unknown, argv: string[], flags: Record<string, unknown>) => Promise<number | void>;
 }
 interface DiscoveryResult {
     source: 'workspace' | 'node_modules' | 'linked' | 'builtin';
     /**
      * Scope this result came from. Platform-wide discovery (monorepo workspace,
      * platform node_modules) reports `platform`; discovery from
-     * `<projectRoot>/.kb/plugins/` reports `project`. On collision (same
-     * packageName in both scopes) the platform entry wins — see ADR-0012.
+     * `<projectRoot>/.kb/plugins/` or `<projectRoot>` workspace reports `project`.
+     * On collision (same packageName in both scopes) the project entry wins —
+     * project overrides platform defaults.
      */
     scope: 'platform' | 'project';
     packageName: string;
@@ -121,7 +127,7 @@ type AvailabilityCheck = {
  */
 
 interface CommandRun {
-    (ctx: any, argv: string[], flags: Record<string, any>): Promise<number | void>;
+    (ctx: PluginContextV3, argv: string[], flags: Record<string, unknown>): Promise<number | void>;
 }
 interface Command {
     name: string;
@@ -142,10 +148,10 @@ interface CommandGroup {
 interface CommandRegistry {
     register(cmd: Command): void;
     registerGroup(group: CommandGroup): void;
-    registerManifest(cmd: any): void;
+    registerManifest(cmd: RegisteredCommand): void;
     list(): Command[];
     listGroups(): CommandGroup[];
-    listManifests(): any[];
+    listManifests(): RegisteredCommand[];
     markPartial(isPartial: boolean): void;
     isPartial(): boolean;
 }
@@ -243,9 +249,7 @@ declare function findCommandWithType(nameOrPath: string | string[]): CommandLook
  * Create loader stub for ManifestV3 commands.
  * Loader should never be executed directly – CLI adapters must handle execution.
  */
-declare function createManifestV3Loader(commandId: string): () => Promise<{
-    run: any;
-}>;
+declare function createManifestV3Loader(commandId: string): () => Promise<CommandModule>;
 /**
  * Ensure manifest has loader function (rehydrate after JSON serialization).
  */
@@ -284,4 +288,4 @@ declare function discoverManifests(cwd: string, noCache?: boolean, options?: {
  */
 declare function discoverManifestsByNamespace(cwd: string, namespace: string, noCache?: boolean): Promise<DiscoveryResult[]>;
 
-export { type AvailabilityCheck as A, type CommandGroup as C, type DiscoveryResult as D, type FlagDefinition as F, type GlobalFlags as G, type ProductGroup as P, type RegisteredCommand as R, __test as _, type Command as a, type CacheFile as b, type CommandLookupResult as c, type CommandManifest as d, type CommandModule as e, type CommandType as f, type PackageCacheEntry as g, discoverManifests as h, discoverManifestsByNamespace as i, findCommand as j, findCommandWithType as k, resetInProcCache as l, registry as r };
+export { type AvailabilityCheck as A, type CommandGroup as C, type DiscoveryResult as D, type FlagDefinition as F, type GlobalFlags as G, type ProductGroup as P, type RegisteredCommand as R, __test as _, type Command as a, type CacheFile as b, type CommandLookupResult as c, type CommandManifest as d, type CommandModule as e, type CommandType as f, type PackageCacheEntry as g, discoverManifests as h, discoverManifestsByNamespace as i, findCommand as j, findCommandWithType as k, type CommandRegistry as l, resetInProcCache as m, registry as r };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CommandGroup, P as ProductGroup, a as Command, R as RegisteredCommand } from './discover-Cz7X5bQp.js';
-export { A as AvailabilityCheck, b as CacheFile, c as CommandLookupResult, d as CommandManifest, e as CommandModule, f as CommandType, D as DiscoveryResult, F as FlagDefinition, G as GlobalFlags, g as PackageCacheEntry, h as discoverManifests, i as discoverManifestsByNamespace, j as findCommand, k as findCommandWithType, r as registry } from './discover-Cz7X5bQp.js';
+import { C as CommandGroup, P as ProductGroup, a as Command, R as RegisteredCommand } from './discover-CCE84_5E.js';
+export { A as AvailabilityCheck, b as CacheFile, c as CommandLookupResult, d as CommandManifest, e as CommandModule, f as CommandType, D as DiscoveryResult, F as FlagDefinition, G as GlobalFlags, g as PackageCacheEntry, h as discoverManifests, i as discoverManifestsByNamespace, j as findCommand, k as findCommandWithType, r as registry } from './discover-CCE84_5E.js';
 import { ILogger } from '@kb-labs/core-platform';
 export { TimingTracker } from '@kb-labs/shared-cli-ui';
 import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';