@fungi.computer/puffball 0.0.0-stage → 0.0.1

package/docs/api/effect.md

@@ -0,0 +1,2429 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/puffball**](README.md)
+
+---
+
+[@fungi.computer/puffball](README.md) / effect
+
+# effect
+
+## Type Aliases
+
+### AppReleaseCoreFailure
+
+```ts
+type AppReleaseCoreFailure =
+  | AppReleaseImmutableConflictError
+  | AppReleaseOwnerAppAbsentError
+  | AppReleaseSurfaceOwnerAppAbsentError
+  | AppReleaseStoreUnavailableError
+  | AppReleaseReleaseAbsentError
+  | AppReleaseArtifactUnavailableError
+  | AppReleaseArtifactMissingError
+  | AppReleaseArtifactDigestMismatchError
+  | AppReleaseArtifactInvalidSnapshotError
+  | AppReleaseCommandInputError
+  | AppReleaseInvalidStoreResultError
+  | AppReleaseTransitionIdempotencyConflictError
+  | AppReleaseTransitionOwnershipConflictError
+  | AppReleaseTransitionReleaseAbsentError
+  | AppReleaseTransitionReleaseRevokedError
+  | AppReleaseTransitionReleaseUnverifiedError
+  | AppReleaseTransitionArtifactIncompatibleError
+  | AppReleaseTransitionSurfaceAbsentError
+  | AppReleaseTransitionIdUnavailableError
+  | AppReleasePublicWebsiteNotFoundError
+  | AppReleasePublicWebsiteUnavailableError;
+```
+
+Closed domain failures that the core maps from store outcomes.
+
+---
+
+### AppReleaseCore
+
+```ts
+type AppReleaseCore = object;
+```
+
+Effect-native core for the narrow App and immutable Release catalog facts.
+
+#### Methods
+
+##### createApp()
+
+```ts
+createApp(app): Effect<App, AppReleaseCoreFailure>;
+```
+
+Create or observe one Global App through the owned store port.
+
+###### Parameters
+
+| Parameter | Type                  |
+| --------- | --------------------- |
+| `app`     | [`App`](index.md#app) |
+
+###### Returns
+
+`Effect`\<[`App`](index.md#app),
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### createRelease()
+
+```ts
+createRelease(release): Effect<Release, AppReleaseCoreFailure>;
+```
+
+Create or observe one immutable Release through the owned store port.
+
+###### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| `release` | [`Release`](index.md#release) |
+
+###### Returns
+
+`Effect`\<[`Release`](index.md#release),
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### verifyReleaseArtifact()
+
+```ts
+verifyReleaseArtifact(releaseId): Effect<VerifiedArtifactRead, AppReleaseCoreFailure>;
+```
+
+Verify the immutable artifact bound to one Release.
+
+###### Parameters
+
+| Parameter   | Type                              |
+| ----------- | --------------------------------- |
+| `releaseId` | [`ReleaseId`](index.md#releaseid) |
+
+###### Returns
+
+`Effect`\<[`VerifiedArtifactRead`](index.md#verifiedartifactread),
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### resolveEligibleReleaseArtifact()
+
+```ts
+resolveEligibleReleaseArtifact(releaseId): Effect<VerifiedArtifactRead & object, AppReleaseCoreFailure>;
+```
+
+Read and recheck one eligible snapshot before each authorized use.
+
+###### Parameters
+
+| Parameter   | Type                              |
+| ----------- | --------------------------------- |
+| `releaseId` | [`ReleaseId`](index.md#releaseid) |
+
+###### Returns
+
+`Effect`\<[`VerifiedArtifactRead`](index.md#verifiedartifactread) & `object`,
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### resolveEligibleApp()
+
+```ts
+resolveEligibleApp(releaseId): Effect<ResolvedApp, AppReleaseCoreFailure>;
+```
+
+Resolve UI and backend together, checking eligibility around all child reads.
+
+###### Parameters
+
+| Parameter   | Type                              |
+| ----------- | --------------------------------- |
+| `releaseId` | [`ReleaseId`](index.md#releaseid) |
+
+###### Returns
+
+`Effect`\<[`ResolvedApp`](index.md#resolvedapp),
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### resolveEligibleAppMetadata()
+
+```ts
+resolveEligibleAppMetadata(releaseId): Effect<Readonly<{
+  release: Release;
+  digest: Sha256Digest;
+  description: VerifiedAppDescription;
+}>, AppReleaseCoreFailure>;
+```
+
+Resolve verified App metadata without reading any artifact body.
+
+###### Parameters
+
+| Parameter   | Type                              |
+| ----------- | --------------------------------- |
+| `releaseId` | [`ReleaseId`](index.md#releaseid) |
+
+###### Returns
+
+`Effect`\<`Readonly`\<\{ `release`: [`Release`](index.md#release); `digest`:
+[`Sha256Digest`](index.md#sha256digest); `description`:
+[`VerifiedAppDescription`](index.md#verifiedappdescription); \}\>,
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### resolvePublicSurfaceAuthority()
+
+```ts
+resolvePublicSurfaceAuthority(stableRoute): Effect<Readonly<{
+  currentReleaseId: ReleaseId;
+  sequence: number;
+  app: App;
+  release: Release;
+  surface: PublicSurface;
+  digest: Sha256Digest;
+  revocation: ReleaseRevocation;
+  description: VerifiedAppDescription;
+}>, AppReleaseCoreFailure>;
+```
+
+Resolve one selected Surface's current metadata authority without bodies.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+
+###### Returns
+
+`Effect`\<`Readonly`\<\{ `currentReleaseId`: [`ReleaseId`](index.md#releaseid);
+`sequence`: `number`; `app`: [`App`](index.md#app); `release`:
+[`Release`](index.md#release); `surface`:
+[`PublicSurface`](index.md#publicsurface); `digest`:
+[`Sha256Digest`](index.md#sha256digest); `revocation`:
+[`ReleaseRevocation`](index.md#releaserevocation); `description`:
+[`VerifiedAppDescription`](index.md#verifiedappdescription); \}\>,
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### resolvePublicSurfaceAuthorityVersion()
+
+```ts
+resolvePublicSurfaceAuthorityVersion(stableRoute, releaseId): Effect<Readonly<{
+  currentReleaseId: ReleaseId;
+  sequence: number;
+  app: App;
+  release: Release;
+  surface: PublicSurface;
+  digest: Sha256Digest;
+  revocation: ReleaseRevocation;
+  description: VerifiedAppDescription;
+}>, AppReleaseCoreFailure>;
+```
+
+Resolve one previously selected Release's current metadata authority.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+| `releaseId`   | [`ReleaseId`](index.md#releaseid)     |
+
+###### Returns
+
+`Effect`\<`Readonly`\<\{ `currentReleaseId`: [`ReleaseId`](index.md#releaseid);
+`sequence`: `number`; `app`: [`App`](index.md#app); `release`:
+[`Release`](index.md#release); `surface`:
+[`PublicSurface`](index.md#publicsurface); `digest`:
+[`Sha256Digest`](index.md#sha256digest); `revocation`:
+[`ReleaseRevocation`](index.md#releaserevocation); `description`:
+[`VerifiedAppDescription`](index.md#verifiedappdescription); \}\>,
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### resolvePublicAssetBuild()
+
+```ts
+resolvePublicAssetBuild(stableRoute): Effect<PublicAssetBuildRepresentation, AppReleaseCoreFailure>;
+```
+
+Resolve a multi-file root through existing Surface selection and eligibility.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+
+###### Returns
+
+`Effect`\<[`PublicAssetBuildRepresentation`](index.md#publicassetbuildrepresentation),
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### createPublicSurface()
+
+```ts
+createPublicSurface(surface): Effect<PublicSurface, AppReleaseCoreFailure>;
+```
+
+Create or observe one App-owned anonymous public Surface.
+
+###### Parameters
+
+| Parameter | Type                                                          |
+| --------- | ------------------------------------------------------------- |
+| `surface` | [`PublicSurfaceDefinition`](index.md#publicsurfacedefinition) |
+
+###### Returns
+
+`Effect`\<[`PublicSurface`](index.md#publicsurface),
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### transition()
+
+```ts
+transition(request): Effect<TransitionReceipt, AppReleaseCoreFailure>;
+```
+
+Apply one owner-issued transition with an idempotent terminal receipt.
+
+###### Parameters
+
+| Parameter | Type                                              |
+| --------- | ------------------------------------------------- |
+| `request` | [`ReleaseTransition`](index.md#releasetransition) |
+
+###### Returns
+
+`Effect`\<[`TransitionReceipt`](index.md#transitionreceipt),
+[`AppReleaseCoreFailure`](#appreleasecorefailure)\>
+
+##### resolveEligibleSurfaceRelease()
+
+```ts
+resolveEligibleSurfaceRelease(stableRoute): Effect<Readonly<{
+  appId: Release["appId"];
+  releaseId: Release["releaseId"];
+  stableRoute: StableRoute;
+  artifactDigest: Sha256Digest;
+  mediaType: "application/vnd.fungi.app+json";
+}>,
+  | AppReleasePublicWebsiteNotFoundError
+| AppReleasePublicWebsiteUnavailableError>;
+```
+
+Resolve the current eligible Surface Release without reading artifact bytes.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+
+###### Returns
+
+`Effect`\<`Readonly`\<\{ `appId`: [`Release`](index.md#release)\[`"appId"`\];
+`releaseId`: [`Release`](index.md#release)\[`"releaseId"`\]; `stableRoute`:
+[`StableRoute`](index.md#stableroute); `artifactDigest`:
+[`Sha256Digest`](index.md#sha256digest); `mediaType`:
+`"application/vnd.fungi.app+json"`; \}\>, \|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>
+
+##### resolveEligibleSurfaceReleases()
+
+```ts
+resolveEligibleSurfaceReleases(stableRoutes): Effect<readonly Result<Readonly<{
+  appId: Release["appId"];
+  releaseId: Release["releaseId"];
+  stableRoute: StableRoute;
+  artifactDigest: Sha256Digest;
+  mediaType: "application/vnd.fungi.app+json";
+}>,
+  | AppReleasePublicWebsiteNotFoundError
+  | AppReleasePublicWebsiteUnavailableError>[],
+  | AppReleasePublicWebsiteNotFoundError
+| AppReleasePublicWebsiteUnavailableError>;
+```
+
+Read up to 100 current Surface selections in one atomic metadata batch. Each
+entry reports its eligibility; failure of the read fails the Effect.
+
+###### Parameters
+
+| Parameter      | Type                                             |
+| -------------- | ------------------------------------------------ |
+| `stableRoutes` | readonly [`StableRoute`](index.md#stableroute)[] |
+
+###### Returns
+
+`Effect`\<readonly `Result`\<`Readonly`\<\{ `appId`:
+[`Release`](index.md#release)\[`"appId"`\]; `releaseId`:
+[`Release`](index.md#release)\[`"releaseId"`\]; `stableRoute`:
+[`StableRoute`](index.md#stableroute); `artifactDigest`:
+[`Sha256Digest`](index.md#sha256digest); `mediaType`:
+`"application/vnd.fungi.app+json"`; \}\>, \|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>[],
+\|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>
+
+##### resolveEligibleSurfaceVersion()
+
+```ts
+resolveEligibleSurfaceVersion(stableRoute, releaseId): Effect<Readonly<{
+  appId: Release["appId"];
+  releaseId: Release["releaseId"];
+  stableRoute: StableRoute;
+  artifactDigest: Sha256Digest;
+  mediaType: "application/vnd.fungi.app+json";
+}>,
+  | AppReleasePublicWebsiteNotFoundError
+| AppReleasePublicWebsiteUnavailableError>;
+```
+
+Resolve one eligible Release previously selected on this Surface.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+| `releaseId`   | [`ReleaseId`](index.md#releaseid)     |
+
+###### Returns
+
+`Effect`\<`Readonly`\<\{ `appId`: [`Release`](index.md#release)\[`"appId"`\];
+`releaseId`: [`Release`](index.md#release)\[`"releaseId"`\]; `stableRoute`:
+[`StableRoute`](index.md#stableroute); `artifactDigest`:
+[`Sha256Digest`](index.md#sha256digest); `mediaType`:
+`"application/vnd.fungi.app+json"`; \}\>, \|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>
+
+##### resolvePublicSurface()
+
+```ts
+resolvePublicSurface(stableRoute): Effect<PublicSurface,
+  | AppReleasePublicWebsiteNotFoundError
+| AppReleasePublicWebsiteUnavailableError>;
+```
+
+Resolve one stable route's immutable Surface owner without selecting a Release.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+
+###### Returns
+
+`Effect`\<[`PublicSurface`](index.md#publicsurface), \|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>
+
+##### resolvePublicWebsite()
+
+```ts
+resolvePublicWebsite(stableRoute): Effect<Readonly<{
+  releaseId: ReleaseId;
+  digest: Sha256Digest;
+  mediaType: "text/html; charset=utf-8";
+  byteLength: number;
+  bytes: ImmutableArtifactBytes;
+}>,
+  | AppReleasePublicWebsiteNotFoundError
+| AppReleasePublicWebsiteUnavailableError>;
+```
+
+Resolve the current eligible immutable website representation.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+
+###### Returns
+
+`Effect`\<`Readonly`\<\{ `releaseId`: [`ReleaseId`](index.md#releaseid);
+`digest`: [`Sha256Digest`](index.md#sha256digest); `mediaType`:
+`"text/html; charset=utf-8"`; `byteLength`: `number`; `bytes`:
+[`ImmutableArtifactBytes`](index.md#immutableartifactbytes); \}\>, \|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>
+
+##### resolvePublicWebsiteVersion()
+
+```ts
+resolvePublicWebsiteVersion(stableRoute, releaseId): Effect<Readonly<{
+  releaseId: ReleaseId;
+  digest: Sha256Digest;
+  mediaType: "text/html; charset=utf-8";
+  byteLength: number;
+  bytes: ImmutableArtifactBytes;
+}>,
+  | AppReleasePublicWebsiteNotFoundError
+| AppReleasePublicWebsiteUnavailableError>;
+```
+
+Resolve a pinned eligible immutable website representation.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+| `releaseId`   | [`ReleaseId`](index.md#releaseid)     |
+
+###### Returns
+
+`Effect`\<`Readonly`\<\{ `releaseId`: [`ReleaseId`](index.md#releaseid);
+`digest`: [`Sha256Digest`](index.md#sha256digest); `mediaType`:
+`"text/html; charset=utf-8"`; `byteLength`: `number`; `bytes`:
+[`ImmutableArtifactBytes`](index.md#immutableartifactbytes); \}\>, \|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>
+
+##### resolvePublicAssetBuildVersion()
+
+```ts
+resolvePublicAssetBuildVersion(stableRoute, releaseId): Effect<PublicAssetBuildRepresentation,
+  | AppReleasePublicWebsiteNotFoundError
+| AppReleasePublicWebsiteUnavailableError>;
+```
+
+Resolve a pinned asset-build root through Surface authority.
+
+###### Parameters
+
+| Parameter     | Type                                  |
+| ------------- | ------------------------------------- |
+| `stableRoute` | [`StableRoute`](index.md#stableroute) |
+| `releaseId`   | [`ReleaseId`](index.md#releaseid)     |
+
+###### Returns
+
+`Effect`\<[`PublicAssetBuildRepresentation`](index.md#publicassetbuildrepresentation),
+\|
+[`AppReleasePublicWebsiteNotFoundError`](index.md#appreleasepublicwebsitenotfounderror)
+\|
+[`AppReleasePublicWebsiteUnavailableError`](index.md#appreleasepublicwebsiteunavailableerror)\>
+
+---
+
+### AppReleaseArtifactReaderUnavailable
+
+```ts
+type AppReleaseArtifactReaderUnavailable = object;
+```
+
+Closed infrastructure failure at the hostile artifact-reader boundary.
+
+#### Properties
+
+##### kind
+
+```ts
+readonly kind: "unavailable";
+```
+
+---
+
+### AppReleaseArtifactReader
+
+```ts
+type AppReleaseArtifactReader = object;
+```
+
+Effect-native artifact reader port.
+
+A reader result is hostile until the App Release core decodes it through its
+canonical schema. This port owns the only direct unknown success value.
+
+#### Methods
+
+##### read()
+
+```ts
+read(input): Effect<unknown, AppReleaseArtifactReaderUnavailable>;
+```
+
+Resolve one stored artifact reference for its expected immutable digest.
+
+###### Parameters
+
+| Parameter                         | Type                                                                                                                                                                                                                                                                                | Description                                                                |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `input`                           | \{ `artifactRef`: [`ArtifactRef`](index.md#artifactref); `expectedDigest`: [`Sha256Digest`](index.md#sha256digest); `expectedObject?`: \{ `version`: `string`; `byteLength`: `number`; \}; `verification?`: [`ArtifactVerificationIntent`](index.md#artifactverificationintent); \} | -                                                                          |
+| `input.artifactRef`               | [`ArtifactRef`](index.md#artifactref)                                                                                                                                                                                                                                               | -                                                                          |
+| `input.expectedDigest`            | [`Sha256Digest`](index.md#sha256digest)                                                                                                                                                                                                                                             | -                                                                          |
+| `input.expectedObject?`           | \{ `version`: `string`; `byteLength`: `number`; \}                                                                                                                                                                                                                                  | Native version and size of a child named by a verified App root.           |
+| `input.expectedObject.version`    | `string`                                                                                                                                                                                                                                                                            | -                                                                          |
+| `input.expectedObject.byteLength` | `number`                                                                                                                                                                                                                                                                            | -                                                                          |
+| `input.verification?`             | [`ArtifactVerificationIntent`](index.md#artifactverificationintent)                                                                                                                                                                                                                 | Publication additionally verifies every object named by an asset manifest. |
+
+###### Returns
+
+`Effect`\<`unknown`,
+[`AppReleaseArtifactReaderUnavailable`](#appreleaseartifactreaderunavailable)\>
+
+---
+
+### AppReleaseStorePortFailure
+
+```ts
+type AppReleaseStorePortFailure =
+  | AppReleaseStoreFailure
+  | {
+      kind: "invalid-store-result";
+    };
+```
+
+Closed failures emitted by the owned Effect Store port.
+
+The invalid-result sentinel lets the outer Promise adapter fail closed when a
+foreign fulfilled value is not one of the catalog's durable outcomes.
+
+---
+
+### AppReleaseStore
+
+```ts
+type AppReleaseStore = object;
+```
+
+Canonical Effect-owned persistence port for the narrow App/Release catalog.
+
+Implementations own atomicity; the catalog owns the interpretation of these
+explicit outcomes. This port intentionally has no generic query or mutation
+escape hatch.
+
+#### Properties
+
+##### readReleaseLifecycle?
+
+```ts
+readonly optional readReleaseLifecycle?: (releaseId) => Effect.Effect<ReleaseLifecycle, AppReleaseStorePortFailure>;
+```
+
+Read the Release facts relevant to transition eligibility.
+
+###### Parameters
+
+| Parameter   | Type                              |
+| ----------- | --------------------------------- |
+| `releaseId` | [`ReleaseId`](index.md#releaseid) |
+
+###### Returns
+
+`Effect.Effect`\<[`ReleaseLifecycle`](index.md#releaselifecycle),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### recordReleaseVerification?
+
+```ts
+readonly optional recordReleaseVerification?: (input) => Effect.Effect<{
+  kind: "recorded";
+}, AppReleaseStorePortFailure>;
+```
+
+Retain a verified artifact fact after core validation succeeds.
+
+###### Parameters
+
+| Parameter           | Type                                                                                                                                                                                                                                  |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`             | \{ `releaseId`: [`ReleaseId`](index.md#releaseid); `digest`: [`Sha256Digest`](index.md#sha256digest); `mediaType`: `"application/vnd.fungi.app+json"`; `description`: [`VerifiedAppDescription`](index.md#verifiedappdescription); \} |
+| `input.releaseId`   | [`ReleaseId`](index.md#releaseid)                                                                                                                                                                                                     |
+| `input.digest`      | [`Sha256Digest`](index.md#sha256digest)                                                                                                                                                                                               |
+| `input.mediaType`   | `"application/vnd.fungi.app+json"`                                                                                                                                                                                                    |
+| `input.description` | [`VerifiedAppDescription`](index.md#verifiedappdescription)                                                                                                                                                                           |
+
+###### Returns
+
+`Effect.Effect`\<\{ `kind`: `"recorded"`; \},
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### readTransition?
+
+```ts
+readonly optional readTransition?: (request) => Effect.Effect<TransitionLookup, AppReleaseStorePortFailure>;
+```
+
+Read a receipt or idempotency conflict before transition policy.
+
+###### Parameters
+
+| Parameter | Type                                              |
+| --------- | ------------------------------------------------- |
+| `request` | [`ReleaseTransition`](index.md#releasetransition) |
+
+###### Returns
+
+`Effect.Effect`\<[`TransitionLookup`](index.md#transitionlookup),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### persistTransition?
+
+```ts
+readonly optional persistTransition?: (request, receipt) => Effect.Effect<TransitionPersistence, AppReleaseStorePortFailure>;
+```
+
+Atomically persist a policy-approved transition and receipt.
+
+###### Parameters
+
+| Parameter | Type                                              |
+| --------- | ------------------------------------------------- |
+| `request` | [`ReleaseTransition`](index.md#releasetransition) |
+| `receipt` | [`TransitionReceipt`](index.md#transitionreceipt) |
+
+###### Returns
+
+`Effect.Effect`\<[`TransitionPersistence`](index.md#transitionpersistence),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+#### Methods
+
+##### readApp()
+
+```ts
+readApp(appId): Effect<AppRead, AppReleaseStorePortFailure>;
+```
+
+Look up exactly one Global App.
+
+###### Parameters
+
+| Parameter | Type                      |
+| --------- | ------------------------- |
+| `appId`   | [`AppId`](index.md#appid) |
+
+###### Returns
+
+`Effect`\<[`AppRead`](index.md#appread),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### createAppIfAbsent()
+
+```ts
+createAppIfAbsent(app): Effect<AppCreate, AppReleaseStorePortFailure>;
+```
+
+Atomically create or observe exactly one Global App.
+
+###### Parameters
+
+| Parameter | Type                  |
+| --------- | --------------------- |
+| `app`     | [`App`](index.md#app) |
+
+###### Returns
+
+`Effect`\<[`AppCreate`](index.md#appcreate),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### readRelease()
+
+```ts
+readRelease(releaseId): Effect<ReleaseRead, AppReleaseStorePortFailure>;
+```
+
+Look up exactly one immutable Release.
+
+###### Parameters
+
+| Parameter   | Type                              |
+| ----------- | --------------------------------- |
+| `releaseId` | [`ReleaseId`](index.md#releaseid) |
+
+###### Returns
+
+`Effect`\<[`ReleaseRead`](index.md#releaseread),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### createReleaseIfAbsent()
+
+```ts
+createReleaseIfAbsent(release): Effect<ReleaseCreate, AppReleaseStorePortFailure>;
+```
+
+Atomically create or observe exactly one immutable Release.
+
+###### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| `release` | [`Release`](index.md#release) |
+
+###### Returns
+
+`Effect`\<[`ReleaseCreate`](index.md#releasecreate),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### readPublicSurface()
+
+```ts
+readPublicSurface(publicSurfaceId): Effect<PublicSurfaceRead, AppReleaseStorePortFailure>;
+```
+
+Look up exactly one App-owned anonymous public Surface.
+
+###### Parameters
+
+| Parameter         | Type                                          |
+| ----------------- | --------------------------------------------- |
+| `publicSurfaceId` | [`PublicSurfaceId`](index.md#publicsurfaceid) |
+
+###### Returns
+
+`Effect`\<[`PublicSurfaceRead`](index.md#publicsurfaceread),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+##### createPublicSurfaceIfAbsent()
+
+```ts
+createPublicSurfaceIfAbsent(surface): Effect<PublicSurfaceCreate, AppReleaseStorePortFailure>;
+```
+
+Atomically create or observe one App-owned anonymous public Surface.
+
+###### Parameters
+
+| Parameter | Type                                                          |
+| --------- | ------------------------------------------------------------- |
+| `surface` | [`PublicSurfaceDefinition`](index.md#publicsurfacedefinition) |
+
+###### Returns
+
+`Effect`\<[`PublicSurfaceCreate`](index.md#publicsurfacecreate),
+[`AppReleaseStorePortFailure`](#appreleasestoreportfailure)\>
+
+## Variables
+
+### appIdSchema
+
+```ts
+const appIdSchema: refine<AppId, String>;
+```
+
+Canonical Effect Schema for one Global App identifier.
+
+---
+
+### releaseIdSchema
+
+```ts
+const releaseIdSchema: refine<ReleaseId, String>;
+```
+
+Canonical Effect Schema for one immutable Release identifier.
+
+---
+
+### publicSurfaceIdSchema
+
+```ts
+const publicSurfaceIdSchema: refine<PublicSurfaceId, String>;
+```
+
+Canonical Effect Schema for one anonymous public-Surface identifier.
+
+---
+
+### artifactRefSchema
+
+```ts
+const artifactRefSchema: refine<ArtifactRef, String>;
+```
+
+Canonical Effect Schema for one bounded artifact reference.
+
+---
+
+### idempotencyKeySchema
+
+```ts
+const idempotencyKeySchema: refine<IdempotencyKey, String>;
+```
+
+Canonical Effect Schema for one caller-provided idempotency key.
+
+---
+
+### sourceRevisionSchema
+
+```ts
+const sourceRevisionSchema: refine<SourceRevision, String>;
+```
+
+Canonical Effect Schema for one pinned lowercase Git source revision.
+
+---
+
+### sha256DigestSchema
+
+```ts
+const sha256DigestSchema: refine<Sha256Digest, String>;
+```
+
+Canonical Effect Schema for one lowercase SHA-256 digest.
+
+---
+
+### stableRouteSchema
+
+```ts
+const stableRouteSchema: refine<StableRoute, String>;
+```
+
+Canonical Effect Schema for one canonical local stable route.
+
+---
+
+### appSchema
+
+```ts
+const appSchema: Struct<{
+  appId: refine<AppId, String>;
+}>;
+```
+
+Canonical Effect Schema for a Global App record.
+
+---
+
+### artifactProvenanceSchema
+
+```ts
+const artifactProvenanceSchema: Struct<{
+  sourceRevision: refine<SourceRevision, String>;
+  sourceTreeDigest: refine<Sha256Digest, String>;
+  buildRecipeDigest: refine<Sha256Digest, String>;
+}>;
+```
+
+Canonical Effect Schema for immutable source and build provenance.
+
+---
+
+### releaseArtifactSchema
+
+```ts
+const releaseArtifactSchema: Struct<{
+  artifactRef: refine<ArtifactRef, String>;
+  artifactDigest: refine<Sha256Digest, String>;
+  provenance: Struct<{
+    sourceRevision: refine<SourceRevision, String>;
+    sourceTreeDigest: refine<Sha256Digest, String>;
+    buildRecipeDigest: refine<Sha256Digest, String>;
+  }>;
+}>;
+```
+
+Canonical Effect Schema for immutable artifact identity and provenance.
+
+---
+
+### releaseSchema
+
+```ts
+const releaseSchema: Struct<{
+  releaseId: refine<ReleaseId, String>;
+  appId: refine<AppId, String>;
+  artifact: Struct<{
+    artifactRef: refine<ArtifactRef, String>;
+    artifactDigest: refine<Sha256Digest, String>;
+    provenance: Struct<{
+      sourceRevision: refine<SourceRevision, String>;
+      sourceTreeDigest: refine<Sha256Digest, String>;
+      buildRecipeDigest: refine<Sha256Digest, String>;
+    }>;
+  }>;
+}>;
+```
+
+Canonical Effect Schema for one immutable App Release.
+
+---
+
+### publicSurfaceSchema
+
+```ts
+const publicSurfaceSchema: Struct<{
+  publicSurfaceId: refine<PublicSurfaceId, String>;
+  appId: refine<AppId, String>;
+  stableRoute: refine<StableRoute, String>;
+}>;
+```
+
+Canonical Effect Schema for one App-owned anonymous public Surface.
+
+---
+
+### verifiedArtifactReadSchema
+
+```ts
+const verifiedArtifactReadSchema: Struct<{
+  kind: Literal<"verified">;
+  digest: refine<Sha256Digest, String>;
+  mediaType: Literals<
+    readonly [
+      "text/html; charset=utf-8",
+      "application/vnd.fungi.app-backend+json",
+      "application/vnd.fungi.app-assets+json",
+      "application/vnd.fungi.app+json",
+    ]
+  >;
+  bytes: refine<
+    object & ImmutableArtifactBytes,
+    Struct<{
+      byteLength: Number;
+      copy: instanceOf<Function, unknown>;
+    }>
+  >;
+  byteLength: Number;
+}>;
+```
+
+Canonical Effect Schema for a verified immutable artifact snapshot.
+
+---
+
+### artifactReadResultSchema
+
+```ts
+const artifactReadResultSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"verified">;
+      digest: refine<Sha256Digest, String>;
+      mediaType: Literals<
+        readonly [
+          "text/html; charset=utf-8",
+          "application/vnd.fungi.app-backend+json",
+          "application/vnd.fungi.app-assets+json",
+          "application/vnd.fungi.app+json",
+        ]
+      >;
+      bytes: refine<
+        object & ImmutableArtifactBytes,
+        Struct<{
+          byteLength: Number;
+          copy: instanceOf<Function, unknown>;
+        }>
+      >;
+      byteLength: Number;
+    }>,
+    Struct<{
+      kind: Literal<"unavailable">;
+    }>,
+    Struct<{
+      kind: Literal<"missing">;
+    }>,
+    Struct<{
+      kind: Literal<"digest-mismatch">;
+      actualDigest: refine<Sha256Digest, String>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for the complete hostile artifact-reader result.
+
+---
+
+### appReadSchema
+
+```ts
+const appReadSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"found">;
+      app: Struct<{
+        appId: refine<AppId, String>;
+      }>;
+    }>,
+    Struct<{
+      kind: Literal<"absent">;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for one explicit App lookup result.
+
+---
+
+### appCreateSchema
+
+```ts
+const appCreateSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"created">;
+      app: Struct<{
+        appId: refine<AppId, String>;
+      }>;
+    }>,
+    Struct<{
+      kind: Literal<"existing">;
+      app: Struct<{
+        appId: refine<AppId, String>;
+      }>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for one explicit App create-or-observe result.
+
+---
+
+### releaseReadSchema
+
+```ts
+const releaseReadSchema: Union<readonly [Struct<{
+  kind: Literal<"found">;
+  release: Struct<{
+     releaseId: refine<ReleaseId, String>;
+     appId: refine<AppId, String>;
+     artifact: Struct<{
+        artifactRef: refine<ArtifactRef, String>;
+        artifactDigest: refine<Sha256Digest, String>;
+        provenance: Struct<{
+           sourceRevision: refine<..., ...>;
+           sourceTreeDigest: refine<..., ...>;
+           buildRecipeDigest: refine<..., ...>;
+        }>;
+     }>;
+  }>;
+}>, Struct<{
+  kind: Literal<"absent">;
+}>]>;
+```
+
+Canonical Effect Schema for one explicit Release lookup result.
+
+---
+
+### releaseCreateSchema
+
+```ts
+const releaseCreateSchema: Union<readonly [Struct<{
+  kind: Literal<"created">;
+  release: Struct<{
+     releaseId: refine<ReleaseId, String>;
+     appId: refine<AppId, String>;
+     artifact: Struct<{
+        artifactRef: refine<ArtifactRef, String>;
+        artifactDigest: refine<Sha256Digest, String>;
+        provenance: Struct<{
+           sourceRevision: refine<..., ...>;
+           sourceTreeDigest: refine<..., ...>;
+           buildRecipeDigest: refine<..., ...>;
+        }>;
+     }>;
+  }>;
+}>, Struct<{
+  kind: Literal<"existing">;
+  release: Struct<{
+     releaseId: refine<ReleaseId, String>;
+     appId: refine<AppId, String>;
+     artifact: Struct<{
+        artifactRef: refine<ArtifactRef, String>;
+        artifactDigest: refine<Sha256Digest, String>;
+        provenance: Struct<{
+           sourceRevision: refine<..., ...>;
+           sourceTreeDigest: refine<..., ...>;
+           buildRecipeDigest: refine<..., ...>;
+        }>;
+     }>;
+  }>;
+}>]>;
+```
+
+Canonical Effect Schema for one explicit Release create-or-observe result.
+
+---
+
+### publicSurfaceReadSchema
+
+```ts
+const publicSurfaceReadSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"found">;
+      surface: Struct<{
+        publicSurfaceId: refine<PublicSurfaceId, String>;
+        appId: refine<AppId, String>;
+        stableRoute: refine<StableRoute, String>;
+      }>;
+    }>,
+    Struct<{
+      kind: Literal<"absent">;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for one explicit public-Surface lookup result.
+
+---
+
+### publicSurfaceCreateSchema
+
+```ts
+const publicSurfaceCreateSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"created">;
+      surface: Struct<{
+        publicSurfaceId: refine<PublicSurfaceId, String>;
+        appId: refine<AppId, String>;
+        stableRoute: refine<StableRoute, String>;
+      }>;
+    }>,
+    Struct<{
+      kind: Literal<"existing">;
+      surface: Struct<{
+        publicSurfaceId: refine<PublicSurfaceId, String>;
+        appId: refine<AppId, String>;
+        stableRoute: refine<StableRoute, String>;
+      }>;
+    }>,
+    Struct<{
+      kind: Literal<"conflict">;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for one public-Surface create-or-observe result.
+
+---
+
+### appTransitionIdSchema
+
+```ts
+const appTransitionIdSchema: declare<AppTransitionId, AppTransitionId>;
+```
+
+The sole Effect Schema wrapper around Cairn's transition codec parser.
+
+---
+
+### appReleaseStoreFailureSchema
+
+```ts
+const appReleaseStoreFailureSchema: Struct<{
+  kind: Literal<"unavailable">;
+}>;
+```
+
+Canonical Effect Schema for a closed App Release store infrastructure failure.
+
+---
+
+### appReadStoreResultSchema
+
+```ts
+const appReadStoreResultSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"success">;
+      value: Codec<
+        | {
+            kind: "found";
+            app: {
+              appId: AppId;
+            };
+          }
+        | {
+            kind: "absent";
+          },
+        | {
+            kind: "found";
+            app: {
+              appId: string;
+            };
+          }
+        | {
+            kind: "absent";
+          },
+        never,
+        never
+      >;
+    }>,
+    Struct<{
+      kind: Literal<"failure">;
+      failure: Struct<{
+        kind: Literal<"unavailable">;
+      }>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for a closed App-read store result envelope.
+
+---
+
+### appCreateStoreResultSchema
+
+```ts
+const appCreateStoreResultSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"success">;
+      value: Codec<
+        | {
+            kind: "created";
+            app: {
+              appId: AppId;
+            };
+          }
+        | {
+            kind: "existing";
+            app: {
+              appId: AppId;
+            };
+          },
+        | {
+            kind: "created";
+            app: {
+              appId: string;
+            };
+          }
+        | {
+            kind: "existing";
+            app: {
+              appId: string;
+            };
+          },
+        never,
+        never
+      >;
+    }>,
+    Struct<{
+      kind: Literal<"failure">;
+      failure: Struct<{
+        kind: Literal<"unavailable">;
+      }>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for a closed App-create store result envelope.
+
+---
+
+### releaseReadStoreResultSchema
+
+```ts
+const releaseReadStoreResultSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"success">;
+      value: Codec<
+        | {
+            kind: "found";
+            release: {
+              releaseId: ReleaseId;
+              appId: AppId;
+              artifact: {
+                artifactRef: ArtifactRef;
+                artifactDigest: Sha256Digest;
+                provenance: {
+                  sourceRevision: SourceRevision;
+                  sourceTreeDigest: Sha256Digest;
+                  buildRecipeDigest: Sha256Digest;
+                };
+              };
+            };
+          }
+        | {
+            kind: "absent";
+          },
+        | {
+            kind: "found";
+            release: {
+              releaseId: string;
+              appId: string;
+              artifact: {
+                artifactRef: string;
+                artifactDigest: string;
+                provenance: {
+                  sourceRevision: string;
+                  sourceTreeDigest: string;
+                  buildRecipeDigest: string;
+                };
+              };
+            };
+          }
+        | {
+            kind: "absent";
+          },
+        never,
+        never
+      >;
+    }>,
+    Struct<{
+      kind: Literal<"failure">;
+      failure: Struct<{
+        kind: Literal<"unavailable">;
+      }>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for a closed Release-read store result envelope.
+
+---
+
+### releaseCreateStoreResultSchema
+
+```ts
+const releaseCreateStoreResultSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"success">;
+      value: Codec<
+        | {
+            kind: "created";
+            release: {
+              releaseId: ReleaseId;
+              appId: AppId;
+              artifact: {
+                artifactRef: ArtifactRef;
+                artifactDigest: Sha256Digest;
+                provenance: {
+                  sourceRevision: SourceRevision;
+                  sourceTreeDigest: Sha256Digest;
+                  buildRecipeDigest: Sha256Digest;
+                };
+              };
+            };
+          }
+        | {
+            kind: "existing";
+            release: {
+              releaseId: ReleaseId;
+              appId: AppId;
+              artifact: {
+                artifactRef: ArtifactRef;
+                artifactDigest: Sha256Digest;
+                provenance: {
+                  sourceRevision: SourceRevision;
+                  sourceTreeDigest: Sha256Digest;
+                  buildRecipeDigest: Sha256Digest;
+                };
+              };
+            };
+          },
+        | {
+            kind: "created";
+            release: {
+              releaseId: string;
+              appId: string;
+              artifact: {
+                artifactRef: string;
+                artifactDigest: string;
+                provenance: {
+                  sourceRevision: string;
+                  sourceTreeDigest: string;
+                  buildRecipeDigest: string;
+                };
+              };
+            };
+          }
+        | {
+            kind: "existing";
+            release: {
+              releaseId: string;
+              appId: string;
+              artifact: {
+                artifactRef: string;
+                artifactDigest: string;
+                provenance: {
+                  sourceRevision: string;
+                  sourceTreeDigest: string;
+                  buildRecipeDigest: string;
+                };
+              };
+            };
+          },
+        never,
+        never
+      >;
+    }>,
+    Struct<{
+      kind: Literal<"failure">;
+      failure: Struct<{
+        kind: Literal<"unavailable">;
+      }>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for a closed Release-create store result envelope.
+
+---
+
+### publicSurfaceReadStoreResultSchema
+
+```ts
+const publicSurfaceReadStoreResultSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"success">;
+      value: Codec<
+        | {
+            kind: "found";
+            surface: {
+              publicSurfaceId: PublicSurfaceId;
+              appId: AppId;
+              stableRoute: StableRoute;
+            };
+          }
+        | {
+            kind: "absent";
+          },
+        | {
+            kind: "found";
+            surface: {
+              publicSurfaceId: string;
+              appId: string;
+              stableRoute: string;
+            };
+          }
+        | {
+            kind: "absent";
+          },
+        never,
+        never
+      >;
+    }>,
+    Struct<{
+      kind: Literal<"failure">;
+      failure: Struct<{
+        kind: Literal<"unavailable">;
+      }>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for a closed public-Surface-read store result envelope.
+
+---
+
+### publicSurfaceCreateStoreResultSchema
+
+```ts
+const publicSurfaceCreateStoreResultSchema: Union<
+  readonly [
+    Struct<{
+      kind: Literal<"success">;
+      value: Codec<
+        | {
+            kind: "created";
+            surface: {
+              publicSurfaceId: PublicSurfaceId;
+              appId: AppId;
+              stableRoute: StableRoute;
+            };
+          }
+        | {
+            kind: "existing";
+            surface: {
+              publicSurfaceId: PublicSurfaceId;
+              appId: AppId;
+              stableRoute: StableRoute;
+            };
+          }
+        | {
+            kind: "conflict";
+          },
+        | {
+            kind: "created";
+            surface: {
+              publicSurfaceId: string;
+              appId: string;
+              stableRoute: string;
+            };
+          }
+        | {
+            kind: "existing";
+            surface: {
+              publicSurfaceId: string;
+              appId: string;
+              stableRoute: string;
+            };
+          }
+        | {
+            kind: "conflict";
+          },
+        never,
+        never
+      >;
+    }>,
+    Struct<{
+      kind: Literal<"failure">;
+      failure: Struct<{
+        kind: Literal<"unavailable">;
+      }>;
+    }>,
+  ]
+>;
+```
+
+Canonical Effect Schema for a closed public-Surface-create store result
+envelope.
+
+---
+
+### decodeAppId
+
+```ts
+const decodeAppId: (input, options?) => Result<AppId, SchemaError>;
+```
+
+Decode one Global App identifier through its canonical closed Effect Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`AppId`](index.md#appid), `SchemaError`\>
+
+---
+
+### decodeReleaseId
+
+```ts
+const decodeReleaseId: (input, options?) => Result<ReleaseId, SchemaError>;
+```
+
+Decode one immutable Release identifier through its canonical closed Effect
+Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`ReleaseId`](index.md#releaseid), `SchemaError`\>
+
+---
+
+### decodePublicSurfaceId
+
+```ts
+const decodePublicSurfaceId: (
+  input,
+  options?,
+) => Result<PublicSurfaceId, SchemaError>;
+```
+
+Decode one public-Surface identifier through its canonical closed Effect Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`PublicSurfaceId`](index.md#publicsurfaceid), `SchemaError`\>
+
+---
+
+### decodeArtifactRef
+
+```ts
+const decodeArtifactRef: (input, options?) => Result<ArtifactRef, SchemaError>;
+```
+
+Decode one bounded artifact reference through its canonical closed Effect
+Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`ArtifactRef`](index.md#artifactref), `SchemaError`\>
+
+---
+
+### decodeIdempotencyKey
+
+```ts
+const decodeIdempotencyKey: (
+  input,
+  options?,
+) => Result<IdempotencyKey, SchemaError>;
+```
+
+Decode one idempotency key through its canonical closed Effect Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`IdempotencyKey`](index.md#idempotencykey), `SchemaError`\>
+
+---
+
+### decodeSourceRevision
+
+```ts
+const decodeSourceRevision: (
+  input,
+  options?,
+) => Result<SourceRevision, SchemaError>;
+```
+
+Decode one pinned source revision through its canonical closed Effect Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`SourceRevision`](index.md#sourcerevision), `SchemaError`\>
+
+---
+
+### decodeSha256Digest
+
+```ts
+const decodeSha256Digest: (
+  input,
+  options?,
+) => Result<Sha256Digest, SchemaError>;
+```
+
+Decode one SHA-256 digest through its canonical closed Effect Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`Sha256Digest`](index.md#sha256digest), `SchemaError`\>
+
+---
+
+### decodeStableRoute
+
+```ts
+const decodeStableRoute: (input, options?) => Result<StableRoute, SchemaError>;
+```
+
+Decode one local stable route through its canonical closed Effect Schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`StableRoute`](index.md#stableroute), `SchemaError`\>
+
+---
+
+### decodeAppTransitionId
+
+```ts
+const decodeAppTransitionId: (
+  input,
+  options?,
+) => Result<AppTransitionId, SchemaError>;
+```
+
+Decode a Cairn-issued App transition identity through its sole wrapper.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<[`AppTransitionId`](index.md#apptransitionid), `SchemaError`\>
+
+---
+
+### decodeArtifactReadResult
+
+```ts
+const decodeArtifactReadResult: (
+  input,
+  options?,
+) => Effect<
+  | {
+      kind: "verified";
+      digest: Sha256Digest;
+      mediaType:
+        | "text/html; charset=utf-8"
+        | "application/vnd.fungi.app-backend+json"
+        | "application/vnd.fungi.app-assets+json"
+        | "application/vnd.fungi.app+json";
+      bytes: object & ImmutableArtifactBytes;
+      byteLength: number;
+    }
+  | {
+      kind: "unavailable";
+    }
+  | {
+      kind: "missing";
+    }
+  | {
+      kind: "digest-mismatch";
+      actualDigest: Sha256Digest;
+    },
+  SchemaError,
+  never
+>;
+```
+
+Decode a hostile artifact-reader result through its canonical closed schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Effect`\< \| \{ `kind`: `"verified"`; `digest`:
+[`Sha256Digest`](index.md#sha256digest); `mediaType`: \|
+`"text/html; charset=utf-8"` \| `"application/vnd.fungi.app-backend+json"` \|
+`"application/vnd.fungi.app-assets+json"` \| `"application/vnd.fungi.app+json"`;
+`bytes`: `object` & [`ImmutableArtifactBytes`](index.md#immutableartifactbytes);
+`byteLength`: `number`; \} \| \{ `kind`: `"unavailable"`; \} \| \{ `kind`:
+`"missing"`; \} \| \{ `kind`: `"digest-mismatch"`; `actualDigest`:
+[`Sha256Digest`](index.md#sha256digest); \}, `SchemaError`, `never`\>
+
+---
+
+### decodeApp
+
+```ts
+const decodeApp: (
+  input,
+  options?,
+) => Result<
+  {
+    appId: AppId;
+  },
+  SchemaError
+>;
+```
+
+Decode a hostile App record through its canonical closed schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<\{ `appId`: [`AppId`](index.md#appid); \}, `SchemaError`\>
+
+---
+
+### decodeRelease
+
+```ts
+const decodeRelease: (
+  input,
+  options?,
+) => Result<
+  {
+    releaseId: ReleaseId;
+    appId: AppId;
+    artifact: {
+      artifactRef: ArtifactRef;
+      artifactDigest: Sha256Digest;
+      provenance: {
+        sourceRevision: SourceRevision;
+        sourceTreeDigest: Sha256Digest;
+        buildRecipeDigest: Sha256Digest;
+      };
+    };
+  },
+  SchemaError
+>;
+```
+
+Decode a hostile Release record through its canonical closed schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<\{ `releaseId`: [`ReleaseId`](index.md#releaseid); `appId`:
+[`AppId`](index.md#appid); `artifact`: \{ `artifactRef`:
+[`ArtifactRef`](index.md#artifactref); `artifactDigest`:
+[`Sha256Digest`](index.md#sha256digest); `provenance`: \{ `sourceRevision`:
+[`SourceRevision`](index.md#sourcerevision); `sourceTreeDigest`:
+[`Sha256Digest`](index.md#sha256digest); `buildRecipeDigest`:
+[`Sha256Digest`](index.md#sha256digest); \}; \}; \}, `SchemaError`\>
+
+---
+
+### decodePublicSurface
+
+```ts
+const decodePublicSurface: (
+  input,
+  options?,
+) => Result<
+  {
+    publicSurfaceId: PublicSurfaceId;
+    appId: AppId;
+    stableRoute: StableRoute;
+  },
+  SchemaError
+>;
+```
+
+Decode a hostile public Surface through its canonical closed schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\<\{ `publicSurfaceId`: [`PublicSurfaceId`](index.md#publicsurfaceid);
+`appId`: [`AppId`](index.md#appid); `stableRoute`:
+[`StableRoute`](index.md#stableroute); \}, `SchemaError`\>
+
+---
+
+### decodeAppReadStoreResult
+
+```ts
+const decodeAppReadStoreResult: (
+  input,
+  options?,
+) => Result<
+  | {
+      kind: "success";
+      value:
+        | {
+            kind: "found";
+            app: {
+              appId: AppId;
+            };
+          }
+        | {
+            kind: "absent";
+          };
+    }
+  | {
+      kind: "failure";
+      failure: {
+        kind: "unavailable";
+      };
+    },
+  SchemaError
+>;
+```
+
+Decode a hostile App-read store result through its canonical closed schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\< \| \{ `kind`: `"success"`; `value`: \| \{ `kind`: `"found"`; `app`:
+\{ `appId`: [`AppId`](index.md#appid); \}; \} \| \{ `kind`: `"absent"`; \}; \}
+\| \{ `kind`: `"failure"`; `failure`: \{ `kind`: `"unavailable"`; \}; \},
+`SchemaError`\>
+
+---
+
+### decodeAppCreateStoreResult
+
+```ts
+const decodeAppCreateStoreResult: (
+  input,
+  options?,
+) => Result<
+  | {
+      kind: "success";
+      value:
+        | {
+            kind: "created";
+            app: {
+              appId: AppId;
+            };
+          }
+        | {
+            kind: "existing";
+            app: {
+              appId: AppId;
+            };
+          };
+    }
+  | {
+      kind: "failure";
+      failure: {
+        kind: "unavailable";
+      };
+    },
+  SchemaError
+>;
+```
+
+Decode a hostile App-create store result through its canonical closed schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\< \| \{ `kind`: `"success"`; `value`: \| \{ `kind`: `"created"`; `app`:
+\{ `appId`: [`AppId`](index.md#appid); \}; \} \| \{ `kind`: `"existing"`; `app`:
+\{ `appId`: [`AppId`](index.md#appid); \}; \}; \} \| \{ `kind`: `"failure"`;
+`failure`: \{ `kind`: `"unavailable"`; \}; \}, `SchemaError`\>
+
+---
+
+### decodeReleaseReadStoreResult
+
+```ts
+const decodeReleaseReadStoreResult: (
+  input,
+  options?,
+) => Result<
+  | {
+      kind: "success";
+      value:
+        | {
+            kind: "found";
+            release: {
+              releaseId: ReleaseId;
+              appId: AppId;
+              artifact: {
+                artifactRef: ArtifactRef;
+                artifactDigest: Sha256Digest;
+                provenance: {
+                  sourceRevision: SourceRevision;
+                  sourceTreeDigest: Sha256Digest;
+                  buildRecipeDigest: Sha256Digest;
+                };
+              };
+            };
+          }
+        | {
+            kind: "absent";
+          };
+    }
+  | {
+      kind: "failure";
+      failure: {
+        kind: "unavailable";
+      };
+    },
+  SchemaError
+>;
+```
+
+Decode a hostile Release-read store result through its canonical closed schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\< \| \{ `kind`: `"success"`; `value`: \| \{ `kind`: `"found"`;
+`release`: \{ `releaseId`: [`ReleaseId`](index.md#releaseid); `appId`:
+[`AppId`](index.md#appid); `artifact`: \{ `artifactRef`:
+[`ArtifactRef`](index.md#artifactref); `artifactDigest`:
+[`Sha256Digest`](index.md#sha256digest); `provenance`: \{ `sourceRevision`:
+[`SourceRevision`](index.md#sourcerevision); `sourceTreeDigest`:
+[`Sha256Digest`](index.md#sha256digest); `buildRecipeDigest`:
+[`Sha256Digest`](index.md#sha256digest); \}; \}; \}; \} \| \{ `kind`:
+`"absent"`; \}; \} \| \{ `kind`: `"failure"`; `failure`: \{ `kind`:
+`"unavailable"`; \}; \}, `SchemaError`\>
+
+---
+
+### decodeReleaseCreateStoreResult
+
+```ts
+const decodeReleaseCreateStoreResult: (
+  input,
+  options?,
+) => Result<
+  | {
+      kind: "success";
+      value:
+        | {
+            kind: "created";
+            release: {
+              releaseId: ReleaseId;
+              appId: AppId;
+              artifact: {
+                artifactRef: ArtifactRef;
+                artifactDigest: Sha256Digest;
+                provenance: {
+                  sourceRevision: SourceRevision;
+                  sourceTreeDigest: Sha256Digest;
+                  buildRecipeDigest: Sha256Digest;
+                };
+              };
+            };
+          }
+        | {
+            kind: "existing";
+            release: {
+              releaseId: ReleaseId;
+              appId: AppId;
+              artifact: {
+                artifactRef: ArtifactRef;
+                artifactDigest: Sha256Digest;
+                provenance: {
+                  sourceRevision: SourceRevision;
+                  sourceTreeDigest: Sha256Digest;
+                  buildRecipeDigest: Sha256Digest;
+                };
+              };
+            };
+          };
+    }
+  | {
+      kind: "failure";
+      failure: {
+        kind: "unavailable";
+      };
+    },
+  SchemaError
+>;
+```
+
+Decode a hostile Release-create store result through its canonical closed
+schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\< \| \{ `kind`: `"success"`; `value`: \| \{ `kind`: `"created"`;
+`release`: \{ `releaseId`: [`ReleaseId`](index.md#releaseid); `appId`:
+[`AppId`](index.md#appid); `artifact`: \{ `artifactRef`:
+[`ArtifactRef`](index.md#artifactref); `artifactDigest`:
+[`Sha256Digest`](index.md#sha256digest); `provenance`: \{ `sourceRevision`:
+[`SourceRevision`](index.md#sourcerevision); `sourceTreeDigest`:
+[`Sha256Digest`](index.md#sha256digest); `buildRecipeDigest`:
+[`Sha256Digest`](index.md#sha256digest); \}; \}; \}; \} \| \{ `kind`:
+`"existing"`; `release`: \{ `releaseId`: [`ReleaseId`](index.md#releaseid);
+`appId`: [`AppId`](index.md#appid); `artifact`: \{ `artifactRef`:
+[`ArtifactRef`](index.md#artifactref); `artifactDigest`:
+[`Sha256Digest`](index.md#sha256digest); `provenance`: \{ `sourceRevision`:
+[`SourceRevision`](index.md#sourcerevision); `sourceTreeDigest`:
+[`Sha256Digest`](index.md#sha256digest); `buildRecipeDigest`:
+[`Sha256Digest`](index.md#sha256digest); \}; \}; \}; \}; \} \| \{ `kind`:
+`"failure"`; `failure`: \{ `kind`: `"unavailable"`; \}; \}, `SchemaError`\>
+
+---
+
+### decodePublicSurfaceReadStoreResult
+
+```ts
+const decodePublicSurfaceReadStoreResult: (
+  input,
+  options?,
+) => Result<
+  | {
+      kind: "success";
+      value:
+        | {
+            kind: "found";
+            surface: {
+              publicSurfaceId: PublicSurfaceId;
+              appId: AppId;
+              stableRoute: StableRoute;
+            };
+          }
+        | {
+            kind: "absent";
+          };
+    }
+  | {
+      kind: "failure";
+      failure: {
+        kind: "unavailable";
+      };
+    },
+  SchemaError
+>;
+```
+
+Decode a hostile public-Surface-read store result through its canonical closed
+schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\< \| \{ `kind`: `"success"`; `value`: \| \{ `kind`: `"found"`;
+`surface`: \{ `publicSurfaceId`: [`PublicSurfaceId`](index.md#publicsurfaceid);
+`appId`: [`AppId`](index.md#appid); `stableRoute`:
+[`StableRoute`](index.md#stableroute); \}; \} \| \{ `kind`: `"absent"`; \}; \}
+\| \{ `kind`: `"failure"`; `failure`: \{ `kind`: `"unavailable"`; \}; \},
+`SchemaError`\>
+
+---
+
+### decodePublicSurfaceCreateStoreResult
+
+```ts
+const decodePublicSurfaceCreateStoreResult: (
+  input,
+  options?,
+) => Result<
+  | {
+      kind: "success";
+      value:
+        | {
+            kind: "created";
+            surface: {
+              publicSurfaceId: PublicSurfaceId;
+              appId: AppId;
+              stableRoute: StableRoute;
+            };
+          }
+        | {
+            kind: "existing";
+            surface: {
+              publicSurfaceId: PublicSurfaceId;
+              appId: AppId;
+              stableRoute: StableRoute;
+            };
+          }
+        | {
+            kind: "conflict";
+          };
+    }
+  | {
+      kind: "failure";
+      failure: {
+        kind: "unavailable";
+      };
+    },
+  SchemaError
+>;
+```
+
+Decode a hostile public-Surface-create store result through its canonical closed
+schema.
+
+#### Parameters
+
+| Parameter  | Type           |
+| ---------- | -------------- |
+| `input`    | `unknown`      |
+| `options?` | `ParseOptions` |
+
+#### Returns
+
+`Result`\< \| \{ `kind`: `"success"`; `value`: \| \{ `kind`: `"created"`;
+`surface`: \{ `publicSurfaceId`: [`PublicSurfaceId`](index.md#publicsurfaceid);
+`appId`: [`AppId`](index.md#appid); `stableRoute`:
+[`StableRoute`](index.md#stableroute); \}; \} \| \{ `kind`: `"existing"`;
+`surface`: \{ `publicSurfaceId`: [`PublicSurfaceId`](index.md#publicsurfaceid);
+`appId`: [`AppId`](index.md#appid); `stableRoute`:
+[`StableRoute`](index.md#stableroute); \}; \} \| \{ `kind`: `"conflict"`; \}; \}
+\| \{ `kind`: `"failure"`; `failure`: \{ `kind`: `"unavailable"`; \}; \},
+`SchemaError`\>
+
+## Functions
+
+### createAppReleaseCore()
+
+```ts
+function createAppReleaseCore(options): AppReleaseCore;
+```
+
+Compose the Effect-native App Release core.
+
+A Release is first compared with its existing immutable record. Only an absent
+Release requires an owner App lookup and an atomic create-or-observe. Every
+closed store failure is mapped at this boundary.
+
+#### Parameters
+
+| Parameter                 | Type                                                                                                                                                                                                                          |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`                 | \{ `store`: [`AppReleaseStore`](#appreleasestore); `artifactReader`: [`AppReleaseArtifactReader`](#appreleaseartifactreader); `artifactPolicy?`: `Readonly`\<\{ `maxBytes`: `number`; `maxManifestBytes?`: `number`; \}\>; \} |
+| `options.store`           | [`AppReleaseStore`](#appreleasestore)                                                                                                                                                                                         |
+| `options.artifactReader`  | [`AppReleaseArtifactReader`](#appreleaseartifactreader)                                                                                                                                                                       |
+| `options.artifactPolicy?` | `Readonly`\<\{ `maxBytes`: `number`; `maxManifestBytes?`: `number`; \}\>                                                                                                                                                      |
+
+#### Returns
+
+[`AppReleaseCore`](#appreleasecore)
+
+---
+
+### createDeterministicMemoryAppReleaseStore()
+
+```ts
+function createDeterministicMemoryAppReleaseStore(
+  options?,
+): PromiseAppReleaseStore;
+```
+
+Compose an in-process deterministic store for the narrow App/Release port.
+
+Store methods mutate only the private collections below. Decisions remain in
+pure helpers, and every returned record is copied, so callers cannot mutate
+retained state after an atomic create-or-observe operation.
+
+#### Parameters
+
+| Parameter                         | Type                                                                                                                                                                    |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`                         | \{ `routes`: \{ `platformRoutes`: readonly `object`[]; `structuralRoutes`: readonly [`StableRoute`](index.md#stableroute)[]; \}; `publishers?`: readonly `object`[]; \} |
+| `options.routes`                  | \{ `platformRoutes`: readonly `object`[]; `structuralRoutes`: readonly [`StableRoute`](index.md#stableroute)[]; \}                                                      |
+| `options.routes.platformRoutes`   | readonly `object`[]                                                                                                                                                     |
+| `options.routes.structuralRoutes` | readonly [`StableRoute`](index.md#stableroute)[]                                                                                                                        |
+| `options.publishers?`             | readonly `object`[]                                                                                                                                                     |
+
+#### Returns
+
+[`PromiseAppReleaseStore`](index.md#promiseappreleasestore)
+
+---
+
+### adaptPromiseAppReleaseStore()
+
+```ts
+function adaptPromiseAppReleaseStore(projection): AppReleaseStore;
+```
+
+Adapt the Promise store projection at the one outer edge.
+
+Rejected Promise work is deliberately collapsed into the closed unavailable
+store outcome; infrastructure detail never crosses into catalog policy.
+
+#### Parameters
+
+| Parameter    | Type                                                        |
+| ------------ | ----------------------------------------------------------- |
+| `projection` | [`PromiseAppReleaseStore`](index.md#promiseappreleasestore) |
+
+#### Returns
+
+[`AppReleaseStore`](#appreleasestore)
+
+---
+
+### adaptPromiseArtifactReader()
+
+```ts
+function adaptPromiseArtifactReader(projection): AppReleaseArtifactReader;
+```
+
+Adapt the Promise artifact-reader projection at the one outer edge.
+
+Successful values remain hostile until the core's canonical schema decodes them.
+A rejected Promise is closed to the reader's unavailable failure.
+
+#### Parameters
+
+| Parameter    | Type                                        |
+| ------------ | ------------------------------------------- |
+| `projection` | [`ArtifactReader`](index.md#artifactreader) |
+
+#### Returns
+
+[`AppReleaseArtifactReader`](#appreleaseartifactreader)