@kb-labs/commit-cli 0.5.0

package/dist/rest/handlers/regenerate-handler.js

@@ -0,0 +1,124 @@
+import { defineHandler, useLogger, useLLM, useConfig } from '@kb-labs/sdk';
+import { resolveCommitConfig, COMMIT_CACHE_PREFIX } from '@kb-labs/commit-contracts';
+import { loadPlan, savePlan } from '@kb-labs/commit-core/storage';
+import { getFileSummaries, getFileDiffs } from '@kb-labs/commit-core/analyzer';
+import { SYSTEM_PROMPT_WITH_DIFF, COMMIT_PLAN_TOOL } from '@kb-labs/commit-core/generator';
+import * as path from 'path';
+
+// src/rest/handlers/regenerate-handler.ts
+function resolveScopePath(baseCwd, scopeId = "root", scopes) {
+  const scopeDef = scopes?.find((s) => s.id === scopeId);
+  const relativePath = scopeDef?.path ?? (scopeId === "root" ? "." : scopeId);
+  return relativePath === "." ? baseCwd : path.join(baseCwd, relativePath);
+}
+
+// src/rest/handlers/regenerate-handler.ts
+var regenerate_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const logger = useLogger();
+    const { scope = "root", commitId, instruction } = input.body ?? {};
+    if (!commitId) {
+      throw new Error("commitId is required");
+    }
+    const plan = await loadPlan(ctx.cwd, scope);
+    if (!plan) {
+      throw new Error("No commit plan found. Generate a plan first.");
+    }
+    const commitIndex = plan.commits.findIndex((c) => c.id === commitId);
+    if (commitIndex === -1) {
+      throw new Error(`Commit "${commitId}" not found in plan`);
+    }
+    const existingCommit = plan.commits[commitIndex];
+    const files = existingCommit.files;
+    if (files.length === 0) {
+      throw new Error("Commit has no files to regenerate");
+    }
+    const llm = useLLM();
+    if (!llm || !llm.chatWithTools) {
+      throw new Error("LLM is not available for regeneration");
+    }
+    try {
+      const fileConfig = await useConfig();
+      const config = resolveCommitConfig(fileConfig ?? {});
+      const scopeCwd = resolveScopePath(ctx.cwd, scope, config.scope?.scopes);
+      const summaries = await getFileSummaries(scopeCwd, files);
+      const diffs = await getFileDiffs(scopeCwd, files);
+      const fileContext = summaries.map((s) => {
+        const diff = diffs.get(s.path) || "";
+        return `File: ${s.path} (${s.status}, +${s.additions}/-${s.deletions})${diff ? `
+Diff:
+${diff}` : ""}`;
+      }).join("\n\n");
+      const instructionText = instruction ? `
+
+User instruction: ${instruction}` : "";
+      const userPrompt = `Analyze these files and generate exactly ONE commit following conventional commit conventions.
+These files were previously grouped as: ${existingCommit.type}(${existingCommit.scope || ""}): ${existingCommit.message}
+
+Re-analyze them and generate an improved commit message.${instructionText}
+
+Files to analyze:
+${fileContext}`;
+      const messages = [
+        { role: "system", content: SYSTEM_PROMPT_WITH_DIFF },
+        { role: "user", content: userPrompt }
+      ];
+      const response = await llm.chatWithTools(messages, {
+        tools: [COMMIT_PLAN_TOOL],
+        toolChoice: {
+          type: "function",
+          function: { name: "generate_commit_plan" }
+        },
+        temperature: 0.3
+      });
+      const toolCall = response.toolCalls?.[0];
+      if (!toolCall || toolCall.name !== "generate_commit_plan") {
+        throw new Error("LLM did not call generate_commit_plan tool");
+      }
+      const toolArgs = toolCall.input;
+      const regeneratedCommit = toolArgs.commits[0];
+      if (!regeneratedCommit) {
+        throw new Error("LLM returned no commits");
+      }
+      regeneratedCommit.id = existingCommit.id;
+      regeneratedCommit.files = existingCommit.files;
+      plan.commits[commitIndex] = regeneratedCommit;
+      await savePlan(ctx.cwd, plan, scope);
+      const appliedCacheKey = `${COMMIT_CACHE_PREFIX}plan-applied:${scope}`;
+      await ctx.platform.cache.delete(appliedCacheKey);
+      await logger.info("[regenerate-handler] Commit regenerated", {
+        scope,
+        commitId,
+        oldMessage: `${existingCommit.type}: ${existingCommit.message}`,
+        newMessage: `${regeneratedCommit.type}: ${regeneratedCommit.message}`
+      });
+      if (ctx.platform.analytics) {
+        await ctx.platform.analytics.track("commit.regenerate.success", {
+          scope,
+          commitId,
+          hadInstruction: !!instruction,
+          filesCount: files.length
+        });
+      }
+      return {
+        success: true,
+        scope,
+        commitId,
+        commit: regeneratedCommit
+      };
+    } catch (error) {
+      if (ctx.platform.analytics) {
+        await ctx.platform.analytics.track("commit.regenerate.error", {
+          scope,
+          commitId,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+      throw new Error(`Failed to regenerate commit: ${error}`);
+    }
+  }
+});
+
+export { regenerate_handler_default as default };
+//# sourceMappingURL=regenerate-handler.js.map
+//# sourceMappingURL=regenerate-handler.js.map

package/dist/rest/handlers/regenerate-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/scope-resolver.ts","../../../src/rest/handlers/regenerate-handler.ts"],"names":[],"mappings":"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","file":"regenerate-handler.js","sourcesContent":["import * as path from 'node:path';\nimport type { CommitScope } from '@kb-labs/commit-contracts';\n\n/**\n * Resolves a scope id to an absolute filesystem path.\n *\n * Looks up the scope in the provided scopes array by id.\n * Falls back to treating the id as a relative path from baseCwd (legacy compat).\n *\n * @param baseCwd  - Workspace root (ctx.cwd)\n * @param scopeId  - Scope identifier, e.g. \"root\", \"public/kb-labs\"\n * @param scopes   - Configured scopes from CommitPluginConfig.scope.scopes\n */\nexport function resolveScopePath(\n  baseCwd: string,\n  scopeId: string = 'root',\n  scopes?: CommitScope[],\n): string {\n  const scopeDef = scopes?.find((s) => s.id === scopeId);\n  const relativePath = scopeDef?.path ?? (scopeId === 'root' ? '.' : scopeId);\n  return relativePath === '.' ? baseCwd : path.join(baseCwd, relativePath);\n}\n","import { defineHandler, useConfig, type PluginContextV3, type RestInput, useLLM, useLogger } from '@kb-labs/sdk';\nimport type { LLMMessage } from '@kb-labs/sdk';\nimport {\n  COMMIT_CACHE_PREFIX,\n  type RegenerateCommitRequest,\n  type RegenerateCommitResponse,\n  type CommitGroup,\n  type CommitPluginConfig,\n  resolveCommitConfig,\n} from '@kb-labs/commit-contracts';\nimport { loadPlan, savePlan } from '@kb-labs/commit-core/storage';\nimport { getFileSummaries, getFileDiffs } from '@kb-labs/commit-core/analyzer';\nimport { COMMIT_PLAN_TOOL, SYSTEM_PROMPT_WITH_DIFF } from '@kb-labs/commit-core/generator';\nimport { resolveScopePath } from './scope-resolver';\n\n/**\n * POST /regenerate-commit handler\n *\n * Re-analyzes files from a single commit using LLM and replaces it in the plan.\n * Uses Phase 2 approach (with diff context) for best results.\n */\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, input: RestInput<unknown, RegenerateCommitRequest>): Promise<RegenerateCommitResponse> {\n    const logger = useLogger();\n    const { scope = 'root', commitId, instruction } = input.body ?? {};\n\n    if (!commitId) {\n      throw new Error('commitId is required');\n    }\n\n    const plan = await loadPlan(ctx.cwd, scope);\n    if (!plan) {\n      throw new Error('No commit plan found. Generate a plan first.');\n    }\n\n    const commitIndex = plan.commits.findIndex(c => c.id === commitId);\n    if (commitIndex === -1) {\n      throw new Error(`Commit \"${commitId}\" not found in plan`);\n    }\n\n    const existingCommit = plan.commits[commitIndex]!;\n    const files = existingCommit.files;\n\n    if (files.length === 0) {\n      throw new Error('Commit has no files to regenerate');\n    }\n\n    const llm = useLLM();\n    if (!llm || !llm.chatWithTools) {\n      throw new Error('LLM is not available for regeneration');\n    }\n\n    try {\n      // Resolve scope for file operations\n      const fileConfig = await useConfig<Partial<CommitPluginConfig>>();\n      const config = resolveCommitConfig(fileConfig ?? {});\n      const scopeCwd = resolveScopePath(ctx.cwd, scope, config.scope?.scopes);\n\n      // Get fresh file summaries and diffs\n      const summaries = await getFileSummaries(scopeCwd, files);\n      const diffs = await getFileDiffs(scopeCwd, files);\n\n      // Build prompt for single commit regeneration\n      const fileContext = summaries.map(s => {\n        const diff = diffs.get(s.path) || '';\n        return `File: ${s.path} (${s.status}, +${s.additions}/-${s.deletions})${diff ? `\\nDiff:\\n${diff}` : ''}`;\n      }).join('\\n\\n');\n\n      const instructionText = instruction\n        ? `\\n\\nUser instruction: ${instruction}`\n        : '';\n\n      const userPrompt = `Analyze these files and generate exactly ONE commit following conventional commit conventions.\nThese files were previously grouped as: ${existingCommit.type}(${existingCommit.scope || ''}): ${existingCommit.message}\n\nRe-analyze them and generate an improved commit message.${instructionText}\n\nFiles to analyze:\n${fileContext}`;\n\n      const messages: LLMMessage[] = [\n        { role: 'system', content: SYSTEM_PROMPT_WITH_DIFF },\n        { role: 'user', content: userPrompt },\n      ];\n\n      const response = await llm.chatWithTools(messages, {\n        tools: [COMMIT_PLAN_TOOL],\n        toolChoice: {\n          type: 'function',\n          function: { name: 'generate_commit_plan' },\n        },\n        temperature: 0.3,\n      });\n\n      const toolCall = response.toolCalls?.[0];\n      if (!toolCall || toolCall.name !== 'generate_commit_plan') {\n        throw new Error('LLM did not call generate_commit_plan tool');\n      }\n\n      const toolArgs = toolCall.input as { commits: CommitGroup[] };\n\n      // Take the first commit from LLM output (we asked for exactly one)\n      const regeneratedCommit = toolArgs.commits[0];\n      if (!regeneratedCommit) {\n        throw new Error('LLM returned no commits');\n      }\n\n      // Preserve the original commit ID and files\n      regeneratedCommit.id = existingCommit.id;\n      regeneratedCommit.files = existingCommit.files;\n\n      // Replace in plan\n      plan.commits[commitIndex] = regeneratedCommit;\n      await savePlan(ctx.cwd, plan, scope);\n\n      // Regenerated plan is no longer considered applied.\n      const appliedCacheKey = `${COMMIT_CACHE_PREFIX}plan-applied:${scope}`;\n      await ctx.platform.cache.delete(appliedCacheKey);\n\n      await logger.info('[regenerate-handler] Commit regenerated', {\n        scope,\n        commitId,\n        oldMessage: `${existingCommit.type}: ${existingCommit.message}`,\n        newMessage: `${regeneratedCommit.type}: ${regeneratedCommit.message}`,\n      });\n\n      // Track analytics\n      if (ctx.platform.analytics) {\n        await ctx.platform.analytics.track('commit.regenerate.success', {\n          scope,\n          commitId,\n          hadInstruction: !!instruction,\n          filesCount: files.length,\n        });\n      }\n\n      return {\n        success: true,\n        scope,\n        commitId,\n        commit: regeneratedCommit,\n      };\n    } catch (error) {\n      if (ctx.platform.analytics) {\n        await ctx.platform.analytics.track('commit.regenerate.error', {\n          scope,\n          commitId,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n\n      throw new Error(`Failed to regenerate commit: ${error}`);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/reset-handler.d.ts

@@ -0,0 +1,17 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+/**
+ * DELETE /plan handler
+ *
+ * Deletes the current commit plan.
+ */
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<{
+    scope?: string;
+}, unknown, unknown>, {
+    message: string;
+    scope: string;
+    success: boolean;
+}>;
+
+export { _default as default };

package/dist/rest/handlers/reset-handler.js

@@ -0,0 +1,30 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { COMMIT_CACHE_PREFIX } from '@kb-labs/commit-contracts';
+import { clearPlan } from '@kb-labs/commit-core/storage';
+
+// src/rest/handlers/reset-handler.ts
+var reset_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const scope = input.query?.scope || "root";
+    try {
+      await clearPlan(ctx.cwd, scope);
+      const appliedCacheKey = `${COMMIT_CACHE_PREFIX}plan-applied:${scope}`;
+      await ctx.platform.cache.delete(appliedCacheKey);
+      return {
+        success: true,
+        message: "Commit plan deleted successfully",
+        scope
+      };
+    } catch (error) {
+      return {
+        success: false,
+        message: `Failed to delete plan: ${error}`,
+        scope
+      };
+    }
+  }
+});
+
+export { reset_handler_default as default };
+//# sourceMappingURL=reset-handler.js.map
+//# sourceMappingURL=reset-handler.js.map

package/dist/rest/handlers/reset-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/reset-handler.ts"],"names":[],"mappings":";;;;;AAYA,IAAO,wBAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAuE;AACzG,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,EAAO,KAAA,IAAS,MAAA;AAEpC,IAAA,IAAI;AACF,MAAA,MAAM,SAAA,CAAU,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAC9B,MAAA,MAAM,eAAA,GAAkB,CAAA,EAAG,mBAAmB,CAAA,aAAA,EAAgB,KAAK,CAAA,CAAA;AACnE,MAAA,MAAM,GAAA,CAAI,QAAA,CAAS,KAAA,CAAM,MAAA,CAAO,eAAe,CAAA;AAE/C,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,IAAA;AAAA,QACT,OAAA,EAAS,kCAAA;AAAA,QACT;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,OAAA,EAAS,0BAA0B,KAAK,CAAA,CAAA;AAAA,QACxC;AAAA,OACF;AAAA,IACF;AAAA,EACF;AACF,CAAC","file":"reset-handler.js","sourcesContent":["import { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport {\n  COMMIT_CACHE_PREFIX,\n  type ResetResponse,\n} from '@kb-labs/commit-contracts';\nimport { clearPlan } from '@kb-labs/commit-core/storage';\n\n/**\n * DELETE /plan handler\n *\n * Deletes the current commit plan.\n */\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, input: RestInput<{ scope?: string }, unknown>): Promise<ResetResponse> {\n    const scope = input.query?.scope || 'root';\n\n    try {\n      await clearPlan(ctx.cwd, scope);\n      const appliedCacheKey = `${COMMIT_CACHE_PREFIX}plan-applied:${scope}`;\n      await ctx.platform.cache.delete(appliedCacheKey);\n\n      return {\n        success: true,\n        message: 'Commit plan deleted successfully',\n        scope,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        message: `Failed to delete plan: ${error}`,\n        scope,\n      };\n    }\n  },\n});\n"]}

package/dist/rest/handlers/scope-resolver.d.ts

@@ -0,0 +1,15 @@
+import { CommitScope } from '@kb-labs/commit-contracts';
+
+/**
+ * Resolves a scope id to an absolute filesystem path.
+ *
+ * Looks up the scope in the provided scopes array by id.
+ * Falls back to treating the id as a relative path from baseCwd (legacy compat).
+ *
+ * @param baseCwd  - Workspace root (ctx.cwd)
+ * @param scopeId  - Scope identifier, e.g. "root", "public/kb-labs"
+ * @param scopes   - Configured scopes from CommitPluginConfig.scope.scopes
+ */
+declare function resolveScopePath(baseCwd: string, scopeId?: string, scopes?: CommitScope[]): string;
+
+export { resolveScopePath };

package/dist/rest/handlers/scope-resolver.js

@@ -0,0 +1,12 @@
+import * as path from 'path';
+
+// src/rest/handlers/scope-resolver.ts
+function resolveScopePath(baseCwd, scopeId = "root", scopes) {
+  const scopeDef = scopes?.find((s) => s.id === scopeId);
+  const relativePath = scopeDef?.path ?? (scopeId === "root" ? "." : scopeId);
+  return relativePath === "." ? baseCwd : path.join(baseCwd, relativePath);
+}
+
+export { resolveScopePath };
+//# sourceMappingURL=scope-resolver.js.map
+//# sourceMappingURL=scope-resolver.js.map

package/dist/rest/handlers/scope-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/scope-resolver.ts"],"names":[],"mappings":";;;AAaO,SAAS,gBAAA,CACd,OAAA,EACA,OAAA,GAAkB,MAAA,EAClB,MAAA,EACQ;AACR,EAAA,MAAM,WAAW,MAAA,EAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,OAAO,CAAA;AACrD,EAAA,MAAM,YAAA,GAAe,QAAA,EAAU,IAAA,KAAS,OAAA,KAAY,SAAS,GAAA,GAAM,OAAA,CAAA;AACnE,EAAA,OAAO,YAAA,KAAiB,GAAA,GAAM,OAAA,GAAe,IAAA,CAAA,IAAA,CAAK,SAAS,YAAY,CAAA;AACzE","file":"scope-resolver.js","sourcesContent":["import * as path from 'node:path';\nimport type { CommitScope } from '@kb-labs/commit-contracts';\n\n/**\n * Resolves a scope id to an absolute filesystem path.\n *\n * Looks up the scope in the provided scopes array by id.\n * Falls back to treating the id as a relative path from baseCwd (legacy compat).\n *\n * @param baseCwd  - Workspace root (ctx.cwd)\n * @param scopeId  - Scope identifier, e.g. \"root\", \"public/kb-labs\"\n * @param scopes   - Configured scopes from CommitPluginConfig.scope.scopes\n */\nexport function resolveScopePath(\n  baseCwd: string,\n  scopeId: string = 'root',\n  scopes?: CommitScope[],\n): string {\n  const scopeDef = scopes?.find((s) => s.id === scopeId);\n  const relativePath = scopeDef?.path ?? (scopeId === 'root' ? '.' : scopeId);\n  return relativePath === '.' ? baseCwd : path.join(baseCwd, relativePath);\n}\n"]}

package/dist/rest/handlers/scopes-handler.d.ts

@@ -0,0 +1,12 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { SelectData } from '@kb-labs/sdk';
+
+/**
+ * GET /scopes handler
+ *
+ * Returns available scopes from kb.config.json (plugins.commit.scope.scopes).
+ * Falls back to a single "root" scope if not configured.
+ */
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, unknown, SelectData>;
+
+export { _default as default };

package/dist/rest/handlers/scopes-handler.js

@@ -0,0 +1,24 @@
+import { defineHandler, useConfig } from '@kb-labs/sdk';
+import { resolveCommitConfig } from '@kb-labs/commit-contracts';
+
+// src/rest/handlers/scopes-handler.ts
+var scopes_handler_default = defineHandler({
+  async execute(_ctx, _input) {
+    const fileConfig = await useConfig();
+    const config = resolveCommitConfig(fileConfig ?? {});
+    const scopes = config.scope?.scopes ?? [{ id: "root", label: "root", path: "." }];
+    const defaultId = config.scope?.default ?? scopes[0]?.id ?? "root";
+    return {
+      value: defaultId,
+      options: scopes.map((s) => ({
+        value: s.id,
+        label: s.label,
+        description: s.description
+      }))
+    };
+  }
+});
+
+export { scopes_handler_default as default };
+//# sourceMappingURL=scopes-handler.js.map
+//# sourceMappingURL=scopes-handler.js.map

package/dist/rest/handlers/scopes-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/scopes-handler.ts"],"names":[],"mappings":";;;;AASA,IAAO,yBAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,IAAA,EAAuB,MAAA,EAAsC;AACzE,IAAA,MAAM,UAAA,GAAa,MAAM,SAAA,EAAuC;AAChE,IAAA,MAAM,MAAA,GAAS,mBAAA,CAAoB,UAAA,IAAc,EAAE,CAAA;AAEnD,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,KAAA,EAAO,MAAA,IAAU,CAAC,EAAE,EAAA,EAAI,MAAA,EAAQ,KAAA,EAAO,MAAA,EAAQ,IAAA,EAAM,GAAA,EAAK,CAAA;AAChF,IAAA,MAAM,YAAY,MAAA,CAAO,KAAA,EAAO,WAAW,MAAA,CAAO,CAAC,GAAG,EAAA,IAAM,MAAA;AAE5D,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,SAAA;AAAA,MACP,OAAA,EAAS,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,QAC1B,OAAO,CAAA,CAAE,EAAA;AAAA,QACT,OAAO,CAAA,CAAE,KAAA;AAAA,QACT,aAAa,CAAA,CAAE;AAAA,OACjB,CAAE;AAAA,KACJ;AAAA,EACF;AACF,CAAC","file":"scopes-handler.js","sourcesContent":["import { defineHandler, useConfig, type PluginContextV3, type SelectData } from '@kb-labs/sdk';\nimport { type CommitPluginConfig, resolveCommitConfig } from '@kb-labs/commit-contracts';\n\n/**\n * GET /scopes handler\n *\n * Returns available scopes from kb.config.json (plugins.commit.scope.scopes).\n * Falls back to a single \"root\" scope if not configured.\n */\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, _input: unknown): Promise<SelectData> {\n    const fileConfig = await useConfig<Partial<CommitPluginConfig>>();\n    const config = resolveCommitConfig(fileConfig ?? {});\n\n    const scopes = config.scope?.scopes ?? [{ id: 'root', label: 'root', path: '.' }];\n    const defaultId = config.scope?.default ?? scopes[0]?.id ?? 'root';\n\n    return {\n      value: defaultId,\n      options: scopes.map((s) => ({\n        value: s.id,\n        label: s.label,\n        description: s.description,\n      })),\n    };\n  },\n});\n"]}

package/dist/rest/handlers/status-handler.d.ts

@@ -0,0 +1,27 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+/**
+ * GET /status handler
+ *
+ * Returns current status for a scope according to StatusResponse contract.
+ * Uses ctx.platform.cache for git status caching.
+ */
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<{
+    scope?: string;
+}, unknown, unknown>, {
+    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;
+}>;
+
+export { _default as default };

package/dist/rest/handlers/status-handler.js

@@ -0,0 +1,91 @@
+import { defineHandler, useConfig } from '@kb-labs/sdk';
+import { loadPlan } from '@kb-labs/commit-core/storage';
+import { getGitStatus } from '@kb-labs/commit-core/analyzer';
+import { COMMIT_CACHE_PREFIX, resolveCommitConfig } from '@kb-labs/commit-contracts';
+import * as path from 'path';
+
+// src/rest/handlers/status-handler.ts
+function resolveScopePath(baseCwd, scopeId = "root", scopes) {
+  const scopeDef = scopes?.find((s) => s.id === scopeId);
+  const relativePath = scopeDef?.path ?? (scopeId === "root" ? "." : scopeId);
+  return relativePath === "." ? baseCwd : path.join(baseCwd, relativePath);
+}
+
+// src/rest/handlers/status-handler.ts
+var STATUS_CACHE_TTL = 5e3;
+var status_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const scope = input.query?.scope || "root";
+    ctx.platform.logger.info(`[status-handler] Fetching status for scope: ${scope}`);
+    try {
+      const plan = await loadPlan(ctx.cwd, scope);
+      ctx.platform.logger.info(`[status-handler] Plan loaded: ${!!plan}`);
+      let filesChanged = 0;
+      let gitStatus = null;
+      const cacheKey = `${COMMIT_CACHE_PREFIX}git-status:${scope}`;
+      ctx.platform.logger.info(`[status-handler] Cache key: ${cacheKey}`);
+      const cached = await ctx.platform.cache.get(cacheKey);
+      ctx.platform.logger.info(`[status-handler] Cache hit: ${!!cached}`);
+      if (cached !== null && cached !== void 0) {
+        const cachedData = cached;
+        filesChanged = cachedData.count;
+        gitStatus = cachedData.status;
+      } else {
+        const fileConfig = await useConfig();
+        const config = resolveCommitConfig(fileConfig ?? {});
+        const scopeCwd = resolveScopePath(ctx.cwd, scope, config.scope?.scopes);
+        ctx.platform.logger.info(`[status-handler] Resolved scope CWD: ${scopeCwd}`);
+        gitStatus = await getGitStatus(scopeCwd);
+        ctx.platform.logger.info(`[status-handler] Git status fetched - staged: ${gitStatus.staged.length}, unstaged: ${gitStatus.unstaged.length}, untracked: ${gitStatus.untracked.length}`);
+        filesChanged = gitStatus.staged.length + gitStatus.unstaged.length + gitStatus.untracked.length;
+        ctx.platform.logger.info(`[status-handler] Total files changed: ${filesChanged}`);
+        await ctx.platform.cache.set(
+          cacheKey,
+          { count: filesChanged, status: gitStatus },
+          STATUS_CACHE_TTL
+        );
+      }
+      let planStatus = "idle";
+      let commitsApplied = 0;
+      if (plan) {
+        const appliedCacheKey = `${COMMIT_CACHE_PREFIX}plan-applied:${scope}`;
+        const appliedData = await ctx.platform.cache.get(appliedCacheKey);
+        if (appliedData) {
+          const applied = appliedData;
+          if (!applied.planCreatedAt || applied.planCreatedAt === plan.createdAt) {
+            commitsApplied = applied.commitsApplied;
+            planStatus = "applied";
+          } else {
+            await ctx.platform.cache.delete(appliedCacheKey);
+            planStatus = "ready";
+          }
+        } else {
+          planStatus = "ready";
+        }
+      }
+      return {
+        scope,
+        hasPlan: !!plan,
+        planStatus,
+        filesChanged,
+        commitsInPlan: plan?.commits.length || 0,
+        commitsApplied,
+        planTimestamp: plan?.createdAt,
+        gitStatus: gitStatus || void 0
+      };
+    } catch (error) {
+      return {
+        scope,
+        hasPlan: false,
+        planStatus: "idle",
+        filesChanged: 0,
+        commitsInPlan: 0,
+        commitsApplied: 0
+      };
+    }
+  }
+});
+
+export { status_handler_default as default };
+//# sourceMappingURL=status-handler.js.map
+//# sourceMappingURL=status-handler.js.map

package/dist/rest/handlers/status-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/scope-resolver.ts","../../../src/rest/handlers/status-handler.ts"],"names":[],"mappings":"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","file":"status-handler.js","sourcesContent":["import * as path from 'node:path';\nimport type { CommitScope } from '@kb-labs/commit-contracts';\n\n/**\n * Resolves a scope id to an absolute filesystem path.\n *\n * Looks up the scope in the provided scopes array by id.\n * Falls back to treating the id as a relative path from baseCwd (legacy compat).\n *\n * @param baseCwd  - Workspace root (ctx.cwd)\n * @param scopeId  - Scope identifier, e.g. \"root\", \"public/kb-labs\"\n * @param scopes   - Configured scopes from CommitPluginConfig.scope.scopes\n */\nexport function resolveScopePath(\n  baseCwd: string,\n  scopeId: string = 'root',\n  scopes?: CommitScope[],\n): string {\n  const scopeDef = scopes?.find((s) => s.id === scopeId);\n  const relativePath = scopeDef?.path ?? (scopeId === 'root' ? '.' : scopeId);\n  return relativePath === '.' ? baseCwd : path.join(baseCwd, relativePath);\n}\n","import { defineHandler, useConfig, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { loadPlan } from '@kb-labs/commit-core/storage';\nimport { getGitStatus } from '@kb-labs/commit-core/analyzer';\nimport { COMMIT_CACHE_PREFIX, type StatusResponse, type PlanStatus, type CommitPluginConfig, resolveCommitConfig } from '@kb-labs/commit-contracts';\nimport { resolveScopePath } from './scope-resolver';\n\nconst STATUS_CACHE_TTL = 5000; // 5 seconds\n\n/**\n * GET /status handler\n *\n * Returns current status for a scope according to StatusResponse contract.\n * Uses ctx.platform.cache for git status caching.\n */\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, input: RestInput<{ scope?: string }>): Promise<StatusResponse> {\n    const scope = input.query?.scope || 'root';\n\n    ctx.platform.logger.info(`[status-handler] Fetching status for scope: ${scope}`);\n\n    try {\n      // Load current plan\n      const plan = await loadPlan(ctx.cwd, scope);\n      ctx.platform.logger.info(`[status-handler] Plan loaded: ${!!plan}`);\n\n      // Get git status (with platform cache)\n      let filesChanged = 0;\n      let gitStatus = null;\n      const cacheKey = `${COMMIT_CACHE_PREFIX}git-status:${scope}`;\n      ctx.platform.logger.info(`[status-handler] Cache key: ${cacheKey}`);\n\n      // Try to get from cache\n      const cached = await ctx.platform.cache.get(cacheKey);\n      ctx.platform.logger.info(`[status-handler] Cache hit: ${!!cached}`);\n\n      if (cached !== null && cached !== undefined) {\n        // Use cached value\n        const cachedData = cached as { count: number; status: any };\n        filesChanged = cachedData.count;\n        gitStatus = cachedData.status;\n      } else {\n        // Fetch fresh git status\n        // Resolve scope to actual directory path (same as files-handler)\n        const fileConfig = await useConfig<Partial<CommitPluginConfig>>();\n        const config = resolveCommitConfig(fileConfig ?? {});\n        const scopeCwd = resolveScopePath(ctx.cwd, scope, config.scope?.scopes);\n        ctx.platform.logger.info(`[status-handler] Resolved scope CWD: ${scopeCwd}`);\n\n        gitStatus = await getGitStatus(scopeCwd);\n        ctx.platform.logger.info(`[status-handler] Git status fetched - staged: ${gitStatus.staged.length}, unstaged: ${gitStatus.unstaged.length}, untracked: ${gitStatus.untracked.length}`);\n\n        filesChanged =\n          gitStatus.staged.length +\n          gitStatus.unstaged.length +\n          gitStatus.untracked.length;\n\n        ctx.platform.logger.info(`[status-handler] Total files changed: ${filesChanged}`);\n\n        // Cache the result\n        await ctx.platform.cache.set(\n          cacheKey,\n          { count: filesChanged, status: gitStatus },\n          STATUS_CACHE_TTL\n        );\n      }\n\n      // Determine plan status\n      let planStatus: PlanStatus = 'idle';\n      let commitsApplied = 0;\n\n      if (plan) {\n        // Check if commits were applied (stored in cache after apply)\n        const appliedCacheKey = `${COMMIT_CACHE_PREFIX}plan-applied:${scope}`;\n        const appliedData = await ctx.platform.cache.get(appliedCacheKey);\n\n        if (appliedData) {\n          const applied = appliedData as { commitsApplied: number; planCreatedAt?: string };\n          // Only trust applied marker if it belongs to the current plan version.\n          if (!applied.planCreatedAt || applied.planCreatedAt === plan.createdAt) {\n            commitsApplied = applied.commitsApplied;\n            planStatus = 'applied';\n          } else {\n            await ctx.platform.cache.delete(appliedCacheKey);\n            planStatus = 'ready';\n          }\n        } else {\n          planStatus = 'ready';\n        }\n      }\n\n      return {\n        scope,\n        hasPlan: !!plan,\n        planStatus,\n        filesChanged,\n        commitsInPlan: plan?.commits.length || 0,\n        commitsApplied,\n        planTimestamp: plan?.createdAt,\n        gitStatus: gitStatus || undefined,\n      };\n    } catch (error) {\n      return {\n        scope,\n        hasPlan: false,\n        planStatus: 'idle',\n        filesChanged: 0,\n        commitsInPlan: 0,\n        commitsApplied: 0,\n      };\n    }\n  },\n});\n"]}

package/dist/rest/handlers/summarize-handler.d.ts

@@ -0,0 +1,21 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+/**
+ * POST /summarize handler
+ *
+ * Summarizes changes using LLM. Can summarize:
+ * - All changes in scope (if no file specified)
+ * - Specific file changes (if file specified)
+ */
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, {
+    scope: string;
+    file?: string | undefined;
+}, unknown>, {
+    scope: string;
+    summary: string;
+    tokensUsed?: number | undefined;
+    file?: string | undefined;
+}>;
+
+export { _default as default };

package/dist/rest/handlers/summarize-handler.js

@@ -0,0 +1,106 @@
+import { defineHandler, useLogger, useLLM, useConfig } from '@kb-labs/sdk';
+import { resolveCommitConfig } from '@kb-labs/commit-contracts';
+import { getFileDiff, getGitStatus, getAllChangedFiles } from '@kb-labs/commit-core/analyzer';
+import * as path from 'path';
+
+// src/rest/handlers/summarize-handler.ts
+function resolveScopePath(baseCwd, scopeId = "root", scopes) {
+  const scopeDef = scopes?.find((s) => s.id === scopeId);
+  const relativePath = scopeDef?.path ?? (scopeId === "root" ? "." : scopeId);
+  return relativePath === "." ? baseCwd : path.join(baseCwd, relativePath);
+}
+
+// src/rest/handlers/summarize-handler.ts
+var summarize_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const logger = useLogger();
+    const llm = useLLM();
+    if (!llm) {
+      throw new Error("LLM is not available. Please configure an LLM adapter.");
+    }
+    const { scope = "root", file } = input.body || {};
+    logger.info("[summarize-handler] Request received", { scope, file });
+    try {
+      const fileConfig = await useConfig();
+      const config = resolveCommitConfig(fileConfig ?? {});
+      const scopeCwd = resolveScopePath(ctx.cwd, scope, config.scope?.scopes);
+      logger.info("[summarize-handler] Resolved scope", { scope, scopeCwd });
+      let prompt;
+      if (file) {
+        logger.info("[summarize-handler] Summarizing file", { file });
+        const diffResult = await getFileDiff(scopeCwd, file);
+        prompt = `Analyze this git diff and provide a concise summary of what changed in this file.
+
+File: ${file}
+
+Diff:
+\`\`\`diff
+${diffResult.diff}
+\`\`\`
+
+Provide a 2-3 sentence summary focusing on:
+- What was added, modified, or removed
+- The purpose/intent of the changes
+- Any notable impacts
+
+Keep it concise and technical.`;
+      } else {
+        logger.info("[summarize-handler] Summarizing all changes");
+        const gitStatus = await getGitStatus(scopeCwd);
+        const files = getAllChangedFiles(gitStatus);
+        if (files.length === 0) {
+          return {
+            scope,
+            summary: "No changes detected in this scope."
+          };
+        }
+        const filesToSummarize = files.slice(0, 10);
+        const diffs = await Promise.all(
+          filesToSummarize.map(async (f) => {
+            const diff = await getFileDiff(scopeCwd, f);
+            return { file: f, diff: diff.diff, additions: diff.additions, deletions: diff.deletions };
+          })
+        );
+        const diffsText = diffs.map((d) => `### ${d.file} (+${d.additions} -${d.deletions})
+\`\`\`diff
+${d.diff}
+\`\`\``).join("\n\n");
+        prompt = `Analyze these git diffs and provide a high-level summary of all changes in this scope.
+
+Total files changed: ${files.length}
+${files.length > 10 ? `(Showing first 10 files)` : ""}
+
+${diffsText}
+
+Provide a 3-5 sentence summary covering:
+- Overall theme of the changes
+- Key features added, bugs fixed, or refactorings done
+- Any notable architectural changes
+
+Keep it concise and at a high level.`;
+      }
+      logger.info("[summarize-handler] Calling LLM");
+      const result = await llm.complete(prompt, {
+        systemPrompt: "You are a technical code reviewer. Provide concise, accurate summaries of code changes.",
+        temperature: 0.3,
+        maxTokens: 500
+      });
+      logger.info("[summarize-handler] LLM response received", {
+        tokensUsed: result.usage.promptTokens + result.usage.completionTokens
+      });
+      return {
+        scope,
+        file,
+        summary: result.content.trim(),
+        tokensUsed: result.usage.promptTokens + result.usage.completionTokens
+      };
+    } catch (error) {
+      logger.error("[summarize-handler] Error", error);
+      throw new Error(`Failed to summarize changes: ${error}`);
+    }
+  }
+});
+
+export { summarize_handler_default as default };
+//# sourceMappingURL=summarize-handler.js.map
+//# sourceMappingURL=summarize-handler.js.map

package/dist/rest/handlers/summarize-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/scope-resolver.ts","../../../src/rest/handlers/summarize-handler.ts"],"names":[],"mappings":"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","file":"summarize-handler.js","sourcesContent":["import * as path from 'node:path';\nimport type { CommitScope } from '@kb-labs/commit-contracts';\n\n/**\n * Resolves a scope id to an absolute filesystem path.\n *\n * Looks up the scope in the provided scopes array by id.\n * Falls back to treating the id as a relative path from baseCwd (legacy compat).\n *\n * @param baseCwd  - Workspace root (ctx.cwd)\n * @param scopeId  - Scope identifier, e.g. \"root\", \"public/kb-labs\"\n * @param scopes   - Configured scopes from CommitPluginConfig.scope.scopes\n */\nexport function resolveScopePath(\n  baseCwd: string,\n  scopeId: string = 'root',\n  scopes?: CommitScope[],\n): string {\n  const scopeDef = scopes?.find((s) => s.id === scopeId);\n  const relativePath = scopeDef?.path ?? (scopeId === 'root' ? '.' : scopeId);\n  return relativePath === '.' ? baseCwd : path.join(baseCwd, relativePath);\n}\n","import { defineHandler, useConfig, type PluginContextV3, type RestInput, useLogger, useLLM } from '@kb-labs/sdk';\nimport { type SummarizeRequest, type SummarizeResponse, type CommitPluginConfig, resolveCommitConfig } from '@kb-labs/commit-contracts';\nimport { getFileDiff, getAllChangedFiles, getGitStatus } from '@kb-labs/commit-core/analyzer';\nimport { resolveScopePath } from './scope-resolver';\n\n/**\n * POST /summarize handler\n *\n * Summarizes changes using LLM. Can summarize:\n * - All changes in scope (if no file specified)\n * - Specific file changes (if file specified)\n */\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, input: RestInput<unknown, SummarizeRequest>): Promise<SummarizeResponse> {\n    const logger = useLogger();\n    const llm = useLLM();\n\n    if (!llm) {\n      throw new Error('LLM is not available. Please configure an LLM adapter.');\n    }\n\n    const { scope = 'root', file } = input.body || {};\n\n    logger.info('[summarize-handler] Request received', { scope, file });\n\n    try {\n      // Resolve scope to actual directory path\n      const fileConfig = await useConfig<Partial<CommitPluginConfig>>();\n      const config = resolveCommitConfig(fileConfig ?? {});\n      const scopeCwd = resolveScopePath(ctx.cwd, scope, config.scope?.scopes);\n      logger.info('[summarize-handler] Resolved scope', { scope, scopeCwd });\n\n      let prompt: string;\n\n      if (file) {\n        // Summarize specific file\n        logger.info('[summarize-handler] Summarizing file', { file });\n\n        // Get file diff (git runs FROM scopeCwd)\n        const diffResult = await getFileDiff(scopeCwd, file);\n\n        prompt = `Analyze this git diff and provide a concise summary of what changed in this file.\n\nFile: ${file}\n\nDiff:\n\\`\\`\\`diff\n${diffResult.diff}\n\\`\\`\\`\n\nProvide a 2-3 sentence summary focusing on:\n- What was added, modified, or removed\n- The purpose/intent of the changes\n- Any notable impacts\n\nKeep it concise and technical.`;\n      } else {\n        // Summarize all changes\n        logger.info('[summarize-handler] Summarizing all changes');\n\n        // Get git status (git runs FROM scopeCwd)\n        const gitStatus = await getGitStatus(scopeCwd);\n        const files = getAllChangedFiles(gitStatus);\n\n        if (files.length === 0) {\n          return {\n            scope,\n            summary: 'No changes detected in this scope.',\n          };\n        }\n\n        // Get diffs for all files (limit to first 10 to avoid token overflow)\n        const filesToSummarize = files.slice(0, 10);\n        const diffs = await Promise.all(\n          filesToSummarize.map(async (f) => {\n            const diff = await getFileDiff(scopeCwd, f);\n            return { file: f, diff: diff.diff, additions: diff.additions, deletions: diff.deletions };\n          })\n        );\n\n        const diffsText = diffs\n          .map((d) => `### ${d.file} (+${d.additions} -${d.deletions})\\n\\`\\`\\`diff\\n${d.diff}\\n\\`\\`\\``)\n          .join('\\n\\n');\n\n        prompt = `Analyze these git diffs and provide a high-level summary of all changes in this scope.\n\nTotal files changed: ${files.length}\n${files.length > 10 ? `(Showing first 10 files)` : ''}\n\n${diffsText}\n\nProvide a 3-5 sentence summary covering:\n- Overall theme of the changes\n- Key features added, bugs fixed, or refactorings done\n- Any notable architectural changes\n\nKeep it concise and at a high level.`;\n      }\n\n      // Call LLM\n      logger.info('[summarize-handler] Calling LLM');\n      const result = await llm.complete(prompt, {\n        systemPrompt: 'You are a technical code reviewer. Provide concise, accurate summaries of code changes.',\n        temperature: 0.3,\n        maxTokens: 500,\n      });\n\n      logger.info('[summarize-handler] LLM response received', {\n        tokensUsed: result.usage.promptTokens + result.usage.completionTokens,\n      });\n\n      return {\n        scope,\n        file,\n        summary: result.content.trim(),\n        tokensUsed: result.usage.promptTokens + result.usage.completionTokens,\n      };\n    } catch (error) {\n      logger.error('[summarize-handler] Error', error as Error);\n      throw new Error(`Failed to summarize changes: ${error}`);\n    }\n  },\n});\n"]}