docs(client): the SDK retirement notes state the version and the refusal truthfully

Two sentences copied from the inbox door, where both are true, into the runs
door, where neither is:

- 'clamped to 1..100' — nothing on this door clamps. parseIntegerParam throws
  min_value/max_value (query-param.ts:168-173) on the bounds the door reads off
  ListRunsRequestSchema.shape.limit, and the engine is a bare '?? 20'. The
  window is REFUSED outside 1..100, not clamped. Lit control: the real clamp
  in this repo is messaging-service.ts:541.
- 'removed in protocol 18' — PROTOCOL_VERSION is '17.0.0' and the prescription
  publishes '@objectstack/spec 17.5.0'. The SDK was the one surface a CHANGELOG
  reader lands on, disagreeing with the spec about the single fact a retirement
  note exists to state. All three docblocks now carry the published version.

Same stroke: the D3 acceptanceCriteria cited '(ADR route-ownership rule 5)';
no ADR carries that rule. It is AGENTS.md 'Route & surface ownership' rule 5.
Registry mirror regenerated with the generator.

Claude-Session: https://claude.ai/code/session_01UDXER3sdqfeVYpEWZs5mZx
Co-authored-by: Claude <noreply@anthropic.com>

Author: claude

packages/client/src/index.ts

@@ -5537,12 +5537,16 @@ export class ObjectStackClient {
            * List execution runs for a flow.
            *
            * Returns the newest `limit` runs — a WINDOW, not a page. The
-           * `cursor` parameter was removed in protocol 18 (#19365): it was
-           * appended to the query string here and read by nothing on the
-           * server, so a caller paginating by it re-read the first window
-           * forever. Omit `limit` to take the server's window (20, clamped to
-           * 1..100); raise it to see further back. There is no continuation
-           * token — read `hasMore` to learn whether the window was short.
+           * `cursor` parameter was removed in `@objectstack/spec` 17.5.0
+           * (#19365): it was appended to the query string here and read by
+           * nothing on the server, so a caller paginating by it re-read the
+           * first window forever.
+           *
+           * Omit `limit` to take the server's window (20). It is
+           * bounded to 1..100 and a value outside that range is REFUSED with
+           * `400 VALIDATION_FAILED`, never clamped — so raise it deliberately
+           * to see further back. There is no continuation token — read
+           * `hasMore` to learn whether the window was short.
            */
           list: async (flowName: string, options?: { limit?: number }): Promise<{ runs: ExecutionLog[]; hasMore: boolean }> => {
               const route = this.getRoute('automation');
@@ -5616,9 +5620,9 @@ export class ObjectStackClient {
       /**
        * Alias for `automation.runs.list`.
        *
-       * `cursor` was removed in protocol 18 (#19365) — see that method for the
-       * reason. A window, not a page: widen `limit` (1..100, default 20) and
-       * read `hasMore`.
+       * `cursor` was removed in `@objectstack/spec` 17.5.0 (#19365) — see that
+       * method for the reason. A window, not a page: widen `limit`
+       * (1..100, default 20) and read `hasMore`.
        */
       listRuns: async <T extends { runs: ExecutionLog[]; hasMore: boolean } = { runs: ExecutionLog[]; hasMore: boolean }>(
           flowName: string,
@@ -8101,7 +8105,7 @@ export class ScopedEnvironmentClient {
     /**
      * List recent runs for a flow, optionally narrowed to one status.
      *
-     * `cursor` was removed in protocol 18 (#19365) — see
+     * `cursor` was removed in `@objectstack/spec` 17.5.0 (#19365) — see
      * `automation.runs.list` for the reason. A window, not a page: widen
      * `limit` (1..100, default 20) and read `hasMore`.
      */

packages/spec/src/migrations/entries/semantic/18.automation-runs-cursor-retired.ts

@@ -90,7 +90,7 @@ export const entry: SemanticMigration = {
     + 'would not be the one to discover the type was unenforced; this ruling decides it '
     + 'instead — there will be no cursor implementation on this door — so the refusal would '
     + 'be validating a key the contract no longer has. This route declares no closed query '
-    + 'set (ADR route-ownership rule 5), so an unrecognised name has never been refused here '
+    + 'set (AGENTS.md route-ownership rule 5), so an unrecognised name has never been refused here '
     + 'on its own account. '
     + '⚠️ `hasMore` also changes, from a constant to an answer: a request whose window is '
     + 'shorter than the matching run set now receives `hasMore: true` where it previously '

packages/spec/src/migrations/registry.ts

@@ -5887,7 +5887,7 @@ const step18: MigrationStep = {
         + 'would not be the one to discover the type was unenforced; this ruling decides it '
         + 'instead — there will be no cursor implementation on this door — so the refusal would '
         + 'be validating a key the contract no longer has. This route declares no closed query '
-        + 'set (ADR route-ownership rule 5), so an unrecognised name has never been refused here '
+        + 'set (AGENTS.md route-ownership rule 5), so an unrecognised name has never been refused here '
         + 'on its own account. '
         + '⚠️ `hasMore` also changes, from a constant to an answer: a request whose window is '
         + 'shorter than the matching run set now receives `hasMore: true` where it previously '