pi-release 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZachDreamZ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# pi-release
+
+> Pi-native release automation: bump version, generate changelog, create GitHub release, publish to npm.
+
+## Installation
+
+```bash
+pi install npm:pi-release
+```
+
+## What It Does
+
+pi-release automates the full release lifecycle for pi.dev packages. It completes the pipeline:
+
+```
+pi-commit-lint → pi-changelog → pi-release
+```
+
+Three focused tools and one orchestrated `/release` command handle:
+- **Version bumping** — semver-aware `package.json` updates with git commits and tags
+- **GitHub releases** — auto-generated release notes via GitHub CLI
+- **npm publishing** — with OTP/2FA support and custom registries
+
+## Tools
+
+### `bump_version`
+
+Bump the version in `package.json`, create a git commit and tag.
+
+```
+bump_version(bump: "patch" | "minor" | "major", pre_release?: "beta", dry_run?: false)
+```
+
+**Parameters:**
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `bump` | `major \| minor \| patch` | `patch` | Version bump type |
+| `pre_release` | `string` | — | Pre-release tag (e.g. `beta`, `alpha`, `rc`) |
+| `dry_run` | `boolean` | `false` | Preview without making changes |
+| `message` | `string` | `chore(release): {version}` | Custom commit message |
+
+### `create_github_release`
+
+Create a GitHub release from a git tag.
+
+```
+create_github_release(tag: "v1.0.0", title?: "Release v1.0.0", notes?: "...", prerelease?: false, dry_run?: false)
+```
+
+**Parameters:**
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `tag` | `string` | *required* | Git tag to release from |
+| `title` | `string` | `Release {tag}` | Release title |
+| `notes` | `string` | *auto-generated* | Custom release notes |
+| `prerelease` | `boolean` | `false` | Mark as pre-release |
+| `dry_run` | `boolean` | `false` | Preview without creating |
+
+Requires [GitHub CLI](https://cli.github.com/) (`gh`) installed and authenticated.
+
+### `publish_npm`
+
+Publish the package to npm.
+
+```
+publish_npm(otp?: "123456", registry?: "https://...", tag?: "beta", dry_run?: false)
+```
+
+**Parameters:**
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `otp` | `string` | — | One-time password for npm 2FA |
+| `registry` | `string` | `https://registry.npmjs.org/` | npm registry URL |
+| `tag` | `string` | `latest` | npm dist-tag |
+| `dry_run` | `boolean` | `false` | Preview without publishing |
+
+## Command
+
+### `/release`
+
+Orchestrates the full release flow:
+
+```
+/release [major|minor|patch] [--dry-run]
+```
+
+**Steps:**
+1. 📦 Bump version in `package.json`, commit, tag
+2. 📝 Generate changelog from conventional commits
+3. 🚀 Create GitHub release with auto-generated notes
+4. 📤 Publish to npm
+
+```bash
+# Preview a patch release
+/release patch --dry-run
+
+# Execute a minor release
+/release minor
+
+# Major release
+/release major
+```
+
+## Configuration
+
+Create `pi-release.json` in your project root:
+
+```json
+{
+  "registry": "https://registry.npmjs.org/",
+  "githubRepo": "owner/repo",
+  "defaultBump": "patch",
+  "preReleaseTag": "",
+  "generateChangelog": true,
+  "commitBump": true,
+  "commitMessage": "chore(release): {version}",
+  "createTag": true,
+  "tagPrefix": "v",
+  "createGithubRelease": true,
+  "publishToNpm": true
+}
+```
+
+**Config options:**
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `registry` | `string` | `https://registry.npmjs.org/` | npm registry URL |
+| `githubRepo` | `string \| null` | `null` (auto-detect) | GitHub `owner/repo` |
+| `defaultBump` | `string` | `patch` | Default bump type for `/release` |
+| `preReleaseTag` | `string` | `""` | Pre-release tag applied to all releases |
+| `generateChangelog` | `boolean` | `true` | Auto-generate changelog |
+| `commitBump` | `boolean` | `true` | Commit the version bump |
+| `commitMessage` | `string` | `chore(release): {version}` | Commit message template |
+| `createTag` | `boolean` | `true` | Create git tag |
+| `tagPrefix` | `string` | `v` | Tag prefix (e.g. `v1.0.0`) |
+| `createGithubRelease` | `boolean` | `true` | Create GitHub release |
+| `publishToNpm` | `boolean` | `true` | Publish to npm |
+
+## Dry Run
+
+All tools support `--dry-run` mode to preview what would happen without making any changes:
+
+```bash
+# Via tool
+bump_version(bump="minor", dry_run=true)
+
+# Via command
+/release minor --dry-run
+```
+
+## Example Workflow
+
+```bash
+# 1. Ensure commits follow conventional format
+pi> /lint-commits
+
+# 2. Preview the release
+pi> /release minor --dry-run
+
+# 3. Execute the release
+pi> /release minor
+
+# Output:
+# 📦 Version Bump: 1.0.0 → 1.1.0
+# 📝 Changelog generated
+# 🚀 GitHub Release: https://github.com/owner/repo/releases/tag/v1.1.0
+# 📤 Published to npm: my-package@1.1.0
+# ✅ Release complete!
+```
+
+## Resources
+
+- [npm](https://www.npmjs.com/package/pi-release)
+- [GitHub](https://github.com/ZachDreamZ/pi-release)
+- [pi.dev](https://pi.dev/packages/pi-release)
+
+## License
+
+MIT

package/biome.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.7.0/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedVariables": "warn"
+      }
+    }
+  },
+  "files": {
+    "include": ["extensions/**/*.ts"],
+    "ignore": ["node_modules", "dist"]
+  }
+}

package/extensions/index.test.ts

@@ -0,0 +1,398 @@
+import { execSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+	bumpSemver,
+	bumpVersionImpl,
+	createGithubReleaseImpl,
+	generateBasicChangelog,
+	parseGithubRepo,
+	publishNpmImpl,
+} from "./index.js";
+
+// ── Helpers ─────────────────────────────────────────────────────────
+
+function createTmpGitRepo(): string {
+	const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "release-test-"));
+	execSync("git init", { cwd: tmpDir, stdio: "pipe" });
+	execSync("git config user.email test@test.com", {
+		cwd: tmpDir,
+		stdio: "pipe",
+	});
+	execSync("git config user.name Test", { cwd: tmpDir, stdio: "pipe" });
+
+	// Create initial package.json
+	const pkg = {
+		name: "test-package",
+		version: "1.0.0",
+		description: "Test package",
+	};
+	fs.writeFileSync(
+		path.join(tmpDir, "package.json"),
+		`${JSON.stringify(pkg, null, 2)}\n`,
+		"utf-8",
+	);
+
+	execSync("git add .", { cwd: tmpDir, stdio: "pipe" });
+	execSync('git commit -m "feat: initial commit"', {
+		cwd: tmpDir,
+		stdio: "pipe",
+	});
+
+	return tmpDir;
+}
+
+function commit(dir: string, message: string, file = "test.txt"): void {
+	const filePath = path.join(dir, file);
+	fs.writeFileSync(filePath, `${message}\n`, "utf-8");
+	execSync(`git add ${file}`, { cwd: dir, stdio: "pipe" });
+	execSync(`git commit -m "${message}"`, { cwd: dir, stdio: "pipe" });
+}
+
+function tag(dir: string, tagName: string): void {
+	execSync(`git tag ${tagName}`, { cwd: dir, stdio: "pipe" });
+}
+
+// ── bumpSemver tests ────────────────────────────────────────────────
+
+describe("bumpSemver", () => {
+	it("should bump patch version", () => {
+		expect(bumpSemver("1.0.0", "patch")).toBe("1.0.1");
+	});
+
+	it("should bump minor version", () => {
+		expect(bumpSemver("1.0.0", "minor")).toBe("1.1.0");
+	});
+
+	it("should bump major version", () => {
+		expect(bumpSemver("1.0.0", "major")).toBe("2.0.0");
+	});
+
+	it("should reset lower segments on major bump", () => {
+		expect(bumpSemver("1.2.3", "major")).toBe("2.0.0");
+	});
+
+	it("should reset patch on minor bump", () => {
+		expect(bumpSemver("1.2.3", "minor")).toBe("1.3.0");
+	});
+
+	it("should handle large version numbers", () => {
+		expect(bumpSemver("9.9.9", "patch")).toBe("9.9.10");
+		expect(bumpSemver("9.9.9", "minor")).toBe("9.10.0");
+		expect(bumpSemver("9.9.9", "major")).toBe("10.0.0");
+	});
+
+	it("should throw on invalid semver", () => {
+		expect(() => bumpSemver("invalid", "patch")).toThrow(
+			"Invalid semver version",
+		);
+		expect(() => bumpSemver("1.2", "patch")).toThrow("Invalid semver version");
+		expect(() => bumpSemver("1.2.x", "patch")).toThrow(
+			"Invalid semver version",
+		);
+	});
+});
+
+// ── parseGithubRepo tests ───────────────────────────────────────────
+
+describe("parseGithubRepo", () => {
+	it("should parse SSH remote", () => {
+		expect(parseGithubRepo("git@github.com:owner/repo.git")).toBe("owner/repo");
+	});
+
+	it("should parse HTTPS remote with .git", () => {
+		expect(parseGithubRepo("https://github.com/owner/repo.git")).toBe(
+			"owner/repo",
+		);
+	});
+
+	it("should parse HTTPS remote without .git", () => {
+		expect(parseGithubRepo("https://github.com/owner/repo")).toBe("owner/repo");
+	});
+
+	it("should return null for non-GitHub remotes", () => {
+		expect(parseGithubRepo("https://gitlab.com/owner/repo.git")).toBeNull();
+		expect(parseGithubRepo("git@gitlab.com:owner/repo.git")).toBeNull();
+	});
+});
+
+// ── bumpVersionImpl tests ───────────────────────────────────────────
+
+describe("bumpVersionImpl", () => {
+	let tmpDir: string;
+
+	beforeEach(() => {
+		tmpDir = createTmpGitRepo();
+	});
+
+	afterEach(() => {
+		fs.rmSync(tmpDir, { recursive: true, force: true });
+	});
+
+	it("should bump patch version by default", () => {
+		const result = bumpVersionImpl("patch", { cwd: tmpDir });
+		expect(result.previousVersion).toBe("1.0.0");
+		expect(result.newVersion).toBe("1.0.1");
+		expect(result.tag).toBe("v1.0.1");
+		expect(result.dryRun).toBe(false);
+		expect(result.commitHash).toBeTruthy();
+	});
+
+	it("should bump minor version", () => {
+		const result = bumpVersionImpl("minor", { cwd: tmpDir });
+		expect(result.newVersion).toBe("1.1.0");
+		expect(result.tag).toBe("v1.1.0");
+	});
+
+	it("should bump major version", () => {
+		const result = bumpVersionImpl("major", { cwd: tmpDir });
+		expect(result.newVersion).toBe("2.0.0");
+		expect(result.tag).toBe("v2.0.0");
+	});
+
+	it("should add pre-release tag", () => {
+		const result = bumpVersionImpl("patch", {
+			cwd: tmpDir,
+			preReleaseTag: "beta",
+		});
+		expect(result.newVersion).toBe("1.0.1-beta");
+		expect(result.tag).toBe("v1.0.1-beta");
+	});
+
+	it("should write new version to package.json", () => {
+		bumpVersionImpl("minor", { cwd: tmpDir });
+		const pkg = JSON.parse(
+			fs.readFileSync(path.join(tmpDir, "package.json"), "utf-8"),
+		);
+		expect(pkg.version).toBe("1.1.0");
+	});
+
+	it("should create git tag", () => {
+		bumpVersionImpl("patch", { cwd: tmpDir });
+		const tags = execSync("git tag", { cwd: tmpDir, encoding: "utf-8" }).trim();
+		expect(tags).toContain("v1.0.1");
+	});
+
+	it("should not modify files in dry run mode", () => {
+		const result = bumpVersionImpl("major", { cwd: tmpDir, dryRun: true });
+		expect(result.dryRun).toBe(true);
+		expect(result.commitHash).toBeNull();
+
+		// Verify package.json unchanged
+		const pkg = JSON.parse(
+			fs.readFileSync(path.join(tmpDir, "package.json"), "utf-8"),
+		);
+		expect(pkg.version).toBe("1.0.0");
+	});
+
+	it("should throw if working directory is dirty", () => {
+		fs.writeFileSync(path.join(tmpDir, "dirty.txt"), "dirty", "utf-8");
+		expect(() => bumpVersionImpl("patch", { cwd: tmpDir })).toThrow(
+			"uncommitted changes",
+		);
+	});
+
+	it("should throw if tag already exists", () => {
+		tag(tmpDir, "v1.0.1");
+		expect(() => bumpVersionImpl("patch", { cwd: tmpDir })).toThrow(
+			"already exists",
+		);
+	});
+
+	it("should use custom tag prefix", () => {
+		const result = bumpVersionImpl("patch", {
+			cwd: tmpDir,
+			tagPrefix: "release-",
+		});
+		expect(result.tag).toBe("release-1.0.1");
+	});
+
+	it("should use custom commit message", () => {
+		const result = bumpVersionImpl("patch", {
+			cwd: tmpDir,
+			commitMessage: "release: v{version}",
+		});
+		expect(result.commitHash).toBeTruthy();
+
+		const lastMsg = execSync("git log -1 --format=%s", {
+			cwd: tmpDir,
+			encoding: "utf-8",
+		}).trim();
+		expect(lastMsg).toBe("release: v1.0.1");
+	});
+});
+
+// ── generateBasicChangelog tests ────────────────────────────────────
+
+describe("generateBasicChangelog", () => {
+	let tmpDir: string;
+
+	beforeEach(() => {
+		tmpDir = createTmpGitRepo();
+	});
+
+	afterEach(() => {
+		fs.rmSync(tmpDir, { recursive: true, force: true });
+	});
+
+	it("should generate changelog for initial commit", () => {
+		const result = generateBasicChangelog("1.0.0", tmpDir);
+		expect(result).toContain("# Changelog");
+		expect(result).toContain("[1.0.0]");
+		expect(result).toContain("initial commit");
+	});
+
+	it("should group commits by type", () => {
+		commit(tmpDir, "feat: add login", "login.txt");
+		commit(tmpDir, "fix: fix crash", "fix.txt");
+		commit(tmpDir, "docs: update README", "docs.txt");
+
+		const result = generateBasicChangelog("1.1.0", tmpDir);
+		expect(result).toContain("Features");
+		expect(result).toContain("Bug Fixes");
+		expect(result).toContain("Documentation");
+	});
+
+	it("should detect breaking changes", () => {
+		commit(tmpDir, "feat!: redesign API", "api.txt");
+
+		const result = generateBasicChangelog("2.0.0", tmpDir);
+		expect(result).toContain("BREAKING CHANGES");
+		expect(result).toContain("redesign API");
+	});
+
+	it("should handle scoped commits", () => {
+		commit(tmpDir, "feat(auth): add OAuth", "auth.txt");
+
+		const result = generateBasicChangelog("1.1.0", tmpDir);
+		expect(result).toContain("**auth:**");
+		expect(result).toContain("add OAuth");
+	});
+
+	it("should handle empty history gracefully", () => {
+		// Create a fresh repo with no commits beyond initial
+		const emptyDir = fs.mkdtempSync(path.join(os.tmpdir(), "changelog-empty-"));
+		execSync("git init", { cwd: emptyDir, stdio: "pipe" });
+		execSync("git config user.email test@test.com", {
+			cwd: emptyDir,
+			stdio: "pipe",
+		});
+		execSync("git config user.name Test", { cwd: emptyDir, stdio: "pipe" });
+
+		const result = generateBasicChangelog("0.0.1", emptyDir);
+		expect(result).toContain("# Changelog");
+		expect(result).toContain("No commits found");
+
+		fs.rmSync(emptyDir, { recursive: true, force: true });
+	});
+
+	it("should limit to commits since last tag", () => {
+		commit(tmpDir, "feat: first", "a.txt");
+		tag(tmpDir, "v1.0.0");
+		commit(tmpDir, "feat: second", "b.txt");
+		commit(tmpDir, "fix: third", "c.txt");
+
+		const result = generateBasicChangelog("1.1.0", tmpDir);
+		// Should only contain commits after v1.0.0
+		expect(result).toContain("second");
+		expect(result).toContain("third");
+		expect(result).not.toContain("first");
+	});
+});
+
+// ── createGithubReleaseImpl tests ───────────────────────────────────
+
+describe("createGithubReleaseImpl", () => {
+	let tmpDir: string;
+
+	beforeEach(() => {
+		tmpDir = createTmpGitRepo();
+		// Add a GitHub remote so the function can detect the repo
+		execSync(
+			"git remote add origin https://github.com/test-owner/test-repo.git",
+			{ cwd: tmpDir, stdio: "pipe" },
+		);
+		tag(tmpDir, "v1.0.0");
+	});
+
+	afterEach(() => {
+		fs.rmSync(tmpDir, { recursive: true, force: true });
+	});
+
+	it("should return dry run result without executing", () => {
+		const result = createGithubReleaseImpl("v1.0.0", {
+			cwd: tmpDir,
+			dryRun: true,
+		});
+		expect(result.dryRun).toBe(true);
+		expect(result.tag).toBe("v1.0.0");
+		expect(result.url).toContain("test-owner/test-repo");
+		expect(result.url).toContain("v1.0.0");
+	});
+
+	it("should throw if tag does not exist (non-dry-run)", () => {
+		expect(() =>
+			createGithubReleaseImpl("v9.9.9", { cwd: tmpDir, dryRun: false }),
+		).toThrow("does not exist");
+	});
+});
+
+// ── publishNpmImpl tests ────────────────────────────────────────────
+
+describe("publishNpmImpl", () => {
+	let tmpDir: string;
+
+	beforeEach(() => {
+		tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "publish-test-"));
+		const pkg = {
+			name: "test-pi-release-pkg",
+			version: "1.0.0",
+		};
+		fs.writeFileSync(
+			path.join(tmpDir, "package.json"),
+			JSON.stringify(pkg, null, 2),
+			"utf-8",
+		);
+	});
+
+	afterEach(() => {
+		fs.rmSync(tmpDir, { recursive: true, force: true });
+	});
+
+	it("should return dry run result", () => {
+		const result = publishNpmImpl({ cwd: tmpDir, dryRun: true });
+		expect(result.dryRun).toBe(true);
+		expect(result.package).toBe("test-pi-release-pkg");
+		expect(result.version).toBe("1.0.0");
+	});
+
+	it("should use custom registry", () => {
+		const result = publishNpmImpl({
+			cwd: tmpDir,
+			dryRun: true,
+			registry: "https://custom.registry.com/",
+		});
+		expect(result.registry).toBe("https://custom.registry.com/");
+	});
+});
+
+// ── Extension registration tests ────────────────────────────────────
+
+describe("extension registration", () => {
+	it("should export a default function", async () => {
+		const mod = await import("./index.js");
+		expect(typeof mod.default).toBe("function");
+	});
+
+	it("should export helper functions directly", async () => {
+		const mod = await import("./index.js");
+		expect(typeof mod.bumpSemver).toBe("function");
+		expect(typeof mod.bumpVersionImpl).toBe("function");
+		expect(typeof mod.createGithubReleaseImpl).toBe("function");
+		expect(typeof mod.publishNpmImpl).toBe("function");
+		expect(typeof mod.generateBasicChangelog).toBe("function");
+		expect(typeof mod.parseGithubRepo).toBe("function");
+	});
+});