@kb-labs/commit-contracts 0.6.0

package/dist/index.d.ts

@@ -0,0 +1,2410 @@
+import { PluginArtifactIds, PluginCommandIds } from './contract.js';
+export { pluginContractsManifest } from './contract.js';
+import { z } from 'zod';
+export { ActionsResponse, ActionsResponseSchema, ApplyInput, ApplyInputSchema, ApplyOutput, ApplyOutputSchema, ApplyResult, ApplyResultSchema, CommitGroup, CommitGroupSchema, CommitPlan, CommitPlanSchema, CommitReasoning, CommitReasoningSchema, CommitRunInput, CommitRunInputSchema, CommitRunOutput, CommitRunOutputSchema, ConventionalType, ConventionalTypeSchema, FileSummary, FileSummarySchema, GenerateInput, GenerateInputSchema, GenerateOutput, GenerateOutputSchema, GitStatus, GitStatusSchema, GitStatusSnapshot, GitStatusSnapshotSchema, OpenInput, OpenInputSchema, OpenOutput, OpenOutputSchema, PushInput, PushInputSchema, PushOutput, PushOutputSchema, PushResult, PushResultSchema, ReleaseHint, ReleaseHintSchema, ResetOutput, ResetOutputSchema } from './schema.js';
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_shared_cli_ui from '@kb-labs/shared-cli-ui';
+
+/**
+ * Type-safe helper functions for contracts
+ * @module @kb-labs/commit-contracts/helpers
+ */
+
+/**
+ * Get artifact path pattern by ID (type-safe)
+ *
+ * @example
+ * const path = getArtifactPath('commit.plan.json');
+ * // Returns: '.kb/commit/current/plan.json'
+ */
+declare function getArtifactPath<T extends PluginArtifactIds>(id: T): string;
+/**
+ * Get artifact metadata by ID (type-safe)
+ *
+ * @example
+ * const artifact = getArtifact('commit.plan.json');
+ * // artifact.kind, artifact.description, etc.
+ */
+declare function getArtifact<T extends PluginArtifactIds>(id: T): {
+    readonly "commit.plan.json": {
+        readonly id: "commit.plan.json";
+        readonly kind: "json";
+        readonly description: "Current commit plan generated by LLM analysis of git changes.";
+        readonly pathPattern: ".kb/commit/current/plan.json";
+        readonly mediaType: "application/json";
+        readonly schemaRef: "@kb-labs/commit-contracts/schema#CommitPlan";
+        readonly example: {
+            readonly summary: "Example commit plan with two commits";
+            readonly payload: {
+                readonly schemaVersion: "1.0";
+                readonly commits: readonly [{
+                    readonly id: "c1";
+                    readonly type: "feat";
+                    readonly scope: "ui";
+                    readonly message: "add button component";
+                    readonly files: readonly ["src/components/Button.tsx"];
+                    readonly releaseHint: "minor";
+                }];
+            };
+        };
+    };
+    readonly "commit.status.json": {
+        readonly id: "commit.status.json";
+        readonly kind: "json";
+        readonly description: "Git status snapshot at plan generation time.";
+        readonly pathPattern: ".kb/commit/current/status.json";
+        readonly mediaType: "application/json";
+        readonly schemaRef: "@kb-labs/commit-contracts/schema#GitStatusSnapshot";
+    };
+    readonly "commit.history": {
+        readonly id: "commit.history";
+        readonly kind: "dir";
+        readonly description: "History of applied commit plans with results.";
+        readonly pathPattern: ".kb/commit/history/";
+    };
+}[T];
+/**
+ * Check if artifact ID exists in contracts (type-safe)
+ *
+ * @example
+ * if (hasArtifact('commit.plan.json')) {
+ *   // TypeScript knows the type!
+ * }
+ */
+declare function hasArtifact(id: string): id is PluginArtifactIds;
+/**
+ * Get command metadata by ID (type-safe)
+ *
+ * @example
+ * const command = getCommand('commit:generate');
+ * // command.description, command.input, command.output, etc.
+ */
+declare function getCommand<T extends PluginCommandIds>(id: T): {
+    readonly commit: {
+        readonly id: "commit";
+        readonly description: "Generate and apply commits (default flow).";
+        readonly input: {
+            readonly ref: "@kb-labs/commit-contracts/schema#CommitRunInput";
+            readonly format: "zod";
+        };
+        readonly output: {
+            readonly ref: "@kb-labs/commit-contracts/schema#CommitRunOutput";
+            readonly format: "zod";
+        };
+        readonly produces: ["commit.plan.json", "commit.status.json"];
+        readonly examples: ["kb commit", "kb commit --dry-run", "kb commit --with-push"];
+    };
+    readonly "commit:generate": {
+        readonly id: "commit:generate";
+        readonly description: "Generate commit plan from git changes using LLM.";
+        readonly input: {
+            readonly ref: "@kb-labs/commit-contracts/schema#GenerateInput";
+            readonly format: "zod";
+        };
+        readonly output: {
+            readonly ref: "@kb-labs/commit-contracts/schema#GenerateOutput";
+            readonly format: "zod";
+        };
+        readonly produces: ["commit.plan.json", "commit.status.json"];
+        readonly examples: ["kb commit generate", "kb commit generate --json", "kb commit generate --scope src/**"];
+    };
+    readonly "commit:apply": {
+        readonly id: "commit:apply";
+        readonly description: "Apply current commit plan (create local git commits).";
+        readonly input: {
+            readonly ref: "@kb-labs/commit-contracts/schema#ApplyInput";
+            readonly format: "zod";
+        };
+        readonly output: {
+            readonly ref: "@kb-labs/commit-contracts/schema#ApplyOutput";
+            readonly format: "zod";
+        };
+        readonly produces: [];
+        readonly examples: ["kb commit apply", "kb commit apply --force"];
+    };
+    readonly "commit:push": {
+        readonly id: "commit:push";
+        readonly description: "Push commits to remote repository.";
+        readonly input: {
+            readonly ref: "@kb-labs/commit-contracts/schema#PushInput";
+            readonly format: "zod";
+        };
+        readonly output: {
+            readonly ref: "@kb-labs/commit-contracts/schema#PushOutput";
+            readonly format: "zod";
+        };
+        readonly produces: [];
+        readonly examples: ["kb commit push", "kb commit push --force"];
+    };
+    readonly "commit:open": {
+        readonly id: "commit:open";
+        readonly description: "Show current commit plan.";
+        readonly input: {
+            readonly ref: "@kb-labs/commit-contracts/schema#OpenInput";
+            readonly format: "zod";
+        };
+        readonly output: {
+            readonly ref: "@kb-labs/commit-contracts/schema#OpenOutput";
+            readonly format: "zod";
+        };
+        readonly produces: [];
+        readonly examples: ["kb commit open", "kb commit open --json"];
+    };
+    readonly "commit:reset": {
+        readonly id: "commit:reset";
+        readonly description: "Clear current commit plan.";
+        readonly output: {
+            readonly ref: "@kb-labs/commit-contracts/schema#ResetOutput";
+            readonly format: "zod";
+        };
+        readonly produces: [];
+        readonly examples: ["kb commit reset"];
+    };
+}[T];
+/**
+ * Check if command ID exists in contracts (type-safe)
+ *
+ * @example
+ * if (hasCommand('commit:generate')) {
+ *   // TypeScript knows the type!
+ * }
+ */
+declare function hasCommand(id: string): id is PluginCommandIds;
+/**
+ * Type-safe identity function for command IDs (useful for validation)
+ *
+ * @example
+ * const cmdId = getCommandId('commit:generate'); // Compile-time validation!
+ */
+declare function getCommandId<T extends PluginCommandIds>(id: T): T;
+/**
+ * Type-safe identity function for artifact IDs (useful for validation)
+ *
+ * @example
+ * const artifactId = getArtifactId('commit.plan.json'); // Compile-time validation!
+ */
+declare function getArtifactId<T extends PluginArtifactIds>(id: T): T;
+
+declare const pluginContractsSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"kb.plugin.contracts/1">;
+    pluginId: z.ZodString;
+    contractsVersion: z.ZodString;
+    artifacts: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["file", "json", "markdown", "binary", "dir", "log"]>;
+        description: z.ZodOptional<z.ZodString>;
+        pathPattern: z.ZodOptional<z.ZodString>;
+        mediaType: z.ZodOptional<z.ZodString>;
+        schemaRef: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodObject<{
+            summary: z.ZodOptional<z.ZodString>;
+            payload: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            summary?: string | undefined;
+            payload?: unknown;
+        }, {
+            summary?: string | undefined;
+            payload?: unknown;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: "file" | "json" | "markdown" | "binary" | "dir" | "log";
+        description?: string | undefined;
+        pathPattern?: string | undefined;
+        mediaType?: string | undefined;
+        schemaRef?: string | undefined;
+        example?: {
+            summary?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    }, {
+        id: string;
+        kind: "file" | "json" | "markdown" | "binary" | "dir" | "log";
+        description?: string | undefined;
+        pathPattern?: string | undefined;
+        mediaType?: string | undefined;
+        schemaRef?: string | undefined;
+        example?: {
+            summary?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    }>>;
+    commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+            format: z.ZodOptional<z.ZodEnum<["zod", "json-schema", "openapi"]>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        }, {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        }>>;
+        output: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+            format: z.ZodOptional<z.ZodEnum<["zod", "json-schema", "openapi"]>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        }, {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        }>>;
+        produces: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        consumes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        input?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        output?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        examples?: string[] | undefined;
+    }, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        input?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        output?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        examples?: string[] | undefined;
+    }>>>;
+    workflows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        consumes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        produces: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            commandId: z.ZodOptional<z.ZodString>;
+            consumes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            produces: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            description?: string | undefined;
+            produces?: string[] | undefined;
+            consumes?: string[] | undefined;
+            commandId?: string | undefined;
+        }, {
+            id: string;
+            description?: string | undefined;
+            produces?: string[] | undefined;
+            consumes?: string[] | undefined;
+            commandId?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        steps?: {
+            id: string;
+            description?: string | undefined;
+            produces?: string[] | undefined;
+            consumes?: string[] | undefined;
+            commandId?: string | undefined;
+        }[] | undefined;
+    }, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        steps?: {
+            id: string;
+            description?: string | undefined;
+            produces?: string[] | undefined;
+            consumes?: string[] | undefined;
+            commandId?: string | undefined;
+        }[] | undefined;
+    }>>>;
+    api: z.ZodOptional<z.ZodObject<{
+        rest: z.ZodOptional<z.ZodObject<{
+            basePath: z.ZodString;
+            routes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                id: z.ZodString;
+                method: z.ZodString;
+                path: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                request: z.ZodOptional<z.ZodObject<{
+                    ref: z.ZodString;
+                    format: z.ZodOptional<z.ZodEnum<["zod", "json-schema", "openapi"]>>;
+                    description: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                }, {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                }>>;
+                response: z.ZodOptional<z.ZodObject<{
+                    ref: z.ZodString;
+                    format: z.ZodOptional<z.ZodEnum<["zod", "json-schema", "openapi"]>>;
+                    description: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                }, {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                }>>;
+                produces: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                consumes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            basePath: string;
+            routes: Record<string, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>;
+        }, {
+            basePath: string;
+            routes: Record<string, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        rest?: {
+            basePath: string;
+            routes: Record<string, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>;
+        } | undefined;
+    }, {
+        rest?: {
+            basePath: string;
+            routes: Record<string, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>;
+        } | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    schema: "kb.plugin.contracts/1";
+    pluginId: string;
+    contractsVersion: string;
+    artifacts: Record<string, {
+        id: string;
+        kind: "file" | "json" | "markdown" | "binary" | "dir" | "log";
+        description?: string | undefined;
+        pathPattern?: string | undefined;
+        mediaType?: string | undefined;
+        schemaRef?: string | undefined;
+        example?: {
+            summary?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    }>;
+    commands?: Record<string, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        input?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        output?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        examples?: string[] | undefined;
+    }> | undefined;
+    workflows?: Record<string, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        steps?: {
+            id: string;
+            description?: string | undefined;
+            produces?: string[] | undefined;
+            consumes?: string[] | undefined;
+            commandId?: string | undefined;
+        }[] | undefined;
+    }> | undefined;
+    api?: {
+        rest?: {
+            basePath: string;
+            routes: Record<string, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>;
+        } | undefined;
+    } | undefined;
+}, {
+    schema: "kb.plugin.contracts/1";
+    pluginId: string;
+    contractsVersion: string;
+    artifacts: Record<string, {
+        id: string;
+        kind: "file" | "json" | "markdown" | "binary" | "dir" | "log";
+        description?: string | undefined;
+        pathPattern?: string | undefined;
+        mediaType?: string | undefined;
+        schemaRef?: string | undefined;
+        example?: {
+            summary?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    }>;
+    commands?: Record<string, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        input?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        output?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        examples?: string[] | undefined;
+    }> | undefined;
+    workflows?: Record<string, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        steps?: {
+            id: string;
+            description?: string | undefined;
+            produces?: string[] | undefined;
+            consumes?: string[] | undefined;
+            commandId?: string | undefined;
+        }[] | undefined;
+    }> | undefined;
+    api?: {
+        rest?: {
+            basePath: string;
+            routes: Record<string, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>;
+        } | undefined;
+    } | undefined;
+}>;
+declare function parsePluginContracts(input: unknown): {
+    schema: "kb.plugin.contracts/1";
+    pluginId: string;
+    contractsVersion: string;
+    artifacts: Record<string, {
+        id: string;
+        kind: "file" | "json" | "markdown" | "binary" | "dir" | "log";
+        description?: string | undefined;
+        pathPattern?: string | undefined;
+        mediaType?: string | undefined;
+        schemaRef?: string | undefined;
+        example?: {
+            summary?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    }>;
+    commands?: Record<string, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        input?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        output?: {
+            ref: string;
+            format?: "zod" | "json-schema" | "openapi" | undefined;
+            description?: string | undefined;
+        } | undefined;
+        examples?: string[] | undefined;
+    }> | undefined;
+    workflows?: Record<string, {
+        id: string;
+        description?: string | undefined;
+        produces?: string[] | undefined;
+        consumes?: string[] | undefined;
+        steps?: {
+            id: string;
+            description?: string | undefined;
+            produces?: string[] | undefined;
+            consumes?: string[] | undefined;
+            commandId?: string | undefined;
+        }[] | undefined;
+    }> | undefined;
+    api?: {
+        rest?: {
+            basePath: string;
+            routes: Record<string, {
+                path: string;
+                id: string;
+                method: string;
+                description?: string | undefined;
+                request?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                response?: {
+                    ref: string;
+                    format?: "zod" | "json-schema" | "openapi" | undefined;
+                    description?: string | undefined;
+                } | undefined;
+                produces?: string[] | undefined;
+                consumes?: string[] | undefined;
+            }>;
+        } | undefined;
+    } | undefined;
+};
+
+declare const contractsSchemaId: "kb.plugin.contracts/1";
+type ContractsSchemaId = typeof contractsSchemaId;
+declare const contractsVersion: "1.0.0";
+
+type SchemaFormat = "zod" | "json-schema" | "openapi";
+interface SchemaReference {
+    /**
+     * Reference to the schema. Can be a URI, npm package export, or local module path.
+     */
+    ref: string;
+    /**
+     * Describes the format of the referenced schema.
+     */
+    format?: SchemaFormat;
+    description?: string;
+}
+interface RestRouteContract {
+    id: string;
+    method: string;
+    path: string;
+    description?: string;
+    request?: SchemaReference;
+    response?: SchemaReference;
+    produces?: string[];
+    consumes?: string[];
+}
+interface RestApiContract {
+    basePath: string;
+    routes: Record<string, RestRouteContract>;
+}
+interface ApiContract {
+    rest?: RestApiContract;
+}
+
+type ArtifactKind = "file" | "json" | "markdown" | "binary" | "dir" | "log";
+interface ArtifactExample {
+    summary?: string;
+    payload?: unknown;
+}
+interface PluginArtifactContract {
+    id: string;
+    kind: ArtifactKind;
+    description?: string;
+    /**
+     * Relative path or glob pattern describing where the artifact is materialised.
+     * Example: "artifacts/template/hello/greeting.json"
+     */
+    pathPattern?: string;
+    /**
+     * IANA media type describing the artifact. Example: "application/json".
+     */
+    mediaType?: string;
+    /**
+     * Reference to a schema describing the artifact payload. Can be a URI or package export.
+     */
+    schemaRef?: string;
+    /**
+     * Optional example payload to help documentation and tooling.
+     */
+    example?: ArtifactExample;
+}
+type ArtifactContractsMap = Record<string, PluginArtifactContract>;
+
+interface CommandContract {
+    id: string;
+    description?: string;
+    input?: SchemaReference;
+    output?: SchemaReference;
+    produces?: string[];
+    consumes?: string[];
+    examples?: string[];
+}
+type CommandContractsMap = Record<string, CommandContract>;
+
+interface WorkflowStepContract {
+    id: string;
+    description?: string;
+    commandId?: string;
+    consumes?: string[];
+    produces?: string[];
+}
+interface WorkflowContract {
+    id: string;
+    description?: string;
+    consumes?: string[];
+    produces?: string[];
+    steps?: WorkflowStepContract[];
+}
+type WorkflowContractsMap = Record<string, WorkflowContract>;
+
+/**
+ * Plugin Configuration Contract
+ *
+ * Defines the shape of plugin configuration stored in kb.config.json
+ * under plugins.commit section.
+ *
+ * This type is the single source of truth for:
+ * - defineSetup (setup handler knows what config to create)
+ * - defineCommand (commands can access typed config)
+ */
+/**
+ * LLM configuration for commit generation
+ */
+interface LLMConfig {
+    /** Whether to use LLM for commit generation (default: true) */
+    enabled: boolean;
+    /** Temperature for LLM responses (0-1, default: 0.3) */
+    temperature: number;
+    /** Maximum tokens for LLM response (default: 2000) */
+    maxTokens: number;
+}
+/**
+ * Storage configuration
+ */
+interface StorageConfig {
+    /** Directory for commit plugin data (default: .kb/commit) */
+    directory: string;
+}
+/**
+ * Git configuration
+ */
+interface GitConfig {
+    /** Protected branches that require confirmation (default: ['main', 'master']) */
+    protectedBranches: string[];
+    /** Whether to auto-stage all changes before commit (default: false) */
+    autoStage: boolean;
+}
+/**
+ * A single commit scope definition
+ */
+interface CommitScope {
+    /** Scope identifier — used as value in selector and in API requests */
+    id: string;
+    /** Display label shown in Studio UI */
+    label: string;
+    /**
+     * Relative path from workspace root to the target git repository.
+     * Use "." for the workspace root itself.
+     * @example "."
+     * @example "public/kb-labs"
+     * @example "plugins/kb-labs-mind"
+     */
+    path: string;
+    /** Optional description shown in Studio selector */
+    description?: string;
+}
+/**
+ * Scope configuration
+ */
+interface ScopeConfig {
+    /** Default scope id to pre-select in Studio and use when not specified via CLI */
+    default?: string;
+    /**
+     * Explicit list of available scopes.
+     * If not provided, falls back to a single "root" scope (workspace root).
+     *
+     * @example
+     * ```json
+     * "scopes": [
+     *   { "id": "root", "label": "workspace root", "path": "." },
+     *   { "id": "public/kb-labs", "label": "kb-labs (public)", "path": "public/kb-labs" }
+     * ]
+     * ```
+     */
+    scopes?: CommitScope[];
+}
+/**
+ * Plugin configuration stored in kb.config.json
+ *
+ * @example
+ * ```json
+ * {
+ *   "plugins": {
+ *     "commit": {
+ *       "enabled": true,
+ *       "llm": {
+ *         "enabled": true,
+ *         "temperature": 0.3,
+ *         "maxTokens": 2000
+ *       },
+ *       "storage": {
+ *         "directory": ".kb/commit"
+ *       },
+ *       "git": {
+ *         "protectedBranches": ["main", "master"],
+ *         "autoStage": false
+ *       },
+ *       "scope": {
+ *         "default": "kb-labs-commit-plugin"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+interface CommitPluginConfig {
+    /** Whether the plugin is enabled */
+    enabled: boolean;
+    /** LLM configuration */
+    llm: LLMConfig;
+    /** Storage configuration */
+    storage: StorageConfig;
+    /** Git configuration */
+    git: GitConfig;
+    /** Scope configuration */
+    scope?: ScopeConfig;
+}
+/**
+ * Environment variables supported by commit plugin
+ * Must be declared in manifest.permissions.env.allow
+ */
+declare const COMMIT_ENV_VARS: readonly ["KB_COMMIT_LLM_ENABLED", "KB_COMMIT_LLM_TEMPERATURE", "KB_COMMIT_LLM_MAX_TOKENS", "KB_COMMIT_STORAGE_DIR", "KB_COMMIT_AUTO_STAGE"];
+type CommitEnvVar = (typeof COMMIT_ENV_VARS)[number];
+/**
+ * Default plugin configuration values
+ */
+declare const defaultCommitConfig: CommitPluginConfig;
+/**
+ * Resolve config with env variable overrides
+ *
+ * @param fileConfig - Config from kb.config.json (via useConfig)
+ * @param env - Environment variables (from commitEnv.parse(runtime))
+ */
+declare function resolveCommitConfig(fileConfig?: Partial<CommitPluginConfig>, env?: Partial<{
+    KB_COMMIT_LLM_ENABLED: boolean;
+    KB_COMMIT_LLM_TEMPERATURE: number;
+    KB_COMMIT_LLM_MAX_TOKENS: number;
+    KB_COMMIT_STORAGE_DIR: string;
+    KB_COMMIT_AUTO_STAGE: boolean;
+}>): CommitPluginConfig;
+
+interface PluginContracts {
+    schema: ContractsSchemaId;
+    pluginId: string;
+    contractsVersion: string;
+    artifacts: ArtifactContractsMap;
+    commands?: CommandContractsMap;
+    workflows?: WorkflowContractsMap;
+    api?: ApiContract;
+}
+
+/**
+ * Single scope entry
+ */
+declare const ScopeSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    path: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    id: string;
+    name: string;
+    description?: string | undefined;
+}, {
+    path: string;
+    id: string;
+    name: string;
+    description?: string | undefined;
+}>;
+type Scope = z.infer<typeof ScopeSchema>;
+/**
+ * GET /scopes response
+ */
+declare const ScopesResponseSchema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        id: string;
+        name: string;
+        description?: string | undefined;
+    }, {
+        path: string;
+        id: string;
+        name: string;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    scopes: {
+        path: string;
+        id: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+}, {
+    scopes: {
+        path: string;
+        id: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+}>;
+type ScopesResponse = z.infer<typeof ScopesResponseSchema>;
+/**
+ * Plan status lifecycle
+ * - idle: No plan exists, need to generate
+ * - ready: Plan generated, ready to apply
+ * - applied: Plan applied as commits, ready to push
+ * - pushed: Commits pushed to remote
+ */
+declare const PlanStatusSchema: z.ZodEnum<["idle", "ready", "applied", "pushed"]>;
+type PlanStatus = z.infer<typeof PlanStatusSchema>;
+/**
+ * GET /status?scope=X response
+ */
+declare const StatusResponseSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    hasPlan: z.ZodBoolean;
+    planStatus: z.ZodDefault<z.ZodEnum<["idle", "ready", "applied", "pushed"]>>;
+    planTimestamp: z.ZodOptional<z.ZodString>;
+    gitStatus: z.ZodOptional<z.ZodObject<{
+        staged: z.ZodArray<z.ZodString, "many">;
+        unstaged: z.ZodArray<z.ZodString, "many">;
+        untracked: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    }, {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    }>>;
+    filesChanged: z.ZodDefault<z.ZodNumber>;
+    commitsInPlan: z.ZodDefault<z.ZodNumber>;
+    commitsApplied: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    hasPlan: boolean;
+    planStatus: "applied" | "pushed" | "idle" | "ready";
+    filesChanged: number;
+    commitsInPlan: number;
+    commitsApplied: number;
+    gitStatus?: {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    } | undefined;
+    planTimestamp?: string | undefined;
+}, {
+    hasPlan: boolean;
+    scope?: string | undefined;
+    gitStatus?: {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    } | undefined;
+    planStatus?: "applied" | "pushed" | "idle" | "ready" | undefined;
+    planTimestamp?: string | undefined;
+    filesChanged?: number | undefined;
+    commitsInPlan?: number | undefined;
+    commitsApplied?: number | undefined;
+}>;
+type StatusResponse = z.infer<typeof StatusResponseSchema>;
+/**
+ * POST /generate request body
+ */
+declare const GenerateRequestSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    allowSecrets: z.ZodDefault<z.ZodBoolean>;
+    autoConfirm: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    dryRun: boolean;
+    allowSecrets: boolean;
+    autoConfirm: boolean;
+}, {
+    scope?: string | undefined;
+    dryRun?: boolean | undefined;
+    allowSecrets?: boolean | undefined;
+    autoConfirm?: boolean | undefined;
+}>;
+type GenerateRequest = z.infer<typeof GenerateRequestSchema>;
+/**
+ * Secret match location
+ */
+declare const SecretMatchSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    type: z.ZodString;
+    pattern: z.ZodString;
+    matched: z.ZodString;
+    context: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    type: string;
+    line: number;
+    column: number;
+    pattern: string;
+    matched: string;
+    context: string;
+}, {
+    file: string;
+    type: string;
+    line: number;
+    column: number;
+    pattern: string;
+    matched: string;
+    context: string;
+}>;
+type SecretMatch = z.infer<typeof SecretMatchSchema>;
+/**
+ * POST /generate response
+ */
+declare const GenerateResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    plan: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        createdAt: z.ZodString;
+        repoRoot: z.ZodString;
+        gitStatus: z.ZodObject<{
+            staged: z.ZodArray<z.ZodString, "many">;
+            unstaged: z.ZodArray<z.ZodString, "many">;
+            untracked: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        }, {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        }>;
+        commits: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<["feat", "fix", "refactor", "chore", "docs", "test", "build", "ci", "perf"]>;
+            scope: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            body: z.ZodOptional<z.ZodString>;
+            files: z.ZodArray<z.ZodString, "many">;
+            releaseHint: z.ZodDefault<z.ZodEnum<["none", "patch", "minor", "major"]>>;
+            breaking: z.ZodDefault<z.ZodBoolean>;
+            reasoning: z.ZodOptional<z.ZodObject<{
+                newBehavior: z.ZodDefault<z.ZodBoolean>;
+                fixesBug: z.ZodDefault<z.ZodBoolean>;
+                internalOnly: z.ZodDefault<z.ZodBoolean>;
+                explanation: z.ZodDefault<z.ZodString>;
+                confidence: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            }, {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            releaseHint: "minor" | "none" | "patch" | "major";
+            breaking: boolean;
+            scope?: string | undefined;
+            body?: string | undefined;
+            reasoning?: {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            } | undefined;
+        }, {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            scope?: string | undefined;
+            body?: string | undefined;
+            releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+            breaking?: boolean | undefined;
+            reasoning?: {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            } | undefined;
+        }>, "many">;
+        metadata: z.ZodObject<{
+            totalFiles: z.ZodNumber;
+            totalCommits: z.ZodNumber;
+            llmUsed: z.ZodBoolean;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            escalated: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        }, {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            releaseHint: "minor" | "none" | "patch" | "major";
+            breaking: boolean;
+            scope?: string | undefined;
+            body?: string | undefined;
+            reasoning?: {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    }, {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            scope?: string | undefined;
+            body?: string | undefined;
+            releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+            breaking?: boolean | undefined;
+            reasoning?: {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    }>>;
+    planPath: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodString>;
+    secretsDetected: z.ZodDefault<z.ZodBoolean>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        type: z.ZodString;
+        pattern: z.ZodString;
+        matched: z.ZodString;
+        context: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        type: string;
+        line: number;
+        column: number;
+        pattern: string;
+        matched: string;
+        context: string;
+    }, {
+        file: string;
+        type: string;
+        line: number;
+        column: number;
+        pattern: string;
+        matched: string;
+        context: string;
+    }>, "many">>;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    success: boolean;
+    secretsDetected: boolean;
+    message?: string | undefined;
+    plan?: {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            releaseHint: "minor" | "none" | "patch" | "major";
+            breaking: boolean;
+            scope?: string | undefined;
+            body?: string | undefined;
+            reasoning?: {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    } | undefined;
+    planPath?: string | undefined;
+    secrets?: {
+        file: string;
+        type: string;
+        line: number;
+        column: number;
+        pattern: string;
+        matched: string;
+        context: string;
+    }[] | undefined;
+}, {
+    success: boolean;
+    scope?: string | undefined;
+    message?: string | undefined;
+    plan?: {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            scope?: string | undefined;
+            body?: string | undefined;
+            releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+            breaking?: boolean | undefined;
+            reasoning?: {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    } | undefined;
+    planPath?: string | undefined;
+    secretsDetected?: boolean | undefined;
+    secrets?: {
+        file: string;
+        type: string;
+        line: number;
+        column: number;
+        pattern: string;
+        matched: string;
+        context: string;
+    }[] | undefined;
+}>;
+type GenerateResponse = z.infer<typeof GenerateResponseSchema>;
+/**
+ * GET /plan?scope=X response
+ */
+declare const PlanResponseSchema: z.ZodObject<{
+    hasPlan: z.ZodBoolean;
+    plan: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        createdAt: z.ZodString;
+        repoRoot: z.ZodString;
+        gitStatus: z.ZodObject<{
+            staged: z.ZodArray<z.ZodString, "many">;
+            unstaged: z.ZodArray<z.ZodString, "many">;
+            untracked: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        }, {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        }>;
+        commits: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<["feat", "fix", "refactor", "chore", "docs", "test", "build", "ci", "perf"]>;
+            scope: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            body: z.ZodOptional<z.ZodString>;
+            files: z.ZodArray<z.ZodString, "many">;
+            releaseHint: z.ZodDefault<z.ZodEnum<["none", "patch", "minor", "major"]>>;
+            breaking: z.ZodDefault<z.ZodBoolean>;
+            reasoning: z.ZodOptional<z.ZodObject<{
+                newBehavior: z.ZodDefault<z.ZodBoolean>;
+                fixesBug: z.ZodDefault<z.ZodBoolean>;
+                internalOnly: z.ZodDefault<z.ZodBoolean>;
+                explanation: z.ZodDefault<z.ZodString>;
+                confidence: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            }, {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            releaseHint: "minor" | "none" | "patch" | "major";
+            breaking: boolean;
+            scope?: string | undefined;
+            body?: string | undefined;
+            reasoning?: {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            } | undefined;
+        }, {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            scope?: string | undefined;
+            body?: string | undefined;
+            releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+            breaking?: boolean | undefined;
+            reasoning?: {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            } | undefined;
+        }>, "many">;
+        metadata: z.ZodObject<{
+            totalFiles: z.ZodNumber;
+            totalCommits: z.ZodNumber;
+            llmUsed: z.ZodBoolean;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            escalated: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        }, {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            releaseHint: "minor" | "none" | "patch" | "major";
+            breaking: boolean;
+            scope?: string | undefined;
+            body?: string | undefined;
+            reasoning?: {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    }, {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            scope?: string | undefined;
+            body?: string | undefined;
+            releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+            breaking?: boolean | undefined;
+            reasoning?: {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    }>>;
+    scope: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    hasPlan: boolean;
+    plan?: {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            releaseHint: "minor" | "none" | "patch" | "major";
+            breaking: boolean;
+            scope?: string | undefined;
+            body?: string | undefined;
+            reasoning?: {
+                newBehavior: boolean;
+                fixesBug: boolean;
+                internalOnly: boolean;
+                explanation: string;
+                confidence: number;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    } | undefined;
+}, {
+    hasPlan: boolean;
+    scope?: string | undefined;
+    plan?: {
+        schemaVersion: "1.0";
+        createdAt: string;
+        repoRoot: string;
+        gitStatus: {
+            staged: string[];
+            unstaged: string[];
+            untracked: string[];
+        };
+        commits: {
+            message: string;
+            type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+            id: string;
+            files: string[];
+            scope?: string | undefined;
+            body?: string | undefined;
+            releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+            breaking?: boolean | undefined;
+            reasoning?: {
+                newBehavior?: boolean | undefined;
+                fixesBug?: boolean | undefined;
+                internalOnly?: boolean | undefined;
+                explanation?: string | undefined;
+                confidence?: number | undefined;
+            } | undefined;
+        }[];
+        metadata: {
+            totalFiles: number;
+            totalCommits: number;
+            llmUsed: boolean;
+            tokensUsed?: number | undefined;
+            escalated?: boolean | undefined;
+        };
+    } | undefined;
+}>;
+type PlanResponse = z.infer<typeof PlanResponseSchema>;
+/**
+ * PATCH /plan request body — edit a single commit in the plan
+ */
+declare const PatchPlanRequestSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    commitId: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    scope_: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    commitId: string;
+    message?: string | undefined;
+    type?: string | undefined;
+    body?: string | undefined;
+    scope_?: string | undefined;
+}, {
+    commitId: string;
+    scope?: string | undefined;
+    message?: string | undefined;
+    type?: string | undefined;
+    body?: string | undefined;
+    scope_?: string | undefined;
+}>;
+type PatchPlanRequest = z.infer<typeof PatchPlanRequestSchema>;
+/**
+ * PATCH /plan response
+ */
+declare const PatchPlanResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    scope: z.ZodDefault<z.ZodString>;
+    commitId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    success: boolean;
+    commitId: string;
+}, {
+    success: boolean;
+    commitId: string;
+    scope?: string | undefined;
+}>;
+type PatchPlanResponse = z.infer<typeof PatchPlanResponseSchema>;
+/**
+ * POST /regenerate-commit request body
+ */
+declare const RegenerateCommitRequestSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    commitId: z.ZodString;
+    instruction: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    commitId: string;
+    instruction?: string | undefined;
+}, {
+    commitId: string;
+    scope?: string | undefined;
+    instruction?: string | undefined;
+}>;
+type RegenerateCommitRequest = z.infer<typeof RegenerateCommitRequestSchema>;
+/**
+ * POST /regenerate-commit response
+ */
+declare const RegenerateCommitResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    scope: z.ZodDefault<z.ZodString>;
+    commitId: z.ZodString;
+    commit: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<["feat", "fix", "refactor", "chore", "docs", "test", "build", "ci", "perf"]>;
+        scope: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        body: z.ZodOptional<z.ZodString>;
+        files: z.ZodArray<z.ZodString, "many">;
+        releaseHint: z.ZodDefault<z.ZodEnum<["none", "patch", "minor", "major"]>>;
+        breaking: z.ZodDefault<z.ZodBoolean>;
+        reasoning: z.ZodOptional<z.ZodObject<{
+            newBehavior: z.ZodDefault<z.ZodBoolean>;
+            fixesBug: z.ZodDefault<z.ZodBoolean>;
+            internalOnly: z.ZodDefault<z.ZodBoolean>;
+            explanation: z.ZodDefault<z.ZodString>;
+            confidence: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            newBehavior: boolean;
+            fixesBug: boolean;
+            internalOnly: boolean;
+            explanation: string;
+            confidence: number;
+        }, {
+            newBehavior?: boolean | undefined;
+            fixesBug?: boolean | undefined;
+            internalOnly?: boolean | undefined;
+            explanation?: string | undefined;
+            confidence?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+        id: string;
+        files: string[];
+        releaseHint: "minor" | "none" | "patch" | "major";
+        breaking: boolean;
+        scope?: string | undefined;
+        body?: string | undefined;
+        reasoning?: {
+            newBehavior: boolean;
+            fixesBug: boolean;
+            internalOnly: boolean;
+            explanation: string;
+            confidence: number;
+        } | undefined;
+    }, {
+        message: string;
+        type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+        id: string;
+        files: string[];
+        scope?: string | undefined;
+        body?: string | undefined;
+        releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+        breaking?: boolean | undefined;
+        reasoning?: {
+            newBehavior?: boolean | undefined;
+            fixesBug?: boolean | undefined;
+            internalOnly?: boolean | undefined;
+            explanation?: string | undefined;
+            confidence?: number | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    success: boolean;
+    commitId: string;
+    commit?: {
+        message: string;
+        type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+        id: string;
+        files: string[];
+        releaseHint: "minor" | "none" | "patch" | "major";
+        breaking: boolean;
+        scope?: string | undefined;
+        body?: string | undefined;
+        reasoning?: {
+            newBehavior: boolean;
+            fixesBug: boolean;
+            internalOnly: boolean;
+            explanation: string;
+            confidence: number;
+        } | undefined;
+    } | undefined;
+}, {
+    success: boolean;
+    commitId: string;
+    scope?: string | undefined;
+    commit?: {
+        message: string;
+        type: "feat" | "fix" | "refactor" | "chore" | "docs" | "test" | "build" | "ci" | "perf";
+        id: string;
+        files: string[];
+        scope?: string | undefined;
+        body?: string | undefined;
+        releaseHint?: "minor" | "none" | "patch" | "major" | undefined;
+        breaking?: boolean | undefined;
+        reasoning?: {
+            newBehavior?: boolean | undefined;
+            fixesBug?: boolean | undefined;
+            internalOnly?: boolean | undefined;
+            explanation?: string | undefined;
+            confidence?: number | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+type RegenerateCommitResponse = z.infer<typeof RegenerateCommitResponseSchema>;
+/**
+ * POST /apply request body
+ */
+declare const ApplyRequestSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+    /** Optional: apply only specific commits by ID. If omitted, applies all. */
+    commitIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    force: boolean;
+    commitIds?: string[] | undefined;
+}, {
+    scope?: string | undefined;
+    force?: boolean | undefined;
+    commitIds?: string[] | undefined;
+}>;
+type ApplyRequest = z.infer<typeof ApplyRequestSchema>;
+/**
+ * POST /apply response
+ */
+declare const ApplyResponseSchema: z.ZodObject<{
+    result: z.ZodObject<{
+        success: z.ZodBoolean;
+        appliedCommits: z.ZodArray<z.ZodObject<{
+            groupId: z.ZodString;
+            sha: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            sha: string;
+            groupId: string;
+        }, {
+            message: string;
+            sha: string;
+            groupId: string;
+        }>, "many">;
+        errors: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        errors: string[];
+        appliedCommits: {
+            message: string;
+            sha: string;
+            groupId: string;
+        }[];
+    }, {
+        success: boolean;
+        errors: string[];
+        appliedCommits: {
+            message: string;
+            sha: string;
+            groupId: string;
+        }[];
+    }>;
+    scope: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    result: {
+        success: boolean;
+        errors: string[];
+        appliedCommits: {
+            message: string;
+            sha: string;
+            groupId: string;
+        }[];
+    };
+}, {
+    result: {
+        success: boolean;
+        errors: string[];
+        appliedCommits: {
+            message: string;
+            sha: string;
+            groupId: string;
+        }[];
+    };
+    scope?: string | undefined;
+}>;
+type ApplyResponse = z.infer<typeof ApplyResponseSchema>;
+/**
+ * POST /push request body
+ */
+declare const PushRequestSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    remote: z.ZodDefault<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    force: boolean;
+    remote: string;
+}, {
+    scope?: string | undefined;
+    force?: boolean | undefined;
+    remote?: string | undefined;
+}>;
+type PushRequest = z.infer<typeof PushRequestSchema>;
+/**
+ * POST /push response
+ */
+declare const PushResponseSchema: z.ZodObject<{
+    result: z.ZodObject<{
+        success: z.ZodBoolean;
+        remote: z.ZodString;
+        branch: z.ZodString;
+        commitsPushed: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        remote: string;
+        branch: string;
+        commitsPushed: number;
+        error?: string | undefined;
+    }, {
+        success: boolean;
+        remote: string;
+        branch: string;
+        commitsPushed: number;
+        error?: string | undefined;
+    }>;
+    scope: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    result: {
+        success: boolean;
+        remote: string;
+        branch: string;
+        commitsPushed: number;
+        error?: string | undefined;
+    };
+}, {
+    result: {
+        success: boolean;
+        remote: string;
+        branch: string;
+        commitsPushed: number;
+        error?: string | undefined;
+    };
+    scope?: string | undefined;
+}>;
+type PushResponse = z.infer<typeof PushResponseSchema>;
+/**
+ * DELETE /plan?scope=X response
+ */
+declare const ResetResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodString;
+    scope: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    message: string;
+    success: boolean;
+}, {
+    message: string;
+    success: boolean;
+    scope?: string | undefined;
+}>;
+type ResetResponse = z.infer<typeof ResetResponseSchema>;
+/**
+ * GET /git-status?scope=X response
+ */
+declare const GitStatusResponseSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    status: z.ZodObject<{
+        staged: z.ZodArray<z.ZodString, "many">;
+        unstaged: z.ZodArray<z.ZodString, "many">;
+        untracked: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    }, {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    }>;
+    summaries: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        status: z.ZodEnum<["added", "modified", "deleted", "renamed", "copied"]>;
+        additions: z.ZodNumber;
+        deletions: z.ZodNumber;
+        binary: z.ZodDefault<z.ZodBoolean>;
+        isNewFile: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        binary: boolean;
+        path: string;
+        status: "added" | "modified" | "deleted" | "renamed" | "copied";
+        additions: number;
+        deletions: number;
+        isNewFile: boolean;
+    }, {
+        path: string;
+        status: "added" | "modified" | "deleted" | "renamed" | "copied";
+        additions: number;
+        deletions: number;
+        binary?: boolean | undefined;
+        isNewFile?: boolean | undefined;
+    }>, "many">;
+    totalFiles: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    status: {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    };
+    totalFiles: number;
+    summaries: {
+        binary: boolean;
+        path: string;
+        status: "added" | "modified" | "deleted" | "renamed" | "copied";
+        additions: number;
+        deletions: number;
+        isNewFile: boolean;
+    }[];
+}, {
+    status: {
+        staged: string[];
+        unstaged: string[];
+        untracked: string[];
+    };
+    totalFiles: number;
+    summaries: {
+        path: string;
+        status: "added" | "modified" | "deleted" | "renamed" | "copied";
+        additions: number;
+        deletions: number;
+        binary?: boolean | undefined;
+        isNewFile?: boolean | undefined;
+    }[];
+    scope?: string | undefined;
+}>;
+type GitStatusResponse = z.infer<typeof GitStatusResponseSchema>;
+/**
+ * GET /diff?scope=X&file=Y response
+ */
+declare const FileDiffResponseSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    file: z.ZodString;
+    diff: z.ZodString;
+    additions: z.ZodDefault<z.ZodNumber>;
+    deletions: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    scope: string;
+    additions: number;
+    deletions: number;
+    diff: string;
+}, {
+    file: string;
+    diff: string;
+    scope?: string | undefined;
+    additions?: number | undefined;
+    deletions?: number | undefined;
+}>;
+type FileDiffResponse = z.infer<typeof FileDiffResponseSchema>;
+/**
+ * POST /summarize request body
+ */
+declare const SummarizeRequestSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    /** Optional file path - if provided, summarize only this file */
+    file: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    file?: string | undefined;
+}, {
+    file?: string | undefined;
+    scope?: string | undefined;
+}>;
+type SummarizeRequest = z.infer<typeof SummarizeRequestSchema>;
+/**
+ * POST /summarize response
+ */
+declare const SummarizeResponseSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodString>;
+    file: z.ZodOptional<z.ZodString>;
+    summary: z.ZodString;
+    /** Token usage for the LLM call */
+    tokensUsed: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    summary: string;
+    file?: string | undefined;
+    tokensUsed?: number | undefined;
+}, {
+    summary: string;
+    file?: string | undefined;
+    scope?: string | undefined;
+    tokensUsed?: number | undefined;
+}>;
+type SummarizeResponse = z.infer<typeof SummarizeResponseSchema>;
+
+/**
+ * Declarative flag definitions for commit plugin commands
+ *
+ * Using the new defineFlags system from @kb-labs/sdk for:
+ * - Type safety
+ * - Runtime validation
+ * - Automatic type inference
+ * - Consistent DX across commands
+ */
+/**
+ * Flags for commit:commit (run) command
+ *
+ * @example
+ * ```bash
+ * kb commit commit --scope="@kb-labs/core" --dry-run --with-push
+ * ```
+ */
+declare const commitFlags: _kb_labs_shared_command_kit.FlagSchemaWithInfer<{
+    scope: {
+        type: "string";
+        description: string;
+        examples: string[];
+    };
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    "dry-run": {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    "with-push": {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    "allow-secrets": {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    yes: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+/**
+ * Inferred TypeScript type for commit command input
+ *
+ * Type resolves to:
+ * {
+ *   scope?: string;
+ *   json: boolean;
+ *   'dry-run': boolean;
+ *   'with-push': boolean;
+ * }
+ */
+type CommitFlags = typeof commitFlags.infer;
+/**
+ * Flags for commit:generate command
+ *
+ * @example
+ * ```bash
+ * kb commit generate --scope="@kb-labs/cli" --json
+ * ```
+ */
+declare const generateFlags: _kb_labs_shared_command_kit.FlagSchemaWithInfer<{
+    scope: {
+        type: "string";
+        description: string;
+        examples: string[];
+    };
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    "allow-secrets": {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    yes: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+/**
+ * Inferred TypeScript type for generate command input
+ *
+ * Type resolves to:
+ * {
+ *   scope?: string;
+ *   json: boolean;
+ * }
+ */
+type GenerateFlags = typeof generateFlags.infer;
+
+/**
+ * Environment variable definitions for commit plugin
+ */
+declare const commitEnv: _kb_labs_shared_cli_ui.EnvDefinition<{
+    KB_COMMIT_LLM_ENABLED: {
+        type: "boolean";
+        default: true;
+        description: string;
+    };
+    KB_COMMIT_LLM_TEMPERATURE: {
+        type: "number";
+        default: number;
+        description: string;
+        validate: (v: number) => void;
+    };
+    KB_COMMIT_LLM_MAX_TOKENS: {
+        type: "number";
+        default: number;
+        description: string;
+    };
+    KB_COMMIT_STORAGE_DIR: {
+        type: "string";
+        default: string;
+        description: string;
+    };
+    KB_COMMIT_AUTO_STAGE: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+}>;
+type CommitEnv = typeof commitEnv.type;
+
+/**
+ * @module @kb-labs/commit-contracts/routes
+ * REST API route constants for commit plugin
+ */
+/**
+ * REST API base path for commit plugin
+ */
+declare const COMMIT_BASE_PATH: "/v1/plugins/commit";
+/**
+ * REST API route paths (relative to basePath)
+ *
+ * These are used in both:
+ * - manifest.rest.routes[].path (route definitions)
+ * - manifest.studio.widgets[].data.source.routeId (widget data sources)
+ * - manifest.studio.widgets[].actions[].endpoint.routeId (widget actions)
+ */
+declare const COMMIT_ROUTES: {
+    /** GET /scopes - List available scopes */
+    readonly SCOPES: "/scopes";
+    /** GET /status - Get current status (plan + git) */
+    readonly STATUS: "/status";
+    /** GET /plan - Get current commit plan */
+    readonly PLAN: "/plan";
+    /** GET /git-status - Get git status with file details */
+    readonly GIT_STATUS: "/git-status";
+    /** GET /files - Get file tree with diff statistics */
+    readonly FILES: "/files";
+    /** GET /diff - Get diff for a specific file */
+    readonly DIFF: "/diff";
+    /** POST /summarize - Summarize changes using LLM */
+    readonly SUMMARIZE: "/summarize";
+    /** GET /actions - Get actions widget data */
+    readonly ACTIONS: "/actions";
+    /** POST /generate - Generate new commit plan */
+    readonly GENERATE: "/generate";
+    /** POST /apply - Apply commit plan */
+    readonly APPLY: "/apply";
+    /** POST /push - Push commits to remote */
+    readonly PUSH: "/push";
+    /** DELETE /plan - Delete current plan */
+    readonly RESET: "/plan";
+    /** PATCH /plan - Edit a single commit in the plan */
+    readonly PATCH_PLAN: "/plan";
+    /** POST /regenerate-commit - Regenerate a single commit */
+    readonly REGENERATE_COMMIT: "/regenerate-commit";
+};
+/**
+ * Full REST API URLs (basePath + route)
+ * Useful for testing and documentation
+ */
+declare const COMMIT_FULL_ROUTES: {
+    readonly SCOPES: "/v1/plugins/commit/scopes";
+    readonly STATUS: "/v1/plugins/commit/status";
+    readonly PLAN: "/v1/plugins/commit/plan";
+    readonly GIT_STATUS: "/v1/plugins/commit/git-status";
+    readonly FILES: "/v1/plugins/commit/files";
+    readonly DIFF: "/v1/plugins/commit/diff";
+    readonly SUMMARIZE: "/v1/plugins/commit/summarize";
+    readonly ACTIONS: "/v1/plugins/commit/actions";
+    readonly GENERATE: "/v1/plugins/commit/generate";
+    readonly APPLY: "/v1/plugins/commit/apply";
+    readonly PUSH: "/v1/plugins/commit/push";
+    readonly RESET: "/v1/plugins/commit/plan";
+    readonly PATCH_PLAN: "/v1/plugins/commit/plan";
+    readonly REGENERATE_COMMIT: "/v1/plugins/commit/regenerate-commit";
+};
+/**
+ * Widget-friendly route IDs (without leading slash)
+ * Use these in manifest.studio.widgets[].data.source.routeId
+ */
+declare const COMMIT_WIDGET_ROUTES: {
+    readonly SCOPES: "scopes";
+    readonly STATUS: "status";
+    readonly PLAN: "plan";
+    readonly GIT_STATUS: "git-status";
+    readonly FILES: "files";
+    readonly DIFF: "diff";
+    readonly SUMMARIZE: "summarize";
+    readonly ACTIONS: "actions";
+    readonly GENERATE: "generate";
+    readonly APPLY: "apply";
+    readonly PUSH: "push";
+    readonly RESET: "plan";
+    readonly PATCH_PLAN: "plan";
+    readonly REGENERATE_COMMIT: "regenerate-commit";
+};
+type CommitRoute = (typeof COMMIT_ROUTES)[keyof typeof COMMIT_ROUTES];
+type CommitWidgetRoute = (typeof COMMIT_WIDGET_ROUTES)[keyof typeof COMMIT_WIDGET_ROUTES];
+
+/**
+ * @module @kb-labs/commit-contracts/events
+ * Studio event definitions for commit plugin
+ */
+/**
+ * Event names for commit plugin widgets
+ */
+declare const COMMIT_EVENTS: {
+    /** Scope selector changed */
+    readonly SCOPE_CHANGED: "scope:changed";
+    /** Form submitted (actions widget) */
+    readonly FORM_SUBMITTED: "form:submitted";
+    /** Commit plan generated */
+    readonly PLAN_GENERATED: "plan:generated";
+};
+type CommitEventName = (typeof COMMIT_EVENTS)[keyof typeof COMMIT_EVENTS];
+/**
+ * Event payload types
+ */
+/** Payload for scope:changed event */
+interface ScopeChangedPayload {
+    /** Selected scope ID */
+    scope: string;
+}
+/** Payload for form:submitted event */
+interface FormSubmittedPayload {
+    /** Action ID that was submitted */
+    action: string;
+    /** Form data (if any) */
+    data?: Record<string, unknown>;
+}
+/** Payload for plan:generated event */
+interface PlanGeneratedPayload {
+    /** The generated commit plan */
+    plan: {
+        commits: Array<{
+            type: string;
+            scope?: string;
+            message: string;
+            body?: string;
+            files: string[];
+        }>;
+    };
+    /** Scope where plan was generated */
+    scope: string;
+}
+/**
+ * Union type for all commit event payloads
+ */
+type CommitEventPayload = ScopeChangedPayload | FormSubmittedPayload | PlanGeneratedPayload;
+
+/**
+ * Cache key prefix for commit plugin
+ * Used for platform cache namespacing: commit:git-status:*, commit:plan-applied:*
+ */
+declare const COMMIT_CACHE_PREFIX: "commit:";
+
+export { type ApiContract, type ApplyRequest, ApplyRequestSchema, type ApplyResponse, ApplyResponseSchema, type ArtifactContractsMap, type ArtifactExample, type ArtifactKind, COMMIT_BASE_PATH, COMMIT_CACHE_PREFIX, COMMIT_ENV_VARS, COMMIT_EVENTS, COMMIT_FULL_ROUTES, COMMIT_ROUTES, COMMIT_WIDGET_ROUTES, type CommandContract, type CommandContractsMap, type CommitEnv, type CommitEnvVar, type CommitEventName, type CommitEventPayload, type CommitFlags, type CommitPluginConfig, type CommitRoute, type CommitScope, type CommitWidgetRoute, type FileDiffResponse, FileDiffResponseSchema, type FormSubmittedPayload, type GenerateFlags, type GenerateRequest, GenerateRequestSchema, type GenerateResponse, GenerateResponseSchema, type GitConfig, type GitStatusResponse, GitStatusResponseSchema, type LLMConfig, type PatchPlanRequest, PatchPlanRequestSchema, type PatchPlanResponse, PatchPlanResponseSchema, type PlanGeneratedPayload, type PlanResponse, PlanResponseSchema, type PlanStatus, PlanStatusSchema, type PluginArtifactContract, PluginArtifactIds, PluginCommandIds, type PluginContracts, type PushRequest, PushRequestSchema, type PushResponse, PushResponseSchema, type RegenerateCommitRequest, RegenerateCommitRequestSchema, type RegenerateCommitResponse, RegenerateCommitResponseSchema, type ResetResponse, ResetResponseSchema, type RestApiContract, type RestRouteContract, type SchemaReference, type Scope, type ScopeChangedPayload, type ScopeConfig, ScopeSchema, type ScopesResponse, ScopesResponseSchema, type SecretMatch, SecretMatchSchema, type StatusResponse, StatusResponseSchema, type StorageConfig, type SummarizeRequest, SummarizeRequestSchema, type SummarizeResponse, SummarizeResponseSchema, type WorkflowContract, type WorkflowContractsMap, type WorkflowStepContract, commitEnv, commitFlags, contractsSchemaId, contractsVersion, defaultCommitConfig, generateFlags, getArtifact, getArtifactId, getArtifactPath, getCommand, getCommandId, hasArtifact, hasCommand, parsePluginContracts, pluginContractsSchema, resolveCommitConfig };