@mannyc1/ts-release 0.0.1 → 0.0.3

package/examples/multi-target/release.config.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
   "identity": {
     "name": "release-example-multi-target",
     "version": "0.1.0",
@@ -36,8 +37,16 @@
       "_tag": "NpmRegistryTarget",
       "id": "npm",
       "registry": "https://registry.npmjs.org",
+      "packageName": "release-example-multi-target",
       "packagePath": ".",
-      "tokenEnv": "NPM_TOKEN",
+      "trustedPublishing": {
+        "provider": "github-actions",
+        "workflow": "release.yml",
+        "packageExists": true,
+        "verifyPackageExists": true
+      },
+      "access": "public",
+      "provenance": true,
       "dryRunSupport": "native",
       "mutability": "immutable",
       "recovery": "publish-new-version"

package/examples/non-strict-skips/release.config.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
   "identity": {
     "name": "release-example-skips",
     "version": "0.1.0",

package/examples/npm-first-publish/release.config.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
+  "identity": {
+    "name": "@scope/release-example-first",
+    "version": "0.1.0",
+    "commit": "example",
+    "tag": "v0.1.0"
+  },
+  "artifacts": [
+    {
+      "id": "package",
+      "path": ".",
+      "format": "directory",
+      "consumers": ["npm"]
+    }
+  ],
+  "targets": [
+    {
+      "_tag": "NpmRegistryTarget",
+      "id": "npm",
+      "registry": "https://registry.npmjs.org",
+      "packageName": "@scope/release-example-first",
+      "packagePath": ".",
+      "tokenEnv": "NPM_TOKEN",
+      "access": "public",
+      "dryRunSupport": "native",
+      "mutability": "immutable",
+      "recovery": "publish-new-version"
+    }
+  ],
+  "strict": true,
+  "evidenceDirectory": ".release/evidence"
+}

package/examples/npm-only/release.config.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
   "identity": {
     "name": "release-example-npm-only",
     "version": "0.1.0",
@@ -18,8 +19,16 @@
       "_tag": "NpmRegistryTarget",
       "id": "npm",
       "registry": "https://registry.npmjs.org",
+      "packageName": "release-example-npm-only",
       "packagePath": ".",
-      "tokenEnv": "NPM_TOKEN",
+      "trustedPublishing": {
+        "provider": "github-actions",
+        "workflow": "release.yml",
+        "packageExists": true,
+        "verifyPackageExists": true
+      },
+      "access": "public",
+      "provenance": true,
       "dryRunSupport": "native",
       "mutability": "immutable",
       "recovery": "publish-new-version"

package/examples/pypi-registry/release.config.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
   "identity": {
     "name": "release-example-pypi",
     "version": "0.1.0",

package/examples/scoop-bucket/release.config.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
   "identity": {
     "name": "release-example-scoop",
     "version": "0.1.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mannyc1/ts-release",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "packageManager": "bun@1.3.14",
   "description": "Plan-first release orchestration with explicit validation, evidence, and execution gates.",
@@ -24,32 +24,17 @@
     "bun",
     "cli"
   ],
+  "workspaces": [
+    "apps/*"
+  ],
   "engines": {
     "bun": ">=1.3.14"
   },
-  "bin": {
-    "release": "dist/cli/main.js"
-  },
-  "sideEffects": [
-    "./dist/cli/main.js"
-  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./cli": {
-      "types": "./dist/cli/command.d.ts",
-      "default": "./dist/cli/command.js"
-    },
-    "./cli/command": {
-      "types": "./dist/cli/command.d.ts",
-      "default": "./dist/cli/command.js"
-    },
-    "./cli/programmatic": {
-      "types": "./dist/cli/programmatic.d.ts",
-      "default": "./dist/cli/programmatic.js"
-    },
     "./config/errors": {
       "types": "./dist/config/errors.d.ts",
       "default": "./dist/config/errors.js"
@@ -78,6 +63,10 @@
       "types": "./dist/domain/release.d.ts",
       "default": "./dist/domain/release.js"
     },
+    "./domain/status": {
+      "types": "./dist/domain/status.d.ts",
+      "default": "./dist/domain/status.js"
+    },
     "./domain/target": {
       "types": "./dist/domain/target.d.ts",
       "default": "./dist/domain/target.js"
@@ -86,10 +75,6 @@
       "types": "./dist/host/host.d.ts",
       "default": "./dist/host/host.js"
     },
-    "./host/bun": {
-      "types": "./dist/host/bun.d.ts",
-      "default": "./dist/host/bun.js"
-    },
     "./host/http": {
       "types": "./dist/host/http.d.ts",
       "default": "./dist/host/http.js"
@@ -98,6 +83,10 @@
       "types": "./dist/host/http-live.d.ts",
       "default": "./dist/host/http-live.js"
     },
+    "./host/platform": {
+      "types": "./dist/host/platform.d.ts",
+      "default": "./dist/host/platform.js"
+    },
     "./host/test": {
       "types": "./dist/host/test.d.ts",
       "default": "./dist/host/test.js"
@@ -122,10 +111,18 @@
       "types": "./dist/planner/normalize-release.d.ts",
       "default": "./dist/planner/normalize-release.js"
     },
+    "./planner/release-eligibility": {
+      "types": "./dist/planner/release-eligibility.d.ts",
+      "default": "./dist/planner/release-eligibility.js"
+    },
     "./planner/render-plan": {
       "types": "./dist/planner/render-plan.d.ts",
       "default": "./dist/planner/render-plan.js"
     },
+    "./planner/status": {
+      "types": "./dist/planner/status.d.ts",
+      "default": "./dist/planner/status.js"
+    },
     "./targets/adapter": {
       "types": "./dist/targets/adapter.d.ts",
       "default": "./dist/targets/adapter.js"
@@ -157,11 +154,37 @@
     "./targets/scoop": {
       "types": "./dist/targets/scoop.d.ts",
       "default": "./dist/targets/scoop.js"
+    },
+    "./workflows": {
+      "types": "./dist/workflows/index.d.ts",
+      "default": "./dist/workflows/index.js"
+    },
+    "./workflows/config": {
+      "types": "./dist/workflows/config.d.ts",
+      "default": "./dist/workflows/config.js"
+    },
+    "./workflows/evidence": {
+      "types": "./dist/workflows/evidence.d.ts",
+      "default": "./dist/workflows/evidence.js"
+    },
+    "./workflows/diagnostics": {
+      "types": "./dist/workflows/diagnostics.d.ts",
+      "default": "./dist/workflows/diagnostics.js"
+    },
+    "./workflows/init": {
+      "types": "./dist/workflows/init.d.ts",
+      "default": "./dist/workflows/init.js"
+    },
+    "./workflows/live": {
+      "types": "./dist/workflows/live.d.ts",
+      "default": "./dist/workflows/live.js"
     }
   },
   "files": [
+    "ARCHITECTURE.md",
     "dist",
     "examples",
+    "templates",
     "SPEC.md",
     "README.md"
   ],
@@ -177,17 +200,23 @@
     "check:tree-shaking": "bun run scripts/check-tree-shaking.ts",
     "check:examples": "bun run scripts/check-examples.ts",
     "check:readme": "bun run scripts/check-readme.ts",
-    "check:self-release-config": "bun run scripts/check-self-release-config.ts",
-    "check:portable": "bun run check && bun test && bun audit && bun run check:effect-imports && bun run check:tree-shaking && bun run build && bun run check:examples && bun run check:readme && bun run check:package-exports && bun dist/cli/main.js --help",
+    "check:self-release-config": "bun run apps/release-ts/scripts/check-self-release-config.ts",
+    "check:action-bundle": "bun run scripts/check-action-bundle.ts",
+    "check:core": "bun run check && bun test && bun audit && bun run check:effect-imports && bun run check:tree-shaking && bun run build && bun run check:examples && bun run check:readme && bun run check:package-exports",
+    "check:app": "bun run --cwd apps/release-ts check && bun test test/cli-command.test.ts",
+    "check:action": "bun run --cwd apps/ts-release-action check && bun run check:action-bundle && bun test test/action-command.test.ts",
+    "check:portable": "bun run check:core && bun run check:app && bun run check:action",
     "check:release": "bun run check:self-release-config && bun run check:portable",
-    "cli": "bun run src/cli/main.ts"
+    "release:artifacts": "bun run apps/release-ts/scripts/build-release-artifacts.ts",
+    "cli": "bun run apps/release-ts/src/cli/main.ts"
   },
   "dependencies": {
-    "@effect/platform-bun": "4.0.0-beta.83",
     "effect": "4.0.0-beta.83"
   },
   "devDependencies": {
+    "@effect/platform-bun": "4.0.0-beta.83",
     "@types/bun": "^1.3.14",
+    "bun-types": "^1.3.14",
     "typescript": "^6.0.3"
   }
 }

package/templates/README.md

@@ -0,0 +1,54 @@
+# Release Templates
+
+Templates are copyable starting points for new repositories. They use
+placeholder names and may reference artifacts that you still need to build.
+The checked-in JSON templates are the same policy shape produced by `release
+init`.
+
+After copying a template, preview the release plan first:
+
+```sh
+bun run cli plan --config release.config.json --format text
+```
+
+Runnable fixtures live in `examples/`; templates are for authoring your own
+`release.config.json`.
+
+The CLI can preview or write these configs:
+
+```sh
+bun run cli init --template npm-github --package @scope/pkg --repo owner/repo
+bun run cli init --template npm-github --package @scope/pkg --repo owner/repo --github-actions --write
+```
+
+Available config templates:
+
+- `npm-only`: existing npm package with GitHub Actions trusted publishing.
+- `npm-github`: npm plus GitHub Releases.
+- `multi-target-homebrew`: npm, GitHub Releases, and a Homebrew tap.
+- `multi-target-scoop`: npm, GitHub Releases, and a Scoop bucket.
+
+The npm templates enable provenance, require `packageExists: true`, and set
+`verifyPackageExists: true` so planning includes a read-only `npm view` check
+before trusted publishing.
+
+GitHub Actions templates are action-first:
+
+- `github-actions/plan-only.yml`
+- `github-actions/plan-and-approved-execute.yml`
+- `github-actions/trusted-publishing.yml`
+
+They use `mannyc2/ts-release-action@v1`; the action source lives in this repo at
+`apps/ts-release-action` until the first action release is cut or mirrored.
+The action currently defaults to `runtime: bundled`.
+
+The trusted-publishing templates do not use `NPM_TOKEN`; configure npm trusted
+publishing and a protected GitHub environment named `release` before approving
+the execute job.
+
+After writing a workflow, run static diagnostics before executing a release:
+
+```sh
+bun run cli doctor --config release.config.json --format text
+bun run cli check-ci --config release.config.json --workflow .github/workflows/release.yml --format markdown
+```

package/templates/github-actions/plan-and-approved-execute.yml

@@ -0,0 +1,53 @@
+name: Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  plan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - uses: mannyc2/ts-release-action@v1
+        with:
+          command: plan
+          config: release.config.json
+          format: markdown
+          write-step-summary: true
+          plan-path: release-plan.md
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: release-plan
+          path: |
+            release-plan.md
+            .release/evidence/
+
+  execute:
+    needs: plan
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - run: bun run build
+      - uses: mannyc2/ts-release-action@v1
+        with:
+          command: run
+          config: release.config.json
+          execute: true
+          approve-irreversible: true
+          write-step-summary: true
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: release-evidence
+          path: .release/evidence/

package/templates/github-actions/plan-only.yml

@@ -0,0 +1,30 @@
+name: Release Plan
+
+on:
+  workflow_dispatch:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  plan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - uses: mannyc2/ts-release-action@v1
+        with:
+          command: plan
+          config: release.config.json
+          format: markdown
+          write-step-summary: true
+          plan-path: release-plan.md
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: release-plan
+          path: |
+            release-plan.md
+            .release/evidence/

package/templates/github-actions/trusted-publishing.yml

@@ -0,0 +1,59 @@
+name: Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  plan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - uses: mannyc2/ts-release-action@v1
+        with:
+          command: plan
+          config: release.config.json
+          format: markdown
+          write-step-summary: true
+          plan-path: release-plan.md
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: release-plan
+          path: |
+            release-plan.md
+            .release/evidence/
+
+  execute:
+    needs: plan
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.14.0
+          registry-url: https://registry.npmjs.org
+      - run: npm install -g npm@^11.5.1
+      - run: bun install --frozen-lockfile
+      - run: bun run build
+      - uses: mannyc2/ts-release-action@v1
+        with:
+          command: run
+          config: release.config.json
+          execute: true
+          approve-irreversible: true
+          write-step-summary: true
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: release-evidence
+          path: .release/evidence/

package/templates/multi-target-homebrew/release.config.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
+  "identity": {
+    "name": "@scope/pkg",
+    "version": "0.1.0",
+    "commit": "abc123",
+    "tag": "v0.1.0"
+  },
+  "artifacts": [
+    {
+      "id": "package",
+      "path": ".",
+      "format": "directory",
+      "consumers": ["npm"]
+    },
+    {
+      "id": "archive",
+      "path": "artifacts/pkg-0.1.0.tgz",
+      "format": "tarball",
+      "consumers": ["github", "homebrew"]
+    }
+  ],
+  "targets": [
+    {
+      "_tag": "NpmRegistryTarget",
+      "id": "npm",
+      "registry": "https://registry.npmjs.org",
+      "packageName": "@scope/pkg",
+      "packagePath": ".",
+      "trustedPublishing": {
+        "provider": "github-actions",
+        "workflow": "release.yml",
+        "packageExists": true,
+        "verifyPackageExists": true
+      },
+      "access": "public",
+      "provenance": true,
+      "dryRunSupport": "native",
+      "mutability": "immutable",
+      "recovery": "publish-new-version"
+    },
+    {
+      "_tag": "GitHubReleaseTarget",
+      "id": "github",
+      "repository": "owner/repo",
+      "tokenEnv": "GH_TOKEN",
+      "draft": true,
+      "prerelease": false,
+      "dryRunSupport": "simulated",
+      "mutability": "mutable-release",
+      "recovery": "delete-and-recreate"
+    },
+    {
+      "_tag": "HomebrewTapTarget",
+      "id": "homebrew",
+      "repository": "owner/homebrew-tap",
+      "formulaName": "pkg",
+      "formulaPath": ".release/generated/pkg.rb",
+      "artifactId": "archive",
+      "homepage": "https://github.com/owner/repo",
+      "url": "https://github.com/owner/repo/releases/download/v0.1.0/pkg-0.1.0.tgz",
+      "installPath": "bin/pkg",
+      "dryRunSupport": "simulated",
+      "mutability": "mutable-index",
+      "recovery": "manual"
+    }
+  ],
+  "strict": true,
+  "evidenceDirectory": ".release/evidence/{version}"
+}

package/templates/multi-target-scoop/release.config.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
+  "identity": {
+    "name": "@scope/pkg",
+    "version": "0.1.0",
+    "commit": "abc123",
+    "tag": "v0.1.0"
+  },
+  "artifacts": [
+    {
+      "id": "package",
+      "path": ".",
+      "format": "directory",
+      "consumers": ["npm"]
+    },
+    {
+      "id": "archive",
+      "path": "artifacts/pkg-0.1.0.zip",
+      "format": "zip",
+      "consumers": ["github", "scoop"]
+    }
+  ],
+  "targets": [
+    {
+      "_tag": "NpmRegistryTarget",
+      "id": "npm",
+      "registry": "https://registry.npmjs.org",
+      "packageName": "@scope/pkg",
+      "packagePath": ".",
+      "trustedPublishing": {
+        "provider": "github-actions",
+        "workflow": "release.yml",
+        "packageExists": true,
+        "verifyPackageExists": true
+      },
+      "access": "public",
+      "provenance": true,
+      "dryRunSupport": "native",
+      "mutability": "immutable",
+      "recovery": "publish-new-version"
+    },
+    {
+      "_tag": "GitHubReleaseTarget",
+      "id": "github",
+      "repository": "owner/repo",
+      "tokenEnv": "GH_TOKEN",
+      "draft": true,
+      "prerelease": false,
+      "dryRunSupport": "simulated",
+      "mutability": "mutable-release",
+      "recovery": "delete-and-recreate"
+    },
+    {
+      "_tag": "ScoopBucketTarget",
+      "id": "scoop",
+      "repository": "owner/scoop-bucket",
+      "manifestName": "pkg",
+      "manifestPath": ".release/generated/pkg.json",
+      "artifactId": "archive",
+      "homepage": "https://github.com/owner/repo",
+      "description": "Example Scoop manifest for pkg",
+      "license": "MIT",
+      "url": "https://github.com/owner/repo/releases/download/v0.1.0/pkg-0.1.0.zip",
+      "bin": "pkg.exe",
+      "dryRunSupport": "simulated",
+      "mutability": "mutable-index",
+      "recovery": "manual"
+    }
+  ],
+  "strict": true,
+  "evidenceDirectory": ".release/evidence/{version}"
+}

package/templates/npm-github/release.config.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://mannyc2.github.io/ts-release/schema/release-config.schema.json",
+  "identity": {
+    "name": "@scope/pkg",
+    "version": "0.1.0",
+    "commit": "abc123",
+    "tag": "v0.1.0"
+  },
+  "artifacts": [
+    {
+      "id": "package",
+      "path": ".",
+      "format": "directory",
+      "consumers": ["npm"]
+    }
+  ],
+  "targets": [
+    {
+      "_tag": "NpmRegistryTarget",
+      "id": "npm",
+      "registry": "https://registry.npmjs.org",
+      "packageName": "@scope/pkg",
+      "packagePath": ".",
+      "trustedPublishing": {
+        "provider": "github-actions",
+        "workflow": "release.yml",
+        "packageExists": true,
+        "verifyPackageExists": true
+      },
+      "access": "public",
+      "provenance": true,
+      "dryRunSupport": "native",
+      "mutability": "immutable",
+      "recovery": "publish-new-version"
+    },
+    {
+      "_tag": "GitHubReleaseTarget",
+      "id": "github",
+      "repository": "owner/repo",
+      "tokenEnv": "GH_TOKEN",
+      "draft": true,
+      "prerelease": false,
+      "dryRunSupport": "simulated",
+      "mutability": "mutable-release",
+      "recovery": "delete-and-recreate"
+    }
+  ],
+  "strict": true,
+  "evidenceDirectory": ".release/evidence/{version}"
+}