@kb-labs/release-manager-cli 0.5.0

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

@@ -0,0 +1,75 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { RELEASE_CACHE_PREFIX } from '@kb-labs/release-manager-contracts';
+import 'path';
+import 'fs/promises';
+import 'globby';
+
+// src/rest/handlers/plan-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+
+// src/rest/handlers/plan-handler.ts
+var CACHE_TTL_MS = 15e3;
+var plan_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const scope = input.query?.scope || "root";
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    ctx.platform?.logger?.info?.("Plan handler called", { scope, query: input.query });
+    const scopeDirName = scopeToDir(scope);
+    const planPath = `${repoRoot}/.kb/release/plans/${scopeDirName}/current/plan.json`;
+    const cacheKey = `${RELEASE_CACHE_PREFIX}plan:${scope}`;
+    const cached = await ctx.platform?.cache?.get(cacheKey);
+    if (cached !== void 0 && cached !== null) {
+      ctx.platform?.logger?.info?.("Returning cached plan response", {
+        scope,
+        hasPlan: cached.hasPlan,
+        fromCache: true
+      });
+      return cached;
+    }
+    let raw;
+    try {
+      raw = await ctx.runtime.fs.readFile(planPath, "utf-8");
+    } catch (error) {
+      ctx.platform?.logger?.info?.("No plan found for scope", {
+        scope,
+        planPath,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      const response = {
+        hasPlan: false,
+        scope
+      };
+      await ctx.platform?.cache?.set(cacheKey, response, 5e3);
+      return response;
+    }
+    try {
+      const plan = JSON.parse(raw);
+      const response = {
+        hasPlan: true,
+        plan,
+        scope
+      };
+      ctx.platform?.logger?.info?.("Plan loaded successfully", { scope, hasPlan: true });
+      await ctx.platform?.cache?.set(cacheKey, response, CACHE_TTL_MS);
+      return response;
+    } catch (error) {
+      ctx.platform?.logger?.error?.(
+        "Failed to parse release plan",
+        error instanceof Error ? error : void 0,
+        { scope }
+      );
+      const response = {
+        hasPlan: false,
+        scope
+      };
+      return response;
+    }
+  }
+});
+
+export { plan_handler_default as default };
+//# sourceMappingURL=plan-handler.js.map
+//# sourceMappingURL=plan-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/plan-handler.ts"],"names":["findRepoRoot"],"mappings":"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","file":"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 * Plan handler - Get current release plan for a scope\n *\n * Reads: .kb/release/plans/{scope}/current/plan.json\n * Cache: 15s TTL to avoid repeated file reads\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type { PlanResponse, ReleasePlan, PlanInput } from '@kb-labs/release-manager-contracts';\nimport { RELEASE_CACHE_PREFIX } from '@kb-labs/release-manager-contracts';\nimport { scopeToDir } from '../../shared/utils';\n\nconst CACHE_TTL_MS = 15000; // 15 seconds\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<PlanInput>): Promise<PlanResponse> {\n    const scope = input.query?.scope || 'root';\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    ctx.platform?.logger?.info?.('Plan handler called', { scope, query: input.query });\n\n    const scopeDirName = scopeToDir(scope);\n    const planPath = `${repoRoot}/.kb/release/plans/${scopeDirName}/current/plan.json`;\n    const cacheKey = `${RELEASE_CACHE_PREFIX}plan:${scope}`;\n\n    // Try cache first\n    const cached = await ctx.platform?.cache?.get(cacheKey);\n    if (cached !== undefined && cached !== null) {\n      ctx.platform?.logger?.info?.('Returning cached plan response', {\n        scope,\n        hasPlan: (cached as PlanResponse).hasPlan,\n        fromCache: true\n      });\n      return cached as PlanResponse;\n    }\n\n    // Cache miss - read from file\n    let raw: string;\n    try {\n      raw = await ctx.runtime.fs.readFile(planPath, 'utf-8');\n    } catch (error) {\n      // No plan found for this scope\n      ctx.platform?.logger?.info?.('No plan found for scope', {\n        scope,\n        planPath,\n        error: error instanceof Error ? error.message : 'Unknown error'\n      });\n\n      const response: PlanResponse = {\n        hasPlan: false,\n        scope,\n      };\n      // Cache negative result too (shorter TTL)\n      await ctx.platform?.cache?.set(cacheKey, response, 5000); // 5s for \"not found\"\n      return response;\n    }\n\n    try {\n      const plan: ReleasePlan = JSON.parse(raw);\n      const response: PlanResponse = {\n        hasPlan: true,\n        plan,\n        scope,\n      };\n\n      ctx.platform?.logger?.info?.('Plan loaded successfully', { scope, hasPlan: true });\n\n      // Cache successful result\n      await ctx.platform?.cache?.set(cacheKey, response, CACHE_TTL_MS);\n      return response;\n    } catch (error) {\n      ctx.platform?.logger?.error?.(\n        'Failed to parse release plan',\n        error instanceof Error ? error : undefined,\n        { scope }\n      );\n\n      const response: PlanResponse = {\n        hasPlan: false,\n        scope,\n      };\n      return response;\n    }\n  }\n});\n"]}

package/dist/rest/handlers/preview-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;
+    packages: {
+        name: string;
+        path: string;
+        version: string;
+        buildStatus: "ready" | "not_built" | "outdated" | "building";
+        files: {
+            path: string;
+            size: number;
+        }[];
+        totalSize: number;
+        fileCount: number;
+        expectedFiles?: string[] | undefined;
+    }[];
+    totalSize: number;
+    totalFiles: number;
+    allBuilt: boolean;
+}>;
+
+export { _default as default };

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

@@ -0,0 +1,127 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { readFile, stat, access } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+import packlist from 'npm-packlist';
+
+// src/rest/handlers/preview-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+async function checkBuildStatus(packagePath) {
+  const distPath = join(packagePath, "dist");
+  try {
+    await access(distPath);
+    return "ready";
+  } catch {
+    return "not_built";
+  }
+}
+async function getExpectedFiles(packagePath) {
+  try {
+    const pkgJsonPath = join(packagePath, "package.json");
+    const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf-8"));
+    return pkgJson.files || [];
+  } catch {
+    return [];
+  }
+}
+var preview_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 planPath = join(repoRoot, ".kb/release/plans", scopeDir, "current", "plan.json");
+    let plan;
+    try {
+      const planRaw = await readFile(planPath, "utf-8");
+      plan = JSON.parse(planRaw);
+    } catch {
+      return {
+        scope,
+        packages: [],
+        totalSize: 0,
+        totalFiles: 0,
+        allBuilt: false
+      };
+    }
+    const packages = [];
+    let totalSize = 0;
+    let totalFiles = 0;
+    let allBuilt = true;
+    for (const pkg of plan.packages) {
+      const packagePath = pkg.path.startsWith("/") ? pkg.path : join(repoRoot, pkg.path);
+      const buildStatus = await checkBuildStatus(packagePath);
+      if (buildStatus !== "ready") {
+        allBuilt = false;
+      }
+      const expectedFiles = await getExpectedFiles(packagePath);
+      try {
+        const pkgJsonPath = join(packagePath, "package.json");
+        const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf-8"));
+        const tree = {
+          path: packagePath,
+          isProjectRoot: true,
+          package: {
+            ...pkgJson,
+            bundleDependencies: pkgJson.bundleDependencies || []
+          }
+        };
+        const files = await packlist(tree);
+        const filesWithSize = await Promise.all(
+          files.map(async (filePath) => {
+            try {
+              const fullPath = join(packagePath, filePath);
+              const stats = await stat(fullPath);
+              return {
+                path: filePath,
+                size: stats.size
+              };
+            } catch {
+              return {
+                path: filePath,
+                size: 0
+              };
+            }
+          })
+        );
+        const packageTotalSize = filesWithSize.reduce((sum, f) => sum + f.size, 0);
+        packages.push({
+          name: pkg.name,
+          version: pkg.nextVersion,
+          path: pkg.path,
+          buildStatus,
+          files: filesWithSize,
+          expectedFiles: expectedFiles.length > 0 ? expectedFiles : void 0,
+          totalSize: packageTotalSize,
+          fileCount: files.length
+        });
+        totalSize += packageTotalSize;
+        totalFiles += files.length;
+      } catch {
+        packages.push({
+          name: pkg.name,
+          version: pkg.nextVersion,
+          path: pkg.path,
+          buildStatus,
+          files: [],
+          expectedFiles: expectedFiles.length > 0 ? expectedFiles : void 0,
+          totalSize: 0,
+          fileCount: 0
+        });
+      }
+    }
+    return {
+      scope,
+      packages,
+      totalSize,
+      totalFiles,
+      allBuilt
+    };
+  }
+});
+
+export { preview_handler_default as default };
+//# sourceMappingURL=preview-handler.js.map
+//# sourceMappingURL=preview-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/preview-handler.ts"],"names":["join","readFile","findRepoRoot"],"mappings":"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","file":"preview-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 * Preview handler - Get list of files that will be published for each package\n *\n * Uses npm-packlist to determine what files will be included in the tarball\n * Also checks build status (dist/ folder existence)\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type {\n  PreviewInput,\n  PreviewResponse,\n  PackagePreview,\n  PackageFile,\n  ReleasePlan,\n  BuildStatus,\n} from '@kb-labs/release-manager-contracts';\nimport { readFile, stat, access } from 'node:fs/promises';\nimport { scopeToDir } from '../../shared/utils';\nimport { join } from 'node:path';\nimport packlist from 'npm-packlist';\n\n/**\n * Check if dist folder exists and determine build status\n */\nasync function checkBuildStatus(packagePath: string): Promise<BuildStatus> {\n  const distPath = join(packagePath, 'dist');\n  try {\n    await access(distPath);\n    // TODO: Could check if dist is older than src for 'outdated' status\n    return 'ready';\n  } catch {\n    return 'not_built';\n  }\n}\n\n/**\n * Read expected files from package.json \"files\" field\n */\nasync function getExpectedFiles(packagePath: string): Promise<string[]> {\n  try {\n    const pkgJsonPath = join(packagePath, 'package.json');\n    const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf-8'));\n    return pkgJson.files || [];\n  } catch {\n    return [];\n  }\n}\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<PreviewInput>): Promise<PreviewResponse> {\n    const scope = input.query?.scope || 'root';\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    // Read plan to get packages\n    const scopeDir = scopeToDir(scope);\n    const planPath = join(repoRoot, '.kb/release/plans', scopeDir, 'current', 'plan.json');\n\n    let plan: ReleasePlan;\n    try {\n      const planRaw = await readFile(planPath, 'utf-8');\n      plan = JSON.parse(planRaw);\n    } catch {\n      return {\n        scope,\n        packages: [],\n        totalSize: 0,\n        totalFiles: 0,\n        allBuilt: false,\n      };\n    }\n\n    const packages: PackagePreview[] = [];\n    let totalSize = 0;\n    let totalFiles = 0;\n    let allBuilt = true;\n\n    for (const pkg of plan.packages) {\n      // pkg.path can be absolute or relative\n      const packagePath = pkg.path.startsWith('/') ? pkg.path : join(repoRoot, pkg.path);\n\n      // Check build status\n      const buildStatus = await checkBuildStatus(packagePath);\n      if (buildStatus !== 'ready') {\n        allBuilt = false;\n      }\n\n      // Get expected files from package.json\n      const expectedFiles = await getExpectedFiles(packagePath);\n\n      try {\n        // Read package.json to create tree object for npm-packlist v10+\n        const pkgJsonPath = join(packagePath, 'package.json');\n        const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf-8'));\n\n        // npm-packlist v10+ requires a tree-like arborist node with:\n        // - path: package path\n        // - package: package.json content (must have bundleDependencies if not isProjectRoot)\n        // - isProjectRoot: true to use bundleDependencies instead of all deps\n        // - edgesOut: Map of dependency edges (not needed if bundleDependencies is empty)\n        // npm-packlist v10+ reads tree.path and tree.package at runtime.\n        // @types/npm-packlist expects an arborist Node, but a plain object works fine —\n        // cast to avoid the type mismatch without installing the full @npmcli/arborist types.\n        const tree = {\n          path: packagePath,\n          isProjectRoot: true,\n          package: {\n            ...pkgJson,\n            bundleDependencies: pkgJson.bundleDependencies || [],\n          },\n        } as Parameters<typeof packlist>[0];\n        const files = await packlist(tree);\n\n        // Get file sizes\n        const filesWithSize: PackageFile[] = await Promise.all(\n          files.map(async (filePath: string): Promise<PackageFile> => {\n            try {\n              const fullPath = join(packagePath, filePath);\n              const stats = await stat(fullPath);\n              return {\n                path: filePath,\n                size: stats.size,\n              };\n            } catch {\n              return {\n                path: filePath,\n                size: 0,\n              };\n            }\n          })\n        );\n\n        const packageTotalSize = filesWithSize.reduce((sum: number, f: PackageFile) => sum + f.size, 0);\n\n        packages.push({\n          name: pkg.name,\n          version: pkg.nextVersion,\n          path: pkg.path,\n          buildStatus,\n          files: filesWithSize,\n          expectedFiles: expectedFiles.length > 0 ? expectedFiles : undefined,\n          totalSize: packageTotalSize,\n          fileCount: files.length,\n        });\n\n        totalSize += packageTotalSize;\n        totalFiles += files.length;\n      } catch {\n        // If we can't read the package, add it with empty files\n        packages.push({\n          name: pkg.name,\n          version: pkg.nextVersion,\n          path: pkg.path,\n          buildStatus,\n          files: [],\n          expectedFiles: expectedFiles.length > 0 ? expectedFiles : undefined,\n          totalSize: 0,\n          fileCount: 0,\n        });\n      }\n    }\n\n    return {\n      scope,\n      packages,\n      totalSize,\n      totalFiles,\n      allBuilt,\n    };\n  },\n});\n"]}

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

@@ -0,0 +1,65 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * Report handler - Get latest release report
+ *
+ * Reads from .kb/release/history/index.json and returns most recent report
+ */
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, unknown, {
+    hasReport: boolean;
+    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;
+    } | undefined;
+    scope?: string | undefined;
+}>;
+
+export { _default as default };

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

@@ -0,0 +1,48 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+
+// src/rest/handlers/report-handler.ts
+var report_handler_default = defineHandler({
+  async execute(ctx, _input) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    const indexPath = `${repoRoot}/.kb/release/history/index.json`;
+    let raw;
+    try {
+      raw = await ctx.runtime.fs.readFile(indexPath, "utf-8");
+    } catch (error) {
+      return {
+        hasReport: false
+      };
+    }
+    try {
+      const index = JSON.parse(raw);
+      if (!index.releases || index.releases.length === 0) {
+        return {
+          hasReport: false
+        };
+      }
+      const latest = index.releases[0];
+      const reportPath = `${repoRoot}/.kb/release/history/${latest.id}/report.json`;
+      const reportRaw = await ctx.runtime.fs.readFile(reportPath, "utf-8");
+      const report = JSON.parse(reportRaw);
+      return {
+        hasReport: true,
+        report,
+        scope: report.scope
+      };
+    } catch (error) {
+      ctx.platform?.logger?.error?.(
+        "Failed to read release report",
+        error instanceof Error ? error : void 0,
+        {}
+      );
+      return {
+        hasReport: false
+      };
+    }
+  }
+});
+
+export { report_handler_default as default };
+//# sourceMappingURL=report-handler.js.map
+//# sourceMappingURL=report-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/report-handler.ts"],"names":[],"mappings":";;;AASA,IAAO,yBAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAK,MAAA,EAA0C;AAC3D,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AACnC,IAAA,MAAM,QAAA,GAAW,MAAM,YAAA,CAAa,GAAG,CAAA;AAGvC,IAAA,MAAM,SAAA,GAAY,GAAG,QAAQ,CAAA,+BAAA,CAAA;AAE7B,IAAA,IAAI,GAAA;AACJ,IAAA,IAAI;AACF,MAAA,GAAA,GAAM,MAAM,GAAA,CAAI,OAAA,CAAQ,EAAA,CAAG,QAAA,CAAS,WAAW,OAAO,CAAA;AAAA,IACxD,SAAS,KAAA,EAAO;AAEd,MAAA,OAAO;AAAA,QACL,SAAA,EAAW;AAAA,OACb;AAAA,IACF;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAE5B,MAAA,IAAI,CAAC,KAAA,CAAM,QAAA,IAAY,KAAA,CAAM,QAAA,CAAS,WAAW,CAAA,EAAG;AAClD,QAAA,OAAO;AAAA,UACL,SAAA,EAAW;AAAA,SACb;AAAA,MACF;AAGA,MAAA,MAAM,MAAA,GAAS,KAAA,CAAM,QAAA,CAAS,CAAC,CAAA;AAG/B,MAAA,MAAM,UAAA,GAAa,CAAA,EAAG,QAAQ,CAAA,qBAAA,EAAwB,OAAO,EAAE,CAAA,YAAA,CAAA;AAC/D,MAAA,MAAM,YAAY,MAAM,GAAA,CAAI,QAAQ,EAAA,CAAG,QAAA,CAAS,YAAY,OAAO,CAAA;AACnE,MAAA,MAAM,MAAA,GAAwB,IAAA,CAAK,KAAA,CAAM,SAAS,CAAA;AAElD,MAAA,OAAO;AAAA,QACL,SAAA,EAAW,IAAA;AAAA,QACX,MAAA;AAAA,QACA,OAAO,MAAA,CAAO;AAAA,OAChB;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,UAAU,MAAA,EAAQ,KAAA;AAAA,QACpB,+BAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ,MAAA;AAAA,QACjC;AAAC,OACH;AAEA,MAAA,OAAO;AAAA,QACL,SAAA,EAAW;AAAA,OACb;AAAA,IACF;AAAA,EACF;AACF,CAAC","file":"report-handler.js","sourcesContent":["/**\n * Report handler - Get latest release report\n *\n * Reads from .kb/release/history/index.json and returns most recent report\n */\n\nimport { defineHandler, findRepoRoot } from '@kb-labs/sdk';\nimport type { ReportResponse, ReleaseReport } from '@kb-labs/release-manager-contracts';\n\nexport default defineHandler({\n  async execute(ctx, _input: unknown): Promise<ReportResponse> {\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    // Read history index to find latest report\n    const indexPath = `${repoRoot}/.kb/release/history/index.json`;\n\n    let raw: string;\n    try {\n      raw = await ctx.runtime.fs.readFile(indexPath, 'utf-8');\n    } catch (error) {\n      // No history yet\n      return {\n        hasReport: false,\n      };\n    }\n\n    try {\n      const index = JSON.parse(raw);\n\n      if (!index.releases || index.releases.length === 0) {\n        return {\n          hasReport: false,\n        };\n      }\n\n      // Get most recent release\n      const latest = index.releases[0];\n\n      // Read the full report\n      const reportPath = `${repoRoot}/.kb/release/history/${latest.id}/report.json`;\n      const reportRaw = await ctx.runtime.fs.readFile(reportPath, 'utf-8');\n      const report: ReleaseReport = JSON.parse(reportRaw);\n\n      return {\n        hasReport: true,\n        report,\n        scope: report.scope,\n      };\n    } catch (error) {\n      ctx.platform?.logger?.error?.(\n        'Failed to read release report',\n        error instanceof Error ? error : undefined,\n        {}\n      );\n\n      return {\n        hasReport: false,\n      };\n    }\n  }\n});\n"]}

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

@@ -0,0 +1,12 @@
+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>, {
+    message: string;
+    scope: string;
+    success: boolean;
+}>;
+
+export { _default as default };

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

@@ -0,0 +1,38 @@
+import { defineHandler, findRepoRoot } from '@kb-labs/sdk';
+import { rm } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+
+// src/rest/handlers/reset-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+
+// src/rest/handlers/reset-handler.ts
+var reset_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 scopeDirName = scopeToDir(scope);
+    const scopeDir = join(repoRoot, ".kb/release/plans", scopeDirName, "current");
+    try {
+      await rm(scopeDir, { recursive: true, force: true });
+      return {
+        success: true,
+        scope,
+        message: `Release plan for scope "${scope}" has been reset`
+      };
+    } catch (error) {
+      return {
+        success: false,
+        scope,
+        message: `Failed to reset plan: ${error instanceof Error ? error.message : "Unknown error"}`
+      };
+    }
+  }
+});
+
+export { reset_handler_default as default };
+//# sourceMappingURL=reset-handler.js.map
+//# sourceMappingURL=reset-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/reset-handler.ts"],"names":["findRepoRoot","join"],"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;;;ACHA,IAAO,wBAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAK,KAAA,EAAyE;AAC1F,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,EAAO,KAAA,IAAS,MAAA;AACpC,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,YAAA,GAAe,WAAW,KAAK,CAAA;AACrC,IAAA,MAAM,QAAA,GAAWC,IAAAA,CAAK,QAAA,EAAU,mBAAA,EAAqB,cAAc,SAAS,CAAA;AAE5E,IAAA,IAAI;AAEF,MAAA,MAAM,GAAG,QAAA,EAAU,EAAE,WAAW,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAEnD,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,IAAA;AAAA,QACT,KAAA;AAAA,QACA,OAAA,EAAS,2BAA2B,KAAK,CAAA,gBAAA;AAAA,OAC3C;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,KAAA;AAAA,QACA,SAAS,CAAA,sBAAA,EAAyB,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,eAAe,CAAA;AAAA,OAC5F;AAAA,IACF;AAAA,EACF;AACF,CAAC","file":"reset-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 * Reset release plan handler - Delete current release plan and changelog\n *\n * Deletes: .kb/release/plans/{scope}/current/\n */\n\nimport { defineHandler, findRepoRoot, type RestInput } from '@kb-labs/sdk';\nimport type { ResetPlanRequest, ResetPlanResponse } from '@kb-labs/release-manager-contracts';\nimport { rm } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { scopeToDir } from '../../shared/utils';\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<ResetPlanRequest, unknown>): Promise<ResetPlanResponse> {\n    const scope = input.query?.scope || 'root';\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n\n    const scopeDirName = scopeToDir(scope);\n    const scopeDir = join(repoRoot, '.kb/release/plans', scopeDirName, 'current');\n\n    try {\n      // Remove entire current directory for this scope\n      await rm(scopeDir, { recursive: true, force: true });\n\n      return {\n        success: true,\n        scope,\n        message: `Release plan for scope \"${scope}\" has been reset`,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        scope,\n        message: `Failed to reset plan: ${error instanceof Error ? error.message : 'Unknown error'}`,\n      };\n    }\n  }\n});\n"]}

package/dist/rest/handlers/run-checks-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';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, {
+    scope: string;
+}, unknown>, {
+    scope: string;
+    success: boolean;
+    checks: {
+        id: string;
+        name: string;
+        success: boolean;
+        durationMs: number;
+        error?: string | undefined;
+        optional?: boolean | undefined;
+    }[];
+    totalDurationMs: number;
+}>;
+
+export { _default as default };

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

@@ -0,0 +1,58 @@
+import { defineHandler, findRepoRoot, useConfig } from '@kb-labs/sdk';
+import { resolveScopePath, runReleaseChecks } from '@kb-labs/release-manager-core';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import 'globby';
+
+// src/rest/handlers/run-checks-handler.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+var run_checks_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const scope = input.body?.scope ?? "root";
+    const cwd = ctx.cwd ?? process.cwd();
+    const repoRoot = await findRepoRoot(cwd);
+    const scopeCwd = await resolveScopePath(repoRoot, scope);
+    const startTime = Date.now();
+    const config = await useConfig();
+    const checks = config?.scopes?.[scope]?.checks ?? config?.checks ?? [];
+    if (checks.length === 0) {
+      return { scope, success: true, checks: [], totalDurationMs: Date.now() - startTime };
+    }
+    const scopeDir = scopeToDir(scope);
+    const planPath = join(repoRoot, ".kb/release/plans", scopeDir, "current", "plan.json");
+    let packagePaths = [];
+    try {
+      const plan = JSON.parse(await readFile(planPath, "utf-8"));
+      packagePaths = plan.packages.map((pkg) => pkg.path.startsWith("/") ? pkg.path : join(repoRoot, pkg.path));
+    } catch {
+      packagePaths = [scopeCwd];
+    }
+    const results = await runReleaseChecks(checks, {
+      repoRoot,
+      packagePaths,
+      scopePath: scopeCwd,
+      logger: ctx.platform?.logger
+    });
+    const allPassed = results.every((r) => r.ok || r.hint === "optional");
+    const checkItems = results.map((r) => ({
+      id: r.id,
+      name: checks.find((c) => c.id === r.id)?.name ?? r.id,
+      success: r.ok,
+      error: r.details && typeof r.details === "object" && "error" in r.details ? String(r.details.error) : void 0,
+      durationMs: r.timingMs ?? 0,
+      optional: checks.find((c) => c.id === r.id)?.optional
+    }));
+    return {
+      scope,
+      success: allPassed,
+      checks: checkItems,
+      totalDurationMs: Date.now() - startTime
+    };
+  }
+});
+
+export { run_checks_handler_default as default };
+//# sourceMappingURL=run-checks-handler.js.map
+//# sourceMappingURL=run-checks-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/rest/handlers/run-checks-handler.ts"],"names":["findRepoRoot","join","readFile"],"mappings":"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","file":"run-checks-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 * Run pre-release checks handler — thin adapter over core runReleaseChecks().\n */\n\nimport { defineHandler, findRepoRoot, type RestInput, useConfig } from '@kb-labs/sdk';\nimport type { RunChecksRequest, RunChecksResponse, CheckResultItem } from '@kb-labs/release-manager-contracts';\nimport { runReleaseChecks, type ReleaseConfig, type CustomCheckConfig } from '@kb-labs/release-manager-core';\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { scopeToDir } from '../../shared/utils.js';\nimport { resolveScopePath } from '@kb-labs/release-manager-core';\n\nexport default defineHandler({\n  async execute(ctx, input: RestInput<unknown, RunChecksRequest>): Promise<RunChecksResponse> {\n    const scope = input.body?.scope ?? 'root';\n    const cwd = ctx.cwd ?? process.cwd();\n    const repoRoot = await findRepoRoot(cwd);\n    const scopeCwd = await resolveScopePath(repoRoot, scope);\n    const startTime = Date.now();\n\n    const config = await useConfig<ReleaseConfig>();\n    const checks: CustomCheckConfig[] = config?.scopes?.[scope]?.checks ?? config?.checks ?? [];\n\n    if (checks.length === 0) {\n      return { scope, success: true, checks: [], totalDurationMs: Date.now() - startTime };\n    }\n\n    // Read plan to get package paths\n    const scopeDir = scopeToDir(scope);\n    const planPath = join(repoRoot, '.kb/release/plans', scopeDir, 'current', 'plan.json');\n    let packagePaths: string[] = [];\n    try {\n      const plan: { packages: Array<{ name: string; path: string }> } = JSON.parse(await readFile(planPath, 'utf-8'));\n      packagePaths = plan.packages.map(pkg => pkg.path.startsWith('/') ? pkg.path : join(repoRoot, pkg.path));\n    } catch {\n      packagePaths = [scopeCwd];\n    }\n\n    // Run checks via core\n    const results = await runReleaseChecks(checks, {\n      repoRoot,\n      packagePaths,\n      scopePath: scopeCwd,\n      logger: ctx.platform?.logger,\n    });\n\n    const allPassed = results.every(r => r.ok || r.hint === 'optional');\n\n    // Map core CheckResult to REST CheckResultItem\n    const checkItems: CheckResultItem[] = results.map(r => ({\n      id: r.id,\n      name: checks.find(c => c.id === r.id)?.name ?? r.id,\n      success: r.ok,\n      error: r.details && typeof r.details === 'object' && 'error' in r.details ? String((r.details as any).error) : undefined,\n      durationMs: r.timingMs ?? 0,\n      optional: checks.find(c => c.id === r.id)?.optional,\n    }));\n\n    return {\n      scope,\n      success: allPassed,\n      checks: checkItems,\n      totalDurationMs: Date.now() - startTime,\n    };\n  },\n});\n"]}

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

@@ -0,0 +1,68 @@
+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;
+    strict?: boolean | undefined;
+    dryRun?: boolean | undefined;
+    skipChecks?: boolean | undefined;
+    otp?: string | undefined;
+}, unknown>, {
+    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;
+    };
+    scope: string;
+    success: boolean;
+    errors?: string[] | undefined;
+}>;
+
+export { _default as default };