@mannyc1/ts-release 0.0.2 → 0.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mannyc1/ts-release",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "packageManager": "bun@1.3.14",
   "description": "Plan-first release orchestration with explicit validation, evidence, and execution gates.",
@@ -24,28 +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"
-    },
     "./config/errors": {
       "types": "./dist/config/errors.d.ts",
       "default": "./dist/config/errors.js"
@@ -122,6 +111,10 @@
       "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"
@@ -130,10 +123,6 @@
       "types": "./dist/planner/status.d.ts",
       "default": "./dist/planner/status.js"
     },
-    "./runtime/bun": {
-      "types": "./dist/runtime/bun.d.ts",
-      "default": "./dist/runtime/bun.js"
-    },
     "./targets/adapter": {
       "types": "./dist/targets/adapter.d.ts",
       "default": "./dist/targets/adapter.js"
@@ -166,6 +155,10 @@
       "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"
@@ -174,6 +167,14 @@
       "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"
@@ -183,6 +184,7 @@
     "ARCHITECTURE.md",
     "dist",
     "examples",
+    "templates",
     "SPEC.md",
     "README.md"
   ],
@@ -198,18 +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",
-    "release:artifacts": "bun run scripts/build-release-artifacts.ts",
-    "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}"
+}

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

@@ -0,0 +1,39 @@
+{
+  "$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"
+    }
+  ],
+  "strict": true,
+  "evidenceDirectory": ".release/evidence/{version}"
+}

package/dist/cli/command.d.ts

@@ -1,4 +0,0 @@
-import * as Command from "effect/unstable/cli/Command";
-export type * from "../types/effect-internal.js";
-export declare const cli: Command.Command<"release", {}, {}, import("effect/PlatformError").PlatformError | import("../config/errors.js").ConfigReadError | import("../config/errors.js").ConfigParseError | import("../config/errors.js").ConfigValidationError | import("../domain/operation.js").ExecutionApprovalError | import("../planner/errors.js").ReleaseNormalizationError | import("../planner/errors.js").PlanConstructionError | import("../planner/errors.js").EvidenceWriteError | import("../planner/errors.js").EvidenceReadError | import("../planner/errors.js").WorkspaceWriteError | import("../planner/errors.js").ResumeBlockedError | import("../planner/errors.js").RemoteStateInspectionError | import("../planner/errors.js").ReleaseEligibilityCheckError | import("../planner/errors.js").ReconciliationBlockedError | import("../planner/errors.js").OperationFailedError | import("../targets/registry.js").MissingTargetAdapterError | import("../host/host.js").CommandRunnerError, never>;
-//# sourceMappingURL=command.d.ts.map

package/dist/cli/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAA;AAqCtD,mBAAmB,6BAA6B,CAAA;AAiQhD,eAAO,MAAM,GAAG,o8BAcf,CAAA"}