@mannyc1/ts-release 0.0.7 → 0.2.2

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@mannyc1/ts-release",
-  "version": "0.0.7",
+  "version": "0.2.2",
   "type": "module",
   "packageManager": "bun@1.3.14",
-  "description": "Portable artifact and package-manager distribution planning for TypeScript projects.",
+  "description": "Prepare, publish, observe, and safely resume npm, PyPI, GitHub, Homebrew, and Scoop releases.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -28,201 +28,105 @@
     "apps/*"
   ],
   "engines": {
-    "bun": ">=1.3.14"
+    "bun": ">=1.3.14",
+    "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+  },
+  "bin": {
+    "ts-release": "./dist/bin/ts-release.js"
   },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./artifacts/adapter": {
-      "types": "./dist/artifacts/adapter.d.ts",
-      "default": "./dist/artifacts/adapter.js"
-    },
-    "./artifacts/registry": {
-      "types": "./dist/artifacts/registry.d.ts",
-      "default": "./dist/artifacts/registry.js"
-    },
-    "./config/errors": {
-      "types": "./dist/config/errors.d.ts",
-      "default": "./dist/config/errors.js"
-    },
-    "./config/load": {
-      "types": "./dist/config/load.d.ts",
-      "default": "./dist/config/load.js"
-    },
-    "./config/schema": {
-      "types": "./dist/config/schema.d.ts",
-      "default": "./dist/config/schema.js"
+    "./node": {
+      "types": "./dist/platform/node.d.ts",
+      "default": "./dist/platform/node.js"
     },
-    "./domain/artifact": {
-      "types": "./dist/domain/artifact.d.ts",
-      "default": "./dist/domain/artifact.js"
+    "./bun": {
+      "types": "./dist/platform/bun.d.ts",
+      "default": "./dist/platform/bun.js"
     },
-    "./domain/evidence": {
-      "types": "./dist/domain/evidence.d.ts",
-      "default": "./dist/domain/evidence.js"
-    },
-    "./domain/operation": {
-      "types": "./dist/domain/operation.d.ts",
-      "default": "./dist/domain/operation.js"
-    },
-    "./domain/release": {
-      "types": "./dist/domain/release.d.ts",
-      "default": "./dist/domain/release.js"
-    },
-    "./domain/target": {
-      "types": "./dist/domain/target.d.ts",
-      "default": "./dist/domain/target.js"
+    "./store": {
+      "types": "./dist/store.d.ts",
+      "default": "./dist/store.js"
     },
     "./host": {
-      "types": "./dist/host/host.d.ts",
-      "default": "./dist/host/host.js"
-    },
-    "./host/http": {
-      "types": "./dist/host/http.d.ts",
-      "default": "./dist/host/http.js"
-    },
-    "./host/http-live": {
-      "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"
-    },
-    "./planner/create-release-plan": {
-      "types": "./dist/planner/create-release-plan.d.ts",
-      "default": "./dist/planner/create-release-plan.js"
-    },
-    "./planner/errors": {
-      "types": "./dist/planner/errors.d.ts",
-      "default": "./dist/planner/errors.js"
-    },
-    "./planner/evidence-recorder": {
-      "types": "./dist/planner/evidence-recorder.d.ts",
-      "default": "./dist/planner/evidence-recorder.js"
-    },
-    "./planner/executor": {
-      "types": "./dist/planner/executor.d.ts",
-      "default": "./dist/planner/executor.js"
-    },
-    "./planner/normalize-release": {
-      "types": "./dist/planner/normalize-release.d.ts",
-      "default": "./dist/planner/normalize-release.js"
-    },
-    "./planner/render-plan": {
-      "types": "./dist/planner/render-plan.d.ts",
-      "default": "./dist/planner/render-plan.js"
+      "types": "./dist/host.d.ts",
+      "default": "./dist/host.js"
     },
-    "./targets/adapter": {
-      "types": "./dist/targets/adapter.d.ts",
-      "default": "./dist/targets/adapter.js"
-    },
-    "./targets/github": {
-      "types": "./dist/targets/github.d.ts",
-      "default": "./dist/targets/github.js"
-    },
-    "./targets/homebrew": {
-      "types": "./dist/targets/homebrew.d.ts",
-      "default": "./dist/targets/homebrew.js"
-    },
-    "./targets/live": {
-      "types": "./dist/targets/live.d.ts",
-      "default": "./dist/targets/live.js"
-    },
-    "./targets/npm": {
-      "types": "./dist/targets/npm.d.ts",
-      "default": "./dist/targets/npm.js"
-    },
-    "./targets/pypi": {
-      "types": "./dist/targets/pypi.d.ts",
-      "default": "./dist/targets/pypi.js"
-    },
-    "./targets/registry": {
-      "types": "./dist/targets/registry.d.ts",
-      "default": "./dist/targets/registry.js"
-    },
-    "./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/distribution": {
-      "types": "./dist/workflows/distribution.d.ts",
-      "default": "./dist/workflows/distribution.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"
+    "./provider-sdk": {
+      "types": "./dist/provider-sdk.d.ts",
+      "default": "./dist/provider-sdk.js"
     }
   },
   "files": [
     "ARCHITECTURE.md",
+    "CHANGELOG.md",
+    "apps/release-ts/src",
     "dist",
     "examples",
+    "apps/ts-release-agents",
+    "src",
     "templates",
     "SPEC.md",
     "README.md"
   ],
   "scripts": {
     "check": "tsc --noEmit",
-    "build": "bun run scripts/clean-dist.ts && tsc -p tsconfig.build.json",
+    "build": "bun -e \"await (await import('node:fs/promises')).rm('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json && bun run scripts/build-cli-bundle.ts",
     "test": "bun test",
-    "test:integration:tools": "RELEASE_INTEGRATION_TOOLS=1 bun test integration-tools.test.ts",
-    "test:integration:github": "RELEASE_INTEGRATION_TOOLS=1 RELEASE_INTEGRATION_GITHUB=1 bun test integration-tools.test.ts",
     "test:coverage": "bun test --coverage",
     "check:package-exports": "bun run scripts/check-package-exports.ts",
-    "check:effect-imports": "bun run scripts/check-effect-imports.ts",
+    "check:packed-consumers": "bun run scripts/check-packed-consumers.ts",
+    "check:import-rules": "bun run scripts/check-import-rules.ts",
     "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 apps/release-ts/scripts/check-self-release-config.ts",
-    "check:self-release-ci": "bun run cli check-ci --config apps/release-ts/release.config.json --workflow .github/workflows/release.yml --format text",
-    "check:self-release-live": "bun run apps/release-ts/scripts/check-self-release-live-readiness.ts",
+    "check:self-release-context": "bun run apps/release-ts/scripts/check-self-release-context.ts",
+    "check:self-release-prepare": "bun run apps/release-ts/scripts/check-self-release-prepare.ts",
+    "check:self-release-reproducibility": "bun run apps/release-ts/scripts/check-self-release-reproducibility.ts",
+    "check:self-release-readiness": "bun run apps/release-ts/scripts/check-self-release-readiness.ts",
     "check:self-release-artifacts": "bun run apps/release-ts/scripts/check-self-release-artifacts.ts",
+    "check:self-release-correction": "bun run apps/release-ts/scripts/check-self-release-correction.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:self-release-ci && bun run check:portable",
-    "release:artifacts": "bun run cli stage-artifacts --config apps/release-ts/release.config.json --format text",
-    "release:catalogs": "bun run cli render --config apps/release-ts/release.config.json --execute",
+    "check:cli-bundle": "bun run scripts/check-cli-bundle.ts",
+    "check:config-schema": "bun run scripts/check-config-schema.ts",
+    "check:capabilities": "bun run scripts/check-capabilities.ts",
+    "check:recovery-docs": "bun run scripts/check-recovery-docs.ts",
+    "check:feature-translation": "bun run scripts/check-feature-translation.ts",
+    "generate:capabilities": "bun run scripts/generate-capabilities.ts",
+    "generate:recovery-docs": "bun run scripts/generate-recovery-docs.ts",
+    "generate:config-schema": "bun run scripts/generate-config-schema.ts",
+    "build:agents": "bun run apps/ts-release-agents/src/build.ts",
+    "check:agents": "bun run --cwd apps/ts-release-agents check && bun run --cwd apps/ts-release-agents build && bun run --cwd apps/ts-release-agents check:generated && bun test ./apps/ts-release-agents/test/contract.test.ts",
+    "check:core": "bun run check:versions && bun run check:capabilities && bun run check:recovery-docs && bun run check:feature-translation && bun run check:import-rules && bun run check:tree-shaking && bun run check && bun test && bun run build && bun run check:cli-bundle && bun run check:config-schema && bun run check:examples && bun run check:readme && bun run check:package-exports && bun run check:packed-consumers",
+    "check:versions": "bun run scripts/check-versions.ts",
+    "check:summary": "bun run scripts/run-gates.ts",
+    "measure:release-candidate": "bun run scripts/measure-release-candidate.ts",
+    "replay:provider-reads": "bun run scripts/replay-provider-reads.ts",
+    "check:app": "bun run --cwd apps/release-ts check && bun test test/core/cli-cutover.test.ts test/cli-command.test.ts",
+    "check:action": "bun run --cwd apps/ts-release-action check && bun run check:action-bundle && bun test test/core/action-cutover.test.ts test/action-command.test.ts test/action-launcher.test.ts test/action-artifact-bridge.test.ts",
+    "check:portable": "bun run check:core && bun run check:agents && bun run check:app && bun run check:action",
+    "check:release-candidate": "bun run build && bun run check:self-release-context && bun run check:self-release-prepare && bun run check:self-release-reproducibility && bun run check:self-release-readiness && bun run check:self-release-artifacts && bun run check:self-release-correction && bun run check:portable",
     "cli": "bun run apps/release-ts/src/cli/main.ts"
   },
   "dependencies": {
-    "effect": "4.0.0-beta.83",
+    "@effect/platform-node-shared": "4.0.0-beta.83",
     "semver": "^7.8.5"
   },
+  "peerDependencies": {
+    "@effect/platform-bun": "4.0.0-beta.83",
+    "@effect/platform-node": "4.0.0-beta.83",
+    "effect": "4.0.0-beta.83"
+  },
   "devDependencies": {
     "@effect/bun-test": "file:vendor/effect-bun-test",
     "@effect/platform-bun": "4.0.0-beta.83",
+    "@effect/platform-node": "4.0.0-beta.83",
     "@types/bun": "^1.3.14",
     "@types/semver": "^7.7.1",
+    "effect": "4.0.0-beta.83",
     "bun-types": "^1.3.14",
     "typescript": "^6.0.3"
   }

package/src/api/api.ts

@@ -0,0 +1,365 @@
+import * as Cause from "effect/Cause"
+import * as Effect from "effect/Effect"
+import * as ManagedRuntime from "effect/ManagedRuntime"
+import { decodeConfig } from "../config/config.js"
+import { releaseIdentityCapability } from "../capabilities/registry.js"
+import { secretPatterns } from "../model/secret-patterns.js"
+import { CredentialProvider } from "../publication/authority.js"
+import { AuthorizedMutationHttp, HttpAuthorizer } from "../publication/http.js"
+import { bindAuthoredCorrection, correctPreparedRelease } from "../correction/coordinator.js"
+import { NonEmptyName, SafeRelativePath, Version, WorkspaceRoot } from "../model/primitives.js"
+import {
+  observePreparedRelease,
+  publishPreparedRelease
+} from "../publication/adapter.js"
+import { SafeReason } from "../publication/report.js"
+import { compileReleaseGraph } from "../release/compiler.js"
+import type { VerifiedReleaseContext } from "../release/context.js"
+import { inspectPreparedRelease, inspectRelease } from "../release/inspect.js"
+import { prepareRelease } from "../release/prepare.js"
+import { PreparationError } from "../release/prepare.js"
+import type { CompletePreparedReleaseRef } from "../release/prepared-ref.js"
+import {
+  PreparedReleaseStore,
+  type CommittedPreparedRelease
+} from "../release/prepared-store.js"
+import { ObservedFacts } from "../resolve/facts.js"
+import {
+  PreparationModeUnsupported,
+  ReleaseAbortedError,
+  ReleaseInputError,
+  ReleasePreparationError
+} from "./errors.js"
+import {
+  decodeCorrectInput,
+  decodeInspectInput,
+  decodeObserveInput,
+  decodePrepareInput,
+  decodePublishInput,
+  decodeReleaseInput,
+  workspaceRoot
+} from "./input.js"
+import { ReleaseRuntime } from "./runtime.js"
+import {
+  CorrectionReport,
+  type CorrectInput,
+  type InspectInput,
+  type ObserveInput,
+  type PrepareInput,
+  type PublishInput,
+  type ReleaseApi,
+  type ReleaseApiLayer,
+  type ReleaseApiOptions,
+  type ReleaseApiServices,
+  type ReleaseInput
+} from "./types.js"
+
+export type {
+  CorrectInput,
+  InspectInput,
+  ObserveInput,
+  PrepareInput,
+  PublishInput,
+  ReleaseApi,
+  ReleaseApiLayer,
+  ReleaseApiOptions,
+  ReleaseInput
+} from "./types.js"
+export { CorrectionReport } from "./types.js"
+export { ReleaseInputError } from "./errors.js"
+export { ReleaseRuntime } from "./runtime.js"
+
+const safeFailure = (failure: unknown, fallback: string): string => {
+  const value = typeof failure === "object" && failure !== null &&
+      "reason" in failure && typeof failure.reason === "string"
+    ? failure.reason
+    : failure instanceof Error
+    ? failure.message
+    : typeof failure === "string"
+    ? failure
+    : fallback
+  const normalized = [...value]
+    .map((character) => {
+      const codePoint = character.codePointAt(0) ?? 0
+      return codePoint === 9 || codePoint === 10 || codePoint === 13 || codePoint >= 0x20
+        ? character
+        : "?"
+    })
+    .slice(0, 2048)
+    .join("")
+  return normalized.length === 0 || secretPatterns.some((pattern) => pattern.test(normalized))
+    ? fallback
+    : normalized
+}
+
+const inputFailure = (cause: unknown): ReleaseInputError => new ReleaseInputError({
+  reason: safeFailure(cause, "Release input is invalid.")
+})
+
+const manifestPath = (config: {
+  readonly npmPackage?: { readonly path?: SafeRelativePath }
+}): SafeRelativePath => {
+  const directory = String(config.npmPackage?.path ?? ".")
+  return SafeRelativePath.make(directory === "." ? "package.json" : `${directory}/package.json`)
+}
+
+const releaseTagVersion = (
+  tags: ReadonlyArray<{ toString(): string }>
+): string | undefined => {
+  const values = tags
+    .map((tag) => /^v?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)$/u.exec(tag.toString())?.[1])
+    .filter((value): value is string => value !== undefined)
+  return values.length === 1 ? values[0] : undefined
+}
+
+const observeAndCompile = Effect.fn("observeAndCompileRelease")(function*(input: {
+  readonly config: unknown
+  readonly workspace: string
+}) {
+  const runtime = yield* ReleaseRuntime
+  const authored = yield* decodeConfig(input.config).pipe(Effect.mapError(inputFailure))
+  const root = yield* Effect.try({
+    try: () => workspaceRoot(input.workspace),
+    catch: inputFailure
+  })
+  const context = yield* runtime.source.observe(
+    WorkspaceRoot.make(root),
+    manifestPath(authored)
+  )
+  const observedTagVersion = releaseTagVersion(context.source.headTags)
+  const facts = ObservedFacts.make({
+    commit: context.source.commit,
+    manifestName: context.package.name,
+    manifestVersion: context.package.version,
+    ...(observedTagVersion === undefined
+      ? {}
+      : { headTagVersion: Version.make(observedTagVersion) }),
+    ...(context.source.repository === undefined
+      ? {}
+      : { repository: context.source.repository })
+  })
+  const resolved = yield* Effect.try({
+    try: () => releaseIdentityCapability.resolve(input.config, facts),
+    catch: inputFailure
+  })
+  const graph = yield* Effect.try({
+    try: () => compileReleaseGraph(resolved, context),
+    catch: inputFailure
+  })
+  return {
+    context,
+    config: resolved,
+    graph
+  }
+})
+
+const prepareProgram = Effect.fn("prepareProgram")(function*(
+  input: PrepareInput,
+  options: { readonly allowEmpty: boolean }
+) {
+  const compiled = yield* observeAndCompile({
+    config: input.config,
+    workspace: input.workspace
+  })
+  if (!options.allowEmpty &&
+      compiled.graph.artifacts.length === 0 &&
+      compiled.graph.publications.length === 0) {
+    return yield* new ReleaseInputError({
+      reason: "release resolved to no artifacts and no publication subjects; use allowEmpty only for an explicit diagnostic run."
+    })
+  }
+  const runtime = yield* ReleaseRuntime
+  const store = yield* PreparedReleaseStore
+  const sourceWorkspace = compiled.context.workspace
+  return yield* prepareRelease({
+    context: compiled.context,
+    graph: compiled.graph,
+    store,
+    run: runtime.run,
+    materializeSource: (_context: VerifiedReleaseContext, destination) =>
+      runtime.source.materialize(sourceWorkspace, compiled.context.source, destination)
+  })
+})
+
+const loadPrepared = Effect.fn("loadPreparedForApi")(function*(
+  prepared: CompletePreparedReleaseRef
+) {
+  const store = yield* PreparedReleaseStore
+  return yield* store.load(prepared)
+})
+
+const safeCause = <E>(cause: Cause.Cause<E>, fallback: string): string => {
+  return safeFailure(Cause.squash(cause), fallback)
+}
+
+const preparationFailure = <A, E, R>(
+  effect: Effect.Effect<A, E, R>
+): Effect.Effect<A, ReleaseInputError | ReleasePreparationError | ReleaseAbortedError, R> => effect.pipe(
+  Effect.catchCause((cause): Effect.Effect<
+    A,
+    ReleaseInputError | ReleasePreparationError | ReleaseAbortedError
+  > => {
+    const failure = Cause.squash(cause)
+    if (failure instanceof ReleaseInputError) {
+      return Effect.fail<ReleaseInputError | ReleasePreparationError | ReleaseAbortedError>(failure)
+    }
+    if (failure instanceof PreparationError && failure.prepared !== undefined) {
+      return Effect.fail(new ReleaseAbortedError({
+        prepared: failure.prepared,
+        cause: safeCause(cause, "The durable prepared reference could not be handed to the host.")
+      }))
+    }
+    return Effect.fail(new ReleasePreparationError({
+      cause: safeCause(cause, "Release preparation failed before a durable prepared reference was committed.")
+    }))
+  })
+)
+
+const afterCommitFailure = <A, E, R>(
+  prepared: CompletePreparedReleaseRef,
+  effect: Effect.Effect<A, E, R>
+): Effect.Effect<A, ReleaseAbortedError, R> => effect.pipe(
+  Effect.catchCause((cause) => Effect.fail(new ReleaseAbortedError({
+    prepared,
+    cause: safeCause(cause, "The release operation stopped before a total report was available.")
+  })))
+)
+
+const observeProgram = (
+  prepared: CompletePreparedReleaseRef,
+  adapters: NonNullable<ReleaseApiOptions["providerAdapters"]>
+) => afterCommitFailure(
+  prepared,
+  loadPrepared(prepared).pipe(Effect.flatMap((bundle) => observePreparedRelease(bundle, adapters)))
+)
+
+const publishCommitted = Effect.fn("publishCommittedRelease")(function*(
+  committed: CommittedPreparedRelease,
+  adapters: NonNullable<ReleaseApiOptions["providerAdapters"]>
+) {
+  const report = yield* publishPreparedRelease(committed.bundle, adapters)
+  return { prepared: committed.ref, report }
+})
+
+const publishProgram = Effect.fn("publishProgram")(function*(
+  prepared: CompletePreparedReleaseRef,
+  adapters: NonNullable<ReleaseApiOptions["providerAdapters"]>
+) {
+  const result = yield* afterCommitFailure(
+    prepared,
+    loadPrepared(prepared).pipe(
+      Effect.flatMap((bundle) => publishCommitted({ ref: prepared, bundle }, adapters))
+    )
+  )
+  return result.report
+})
+
+const releaseProgram = Effect.fn("releaseProgram")(function*(
+  input: ReleaseInput,
+  adapters: NonNullable<ReleaseApiOptions["providerAdapters"]>
+) {
+  const committed = yield* preparationFailure(prepareProgram(input, {
+    allowEmpty: input.allowEmpty === true
+  }))
+  return yield* afterCommitFailure(committed.ref, publishCommitted(committed, adapters))
+})
+
+const correctProgram = Effect.fn("correctProgram")(function*(input: CorrectInput) {
+  const bundle = yield* loadPrepared(input.prepared)
+  const credentials = yield* CredentialProvider
+  const http = yield* HttpAuthorizer
+  const mutationHttp = yield* AuthorizedMutationHttp
+  const outcome = yield* Effect.try({
+    try: () => bindAuthoredCorrection(bundle, input.correction),
+    catch: inputFailure
+  }).pipe(Effect.flatMap((intent) => correctPreparedRelease({
+    bundle,
+    intent,
+    services: { credentials, http, mutationHttp }
+  })))
+  if (outcome._tag === "CorrectionExecuted") return new CorrectionReport({
+    prepared: input.prepared,
+    status: outcome.report.status,
+    provider: outcome.provider,
+    reason: SafeReason.make("Catalog correction completed through the exact conditional Git-data subject report."),
+    proposal: "",
+    report: outcome.report
+  })
+  return new CorrectionReport({
+    prepared: input.prepared,
+    status: "unsupported",
+    provider: outcome.provider,
+    reason: SafeReason.make(outcome.reason),
+    proposal: outcome.proposal ?? ""
+  })
+})
+
+export const makeReleaseApi = (layer: ReleaseApiLayer, options: ReleaseApiOptions = {}): ReleaseApi => {
+  const runtime = ManagedRuntime.make(layer)
+  const adapters = options.providerAdapters ?? []
+  const run = <A, E>(effect: Effect.Effect<A, E, ReleaseApiServices>): Promise<A> =>
+    runtime.runPromise(effect)
+
+  const inspect = async (value: InspectInput) => {
+    const input = decodeInspectInput(value)
+    if ("prepared" in input) {
+      return inspectPreparedRelease(await run(afterCommitFailure(
+        input.prepared,
+        loadPrepared(input.prepared)
+      )))
+    }
+    const compiled = await run(observeAndCompile({
+      config: input.config,
+      workspace: input.workspace
+    }))
+    return inspectRelease(compiled.context, compiled.graph)
+  }
+
+  const prepare = async (value: PrepareInput) => {
+    const input = decodePrepareInput(value)
+    const committed = await run(preparationFailure(prepareProgram(input, { allowEmpty: true })))
+    return committed.ref
+  }
+
+  const observe = async (value: ObserveInput) => {
+    const input = decodeObserveInput(value)
+    return run(observeProgram(input.prepared, adapters))
+  }
+
+  const publish = async (value: PublishInput) => {
+    const input = decodePublishInput(value)
+    return run(publishProgram(input.prepared, adapters))
+  }
+
+  const release = async (value: ReleaseInput) => {
+    const input = decodeReleaseInput(value)
+    return run(releaseProgram(input, adapters))
+  }
+
+  const correct = async (value: CorrectInput) => {
+    const input = decodeCorrectInput(value)
+    return run(afterCommitFailure(input.prepared, correctProgram(input)))
+  }
+
+  return Object.freeze({
+    inspect,
+    prepare,
+    observe,
+    publish,
+    release,
+    correct,
+    dispose: () => runtime.dispose()
+  })
+}
+
+export const makeDefaultReleaseApi = (layer: ReleaseApiLayer): ReleaseApi =>
+  makeReleaseApi(layer)
+
+import { NodeReleaseLayer } from "../platform/node.js"
+const defaultApi = makeReleaseApi(NodeReleaseLayer)
+export const inspect = defaultApi.inspect
+export const prepare = defaultApi.prepare
+export const observe = defaultApi.observe
+export const publish = defaultApi.publish
+export const release = defaultApi.release
+export const correct = defaultApi.correct

package/src/api/errors.ts

@@ -0,0 +1,36 @@
+import * as Schema from "effect/Schema"
+import { CompletePreparedReleaseRef } from "../release/prepared-ref.js"
+
+export class ReleaseInputError
+  extends Schema.TaggedErrorClass<ReleaseInputError>()("ReleaseInputError", { reason: Schema.String }) {}
+
+/**
+ * Cross-host preparation is deliberately reserved for plan 235. Recognizing
+ * these two tags before strict input decoding gives callers an actionable,
+ * typed refusal without publishing a partial-bundle shape prematurely.
+ */
+export class PreparationModeUnsupported
+  extends Schema.TaggedErrorClass<PreparationModeUnsupported>()("PreparationModeUnsupported", {
+    mode: Schema.Literals(["partition", "merge"]),
+    owner: Schema.Literal("plan-235"),
+    reason: Schema.String
+  }) {}
+
+export class ReleasePreparationError
+  extends Schema.TaggedErrorClass<ReleasePreparationError>()("ReleasePreparationError", {
+    cause: Schema.String
+  }) {}
+
+export class ReleaseAbortedError
+  extends Schema.TaggedErrorClass<ReleaseAbortedError>()("ReleaseAbortedError", {
+    prepared: Schema.optionalKey(CompletePreparedReleaseRef),
+    cause: Schema.String
+  }) {}
+
+/** Product-boundary failure after a truthful total report has been emitted. */
+export class ReleaseIncompleteError
+  extends Schema.TaggedErrorClass<ReleaseIncompleteError>()("ReleaseIncompleteError", {
+    prepared: CompletePreparedReleaseRef,
+    status: Schema.Literals(["blocked", "uncertain"]),
+    reason: Schema.String
+  }) {}