@aldus-runtime/release 0.2.0-next.4 → 0.2.0-next.41

package/dist/executor.js

@@ -23,6 +23,7 @@
  * the work it describes did not.
  */
 import { SCHEMA_VERSION, newEventId, newReleaseId } from "@aldus-runtime/core";
+import { cannotEstablish, isCannotEstablish } from "./adapter.js";
 import { assertBundleValid, deriveIdempotencyKey } from "./bundle.js";
 import { ReleaseErrorCodes, releaseError } from "./errors.js";
 import { latestByKey } from "./ports.js";
@@ -40,6 +41,37 @@ export const OPERATION_STATES = [
     /** Deliberately not attempted — no authority, or nothing to do. */
     "skipped",
 ];
+/** What reconciliation did about one operation. */
+/**
+ * Which reconciliation findings an operator is warned about (§20; #169).
+ *
+ * An **allow-list**, keyed on the action. It was a deny-list — any finding carrying an explanation
+ * except `confirmed_absent` — so every action added later was opted in by default, with nobody
+ * deciding. `not_reconciled_repeatable` was opted in exactly that way, and appeared in the
+ * warnings of every ordinary release of a bundle holding a repeatable operation, reporting that
+ * the expected thing had happened.
+ *
+ * Membership answers the question a warning asks: **did something go differently than intended?**
+ *
+ * - `repaired` — yes. The local record was wrong and had to be corrected.
+ * - `unavailable` — yes. Reconciliation could not run, so an operator is being told that a
+ *   protection they may assume is absent.
+ * - `confirmed_absent` — no. The ordinary path; most operations in a fresh bundle are absent, and
+ *   one line each would bury the two above.
+ * - `not_reconciled_repeatable` — no. The declared, approved state of the bundle. The reason is in
+ *   the reconciliation report for anyone reading it.
+ *
+ * Adding an action now requires either adding it here or leaving it out, and both are decisions.
+ * Neither happens by default.
+ */
+const OPERATOR_FACING_FINDINGS = new Set([
+    "repaired",
+    "unavailable",
+    // Yes. The operation may or may not have happened and nobody can tell — the state an operator
+    // most needs to see, and the one the deny-list would have surfaced by accident rather than by
+    // decision (#169).
+    "cannot_establish",
+]);
 /** Executes release bundles, resumably. */
 export class ReleaseExecutor {
     #adapters;
@@ -91,7 +123,7 @@ export class ReleaseExecutor {
         const latest = latestByKey(await this.#receipts.list(bundle.runId));
         const findings = [];
         const repaired = [];
-        for (const { operation, idempotencyKey } of this.#plan(bundle)) {
+        for (const { operation, criticality, idempotencyKey } of this.#plan(bundle)) {
             const receipt = latest.get(idempotencyKey);
             if (receipt !== undefined && receipt.status !== "pending") {
                 findings.push({
@@ -101,6 +133,21 @@ export class ReleaseExecutor {
                 });
                 continue;
             }
+            // Asked of nothing, because the answer would change nothing. A repeatable operation may be
+            // performed again whatever the destination holds, so querying it buys no decision — and
+            // where reconciliation runs before execution, as it does inside `execute`, a "not there"
+            // reading can mean "the operation before it has not run yet" rather than "it did not
+            // happen". An adapter forced to answer that question has to invent one (#169).
+            if (operation.repeatable !== undefined) {
+                findings.push({
+                    operationId: operation.operationId,
+                    idempotencyKey,
+                    action: "not_reconciled_repeatable",
+                    explanation: `"${operation.operationId}" declares its effect safe to repeat, so the destination ` +
+                        `was not queried: ${operation.repeatable.reason}`,
+                });
+                continue;
+            }
             const adapter = this.#adapters.require(operation.destination);
             if (adapter.lookup === undefined) {
                 findings.push({
@@ -117,8 +164,91 @@ export class ReleaseExecutor {
                 idempotencyKey,
                 runId: bundle.runId,
             };
-            const remote = await adapter.lookup(request);
+            // Guarded, and the guard is criticality-aware. `reconcile` used to `await` this bare, so a
+            // throw from any operation's `lookup` aborted the whole pass before a single `execute` —
+            // a quota error raised while asking about a tidy-up blocked the upload beside it (#169).
+            //
+            // A required operation's throw still aborts. Fail-closed belongs where a mistake publishes
+            // twice; it does not belong where a best-effort tidy-up could not be queried.
+            let remote;
+            try {
+                remote = await adapter.lookup(request);
+            }
+            catch (thrown) {
+                if (criticality === "required")
+                    throw thrown;
+                remote = cannotEstablish(`querying destination "${operation.destination}" failed: ${thrown instanceof Error ? thrown.message : String(thrown)}`);
+            }
+            if (isCannotEstablish(remote)) {
+                // Asked, and no answer. What happens next depends on what the operation is for.
+                if (criticality === "required") {
+                    // Unknown must never license a publish. A required operation whose prior outcome cannot
+                    // be established is refused before anything executes, because performing it might
+                    // repeat it and skipping it might drop it, and neither is a choice to make blind.
+                    throw releaseError(ReleaseErrorCodes.RECONCILIATION_UNAVAILABLE, `Whether required operation "${operation.operationId}" already happened could not be ` +
+                        `established: ${remote.reason}. Executing would risk performing it twice and ` +
+                        "skipping it would risk dropping it, so the bundle is refused until the outcome is " +
+                        "known (contract §17).", {
+                        category: "conflict",
+                        retryable: false,
+                        details: {
+                            runId: bundle.runId,
+                            operationId: operation.operationId,
+                            destination: operation.destination,
+                        },
+                    });
+                }
+                // Best-effort: **no receipt**, and not performed this pass.
+                //
+                // Writing a `skipped` receipt was the obvious thing and it was wrong in the way this whole
+                // issue is about. `skipped` is terminal in both directions — `execute` skips it and
+                // `reconcile` treats it as already recorded — so one momentary query failure permanently
+                // retired the operation for that bundle. At the destination that produced #169 quota
+                // exhaustion is routine, so a rate limit while *asking about* a tidy-up would silently
+                // drop it forever, and the record would say `skipped`: a decision, when what happened was
+                // an unanswered question.
+                //
+                // A durable record of a transient failure is the same defect as a durable record of a
+                // search nobody performed. So the not-performing lives in this pass only — the finding and
+                // the warning say what happened now, and the next pass asks again.
+                //
+                // Not performed either, because executing on an unknown prior state is the other half of
+                // the trap: it might repeat an operation that already happened.
+                findings.push({
+                    operationId: operation.operationId,
+                    idempotencyKey,
+                    action: "cannot_establish",
+                    explanation: `Whether "${operation.operationId}" already happened could not be established, so it ` +
+                        `was not attempted: ${remote.reason}`,
+                });
+                continue;
+            }
+            // Not an issued cannot-establish, so it must be the other arm — and that has to be checked
+            // rather than assumed. An assembled `{ reason: "..." }` is not an issued state, so
+            // `isCannotEstablish` correctly rejects it, and it would then reach `!remote.exists` with
+            // `exists` undefined and be recorded as `confirmed_absent`: a completed search, asserted
+            // from a value that is not a `RemoteState` at all.
+            //
+            // Fifth instance of the same lesson in this contract (#170 has the other four). A narrowing
+            // that trusts the declared type is not a narrowing.
+            if (typeof remote.exists !== "boolean") {
+                throw releaseError(ReleaseErrorCodes.OPERATION_INVALID, `The adapter for destination "${operation.destination}" answered the lookup for ` +
+                    `"${operation.operationId}" with a value that is neither a remote state nor an ` +
+                    "issued `cannotEstablish`. Reading it as absent would record a completed search that " +
+                    "did not happen (contract §17).", {
+                    category: "validation",
+                    retryable: false,
+                    details: {
+                        runId: bundle.runId,
+                        operationId: operation.operationId,
+                        destination: operation.destination,
+                    },
+                });
+            }
             if (!remote.exists) {
+                // Reserved to a `lookup` that actually returned `exists: false`. Every other reason an
+                // operation might not have been found now has its own action, so this one means what it
+                // says: a completed search established that the destination does not hold it (#169).
                 findings.push({
                     operationId: operation.operationId,
                     idempotencyKey,
@@ -151,11 +281,18 @@ export class ReleaseExecutor {
         assertBundleValid(bundle);
         const warnings = [];
         const written = [];
+        // Operations this pass must not attempt, held in memory and never written down. A best-effort
+        // operation whose prior state could not be established is not performed now — executing on an
+        // unknown prior state might repeat something that already happened — and leaves no durable
+        // trace, so the next pass asks again rather than finding a terminal receipt (#169).
+        const unestablished = new Set();
         if (options.reconcile !== false) {
             const report = await this.reconcile(bundle, { actor: options.actor });
             written.push(...report.repaired);
             for (const finding of report.findings) {
-                if (finding.explanation !== undefined && finding.action !== "confirmed_absent") {
+                if (finding.action === "cannot_establish")
+                    unestablished.add(finding.operationId);
+                if (finding.explanation !== undefined && OPERATOR_FACING_FINDINGS.has(finding.action)) {
                     warnings.push(finding.explanation);
                 }
             }
@@ -172,13 +309,27 @@ export class ReleaseExecutor {
                     "succeed.");
                 continue;
             }
+            // Skipped for this pass only. No receipt was written, so a later pass reaches the same
+            // operation with the same undecided state and asks the destination again.
+            if (unestablished.has(operation.operationId))
+                continue;
             const existing = latest.get(idempotencyKey);
             if (existing?.status === "succeeded" || existing?.status === "skipped")
                 continue;
             // An operation whose outcome was never confirmed must not be retried (contract §17). If
             // reconciliation could have resolved it, it already ran above and this receipt would be
             // terminal; reaching here means the destination cannot be queried.
-            if (existing?.status === "pending") {
+            //
+            // Unless the operation says repeating it is safe, which is exactly the fact this refusal
+            // needs and previously had no way to hear. Without it a best-effort tidy-up whose outcome
+            // was once unconfirmed refused **every later release of that bundle** — the same operation
+            // whose failure `execute` treats as a warning, blocking the release forever because one
+            // past attempt went unanswered (#169).
+            if (existing?.status === "pending" && operation.repeatable !== undefined) {
+                warnings.push(`"${operation.operationId}" has an unconfirmed earlier outcome and declares its effect ` +
+                    `safe to repeat, so it is being performed again: ${operation.repeatable.reason}`);
+            }
+            else if (existing?.status === "pending") {
                 throw releaseError(ReleaseErrorCodes.RECONCILIATION_UNAVAILABLE, `"${operation.operationId}" was attempted and its outcome was never confirmed, and ` +
                     `destination "${operation.destination}" cannot be queried to find out. Retrying ` +
                     "would risk performing it twice, so it is refused until the outcome is established.", {
@@ -248,7 +399,7 @@ export class ReleaseExecutor {
         ];
         return entries.map((entry) => ({
             ...entry,
-            idempotencyKey: deriveIdempotencyKey(bundle.bundleId, entry.operation),
+            idempotencyKey: deriveIdempotencyKey(entry.operation),
         }));
     }
     /** Write a receipt and emit its event (contract §6.4, §17). */
@@ -258,6 +409,9 @@ export class ReleaseExecutor {
             schemaVersion: SCHEMA_VERSION,
             releaseId: this.#nextReleaseId(),
             runId: bundle.runId,
+            // Recorded, never keyed on (ADR-0033). The trace can now say which release produced this
+            // receipt; matching still happens on what the operation does, so a resumed bundle finds it.
+            bundleId: bundle.bundleId,
             destination: operation.destination,
             operation: operation.kind,
             idempotencyKey,
@@ -269,6 +423,11 @@ export class ReleaseExecutor {
             ...(outcome.status === "succeeded" && outcome.remoteUrl !== undefined
                 ? { remoteUrl: outcome.remoteUrl }
                 : {}),
+            // Carried through to the durable record. A field an adapter can set and nothing reads is
+            // the defect #107 reported, one contract over.
+            ...(outcome.status === "succeeded" && outcome.note !== undefined
+                ? { note: outcome.note }
+                : {}),
             // `pending` is not terminal, so it carries no completion time (contract §17).
             ...(outcome.status === "pending" ? {} : { completedAt: at }),
             ...(outcome.status === "failed"

package/dist/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -14,11 +14,11 @@
  *
  * @packageDocumentation
  */
-export { AdapterRegistry, RecordingReleaseAdapter, type AdapterOutcome, type RecordingAdapterOptions, type ReleaseAdapter, type ReleaseRequest, type RemoteState, } from "./adapter.js";
+export { AdapterRegistry, RecordingReleaseAdapter, cannotEstablish, isCannotEstablish, type AdapterOutcome, type CannotEstablish, type RecordingAdapterOptions, type ReleaseAdapter, type ReleaseRequest, type RemoteState, } from "./adapter.js";
 export { gateEngineAuthorizer, permitAllAuthorizer, type AuthorityVerdict, type ReleaseAuthorizer, } from "./authorization.js";
 export { assertBundleValid, deriveIdempotencyKey, operationsOf, type ReleaseBundle, } from "./bundle.js";
 export { ReleaseErrorCodes, releaseError, type ReleaseErrorCode } from "./errors.js";
 export { OPERATION_STATES, ReleaseExecutor, type BundleStatus, type ExecuteOptions, type OperationState, type OperationStatus, type ReconciliationFinding, type ReconciliationReport, type ReleaseExecutorOptions, type ReleaseOutcome, } from "./executor.js";
-export { bestEffortOperation, requiredOperation, type BestEffortOperation, type OperationCriticality, type ReleaseOperation, type ReleaseOperationBase, type RequiredOperation, } from "./operation.js";
+export { bestEffortOperation, repeatable, requiredOperation, type RepeatableDeclaration, type BestEffortOperation, type OperationCriticality, type ReleaseOperation, type ReleaseOperationBase, type RequiredOperation, } from "./operation.js";
 export { MemoryReleaseEventSink, MemoryReleaseReceiptStore, eventStoreSink, latestByKey, runStoreReceipts, type ReleaseEventSink, type ReleaseReceiptStore, } from "./ports.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -14,11 +14,11 @@
  *
  * @packageDocumentation
  */
-export { AdapterRegistry, RecordingReleaseAdapter, } from "./adapter.js";
+export { AdapterRegistry, RecordingReleaseAdapter, cannotEstablish, isCannotEstablish, } from "./adapter.js";
 export { gateEngineAuthorizer, permitAllAuthorizer, } from "./authorization.js";
 export { assertBundleValid, deriveIdempotencyKey, operationsOf, } from "./bundle.js";
 export { ReleaseErrorCodes, releaseError } from "./errors.js";
 export { OPERATION_STATES, ReleaseExecutor, } from "./executor.js";
-export { bestEffortOperation, requiredOperation, } from "./operation.js";
+export { bestEffortOperation, repeatable, requiredOperation, } from "./operation.js";
 export { MemoryReleaseEventSink, MemoryReleaseReceiptStore, eventStoreSink, latestByKey, runStoreReceipts, } from "./ports.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,uBAAuB,GAMxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,GAEb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAC;AAErF,OAAO,EACL,gBAAgB,EAChB,eAAe,GAShB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAMlB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,gBAAgB,GAGjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,iBAAiB,GAOlB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,GAEb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAC;AAErF,OAAO,EACL,gBAAgB,EAChB,eAAe,GAShB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,iBAAiB,GAOlB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,gBAAgB,GAGjB,MAAM,YAAY,CAAC"}

package/dist/operation.d.ts

@@ -12,14 +12,38 @@
  * release that reports success. Requiring the caller to *place* the operation in one list or the
  * other makes the mistake a type error rather than a typo.
  */
+declare const CRITICALITY: unique symbol;
+/** @see RepeatableDeclaration */
+declare const REPEATABILITY: unique symbol;
 /**
- * Brand distinguishing the two operation categories at the type level.
+ * A statement that an operation's effect may be performed more than once (§17, §19.1; #169).
+ *
+ * Minted by {@link repeatable} and not writable as an object literal, for the same reason
+ * `RequiredOperation` is not: this licenses re-performing a real external effect, and a shape a
+ * caller can assemble is a shape that gets assembled from configuration by someone who has not
+ * thought about it.
  *
- * Declared but never exported as a value, so an operation of either kind can only come from the
- * constructor below. A caller cannot hand-write an object literal that satisfies
- * {@link RequiredOperation}.
+ * The reason is **required**. An operation that may be repeated is one an approver is being asked
+ * to accept the repetition of, and "safe to repeat" with no account of why is not something anyone
+ * can approve or audit.
  */
-declare const CRITICALITY: unique symbol;
+export interface RepeatableDeclaration {
+    readonly [REPEATABILITY]: "repeatable";
+    /**
+     * Why repeating this effect is safe, for the approver and for the operator.
+     *
+     * Shown in the reconciliation finding that records the operation was not queried, so a reader
+     * sees the justification rather than only the outcome.
+     */
+    readonly reason: string;
+}
+/**
+ * Declare that repeating this operation's effect is safe (§17, §19.1; #169).
+ *
+ * @throws {AldusError} when the reason is empty. A declaration that licenses repetition and says
+ * nothing about why is the thing this exists to prevent.
+ */
+export declare function repeatable(reason: string): RepeatableDeclaration;
 /** Fields shared by both categories. */
 export interface ReleaseOperationBase {
     /**
@@ -63,6 +87,23 @@ export interface ReleaseOperationBase {
      * The gate engine decides whether the authority is held; this package never re-decides it.
      */
     requiresAuthority?: string;
+    /**
+     * Declares that repeating this operation's effect is safe (§17, §19.1; #169).
+     *
+     * **Absent means one-shot**, which is the conservative reading and the behaviour every existing
+     * bundle already has. Repetition is licensed only by saying so.
+     *
+     * In the **bundle**, not on the adapter and not in `RemoteState`. §13.4 binds a release approval
+     * to the bundle, so a fact that licenses re-performing an effect has to be visible in the
+     * artifact an approver approved — an adapter-side flag would let an adapter license repeating an
+     * operation the approver believed happened once.
+     *
+     * Not inferable from {@link ReleaseOperationBase} either. `deriveIdempotencyKey` documents its
+     * result as the key that makes re-running safe, and that holds only where the destination
+     * honours the key; plenty do not. A key's presence is a request, not a guarantee, so
+     * repeatability has to be stated.
+     */
+    repeatable?: RepeatableDeclaration;
     /** Opaque parameters passed through to the adapter. Never inspected here. */
     parameters?: Readonly<Record<string, unknown>>;
 }

package/dist/operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../src/operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AAEzC,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;CACvC;AAED,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAEvE,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,iBAAiB,CAEpF;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,GAAG,mBAAmB,CAExF;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,aAAa,CAAC"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../src/operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AAEzC,iCAAiC;AACjC,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAWhE;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;CACvC;AAED,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAEvE,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,iBAAiB,CAEpF;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,GAAG,mBAAmB,CAExF;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,aAAa,CAAC"}

package/dist/operation.js

@@ -12,6 +12,28 @@
  * release that reports success. Requiring the caller to *place* the operation in one list or the
  * other makes the mistake a type error rather than a typo.
  */
+/**
+ * Brand distinguishing the two operation categories at the type level.
+ *
+ * Declared but never exported as a value, so an operation of either kind can only come from the
+ * constructor below. A caller cannot hand-write an object literal that satisfies
+ * {@link RequiredOperation}.
+ */
+import { ReleaseErrorCodes, releaseError } from "./errors.js";
+/**
+ * Declare that repeating this operation's effect is safe (§17, §19.1; #169).
+ *
+ * @throws {AldusError} when the reason is empty. A declaration that licenses repetition and says
+ * nothing about why is the thing this exists to prevent.
+ */
+export function repeatable(reason) {
+    if (reason.trim().length === 0) {
+        throw releaseError(ReleaseErrorCodes.OPERATION_INVALID, "A repeatable declaration must say why repeating the effect is safe. It licenses performing " +
+            "an external effect more than once, and an approver cannot accept that from a bare flag " +
+            "(contract §13.4, §17).", { category: "validation", retryable: false, details: {} });
+    }
+    return { reason };
+}
 /** Declare an operation whose failure fails the release (contract §17). */
 export function requiredOperation(operation) {
     return { ...operation };

package/dist/operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"operation.js","sourceRoot":"","sources":["../src/operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAkFH,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,SAA+B;IAC/D,OAAO,EAAE,GAAG,SAAS,EAAuB,CAAC;AAC/C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,SAA+B;IACjE,OAAO,EAAE,GAAG,SAAS,EAAyB,CAAC;AACjD,CAAC"}
+{"version":3,"file":"operation.js","sourceRoot":"","sources":["../src/operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8B9D;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,YAAY,CAChB,iBAAiB,CAAC,iBAAiB,EACnC,6FAA6F;YAC3F,yFAAyF;YACzF,wBAAwB,EAC1B,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAA2B,CAAC;AAC7C,CAAC;AA0FD,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,SAA+B;IAC/D,OAAO,EAAE,GAAG,SAAS,EAAuB,CAAC;AAC/C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,SAA+B;IACjE,OAAO,EAAE,GAAG,SAAS,EAAyB,CAAC;AACjD,CAAC"}

package/dist/ports.d.ts

@@ -14,7 +14,7 @@ import type { EventStore, RunStore } from "@aldus-runtime/file-store";
  * There is no update in place and no delete. §17's receipts are an audit record of what was
  * attempted against a destination: an operation retried after a failure produces a second
  * receipt, not an edit to the first, because the fact that the first attempt failed is what
- * explains the retry. {@link latestFor} resolves the current outcome by reading them in order.
+ * explains the retry. {@link latestByKey} resolves the current outcome by reading them in order.
  */
 export interface ReleaseReceiptStore {
     /** Every receipt recorded for a Run, in the order they were appended. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aldus-runtime/release",
-  "version": "0.2.0-next.4",
+  "version": "0.2.0-next.41",
   "type": "module",
   "description": "Aldus Release — release bundles, resumable idempotent operations, adapter contracts, and external-state reconciliation.",
   "license": "Apache-2.0",
@@ -33,12 +33,12 @@
     "typecheck:test": "tsc -p tsconfig.test.json"
   },
   "dependencies": {
-    "@aldus-runtime/core": "0.2.0-next.4",
-    "@aldus-runtime/file-store": "0.2.0-next.4",
-    "@aldus-runtime/gate-engine": "0.2.0-next.4"
+    "@aldus-runtime/core": "0.2.0-next.41",
+    "@aldus-runtime/file-store": "0.2.0-next.41",
+    "@aldus-runtime/gate-engine": "0.2.0-next.41"
   },
   "devDependencies": {
-    "@aldus-runtime/testkit": "0.2.0-next.4",
+    "@aldus-runtime/testkit": "0.2.0-next.41",
     "@types/node": "^26.2.0",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"