@kb-labs/commit-core 0.6.0

package/dist/recent-commits-DD6LX2OI.d.ts

@@ -0,0 +1,85 @@
+import { GitStatus, FileSummary } from '@kb-labs/commit-contracts';
+
+/**
+ * Git status analysis
+ */
+
+/**
+ * Get current git status (staged, unstaged, untracked files).
+ * cwd must already point to the resolved scope directory.
+ */
+declare function getGitStatus(cwd: string): Promise<GitStatus>;
+/**
+ * Get all changed files (staged + unstaged + untracked)
+ * Filters out node_modules and other build artifacts
+ */
+declare function getAllChangedFiles(status: GitStatus): string[];
+/**
+ * Check if there are any changes
+ */
+declare function hasChanges(status: GitStatus): boolean;
+/**
+ * Get current branch name
+ */
+declare function getCurrentBranch(cwd: string): Promise<string>;
+/**
+ * Check if branch is protected (main/master)
+ */
+declare function isProtectedBranch(branch: string): boolean;
+
+/**
+ * File summary extraction
+ */
+
+/**
+ * Get file summaries with diff stats for given files
+ * Supports nested git repositories by grouping files per repo
+ */
+declare function getFileSummaries(cwd: string, files: string[]): Promise<FileSummary[]>;
+/**
+ * Get a short summary string for display
+ */
+declare function formatFileSummary(summary: FileSummary): string;
+/**
+ * Get diff content for specific files
+ * Used when LLM requests more context (Phase 2 escalation)
+ * Supports nested git repositories (files with prefix like 'kb-labs-sdk/...')
+ */
+declare function getFileDiffs(cwd: string, files: string[]): Promise<Map<string, string>>;
+
+/**
+ * File diff utilities
+ */
+interface FileDiff {
+    diff: string;
+    additions: number;
+    deletions: number;
+}
+/**
+ * Get diff for a specific file
+ */
+declare function getFileDiff(cwd: string, filePath: string): Promise<FileDiff>;
+
+/**
+ * Recent commits analysis for style matching
+ */
+/**
+ * Get recent commit messages for style reference
+ *
+ * @param cwd - Working directory
+ * @param count - Number of commits to retrieve (default: 10)
+ * @returns Array of commit messages (subject line only)
+ */
+declare function getRecentCommits(cwd: string, count?: number): Promise<string[]>;
+/**
+ * Detect the commit style from recent commits
+ *
+ * @returns Detected style hints
+ */
+declare function detectCommitStyle(commits: string[]): {
+    usesConventional: boolean;
+    commonScopes: string[];
+    avgLength: number;
+};
+
+export { type FileDiff as F, getAllChangedFiles as a, getCurrentBranch as b, getFileSummaries as c, getFileDiff as d, getRecentCommits as e, formatFileSummary as f, getGitStatus as g, hasChanges as h, isProtectedBranch as i, detectCommitStyle as j, getFileDiffs as k };

package/dist/storage/index.d.ts

@@ -0,0 +1,59 @@
+import { CommitPlan, GitStatusSnapshot, ApplyResult } from '@kb-labs/commit-contracts';
+
+/**
+ * Commit plan storage in .kb/commit/
+ */
+
+/**
+ * Get path to commit storage directory
+ */
+declare function getCommitStoragePath(cwd: string): string;
+/**
+ * Get path to current plan file for a scope
+ */
+declare function getCurrentPlanPath(cwd: string, scope?: string): string;
+/**
+ * Get path to current status file for a scope
+ */
+declare function getCurrentStatusPath(cwd: string, scope?: string): string;
+/**
+ * Save commit plan to storage
+ */
+declare function savePlan(cwd: string, plan: CommitPlan, scope?: string): Promise<void>;
+/**
+ * Load current commit plan from storage
+ */
+declare function loadPlan(cwd: string, scope?: string): Promise<CommitPlan | null>;
+/**
+ * Load current status snapshot from storage
+ */
+declare function loadStatus(cwd: string, scope?: string): Promise<GitStatusSnapshot | null>;
+/**
+ * Check if a plan exists
+ */
+declare function hasPlan(cwd: string, scope?: string): Promise<boolean>;
+/**
+ * Clear current commit plan
+ */
+declare function clearPlan(cwd: string, scope?: string): Promise<void>;
+/**
+ * Save plan and result to history
+ */
+declare function saveToHistory(cwd: string, plan: CommitPlan, result: ApplyResult, scope?: string): Promise<void>;
+/**
+ * List history entries
+ */
+declare function listHistory(cwd: string, scope?: string): Promise<Array<{
+    timestamp: string;
+    path: string;
+}>>;
+/**
+ * Clean old history entries, keeping only the most recent N entries
+ */
+declare function cleanOldHistory(cwd: string, scope?: string, maxEntries?: number): Promise<void>;
+/**
+ * Initialize storage directory structure
+ */
+declare function initStorage(cwd: string, scope?: string): Promise<void>;
+
+export { cleanOldHistory, clearPlan, getCommitStoragePath, getCurrentPlanPath, getCurrentStatusPath, hasPlan, initStorage, listHistory, loadPlan, loadStatus, savePlan, saveToHistory };

package/dist/storage/index.js

@@ -0,0 +1,280 @@
+import { mkdir, writeFile, readFile, rm, readdir } from 'fs/promises';
+import { join, dirname } from 'path';
+import { CommitPlanSchema, GitStatusSnapshotSchema } from '@kb-labs/commit-contracts';
+import { simpleGit } from 'simple-git';
+
+// src/storage/plan-storage.ts
+function isTextFile(file) {
+  return !file.binary;
+}
+async function isNewFile(cwd, filePath) {
+  try {
+    const repo = await findGitRepo(cwd, filePath);
+    if (!repo) {
+      return true;
+    }
+    const git = simpleGit(repo.repoPath);
+    const result = await git.raw(["ls-tree", "HEAD", "--", repo.relativePath]);
+    return result.trim().length === 0;
+  } catch {
+    return true;
+  }
+}
+async function getFileSummaries(cwd, files) {
+  if (files.length === 0) {
+    return [];
+  }
+  const summaries = [];
+  const filesByRepo = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const repo = await findGitRepo(cwd, file);
+    if (!repo) {
+      const group2 = filesByRepo.get(cwd) ?? [];
+      group2.push({ repoPath: cwd, relativePath: file, originalPath: file });
+      filesByRepo.set(cwd, group2);
+      continue;
+    }
+    const group = filesByRepo.get(repo.repoPath) ?? [];
+    group.push({
+      repoPath: repo.repoPath,
+      relativePath: repo.relativePath,
+      originalPath: file
+    });
+    filesByRepo.set(repo.repoPath, group);
+  }
+  for (const [repoPath, fileInfos] of filesByRepo) {
+    const git = simpleGit(repoPath);
+    const relativePaths = fileInfos.map((f) => f.relativePath);
+    try {
+      const stagedDiff = await git.diffSummary([
+        "--cached",
+        "--",
+        ...relativePaths
+      ]);
+      const unstagedDiff = await git.diffSummary(["--", ...relativePaths]);
+      const allDiffFiles = /* @__PURE__ */ new Map();
+      for (const file of unstagedDiff.files) {
+        allDiffFiles.set(file.file, file);
+      }
+      for (const file of stagedDiff.files) {
+        allDiffFiles.set(file.file, file);
+      }
+      for (const file of allDiffFiles.values()) {
+        const fileInfo = fileInfos.find((f) => f.relativePath === file.file);
+        if (!fileInfo) {
+          continue;
+        }
+        const isNew = await isNewFile(repoPath, file.file);
+        if (isTextFile(file)) {
+          summaries.push({
+            path: fileInfo.originalPath,
+            status: mapDiffStatus(file.insertions, file.deletions),
+            additions: file.insertions,
+            deletions: file.deletions,
+            binary: false,
+            isNewFile: isNew
+          });
+        } else {
+          summaries.push({
+            path: fileInfo.originalPath,
+            status: "modified",
+            additions: 0,
+            deletions: 0,
+            binary: true,
+            isNewFile: isNew
+          });
+        }
+      }
+      const processedPaths = new Set(
+        Array.from(allDiffFiles.values()).map((f) => f.file)
+      );
+      const missingInRepo = fileInfos.filter(
+        (f) => !processedPaths.has(f.relativePath)
+      );
+      for (const fileInfo of missingInRepo) {
+        summaries.push({
+          path: fileInfo.originalPath,
+          status: "added",
+          additions: 0,
+          deletions: 0,
+          binary: false,
+          isNewFile: true
+        });
+      }
+    } catch {
+      for (const fileInfo of fileInfos) {
+        summaries.push({
+          path: fileInfo.originalPath,
+          status: "modified",
+          additions: 0,
+          deletions: 0,
+          binary: false,
+          isNewFile: false
+          // Conservative assumption
+        });
+      }
+    }
+  }
+  return summaries;
+}
+function mapDiffStatus(insertions, deletions) {
+  if (deletions === 0 && insertions > 0) {
+    return "added";
+  }
+  if (insertions === 0 && deletions > 0) {
+    return "deleted";
+  }
+  return "modified";
+}
+async function existsAsync(path) {
+  try {
+    const { existsSync } = await import('fs');
+    return existsSync(path);
+  } catch {
+    return false;
+  }
+}
+async function findGitRepo(basePath, filePath) {
+  const segments = filePath.split("/");
+  for (let i = segments.length - 1; i > 0; i--) {
+    const potentialRepoSegments = segments.slice(0, i);
+    const potentialRepoPath = `${basePath}/${potentialRepoSegments.join("/")}`;
+    const gitDir = `${potentialRepoPath}/.git`;
+    if (await existsAsync(gitDir)) {
+      const relativePath = segments.slice(i).join("/");
+      return { repoPath: potentialRepoPath, relativePath };
+    }
+  }
+  if (await existsAsync(`${basePath}/.git`)) {
+    return { repoPath: basePath, relativePath: filePath };
+  }
+  return null;
+}
+
+// src/storage/plan-storage.ts
+var COMMIT_DIR = ".kb/commit";
+var PLANS_DIR = "plans";
+var CURRENT_DIR = "current";
+var HISTORY_DIR = "history";
+var PLAN_FILE = "plan.json";
+var STATUS_FILE = "status.json";
+var RESULT_FILE = "result.json";
+var MAX_HISTORY_ENTRIES = 30;
+function normalizeScopeForPath(scope) {
+  return scope.replace(/\//g, "-").replace(/\*/g, "").replace(/\./g, "-").replace(/:/g, "-");
+}
+function getCommitStoragePath(cwd) {
+  return join(cwd, COMMIT_DIR);
+}
+function getScopePlanDir(cwd, scope = "root") {
+  const scopeDir = normalizeScopeForPath(scope);
+  return join(cwd, COMMIT_DIR, PLANS_DIR, scopeDir);
+}
+function getCurrentPlanPath(cwd, scope = "root") {
+  return join(getScopePlanDir(cwd, scope), CURRENT_DIR, PLAN_FILE);
+}
+function getCurrentStatusPath(cwd, scope = "root") {
+  return join(getScopePlanDir(cwd, scope), CURRENT_DIR, STATUS_FILE);
+}
+async function savePlan(cwd, plan, scope = "root") {
+  const planPath = getCurrentPlanPath(cwd, scope);
+  const statusPath = getCurrentStatusPath(cwd, scope);
+  await mkdir(dirname(planPath), { recursive: true });
+  await writeFile(planPath, JSON.stringify(plan, null, 2));
+  const status = plan.gitStatus;
+  const allFiles = [...status.staged, ...status.unstaged, ...status.untracked];
+  const summaries = await getFileSummaries(cwd, allFiles);
+  const snapshot = {
+    schemaVersion: "1.0",
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    status,
+    summaries
+  };
+  await writeFile(statusPath, JSON.stringify(snapshot, null, 2));
+}
+async function loadPlan(cwd, scope = "root") {
+  const planPath = getCurrentPlanPath(cwd, scope);
+  try {
+    const content = await readFile(planPath, "utf-8");
+    const data = JSON.parse(content);
+    const result = CommitPlanSchema.safeParse(data);
+    if (!result.success) {
+      console.error(`[loadPlan] Zod validation failed for ${planPath}:`, JSON.stringify(result.error.issues));
+      return null;
+    }
+    return result.data;
+  } catch (err) {
+    console.error(`[loadPlan] Failed to read ${planPath}:`, err instanceof Error ? err.message : err);
+    return null;
+  }
+}
+async function loadStatus(cwd, scope = "root") {
+  const statusPath = getCurrentStatusPath(cwd, scope);
+  try {
+    const content = await readFile(statusPath, "utf-8");
+    const data = JSON.parse(content);
+    const result = GitStatusSnapshotSchema.safeParse(data);
+    if (!result.success) {
+      return null;
+    }
+    return result.data;
+  } catch {
+    return null;
+  }
+}
+async function hasPlan(cwd, scope = "root") {
+  const plan = await loadPlan(cwd, scope);
+  return plan !== null;
+}
+async function clearPlan(cwd, scope = "root") {
+  const currentDir = join(getScopePlanDir(cwd, scope), CURRENT_DIR);
+  try {
+    await rm(currentDir, { recursive: true, force: true });
+  } catch {
+  }
+}
+async function saveToHistory(cwd, plan, result, scope = "root") {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const historyDir = join(getScopePlanDir(cwd, scope), HISTORY_DIR, timestamp);
+  await mkdir(historyDir, { recursive: true });
+  await writeFile(join(historyDir, PLAN_FILE), JSON.stringify(plan, null, 2));
+  await writeFile(join(historyDir, RESULT_FILE), JSON.stringify(result, null, 2));
+  await cleanOldHistory(cwd, scope);
+}
+async function listHistory(cwd, scope = "root") {
+  const historyDir = join(getScopePlanDir(cwd, scope), HISTORY_DIR);
+  try {
+    const entries = await readdir(historyDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => ({
+      timestamp: e.name,
+      path: join(historyDir, e.name)
+    })).sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+  } catch {
+    return [];
+  }
+}
+async function cleanOldHistory(cwd, scope = "root", maxEntries = MAX_HISTORY_ENTRIES) {
+  const entries = await listHistory(cwd, scope);
+  if (entries.length > maxEntries) {
+    const toDelete = entries.slice(maxEntries);
+    for (const entry of toDelete) {
+      try {
+        await rm(entry.path, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  }
+}
+async function initStorage(cwd, scope = "root") {
+  const dirs = [
+    join(getScopePlanDir(cwd, scope), CURRENT_DIR),
+    join(getScopePlanDir(cwd, scope), HISTORY_DIR)
+  ];
+  for (const dir of dirs) {
+    await mkdir(dir, { recursive: true });
+  }
+}
+
+export { cleanOldHistory, clearPlan, getCommitStoragePath, getCurrentPlanPath, getCurrentStatusPath, hasPlan, initStorage, listHistory, loadPlan, loadStatus, savePlan, saveToHistory };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/analyzer/file-summary.ts","../../src/storage/plan-storage.ts"],"names":["group"],"mappings":";;;;;;AAiBA,SAAS,WACP,IAAA,EAC4B;AAC5B,EAAA,OAAO,CAAC,IAAA,CAAK,MAAA;AACf;AAQA,eAAe,SAAA,CAAU,KAAa,QAAA,EAAoC;AACxE,EAAA,IAAI;AAEF,IAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAA;AAE5C,IAAA,IAAI,CAAC,IAAA,EAAM;AAET,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,MAAM,GAAA,GAAM,SAAA,CAAU,IAAA,CAAK,QAAQ,CAAA;AAMnC,IAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,GAAA,CAAI,CAAC,WAAW,MAAA,EAAQ,IAAA,EAAM,IAAA,CAAK,YAAY,CAAC,CAAA;AAIzE,IAAA,OAAO,MAAA,CAAO,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA;AAAA,EAClC,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAOA,eAAsB,gBAAA,CACpB,KACA,KAAA,EACwB;AACxB,EAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACtB,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,YAA2B,EAAC;AAGlC,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAGtB;AAEF,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,GAAA,EAAK,IAAI,CAAA;AAExC,IAAA,IAAI,CAAC,IAAA,EAAM;AAET,MAAA,MAAMA,MAAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,GAAG,KAAK,EAAC;AACvC,MAAAA,MAAAA,CAAM,KAAK,EAAE,QAAA,EAAU,KAAK,YAAA,EAAc,IAAA,EAAM,YAAA,EAAc,IAAA,EAAM,CAAA;AACpE,MAAA,WAAA,CAAY,GAAA,CAAI,KAAKA,MAAK,CAAA;AAC1B,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,QAAQ,WAAA,CAAY,GAAA,CAAI,IAAA,CAAK,QAAQ,KAAK,EAAC;AACjD,IAAA,KAAA,CAAM,IAAA,CAAK;AAAA,MACT,UAAU,IAAA,CAAK,QAAA;AAAA,MACf,cAAc,IAAA,CAAK,YAAA;AAAA,MACnB,YAAA,EAAc;AAAA,KACf,CAAA;AACD,IAAA,WAAA,CAAY,GAAA,CAAI,IAAA,CAAK,QAAA,EAAU,KAAK,CAAA;AAAA,EACtC;AAGA,EAAA,KAAA,MAAW,CAAC,QAAA,EAAU,SAAS,CAAA,IAAK,WAAA,EAAa;AAC/C,IAAA,MAAM,GAAA,GAAiB,UAAU,QAAQ,CAAA;AACzC,IAAA,MAAM,gBAAgB,SAAA,CAAU,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,YAAY,CAAA;AAEzD,IAAA,IAAI;AAEF,MAAA,MAAM,UAAA,GAAa,MAAM,GAAA,CAAI,WAAA,CAAY;AAAA,QACvC,UAAA;AAAA,QACA,IAAA;AAAA,QACA,GAAG;AAAA,OACJ,CAAA;AAGD,MAAA,MAAM,YAAA,GAAe,MAAM,GAAA,CAAI,WAAA,CAAY,CAAC,IAAA,EAAM,GAAG,aAAa,CAAC,CAAA;AAGnE,MAAA,MAAM,YAAA,uBAAmB,GAAA,EAGvB;AACF,MAAA,KAAA,MAAW,IAAA,IAAQ,aAAa,KAAA,EAAO;AACrC,QAAA,YAAA,CAAa,GAAA,CAAI,IAAA,CAAK,IAAA,EAAM,IAAI,CAAA;AAAA,MAClC;AACA,MAAA,KAAA,MAAW,IAAA,IAAQ,WAAW,KAAA,EAAO;AAEnC,QAAA,YAAA,CAAa,GAAA,CAAI,IAAA,CAAK,IAAA,EAAM,IAAI,CAAA;AAAA,MAClC;AAGA,MAAA,KAAA,MAAW,IAAA,IAAQ,YAAA,CAAa,MAAA,EAAO,EAAG;AAExC,QAAA,MAAM,QAAA,GAAW,UAAU,IAAA,CAAK,CAAC,MAAM,CAAA,CAAE,YAAA,KAAiB,KAAK,IAAI,CAAA;AACnE,QAAA,IAAI,CAAC,QAAA,EAAU;AACb,UAAA;AAAA,QACF;AAGA,QAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,CAAU,QAAA,EAAU,KAAK,IAAI,CAAA;AAGjD,QAAA,IAAI,UAAA,CAAW,IAAI,CAAA,EAAG;AACpB,UAAA,SAAA,CAAU,IAAA,CAAK;AAAA,YACb,MAAM,QAAA,CAAS,YAAA;AAAA,YACf,MAAA,EAAQ,aAAA,CAAc,IAAA,CAAK,UAAA,EAAY,KAAK,SAAS,CAAA;AAAA,YACrD,WAAW,IAAA,CAAK,UAAA;AAAA,YAChB,WAAW,IAAA,CAAK,SAAA;AAAA,YAChB,MAAA,EAAQ,KAAA;AAAA,YACR,SAAA,EAAW;AAAA,WACZ,CAAA;AAAA,QACH,CAAA,MAAO;AAEL,UAAA,SAAA,CAAU,IAAA,CAAK;AAAA,YACb,MAAM,QAAA,CAAS,YAAA;AAAA,YACf,MAAA,EAAQ,UAAA;AAAA,YACR,SAAA,EAAW,CAAA;AAAA,YACX,SAAA,EAAW,CAAA;AAAA,YACX,MAAA,EAAQ,IAAA;AAAA,YACR,SAAA,EAAW;AAAA,WACZ,CAAA;AAAA,QACH;AAAA,MACF;AAGA,MAAA,MAAM,iBAAiB,IAAI,GAAA;AAAA,QACzB,KAAA,CAAM,IAAA,CAAK,YAAA,CAAa,MAAA,EAAQ,EAAE,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,IAAI;AAAA,OACrD;AACA,MAAA,MAAM,gBAAgB,SAAA,CAAU,MAAA;AAAA,QAC9B,CAAC,CAAA,KAAM,CAAC,cAAA,CAAe,GAAA,CAAI,EAAE,YAAY;AAAA,OAC3C;AAEA,MAAA,KAAA,MAAW,YAAY,aAAA,EAAe;AAEpC,QAAA,SAAA,CAAU,IAAA,CAAK;AAAA,UACb,MAAM,QAAA,CAAS,YAAA;AAAA,UACf,MAAA,EAAQ,OAAA;AAAA,UACR,SAAA,EAAW,CAAA;AAAA,UACX,SAAA,EAAW,CAAA;AAAA,UACX,MAAA,EAAQ,KAAA;AAAA,UACR,SAAA,EAAW;AAAA,SACZ,CAAA;AAAA,MACH;AAAA,IACF,CAAA,CAAA,MAAQ;AAEN,MAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAChC,QAAA,SAAA,CAAU,IAAA,CAAK;AAAA,UACb,MAAM,QAAA,CAAS,YAAA;AAAA,UACf,MAAA,EAAQ,UAAA;AAAA,UACR,SAAA,EAAW,CAAA;AAAA,UACX,SAAA,EAAW,CAAA;AAAA,UACX,MAAA,EAAQ,KAAA;AAAA,UACR,SAAA,EAAW;AAAA;AAAA,SACZ,CAAA;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,SAAA;AACT;AAKA,SAAS,aAAA,CACP,YACA,SAAA,EACuB;AAEvB,EAAA,IAAI,SAAA,KAAc,CAAA,IAAK,UAAA,GAAa,CAAA,EAAG;AACrC,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,IAAI,UAAA,KAAe,CAAA,IAAK,SAAA,GAAY,CAAA,EAAG;AACrC,IAAA,OAAO,SAAA;AAAA,EACT;AACA,EAAA,OAAO,UAAA;AACT;AAqFA,eAAe,YAAY,IAAA,EAAgC;AACzD,EAAA,IAAI;AACF,IAAA,MAAM,EAAE,UAAA,EAAW,GAAI,MAAM,OAAO,IAAS,CAAA;AAC7C,IAAA,OAAO,WAAW,IAAI,CAAA;AAAA,EACxB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAmBA,eAAe,WAAA,CACb,UACA,QAAA,EAC4D;AAC5D,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA;AAUnC,EAAA,KAAA,IAAS,IAAI,QAAA,CAAS,MAAA,GAAS,CAAA,EAAG,CAAA,GAAI,GAAG,CAAA,EAAA,EAAK;AAC5C,IAAA,MAAM,qBAAA,GAAwB,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AACjD,IAAA,MAAM,oBAAoB,CAAA,EAAG,QAAQ,IAAI,qBAAA,CAAsB,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA;AACxE,IAAA,MAAM,MAAA,GAAS,GAAG,iBAAiB,CAAA,KAAA,CAAA;AAEnC,IAAA,IAAI,MAAM,WAAA,CAAY,MAAM,CAAA,EAAG;AAE7B,MAAA,MAAM,eAAe,QAAA,CAAS,KAAA,CAAM,CAAC,CAAA,CAAE,KAAK,GAAG,CAAA;AAC/C,MAAA,OAAO,EAAE,QAAA,EAAU,iBAAA,EAAmB,YAAA,EAAa;AAAA,IACrD;AAAA,EACF;AAGA,EAAA,IAAI,MAAM,WAAA,CAAY,CAAA,EAAG,QAAQ,OAAO,CAAA,EAAG;AACzC,IAAA,OAAO,EAAE,QAAA,EAAU,QAAA,EAAU,YAAA,EAAc,QAAA,EAAS;AAAA,EACtD;AAGA,EAAA,OAAO,IAAA;AACT;;;ACzVA,IAAM,UAAA,GAAa,YAAA;AACnB,IAAM,SAAA,GAAY,OAAA;AAClB,IAAM,WAAA,GAAc,SAAA;AACpB,IAAM,WAAA,GAAc,SAAA;AACpB,IAAM,SAAA,GAAY,WAAA;AAClB,IAAM,WAAA,GAAc,aAAA;AACpB,IAAM,WAAA,GAAc,aAAA;AACpB,IAAM,mBAAA,GAAsB,EAAA;AAO5B,SAAS,sBAAsB,KAAA,EAAuB;AACpD,EAAA,OAAO,KAAA,CACJ,OAAA,CAAQ,KAAA,EAAO,GAAG,EAClB,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA,CACjB,QAAQ,KAAA,EAAO,GAAG,CAAA,CAClB,OAAA,CAAQ,MAAM,GAAG,CAAA;AACtB;AAKO,SAAS,qBAAqB,GAAA,EAAqB;AACxD,EAAA,OAAO,IAAA,CAAK,KAAK,UAAU,CAAA;AAC7B;AAKO,SAAS,eAAA,CAAgB,GAAA,EAAa,KAAA,GAAgB,MAAA,EAAgB;AAC3E,EAAA,MAAM,QAAA,GAAW,sBAAsB,KAAK,CAAA;AAC5C,EAAA,OAAO,IAAA,CAAK,GAAA,EAAK,UAAA,EAAY,SAAA,EAAW,QAAQ,CAAA;AAClD;AAKO,SAAS,kBAAA,CAAmB,GAAA,EAAa,KAAA,GAAgB,MAAA,EAAgB;AAC9E,EAAA,OAAO,KAAK,eAAA,CAAgB,GAAA,EAAK,KAAK,CAAA,EAAG,aAAa,SAAS,CAAA;AACjE;AAKO,SAAS,oBAAA,CAAqB,GAAA,EAAa,KAAA,GAAgB,MAAA,EAAgB;AAChF,EAAA,OAAO,KAAK,eAAA,CAAgB,GAAA,EAAK,KAAK,CAAA,EAAG,aAAa,WAAW,CAAA;AACnE;AAKA,eAAsB,QAAA,CAAS,GAAA,EAAa,IAAA,EAAkB,KAAA,GAAgB,MAAA,EAAuB;AACnG,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,GAAA,EAAK,KAAK,CAAA;AAC9C,EAAA,MAAM,UAAA,GAAa,oBAAA,CAAqB,GAAA,EAAK,KAAK,CAAA;AAGlD,EAAA,MAAM,MAAM,OAAA,CAAQ,QAAQ,GAAG,EAAE,SAAA,EAAW,MAAM,CAAA;AAGlD,EAAA,MAAM,UAAU,QAAA,EAAU,IAAA,CAAK,UAAU,IAAA,EAAM,IAAA,EAAM,CAAC,CAAC,CAAA;AAGvD,EAAA,MAAM,SAAS,IAAA,CAAK,SAAA;AACpB,EAAA,MAAM,QAAA,GAAW,CAAC,GAAG,MAAA,CAAO,MAAA,EAAQ,GAAG,MAAA,CAAO,QAAA,EAAU,GAAG,MAAA,CAAO,SAAS,CAAA;AAC3E,EAAA,MAAM,SAAA,GAAY,MAAM,gBAAA,CAAiB,GAAA,EAAK,QAAQ,CAAA;AAEtD,EAAA,MAAM,QAAA,GAA8B;AAAA,IAClC,aAAA,EAAe,KAAA;AAAA,IACf,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,IAClC,MAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,MAAM,UAAU,UAAA,EAAY,IAAA,CAAK,UAAU,QAAA,EAAU,IAAA,EAAM,CAAC,CAAC,CAAA;AAC/D;AAKA,eAAsB,QAAA,CAAS,GAAA,EAAa,KAAA,GAAgB,MAAA,EAAoC;AAC9F,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,GAAA,EAAK,KAAK,CAAA;AAE9C,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAM,QAAA,CAAS,QAAA,EAAU,OAAO,CAAA;AAChD,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,OAAO,CAAA;AAG/B,IAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,SAAA,CAAU,IAAI,CAAA;AAC9C,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,OAAA,CAAQ,KAAA,CAAM,wCAAwC,QAAQ,CAAA,CAAA,CAAA,EAAK,KAAK,SAAA,CAAU,MAAA,CAAO,KAAA,CAAM,MAAM,CAAC,CAAA;AACtG,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,OAAO,MAAA,CAAO,IAAA;AAAA,EAChB,SAAS,GAAA,EAAK;AACZ,IAAA,OAAA,CAAQ,KAAA,CAAM,6BAA6B,QAAQ,CAAA,CAAA,CAAA,EAAK,eAAe,KAAA,GAAQ,GAAA,CAAI,UAAU,GAAG,CAAA;AAChG,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAKA,eAAsB,UAAA,CAAW,GAAA,EAAa,KAAA,GAAgB,MAAA,EAA2C;AACvG,EAAA,MAAM,UAAA,GAAa,oBAAA,CAAqB,GAAA,EAAK,KAAK,CAAA;AAElD,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAM,QAAA,CAAS,UAAA,EAAY,OAAO,CAAA;AAClD,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,OAAO,CAAA;AAE/B,IAAA,MAAM,MAAA,GAAS,uBAAA,CAAwB,SAAA,CAAU,IAAI,CAAA;AACrD,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,OAAO,MAAA,CAAO,IAAA;AAAA,EAChB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAKA,eAAsB,OAAA,CAAQ,GAAA,EAAa,KAAA,GAAgB,MAAA,EAA0B;AACnF,EAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,GAAA,EAAK,KAAK,CAAA;AACtC,EAAA,OAAO,IAAA,KAAS,IAAA;AAClB;AAKA,eAAsB,SAAA,CAAU,GAAA,EAAa,KAAA,GAAgB,MAAA,EAAuB;AAClF,EAAA,MAAM,aAAa,IAAA,CAAK,eAAA,CAAgB,GAAA,EAAK,KAAK,GAAG,WAAW,CAAA;AAEhE,EAAA,IAAI;AACF,IAAA,MAAM,GAAG,UAAA,EAAY,EAAE,WAAW,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAAA,EACvD,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAKA,eAAsB,aAAA,CACpB,GAAA,EACA,IAAA,EACA,MAAA,EACA,QAAgB,MAAA,EACD;AACf,EAAA,MAAM,SAAA,GAAA,qBAAgB,IAAA,EAAK,EAAE,aAAY,CAAE,OAAA,CAAQ,SAAS,GAAG,CAAA;AAC/D,EAAA,MAAM,aAAa,IAAA,CAAK,eAAA,CAAgB,KAAK,KAAK,CAAA,EAAG,aAAa,SAAS,CAAA;AAE3E,EAAA,MAAM,KAAA,CAAM,UAAA,EAAY,EAAE,SAAA,EAAW,MAAM,CAAA;AAE3C,EAAA,MAAM,SAAA,CAAU,IAAA,CAAK,UAAA,EAAY,SAAS,CAAA,EAAG,KAAK,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,CAAC,CAAC,CAAA;AAC1E,EAAA,MAAM,SAAA,CAAU,IAAA,CAAK,UAAA,EAAY,WAAW,CAAA,EAAG,KAAK,SAAA,CAAU,MAAA,EAAQ,IAAA,EAAM,CAAC,CAAC,CAAA;AAG9E,EAAA,MAAM,eAAA,CAAgB,KAAK,KAAK,CAAA;AAClC;AAKA,eAAsB,WAAA,CACpB,GAAA,EACA,KAAA,GAAgB,MAAA,EACqC;AACrD,EAAA,MAAM,aAAa,IAAA,CAAK,eAAA,CAAgB,GAAA,EAAK,KAAK,GAAG,WAAW,CAAA;AAEhE,EAAA,IAAI;AACF,IAAA,MAAM,UAAU,MAAM,OAAA,CAAQ,YAAY,EAAE,aAAA,EAAe,MAAM,CAAA;AAEjE,IAAA,OAAO,OAAA,CACJ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,aAAa,CAAA,CAC7B,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,MACX,WAAW,CAAA,CAAE,IAAA;AAAA,MACb,IAAA,EAAM,IAAA,CAAK,UAAA,EAAY,CAAA,CAAE,IAAI;AAAA,KAC/B,CAAE,CAAA,CACD,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,SAAA,CAAU,aAAA,CAAc,CAAA,CAAE,SAAS,CAAC,CAAA;AAAA,EAC1D,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AAKA,eAAsB,eAAA,CACpB,GAAA,EACA,KAAA,GAAgB,MAAA,EAChB,aAAqB,mBAAA,EACN;AACf,EAAA,MAAM,OAAA,GAAU,MAAM,WAAA,CAAY,GAAA,EAAK,KAAK,CAAA;AAG5C,EAAA,IAAI,OAAA,CAAQ,SAAS,UAAA,EAAY;AAC/B,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAEzC,IAAA,KAAA,MAAW,SAAS,QAAA,EAAU;AAC5B,MAAA,IAAI;AACF,QAAA,MAAM,EAAA,CAAG,MAAM,IAAA,EAAM,EAAE,WAAW,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAAA,MACvD,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;AAKA,eAAsB,WAAA,CAAY,GAAA,EAAa,KAAA,GAAgB,MAAA,EAAuB;AACpF,EAAA,MAAM,IAAA,GAAO;AAAA,IACX,IAAA,CAAK,eAAA,CAAgB,GAAA,EAAK,KAAK,GAAG,WAAW,CAAA;AAAA,IAC7C,IAAA,CAAK,eAAA,CAAgB,GAAA,EAAK,KAAK,GAAG,WAAW;AAAA,GAC/C;AAEA,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,MAAM,KAAA,CAAM,GAAA,EAAK,EAAE,SAAA,EAAW,MAAM,CAAA;AAAA,EACtC;AACF","file":"index.js","sourcesContent":["/**\n * File summary extraction\n */\n\n/* eslint-disable no-await-in-loop -- Sequential git operations required: must check status, read diffs, compute summaries one-by-one for each file */\n\nimport {\n  simpleGit,\n  type SimpleGit,\n  type DiffResultTextFile,\n  type DiffResultBinaryFile,\n} from \"simple-git\";\nimport type { FileSummary } from \"@kb-labs/commit-contracts\";\n\n/**\n * Type guard for text file diff result\n */\nfunction isTextFile(\n  file: DiffResultTextFile | DiffResultBinaryFile,\n): file is DiffResultTextFile {\n  return !file.binary;\n}\n\n/**\n * Check if file is truly new (doesn't exist in current HEAD commit)\n * Returns true if file doesn't exist in HEAD (the current committed state)\n * Returns false if file exists in HEAD (even if modified/deleted locally)\n * Supports nested git repositories\n */\nasync function isNewFile(cwd: string, filePath: string): Promise<boolean> {\n  try {\n    // Find the git repository for this file (walks up directory tree)\n    const repo = await findGitRepo(cwd, filePath);\n\n    if (!repo) {\n      // No git repo found - treat as new file\n      return true;\n    }\n\n    const git = simpleGit(repo.repoPath);\n\n    // Check if file exists in HEAD (current commit), not in history\n    // git ls-tree HEAD -- <file>\n    // Returns tree entry if file exists in HEAD, empty if file is new\n    // This correctly handles modified/unstaged files (they exist in HEAD = not new)\n    const result = await git.raw([\"ls-tree\", \"HEAD\", \"--\", repo.relativePath]);\n\n    // If no output, file doesn't exist in HEAD → truly new file\n    // If has output, file exists in HEAD → not new (modified/unstaged)\n    return result.trim().length === 0;\n  } catch {\n    // On error, assume it's new (safer to say \"new\" than claim it existed)\n    return true;\n  }\n}\n\n/**\n * Get file summaries with diff stats for given files\n * Supports nested git repositories by grouping files per repo\n */\n// eslint-disable-next-line sonarjs/cognitive-complexity -- File summary extraction: groups files by repo, handles nested git repos, computes diff stats, processes staged/unstaged/untracked files\nexport async function getFileSummaries(\n  cwd: string,\n  files: string[],\n): Promise<FileSummary[]> {\n  if (files.length === 0) {\n    return [];\n  }\n\n  const summaries: FileSummary[] = [];\n\n  // Group files by repository (walks up directory tree to find .git)\n  const filesByRepo = new Map<\n    string,\n    { repoPath: string; relativePath: string; originalPath: string }[]\n  >();\n\n  for (const file of files) {\n    const repo = await findGitRepo(cwd, file);\n\n    if (!repo) {\n      // No git repo found - treat as file in cwd\n      const group = filesByRepo.get(cwd) ?? [];\n      group.push({ repoPath: cwd, relativePath: file, originalPath: file });\n      filesByRepo.set(cwd, group);\n      continue;\n    }\n\n    // Group by repository path\n    const group = filesByRepo.get(repo.repoPath) ?? [];\n    group.push({\n      repoPath: repo.repoPath,\n      relativePath: repo.relativePath,\n      originalPath: file,\n    });\n    filesByRepo.set(repo.repoPath, group);\n  }\n\n  // Get diff summaries for each repo separately\n  for (const [repoPath, fileInfos] of filesByRepo) {\n    const git: SimpleGit = simpleGit(repoPath);\n    const relativePaths = fileInfos.map((f) => f.relativePath);\n\n    try {\n      // Try staged diff first\n      const stagedDiff = await git.diffSummary([\n        \"--cached\",\n        \"--\",\n        ...relativePaths,\n      ]);\n\n      // Then try unstaged diff (working tree changes)\n      const unstagedDiff = await git.diffSummary([\"--\", ...relativePaths]);\n\n      // Combine results (prefer staged if file appears in both)\n      const allDiffFiles = new Map<\n        string,\n        DiffResultTextFile | DiffResultBinaryFile\n      >();\n      for (const file of unstagedDiff.files) {\n        allDiffFiles.set(file.file, file);\n      }\n      for (const file of stagedDiff.files) {\n        // Staged takes priority\n        allDiffFiles.set(file.file, file);\n      }\n\n      // Process diff results\n      for (const file of allDiffFiles.values()) {\n        // Find original path (with repo prefix)\n        const fileInfo = fileInfos.find((f) => f.relativePath === file.file);\n        if (!fileInfo) {\n          continue;\n        }\n\n        // Check if file is truly new (using repoPath as cwd)\n        const isNew = await isNewFile(repoPath, file.file);\n\n        // Handle both text and binary files\n        if (isTextFile(file)) {\n          summaries.push({\n            path: fileInfo.originalPath,\n            status: mapDiffStatus(file.insertions, file.deletions),\n            additions: file.insertions,\n            deletions: file.deletions,\n            binary: false,\n            isNewFile: isNew,\n          });\n        } else {\n          // Binary file\n          summaries.push({\n            path: fileInfo.originalPath,\n            status: \"modified\",\n            additions: 0,\n            deletions: 0,\n            binary: true,\n            isNewFile: isNew,\n          });\n        }\n      }\n\n      // Add any missing files from this repo (untracked - not in git yet)\n      const processedPaths = new Set(\n        Array.from(allDiffFiles.values()).map((f) => f.file),\n      );\n      const missingInRepo = fileInfos.filter(\n        (f) => !processedPaths.has(f.relativePath),\n      );\n\n      for (const fileInfo of missingInRepo) {\n        // Untracked files are always new (never existed in git)\n        summaries.push({\n          path: fileInfo.originalPath,\n          status: \"added\",\n          additions: 0,\n          deletions: 0,\n          binary: false,\n          isNewFile: true,\n        });\n      }\n    } catch {\n      // Fallback: create basic summaries for this repo's files\n      for (const fileInfo of fileInfos) {\n        summaries.push({\n          path: fileInfo.originalPath,\n          status: \"modified\",\n          additions: 0,\n          deletions: 0,\n          binary: false,\n          isNewFile: false, // Conservative assumption\n        });\n      }\n    }\n  }\n\n  return summaries;\n}\n\n/**\n * Map insertions/deletions to status\n */\nfunction mapDiffStatus(\n  insertions: number,\n  deletions: number,\n): FileSummary[\"status\"] {\n  // Simple heuristic: if only insertions, likely added; if only deletions, likely deleted\n  if (deletions === 0 && insertions > 0) {\n    return \"added\";\n  }\n  if (insertions === 0 && deletions > 0) {\n    return \"deleted\";\n  }\n  return \"modified\";\n}\n\n/**\n * Get a short summary string for display\n */\nexport function formatFileSummary(summary: FileSummary): string {\n  const stats = summary.binary\n    ? \"binary\"\n    : `+${summary.additions}/-${summary.deletions}`;\n  return `${summary.path} (${summary.status}, ${stats})`;\n}\n\n/**\n * Get diff content for specific files\n * Used when LLM requests more context (Phase 2 escalation)\n * Supports nested git repositories (files with prefix like 'kb-labs-sdk/...')\n */\n// eslint-disable-next-line sonarjs/cognitive-complexity -- Diff extraction: groups files by nested repo, handles staged/unstaged diffs, processes binary files, merges results\nexport async function getFileDiffs(\n  cwd: string,\n  files: string[],\n): Promise<Map<string, string>> {\n  if (files.length === 0) {\n    return new Map();\n  }\n\n  const diffs = new Map<string, string>();\n\n  // Group files by repository (walks up directory tree to find .git)\n  const filesByRepo = new Map<\n    string,\n    { repoPath: string; relativePath: string; originalPath: string }[]\n  >();\n\n  for (const file of files) {\n    const repo = await findGitRepo(cwd, file);\n\n    if (!repo) {\n      // No git repo found - treat as file in cwd\n      const group = filesByRepo.get(cwd) ?? [];\n      group.push({ repoPath: cwd, relativePath: file, originalPath: file });\n      filesByRepo.set(cwd, group);\n      continue;\n    }\n\n    // Group by repository path\n    const group = filesByRepo.get(repo.repoPath) ?? [];\n    group.push({\n      repoPath: repo.repoPath,\n      relativePath: repo.relativePath,\n      originalPath: file,\n    });\n    filesByRepo.set(repo.repoPath, group);\n  }\n\n  // Get diffs for each repo\n  for (const [repoPath, fileInfos] of filesByRepo) {\n    const git: SimpleGit = simpleGit(repoPath);\n\n    for (const { relativePath, originalPath } of fileInfos) {\n      try {\n        // Try staged diff first, then unstaged\n        let diff = await git.diff([\"--cached\", \"--\", relativePath]);\n        if (!diff) {\n          diff = await git.diff([\"--\", relativePath]);\n        }\n        if (!diff) {\n          // For untracked files, try to read content\n          diff = await git.show([`:${relativePath}`]).catch(() => \"\");\n        }\n        if (diff) {\n          diffs.set(originalPath, diff);\n        }\n      } catch {\n        // Skip files that can't be diffed\n      }\n    }\n  }\n\n  return diffs;\n}\n\n/**\n * Helper to check if path exists asynchronously\n */\nasync function existsAsync(path: string): Promise<boolean> {\n  try {\n    const { existsSync } = await import(\"node:fs\");\n    return existsSync(path);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Find the git repository root for a given file path.\n * Walks up the directory tree to find the nearest .git directory.\n *\n * @param basePath - Base path to start searching from (e.g., /Users/user/project)\n * @param filePath - Relative file path (e.g., kb-labs-commit/packages/core/src/index.ts)\n * @returns Object with repoPath (absolute) and relativePath (relative to repo), or null if no repo found\n *\n * @example\n * // For nested repo:\n * findGitRepo('/Users/user/kb-labs', 'kb-labs-commit/packages/core/src/index.ts')\n * // Returns: { repoPath: '/Users/user/kb-labs/kb-labs-commit', relativePath: 'packages/core/src/index.ts' }\n *\n * // For file in root repo:\n * findGitRepo('/Users/user/kb-labs', 'src/index.ts')\n * // Returns: { repoPath: '/Users/user/kb-labs', relativePath: 'src/index.ts' }\n */\nasync function findGitRepo(\n  basePath: string,\n  filePath: string,\n): Promise<{ repoPath: string; relativePath: string } | null> {\n  const segments = filePath.split(\"/\");\n\n  // Try progressively shorter paths (walk up the tree)\n  // For 'kb-labs-commit/packages/core/src/index.ts', try:\n  // 1. basePath/kb-labs-commit/packages/core/src\n  // 2. basePath/kb-labs-commit/packages/core\n  // 3. basePath/kb-labs-commit/packages\n  // 4. basePath/kb-labs-commit\n  // 5. basePath (fallback to root)\n\n  for (let i = segments.length - 1; i > 0; i--) {\n    const potentialRepoSegments = segments.slice(0, i);\n    const potentialRepoPath = `${basePath}/${potentialRepoSegments.join(\"/\")}`;\n    const gitDir = `${potentialRepoPath}/.git`;\n\n    if (await existsAsync(gitDir)) {\n      // Found a .git directory - this is the repo root\n      const relativePath = segments.slice(i).join(\"/\");\n      return { repoPath: potentialRepoPath, relativePath };\n    }\n  }\n\n  // No nested repo found, check if basePath itself is a git repo\n  if (await existsAsync(`${basePath}/.git`)) {\n    return { repoPath: basePath, relativePath: filePath };\n  }\n\n  // No git repo found at all\n  return null;\n}\n","/**\n * Commit plan storage in .kb/commit/\n */\n\n/* eslint-disable no-await-in-loop -- Sequential file operations required for plan cleanup and history management */\n\nimport { readFile, writeFile, mkdir, rm, readdir } from 'node:fs/promises';\nimport { join, dirname } from 'node:path';\nimport type { CommitPlan, ApplyResult, GitStatusSnapshot } from '@kb-labs/commit-contracts';\nimport { CommitPlanSchema, GitStatusSnapshotSchema } from '@kb-labs/commit-contracts';\nimport { getFileSummaries } from '../analyzer/file-summary';\n\nconst COMMIT_DIR = '.kb/commit';\nconst PLANS_DIR = 'plans';\nconst CURRENT_DIR = 'current';\nconst HISTORY_DIR = 'history';\nconst PLAN_FILE = 'plan.json';\nconst STATUS_FILE = 'status.json';\nconst RESULT_FILE = 'result.json';\nconst MAX_HISTORY_ENTRIES = 30; // Keep last 30 history entries\n\n/**\n * Normalize scope string for use in file paths\n * @example \"@kb-labs/mind\" -> \"@kb-labs-mind\"\n * @example \"packages/core/**\" -> \"packages-core\"\n */\nfunction normalizeScopeForPath(scope: string): string {\n  return scope\n    .replace(/\\//g, '-')\n    .replace(/\\*/g, '')\n    .replace(/\\./g, '-')\n    .replace(/:/g, '-');\n}\n\n/**\n * Get path to commit storage directory\n */\nexport function getCommitStoragePath(cwd: string): string {\n  return join(cwd, COMMIT_DIR);\n}\n\n/**\n * Get path to scope-specific plan directory\n */\nexport function getScopePlanDir(cwd: string, scope: string = 'root'): string {\n  const scopeDir = normalizeScopeForPath(scope);\n  return join(cwd, COMMIT_DIR, PLANS_DIR, scopeDir);\n}\n\n/**\n * Get path to current plan file for a scope\n */\nexport function getCurrentPlanPath(cwd: string, scope: string = 'root'): string {\n  return join(getScopePlanDir(cwd, scope), CURRENT_DIR, PLAN_FILE);\n}\n\n/**\n * Get path to current status file for a scope\n */\nexport function getCurrentStatusPath(cwd: string, scope: string = 'root'): string {\n  return join(getScopePlanDir(cwd, scope), CURRENT_DIR, STATUS_FILE);\n}\n\n/**\n * Save commit plan to storage\n */\nexport async function savePlan(cwd: string, plan: CommitPlan, scope: string = 'root'): Promise<void> {\n  const planPath = getCurrentPlanPath(cwd, scope);\n  const statusPath = getCurrentStatusPath(cwd, scope);\n\n  // Ensure directory exists\n  await mkdir(dirname(planPath), { recursive: true });\n\n  // Save plan\n  await writeFile(planPath, JSON.stringify(plan, null, 2));\n\n  // Save status snapshot — use git status already captured in the plan\n  const status = plan.gitStatus;\n  const allFiles = [...status.staged, ...status.unstaged, ...status.untracked];\n  const summaries = await getFileSummaries(cwd, allFiles);\n\n  const snapshot: GitStatusSnapshot = {\n    schemaVersion: '1.0',\n    createdAt: new Date().toISOString(),\n    status,\n    summaries,\n  };\n\n  await writeFile(statusPath, JSON.stringify(snapshot, null, 2));\n}\n\n/**\n * Load current commit plan from storage\n */\nexport async function loadPlan(cwd: string, scope: string = 'root'): Promise<CommitPlan | null> {\n  const planPath = getCurrentPlanPath(cwd, scope);\n\n  try {\n    const content = await readFile(planPath, 'utf-8');\n    const data = JSON.parse(content);\n\n    // Validate with schema\n    const result = CommitPlanSchema.safeParse(data);\n    if (!result.success) {\n      console.error(`[loadPlan] Zod validation failed for ${planPath}:`, JSON.stringify(result.error.issues));\n      return null;\n    }\n\n    return result.data;\n  } catch (err) {\n    console.error(`[loadPlan] Failed to read ${planPath}:`, err instanceof Error ? err.message : err);\n    return null;\n  }\n}\n\n/**\n * Load current status snapshot from storage\n */\nexport async function loadStatus(cwd: string, scope: string = 'root'): Promise<GitStatusSnapshot | null> {\n  const statusPath = getCurrentStatusPath(cwd, scope);\n\n  try {\n    const content = await readFile(statusPath, 'utf-8');\n    const data = JSON.parse(content);\n\n    const result = GitStatusSnapshotSchema.safeParse(data);\n    if (!result.success) {\n      return null;\n    }\n\n    return result.data;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Check if a plan exists\n */\nexport async function hasPlan(cwd: string, scope: string = 'root'): Promise<boolean> {\n  const plan = await loadPlan(cwd, scope);\n  return plan !== null;\n}\n\n/**\n * Clear current commit plan\n */\nexport async function clearPlan(cwd: string, scope: string = 'root'): Promise<void> {\n  const currentDir = join(getScopePlanDir(cwd, scope), CURRENT_DIR);\n\n  try {\n    await rm(currentDir, { recursive: true, force: true });\n  } catch {\n    // Ignore errors if directory doesn't exist\n  }\n}\n\n/**\n * Save plan and result to history\n */\nexport async function saveToHistory(\n  cwd: string,\n  plan: CommitPlan,\n  result: ApplyResult,\n  scope: string = 'root'\n): Promise<void> {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\n  const historyDir = join(getScopePlanDir(cwd, scope), HISTORY_DIR, timestamp);\n\n  await mkdir(historyDir, { recursive: true });\n\n  await writeFile(join(historyDir, PLAN_FILE), JSON.stringify(plan, null, 2));\n  await writeFile(join(historyDir, RESULT_FILE), JSON.stringify(result, null, 2));\n\n  // Clean old history entries after saving new one\n  await cleanOldHistory(cwd, scope);\n}\n\n/**\n * List history entries\n */\nexport async function listHistory(\n  cwd: string,\n  scope: string = 'root'\n): Promise<Array<{ timestamp: string; path: string }>> {\n  const historyDir = join(getScopePlanDir(cwd, scope), HISTORY_DIR);\n\n  try {\n    const entries = await readdir(historyDir, { withFileTypes: true });\n\n    return entries\n      .filter((e) => e.isDirectory())\n      .map((e) => ({\n        timestamp: e.name,\n        path: join(historyDir, e.name),\n      }))\n      .sort((a, b) => b.timestamp.localeCompare(a.timestamp)); // Newest first\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Clean old history entries, keeping only the most recent N entries\n */\nexport async function cleanOldHistory(\n  cwd: string,\n  scope: string = 'root',\n  maxEntries: number = MAX_HISTORY_ENTRIES\n): Promise<void> {\n  const entries = await listHistory(cwd, scope);\n\n  // If we have more entries than the limit, delete the oldest ones\n  if (entries.length > maxEntries) {\n    const toDelete = entries.slice(maxEntries); // Keep first N (newest), delete rest\n\n    for (const entry of toDelete) {\n      try {\n        await rm(entry.path, { recursive: true, force: true });\n      } catch {\n        // Ignore errors if directory doesn't exist or can't be deleted\n      }\n    }\n  }\n}\n\n/**\n * Initialize storage directory structure\n */\nexport async function initStorage(cwd: string, scope: string = 'root'): Promise<void> {\n  const dirs = [\n    join(getScopePlanDir(cwd, scope), CURRENT_DIR),\n    join(getScopePlanDir(cwd, scope), HISTORY_DIR),\n  ];\n\n  for (const dir of dirs) {\n    await mkdir(dir, { recursive: true });\n  }\n}\n\n/**\n * List all scopes with plans\n */\nexport async function listScopes(cwd: string): Promise<string[]> {\n  const plansDir = join(cwd, COMMIT_DIR, PLANS_DIR);\n\n  try {\n    const entries = await readdir(plansDir, { withFileTypes: true });\n    return entries\n      .filter((e) => e.isDirectory())\n      .map((e) => e.name);\n  } catch {\n    return [];\n  }\n}\n"]}

package/dist/types-CEjOl41u.d.ts

@@ -0,0 +1,67 @@
+import * as _kb_labs_commit_contracts from '@kb-labs/commit-contracts';
+
+/**
+ * Options for generating a commit plan
+ *
+ * Note: Debug logging and LLM access are handled via SDK hooks (useLogger, useLLM),
+ * which can be called anywhere without passing through arguments.
+ */
+interface GenerateOptions {
+    /** Working directory (repo root) */
+    cwd: string;
+    /** Optional scope pattern to filter files */
+    scope?: string;
+    /** Recent commits for style reference */
+    recentCommits?: string[];
+    /** Plugin configuration (from kb.config.json + env) */
+    config?: _kb_labs_commit_contracts.CommitPluginConfig;
+    /** Progress callback for UI updates (updates spinner text) */
+    onProgress?: (message: string) => void;
+    /** LLM completion function (optional - can be undefined if LLM disabled) */
+    llmComplete?: LLMCompleteFunction;
+    /** Allow committing files with detected secrets (requires manual confirmation) */
+    allowSecrets?: boolean;
+    /** Auto-confirm all prompts (--yes flag for non-interactive mode) */
+    autoConfirm?: boolean;
+}
+/**
+ * Options for applying a commit plan
+ */
+interface ApplyOptions {
+    /** Force apply even if working tree changed */
+    force?: boolean;
+    /** Scope pattern to filter files (e.g., '@kb-labs/workflow', 'packages/core/**') */
+    scope?: string;
+}
+/**
+ * Options for pushing commits
+ */
+interface PushOptions {
+    /** Force push (dangerous!) */
+    force?: boolean;
+    /** Remote name (default: origin) */
+    remote?: string;
+    /** Scope pattern to filter files (e.g., '@kb-labs/workflow', 'packages/core/**') */
+    scope?: string;
+}
+/**
+ * LLM completion function signature
+ */
+type LLMCompleteFunction = (prompt: string, options?: {
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+}) => Promise<{
+    content: string;
+    tokensUsed?: number;
+}>;
+/**
+ * Result of git status check with staleness info
+ */
+interface GitStatusWithStaleness {
+    status: _kb_labs_commit_contracts.GitStatus;
+    summaries: _kb_labs_commit_contracts.FileSummary[];
+    hash: string;
+}
+
+export type { ApplyOptions as A, GenerateOptions as G, LLMCompleteFunction as L, PushOptions as P, GitStatusWithStaleness as a };

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@kb-labs/commit-core",
+  "version": "0.6.0",
+  "type": "module",
+  "description": "Core business logic for KB Labs Commit plugin - git analysis, plan generation, and commit application.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./analyzer": {
+      "import": "./dist/analyzer/index.js",
+      "types": "./dist/analyzer/index.d.ts"
+    },
+    "./generator": {
+      "import": "./dist/generator/index.js",
+      "types": "./dist/generator/index.d.ts"
+    },
+    "./applier": {
+      "import": "./dist/applier/index.js",
+      "types": "./dist/applier/index.d.ts"
+    },
+    "./storage": {
+      "import": "./dist/storage/index.js",
+      "types": "./dist/storage/index.d.ts"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "pretype-check": "pnpm --filter @kb-labs/commit-core build",
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:benchmarks": "vitest run tests/benchmarks/commit-type-accuracy.test.ts",
+    "test:all": "vitest run && vitest run tests/benchmarks/commit-type-accuracy.test.ts"
+  },
+  "dependencies": {
+    "@kb-labs/commit-contracts": "^0.6.0",
+    "@kb-labs/sdk": "^1.5.0",
+    "globby": "^11.0.0",
+    "minimatch": "^10.0.1",
+    "simple-git": "^3.25.0"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../../infra/kb-labs-devkit",
+    "@types/node": "^24.3.3",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}