@releasekit/publish 0.3.0 → 0.4.0

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+
+declare function createPublishCommand(): Command;
+
+export { createPublishCommand };

package/dist/cli.js

@@ -1 +1,81 @@
 #!/usr/bin/env node
+import {
+  BasePublishError,
+  EXIT_CODES,
+  PipelineError,
+  loadConfig,
+  parseInput,
+  readPackageVersion,
+  runPipeline,
+  setJsonMode,
+  setLogLevel
+} from "./chunk-ZMMZ7S6G.js";
+
+// src/cli.ts
+import { realpathSync } from "fs";
+import { fileURLToPath } from "url";
+import { Command } from "commander";
+function createPublishCommand() {
+  return new Command("publish").description("Publish packages to registries with git tagging and GitHub releases").option("--input <path>", "Path to version output JSON (default: stdin)").option("--config <path>", "Path to releasekit config").option("--registry <type>", "Registry to publish to (npm, cargo, all)", "all").option("--npm-auth <method>", "NPM auth method (oidc, token, auto)", "auto").option("--dry-run", "Simulate all operations", false).option("--skip-git", "Skip git commit/tag/push", false).option("--skip-publish", "Skip registry publishing", false).option("--skip-github-release", "Skip GitHub Release creation", false).option("--skip-verification", "Skip post-publish verification", false).option("--json", "Output results as JSON", false).option("--verbose", "Verbose logging", false).action(async (options) => {
+    if (options.verbose) setLogLevel("debug");
+    if (options.json) setJsonMode(true);
+    try {
+      const config = loadConfig({ configPath: options.config });
+      const input = await parseInput(options.input);
+      if (options.npmAuth !== "auto") {
+        config.npm.auth = options.npmAuth;
+      }
+      const cliOptions = {
+        input: options.input,
+        config: options.config,
+        registry: options.registry,
+        npmAuth: options.npmAuth,
+        dryRun: options.dryRun,
+        skipGit: options.skipGit,
+        skipPublish: options.skipPublish,
+        skipGithubRelease: options.skipGithubRelease,
+        skipVerification: options.skipVerification,
+        json: options.json,
+        verbose: options.verbose
+      };
+      const output = await runPipeline(input, config, cliOptions);
+      if (options.json) {
+        console.log(JSON.stringify(output, null, 2));
+      }
+    } catch (err) {
+      if (err instanceof PipelineError && options.json) {
+        console.log(
+          JSON.stringify(
+            {
+              error: err.message,
+              failedStage: err.failedStage,
+              partialOutput: err.partialOutput
+            },
+            null,
+            2
+          )
+        );
+        process.exit(EXIT_CODES.PUBLISH_ERROR);
+      }
+      if (BasePublishError.isPublishError(err)) {
+        err.logError();
+        process.exit(EXIT_CODES.PUBLISH_ERROR);
+      }
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+  });
+}
+var isMain = (() => {
+  try {
+    return process.argv[1] ? realpathSync(process.argv[1]) === fileURLToPath(import.meta.url) : false;
+  } catch {
+    return false;
+  }
+})();
+if (isMain) {
+  createPublishCommand().name("releasekit-publish").version(readPackageVersion(import.meta.url)).parse();
+}
+export {
+  createPublishCommand
+};

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { getDefaultConfig, loadConfig } from './config.ts';
+export { BasePublishError, PipelineError, PublishError, PublishErrorCode, createPublishError } from './errors/index.ts';
+export { runPipeline } from './pipeline/index.ts';
+export { parseInput } from './stages/input.ts';
+export { CargoConfig, GitConfig, GitHubReleaseConfig, GitHubReleaseResult, GitResult, NpmConfig, PipelineContext, PublishCliOptions, PublishConfig, PublishOutput, PublishResult, VerificationResult, VerifyConfig } from './types.ts';
+export { detectNpmAuth, hasCargoAuth } from './utils/auth.ts';
+export { CargoManifest, extractPathDeps, parseCargoToml, updateCargoVersion } from './utils/cargo.ts';
+export { PackageManager, detectPackageManager } from './utils/package-manager.ts';
+export { getDistTag, isPrerelease } from './utils/semver.ts';

package/dist/index.js

@@ -0,0 +1,38 @@
+import {
+  BasePublishError,
+  PipelineError,
+  PublishError,
+  PublishErrorCode,
+  createPublishError,
+  detectNpmAuth,
+  detectPackageManager,
+  extractPathDeps,
+  getDefaultConfig,
+  getDistTag,
+  hasCargoAuth,
+  isPrerelease,
+  loadConfig,
+  parseCargoToml,
+  parseInput,
+  runPipeline,
+  updateCargoVersion
+} from "./chunk-ZMMZ7S6G.js";
+export {
+  BasePublishError,
+  PipelineError,
+  PublishError,
+  PublishErrorCode,
+  createPublishError,
+  detectNpmAuth,
+  detectPackageManager,
+  extractPathDeps,
+  getDefaultConfig,
+  getDistTag,
+  hasCargoAuth,
+  isPrerelease,
+  loadConfig,
+  parseCargoToml,
+  parseInput,
+  runPipeline,
+  updateCargoVersion
+};

package/docs/github-releases.md

@@ -0,0 +1,177 @@
+# GitHub Releases
+
+`@releasekit/publish` creates a GitHub Release for each published package. This guide covers configuration options and how to use LLM-generated prose as the release body.
+
+## Enabling GitHub Releases
+
+GitHub Releases are enabled by default. Requires `GITHUB_TOKEN` with `contents: write` permission.
+
+```json
+{
+  "publish": {
+    "githubRelease": {
+      "enabled": true
+    }
+  }
+}
+```
+
+To disable:
+
+```json
+{
+  "publish": {
+    "githubRelease": { "enabled": false }
+  }
+}
+```
+
+---
+
+## Release Body (`body`)
+
+Controls what appears in the GitHub Release description.
+
+| Value | Behaviour |
+|-------|-----------|
+| `"auto"` (default) | Use LLM release notes if available, otherwise changelog entries, otherwise GitHub auto-generated notes |
+| `"releaseNotes"` | Use LLM-generated prose release notes (requires `notes.releaseNotes.llm.tasks.releaseNotes: true`) |
+| `"changelog"` | Use the formatted changelog entries for this version |
+| `"generated"` | GitHub's auto-generated release notes (from merged PRs and commits) |
+| `"none"` | No release body |
+
+```json
+{
+  "publish": {
+    "githubRelease": {
+      "body": "releaseNotes"
+    }
+  }
+}
+```
+
+---
+
+## Using LLM-Generated Release Notes
+
+To populate the GitHub Release body with LLM-written prose:
+
+**1. Enable the `releaseNotes` LLM task in notes config:**
+
+```json
+{
+  "notes": {
+    "releaseNotes": {
+      "llm": {
+        "provider": "openai",
+        "model": "gpt-4o-mini",
+        "tasks": { "releaseNotes": true }
+      }
+    }
+  },
+  "publish": {
+    "githubRelease": {
+      "body": "releaseNotes"
+    }
+  }
+}
+```
+
+The notes step runs first, the LLM generates prose release notes, and the publish step forwards them to the GitHub Release API.
+
+If `body` is `"auto"` (default), LLM release notes are used automatically when available — no extra config needed.
+
+**2. Optionally write release notes to a file** as well:
+
+```json
+{
+  "notes": {
+    "releaseNotes": {
+      "mode": "root",
+      "llm": {
+        "provider": "anthropic",
+        "model": "claude-haiku-4-5",
+        "tasks": { "releaseNotes": true }
+      }
+    }
+  }
+}
+```
+
+When `mode` is set, a `RELEASE_NOTES.md` file is written in addition to the GitHub Release being populated.
+
+---
+
+## Draft Releases
+
+Releases are created as drafts by default, giving you a chance to review before publishing.
+
+```json
+{
+  "publish": {
+    "githubRelease": {
+      "draft": true
+    }
+  }
+}
+```
+
+Set `"draft": false` to publish releases immediately.
+
+---
+
+## Prerelease Marking
+
+```json
+{
+  "publish": {
+    "githubRelease": {
+      "prerelease": "auto"
+    }
+  }
+}
+```
+
+| Value | Behaviour |
+|-------|-----------|
+| `"auto"` (default) | Marked as prerelease when the version contains a prerelease identifier (e.g. `1.0.0-beta.1`) |
+| `true` | Always marked as prerelease |
+| `false` | Never marked as prerelease |
+
+---
+
+## Per-Package Releases
+
+In a monorepo, a separate GitHub Release is created for each published package by default.
+
+```json
+{
+  "publish": {
+    "githubRelease": {
+      "perPackage": true
+    }
+  }
+}
+```
+
+Set `"perPackage": false` to create a single release for the entire repo.
+
+---
+
+## Full Configuration Reference
+
+```json
+{
+  "publish": {
+    "githubRelease": {
+      "enabled": true,
+      "draft": true,
+      "prerelease": "auto",
+      "perPackage": true,
+      "body": "auto"
+    }
+  }
+}
+```
+
+See the [@releasekit/publish README](../README.md) for all options.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@releasekit/publish",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Publish packages to npm and crates.io with git tagging and GitHub releases",
   "type": "module",
   "module": "./dist/index.js",
@@ -41,6 +41,7 @@
   "license": "MIT",
   "files": [
     "dist",
+    "docs",
     "README.md",
     "LICENSE"
   ],