@kb-labs/release-manager-cli 0.5.0

package/dist/rest/handlers/git-timeline-handler.js

@@ -0,0 +1,209 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import globby from 'globby';
+
+// src/rest/handlers/git-timeline-handler.ts
+async function resolveScopePath(repoRoot, scope) {
+  if (scope === "root") {
+    return repoRoot;
+  }
+  if (scope.startsWith("@")) {
+    const packageJsonPaths = await globby("**/package.json", {
+      cwd: repoRoot,
+      absolute: true,
+      onlyFiles: true,
+      ignore: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**", "**/.*/**"]
+    });
+    for (const pkgJsonPath of packageJsonPaths) {
+      try {
+        const pkg = JSON.parse(await readFile(pkgJsonPath, "utf-8"));
+        if (pkg.name === scope) {
+          return join(pkgJsonPath, "..");
+        }
+      } catch {
+      }
+    }
+  }
+  return join(repoRoot, scope);
+}
+
+// src/rest/handlers/git-timeline-handler.ts
+var git_timeline_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 scopePath = await resolveScopePath(repoRoot, scope);
+    let currentVersion;
+    try {
+      const pkg = JSON.parse(await readFile(join(scopePath, "package.json"), "utf-8"));
+      currentVersion = pkg.version;
+    } catch {
+    }
+    const lastTagResult = await ctx.api.shell.exec(
+      "git",
+      ["describe", "--tags", "--abbrev=0"],
+      { cwd: scopePath }
+    );
+    const lastTag = lastTagResult.code === 0 ? lastTagResult.stdout.trim() : void 0;
+    const gitLogArgs = lastTag ? ["log", `${lastTag}..HEAD`, "--pretty=format:%H|%s|%an|%aI", "--"] : ["log", "--pretty=format:%H|%s|%an|%aI", "--max-count=50", "--"];
+    const logResult = await ctx.api.shell.exec("git", gitLogArgs, { cwd: scopePath });
+    ctx.platform?.logger?.info?.("Git timeline log result", {
+      code: logResult.code,
+      stdout: logResult.stdout?.substring(0, 300),
+      stderr: logResult.stderr?.substring(0, 300),
+      args: gitLogArgs,
+      cwd: scopePath,
+      lastTag
+    });
+    const commits = [];
+    if (logResult.code === 0 && logResult.stdout) {
+      const lines = logResult.stdout.trim().split("\n").filter(Boolean);
+      for (const line of lines) {
+        const [sha, message, author, date] = line.split("|");
+        if (!sha || !message) {
+          continue;
+        }
+        const parsed = parseConventionalCommit(message);
+        commits.push({
+          sha: sha || "",
+          shortSha: sha ? sha.substring(0, 7) : "",
+          message: message || "",
+          type: parsed.type,
+          bump: parsed.bump,
+          scope: parsed.scope,
+          author: author || "Unknown",
+          date: date || (/* @__PURE__ */ new Date()).toISOString()
+        });
+      }
+    }
+    const suggestedBump = calculateSuggestedBump(commits);
+    let suggestedVersion;
+    if (currentVersion && suggestedBump !== "none") {
+      suggestedVersion = bumpVersion(currentVersion, suggestedBump);
+    }
+    return {
+      scope,
+      currentVersion,
+      suggestedVersion,
+      suggestedBump,
+      commits,
+      unreleased: commits.length,
+      lastTag,
+      hasUnreleasedChanges: commits.length > 0
+    };
+  }
+});
+function parseConventionalCommit(message) {
+  if (message.includes("BREAKING CHANGE") || message.includes("!:")) {
+    return { type: "BREAKING", bump: "major" };
+  }
+  const match = message.match(/^(\w+)(?:\(([^)]+)\))?!?:\s*(.+)/);
+  if (!match) {
+    return { type: "unknown", bump: "none" };
+  }
+  const [, type, scope] = match;
+  if (!type) {
+    return { type: "unknown", bump: "none", scope };
+  }
+  let bump = "none";
+  let commitType = "unknown";
+  switch (type.toLowerCase()) {
+    case "feat":
+      commitType = "feat";
+      bump = "minor";
+      break;
+    case "fix":
+      commitType = "fix";
+      bump = "patch";
+      break;
+    case "perf":
+      commitType = "perf";
+      bump = "patch";
+      break;
+    case "chore":
+      commitType = "chore";
+      bump = "none";
+      break;
+    case "docs":
+      commitType = "docs";
+      bump = "none";
+      break;
+    case "refactor":
+      commitType = "refactor";
+      bump = "none";
+      break;
+    case "test":
+      commitType = "test";
+      bump = "none";
+      break;
+    case "style":
+      commitType = "style";
+      bump = "none";
+      break;
+    case "ci":
+      commitType = "ci";
+      bump = "none";
+      break;
+    case "build":
+      commitType = "build";
+      bump = "none";
+      break;
+    case "revert":
+      commitType = "revert";
+      bump = "patch";
+      break;
+    default:
+      commitType = "unknown";
+      bump = "none";
+  }
+  return { type: commitType, bump, scope };
+}
+function calculateSuggestedBump(commits) {
+  if (commits.length === 0) {
+    return "none";
+  }
+  let hasMajor = false;
+  let hasMinor = false;
+  let hasPatch = false;
+  for (const commit of commits) {
+    if (commit.bump === "major") {
+      hasMajor = true;
+    }
+    if (commit.bump === "minor") {
+      hasMinor = true;
+    }
+    if (commit.bump === "patch") {
+      hasPatch = true;
+    }
+  }
+  if (hasMajor) {
+    return "major";
+  }
+  if (hasMinor) {
+    return "minor";
+  }
+  if (hasPatch) {
+    return "patch";
+  }
+  return "none";
+}
+function bumpVersion(version, bump) {
+  const parts = version.split(".").map((v) => parseInt(v, 10));
+  const [major = 0, minor = 0, patch = 0] = parts;
+  switch (bump) {
+    case "major":
+      return `${major + 1}.0.0`;
+    case "minor":
+      return `${major}.${minor + 1}.0`;
+    case "patch":
+      return `${major}.${minor}.${patch + 1}`;
+    default:
+      return version;
+  }
+}
+
+export { git_timeline_handler_default as default };
+//# sourceMappingURL=git-timeline-handler.js.map
+//# sourceMappingURL=git-timeline-handler.js.map

package/dist/rest/handlers/git-timeline-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/git-timeline-handler.ts"],"names":["findRepoRoot","readFile","join"],"mappings":"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","file":"git-timeline-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 * Git Timeline handler - Get git commit history and version preview\n *\n * Analyzes conventional commits since last tag and suggests next version\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type {\n  GitTimelineResponse,\n  GitCommit,\n  GitTimelineInput,\n} from '@kb-labs/release-manager-contracts';\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { resolveScopePath } from '../../shared/utils';\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<GitTimelineInput>): Promise<GitTimelineResponse> {\n    const scope = input.query?.scope || 'root';\n    const cwd = ctx.cwd || process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    // Get scope path using proper package discovery\n    const scopePath = await resolveScopePath(repoRoot, scope);\n\n    // Get current version from package.json\n    let currentVersion: string | undefined;\n    try {\n      const pkg = JSON.parse(await readFile(join(scopePath, 'package.json'), 'utf-8'));\n      currentVersion = pkg.version;\n    } catch {\n      // No version found\n    }\n\n    // Get last git tag\n    const lastTagResult = await ctx.api.shell.exec(\n      'git',\n      ['describe', '--tags', '--abbrev=0'],\n      { cwd: scopePath }\n    );\n    const lastTag = lastTagResult.code === 0 ? lastTagResult.stdout.trim() : undefined;\n\n    // Get commits since last tag (or all commits if no tag)\n    const gitLogArgs = lastTag\n      ? ['log', `${lastTag}..HEAD`, '--pretty=format:%H|%s|%an|%aI', '--']\n      : ['log', '--pretty=format:%H|%s|%an|%aI', '--max-count=50', '--'];\n\n    const logResult = await ctx.api.shell.exec('git', gitLogArgs, { cwd: scopePath });\n\n    ctx.platform?.logger?.info?.('Git timeline log result', {\n      code: logResult.code,\n      stdout: logResult.stdout?.substring(0, 300),\n      stderr: logResult.stderr?.substring(0, 300),\n      args: gitLogArgs,\n      cwd: scopePath,\n      lastTag,\n    });\n\n    // Parse commits\n    const commits: GitCommit[] = [];\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 [sha, message, author, date] = line.split('|');\n        if (!sha || !message) {continue;}\n\n        const parsed = parseConventionalCommit(message);\n\n        commits.push({\n          sha: sha || '',\n          shortSha: sha ? sha.substring(0, 7) : '',\n          message: message || '',\n          type: parsed.type,\n          bump: parsed.bump,\n          scope: parsed.scope,\n          author: author || 'Unknown',\n          date: date || new Date().toISOString(),\n        });\n      }\n    }\n\n    // Calculate suggested bump\n    const suggestedBump = calculateSuggestedBump(commits);\n\n    // Calculate suggested version\n    let suggestedVersion: string | undefined;\n    if (currentVersion && suggestedBump !== 'none') {\n      suggestedVersion = bumpVersion(currentVersion, suggestedBump);\n    }\n\n    return {\n      scope,\n      currentVersion,\n      suggestedVersion,\n      suggestedBump,\n      commits,\n      unreleased: commits.length,\n      lastTag,\n      hasUnreleasedChanges: commits.length > 0,\n    };\n  },\n});\n\n/**\n * Parse conventional commit message\n * Format: type(scope): subject\n * Examples:\n * - feat: add new feature → minor\n * - fix: bug fix → patch\n * - feat!: breaking change → major\n * - BREAKING CHANGE: → major\n */\nfunction parseConventionalCommit(message: string): {\n  type: GitCommit['type'];\n  bump: GitCommit['bump'];\n  scope?: string;\n} {\n  // Check for BREAKING CHANGE\n  if (message.includes('BREAKING CHANGE') || message.includes('!:')) {\n    return { type: 'BREAKING', bump: 'major' };\n  }\n\n  // Parse conventional commit format\n  const match = message.match(/^(\\w+)(?:\\(([^)]+)\\))?!?:\\s*(.+)/);\n\n  if (!match) {\n    return { type: 'unknown', bump: 'none' };\n  }\n\n  const [, type, scope] = match;\n\n  // Type safety: if no type matched, return unknown\n  if (!type) {\n    return { type: 'unknown', bump: 'none', scope };\n  }\n\n  // Map type to bump\n  let bump: GitCommit['bump'] = 'none';\n  let commitType: GitCommit['type'] = 'unknown';\n\n  switch (type.toLowerCase()) {\n    case 'feat':\n      commitType = 'feat';\n      bump = 'minor';\n      break;\n    case 'fix':\n      commitType = 'fix';\n      bump = 'patch';\n      break;\n    case 'perf':\n      commitType = 'perf';\n      bump = 'patch';\n      break;\n    case 'chore':\n      commitType = 'chore';\n      bump = 'none';\n      break;\n    case 'docs':\n      commitType = 'docs';\n      bump = 'none';\n      break;\n    case 'refactor':\n      commitType = 'refactor';\n      bump = 'none';\n      break;\n    case 'test':\n      commitType = 'test';\n      bump = 'none';\n      break;\n    case 'style':\n      commitType = 'style';\n      bump = 'none';\n      break;\n    case 'ci':\n      commitType = 'ci';\n      bump = 'none';\n      break;\n    case 'build':\n      commitType = 'build';\n      bump = 'none';\n      break;\n    case 'revert':\n      commitType = 'revert';\n      bump = 'patch';\n      break;\n    default:\n      commitType = 'unknown';\n      bump = 'none';\n  }\n\n  return { type: commitType, bump, scope };\n}\n\n/**\n * Calculate suggested version bump based on commits\n */\nfunction calculateSuggestedBump(commits: GitCommit[]): 'major' | 'minor' | 'patch' | 'none' {\n  if (commits.length === 0) {return 'none';}\n\n  // Priority: major > minor > patch > none\n  let hasMajor = false;\n  let hasMinor = false;\n  let hasPatch = false;\n\n  for (const commit of commits) {\n    if (commit.bump === 'major') {hasMajor = true;}\n    if (commit.bump === 'minor') {hasMinor = true;}\n    if (commit.bump === 'patch') {hasPatch = true;}\n  }\n\n  if (hasMajor) {return 'major';}\n  if (hasMinor) {return 'minor';}\n  if (hasPatch) {return 'patch';}\n  return 'none';\n}\n\n/**\n * Bump semver version\n */\nfunction bumpVersion(version: string, bump: 'major' | 'minor' | 'patch'): string {\n  const parts = version.split('.').map((v) => parseInt(v, 10));\n  const [major = 0, minor = 0, patch = 0] = parts;\n\n  switch (bump) {\n    case 'major':\n      return `${major + 1}.0.0`;\n    case 'minor':\n      return `${major}.${minor + 1}.0`;\n    case 'patch':\n      return `${major}.${minor}.${patch + 1}`;\n    default:\n      return version;\n  }\n}\n\n"]}

package/dist/rest/handlers/history-changelog-handler.d.ts

@@ -0,0 +1,14 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+interface HistoryChangelogParams {
+    scope: string;
+    id: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, unknown, HistoryChangelogParams>, {
+    markdown: string;
+    id: string;
+    scope: string;
+}>;
+
+export { type HistoryChangelogParams, _default as default };

package/dist/rest/handlers/history-changelog-handler.js

@@ -0,0 +1,34 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+
+// src/rest/handlers/history-changelog-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+
+// src/rest/handlers/history-changelog-handler.ts
+var history_changelog_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const { scope, id } = input.params;
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    const scopeDir = scopeToDir(scope);
+    const changelogPath = join(repoRoot, ".kb/release/history", scopeDir, id, "changelog.md");
+    try {
+      const markdown = await readFile(changelogPath, "utf-8");
+      return {
+        id,
+        markdown,
+        scope
+      };
+    } catch (error) {
+      throw new Error(`Failed to read changelog for ${scope}/${id}: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
+});
+
+export { history_changelog_handler_default as default };
+//# sourceMappingURL=history-changelog-handler.js.map
+//# sourceMappingURL=history-changelog-handler.js.map

package/dist/rest/handlers/history-changelog-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/history-changelog-handler.ts"],"names":["findRepoRoot","join","readFile"],"mappings":";;;;;;AASO,SAAS,WAAW,KAAA,EAAuB;AAChD,EAAA,OAAO,KAAA,CACJ,OAAA,CAAQ,IAAA,EAAM,EAAE,EAChB,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA,CAClB,QAAQ,IAAA,EAAM,GAAG,CAAA,CACjB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACtB;;;ACEA,IAAO,oCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAK,KAAA,EAA+F;AAChH,IAAA,MAAM,EAAE,KAAA,EAAO,EAAA,EAAG,GAAI,KAAA,CAAM,MAAA;AAC5B,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AACnC,IAAA,MAAM,QAAA,GAAW,MAAMA,YAAAA,CAAa,GAAG,CAAA;AAEvC,IAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,IAAA,MAAM,gBAAgBC,IAAAA,CAAK,QAAA,EAAU,qBAAA,EAAuB,QAAA,EAAU,IAAI,cAAc,CAAA;AAExF,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAMC,QAAAA,CAAS,aAAA,EAAe,OAAO,CAAA;AAEtD,MAAA,OAAO;AAAA,QACL,EAAA;AAAA,QACA,QAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,6BAAA,EAAgC,KAAK,CAAA,CAAA,EAAI,EAAE,CAAA,EAAA,EAAK,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,eAAe,CAAA,CAAE,CAAA;AAAA,IAC5H;AAAA,EACF;AACF,CAAC","file":"history-changelog-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 * History changelog handler - Get specific changelog from history\n *\n * Reads: .kb/release/history/{scope}/{id}/changelog.md\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type { HistoryChangelogResponse } from '@kb-labs/release-manager-contracts';\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { scopeToDir } from '../../shared/utils';\n\nexport interface HistoryChangelogParams {\n  scope: string;  // Scope (e.g., \"root\" or \"@kb-labs/shared\")\n  id: string;     // Release ID (folder name like 2026-01-04T12-30-00Z)\n}\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<unknown, unknown, HistoryChangelogParams>): Promise<HistoryChangelogResponse> {\n    const { scope, id } = input.params!;\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    const scopeDir = scopeToDir(scope);\n    const changelogPath = join(repoRoot, '.kb/release/history', scopeDir, id, 'changelog.md');\n\n    try {\n      const markdown = await readFile(changelogPath, 'utf-8');\n\n      return {\n        id,\n        markdown,\n        scope,\n      };\n    } catch (error) {\n      throw new Error(`Failed to read changelog for ${scope}/${id}: ${error instanceof Error ? error.message : 'Unknown error'}`);\n    }\n  }\n});\n"]}

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

@@ -0,0 +1,20 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+interface HistoryInput {
+    scope?: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<HistoryInput, unknown, unknown>, {
+    releases: {
+        id: string;
+        scope: string;
+        packages: string[];
+        success: boolean;
+        stage: "rollback" | "planning" | "checking" | "versioning" | "publishing" | "verifying";
+        timestamp: string;
+        version?: string | undefined;
+        error?: string | undefined;
+    }[];
+}>;
+
+export { type HistoryInput, _default as default };

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

@@ -0,0 +1,75 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { readdir, readFile } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+
+// src/rest/handlers/history-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+function dirToScope(dirName) {
+  if (dirName === "root") {
+    return "root";
+  }
+  const parts = dirName.split("-");
+  if (parts.length >= 2) {
+    return "@" + parts[0] + "-" + parts[1] + "/" + parts.slice(2).join("-");
+  }
+  return dirName;
+}
+
+// src/rest/handlers/history-handler.ts
+var history_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const filterScope = input.query?.scope;
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    const historyDir = join(repoRoot, ".kb/release/history");
+    try {
+      const releases = [];
+      const scopeEntries = await readdir(historyDir, { withFileTypes: true });
+      const scopeFolders = scopeEntries.filter((e) => e.isDirectory());
+      for (const scopeFolder of scopeFolders) {
+        const scopeDirName = scopeFolder.name;
+        const scope = dirToScope(scopeDirName);
+        if (filterScope) {
+          const filterDirName = scopeToDir(filterScope);
+          if (scopeDirName !== filterDirName) {
+            continue;
+          }
+        }
+        const scopeDir = join(historyDir, scopeDirName);
+        const releaseEntries = await readdir(scopeDir, { withFileTypes: true });
+        const releaseFolders = releaseEntries.filter((e) => e.isDirectory());
+        for (const releaseFolder of releaseFolders) {
+          const releaseId = releaseFolder.name;
+          const reportPath = join(scopeDir, releaseId, "report.json");
+          try {
+            const reportRaw = await readFile(reportPath, "utf-8");
+            const report = JSON.parse(reportRaw);
+            releases.push({
+              id: releaseId,
+              timestamp: report.ts,
+              scope: report.scope || scope,
+              version: report.result?.version,
+              packages: report.result?.published || [],
+              success: report.result?.ok || false,
+              stage: report.stage,
+              error: report.result?.errors?.[0]
+            });
+          } catch (error) {
+            continue;
+          }
+        }
+      }
+      releases.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+      return { releases };
+    } catch (error) {
+      return { releases: [] };
+    }
+  }
+});
+
+export { history_handler_default as default };
+//# sourceMappingURL=history-handler.js.map
+//# sourceMappingURL=history-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/history-handler.ts"],"names":["findRepoRoot","join","readFile"],"mappings":"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","file":"history-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 * History handler - List all release history\n *\n * Reads: .kb/release/history/{scope}/{releaseId}/report.json\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type { HistoryResponse, ReleaseHistoryItem } from '@kb-labs/release-manager-contracts';\nimport { readFile, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { dirToScope, scopeToDir } from '../../shared/utils';\n\nexport interface HistoryInput {\n  scope?: string; // Optional scope filter\n}\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<HistoryInput>): Promise<HistoryResponse> {\n    const filterScope = input.query?.scope; // Optional scope filter\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n    const historyDir = join(repoRoot, '.kb/release/history');\n\n    try {\n      const releases: ReleaseHistoryItem[] = [];\n\n      // Read all scope directories\n      const scopeEntries = await readdir(historyDir, { withFileTypes: true });\n      const scopeFolders = scopeEntries.filter((e) => e.isDirectory());\n\n      for (const scopeFolder of scopeFolders) {\n        const scopeDirName = scopeFolder.name; // e.g., 'kb-labs-shared' or 'root'\n        const scope = dirToScope(scopeDirName); // Convert to '@kb-labs/shared' or 'root'\n\n        // If filter provided, skip non-matching scopes\n        if (filterScope) {\n          const filterDirName = scopeToDir(filterScope);\n          if (scopeDirName !== filterDirName) {\n            continue;\n          }\n        }\n\n        const scopeDir = join(historyDir, scopeDirName);\n\n        // Read all release folders within this scope\n        const releaseEntries = await readdir(scopeDir, { withFileTypes: true });\n        const releaseFolders = releaseEntries.filter((e) => e.isDirectory());\n\n        for (const releaseFolder of releaseFolders) {\n          const releaseId = releaseFolder.name;\n          const reportPath = join(scopeDir, releaseId, 'report.json');\n\n          try {\n            const reportRaw = await readFile(reportPath, 'utf-8');\n            const report = JSON.parse(reportRaw);\n\n            releases.push({\n              id: releaseId,\n              timestamp: report.ts,\n              scope: report.scope || scope,\n              version: report.result?.version,\n              packages: report.result?.published || [],\n              success: report.result?.ok || false,\n              stage: report.stage,\n              error: report.result?.errors?.[0],\n            });\n          } catch (error) {\n            // Skip invalid/incomplete releases\n            continue;\n          }\n        }\n      }\n\n      // Sort by timestamp descending (newest first)\n      releases.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());\n\n      return { releases };\n    } catch (error) {\n      // No history directory yet\n      return { releases: [] };\n    }\n  }\n});\n"]}

package/dist/rest/handlers/history-plan-handler.d.ts

@@ -0,0 +1,30 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+interface HistoryPlanParams {
+    scope: string;
+    id: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, unknown, HistoryPlanParams>, {
+    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;
+    };
+    id: string;
+}>;
+
+export { type HistoryPlanParams, _default as default };

package/dist/rest/handlers/history-plan-handler.js

@@ -0,0 +1,34 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+
+// src/rest/handlers/history-plan-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+
+// src/rest/handlers/history-plan-handler.ts
+var history_plan_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const { scope, id } = input.params;
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    const scopeDir = scopeToDir(scope);
+    const planPath = join(repoRoot, ".kb/release/history", scopeDir, id, "plan.json");
+    try {
+      const planRaw = await readFile(planPath, "utf-8");
+      const plan = JSON.parse(planRaw);
+      return {
+        id,
+        plan
+      };
+    } catch (error) {
+      throw new Error(`Failed to read release plan for ${scope}/${id}: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
+});
+
+export { history_plan_handler_default as default };
+//# sourceMappingURL=history-plan-handler.js.map
+//# sourceMappingURL=history-plan-handler.js.map

package/dist/rest/handlers/history-plan-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/history-plan-handler.ts"],"names":["findRepoRoot","join","readFile"],"mappings":";;;;;;AASO,SAAS,WAAW,KAAA,EAAuB;AAChD,EAAA,OAAO,KAAA,CACJ,OAAA,CAAQ,IAAA,EAAM,EAAE,EAChB,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA,CAClB,QAAQ,IAAA,EAAM,GAAG,CAAA,CACjB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACtB;;;ACEA,IAAO,+BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAK,KAAA,EAAqF;AACtG,IAAA,MAAM,EAAE,KAAA,EAAO,EAAA,EAAG,GAAI,KAAA,CAAM,MAAA;AAC5B,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AACnC,IAAA,MAAM,QAAA,GAAW,MAAMA,YAAAA,CAAa,GAAG,CAAA;AAEvC,IAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,IAAA,MAAM,WAAWC,IAAAA,CAAK,QAAA,EAAU,qBAAA,EAAuB,QAAA,EAAU,IAAI,WAAW,CAAA;AAEhF,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,MAAMC,QAAAA,CAAS,QAAA,EAAU,OAAO,CAAA;AAChD,MAAA,MAAM,IAAA,GAAoB,IAAA,CAAK,KAAA,CAAM,OAAO,CAAA;AAE5C,MAAA,OAAO;AAAA,QACL,EAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gCAAA,EAAmC,KAAK,CAAA,CAAA,EAAI,EAAE,CAAA,EAAA,EAAK,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,eAAe,CAAA,CAAE,CAAA;AAAA,IAC/H;AAAA,EACF;AACF,CAAC","file":"history-plan-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 * History plan handler - Get specific release plan from history\n *\n * Reads: .kb/release/history/{scope}/{id}/plan.json\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type { HistoryPlanResponse, ReleasePlan } from '@kb-labs/release-manager-contracts';\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { scopeToDir } from '../../shared/utils';\n\nexport interface HistoryPlanParams {\n  scope: string;  // Scope (e.g., \"root\" or \"@kb-labs/shared\")\n  id: string;     // Release ID (folder name like 2026-01-04T12-30-00Z)\n}\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<unknown, unknown, HistoryPlanParams>): Promise<HistoryPlanResponse> {\n    const { scope, id } = input.params!;\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    const scopeDir = scopeToDir(scope);\n    const planPath = join(repoRoot, '.kb/release/history', scopeDir, id, 'plan.json');\n\n    try {\n      const planRaw = await readFile(planPath, 'utf-8');\n      const plan: ReleasePlan = JSON.parse(planRaw);\n\n      return {\n        id,\n        plan,\n      };\n    } catch (error) {\n      throw new Error(`Failed to read release plan for ${scope}/${id}: ${error instanceof Error ? error.message : 'Unknown error'}`);\n    }\n  }\n});\n"]}

package/dist/rest/handlers/history-report-handler.d.ts

@@ -0,0 +1,64 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+interface HistoryReportParams {
+    scope: string;
+    id: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, unknown, HistoryReportParams>, {
+    report: {
+        scope: string;
+        schemaVersion: "1.0";
+        ts: string;
+        context: {
+            repo: string;
+            cwd: string;
+            branch: string;
+            profile?: string | undefined;
+            dryRun?: boolean | undefined;
+        };
+        stage: "rollback" | "planning" | "checking" | "versioning" | "publishing" | "verifying";
+        result: {
+            ok: boolean;
+            timingMs: number;
+            changelog?: string | undefined;
+            version?: string | undefined;
+            published?: string[] | undefined;
+            skipped?: string[] | undefined;
+            checks?: Record<string, {
+                id: string;
+                ok: boolean;
+                details?: unknown;
+                hint?: string | undefined;
+                timingMs?: number | undefined;
+            }> | undefined;
+            git?: {
+                committed: boolean;
+                tagged: string[];
+                pushed: boolean;
+            } | undefined;
+            errors?: string[] | undefined;
+        };
+        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;
+        } | undefined;
+    };
+    id: string;
+}>;
+
+export { type HistoryReportParams, _default as default };

package/dist/rest/handlers/history-report-handler.js

@@ -0,0 +1,34 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+
+// src/rest/handlers/history-report-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+
+// src/rest/handlers/history-report-handler.ts
+var history_report_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const { scope, id } = input.params;
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    const scopeDir = scopeToDir(scope);
+    const reportPath = join(repoRoot, ".kb/release/history", scopeDir, id, "report.json");
+    try {
+      const reportRaw = await readFile(reportPath, "utf-8");
+      const report = JSON.parse(reportRaw);
+      return {
+        id,
+        report
+      };
+    } catch (error) {
+      throw new Error(`Failed to read release report for ${scope}/${id}: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
+});
+
+export { history_report_handler_default as default };
+//# sourceMappingURL=history-report-handler.js.map
+//# sourceMappingURL=history-report-handler.js.map

package/dist/rest/handlers/history-report-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/history-report-handler.ts"],"names":["findRepoRoot","join","readFile"],"mappings":";;;;;;AASO,SAAS,WAAW,KAAA,EAAuB;AAChD,EAAA,OAAO,KAAA,CACJ,OAAA,CAAQ,IAAA,EAAM,EAAE,EAChB,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA,CAClB,QAAQ,IAAA,EAAM,GAAG,CAAA,CACjB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACtB;;;ACEA,IAAO,iCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAK,KAAA,EAAyF;AAC1G,IAAA,MAAM,EAAE,KAAA,EAAO,EAAA,EAAG,GAAI,KAAA,CAAM,MAAA;AAC5B,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AACnC,IAAA,MAAM,QAAA,GAAW,MAAMA,YAAAA,CAAa,GAAG,CAAA;AAEvC,IAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,IAAA,MAAM,aAAaC,IAAAA,CAAK,QAAA,EAAU,qBAAA,EAAuB,QAAA,EAAU,IAAI,aAAa,CAAA;AAEpF,IAAA,IAAI;AACF,MAAA,MAAM,SAAA,GAAY,MAAMC,QAAAA,CAAS,UAAA,EAAY,OAAO,CAAA;AACpD,MAAA,MAAM,MAAA,GAAwB,IAAA,CAAK,KAAA,CAAM,SAAS,CAAA;AAElD,MAAA,OAAO;AAAA,QACL,EAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,KAAK,CAAA,CAAA,EAAI,EAAE,CAAA,EAAA,EAAK,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,eAAe,CAAA,CAAE,CAAA;AAAA,IACjI;AAAA,EACF;AACF,CAAC","file":"history-report-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 * History report handler - Get specific release report from history\n *\n * Reads: .kb/release/history/{scope}/{id}/report.json\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type { HistoryReportResponse, ReleaseReport } from '@kb-labs/release-manager-contracts';\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { scopeToDir } from '../../shared/utils';\n\nexport interface HistoryReportParams {\n  scope: string;  // Scope (e.g., \"root\" or \"@kb-labs/shared\")\n  id: string;     // Release ID (folder name like 2026-01-04T12-30-00Z)\n}\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<unknown, unknown, HistoryReportParams>): Promise<HistoryReportResponse> {\n    const { scope, id } = input.params!;\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    const scopeDir = scopeToDir(scope);\n    const reportPath = join(repoRoot, '.kb/release/history', scopeDir, id, 'report.json');\n\n    try {\n      const reportRaw = await readFile(reportPath, 'utf-8');\n      const report: ReleaseReport = JSON.parse(reportRaw);\n\n      return {\n        id,\n        report,\n      };\n    } catch (error) {\n      throw new Error(`Failed to read release report for ${scope}/${id}: ${error instanceof Error ? error.message : 'Unknown error'}`);\n    }\n  }\n});\n"]}

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

@@ -0,0 +1,29 @@
+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;
+    hasPlan: boolean;
+    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;
+    } | undefined;
+}>;
+
+export { _default as default };