@kb-labs/release-manager-cli 0.5.0

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

@@ -0,0 +1,155 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { readFile, access, readdir, stat } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+
+// src/rest/handlers/checklist-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+var checklist_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const scope = input.query?.scope || "root";
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    const scopeDir = scopeToDir(scope);
+    const basePath = join(repoRoot, ".kb/release/plans", scopeDir, "current");
+    let planStatus = "pending";
+    let planMessage = "No release plan found";
+    let packagesCount = 0;
+    let bump;
+    let plan;
+    try {
+      const planRaw = await readFile(join(basePath, "plan.json"), "utf-8");
+      const parsedPlan = JSON.parse(planRaw);
+      plan = parsedPlan;
+      packagesCount = parsedPlan.packages.length;
+      bump = parsedPlan.packages[0]?.bump;
+      planStatus = "ready";
+      planMessage = `${packagesCount} package${packagesCount !== 1 ? "s" : ""}, ${bump} bump`;
+    } catch {
+    }
+    let changelogStatus = "pending";
+    let changelogMessage = "Changelog not generated";
+    let commitsCount;
+    try {
+      const changelogPath = join(basePath, "CHANGELOG.md");
+      await access(changelogPath);
+      const changelog = await readFile(changelogPath, "utf-8");
+      const commitMatches = changelog.match(/^- /gm);
+      commitsCount = commitMatches?.length || 0;
+      changelogStatus = "ready";
+      changelogMessage = `${commitsCount} change${commitsCount !== 1 ? "s" : ""} documented`;
+    } catch {
+      if (planStatus === "ready") {
+        changelogMessage = "Generate changelog to continue";
+      }
+    }
+    let buildStatus = "pending";
+    let buildMessage = "Build required";
+    let builtCount = 0;
+    let totalCount = 0;
+    if (plan) {
+      totalCount = plan.packages.length;
+      for (const pkg of plan.packages) {
+        const packagePath = pkg.path.startsWith("/") ? pkg.path : join(repoRoot, pkg.path);
+        try {
+          await access(join(packagePath, "dist"));
+          builtCount++;
+        } catch {
+        }
+      }
+      if (builtCount === totalCount) {
+        buildStatus = "ready";
+        buildMessage = `All ${totalCount} package${totalCount !== 1 ? "s" : ""} built`;
+      } else if (builtCount > 0) {
+        buildStatus = "warning";
+        buildMessage = `${builtCount}/${totalCount} packages built`;
+      } else {
+        buildMessage = `${totalCount} package${totalCount !== 1 ? "s" : ""} need build`;
+      }
+    }
+    let previewStatus = "pending";
+    let previewMessage = "Waiting for build";
+    let filesCount;
+    let totalSize;
+    if (buildStatus === "ready" && plan) {
+      filesCount = 0;
+      totalSize = 0;
+      for (const pkg of plan.packages) {
+        const packagePath = pkg.path.startsWith("/") ? pkg.path : join(repoRoot, pkg.path);
+        try {
+          const distPath = join(packagePath, "dist");
+          const countFiles = async (dir) => {
+            let count = 0;
+            let size = 0;
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+              const fullPath = join(dir, entry.name);
+              if (entry.isDirectory()) {
+                const sub = await countFiles(fullPath);
+                count += sub.count;
+                size += sub.size;
+              } else {
+                count++;
+                const fileStat = await stat(fullPath);
+                size += fileStat.size;
+              }
+            }
+            return { count, size };
+          };
+          const result = await countFiles(distPath);
+          filesCount += result.count;
+          totalSize += result.size;
+        } catch {
+        }
+      }
+      if (filesCount > 0) {
+        previewStatus = "ready";
+        previewMessage = `${filesCount} file${filesCount !== 1 ? "s" : ""} ready to publish`;
+      } else {
+        previewStatus = "warning";
+        previewMessage = "No files found to publish";
+      }
+    }
+    const hasNpmToken = !!(process.env.NPM_TOKEN ?? process.env.NODE_AUTH_TOKEN);
+    const npmStatus = hasNpmToken ? "ready" : "error";
+    const npmMessage = hasNpmToken ? "npm token configured" : "Set NPM_TOKEN (granular access token) in environment";
+    const canPublish = planStatus === "ready" && changelogStatus === "ready" && buildStatus === "ready" && previewStatus === "ready" && npmStatus === "ready";
+    return {
+      scope,
+      plan: {
+        status: planStatus,
+        message: planMessage,
+        packagesCount: packagesCount > 0 ? packagesCount : void 0,
+        bump
+      },
+      changelog: {
+        status: changelogStatus,
+        message: changelogMessage,
+        commitsCount
+      },
+      build: {
+        status: buildStatus,
+        message: buildMessage,
+        builtCount: builtCount > 0 ? builtCount : void 0,
+        totalCount: totalCount > 0 ? totalCount : void 0
+      },
+      preview: {
+        status: previewStatus,
+        message: previewMessage,
+        filesCount,
+        totalSize
+      },
+      npm: {
+        status: npmStatus,
+        message: npmMessage
+      },
+      canPublish
+    };
+  }
+});
+
+export { checklist_handler_default as default };
+//# sourceMappingURL=checklist-handler.js.map
+//# sourceMappingURL=checklist-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/checklist-handler.ts"],"names":["findRepoRoot","join","readFile"],"mappings":"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","file":"checklist-handler.js","sourcesContent":["import { join } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport globby from 'globby';\n\nexport { findRepoRoot } from '@kb-labs/sdk';\n\n/**\n * Converts scope to safe directory name\n */\nexport function scopeToDir(scope: string): string {\n  return scope\n    .replace(/^@/, '')\n    .replace(/\\//g, '-')\n    .replace(/:/g, '-')\n    .replace(/\\*/g, '');\n}\n\n/**\n * Converts safe directory name back to scope\n */\nexport function dirToScope(dirName: string): string {\n  if (dirName === 'root') {\n    return 'root';\n  }\n\n  const parts = dirName.split('-');\n  if (parts.length >= 2) {\n    return '@' + parts[0] + '-' + parts[1] + '/' + parts.slice(2).join('-');\n  }\n\n  return dirName;\n}\n\n/**\n * Resolve scope name to absolute filesystem path.\n * Scans all package.json in repoRoot to find the matching package by name.\n */\nexport async function resolveScopePath(repoRoot: string, scope: string): Promise<string> {\n  if (scope === 'root') {\n    return repoRoot;\n  }\n\n  if (scope.startsWith('@')) {\n    const packageJsonPaths = await globby('**/package.json', {\n      cwd: repoRoot,\n      absolute: true,\n      onlyFiles: true,\n      ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.git/**', '**/.*/**'],\n    });\n\n    for (const pkgJsonPath of packageJsonPaths) {\n      try {\n        const pkg = JSON.parse(await readFile(pkgJsonPath, 'utf-8'));\n        if (pkg.name === scope) {\n          return join(pkgJsonPath, '..');\n        }\n      } catch { /* skip */ }\n    }\n  }\n\n  // Direct path or fallback\n  return join(repoRoot, scope);\n}\n","/**\n * Checklist handler - Get unified release checklist status\n *\n * Returns status of all release steps: plan, changelog, build, preview\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type {\n  ReleaseChecklist,\n  ChecklistItemStatus,\n  ReleasePlan,\n} from '@kb-labs/release-manager-contracts';\nimport { readFile, access, readdir, stat } from 'node:fs/promises';\nimport { scopeToDir } from '../../shared/utils';\nimport { join } from 'node:path';\n\ninterface ChecklistInput {\n  scope?: string;\n}\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<ChecklistInput>): Promise<ReleaseChecklist> {\n    const scope = input.query?.scope || 'root';\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    const scopeDir = scopeToDir(scope);\n    const basePath = join(repoRoot, '.kb/release/plans', scopeDir, 'current');\n\n    // Check plan status\n    let planStatus: ChecklistItemStatus = 'pending';\n    let planMessage = 'No release plan found';\n    let packagesCount = 0;\n    let bump: string | undefined;\n    let plan: ReleasePlan | undefined;\n\n    try {\n      const planRaw = await readFile(join(basePath, 'plan.json'), 'utf-8');\n      const parsedPlan: ReleasePlan = JSON.parse(planRaw);\n      plan = parsedPlan;\n      packagesCount = parsedPlan.packages.length;\n      // Get bump type from first package (simplified)\n      bump = parsedPlan.packages[0]?.bump;\n      planStatus = 'ready';\n      planMessage = `${packagesCount} package${packagesCount !== 1 ? 's' : ''}, ${bump} bump`;\n    } catch {\n      // No plan\n    }\n\n    // Check changelog status\n    let changelogStatus: ChecklistItemStatus = 'pending';\n    let changelogMessage = 'Changelog not generated';\n    let commitsCount: number | undefined;\n\n    try {\n      const changelogPath = join(basePath, 'CHANGELOG.md');\n      await access(changelogPath);\n      const changelog = await readFile(changelogPath, 'utf-8');\n      // Count commits by looking for commit-like patterns\n      const commitMatches = changelog.match(/^- /gm);\n      commitsCount = commitMatches?.length || 0;\n      changelogStatus = 'ready';\n      changelogMessage = `${commitsCount} change${commitsCount !== 1 ? 's' : ''} documented`;\n    } catch {\n      if (planStatus === 'ready') {\n        changelogMessage = 'Generate changelog to continue';\n      }\n    }\n\n    // Check build status\n    let buildStatus: ChecklistItemStatus = 'pending';\n    let buildMessage = 'Build required';\n    let builtCount = 0;\n    let totalCount = 0;\n\n    if (plan) {\n      totalCount = plan.packages.length;\n      for (const pkg of plan.packages) {\n        const packagePath = pkg.path.startsWith('/') ? pkg.path : join(repoRoot, pkg.path);\n        try {\n          await access(join(packagePath, 'dist'));\n          builtCount++;\n        } catch {\n          // Not built\n        }\n      }\n\n      if (builtCount === totalCount) {\n        buildStatus = 'ready';\n        buildMessage = `All ${totalCount} package${totalCount !== 1 ? 's' : ''} built`;\n      } else if (builtCount > 0) {\n        buildStatus = 'warning';\n        buildMessage = `${builtCount}/${totalCount} packages built`;\n      } else {\n        buildMessage = `${totalCount} package${totalCount !== 1 ? 's' : ''} need build`;\n      }\n    }\n\n    // Check preview status\n    let previewStatus: ChecklistItemStatus = 'pending';\n    let previewMessage = 'Waiting for build';\n    let filesCount: number | undefined;\n    let totalSize: number | undefined;\n\n    if (buildStatus === 'ready' && plan) {\n      filesCount = 0;\n      totalSize = 0;\n\n      for (const pkg of plan.packages) {\n        const packagePath = pkg.path.startsWith('/') ? pkg.path : join(repoRoot, pkg.path);\n        try {\n          // Count files in dist folder recursively\n          const distPath = join(packagePath, 'dist');\n          const countFiles = async (dir: string): Promise<{ count: number; size: number }> => {\n            let count = 0;\n            let size = 0;\n            const entries = await readdir(dir, { withFileTypes: true });\n            for (const entry of entries) {\n              const fullPath = join(dir, entry.name);\n              if (entry.isDirectory()) {\n                const sub = await countFiles(fullPath);\n                count += sub.count;\n                size += sub.size;\n              } else {\n                count++;\n                const fileStat = await stat(fullPath);\n                size += fileStat.size;\n              }\n            }\n            return { count, size };\n          };\n          const result = await countFiles(distPath);\n          filesCount += result.count;\n          totalSize += result.size;\n        } catch {\n          // Skip - dist doesn't exist or error reading\n        }\n      }\n\n      if (filesCount > 0) {\n        previewStatus = 'ready';\n        previewMessage = `${filesCount} file${filesCount !== 1 ? 's' : ''} ready to publish`;\n      } else {\n        previewStatus = 'warning';\n        previewMessage = 'No files found to publish';\n      }\n    }\n\n    // Check npm auth token\n    const hasNpmToken = !!(process.env.NPM_TOKEN ?? process.env.NODE_AUTH_TOKEN);\n    const npmStatus: ChecklistItemStatus = hasNpmToken ? 'ready' : 'error';\n    const npmMessage = hasNpmToken\n      ? 'npm token configured'\n      : 'Set NPM_TOKEN (granular access token) in environment';\n\n    // Determine if can publish\n    const canPublish =\n      planStatus === 'ready' &&\n      changelogStatus === 'ready' &&\n      buildStatus === 'ready' &&\n      previewStatus === 'ready' &&\n      npmStatus === 'ready';\n\n    return {\n      scope,\n      plan: {\n        status: planStatus,\n        message: planMessage,\n        packagesCount: packagesCount > 0 ? packagesCount : undefined,\n        bump,\n      },\n      changelog: {\n        status: changelogStatus,\n        message: changelogMessage,\n        commitsCount,\n      },\n      build: {\n        status: buildStatus,\n        message: buildMessage,\n        builtCount: builtCount > 0 ? builtCount : undefined,\n        totalCount: totalCount > 0 ? totalCount : undefined,\n      },\n      preview: {\n        status: previewStatus,\n        message: previewMessage,\n        filesCount,\n        totalSize,\n      },\n      npm: {\n        status: npmStatus,\n        message: npmMessage,\n      },\n      canPublish,\n    };\n  },\n});\n"]}

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

@@ -0,0 +1,35 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, {
+    scope: string;
+    useLLM: boolean;
+    bump?: "patch" | "minor" | "major" | "auto" | undefined;
+    scopePath?: string | undefined;
+    strict?: boolean | undefined;
+}, unknown>, {
+    plan: {
+        scope: string;
+        schemaVersion: "1.0";
+        packages: {
+            name: string;
+            path: string;
+            currentVersion: string;
+            nextVersion: string;
+            bump: "patch" | "minor" | "major" | "auto";
+            isPublished: boolean;
+            dependencies?: string[] | undefined;
+            reason?: string | undefined;
+        }[];
+        strategy: "semver";
+        registry: string;
+        rollbackEnabled: boolean;
+        createdAt: string;
+    };
+    scope: string;
+    planPath: string;
+    tokensUsed?: number | undefined;
+    confidence?: number | undefined;
+}>;
+
+export { _default as default };

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

@@ -0,0 +1,206 @@
+import { defineHandler, findRepoRoot, useConfig } from '@kb-labs/sdk';
+import { RELEASE_CACHE_PREFIX } from '@kb-labs/release-manager-contracts';
+import { planRelease } from '@kb-labs/release-manager-core';
+import 'path';
+import 'fs/promises';
+import 'globby';
+
+// src/rest/handlers/generate-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+
+// src/rest/handlers/generate-handler.ts
+var generate_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const scope = input.body?.scope || "root";
+    const bump = input.body?.bump || "auto";
+    const useLLM = input.body?.useLLM ?? true;
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    ctx.platform?.logger?.info?.("Generating release plan", { scope, bump, useLLM });
+    const releaseConfig = await useConfig();
+    const config = {
+      bump,
+      strategy: "semver",
+      registry: "https://registry.npmjs.org",
+      rollback: { enabled: true },
+      versioningStrategy: releaseConfig?.versioningStrategy,
+      packages: releaseConfig?.packages,
+      scopes: releaseConfig?.scopes,
+      publish: releaseConfig?.publish
+    };
+    const corePlan = await planRelease({
+      cwd: repoRoot,
+      config,
+      scope: scope !== "root" ? scope : void 0,
+      bumpOverride: bump
+    });
+    let tokensUsed = 0;
+    const confidences = [];
+    const enhancedPackages = [];
+    for (const pkg of corePlan.packages) {
+      let reason = "Based on " + pkg.bump + " bump";
+      let pkgConfidence = 0.7;
+      if (useLLM && ctx.platform?.llm) {
+        const gitAnalysis = await analyzeGitCommits(ctx, pkg.path);
+        if (gitAnalysis.commits.length > 0) {
+          const llmResult = await analyzePlanWithLLM(ctx, {
+            packageName: pkg.name,
+            currentVersion: pkg.currentVersion || "0.0.0",
+            nextVersion: pkg.nextVersion || "0.0.1",
+            commits: gitAnalysis.commits,
+            detectedBump: pkg.bump
+          });
+          reason = llmResult.reason;
+          pkgConfidence = llmResult.confidence;
+          tokensUsed += llmResult.tokensUsed;
+        } else {
+          reason = "No unreleased commits detected";
+          pkgConfidence = 0.9;
+        }
+      }
+      enhancedPackages.push({
+        ...pkg,
+        reason
+      });
+      if (pkgConfidence > 0) {
+        confidences.push(pkgConfidence);
+      }
+    }
+    const confidence = confidences.length > 0 ? confidences.reduce((sum, c) => sum + c, 0) / confidences.length : 0;
+    const plan = {
+      schemaVersion: "1.0",
+      scope,
+      packages: enhancedPackages,
+      strategy: corePlan.strategy,
+      registry: corePlan.registry,
+      rollbackEnabled: corePlan.rollbackEnabled,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const scopeDir = scopeToDir(scope);
+    const planDir = repoRoot + "/.kb/release/plans/" + scopeDir + "/current";
+    await ctx.runtime.fs.mkdir(planDir, { recursive: true });
+    const planPath = planDir + "/plan.json";
+    await ctx.runtime.fs.writeFile(planPath, JSON.stringify(plan, null, 2), { encoding: "utf-8" });
+    const cacheKey = RELEASE_CACHE_PREFIX + "plan:" + scope;
+    await ctx.platform?.cache?.delete(cacheKey);
+    await ctx.platform?.analytics?.track?.("release.plan.generated", {
+      scope,
+      packagesCount: plan.packages.length,
+      bump,
+      strategy: plan.strategy,
+      useLLM,
+      tokensUsed,
+      confidence
+    });
+    ctx.platform?.logger?.info?.("Release plan generated", {
+      scope,
+      packagesCount: plan.packages.length,
+      useLLM,
+      tokensUsed,
+      confidence
+    });
+    return {
+      plan,
+      planPath: ".kb/release/plans/" + scopeDir + "/current/plan.json",
+      scope,
+      tokensUsed,
+      confidence
+    };
+  }
+});
+async function analyzeGitCommits(ctx, pkgPath) {
+  try {
+    ctx.platform?.logger?.info?.("Starting git analysis", { pkgPath });
+    const lastTagResult = await ctx.api.shell.exec(
+      "git",
+      ["describe", "--tags", "--abbrev=0"],
+      { cwd: pkgPath }
+    );
+    const lastTag = lastTagResult.code === 0 ? lastTagResult.stdout.trim() : void 0;
+    ctx.platform?.logger?.info?.("Got last tag", { lastTag, code: lastTagResult.code });
+    const gitLogArgs = lastTag ? ["log", lastTag + "..HEAD", "--pretty=format:%H|%s", "--max-count=20"] : ["log", "--pretty=format:%H|%s", "--max-count=20"];
+    ctx.platform?.logger?.info?.("Executing git log", { args: gitLogArgs });
+    const logResult = await ctx.api.shell.exec("git", gitLogArgs, { cwd: pkgPath });
+    ctx.platform?.logger?.info?.("Git log result", {
+      code: logResult.code,
+      stdout: logResult.stdout?.substring(0, 200),
+      stderr: logResult.stderr?.substring(0, 200),
+      args: gitLogArgs,
+      cwd: pkgPath
+    });
+    const commits = [];
+    if (logResult.code === 0 && logResult.stdout) {
+      const lines = logResult.stdout.trim().split("\n").filter(Boolean);
+      for (const line of lines) {
+        const parts = line.split("|");
+        const sha = parts[0];
+        const message = parts[1];
+        if (!sha || !message) {
+          continue;
+        }
+        const parsed = parseConventionalCommit(message);
+        commits.push({
+          sha: sha.substring(0, 7),
+          message,
+          type: parsed.type
+        });
+      }
+    }
+    return { commits };
+  } catch (error) {
+    ctx.platform?.logger?.error?.("Git analysis failed", error instanceof Error ? error : void 0);
+    return { commits: [] };
+  }
+}
+function parseConventionalCommit(message) {
+  if (message.includes("BREAKING CHANGE") || message.includes("!:")) {
+    return { type: "BREAKING" };
+  }
+  const match = message.match(/^(\w+)(?:\([^)]+\))?!?:\s*(.+)/);
+  if (!match) {
+    return { type: "unknown" };
+  }
+  const type = match[1];
+  if (!type) {
+    return { type: "unknown" };
+  }
+  return { type: type.toLowerCase() };
+}
+async function analyzePlanWithLLM(ctx, input) {
+  const { packageName, currentVersion, nextVersion, commits, detectedBump } = input;
+  const commitList = commits.length > 0 ? commits.slice(0, 10).map((c) => "- [" + c.sha + "] " + c.type + ": " + c.message).join("\n") : "(No unreleased commits)";
+  const prompt = "You are analyzing a release plan for a package to provide clear reasoning for the version bump.\n\nPackage: " + packageName + "\nCurrent version: " + currentVersion + "\nNext version: " + nextVersion + "\nDetected bump: " + detectedBump + "\n\nRecent commits:\n" + commitList + '\n\nYour task:\nProvide a clear, concise reason (1-2 sentences) explaining WHY this version bump is appropriate based on the commits.\n\nFocus on:\n- What changed (new features, bug fixes, breaking changes)\n- Why it requires this specific bump type\n\nRespond ONLY with valid JSON in this format:\n{\n  "reason": "Brief explanation (1-2 sentences focusing on what changed)",\n  "confidence": 0.0-1.0\n}';
+  try {
+    const response = await ctx.platform.llm.complete(prompt, {
+      maxTokens: 200,
+      temperature: 0.3
+    });
+    const parsed = JSON.parse(response.content);
+    return {
+      reason: parsed.reason || detectedBump + " bump based on commit analysis",
+      tokensUsed: response.usage.completionTokens + response.usage.promptTokens,
+      confidence: parsed.confidence || 0.7
+    };
+  } catch (error) {
+    ctx.platform?.logger?.error?.(
+      "LLM reasoning failed, using simple explanation",
+      error instanceof Error ? error : void 0
+    );
+    const typeCount = {};
+    commits.forEach((c) => {
+      typeCount[c.type] = (typeCount[c.type] || 0) + 1;
+    });
+    const summary = Object.entries(typeCount).map((entry) => entry[1] + " " + entry[0]).join(", ");
+    return {
+      reason: commits.length > 0 ? "Based on " + commits.length + " commit(s): " + summary : "No unreleased changes",
+      tokensUsed: 0,
+      confidence: 0.6
+    };
+  }
+}
+
+export { generate_handler_default as default };
+//# sourceMappingURL=generate-handler.js.map
+//# sourceMappingURL=generate-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/generate-handler.ts"],"names":["findRepoRoot"],"mappings":"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","file":"generate-handler.js","sourcesContent":["import { join } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport globby from 'globby';\n\nexport { findRepoRoot } from '@kb-labs/sdk';\n\n/**\n * Converts scope to safe directory name\n */\nexport function scopeToDir(scope: string): string {\n  return scope\n    .replace(/^@/, '')\n    .replace(/\\//g, '-')\n    .replace(/:/g, '-')\n    .replace(/\\*/g, '');\n}\n\n/**\n * Converts safe directory name back to scope\n */\nexport function dirToScope(dirName: string): string {\n  if (dirName === 'root') {\n    return 'root';\n  }\n\n  const parts = dirName.split('-');\n  if (parts.length >= 2) {\n    return '@' + parts[0] + '-' + parts[1] + '/' + parts.slice(2).join('-');\n  }\n\n  return dirName;\n}\n\n/**\n * Resolve scope name to absolute filesystem path.\n * Scans all package.json in repoRoot to find the matching package by name.\n */\nexport async function resolveScopePath(repoRoot: string, scope: string): Promise<string> {\n  if (scope === 'root') {\n    return repoRoot;\n  }\n\n  if (scope.startsWith('@')) {\n    const packageJsonPaths = await globby('**/package.json', {\n      cwd: repoRoot,\n      absolute: true,\n      onlyFiles: true,\n      ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.git/**', '**/.*/**'],\n    });\n\n    for (const pkgJsonPath of packageJsonPaths) {\n      try {\n        const pkg = JSON.parse(await readFile(pkgJsonPath, 'utf-8'));\n        if (pkg.name === scope) {\n          return join(pkgJsonPath, '..');\n        }\n      } catch { /* skip */ }\n    }\n  }\n\n  // Direct path or fallback\n  return join(repoRoot, scope);\n}\n","/**\n * Generate release plan handler - Analyze changes and create release plan\n *\n * Writes: .kb/release/plans/{scope}/current/plan.json\n */\n\nimport { defineHandler, findRepoRoot, type RestInput, type PluginContextV3, useConfig } from '@kb-labs/sdk';\nimport type {\n  GeneratePlanRequest,\n  GeneratePlanResponse,\n  ReleasePlan,\n  PackageVersion,\n} from '@kb-labs/release-manager-contracts';\nimport { RELEASE_CACHE_PREFIX } from '@kb-labs/release-manager-contracts';\nimport { planRelease, type ReleaseConfig, type VersionBump } from '@kb-labs/release-manager-core';\nimport { scopeToDir } from '../../shared/utils';\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<unknown, GeneratePlanRequest>): Promise<GeneratePlanResponse> {\n    const scope = input.body?.scope || 'root';\n    const bump = input.body?.bump || 'auto';\n    const useLLM = input.body?.useLLM ?? true;\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    ctx.platform?.logger?.info?.('Generating release plan', { scope, bump, useLLM });\n\n    // Read versioningStrategy from kb.config.json release section\n    const releaseConfig = await useConfig<ReleaseConfig>();\n\n    // Create config for core planner\n    const config: ReleaseConfig = {\n      bump: bump as VersionBump,\n      strategy: 'semver',\n      registry: 'https://registry.npmjs.org',\n      rollback: { enabled: true },\n      versioningStrategy: releaseConfig?.versioningStrategy,\n      packages: releaseConfig?.packages,\n      scopes: releaseConfig?.scopes,\n      publish: releaseConfig?.publish,\n    };\n\n    // Use core planner to discover packages and compute versions.\n    // Always discover from repoRoot; scope is a filter applied inside planner.\n    const corePlan = await planRelease({\n      cwd: repoRoot,\n      config,\n      scope: scope !== 'root' ? scope : undefined,\n      bumpOverride: bump as VersionBump | undefined,\n    });\n\n    let tokensUsed = 0;\n    const confidences: number[] = [];\n\n    // If LLM is enabled, enhance each package with AI reasoning\n    const enhancedPackages: PackageVersion[] = [];\n\n    for (const pkg of corePlan.packages) {\n      let reason = 'Based on ' + pkg.bump + ' bump';\n      let pkgConfidence = 0.7;\n\n      if (useLLM && ctx.platform?.llm) {\n        // Get git commits for this package to provide context to LLM\n        const gitAnalysis = await analyzeGitCommits(ctx, pkg.path);\n\n        if (gitAnalysis.commits.length > 0) {\n          const llmResult = await analyzePlanWithLLM(ctx, {\n            packageName: pkg.name,\n            currentVersion: pkg.currentVersion || '0.0.0',\n            nextVersion: pkg.nextVersion || '0.0.1',\n            commits: gitAnalysis.commits,\n            detectedBump: pkg.bump,\n          });\n\n          reason = llmResult.reason;\n          pkgConfidence = llmResult.confidence;\n          tokensUsed += llmResult.tokensUsed;\n        } else {\n          reason = 'No unreleased commits detected';\n          pkgConfidence = 0.9;\n        }\n      }\n\n      enhancedPackages.push({\n        ...pkg,\n        reason,\n      });\n\n      // Collect confidence scores for averaging\n      if (pkgConfidence > 0) {\n        confidences.push(pkgConfidence);\n      }\n    }\n\n    // Calculate average confidence across all packages\n    const confidence = confidences.length > 0\n      ? confidences.reduce((sum, c) => sum + c, 0) / confidences.length\n      : 0;\n\n    const plan: ReleasePlan = {\n      schemaVersion: '1.0',\n      scope,\n      packages: enhancedPackages,\n      strategy: corePlan.strategy,\n      registry: corePlan.registry,\n      rollbackEnabled: corePlan.rollbackEnabled,\n      createdAt: new Date().toISOString(),\n    };\n\n    // Ensure directory exists\n    const scopeDir = scopeToDir(scope);\n    const planDir = repoRoot + '/.kb/release/plans/' + scopeDir + '/current';\n    await ctx.runtime.fs.mkdir(planDir, { recursive: true });\n\n    // Write plan\n    const planPath = planDir + '/plan.json';\n    await ctx.runtime.fs.writeFile(planPath, JSON.stringify(plan, null, 2), { encoding: 'utf-8' });\n\n    // Invalidate cache\n    const cacheKey = RELEASE_CACHE_PREFIX + 'plan:' + scope;\n    await ctx.platform?.cache?.delete(cacheKey);\n\n    // Track analytics\n    await ctx.platform?.analytics?.track?.('release.plan.generated', {\n      scope,\n      packagesCount: plan.packages.length,\n      bump,\n      strategy: plan.strategy,\n      useLLM,\n      tokensUsed,\n      confidence,\n    });\n\n    ctx.platform?.logger?.info?.('Release plan generated', {\n      scope,\n      packagesCount: plan.packages.length,\n      useLLM,\n      tokensUsed,\n      confidence,\n    });\n\n    return {\n      plan,\n      planPath: '.kb/release/plans/' + scopeDir + '/current/plan.json',\n      scope,\n      tokensUsed,\n      confidence,\n    };\n  }\n});\n\n/**\n * Analyze git commits to get context for package\n */\nasync function analyzeGitCommits(ctx: PluginContextV3, pkgPath: string): Promise<{\n  commits: Array<{ type: string; message: string; sha: string }>;\n}> {\n  try {\n    ctx.platform?.logger?.info?.('Starting git analysis', { pkgPath });\n\n    // Get last git tag\n    const lastTagResult = await ctx.api.shell.exec(\n      'git',\n      ['describe', '--tags', '--abbrev=0'],\n      { cwd: pkgPath }\n    );\n    const lastTag = lastTagResult.code === 0 ? lastTagResult.stdout.trim() : undefined;\n\n    ctx.platform?.logger?.info?.('Got last tag', { lastTag, code: lastTagResult.code });\n\n    // Get commits since last tag\n    const gitLogArgs = lastTag\n      ? ['log', lastTag + '..HEAD', '--pretty=format:%H|%s', '--max-count=20']\n      : ['log', '--pretty=format:%H|%s', '--max-count=20'];\n\n    ctx.platform?.logger?.info?.('Executing git log', { args: gitLogArgs });\n\n    const logResult = await ctx.api.shell.exec('git', gitLogArgs, { cwd: pkgPath });\n\n  ctx.platform?.logger?.info?.('Git log result', {\n    code: logResult.code,\n    stdout: logResult.stdout?.substring(0, 200),\n    stderr: logResult.stderr?.substring(0, 200),\n    args: gitLogArgs,\n    cwd: pkgPath,\n  });\n\n    const commits: Array<{ type: string; message: string; sha: string }> = [];\n    if (logResult.code === 0 && logResult.stdout) {\n      const lines = logResult.stdout.trim().split('\\n').filter(Boolean);\n\n      for (const line of lines) {\n        const parts = line.split('|');\n        const sha = parts[0];\n        const message = parts[1];\n        if (!sha || !message) {continue;}\n\n        const parsed = parseConventionalCommit(message);\n        commits.push({\n          sha: sha.substring(0, 7),\n          message,\n          type: parsed.type,\n        });\n      }\n    }\n\n    return { commits };\n  } catch (error) {\n    ctx.platform?.logger?.error?.('Git analysis failed', error instanceof Error ? error : undefined);\n    return { commits: [] };\n  }\n}\n\n/**\n * Parse conventional commit message\n */\nfunction parseConventionalCommit(message: string): { type: string } {\n  if (message.includes('BREAKING CHANGE') || message.includes('!:')) {\n    return { type: 'BREAKING' };\n  }\n\n  const match = message.match(/^(\\w+)(?:\\([^)]+\\))?!?:\\s*(.+)/);\n  if (!match) {\n    return { type: 'unknown' };\n  }\n\n  const type = match[1];\n  if (!type) {return { type: 'unknown' };}\n\n  return { type: type.toLowerCase() };\n}\n\n/**\n * Analyze plan using LLM to provide reasoning for version bump\n */\nasync function analyzePlanWithLLM(\n  ctx: PluginContextV3,\n  input: {\n    packageName: string;\n    currentVersion: string;\n    nextVersion: string;\n    commits: Array<{ type: string; message: string; sha: string }>;\n    detectedBump: string;\n  }\n): Promise<{ reason: string; tokensUsed: number; confidence: number }> {\n  const { packageName, currentVersion, nextVersion, commits, detectedBump } = input;\n\n  // Build commit list\n  const commitList = commits.length > 0\n    ? commits.slice(0, 10).map(c => '- [' + c.sha + '] ' + c.type + ': ' + c.message).join('\\n')\n    : '(No unreleased commits)';\n\n  const prompt = 'You are analyzing a release plan for a package to provide clear reasoning for the version bump.\\n\\nPackage: ' + packageName + '\\nCurrent version: ' + currentVersion + '\\nNext version: ' + nextVersion + '\\nDetected bump: ' + detectedBump + '\\n\\nRecent commits:\\n' + commitList + '\\n\\nYour task:\\nProvide a clear, concise reason (1-2 sentences) explaining WHY this version bump is appropriate based on the commits.\\n\\nFocus on:\\n- What changed (new features, bug fixes, breaking changes)\\n- Why it requires this specific bump type\\n\\nRespond ONLY with valid JSON in this format:\\n{\\n  \"reason\": \"Brief explanation (1-2 sentences focusing on what changed)\",\\n  \"confidence\": 0.0-1.0\\n}';\n\n  try {\n    const response = await ctx.platform!.llm!.complete(prompt, {\n      maxTokens: 200,\n      temperature: 0.3,\n    });\n\n    const parsed = JSON.parse(response.content);\n\n    return {\n      reason: parsed.reason || detectedBump + ' bump based on commit analysis',\n      tokensUsed: response.usage.completionTokens + response.usage.promptTokens,\n      confidence: parsed.confidence || 0.7,\n    };\n  } catch (error) {\n    ctx.platform?.logger?.error?.(\n      'LLM reasoning failed, using simple explanation',\n      error instanceof Error ? error : undefined\n    );\n\n    // Fallback to simple explanation\n    const typeCount: Record<string, number> = {};\n    commits.forEach(c => {\n      typeCount[c.type] = (typeCount[c.type] || 0) + 1;\n    });\n\n    const summary = Object.entries(typeCount)\n      .map(entry => entry[1] + ' ' + entry[0])\n      .join(', ');\n\n    return {\n      reason: commits.length > 0\n        ? 'Based on ' + commits.length + ' commit(s): ' + summary\n        : 'No unreleased changes',\n      tokensUsed: 0,\n      confidence: 0.6,\n    };\n  }\n}\n"]}

package/dist/rest/handlers/get-checks-handler.d.ts

@@ -0,0 +1,15 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<{
+    scope?: string;
+}, never, unknown>, {
+    scope: string;
+    checks: {
+        id: string;
+        name: string;
+        optional?: boolean | undefined;
+    }[];
+}>;
+
+export { _default as default };

package/dist/rest/handlers/get-checks-handler.js

@@ -0,0 +1,22 @@
+import { defineHandler, useConfig } from '@kb-labs/sdk';
+
+// src/rest/handlers/get-checks-handler.ts
+var get_checks_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const scope = input.query?.scope ?? "root";
+    const config = await useConfig();
+    const checks = config?.scopes?.[scope]?.checks ?? config?.checks ?? [];
+    return {
+      scope,
+      checks: checks.map((c) => ({
+        id: c.id,
+        name: c.name ?? c.id,
+        optional: c.optional
+      }))
+    };
+  }
+});
+
+export { get_checks_handler_default as default };
+//# sourceMappingURL=get-checks-handler.js.map
+//# sourceMappingURL=get-checks-handler.js.map

package/dist/rest/handlers/get-checks-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/get-checks-handler.ts"],"names":[],"mappings":";;;AAWA,IAAO,6BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAK,KAAA,EAAyE;AAC1F,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,EAAO,KAAA,IAAS,MAAA;AAEpC,IAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAyB;AAC9C,IAAA,MAAM,MAAA,GAA8B,QAAQ,MAAA,GAAS,KAAK,GAAG,MAAA,IAAU,MAAA,EAAQ,UAAU,EAAC;AAE1F,IAAA,OAAO;AAAA,MACL,KAAA;AAAA,MACA,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,QACzB,IAAI,CAAA,CAAE,EAAA;AAAA,QACN,IAAA,EAAM,CAAA,CAAE,IAAA,IAAQ,CAAA,CAAE,EAAA;AAAA,QAClB,UAAU,CAAA,CAAE;AAAA,OACd,CAAE;AAAA,KACJ;AAAA,EACF;AACF,CAAC","file":"get-checks-handler.js","sourcesContent":["/**\n * Get configured checks handler\n *\n * Returns the list of checks defined in kb.config.json release.checks\n * without running them. Used by the UI to show what will be checked.\n */\n\nimport { defineHandler, type RestInput, useConfig } from '@kb-labs/sdk';\nimport type { GetChecksResponse } from '@kb-labs/release-manager-contracts';\nimport type { ReleaseConfig, CustomCheckConfig } from '@kb-labs/release-manager-core';\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<{ scope?: string }, never>): Promise<GetChecksResponse> {\n    const scope = input.query?.scope ?? 'root';\n\n    const config = await useConfig<ReleaseConfig>();\n    const checks: CustomCheckConfig[] = config?.scopes?.[scope]?.checks ?? config?.checks ?? [];\n\n    return {\n      scope,\n      checks: checks.map((c) => ({\n        id: c.id,\n        name: c.name ?? c.id,\n        optional: c.optional,\n      })),\n    };\n  },\n});\n"]}

package/dist/rest/handlers/git-timeline-handler.d.ts

@@ -0,0 +1,26 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<{
+    scope: string;
+}, unknown, unknown>, {
+    scope: string;
+    commits: {
+        type: "build" | "unknown" | "feat" | "fix" | "chore" | "docs" | "refactor" | "test" | "style" | "perf" | "ci" | "revert" | "BREAKING";
+        message: string;
+        date: string;
+        bump: "patch" | "minor" | "major" | "none";
+        sha: string;
+        shortSha: string;
+        author: string;
+        scope?: string | undefined;
+    }[];
+    unreleased: number;
+    hasUnreleasedChanges: boolean;
+    currentVersion?: string | undefined;
+    suggestedVersion?: string | undefined;
+    suggestedBump?: "patch" | "minor" | "major" | "none" | undefined;
+    lastTag?: string | undefined;
+}>;
+
+export { _default as default };