@kb-labs/release-manager-cli 0.5.0

package/README.md

@@ -0,0 +1,211 @@
+# @kb-labs/release-cli
+
+KB Labs Release Manager - CLI commands for release management.
+
+## Vision & Purpose
+
+**@kb-labs/release-cli** provides CLI commands for KB Labs Release Manager. It includes commands for planning, running, verifying, previewing, reporting, rolling back releases, and generating changelogs.
+
+### Core Goals
+
+- **Plan Command**: Plan release with versioning
+- **Run Command**: Run complete release process
+- **Verify Command**: Verify release readiness
+- **Preview Command**: Preview release plan
+- **Report Command**: Generate release report
+- **Rollback Command**: Rollback failed release
+- **Changelog Command**: Generate changelog
+
+## Package Status
+
+- **Version**: 0.1.0
+- **Stage**: Stable
+- **Status**: Production Ready ✅
+
+## Architecture
+
+### High-Level Overview
+
+```
+Release CLI
+    │
+    ├──► CLI Commands
+    ├──► Manifest Definition
+    ├──► REST Handlers
+    └──► Analytics Integration
+```
+
+### Key Components
+
+1. **Commands** (`commands/`): CLI command implementations
+2. **Manifest** (`manifest.v2.ts`): Plugin manifest definition
+3. **REST Handlers** (`rest/handlers/`): REST API handlers
+4. **Analytics** (`analytics/`): Analytics event tracking
+
+## ✨ Features
+
+- **Plan command** for planning releases
+- **Run command** for running releases
+- **Verify command** for verifying release readiness
+- **Preview command** for previewing release plans
+- **Report command** for generating reports
+- **Rollback command** for rolling back releases
+- **Changelog command** for generating changelogs
+- **REST handlers** for API integration
+
+## 📦 API Reference
+
+### Main Exports
+
+#### Commands
+
+- `plan`: Plan release command
+- `run`: Run release command
+- `verify`: Verify release command
+- `preview`: Preview release command
+- `report`: Report command
+- `rollback`: Rollback command
+- `changelog`: Changelog command
+
+#### Manifest
+
+- `manifest`: Plugin manifest V2
+- `commands`: CLI commands manifest
+
+## 🔧 Configuration
+
+### Configuration Options
+
+All configuration via CLI flags and kb-labs.config.json.
+
+### CLI Flags
+
+- `--json`: Output JSON format
+- `--quiet`: Quiet mode
+- `--verbose`: Verbose output
+
+## 🔗 Dependencies
+
+### Runtime Dependencies
+
+- `@kb-labs/analytics-sdk-node` (`link:../../../kb-labs-analytics/packages/analytics-sdk-node`): Analytics SDK
+- `@kb-labs/release-core` (`link:../release-core`): Release core
+- `@kb-labs/release-checks` (`link:../release-checks`): Release checks
+- `@kb-labs/changelog` (`link:../changelog`): Changelog package
+- `@kb-labs/cli-core` (`link:../../../kb-labs-cli/packages/core`): CLI core
+- `@kb-labs/cli-commands` (`link:../../../kb-labs-cli/packages/commands`): CLI commands
+- `@kb-labs/shared-cli-ui` (`link:../../../kb-labs-shared/packages/cli-ui`): Shared CLI UI
+- `@kb-labs/core` (`link:../../../kb-labs-core`): Core package
+- `@kb-labs/core-bundle` (`link:../../../kb-labs-core/packages/bundle`): Bundle package
+- `@kb-labs/plugin-manifest` (`link:../../../kb-labs-plugin/packages/manifest`): Plugin manifest
+- `@aws-sdk/client-s3` (`^3.676.0`): AWS S3 client
+- `ajv` (`^8.17.1`): JSON schema validation
+- `ajv-formats` (`^3.0.1`): AJV formats
+- `glob` (`^10.3.10`): File globbing
+- `globby` (`^11.0.0`): File pattern matching
+- `semver` (`^7.6.0`): SemVer parsing
+- `simple-git` (`^3.25.0`): Git operations
+- `uuidv7` (`^0.6.1`): UUID v7 generation
+- `yaml` (`^2.8.0`): YAML parsing
+- `zod` (`^4.1.5`): Schema validation
+
+### Development Dependencies
+
+- `@kb-labs/devkit` (`link:../../../kb-labs-devkit`): DevKit presets
+- `@types/node` (`^24.7.0`): Node.js types
+- `tsup` (`^8`): TypeScript bundler
+- `typescript` (`^5`): TypeScript compiler
+- `vitest` (`^3`): Test runner
+
+## 🧪 Testing
+
+### Test Structure
+
+```
+src/__tests__/
+└── manifest.v2.spec.ts
+```
+
+### Test Coverage
+
+- **Current Coverage**: ~50%
+- **Target Coverage**: 90%
+
+## 📈 Performance
+
+### Performance Characteristics
+
+- **Time Complexity**: O(1) for command registration, O(n) for command execution
+- **Space Complexity**: O(1)
+- **Bottlenecks**: Release operations
+
+## 🔒 Security
+
+### Security Considerations
+
+- **Registry Authentication**: Secure registry authentication
+- **Path Validation**: Path validation for file operations
+
+### Known Vulnerabilities
+
+- None
+
+## 🐛 Known Issues & Limitations
+
+### Known Issues
+
+- None currently
+
+### Limitations
+
+- **Command Types**: Fixed command types
+- **Output Formats**: Fixed output formats
+
+### Future Improvements
+
+- **More Commands**: Additional commands
+- **Custom Output Formats**: Custom output format support
+
+## 🔄 Migration & Breaking Changes
+
+### Migration from Previous Versions
+
+No breaking changes in current version (0.1.0).
+
+### Breaking Changes in Future Versions
+
+- None planned
+
+## 📚 Examples
+
+### Example 1: Plan Release
+
+```bash
+kb release:plan
+```
+
+### Example 2: Run Release
+
+```bash
+kb release:run
+```
+
+### Example 3: Verify Release
+
+```bash
+kb release:verify
+```
+
+### Example 4: Generate Changelog
+
+```bash
+kb release:changelog
+```
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for development guidelines.
+
+## 📄 License
+
+MIT © KB Labs

package/dist/cli/commands/changelog.d.ts

@@ -0,0 +1,17 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+interface ChangelogFlags {
+    scope?: string;
+    from?: string;
+    to?: string;
+    'since-tag'?: string;
+    format?: 'json' | 'md' | 'both';
+    level?: 'compact' | 'standard' | 'detailed';
+    template?: string;
+    'breaking-only'?: boolean;
+    json?: boolean;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<ChangelogFlags>, unknown>;
+
+export { _default as default };

package/dist/cli/commands/changelog.js

@@ -0,0 +1,156 @@
+import { join } from 'path';
+import { mkdir, readFile, writeFile, stat } from 'fs/promises';
+import { defineCommand, findRepoRoot, useLoader, useConfig, useLLM, displayArtifacts } from '@kb-labs/sdk';
+import { planRelease } from '@kb-labs/release-manager-core';
+import 'globby';
+import { generateChangelog, generateSimpleChangelog } from '@kb-labs/release-manager-changelog';
+
+// src/cli/commands/changelog.ts
+function createChangelogGenerator(config, llm) {
+  return {
+    async generate(plan, opts) {
+      const locale = config.changelog?.locale || "en";
+      const packages = plan.packages.map((pkg) => ({
+        name: pkg.name,
+        path: pkg.path,
+        currentVersion: pkg.currentVersion,
+        nextVersion: pkg.nextVersion,
+        bump: pkg.bump === "auto" ? "patch" : pkg.bump
+      }));
+      try {
+        const result = await generateChangelog({
+          repoRoot: opts.repoRoot,
+          gitCwd: opts.gitCwd,
+          packages,
+          range: { to: "HEAD" },
+          changelog: {
+            template: config.changelog?.template ?? void 0,
+            locale,
+            metadata: config.changelog?.metadata,
+            ignoreAuthors: config.changelog?.ignoreAuthors,
+            includeTypes: config.changelog?.includeTypes,
+            excludeTypes: config.changelog?.excludeTypes,
+            collapseMerges: config.changelog?.collapseMerges,
+            collapseReverts: config.changelog?.collapseReverts,
+            preferMergeSummary: config.changelog?.preferMergeSummary
+          },
+          git: {
+            autoUnshallow: config.git?.autoUnshallow,
+            requireSignedTags: config.git?.requireSignedTags,
+            baseUrl: config.git?.baseUrl ?? void 0
+          },
+          platform: llm ? { llm } : void 0
+        });
+        return result.markdown;
+      } catch {
+        return generateSimpleChangelog(packages, locale);
+      }
+    }
+  };
+}
+
+// src/cli/commands/changelog.ts
+var changelog_default = defineCommand({
+  id: "release:changelog",
+  description: "Generate changelog from conventional commits",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const cwd = ctx.cwd || process.cwd();
+      const repoRoot = await findRepoRoot(cwd);
+      const loader = useLoader("Loading configuration...");
+      loader.start();
+      const fileConfig = await useConfig();
+      const config = fileConfig ?? {};
+      loader.update({ text: "Discovering packages..." });
+      const plan = await planRelease({ cwd: repoRoot, config, scope: flags.scope });
+      if (plan.packages.length === 0) {
+        loader.fail(`No packages found matching scope: ${flags.scope || "all"}`);
+        return { exitCode: 1 };
+      }
+      let gitCwd = repoRoot;
+      if (flags.scope && plan.packages[0]) {
+        try {
+          gitCwd = await findRepoRoot(plan.packages[0].path);
+        } catch {
+          gitCwd = plan.packages[0].path;
+        }
+      }
+      loader.update({ text: "Generating changelog..." });
+      const llm = useLLM();
+      const generator = createChangelogGenerator(config, llm ?? void 0);
+      const markdown = await generator.generate(plan, { repoRoot, gitCwd, config });
+      const format = flags.format || config.changelog?.format || "both";
+      loader.update({ text: "Saving artifacts..." });
+      const outputDir = join(repoRoot, ".kb", "release");
+      const artifacts = [];
+      if (!flags.json) {
+        await mkdir(outputDir, { recursive: true });
+        if (markdown && (format === "md" || format === "both")) {
+          const changelogPath = join(outputDir, "CHANGELOG.md");
+          let existing = "";
+          try {
+            existing = await readFile(changelogPath, "utf-8");
+            const footerStart = existing.indexOf("\n---\n\n*Generated automatically");
+            if (footerStart !== -1) {
+              existing = existing.substring(0, footerStart);
+            }
+          } catch {
+          }
+          const combined = existing ? `${markdown}
+
+${existing}` : markdown;
+          await writeFile(changelogPath, combined, "utf-8");
+          const stats = await stat(changelogPath);
+          artifacts.push({
+            name: "Changelog",
+            path: changelogPath,
+            size: stats.size,
+            modified: stats.mtime,
+            description: "Generated changelog in Markdown format"
+          });
+        }
+      }
+      loader.succeed("Changelog generated successfully");
+      if (flags.json) {
+        ctx.ui?.json?.({
+          packagesCount: plan.packages.length,
+          markdown: format === "md" || format === "both" ? markdown : void 0,
+          artifacts: artifacts.map((a) => ({ name: a.name, path: a.path, size: a.size ?? 0 }))
+        });
+      } else {
+        const sections = [];
+        sections.push({
+          header: "Summary",
+          items: [
+            `Packages: ${plan.packages.map((p) => p.name).join(", ")}`,
+            `Format: ${format === "both" ? "Markdown + JSON" : format}`
+          ]
+        });
+        if (artifacts.length > 0) {
+          const artifactsLines = displayArtifacts(artifacts, {
+            showSize: true,
+            showTime: true,
+            showDescription: true,
+            maxItems: 10,
+            title: ""
+          });
+          sections.push({ header: "Artifacts", items: artifactsLines });
+        }
+        ctx.ui.sideBox({
+          title: "Changelog Generated",
+          sections,
+          status: "success"
+        });
+      }
+      return {
+        exitCode: 0,
+        artifacts: artifacts.map((a) => ({ name: a.name, path: a.path, size: a.size ?? 0 }))
+      };
+    }
+  }
+});
+
+export { changelog_default as default };
+//# sourceMappingURL=changelog.js.map
+//# sourceMappingURL=changelog.js.map

package/dist/cli/commands/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/changelog-factory.ts","../../../src/cli/commands/changelog.ts"],"names":["join","readFile"],"mappings":";;;;;;;;AAYO,SAAS,wBAAA,CAAyB,QAAuB,GAAA,EAA+B;AAC7F,EAAA,OAAO;AAAA,IACL,MAAM,QAAA,CAAS,IAAA,EAAM,IAAA,EAAM;AACzB,MAAA,MAAM,MAAA,GAAU,MAAA,CAAO,SAAA,EAAW,MAAA,IAA0B,IAAA;AAC5D,MAAA,MAAM,QAAA,GAAmC,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,CAAA,GAAA,MAAQ;AAAA,QACjE,MAAM,GAAA,CAAI,IAAA;AAAA,QACV,MAAM,GAAA,CAAI,IAAA;AAAA,QACV,gBAAgB,GAAA,CAAI,cAAA;AAAA,QACpB,aAAa,GAAA,CAAI,WAAA;AAAA,QACjB,IAAA,EAAM,GAAA,CAAI,IAAA,KAAS,MAAA,GAAS,UAAU,GAAA,CAAI;AAAA,OAC5C,CAAE,CAAA;AACF,MAAA,IAAI;AACF,QAAA,MAAM,MAAA,GAAS,MAAM,iBAAA,CAAkB;AAAA,UACrC,UAAU,IAAA,CAAK,QAAA;AAAA,UACf,QAAQ,IAAA,CAAK,MAAA;AAAA,UACb,QAAA;AAAA,UACA,KAAA,EAAO,EAAE,EAAA,EAAI,MAAA,EAAO;AAAA,UACpB,SAAA,EAAW;AAAA,YACT,QAAA,EAAU,MAAA,CAAO,SAAA,EAAW,QAAA,IAAY,KAAA,CAAA;AAAA,YACxC,MAAA;AAAA,YACA,QAAA,EAAU,OAAO,SAAA,EAAW,QAAA;AAAA,YAC5B,aAAA,EAAe,OAAO,SAAA,EAAW,aAAA;AAAA,YACjC,YAAA,EAAc,OAAO,SAAA,EAAW,YAAA;AAAA,YAChC,YAAA,EAAc,OAAO,SAAA,EAAW,YAAA;AAAA,YAChC,cAAA,EAAgB,OAAO,SAAA,EAAW,cAAA;AAAA,YAClC,eAAA,EAAiB,OAAO,SAAA,EAAW,eAAA;AAAA,YACnC,kBAAA,EAAoB,OAAO,SAAA,EAAW;AAAA,WACxC;AAAA,UACA,GAAA,EAAK;AAAA,YACH,aAAA,EAAe,OAAO,GAAA,EAAK,aAAA;AAAA,YAC3B,iBAAA,EAAmB,OAAO,GAAA,EAAK,iBAAA;AAAA,YAC/B,OAAA,EAAS,MAAA,CAAO,GAAA,EAAK,OAAA,IAAW,KAAA;AAAA,WAClC;AAAA,UACA,QAAA,EAAU,GAAA,GAAM,EAAE,GAAA,EAAI,GAAI,KAAA;AAAA,SAC3B,CAAA;AACD,QAAA,OAAO,MAAA,CAAO,QAAA;AAAA,MAChB,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,uBAAA,CAAwB,UAAU,MAAM,CAAA;AAAA,MACjD;AAAA,IACF;AAAA,GACF;AACF;;;ACzBA,IAAO,oBAAQ,aAAA,CAAc;AAAA,EAC3B,EAAA,EAAI,mBAAA;AAAA,EACJ,WAAA,EAAa,8CAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAkE;AACpG,MAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AACnC,MAAA,MAAM,QAAA,GAAW,MAAM,YAAA,CAAa,GAAG,CAAA;AAGvC,MAAA,MAAM,MAAA,GAAS,UAAU,0BAA0B,CAAA;AACnD,MAAA,MAAA,CAAO,KAAA,EAAM;AAEb,MAAA,MAAM,UAAA,GAAa,MAAM,SAAA,EAAyB;AAClD,MAAA,MAAM,MAAA,GAAwB,cAAc,EAAC;AAE7C,MAAA,MAAA,CAAO,MAAA,CAAO,EAAE,IAAA,EAAM,yBAAA,EAA2B,CAAA;AAEjD,MAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,EAAE,GAAA,EAAK,UAAU,MAAA,EAAQ,KAAA,EAAO,KAAA,CAAM,KAAA,EAAO,CAAA;AAE5E,MAAA,IAAI,IAAA,CAAK,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG;AAC9B,QAAA,MAAA,CAAO,IAAA,CAAK,CAAA,kCAAA,EAAqC,KAAA,CAAM,KAAA,IAAS,KAAK,CAAA,CAAE,CAAA;AACvE,QAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,MACvB;AAGA,MAAA,IAAI,MAAA,GAAS,QAAA;AACb,MAAA,IAAI,KAAA,CAAM,KAAA,IAAS,IAAA,CAAK,QAAA,CAAS,CAAC,CAAA,EAAG;AACnC,QAAA,IAAI;AACF,UAAA,MAAA,GAAS,MAAM,YAAA,CAAa,IAAA,CAAK,QAAA,CAAS,CAAC,EAAE,IAAI,CAAA;AAAA,QACnD,CAAA,CAAA,MAAQ;AACN,UAAA,MAAA,GAAS,IAAA,CAAK,QAAA,CAAS,CAAC,CAAA,CAAE,IAAA;AAAA,QAC5B;AAAA,MACF;AAGA,MAAA,MAAA,CAAO,MAAA,CAAO,EAAE,IAAA,EAAM,yBAAA,EAA2B,CAAA;AAEjD,MAAA,MAAM,MAAM,MAAA,EAAO;AACnB,MAAA,MAAM,SAAA,GAAY,wBAAA,CAAyB,MAAA,EAAQ,GAAA,IAAO,MAAS,CAAA;AACnE,MAAA,MAAM,QAAA,GAAW,MAAM,SAAA,CAAU,QAAA,CAAS,MAAM,EAAE,QAAA,EAAU,MAAA,EAAQ,MAAA,EAAQ,CAAA;AAE5E,MAAA,MAAM,MAAA,GAAS,KAAA,CAAM,MAAA,IAAU,MAAA,CAAO,WAAW,MAAA,IAAU,MAAA;AAG3D,MAAA,MAAA,CAAO,MAAA,CAAO,EAAE,IAAA,EAAM,qBAAA,EAAuB,CAAA;AAE7C,MAAA,MAAM,SAAA,GAAYA,IAAAA,CAAK,QAAA,EAAU,KAAA,EAAO,SAAS,CAAA;AACjD,MAAA,MAAM,YAA4B,EAAC;AAEnC,MAAA,IAAI,CAAC,MAAM,IAAA,EAAM;AACf,QAAA,MAAM,KAAA,CAAM,SAAA,EAAW,EAAE,SAAA,EAAW,MAAM,CAAA;AAE1C,QAAA,IAAI,QAAA,KAAa,MAAA,KAAW,IAAA,IAAQ,MAAA,KAAW,MAAA,CAAA,EAAS;AACtD,UAAA,MAAM,aAAA,GAAgBA,IAAAA,CAAK,SAAA,EAAW,cAAc,CAAA;AAGpD,UAAA,IAAI,QAAA,GAAW,EAAA;AACf,UAAA,IAAI;AACF,YAAA,QAAA,GAAW,MAAMC,QAAAA,CAAS,aAAA,EAAe,OAAO,CAAA;AAChD,YAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,mCAAmC,CAAA;AACxE,YAAA,IAAI,gBAAgB,CAAA,CAAA,EAAI;AACtB,cAAA,QAAA,GAAW,QAAA,CAAS,SAAA,CAAU,CAAA,EAAG,WAAW,CAAA;AAAA,YAC9C;AAAA,UACF,CAAA,CAAA,MAAQ;AAAA,UAA+B;AAEvC,UAAA,MAAM,QAAA,GAAW,QAAA,GAAW,CAAA,EAAG,QAAQ;;AAAA,EAAO,QAAQ,CAAA,CAAA,GAAK,QAAA;AAC3D,UAAA,MAAM,SAAA,CAAU,aAAA,EAAe,QAAA,EAAU,OAAO,CAAA;AAEhD,UAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,aAAa,CAAA;AACtC,UAAA,SAAA,CAAU,IAAA,CAAK;AAAA,YACb,IAAA,EAAM,WAAA;AAAA,YACN,IAAA,EAAM,aAAA;AAAA,YACN,MAAM,KAAA,CAAM,IAAA;AAAA,YACZ,UAAU,KAAA,CAAM,KAAA;AAAA,YAChB,WAAA,EAAa;AAAA,WACd,CAAA;AAAA,QACH;AAAA,MACF;AAEA,MAAA,MAAA,CAAO,QAAQ,kCAAkC,CAAA;AAGjD,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,IAAI,IAAA,GAAO;AAAA,UACb,aAAA,EAAe,KAAK,QAAA,CAAS,MAAA;AAAA,UAC7B,QAAA,EAAU,MAAA,KAAW,IAAA,IAAQ,MAAA,KAAW,SAAS,QAAA,GAAW,MAAA;AAAA,UAC5D,SAAA,EAAW,SAAA,CAAU,GAAA,CAAI,CAAA,CAAA,MAAM,EAAE,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,IAAA,EAAM,EAAE,IAAA,EAAM,IAAA,EAAM,CAAA,CAAE,IAAA,IAAQ,GAAE,CAAE;AAAA,SAClF,CAAA;AAAA,MACH,CAAA,MAAO;AACL,QAAA,MAAM,WAAwD,EAAC;AAE/D,QAAA,QAAA,CAAS,IAAA,CAAK;AAAA,UACZ,MAAA,EAAQ,SAAA;AAAA,UACR,KAAA,EAAO;AAAA,YACL,CAAA,UAAA,EAAa,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,IAAI,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAAA,YACtD,CAAA,QAAA,EAAW,MAAA,KAAW,MAAA,GAAS,iBAAA,GAAoB,MAAM,CAAA;AAAA;AAC3D,SACD,CAAA;AAED,QAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG;AACxB,UAAA,MAAM,cAAA,GAAiB,iBAAiB,SAAA,EAAW;AAAA,YACjD,QAAA,EAAU,IAAA;AAAA,YACV,QAAA,EAAU,IAAA;AAAA,YACV,eAAA,EAAiB,IAAA;AAAA,YACjB,QAAA,EAAU,EAAA;AAAA,YACV,KAAA,EAAO;AAAA,WACR,CAAA;AACD,UAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,WAAA,EAAa,KAAA,EAAO,gBAAgB,CAAA;AAAA,QAC9D;AAEA,QAAA,GAAA,CAAI,GAAG,OAAA,CAAQ;AAAA,UACb,KAAA,EAAO,qBAAA;AAAA,UACP,QAAA;AAAA,UACA,MAAA,EAAQ;AAAA,SACT,CAAA;AAAA,MACH;AAEA,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,CAAA;AAAA,QACV,SAAA,EAAW,SAAA,CAAU,GAAA,CAAI,CAAA,CAAA,MAAM,EAAE,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,IAAA,EAAM,EAAE,IAAA,EAAM,IAAA,EAAM,CAAA,CAAE,IAAA,IAAQ,GAAE,CAAE;AAAA,OACnF;AAAA,IACF;AAAA;AAEJ,CAAC","file":"changelog.js","sourcesContent":["/**\n * Shared changelog generator factory.\n * Used by both CLI (run.ts) and REST (run-handler.ts) to avoid duplication.\n */\n\nimport {\n  generateChangelog,\n  generateSimpleChangelog,\n  type ChangelogPackageInfo,\n} from '@kb-labs/release-manager-changelog';\nimport type { ReleaseConfig, ChangelogGenerator } from '@kb-labs/release-manager-core';\n\nexport function createChangelogGenerator(config: ReleaseConfig, llm?: any): ChangelogGenerator {\n  return {\n    async generate(plan, opts) {\n      const locale = (config.changelog?.locale as 'en' | 'ru') || 'en';\n      const packages: ChangelogPackageInfo[] = plan.packages.map(pkg => ({\n        name: pkg.name,\n        path: pkg.path,\n        currentVersion: pkg.currentVersion,\n        nextVersion: pkg.nextVersion,\n        bump: pkg.bump === 'auto' ? 'patch' : pkg.bump,\n      }));\n      try {\n        const result = await generateChangelog({\n          repoRoot: opts.repoRoot,\n          gitCwd: opts.gitCwd,\n          packages,\n          range: { to: 'HEAD' },\n          changelog: {\n            template: config.changelog?.template ?? undefined,\n            locale,\n            metadata: config.changelog?.metadata,\n            ignoreAuthors: config.changelog?.ignoreAuthors,\n            includeTypes: config.changelog?.includeTypes as string[],\n            excludeTypes: config.changelog?.excludeTypes as string[],\n            collapseMerges: config.changelog?.collapseMerges,\n            collapseReverts: config.changelog?.collapseReverts,\n            preferMergeSummary: config.changelog?.preferMergeSummary,\n          },\n          git: {\n            autoUnshallow: config.git?.autoUnshallow,\n            requireSignedTags: config.git?.requireSignedTags,\n            baseUrl: config.git?.baseUrl ?? undefined,\n          },\n          platform: llm ? { llm } : undefined,\n        });\n        return result.markdown;\n      } catch {\n        return generateSimpleChangelog(packages, locale);\n      }\n    },\n  };\n}\n","/**\n * Release changelog command — thin adapter over planRelease + createChangelogGenerator.\n */\n\nimport { join } from 'node:path';\nimport { stat, writeFile, mkdir, readFile } from 'node:fs/promises';\nimport { defineCommand, type CLIInput, type PluginContextV3, useLLM, useLoader, displayArtifacts, type ArtifactInfo, useConfig } from '@kb-labs/sdk';\nimport { planRelease, type ReleaseConfig } from '@kb-labs/release-manager-core';\nimport { findRepoRoot } from '../../shared/utils';\nimport { createChangelogGenerator } from '../../shared/changelog-factory';\n\ninterface ChangelogFlags {\n  scope?: string;\n  from?: string;\n  to?: string;\n  'since-tag'?: string;\n  format?: 'json' | 'md' | 'both';\n  level?: 'compact' | 'standard' | 'detailed';\n  template?: string;\n  'breaking-only'?: boolean;\n  json?: boolean;\n}\n\ninterface ReleaseChangelogResult {\n  exitCode: number;\n  artifacts?: Array<{ name: string; path: string; size: number }>;\n}\n\nexport default defineCommand({\n  id: 'release:changelog',\n  description: 'Generate changelog from conventional commits',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<ChangelogFlags>): Promise<ReleaseChangelogResult> {\n      const { flags } = input;\n      const cwd = ctx.cwd || process.cwd();\n      const repoRoot = await findRepoRoot(cwd);\n\n      // 1. Load config + discover packages\n      const loader = useLoader('Loading configuration...');\n      loader.start();\n\n      const fileConfig = await useConfig<ReleaseConfig>();\n      const config: ReleaseConfig = fileConfig ?? {};\n\n      loader.update({ text: 'Discovering packages...' });\n\n      const plan = await planRelease({ cwd: repoRoot, config, scope: flags.scope });\n\n      if (plan.packages.length === 0) {\n        loader.fail(`No packages found matching scope: ${flags.scope || 'all'}`);\n        return { exitCode: 1 };\n      }\n\n      // 2. Determine git working directory (for submodule support)\n      let gitCwd = repoRoot;\n      if (flags.scope && plan.packages[0]) {\n        try {\n          gitCwd = await findRepoRoot(plan.packages[0].path);\n        } catch {\n          gitCwd = plan.packages[0].path;\n        }\n      }\n\n      // 3. Generate changelog via shared factory\n      loader.update({ text: 'Generating changelog...' });\n\n      const llm = useLLM();\n      const generator = createChangelogGenerator(config, llm ?? undefined);\n      const markdown = await generator.generate(plan, { repoRoot, gitCwd, config });\n\n      const format = flags.format || config.changelog?.format || 'both';\n\n      // 4. Save artifacts\n      loader.update({ text: 'Saving artifacts...' });\n\n      const outputDir = join(repoRoot, '.kb', 'release');\n      const artifacts: ArtifactInfo[] = [];\n\n      if (!flags.json) {\n        await mkdir(outputDir, { recursive: true });\n\n        if (markdown && (format === 'md' || format === 'both')) {\n          const changelogPath = join(outputDir, 'CHANGELOG.md');\n\n          // Read existing and prepend new content (newest first)\n          let existing = '';\n          try {\n            existing = await readFile(changelogPath, 'utf-8');\n            const footerStart = existing.indexOf('\\n---\\n\\n*Generated automatically');\n            if (footerStart !== -1) {\n              existing = existing.substring(0, footerStart);\n            }\n          } catch { /* file doesn't exist yet */ }\n\n          const combined = existing ? `${markdown}\\n\\n${existing}` : markdown;\n          await writeFile(changelogPath, combined, 'utf-8');\n\n          const stats = await stat(changelogPath);\n          artifacts.push({\n            name: 'Changelog',\n            path: changelogPath,\n            size: stats.size,\n            modified: stats.mtime,\n            description: 'Generated changelog in Markdown format',\n          });\n        }\n      }\n\n      loader.succeed('Changelog generated successfully');\n\n      // 5. Output\n      if (flags.json) {\n        ctx.ui?.json?.({\n          packagesCount: plan.packages.length,\n          markdown: format === 'md' || format === 'both' ? markdown : undefined,\n          artifacts: artifacts.map(a => ({ name: a.name, path: a.path, size: a.size ?? 0 })),\n        });\n      } else {\n        const sections: Array<{ header?: string; items: string[] }> = [];\n\n        sections.push({\n          header: 'Summary',\n          items: [\n            `Packages: ${plan.packages.map(p => p.name).join(', ')}`,\n            `Format: ${format === 'both' ? 'Markdown + JSON' : format}`,\n          ],\n        });\n\n        if (artifacts.length > 0) {\n          const artifactsLines = displayArtifacts(artifacts, {\n            showSize: true,\n            showTime: true,\n            showDescription: true,\n            maxItems: 10,\n            title: '',\n          });\n          sections.push({ header: 'Artifacts', items: artifactsLines });\n        }\n\n        ctx.ui.sideBox({\n          title: 'Changelog Generated',\n          sections,\n          status: 'success',\n        });\n      }\n\n      return {\n        exitCode: 0,\n        artifacts: artifacts.map(a => ({ name: a.name, path: a.path, size: a.size ?? 0 })),\n      };\n    },\n  },\n});\n"]}

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,12 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+interface PlanFlags {
+    scope?: string;
+    bump?: 'patch' | 'minor' | 'major' | 'auto';
+    strict?: boolean;
+    json?: boolean;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<PlanFlags>, unknown>;
+
+export { _default as default };

package/dist/cli/commands/plan.js

@@ -0,0 +1,117 @@
+import { defineCommand, findRepoRoot, useLoader, useConfig, displayArtifacts } from '@kb-labs/sdk';
+import { planRelease } from '@kb-labs/release-manager-core';
+import 'path';
+import 'fs/promises';
+import 'globby';
+
+// src/cli/commands/plan.ts
+function scopeToDir(scope) {
+  return scope.replace(/^@/, "").replace(/\//g, "-").replace(/:/g, "-").replace(/\*/g, "");
+}
+
+// src/cli/commands/plan.ts
+var plan_default = defineCommand({
+  id: "release:plan",
+  description: "Analyze changes and prepare release plan",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const cwd = ctx.cwd || process.cwd();
+      const repoRoot = await findRepoRoot(cwd);
+      const configLoader = useLoader("Loading release configuration...");
+      configLoader.start();
+      const fileConfig = await useConfig();
+      const config = {
+        ...fileConfig,
+        ...flags.bump && { bump: flags.bump },
+        ...flags.strict !== void 0 && { strict: flags.strict }
+      };
+      configLoader.succeed("Configuration loaded");
+      const planLoader = useLoader("Discovering packages and planning release...");
+      planLoader.start();
+      const plan = await planRelease({
+        cwd: repoRoot,
+        config,
+        scope: flags.scope,
+        bumpOverride: flags.bump
+      });
+      if (plan.packages.length === 0) {
+        planLoader.fail(`No packages found matching scope: ${flags.scope || "all"}`);
+      } else {
+        planLoader.succeed(`Found ${plan.packages.length} package(s) to release`);
+      }
+      const scopeDir = scopeToDir(flags.scope ?? "root");
+      const planDir = ctx.runtime.fs.join(repoRoot, ".kb", "release", "plans", scopeDir, "current");
+      const planPath = ctx.runtime.fs.join(planDir, "plan.json");
+      const artifacts = [];
+      if (!flags.json) {
+        await ctx.runtime.fs.mkdir(planDir, { recursive: true });
+        await ctx.runtime.fs.writeFile(planPath, JSON.stringify(plan, null, 2), { encoding: "utf-8" });
+        const stats = await ctx.runtime.fs.stat(planPath);
+        artifacts.push({
+          name: "Release Plan",
+          path: planPath,
+          size: stats.size,
+          modified: new Date(stats.mtime),
+          description: "Detailed release plan (JSON)"
+        });
+      }
+      ctx.platform?.logger?.info?.("Release plan completed", {
+        packagesCount: plan.packages.length,
+        strategy: plan.strategy,
+        registry: plan.registry
+      });
+      if (flags.json) {
+        ctx.ui?.json?.(plan);
+      } else {
+        const sections = [];
+        sections.push({
+          header: "Summary",
+          items: [
+            `Strategy: ${plan.strategy}`,
+            `Registry: ${plan.registry}`,
+            `Packages: ${plan.packages.length}`
+          ]
+        });
+        if (plan.packages.length > 0) {
+          const packageItems = [];
+          for (const pkg of plan.packages) {
+            const versionInfo = pkg.currentVersion && pkg.nextVersion ? `${pkg.currentVersion} \u2192 ${pkg.nextVersion}` : pkg.nextVersion || "new";
+            packageItems.push(`${ctx.ui.symbols.success} ${pkg.name}: ${versionInfo}`);
+          }
+          sections.push({
+            header: "Packages to release",
+            items: packageItems
+          });
+        } else {
+          sections.push({
+            items: ["No packages to release"]
+          });
+        }
+        if (artifacts.length > 0) {
+          const artifactsLines = displayArtifacts(artifacts, {
+            showSize: true,
+            showTime: true,
+            showDescription: true,
+            maxItems: 10,
+            title: ""
+          });
+          sections.push({
+            header: "Artifacts",
+            items: artifactsLines
+          });
+        }
+        ctx.ui.sideBox({
+          title: "Release Plan",
+          sections,
+          status: "success"
+        });
+      }
+      return { exitCode: 0, plan };
+    }
+  }
+});
+
+export { plan_default as default };
+//# sourceMappingURL=plan.js.map
+//# sourceMappingURL=plan.js.map

package/dist/cli/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils.ts","../../../src/cli/commands/plan.ts"],"names":[],"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;;;ACqBA,IAAO,eAAQ,aAAA,CAAc;AAAA,EAC3B,EAAA,EAAI,cAAA;AAAA,EACJ,WAAA,EAAa,0CAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAwD;AAC1F,MAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AACnC,MAAA,MAAM,QAAA,GAAW,MAAM,YAAA,CAAa,GAAG,CAAA;AAGvC,MAAA,MAAM,YAAA,GAAe,UAAU,kCAAkC,CAAA;AACjE,MAAA,YAAA,CAAa,KAAA,EAAM;AAEnB,MAAA,MAAM,UAAA,GAAa,MAAM,SAAA,EAAyB;AAGlD,MAAA,MAAM,MAAA,GAAwB;AAAA,QAC5B,GAAG,UAAA;AAAA,QACH,GAAI,KAAA,CAAM,IAAA,IAAQ,EAAE,IAAA,EAAM,MAAM,IAAA,EAAK;AAAA,QACrC,GAAI,KAAA,CAAM,MAAA,KAAW,UAAa,EAAE,MAAA,EAAQ,MAAM,MAAA;AAAO,OAC3D;AAEA,MAAA,YAAA,CAAa,QAAQ,sBAAsB,CAAA;AAG3C,MAAA,MAAM,UAAA,GAAa,UAAU,8CAA8C,CAAA;AAC3E,MAAA,UAAA,CAAW,KAAA,EAAM;AAEjB,MAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY;AAAA,QAC7B,GAAA,EAAK,QAAA;AAAA,QACL,MAAA;AAAA,QACA,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,cAAc,KAAA,CAAM;AAAA,OACrB,CAAA;AAED,MAAA,IAAI,IAAA,CAAK,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG;AAC9B,QAAA,UAAA,CAAW,IAAA,CAAK,CAAA,kCAAA,EAAqC,KAAA,CAAM,KAAA,IAAS,KAAK,CAAA,CAAE,CAAA;AAAA,MAC7E,CAAA,MAAO;AACL,QAAA,UAAA,CAAW,OAAA,CAAQ,CAAA,MAAA,EAAS,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA,sBAAA,CAAwB,CAAA;AAAA,MAC1E;AAGA,MAAA,MAAM,QAAA,GAAW,UAAA,CAAW,KAAA,CAAM,KAAA,IAAS,MAAM,CAAA;AACjD,MAAA,MAAM,OAAA,GAAU,GAAA,CAAI,OAAA,CAAQ,EAAA,CAAG,IAAA,CAAK,UAAU,KAAA,EAAO,SAAA,EAAW,OAAA,EAAS,QAAA,EAAU,SAAS,CAAA;AAC5F,MAAA,MAAM,WAAW,GAAA,CAAI,OAAA,CAAQ,EAAA,CAAG,IAAA,CAAK,SAAS,WAAW,CAAA;AACzD,MAAA,MAAM,YAA4B,EAAC;AAEnC,MAAA,IAAI,CAAC,MAAM,IAAA,EAAM;AACf,QAAA,MAAM,GAAA,CAAI,QAAQ,EAAA,CAAG,KAAA,CAAM,SAAS,EAAE,SAAA,EAAW,MAAM,CAAA;AACvD,QAAA,MAAM,GAAA,CAAI,OAAA,CAAQ,EAAA,CAAG,SAAA,CAAU,UAAU,IAAA,CAAK,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,CAAC,CAAA,EAAG,EAAE,QAAA,EAAU,SAAS,CAAA;AAE7F,QAAA,MAAM,QAAQ,MAAM,GAAA,CAAI,OAAA,CAAQ,EAAA,CAAG,KAAK,QAAQ,CAAA;AAChD,QAAA,SAAA,CAAU,IAAA,CAAK;AAAA,UACb,IAAA,EAAM,cAAA;AAAA,UACN,IAAA,EAAM,QAAA;AAAA,UACN,MAAM,KAAA,CAAM,IAAA;AAAA,UACZ,QAAA,EAAU,IAAI,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAAA,UAC9B,WAAA,EAAa;AAAA,SACd,CAAA;AAAA,MACH;AAEA,MAAA,GAAA,CAAI,QAAA,EAAU,MAAA,EAAQ,IAAA,GAAO,wBAAA,EAA0B;AAAA,QACrD,aAAA,EAAe,KAAK,QAAA,CAAS,MAAA;AAAA,QAC7B,UAAU,IAAA,CAAK,QAAA;AAAA,QACf,UAAU,IAAA,CAAK;AAAA,OAChB,CAAA;AAED,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,OAAO,IAAI,CAAA;AAAA,MACrB,CAAA,MAAO;AACL,QAAA,MAAM,WAAwD,EAAC;AAG/D,QAAA,QAAA,CAAS,IAAA,CAAK;AAAA,UACZ,MAAA,EAAQ,SAAA;AAAA,UACR,KAAA,EAAO;AAAA,YACL,CAAA,UAAA,EAAa,KAAK,QAAQ,CAAA,CAAA;AAAA,YAC1B,CAAA,UAAA,EAAa,KAAK,QAAQ,CAAA,CAAA;AAAA,YAC1B,CAAA,UAAA,EAAa,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA;AAAA;AACnC,SACD,CAAA;AAGD,QAAA,IAAI,IAAA,CAAK,QAAA,CAAS,MAAA,GAAS,CAAA,EAAG;AAC5B,UAAA,MAAM,eAAyB,EAAC;AAChC,UAAA,KAAA,MAAW,GAAA,IAAO,KAAK,QAAA,EAAU;AAC/B,YAAA,MAAM,WAAA,GACJ,GAAA,CAAI,cAAA,IAAkB,GAAA,CAAI,WAAA,GACtB,CAAA,EAAG,GAAA,CAAI,cAAc,CAAA,QAAA,EAAM,GAAA,CAAI,WAAW,CAAA,CAAA,GAC1C,IAAI,WAAA,IAAe,KAAA;AACzB,YAAA,YAAA,CAAa,IAAA,CAAK,CAAA,EAAG,GAAA,CAAI,EAAA,CAAG,OAAA,CAAQ,OAAO,CAAA,CAAA,EAAI,GAAA,CAAI,IAAI,CAAA,EAAA,EAAK,WAAW,CAAA,CAAE,CAAA;AAAA,UAC3E;AACA,UAAA,QAAA,CAAS,IAAA,CAAK;AAAA,YACZ,MAAA,EAAQ,qBAAA;AAAA,YACR,KAAA,EAAO;AAAA,WACR,CAAA;AAAA,QACH,CAAA,MAAO;AACL,UAAA,QAAA,CAAS,IAAA,CAAK;AAAA,YACZ,KAAA,EAAO,CAAC,wBAAwB;AAAA,WACjC,CAAA;AAAA,QACH;AAGA,QAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG;AACxB,UAAA,MAAM,cAAA,GAAiB,iBAAiB,SAAA,EAAW;AAAA,YACjD,QAAA,EAAU,IAAA;AAAA,YACV,QAAA,EAAU,IAAA;AAAA,YACV,eAAA,EAAiB,IAAA;AAAA,YACjB,QAAA,EAAU,EAAA;AAAA,YACV,KAAA,EAAO;AAAA,WACR,CAAA;AACD,UAAA,QAAA,CAAS,IAAA,CAAK;AAAA,YACZ,MAAA,EAAQ,WAAA;AAAA,YACR,KAAA,EAAO;AAAA,WACR,CAAA;AAAA,QACH;AAEA,QAAA,GAAA,CAAI,GAAG,OAAA,CAAQ;AAAA,UACb,KAAA,EAAO,cAAA;AAAA,UACP,QAAA;AAAA,UACA,MAAA,EAAQ;AAAA,SACT,CAAA;AAAA,MACH;AAEA,MAAA,OAAO,EAAE,QAAA,EAAU,CAAA,EAAG,IAAA,EAAK;AAAA,IAC7B;AAAA;AAEJ,CAAC","file":"plan.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 * Release plan command\n */\n\nimport {\n  defineCommand,\n  type CLIInput,\n  type CommandResult,\n  type PluginContextV3,\n  useLoader,\n  displayArtifacts,\n  type ArtifactInfo,\n  useConfig,\n} from '@kb-labs/sdk';\nimport { planRelease, type VersionBump, type ReleaseConfig } from '@kb-labs/release-manager-core';\nimport { findRepoRoot, scopeToDir } from '../../shared/utils';\n\ninterface PlanFlags {\n  scope?: string;\n  bump?: 'patch' | 'minor' | 'major' | 'auto';\n  strict?: boolean;\n  json?: boolean;\n}\n\ntype ReleasePlanResult = CommandResult & {\n  plan?: {\n    strategy: string;\n    registry: string;\n    packages: Array<{\n      name: string;\n      currentVersion?: string;\n      nextVersion?: string;\n    }>;\n  };\n};\n\nexport default defineCommand({\n  id: 'release:plan',\n  description: 'Analyze changes and prepare release plan',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<PlanFlags>): Promise<ReleasePlanResult> {\n      const { flags } = input;\n      const cwd = ctx.cwd || process.cwd();\n      const repoRoot = await findRepoRoot(cwd);\n\n      // Load configuration\n      const configLoader = useLoader('Loading release configuration...');\n      configLoader.start();\n\n      const fileConfig = await useConfig<ReleaseConfig>();\n\n      // Merge CLI overrides\n      const config: ReleaseConfig = {\n        ...fileConfig,\n        ...(flags.bump && { bump: flags.bump }),\n        ...(flags.strict !== undefined && { strict: flags.strict }),\n      };\n\n      configLoader.succeed('Configuration loaded');\n\n      // Create release plan\n      const planLoader = useLoader('Discovering packages and planning release...');\n      planLoader.start();\n\n      const plan = await planRelease({\n        cwd: repoRoot,\n        config,\n        scope: flags.scope,\n        bumpOverride: flags.bump as VersionBump | undefined,\n      });\n\n      if (plan.packages.length === 0) {\n        planLoader.fail(`No packages found matching scope: ${flags.scope || 'all'}`);\n      } else {\n        planLoader.succeed(`Found ${plan.packages.length} package(s) to release`);\n      }\n\n      // Save plan to .kb/release/plans/{scope}/current/plan.json\n      const scopeDir = scopeToDir(flags.scope ?? 'root');\n      const planDir = ctx.runtime.fs.join(repoRoot, '.kb', 'release', 'plans', scopeDir, 'current');\n      const planPath = ctx.runtime.fs.join(planDir, 'plan.json');\n      const artifacts: ArtifactInfo[] = [];\n\n      if (!flags.json) {\n        await ctx.runtime.fs.mkdir(planDir, { recursive: true });\n        await ctx.runtime.fs.writeFile(planPath, JSON.stringify(plan, null, 2), { encoding: 'utf-8' });\n\n        const stats = await ctx.runtime.fs.stat(planPath);\n        artifacts.push({\n          name: 'Release Plan',\n          path: planPath,\n          size: stats.size,\n          modified: new Date(stats.mtime),\n          description: 'Detailed release plan (JSON)',\n        });\n      }\n\n      ctx.platform?.logger?.info?.('Release plan completed', {\n        packagesCount: plan.packages.length,\n        strategy: plan.strategy,\n        registry: plan.registry,\n      });\n\n      if (flags.json) {\n        ctx.ui?.json?.(plan);\n      } else {\n        const sections: Array<{ header?: string; items: string[] }> = [];\n\n        // Summary\n        sections.push({\n          header: 'Summary',\n          items: [\n            `Strategy: ${plan.strategy}`,\n            `Registry: ${plan.registry}`,\n            `Packages: ${plan.packages.length}`,\n          ],\n        });\n\n        // Packages section\n        if (plan.packages.length > 0) {\n          const packageItems: string[] = [];\n          for (const pkg of plan.packages) {\n            const versionInfo =\n              pkg.currentVersion && pkg.nextVersion\n                ? `${pkg.currentVersion} → ${pkg.nextVersion}`\n                : pkg.nextVersion || 'new';\n            packageItems.push(`${ctx.ui.symbols.success} ${pkg.name}: ${versionInfo}`);\n          }\n          sections.push({\n            header: 'Packages to release',\n            items: packageItems,\n          });\n        } else {\n          sections.push({\n            items: ['No packages to release'],\n          });\n        }\n\n        // Artifacts section\n        if (artifacts.length > 0) {\n          const artifactsLines = displayArtifacts(artifacts, {\n            showSize: true,\n            showTime: true,\n            showDescription: true,\n            maxItems: 10,\n            title: '',\n          });\n          sections.push({\n            header: 'Artifacts',\n            items: artifactsLines,\n          });\n        }\n\n        ctx.ui.sideBox({\n          title: 'Release Plan',\n          sections,\n          status: 'success',\n        });\n      }\n\n      return { exitCode: 0, plan };\n    },\n  },\n});\n"]}

package/dist/cli/commands/publish.d.ts

@@ -0,0 +1,15 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+interface PublishFlags {
+    scope?: string;
+    otp?: string;
+    'dry-run'?: boolean;
+    tag?: string;
+    access?: string;
+    token?: string;
+    json?: boolean;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<PublishFlags>, unknown>;
+
+export { _default as default };