@kb-labs/commit-core 2.116.14 → 2.118.0

package/dist/validator/index.d.ts

@@ -0,0 +1,43 @@
+import { CommitPlan } from '@kb-labs/commit-contracts';
+
+/**
+ * Commit plan validation — shared by applier, REST handlers, CLI, and MCP.
+ *
+ * Centralizes checks that used to live only inside apply.ts, so that any
+ * surface (Studio, CLI, MCP) can proactively report plan integrity/staleness
+ * before the user attempts to apply, instead of only failing at apply time.
+ *
+ * @module @kb-labs/commit-core/validator
+ */
+
+/**
+ * Group files by their git repository (root or nested)
+ *
+ * Supports nested git repositories: files with a first path segment that is
+ * itself a git repo root are grouped under that nested repo instead of cwd.
+ */
+declare function groupFilesByRepo(cwd: string, files: string[]): Map<string, {
+    relativePath: string;
+    originalPath: string;
+}[]>;
+/**
+ * Validate internal consistency of a commit plan: every commit has files and
+ * a message, and no file appears in more than one commit.
+ *
+ * Returns an array of human-readable error strings (empty = valid).
+ */
+declare function validatePlanIntegrity(plan: CommitPlan): string[];
+/**
+ * Check if files in the plan have changed since plan generation.
+ *
+ * Only checks files that are part of the plan, ignoring other changes in the
+ * repo — cheap even on a large repo. Used both proactively (status handlers,
+ * before the user attempts Apply) and as the last-second guard inside
+ * applyCommitPlan.
+ */
+declare function checkPlanStaleness(cwd: string, plan: CommitPlan, scope?: string): Promise<{
+    isStale: boolean;
+    reason: string;
+}>;
+
+export { checkPlanStaleness, groupFilesByRepo, validatePlanIntegrity };

package/dist/validator/index.js

@@ -0,0 +1,131 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { useLogger } from '@kb-labs/sdk';
+import { simpleGit } from 'simple-git';
+
+// src/validator/index.ts
+async function getGitStatus(cwd) {
+  const git = simpleGit(cwd);
+  const status = await git.status(["--ignore-submodules=all"]);
+  return {
+    staged: status.staged.filter((f) => !shouldIgnoreFile(f)),
+    unstaged: [...status.modified, ...status.deleted].filter((f) => !status.staged.includes(f)).filter((f) => !shouldIgnoreFile(f)),
+    untracked: status.not_added.filter((f) => !shouldIgnoreFile(f))
+  };
+}
+var IGNORED_SEGMENTS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  ".next",
+  ".turbo",
+  "coverage"
+]);
+function shouldIgnoreFile(file) {
+  return file.split("/").some((segment) => IGNORED_SEGMENTS.has(segment));
+}
+function getAllChangedFiles(status) {
+  const allFiles = [
+    .../* @__PURE__ */ new Set([...status.staged, ...status.unstaged, ...status.untracked])
+  ];
+  return allFiles.filter((file) => !shouldIgnoreFile(file));
+}
+
+// src/validator/index.ts
+function groupFilesByRepo(cwd, files) {
+  const filesByRepo = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const segments = file.split("/");
+    const potentialRepoDir = segments[0];
+    if (!potentialRepoDir) {
+      const group = filesByRepo.get(cwd) ?? [];
+      group.push({ relativePath: file, originalPath: file });
+      filesByRepo.set(cwd, group);
+      continue;
+    }
+    const potentialRepoPath = join(cwd, potentialRepoDir);
+    const potentialGitDir = join(potentialRepoPath, ".git");
+    const isNestedRepo = existsSync(potentialGitDir);
+    if (isNestedRepo) {
+      const relativePath = segments.slice(1).join("/");
+      const group = filesByRepo.get(potentialRepoPath) ?? [];
+      group.push({ relativePath, originalPath: file });
+      filesByRepo.set(potentialRepoPath, group);
+    } else {
+      const group = filesByRepo.get(cwd) ?? [];
+      group.push({ relativePath: file, originalPath: file });
+      filesByRepo.set(cwd, group);
+    }
+  }
+  return filesByRepo;
+}
+function validatePlanIntegrity(plan) {
+  const errors = [];
+  const seenInCommit = /* @__PURE__ */ new Map();
+  for (const commit of plan.commits) {
+    if (commit.files.length === 0) {
+      errors.push(`Commit ${commit.id} has no files`);
+      continue;
+    }
+    if (!commit.message.trim()) {
+      errors.push(`Commit ${commit.id} has empty message`);
+      continue;
+    }
+    for (const file of commit.files) {
+      const firstCommit = seenInCommit.get(file);
+      if (firstCommit) {
+        errors.push(
+          `File appears in multiple commits: ${file} (first: ${firstCommit}, duplicate: ${commit.id})`
+        );
+      } else {
+        seenInCommit.set(file, commit.id);
+      }
+    }
+  }
+  return errors;
+}
+async function checkPlanStaleness(cwd, plan, scope) {
+  const logger = useLogger();
+  const planFiles = new Set(plan.commits.flatMap((c) => c.files));
+  await logger.debug("checkPlanStaleness: start", {
+    scope,
+    cwd,
+    planFiles: [...planFiles]
+  });
+  if (planFiles.size === 0) {
+    return { isStale: false, reason: "" };
+  }
+  const filesByRepo = groupFilesByRepo(cwd, [...planFiles]);
+  for (const [repoPath, fileInfos] of filesByRepo) {
+    const currentStatus = await getGitStatus(repoPath);
+    const currentFiles = new Set(getAllChangedFiles(currentStatus));
+    await logger.debug("checkPlanStaleness: repo status", {
+      repoPath,
+      staged: currentStatus.staged,
+      unstaged: currentStatus.unstaged,
+      untracked: currentStatus.untracked,
+      expected: fileInfos.map((f) => f.relativePath)
+    });
+    for (const { relativePath, originalPath } of fileInfos) {
+      if (!currentFiles.has(relativePath)) {
+        await logger.warn("checkPlanStaleness: file not in current changes", {
+          scope,
+          repoPath,
+          originalPath,
+          relativePath,
+          currentFiles: [...currentFiles]
+        });
+        return {
+          isStale: true,
+          reason: `File no longer has changes: ${originalPath}. Regenerate plan or use --force.`
+        };
+      }
+    }
+  }
+  return { isStale: false, reason: "" };
+}
+
+export { checkPlanStaleness, groupFilesByRepo, validatePlanIntegrity };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/analyzer/git-status.ts","../../src/validator/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Git status analysis\n */\n\nimport { simpleGit, type SimpleGit, type StatusResult } from \"simple-git\";\nimport type { GitStatus } from \"@kb-labs/commit-contracts\";\n\n/**\n * Get current git status (staged, unstaged, untracked files).\n * cwd must already point to the resolved scope directory.\n */\nexport async function getGitStatus(cwd: string): Promise<GitStatus> {\n  // --ignore-submodules=all: exclude submodule pointer drift in worktrees\n  const git: SimpleGit = simpleGit(cwd);\n  const status: StatusResult = await git.status(['--ignore-submodules=all']);\n\n  return {\n    staged: status.staged.filter((f) => !shouldIgnoreFile(f)),\n    unstaged: [...status.modified, ...status.deleted]\n      .filter((f) => !status.staged.includes(f))\n      .filter((f) => !shouldIgnoreFile(f)),\n    untracked: status.not_added.filter((f) => !shouldIgnoreFile(f)),\n  };\n}\n\nconst IGNORED_SEGMENTS = new Set([\n  \"node_modules\",\n  \".git\",\n  \"dist\",\n  \"build\",\n  \".next\",\n  \".turbo\",\n  \"coverage\",\n]);\n\n/**\n * Check if file should be ignored (node_modules, dist, etc.)\n * Uses exact path segment matching to avoid false positives like \"my-dist/file.ts\".\n */\nfunction shouldIgnoreFile(file: string): boolean {\n  return file.split(\"/\").some((segment) => IGNORED_SEGMENTS.has(segment));\n}\n\n/**\n * Get all changed files (staged + unstaged + untracked)\n * Filters out node_modules and other build artifacts\n */\nexport function getAllChangedFiles(status: GitStatus): string[] {\n  const allFiles = [\n    ...new Set([...status.staged, ...status.unstaged, ...status.untracked]),\n  ];\n  return allFiles.filter((file) => !shouldIgnoreFile(file));\n}\n\n/**\n * Check if there are any changes\n */\nexport function hasChanges(status: GitStatus): boolean {\n  return (\n    status.staged.length > 0 ||\n    status.unstaged.length > 0 ||\n    status.untracked.length > 0\n  );\n}\n\n/**\n * Get current branch name\n */\nexport async function getCurrentBranch(cwd: string): Promise<string> {\n  const git: SimpleGit = simpleGit(cwd);\n  const branch = await git.revparse([\"--abbrev-ref\", \"HEAD\"]);\n  return branch.trim();\n}\n\n/**\n * Check if branch is protected (main/master)\n */\nexport function isProtectedBranch(branch: string): boolean {\n  const protectedBranches = [\n    \"main\",\n    \"master\",\n    \"develop\",\n    \"release\",\n    \"production\",\n  ];\n  return protectedBranches.includes(branch.toLowerCase());\n}\n","/**\n * Commit plan validation — shared by applier, REST handlers, CLI, and MCP.\n *\n * Centralizes checks that used to live only inside apply.ts, so that any\n * surface (Studio, CLI, MCP) can proactively report plan integrity/staleness\n * before the user attempts to apply, instead of only failing at apply time.\n *\n * @module @kb-labs/commit-core/validator\n */\n\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { CommitPlan } from \"@kb-labs/commit-contracts\";\nimport { useLogger } from \"@kb-labs/sdk\";\nimport { getGitStatus, getAllChangedFiles } from \"../analyzer/git-status\";\n\n/**\n * Group files by their git repository (root or nested)\n *\n * Supports nested git repositories: files with a first path segment that is\n * itself a git repo root are grouped under that nested repo instead of cwd.\n */\nexport function groupFilesByRepo(\n  cwd: string,\n  files: string[],\n): Map<string, { relativePath: string; originalPath: string }[]> {\n  const filesByRepo = new Map<\n    string,\n    { relativePath: string; originalPath: string }[]\n  >();\n\n  for (const file of files) {\n    // Check if file is in a nested repo (first segment might be a git repo)\n    const segments = file.split(\"/\");\n    const potentialRepoDir = segments[0];\n\n    // Handle edge case: empty file path or no segments\n    if (!potentialRepoDir) {\n      const group = filesByRepo.get(cwd) ?? [];\n      group.push({ relativePath: file, originalPath: file });\n      filesByRepo.set(cwd, group);\n      continue;\n    }\n\n    const potentialRepoPath = join(cwd, potentialRepoDir);\n    const potentialGitDir = join(potentialRepoPath, \".git\");\n\n    // Check if it's actually a nested git repo\n    const isNestedRepo = existsSync(potentialGitDir);\n\n    if (isNestedRepo) {\n      // Use nested repo as git root, strip first segment from path\n      const relativePath = segments.slice(1).join(\"/\");\n      const group = filesByRepo.get(potentialRepoPath) ?? [];\n      group.push({ relativePath, originalPath: file });\n      filesByRepo.set(potentialRepoPath, group);\n    } else {\n      // Use cwd as git root\n      const group = filesByRepo.get(cwd) ?? [];\n      group.push({ relativePath: file, originalPath: file });\n      filesByRepo.set(cwd, group);\n    }\n  }\n\n  return filesByRepo;\n}\n\n/**\n * Validate internal consistency of a commit plan: every commit has files and\n * a message, and no file appears in more than one commit.\n *\n * Returns an array of human-readable error strings (empty = valid).\n */\nexport function validatePlanIntegrity(plan: CommitPlan): string[] {\n  const errors: string[] = [];\n  const seenInCommit = new Map<string, string>();\n\n  for (const commit of plan.commits) {\n    if (commit.files.length === 0) {\n      errors.push(`Commit ${commit.id} has no files`);\n      continue;\n    }\n\n    if (!commit.message.trim()) {\n      errors.push(`Commit ${commit.id} has empty message`);\n      continue;\n    }\n\n    for (const file of commit.files) {\n      const firstCommit = seenInCommit.get(file);\n      if (firstCommit) {\n        errors.push(\n          `File appears in multiple commits: ${file} (first: ${firstCommit}, duplicate: ${commit.id})`,\n        );\n      } else {\n        seenInCommit.set(file, commit.id);\n      }\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Check if files in the plan have changed since plan generation.\n *\n * Only checks files that are part of the plan, ignoring other changes in the\n * repo — cheap even on a large repo. Used both proactively (status handlers,\n * before the user attempts Apply) and as the last-second guard inside\n * applyCommitPlan.\n */\nexport async function checkPlanStaleness(\n  cwd: string,\n  plan: CommitPlan,\n  scope?: string,\n): Promise<{ isStale: boolean; reason: string }> {\n  const logger = useLogger();\n  const planFiles = new Set(plan.commits.flatMap((c) => c.files));\n\n  await logger.debug(\"checkPlanStaleness: start\", {\n    scope,\n    cwd,\n    planFiles: [...planFiles],\n  });\n\n  // If no files in plan, nothing to check\n  if (planFiles.size === 0) {\n    return { isStale: false, reason: \"\" };\n  }\n\n  // Determine which repo(s) we need to check\n  const filesByRepo = groupFilesByRepo(cwd, [...planFiles]);\n\n  // Check each repo for staleness\n  for (const [repoPath, fileInfos] of filesByRepo) {\n    // Get current git status from the repo\n    // Note: repoPath already points to the correct git repository root\n    const currentStatus = await getGitStatus(repoPath);\n    const currentFiles = new Set(getAllChangedFiles(currentStatus));\n\n    await logger.debug(\"checkPlanStaleness: repo status\", {\n      repoPath,\n      staged: currentStatus.staged,\n      unstaged: currentStatus.unstaged,\n      untracked: currentStatus.untracked,\n      expected: fileInfos.map((f) => f.relativePath),\n    });\n\n    // Check that all expected files are still changed\n    for (const { relativePath, originalPath } of fileInfos) {\n      if (!currentFiles.has(relativePath)) {\n        await logger.warn(\"checkPlanStaleness: file not in current changes\", {\n          scope,\n          repoPath,\n          originalPath,\n          relativePath,\n          currentFiles: [...currentFiles],\n        });\n        return {\n          isStale: true,\n          reason: `File no longer has changes: ${originalPath}. Regenerate plan or use --force.`,\n        };\n      }\n    }\n  }\n\n  return { isStale: false, reason: \"\" };\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kb-labs/commit-core",
   "description": "Core business logic for KB Labs Commit plugin - git analysis, plan generation, and commit application.",
-  "version": "2.116.14",
+  "version": "2.118.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,6 +26,10 @@
       "types": "./dist/storage/index.d.ts",
       "import": "./dist/storage/index.js"
     },
+    "./validator": {
+      "types": "./dist/validator/index.d.ts",
+      "import": "./dist/validator/index.js"
+    },
     "./dist/*": "./dist/*"
   },
   "files": [
@@ -37,8 +41,8 @@
     "globby": "^11.0.0",
     "minimatch": "^10.0.1",
     "simple-git": "^3.36.0",
-    "@kb-labs/commit-contracts": "2.116.14",
-    "@kb-labs/sdk": "2.115.1"
+    "@kb-labs/commit-contracts": "2.118.0",
+    "@kb-labs/sdk": "2.115.3"
   },
   "devDependencies": {
     "@types/node": "^24.3.3",
@@ -46,7 +50,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.6.3",
     "vitest": "^3.2.6",
-    "@kb-labs/devkit": "2.116.14"
+    "@kb-labs/devkit": "2.118.0"
   },
   "engines": {
     "node": ">=22.0.0",