chkit 0.1.0-beta.9 → 0.1.0

package/dist/internal-plugins/skill-hint/plugin.js

@@ -0,0 +1,60 @@
+import process from 'node:process';
+import { definePlugin } from '../../plugins.js';
+import { findAgentRoot, isSkillInstalledAt, } from './agent-detect.js';
+import { installSkill as defaultInstallSkill, promptInstall as defaultPromptInstall, SKILL_INSTALL_COMMAND, } from './prompt.js';
+import { HINT_INTERVAL_MS, readSkillHintState, writeSkillHintState, } from './state.js';
+export { findAgentRoot, HINT_INTERVAL_MS, SKILL_INSTALL_COMMAND, };
+const defaultDeps = {
+    detectAgent() {
+        return findAgentRoot(process.cwd());
+    },
+    isSkillInstalled() {
+        const { root, agent } = findAgentRoot(process.cwd());
+        return isSkillInstalledAt(root, agent);
+    },
+    readState: readSkillHintState,
+    writeState: writeSkillHintState,
+    promptUser: defaultPromptInstall,
+    installSkill: defaultInstallSkill,
+    now: () => Date.now(),
+};
+export function createSkillHintPlugin(overrides) {
+    const deps = { ...defaultDeps, ...overrides };
+    let pendingMessage;
+    return definePlugin({
+        manifest: {
+            name: '@chkit/internal-skill-hint',
+            apiVersion: 1,
+        },
+        hooks: {
+            async onInit(ctx) {
+                if (!ctx.isInteractive || ctx.jsonMode)
+                    return;
+                if (deps.isSkillInstalled())
+                    return;
+                const state = deps.readState();
+                if (state.lastDismissed) {
+                    const elapsed = deps.now() - new Date(state.lastDismissed).getTime();
+                    if (elapsed < HINT_INTERVAL_MS)
+                        return;
+                }
+                const { agent } = deps.detectAgent();
+                const accepted = await deps.promptUser(agent);
+                if (accepted) {
+                    await deps.installSkill();
+                }
+                else {
+                    deps.writeState({ lastDismissed: new Date(deps.now()).toISOString() });
+                    pendingMessage = `You can install it later with: ${SKILL_INSTALL_COMMAND}`;
+                }
+            },
+            onComplete(ctx) {
+                if (pendingMessage && !ctx.jsonMode && ctx.exitCode === 0) {
+                    console.error('');
+                    console.error(pendingMessage);
+                }
+            },
+        },
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/internal-plugins/skill-hint/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/internal-plugins/skill-hint/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,YAAY,EAAkB,MAAM,kBAAkB,CAAA;AAE/D,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,YAAY,IAAI,mBAAmB,EACnC,aAAa,IAAI,oBAAoB,EACrC,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GAGtB,CAAA;AAYD,MAAM,WAAW,GAAkB;IACjC,WAAW;QACT,OAAO,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,gBAAgB;QACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACpD,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACxC,CAAC;IACD,SAAS,EAAE,kBAAkB;IAC7B,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,oBAAoB;IAChC,YAAY,EAAE,mBAAmB;IACjC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;CACtB,CAAA;AAED,MAAM,UAAU,qBAAqB,CAAC,SAAkC;IACtE,MAAM,IAAI,GAAkB,EAAE,GAAG,WAAW,EAAE,GAAG,SAAS,EAAE,CAAA;IAC5D,IAAI,cAAkC,CAAA;IAEtC,OAAO,YAAY,CAAC;QAClB,QAAQ,EAAE;YACR,IAAI,EAAE,4BAA4B;YAClC,UAAU,EAAE,CAAC;SACd;QACD,KAAK,EAAE;YACL,KAAK,CAAC,MAAM,CAAC,GAAG;gBACd,IAAI,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,QAAQ;oBAAE,OAAM;gBAC9C,IAAI,IAAI,CAAC,gBAAgB,EAAE;oBAAE,OAAM;gBAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;gBAC9B,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;oBACxB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,CAAA;oBACpE,IAAI,OAAO,GAAG,gBAAgB;wBAAE,OAAM;gBACxC,CAAC;gBAED,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;gBACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;gBAC7C,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;gBAC3B,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;oBACtE,cAAc,GAAG,kCAAkC,qBAAqB,EAAE,CAAA;gBAC5E,CAAC;YACH,CAAC;YAED,UAAU,CAAC,GAAG;gBACZ,IAAI,cAAc,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC1D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;oBACjB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;gBAC/B,CAAC;YACH,CAAC;SACF;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/internal-plugins/skill-hint/prompt.d.ts

@@ -0,0 +1,5 @@
+import { type AgentKind } from './agent-detect.js';
+export declare const SKILL_INSTALL_COMMAND = "npx skills add obsessiondb/chkit";
+export declare function promptInstall(agent: AgentKind): Promise<boolean>;
+export declare function installSkill(): Promise<boolean>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/internal-plugins/skill-hint/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/internal-plugins/skill-hint/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEjF,eAAO,MAAM,qBAAqB,qCAAqC,CAAA;AAEvE,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBtE;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAarD"}

package/dist/internal-plugins/skill-hint/prompt.js

@@ -0,0 +1,37 @@
+import process from 'node:process';
+import { AGENT_REGISTRY, findAgentRoot } from './agent-detect.js';
+export const SKILL_INSTALL_COMMAND = 'npx skills add obsessiondb/chkit';
+export async function promptInstall(agent) {
+    const { createInterface } = await import('node:readline/promises');
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        const agentLabel = agent !== 'unknown' ? AGENT_REGISTRY[agent].name : undefined;
+        console.error('');
+        console.error(agentLabel
+            ? `chkit has an AI agent skill for ${agentLabel}.`
+            : 'chkit has an AI agent skill available.');
+        console.error(`Install it with: ${SKILL_INSTALL_COMMAND}`);
+        console.error('');
+        const answer = await rl.question('Install now? [y/N] ');
+        return answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function installSkill() {
+    const { execSync } = await import('node:child_process');
+    try {
+        console.error('');
+        execSync(SKILL_INSTALL_COMMAND, {
+            cwd: findAgentRoot(process.cwd()).root,
+            stdio: 'inherit',
+        });
+        return true;
+    }
+    catch {
+        console.error(`Failed to install. Run manually: ${SKILL_INSTALL_COMMAND}`);
+        return false;
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/internal-plugins/skill-hint/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/internal-plugins/skill-hint/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAA;AAEjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,kCAAkC,CAAA;AAEvE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAgB;IAClD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;IAClE,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5E,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QAC/E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACjB,OAAO,CAAC,KAAK,CACX,UAAU;YACR,CAAC,CAAC,mCAAmC,UAAU,GAAG;YAClD,CAAC,CAAC,wCAAwC,CAC7C,CAAA;QACD,OAAO,CAAC,KAAK,CAAC,oBAAoB,qBAAqB,EAAE,CAAC,CAAA;QAC1D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACjB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;QACvD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAA;IACrF,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;IACvD,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACjB,QAAQ,CAAC,qBAAqB,EAAE;YAC9B,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI;YACtC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,oCAAoC,qBAAqB,EAAE,CAAC,CAAA;QAC1E,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/internal-plugins/skill-hint/state.d.ts

@@ -0,0 +1,7 @@
+export interface SkillHintState {
+    lastDismissed?: string;
+}
+export declare const HINT_INTERVAL_MS: number;
+export declare function readSkillHintState(): SkillHintState;
+export declare function writeSkillHintState(state: SkillHintState): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/internal-plugins/skill-hint/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/internal-plugins/skill-hint/state.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,gBAAgB,QAA2B,CAAA;AAUxD,wBAAgB,kBAAkB,IAAI,cAAc,CAMnD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAG/D"}

package/dist/internal-plugins/skill-hint/state.js

@@ -0,0 +1,23 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const HINT_INTERVAL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+function stateDir() {
+    return join(homedir(), '.chkit');
+}
+function stateFilePath() {
+    return join(stateDir(), 'skill-hint.json');
+}
+export function readSkillHintState() {
+    try {
+        return JSON.parse(readFileSync(stateFilePath(), 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeSkillHintState(state) {
+    mkdirSync(stateDir(), { recursive: true });
+    writeFileSync(stateFilePath(), `${JSON.stringify(state, null, 2)}\n`);
+}
+//# sourceMappingURL=state.js.map

package/dist/internal-plugins/skill-hint/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/internal-plugins/skill-hint/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAMhC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,UAAU;AAEnE,SAAS,QAAQ;IACf,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,iBAAiB,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC,CAAmB,CAAA;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAqB;IACvD,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1C,aAAa,CAAC,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;AACvE,CAAC"}

package/dist/plugins.d.ts

@@ -1,24 +1,65 @@
-import type { ChxInlinePluginRegistration, ChxPluginRegistration, FlagDef, MigrationPlan, ParsedFlags, ResolvedChxConfig, SchemaDefinition } from '@chkit/core';
-import type { PluginRuntime } from './bin/plugin-runtime.js';
-import type { TableScope } from './bin/table-scope.js';
-export { defineFlags, parseFlags, typedFlags, MissingFlagValueError, UnknownFlagError, type FlagDef, type InferFlags, type ParsedFlags, } from '@chkit/core';
-export interface CommandDef {
-    name: string;
-    description: string;
-    flags: readonly FlagDef[];
-    run: (ctx: CommandRunContext) => Promise<void>;
-}
-export interface CommandRunContext {
-    command: string;
-    flags: ParsedFlags;
+import type { FlagDef, FlagMapping, MigrationPlan, ParsedFlags, ResolvedChxConfig, SafeParseable, SchemaDefinition } from '@chkit/core';
+import type { ClickHouseExecutor } from '@chkit/clickhouse';
+export { defineFlags, parseFlags, typedFlags, MissingFlagValueError, UnknownFlagError, type FlagDef, type FlagMapping, type InferFlags, type ParsedFlags, type SafeParseable, } from '@chkit/core';
+export interface TableScope {
+    enabled: boolean;
+    selector?: string;
+    matchedTables: string[];
+    matchCount: number;
+}
+export interface LoadedPlugin {
+    options: Record<string, unknown>;
+    rawOptions: Record<string, unknown>;
+    plugin: ChxPlugin;
+    /**
+     * True for built-in plugins (e.g. `core`) loaded by the CLI itself rather
+     * than from the user's config. Their hook/command errors are surfaced raw,
+     * without the `Plugin "<name>" failed in ...` wrapper that only makes sense
+     * for third-party plugins the user explicitly registered.
+     */
+    internal?: boolean;
+}
+export interface PluginRuntime {
+    plugins: ReadonlyArray<LoadedPlugin>;
+    getCommand(pluginName: string, commandName: string): {
+        command: ChxPluginCommand;
+        plugin: LoadedPlugin;
+    } | null;
+    resolveContext(input: Omit<ChxGetContextInput, 'defaults'>): Promise<PluginContext>;
+    disposeContext(ctx: PluginContext): Promise<void>;
+    runOnInit(context: Omit<ChxOnInitContext, 'options'>): Promise<void>;
+    runOnComplete(context: Omit<ChxOnCompleteContext, 'options' | 'exitCode'> & {
+        exitCode?: number;
+    }): Promise<void>;
+    runOnConfigLoaded(context: Omit<ChxOnConfigLoadedContext, 'options' | 'tableScope'> & {
+        tableScope?: TableScope;
+    }): Promise<void>;
+    runOnSchemaLoaded(context: ChxOnSchemaLoadedContext): Promise<SchemaDefinition[]>;
+    runOnPlanCreated(context: Omit<ChxOnPlanCreatedContext, 'plan' | 'tableScope'> & {
+        tableScope?: TableScope;
+    }, plan: MigrationPlan): Promise<MigrationPlan>;
+    runOnBeforeApply(context: ChxOnBeforeApplyContext): Promise<string[]>;
+    runOnAfterApply(context: ChxOnAfterApplyContext): Promise<void>;
+    runOnCheck(context: Omit<ChxOnCheckContext, 'options' | 'tableScope'> & {
+        tableScope?: TableScope;
+    }): Promise<ChxOnCheckResult[]>;
+    runOnCheckReport(results: ChxOnCheckResult[], print: (line: string) => void): Promise<void>;
+    runOnBeforePluginCommand(pluginName: string, commandName: string, context: Omit<ChxOnBeforePluginCommandContext, 'targetPlugin' | 'command' | 'options'>): Promise<ChxOnBeforePluginCommandResult>;
+    runPluginCommand(pluginName: string, commandName: string, context: Omit<ChxPluginCommandContext, 'pluginName' | 'options' | 'rawOptions' | 'tableScope' | 'pluginRuntime' | 'pluginContext'> & {
+        tableScope?: TableScope;
+    }): Promise<number>;
+}
+export interface PluginContext {
+    executor: ClickHouseExecutor;
+    /** True when an executor was provided (either from config or a plugin). False when using the null executor. */
+    hasExecutor: boolean;
+}
+export interface ChxGetContextInput {
     config: ResolvedChxConfig;
     configPath: string;
-    dirs: {
-        outDir: string;
-        migrationsDir: string;
-        metaDir: string;
-    };
-    pluginRuntime: PluginRuntime;
+    command: string;
+    flags: ParsedFlags;
+    defaults: PluginContext;
 }
 export interface CommandExtension {
     command: string | string[];
@@ -46,6 +87,7 @@ export interface ChxOnConfigLoadedContext extends ChxPluginHookContextBase {
     options: Record<string, unknown>;
 }
 export interface ChxOnSchemaLoadedContext extends ChxPluginHookContextBase {
+    jsonMode?: boolean;
     definitions: SchemaDefinition[];
 }
 export interface ChxOnPlanCreatedContext extends ChxPluginHookContextBase {
@@ -61,6 +103,22 @@ export interface ChxOnAfterApplyContext extends ChxPluginHookContextBase {
     statements: string[];
     appliedAt: string;
 }
+export interface ChxOnInitContext {
+    command: string;
+    configPath: string;
+    isInteractive: boolean;
+    jsonMode: boolean;
+    flags: ParsedFlags;
+    config: ResolvedChxConfig;
+    options: Record<string, unknown>;
+}
+export interface ChxOnCompleteContext {
+    command: string;
+    isInteractive: boolean;
+    jsonMode: boolean;
+    exitCode: number;
+    options: Record<string, unknown>;
+}
 export interface ChxCheckFinding {
     code: string;
     message: string;
@@ -80,8 +138,9 @@ export interface ChxOnCheckResult {
     findings: ChxCheckFinding[];
     metadata?: Record<string, unknown>;
 }
-export interface ChxPluginCommandContext {
-    pluginName: string;
+export interface ChxOnBeforePluginCommandContext {
+    targetPlugin: string;
+    command: string;
     config: ResolvedChxConfig;
     configPath: string;
     jsonMode: boolean;
@@ -91,13 +150,39 @@ export interface ChxPluginCommandContext {
     tableScope: TableScope;
     print: (value: unknown) => void;
 }
-export interface ChxPluginCommand {
+export type ChxOnBeforePluginCommandResult = {
+    handled: true;
+    exitCode: number;
+} | {
+    handled: false;
+};
+export interface ChxPluginCommandContext<TOptions = Record<string, unknown>> {
+    pluginName: string;
+    config: ResolvedChxConfig;
+    configPath: string;
+    jsonMode: boolean;
+    args: string[];
+    flags: ParsedFlags;
+    options: TOptions;
+    rawOptions: Record<string, unknown>;
+    tableScope: TableScope;
+    print: (value: unknown) => void;
+    pluginRuntime: PluginRuntime;
+    pluginContext: PluginContext;
+}
+export interface ChxPluginCommand<TOptions = Record<string, unknown>> {
     name: string;
     description?: string;
     flags?: readonly FlagDef[];
-    run: (context: ChxPluginCommandContext) => undefined | number | Promise<undefined | number>;
+    optionsSchema?: SafeParseable<TOptions>;
+    flagMapping?: FlagMapping;
+    run: (context: ChxPluginCommandContext<TOptions>) => undefined | number | Promise<undefined | number>;
 }
 export interface ChxPluginHooks {
+    getContext?: (input: ChxGetContextInput) => PluginContext | Partial<PluginContext> | undefined | Promise<PluginContext | Partial<PluginContext> | undefined>;
+    onInit?: (context: ChxOnInitContext) => void | Promise<void>;
+    onComplete?: (context: ChxOnCompleteContext) => void | Promise<void>;
+    onBeforePluginCommand?: (context: ChxOnBeforePluginCommandContext) => ChxOnBeforePluginCommandResult | Promise<ChxOnBeforePluginCommandResult>;
     onConfigLoaded?: (context: ChxOnConfigLoadedContext) => void | Promise<void>;
     onSchemaLoaded?: (context: ChxOnSchemaLoadedContext) => SchemaDefinition[] | undefined | Promise<SchemaDefinition[] | undefined>;
     onPlanCreated?: (context: ChxOnPlanCreatedContext) => MigrationPlan | undefined | Promise<MigrationPlan | undefined>;
@@ -115,13 +200,10 @@ export interface ChxPluginHooks {
 }
 export interface ChxPlugin {
     manifest: ChxPluginManifest;
+    optionsSchema?: SafeParseable<Record<string, unknown>>;
     hooks?: ChxPluginHooks;
     commands?: ChxPluginCommand[];
     extendCommands?: CommandExtension[];
 }
 export declare function definePlugin(plugin: ChxPlugin): ChxPlugin;
-export declare function definePluginConfig<TOptions extends object = Record<string, unknown>>(registration: Omit<ChxInlinePluginRegistration<ChxPlugin, TOptions>, 'plugin'> & {
-    plugin: ChxPlugin;
-}): ChxInlinePluginRegistration<ChxPlugin, TOptions>;
-export declare function isInlinePluginRegistration(registration: ChxPluginRegistration): registration is ChxInlinePluginRegistration<ChxPlugin>;
 //# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"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"}

package/dist/plugins.js

@@ -2,10 +2,4 @@ export { defineFlags, parseFlags, typedFlags, MissingFlagValueError, UnknownFlag
 export function definePlugin(plugin) {
     return plugin;
 }
-export function definePluginConfig(registration) {
-    return registration;
-}
-export function isInlinePluginRegistration(registration) {
-    return typeof registration === 'object' && registration !== null && 'plugin' in registration;
-}
 //# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,gBAAgB,GAIjB,MAAM,aAAa,CAAA;AAyIpB,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,YAEC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,YAAmC;IAEnC,OAAO,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,IAAI,IAAI,QAAQ,IAAI,YAAY,CAAA;AAC9F,CAAC"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,gBAAgB,GAMjB,MAAM,aAAa,CAAA;AA4QpB,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/runtime/command-dispatch.d.ts

@@ -0,0 +1,18 @@
+import { type FlagDef, type ParsedFlags } from '@chkit/core';
+import { type PluginRuntime } from '../plugins.js';
+import type { CommandRegistry, RegisteredCommand } from './command-registry.js';
+export declare function parseCommandArgs(commandName: string, argv: string[], flagDefs: readonly FlagDef[]): {
+    flags: ParsedFlags;
+    positionals: string[];
+} | null;
+export declare function runResolvedCommand(input: {
+    argv: string[];
+    commandName: string;
+    resolved: RegisteredCommand;
+    registry: CommandRegistry;
+    config: Parameters<PluginRuntime['runOnConfigLoaded']>[0]['config'];
+    configPath: string;
+    pluginRuntime: PluginRuntime;
+    onAmbiguousPluginSubcommand?: () => void;
+}): Promise<void>;
+//# sourceMappingURL=command-dispatch.d.ts.map

package/dist/runtime/command-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-dispatch.d.ts","sourceRoot":"","sources":["../../src/runtime/command-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EAEZ,KAAK,WAAW,EAGhB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAyE/E,wBAAgB,gBAAgB,CAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC1B;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAWtD;AAyED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,QAAQ,EAAE,eAAe,CAAA;IACzB,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACnE,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,aAAa,CAAA;IAC5B,2BAA2B,CAAC,EAAE,MAAM,IAAI,CAAA;CACxC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6GhB"}

package/dist/runtime/command-dispatch.js

@@ -0,0 +1,227 @@
+import { MissingFlagValueError, parseFlags, UnknownFlagError, } from '@chkit/core';
+import { typedFlags } from '../plugins.js';
+import { debug } from './debug.js';
+import { GLOBAL_FLAGS } from './global-flags.js';
+import { printOutput } from './json-output.js';
+import { loadSchemaDefinitions } from './schema-loader.js';
+import { resolveTableScope, tableKeysFromDefinitions } from './table-scope.js';
+function extractPositionals(argv, flagDefs) {
+    const byName = new Map();
+    for (const def of flagDefs)
+        byName.set(def.name, def);
+    const positionals = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (token === undefined)
+            continue;
+        if (!token.startsWith('--')) {
+            positionals.push(token);
+            continue;
+        }
+        const eqIdx = token.indexOf('=');
+        const name = eqIdx === -1 ? token : token.slice(0, eqIdx);
+        const def = byName.get(name);
+        if (def && def.type !== 'boolean' && eqIdx === -1) {
+            i += 1;
+        }
+    }
+    return positionals;
+}
+function splitQueryArgs(argv, flagDefs) {
+    const byName = new Map();
+    for (const def of flagDefs)
+        byName.set(def.name, def);
+    const flagArgs = [];
+    const positionals = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (token === undefined)
+            continue;
+        if (token === '--') {
+            positionals.push(...argv.slice(i + 1));
+            break;
+        }
+        const eqIdx = token.startsWith('--') ? token.indexOf('=') : -1;
+        const name = eqIdx === -1 ? token : token.slice(0, eqIdx);
+        const def = byName.get(name);
+        if (!def) {
+            positionals.push(token);
+            continue;
+        }
+        flagArgs.push(token);
+        if (def.type !== 'boolean' && eqIdx === -1) {
+            const next = argv[i + 1];
+            if (next !== undefined) {
+                flagArgs.push(next);
+                i += 1;
+            }
+        }
+    }
+    return { flagArgs, positionals };
+}
+export function parseCommandArgs(commandName, argv, flagDefs) {
+    if (commandName === 'query') {
+        const { flagArgs, positionals } = splitQueryArgs(argv, flagDefs);
+        const flags = parseFlagsOrReport(flagArgs, flagDefs);
+        if (!flags)
+            return null;
+        return { flags, positionals };
+    }
+    const flags = parseFlagsOrReport(argv, flagDefs);
+    if (!flags)
+        return null;
+    return { flags, positionals: extractPositionals(argv, flagDefs) };
+}
+function stripGlobalFlags(argv) {
+    const rest = [];
+    let jsonMode = false;
+    let tableSelector;
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (token === '--json') {
+            jsonMode = true;
+            continue;
+        }
+        if (token === '--config' && i + 1 < argv.length) {
+            i++;
+            continue;
+        }
+        if (token.startsWith('--config=')) {
+            continue;
+        }
+        if (token === '--table' && i + 1 < argv.length) {
+            tableSelector = argv[i + 1];
+            i++;
+            continue;
+        }
+        if (token.startsWith('--table=')) {
+            tableSelector = token.slice('--table='.length);
+            continue;
+        }
+        rest.push(token);
+    }
+    return { jsonMode, tableSelector, rest };
+}
+function parseFlagsOrReport(args, defs) {
+    try {
+        return parseFlags(args, defs);
+    }
+    catch (error) {
+        if (error instanceof UnknownFlagError ||
+            error instanceof MissingFlagValueError) {
+            console.error(error.message);
+            process.exitCode = 1;
+            return null;
+        }
+        throw error;
+    }
+}
+async function resolvePluginTableScope(input) {
+    try {
+        const definitions = await loadSchemaDefinitions(input.schemaGlobs);
+        return resolveTableScope(input.tableSelector, tableKeysFromDefinitions(definitions));
+    }
+    catch {
+        return resolveTableScope(input.tableSelector, []);
+    }
+}
+export async function runResolvedCommand(input) {
+    debug('dispatch', `routing to plugin command "${input.commandName}"`);
+    const argsAfterCommand = input.argv.slice(1);
+    let subcommandName;
+    if (input.resolved.subcommands) {
+        const commandPositionals = extractPositionals(argsAfterCommand, [
+            ...input.registry.globalFlags,
+            ...input.resolved.flags,
+        ]);
+        const commandToken = commandPositionals[0];
+        const matchedSub = input.resolved.subcommands.find((s) => s.name === commandToken);
+        if (matchedSub) {
+            subcommandName = matchedSub.name;
+        }
+        else if (input.resolved.subcommands.length === 1) {
+            subcommandName = input.resolved.subcommands[0]?.name;
+        }
+        else {
+            input.onAmbiguousPluginSubcommand?.();
+            return;
+        }
+    }
+    const isPluginCommandForwarder = input.commandName === 'plugin';
+    const isQuery = input.commandName === 'query';
+    let flags;
+    let positionals = [];
+    if (isPluginCommandForwarder) {
+        // The plugin command forwards unparsed args to a target plugin command,
+        // so we only strip known global flags and pass the rest through.
+        const { jsonMode, tableSelector, rest } = stripGlobalFlags(argsAfterCommand);
+        const parsed = {};
+        if (jsonMode)
+            parsed['--json'] = true;
+        if (tableSelector)
+            parsed['--table'] = tableSelector;
+        flags = parsed;
+        positionals = rest;
+    }
+    else {
+        const allFlags = input.registry.resolveFlags(input.commandName, subcommandName);
+        if (isQuery) {
+            const parsed = parseCommandArgs(input.commandName, argsAfterCommand, allFlags);
+            if (!parsed)
+                return;
+            flags = parsed.flags;
+            positionals = parsed.positionals;
+        }
+        else {
+            const parsedFlags = parseFlagsOrReport(argsAfterCommand, allFlags);
+            if (!parsedFlags)
+                return;
+            flags = parsedFlags;
+            positionals = extractPositionals(argsAfterCommand, allFlags);
+        }
+    }
+    const gf = typedFlags(flags, GLOBAL_FLAGS);
+    const jsonMode = gf['--json'] === true;
+    const tableScope = await resolvePluginTableScope({
+        schemaGlobs: input.config.schema,
+        tableSelector: gf['--table'],
+    });
+    const pluginName = input.resolved.pluginName ?? input.commandName;
+    const pluginCommandName = subcommandName ?? input.commandName;
+    if (pluginName !== 'core') {
+        try {
+            await input.pluginRuntime.runOnConfigLoaded({
+                command: input.commandName,
+                config: input.config,
+                configPath: input.configPath,
+                tableScope,
+                flags,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (jsonMode) {
+                console.log(JSON.stringify({ ok: false, error: message }));
+            }
+            else {
+                console.error(message);
+            }
+            process.exitCode = 2;
+            return;
+        }
+    }
+    const exitCode = await input.pluginRuntime.runPluginCommand(pluginName, pluginCommandName, {
+        config: input.config,
+        configPath: input.configPath,
+        jsonMode,
+        tableScope,
+        args: positionals,
+        flags,
+        print(value) {
+            printOutput(value, jsonMode);
+        },
+    });
+    if (exitCode !== 0)
+        process.exitCode = exitCode;
+}
+//# sourceMappingURL=command-dispatch.js.map