@orkestrel/scaffold 0.0.139 → 0.0.140

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -81,7 +81,6 @@ const handle = compose<State>([security, boundary], async (_request, context) =>
81
81
 
82
82
  | Name | Kind | Signature | Summary |
83
83
  | --------------------------- | --------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
84
- | `ForeignContract` | interface | `{ expected, is }` | Describes a foreign implementation contract an options key admits — the members its published interface declares, checked as that interface declares them. |
85
84
  | `BoundaryOptions` | interface | `{ expose?, report? }` | Configures `createBoundary` — the error-rendering battery. The factory admits the bag whole, and a refusal is a `ContractError`. The bag must be a plain object; a class instance refuses. |
86
85
  | `TelemetryEntry` | interface | `{ method, pathname, status, duration }` | Represents one access-log-style entry `createTelemetry` records after a response settles — the access-log/timing seam's payload shape. |
87
86
  | `TelemetryOptions` | interface | `{ record }` | Configures `createTelemetry` — the request timing/access-log seam. The factory admits the bag whole, and a refusal is a `ContractError`. The bag must be a plain object; a class instance refuses. |
@@ -227,43 +226,31 @@ const handle = compose<State>([security, boundary], async (_request, context) =>
227
226
 
228
227
  ### Contracts
229
228
 
230
- | Name | Kind | Signature | Summary |
231
- | ------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
232
- | `BOUNDARY_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { expose?: boolean; report?: (...args: never[]) => unknown; }>>` | Admits `BoundaryOptions` whole for `createBoundary`: a boolean `expose` and a function `report`. |
233
- | `TELEMETRY_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ record: (...args: never[]) => unknown; } & {}>>` | Admits `TelemetryOptions` whole for `createTelemetry`: a required function `record`. |
234
- | `COMPRESSION_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { threshold?: number; encodings?: readonly ("deflate" \| "gzip" \| "identity")[]; filter?: (...args: never[]) => unknown; }>>` | Admits `CompressionOptions` whole for `createCompression`: a non-negative finite `threshold`, an `encodings` array of `Encoding` literals, and a function `filter`. |
235
- | `NODE_COMPRESSION_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { threshold?: number; filter?: (...args: never[]) => unknown; }>>` | Admits `NodeCompressionOptions` whole for `createNodeCompression`: a non-negative finite `threshold` and a function `filter`. |
236
- | `SECURITY_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { frame?: "DENY" \| "SAMEORIGIN" \| false; csp?: string \| false; referrer?: string \| false; permissions?: string \| false; coop?: string \| false; corp?: string \| false; cluster?: string \| false; coep?: string \| boolean; hsts?: string \| boolean; identifier?: false \| Readonly<{} & { trust?: boolean; }>; }>>` | Admits `SecurityOptions` whole for `createSecurity`: each header option is a string or `false`, `coep` and `hsts` are a string or a boolean, and `identifier` is `{ trust? }` or `false`. |
237
- | `CORS_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { origin?: string \| readonly string[]; methods?: readonly string[]; headers?: readonly string[]; }>>` | Admits `CORSOptions` whole for `createCORS`: `origin` is a string or a string array, and `methods` and `headers` are string arrays. |
238
- | `DEADLINE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ ms: number; } & { status?: number; }>>` | Admits `DeadlineOptions` whole for `createDeadline`: an integer `ms` from 1 through 2147483647, the range `@orkestrel/timeout` enforces, and an integer `status` from 200 through 599. |
239
- | `FORWARDED_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ proxies: number; } & {}> \| Readonly<{ trusted: readonly string[]; } & {}>>` | Admits `ForwardedOptions` whole for `createForwarded`: exactly one of an integer `proxies` of at least 1 or a `trusted` string array. |
240
- | `ETAG_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { weak?: boolean; }>>` | Admits `ETagOptions` whole for `createETag`: a boolean `weak`. |
241
- | `BEARER_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ verify: (...args: never[]) => unknown; } & { header?: string; scheme?: string; challenge?: { readonly [k: string]: string; }; }>>` | Admits `BearerOptions` whole for `createBearer`: a required function `verify`, string `header` and `scheme`, and a `challenge` record of strings. |
242
- | `LIMITER_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ max: number; window: number; } & { store?: unknown; capacity?: number; key?: (...args: never[]) => unknown; message?: string; clock?: (...args: never[]) => unknown; policy?: boolean; evict?: (...args: never[]) => unknown; }>>` | Admits `LimiterOptions` whole for `createLimiter`: an integer `max` of at least 1, a positive finite `window`, an integer `capacity` of at least 1, and the declared functions; `store` is a foreign key that `LIMITER_STORE_FOREIGN` checks after admission. |
243
- | `SESSION_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ transport: unknown; } & { store?: unknown; ttl?: number; lifetime?: number; capacity?: number; evict?: (...args: never[]) => unknown; create?: (...args: never[]) => unknown; mint?: (...args: never[]) => unknown; required?: boolean; clock?: (...args: never[]) => unknown; }>>` | Admits `SessionOptions` whole for `createSession`: positive finite `ttl` and `lifetime`, an integer `capacity` of at least 1, and the declared functions; `transport` and `store` are foreign keys that `SESSION_TRANSPORT_FOREIGN` and `SESSION_STORE_FOREIGN` check after admission. |
244
- | `COOKIE_TRANSPORT_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ signer: unknown; } & { name?: string; cookie?: Readonly<{} & { path?: string; domain?: string; maxAge?: number; httpOnly?: boolean; secure?: boolean; sameSite?: "Lax" \| "None" \| "Strict"; }>; }>>` | Admits `CookieTransportOptions` whole for `createCookieTransport`: a string `name`, a required `signer`, checked as a foreign key, and an owned `cookie` record of the six optional members `@orkestrel/server` declares: string `path` and `domain`, a finite number `maxAge` (a non-finite value writes `Max-Age=NaN` or `Max-Age=Infinity` into `Set-Cookie`), boolean `httpOnly` and `secure`, and a `sameSite` of `'Strict'`, `'Lax'`, or `'None'`. |
245
- | `HEADER_TRANSPORT_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { header?: string; }>>` | Admits `HeaderTransportOptions` whole for `createHeaderTransport`: a string `header`. |
246
- | `SESSION_LIMITS_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { ttl?: number; lifetime?: number; }>>` | Admits `SessionLimits` whole for `createDatabaseSessionStore`: positive finite `ttl` and `lifetime`. |
247
- | `MEMORY_SESSION_STORE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { ttl?: number; lifetime?: number; capacity?: number; evict?: (...args: never[]) => unknown; }>>` | Admits `MemorySessionStoreOptions` whole for `createMemorySessionStore`: positive finite `ttl` and `lifetime`, an integer `capacity` of at least 1, and a function `evict`. |
248
- | `MEMORY_LIMITER_STORE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { capacity?: number; evict?: (...args: never[]) => unknown; }>>` | Admits `MemoryLimiterStoreOptions` whole for `createMemoryLimiterStore`: an integer `capacity` of at least 1 and a function `evict`. |
249
- | `CSRF_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ signer: unknown; } & { cookie?: string; header?: string; field?: string; safe?: readonly string[]; }>>` | Admits `CSRFOptions` whole for `createCSRF`: a required `signer` that `SIGNER_FOREIGN` checks after admission, string `cookie`, `header`, and `field`, and a `safe` string array. |
250
- | `SCOPE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ paths: string \| readonly string[]; handler: (...args: never[]) => unknown; } & {}>>` | Admits the arguments of `only` and `except` whole: `paths` is a string or a string array, and `handler` is a function. |
251
- | `ASSET_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ source: unknown; } & { store?: unknown; }>>` | Admits `AssetOptions` whole for `createAssets`: both keys are foreign, so `ASSET_SOURCE_FOREIGN` and `ASSET_STORE_FOREIGN` check them after admission. |
252
- | `STATIC_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ root: string; } & { prefix?: string; index?: string; dotfiles?: "allow" \| "deny" \| "ignore"; cache?: number; etag?: boolean; fallback?: boolean \| Readonly<{} & { exclude?: string; }>; }>>` | Admits `StaticOptions` whole for `createStatic`: a non-empty string `root`, a non-negative finite `cache`, a `dotfiles` literal, and a `fallback` that is a boolean or `{ exclude? }`. |
253
- | `MULTIPART_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { limits?: Readonly<{} & { file?: Readonly<{} & { size?: number; count?: number; }>; field?: Readonly<{} & { size?: number; count?: number; }>; total?: number; }>; allowed?: readonly string[]; directory?: string; }>>` | Admits `MultipartOptions` whole for `createMultipart`: non-negative finite sizes and totals, non-negative integer counts, a string array `allowed`, and a string `directory`. |
254
- | `UPLOADED_FILE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ field: string; name: string; size: number; mime: string; validated: boolean; status: "moved" \| "staged"; path: string; } & {}>>` | Admits one `UploadedFile` whole for `createUploadedFile`: string `field`, `name`, `mime`, and `path`, a non-negative finite `size`, a boolean `validated`, and a `status` literal. |
255
- | `LIMITER_STORE_FOREIGN` | const | `import("./types.js").ForeignContract` | Holds the members `LimiterOptions.store` declares: `consume`. |
256
- | `SESSION_TRANSPORT_FOREIGN` | const | `import("./types.js").ForeignContract` | Holds the members `SessionOptions.transport` declares: `read`, `write`, and `clear`. |
257
- | `SESSION_STORE_FOREIGN` | const | `import("./types.js").ForeignContract` | Holds the members `SessionOptions.store` declares: `get`, `set`, and `delete`. |
258
- | `SIGNER_FOREIGN` | const | `import("./types.js").ForeignContract` | Holds the members `CookieTransportOptions.signer` and `CSRFOptions.signer` declare: `sign` and `verify`. |
259
- | `ASSET_SOURCE_FOREIGN` | const | `import("./types.js").ForeignContract` | Holds the members `AssetOptions.source` declares: `read`. |
260
- | `ASSET_STORE_FOREIGN` | const | `import("./types.js").ForeignContract` | Holds the members `AssetOptions.store` declares: `get`, `set`, and `delete`. |
261
-
262
- ### Combinators
263
-
264
- | Name | Kind | Signature | Summary |
265
- | ---------------------- | -------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
266
- | `buildForeignContract` | function | `(members: readonly string[]) => ForeignContract` | Builds a `ForeignContract` whose every declared member is a function — the contract an implementation key admits, such as a store, a transport, or a source. |
229
+ | Name | Kind | Signature | Summary |
230
+ | ------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
231
+ | `BOUNDARY_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { expose?: boolean; report?: (...args: never[]) => unknown; }>>` | Admits `BoundaryOptions` whole for `createBoundary`: a boolean `expose` and a function `report`. |
232
+ | `TELEMETRY_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ record: (...args: never[]) => unknown; } & {}>>` | Admits `TelemetryOptions` whole for `createTelemetry`: a required function `record`. |
233
+ | `COMPRESSION_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { threshold?: number; encodings?: readonly ("deflate" \| "gzip" \| "identity")[]; filter?: (...args: never[]) => unknown; }>>` | Admits `CompressionOptions` whole for `createCompression`: a non-negative finite `threshold`, an `encodings` array of `Encoding` literals, and a function `filter`. |
234
+ | `NODE_COMPRESSION_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { threshold?: number; filter?: (...args: never[]) => unknown; }>>` | Admits `NodeCompressionOptions` whole for `createNodeCompression`: a non-negative finite `threshold` and a function `filter`. |
235
+ | `SECURITY_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { frame?: "DENY" \| "SAMEORIGIN" \| false; csp?: string \| false; referrer?: string \| false; permissions?: string \| false; coop?: string \| false; corp?: string \| false; cluster?: string \| false; coep?: string \| boolean; hsts?: string \| boolean; identifier?: false \| Readonly<{} & { trust?: boolean; }>; }>>` | Admits `SecurityOptions` whole for `createSecurity`: each header option is a string or `false`, `coep` and `hsts` are a string or a boolean, and `identifier` is `{ trust? }` or `false`. |
236
+ | `CORS_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { origin?: string \| readonly string[]; methods?: readonly string[]; headers?: readonly string[]; }>>` | Admits `CORSOptions` whole for `createCORS`: `origin` is a string or a string array, and `methods` and `headers` are string arrays. |
237
+ | `DEADLINE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ ms: number; } & { status?: number; }>>` | Admits `DeadlineOptions` whole for `createDeadline`: an integer `ms` from 1 through 2147483647, the range `@orkestrel/timeout` enforces, and an integer `status` from 200 through 599. |
238
+ | `FORWARDED_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ proxies: number; } & {}> \| Readonly<{ trusted: readonly string[]; } & {}>>` | Admits `ForwardedOptions` whole for `createForwarded`: exactly one of an integer `proxies` of at least 1 or a `trusted` string array. |
239
+ | `ETAG_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { weak?: boolean; }>>` | Admits `ETagOptions` whole for `createETag`: a boolean `weak`. |
240
+ | `BEARER_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ verify: (...args: never[]) => unknown; } & { header?: string; scheme?: string; challenge?: { readonly [k: string]: string; }; }>>` | Admits `BearerOptions` whole for `createBearer`: a required function `verify`, string `header` and `scheme`, and a `challenge` record of strings. |
241
+ | `LIMITER_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ max: number; window: number; } & { store?: Readonly<{ consume: (...args: never[]) => unknown; } & {}>; capacity?: number; key?: (...args: never[]) => unknown; message?: string; clock?: (...args: never[]) => unknown; policy?: boolean; evict?: (...args: never[]) => unknown; }>>` | Admits `LimiterOptions` whole for `createLimiter`: an integer `max` of at least 1, a positive finite `window`, an integer `capacity` of at least 1, and the declared functions; `store` is an implementation that declares the function `consume`. |
242
+ | `SESSION_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ transport: Readonly<{ read: (...args: never[]) => unknown; write: (...args: never[]) => unknown; clear: (...args: never[]) => unknown; } & {}>; } & { store?: Readonly<{ get: (...args: never[]) => unknown; set: (...args: never[]) => unknown; delete: (...args: never[]) => unknown; } & {}>; ttl?: number; lifetime?: number; capacity?: number; evict?: (...args: never[]) => unknown; create?: (...args: never[]) => unknown; mint?: (...args: never[]) => unknown; required?: boolean; clock?: (...args: never[]) => unknown; }>>` | Admits `SessionOptions` whole for `createSession`: positive finite `ttl` and `lifetime`, an integer `capacity` of at least 1, and the declared functions; `transport` is an implementation that declares the functions `read`, `write`, and `clear`, and `store` one that declares `get`, `set`, and `delete`. |
243
+ | `COOKIE_TRANSPORT_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ signer: Readonly<{ sign: (...args: never[]) => unknown; verify: (...args: never[]) => unknown; } & {}>; } & { name?: string; cookie?: Readonly<{} & { path?: string; domain?: string; maxAge?: number; httpOnly?: boolean; secure?: boolean; sameSite?: "Lax" \| "None" \| "Strict"; }>; }>>` | Admits `CookieTransportOptions` whole for `createCookieTransport`: a string `name`, a required `signer` implementation that declares the functions `sign` and `verify`, and an owned `cookie` record of the six optional members `@orkestrel/server` declares: string `path` and `domain`, a finite number `maxAge` (a non-finite value writes `Max-Age=NaN` or `Max-Age=Infinity` into `Set-Cookie`), boolean `httpOnly` and `secure`, and a `sameSite` of `'Strict'`, `'Lax'`, or `'None'`. |
244
+ | `HEADER_TRANSPORT_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { header?: string; }>>` | Admits `HeaderTransportOptions` whole for `createHeaderTransport`: a string `header`. |
245
+ | `SESSION_LIMITS_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { ttl?: number; lifetime?: number; }>>` | Admits `SessionLimits` whole for `createDatabaseSessionStore`: positive finite `ttl` and `lifetime`. |
246
+ | `MEMORY_SESSION_STORE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { ttl?: number; lifetime?: number; capacity?: number; evict?: (...args: never[]) => unknown; }>>` | Admits `MemorySessionStoreOptions` whole for `createMemorySessionStore`: positive finite `ttl` and `lifetime`, an integer `capacity` of at least 1, and a function `evict`. |
247
+ | `MEMORY_LIMITER_STORE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { capacity?: number; evict?: (...args: never[]) => unknown; }>>` | Admits `MemoryLimiterStoreOptions` whole for `createMemoryLimiterStore`: an integer `capacity` of at least 1 and a function `evict`. |
248
+ | `CSRF_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ signer: Readonly<{ sign: (...args: never[]) => unknown; verify: (...args: never[]) => unknown; } & {}>; } & { cookie?: string; header?: string; field?: string; safe?: readonly string[]; }>>` | Admits `CSRFOptions` whole for `createCSRF`: a required `signer` implementation that declares the functions `sign` and `verify`, string `cookie`, `header`, and `field`, and a `safe` string array. |
249
+ | `SCOPE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ paths: string \| readonly string[]; handler: (...args: never[]) => unknown; } & {}>>` | Admits the arguments of `only` and `except` whole: `paths` is a string or a string array, and `handler` is a function. |
250
+ | `ASSET_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ source: Readonly<{ read: (...args: never[]) => unknown; } & {}>; } & { store?: Readonly<{ get: (...args: never[]) => unknown; set: (...args: never[]) => unknown; delete: (...args: never[]) => unknown; } & {}>; }>>` | Admits `AssetOptions` whole for `createAssets`: `source` is an implementation that declares the function `read`, and `store` one that declares `get`, `set`, and `delete`. |
251
+ | `STATIC_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ root: string; } & { prefix?: string; index?: string; dotfiles?: "allow" \| "deny" \| "ignore"; cache?: number; etag?: boolean; fallback?: boolean \| Readonly<{} & { exclude?: string; }>; }>>` | Admits `StaticOptions` whole for `createStatic`: a non-empty string `root`, a non-negative finite `cache`, a `dotfiles` literal, and a `fallback` that is a boolean or `{ exclude? }`. |
252
+ | `MULTIPART_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{} & { limits?: Readonly<{} & { file?: Readonly<{} & { size?: number; count?: number; }>; field?: Readonly<{} & { size?: number; count?: number; }>; total?: number; }>; allowed?: readonly string[]; directory?: string; }>>` | Admits `MultipartOptions` whole for `createMultipart`: non-negative finite sizes and totals, non-negative integer counts, a string array `allowed`, and a string `directory`. |
253
+ | `UPLOADED_FILE_CONTRACT` | const | `import("@orkestrel/contract").ContractInterface<Readonly<{ field: string; name: string; size: number; mime: string; validated: boolean; status: "moved" \| "staged"; path: string; } & {}>>` | Admits one `UploadedFile` whole for `createUploadedFile`: string `field`, `name`, `mime`, and `path`, a non-negative finite `size`, a boolean `validated`, and a `status` literal. |
267
254
 
268
255
  ### Shapers
269
256
 
@@ -298,8 +285,7 @@ const handle = compose<State>([security, boundary], async (_request, context) =>
298
285
  | `verifyCSRFToken` | function | `(signer: SignerInterface, binding: string, token: string) => Promise<boolean>` | Verifies a CSRF token against `binding`: the token's random part must match `CSRF_NONCE_PATTERN`, and its signature must be the signer's HMAC over `CSRF_LABEL`, `binding`, and that random part, under any held key. |
299
286
  | `sessionExpired` | function | `(cursors: SessionCursors, now: number, limits: SessionLimits) => boolean` | Checks whether a session has aged past its idle timeout or absolute lifetime as of `now` — the pure expiry predicate `MemorySessionStore` delegates to. |
300
287
  | `snapshotSession` | function | `(session: SessionInterface) => SessionSnapshot` | Snapshots a session's `state` into a plain, serializable record — the projection a durable store's `set` writes to disk. |
301
- | `admitForeign` | function | `(door: string, path: readonly string[], foreign: ForeignContract, value: unknown) => void` | Admits one foreign implementation key against the members its published interface declares, accepting a class instance and unknown members. |
302
- | `admitOptions` | function | `<T>(door: string, contract: ContractInterface<T>, value: unknown) => void` | Admits an options bag whole against its compiled contract, refusing a missing required key, an undeclared key, and a value outside a declared range. |
288
+ | `admitOptions` | function | `<T>(door: string, contract: ContractInterface<T>, value: unknown) => void` | Admits an options bag whole against its compiled contract through the contract's `own`, refusing a missing required key, an undeclared key, a value outside a declared range, and an implementation key that lacks a member its `interfaceShape` declares. |
303
289
  | `isPreflight` | function | `(method: string, headers: Headers) => boolean` | Determines whether a request is a CORS preflight — an `OPTIONS` request carrying an `Access-Control-Request-Method` header. |
304
290
  | `buildClient` | function | `(ip: string \| undefined) => Client` | Builds the `Client` slice `createForwarded` stashes, from the resolved client IP — a leaf shaping helper. |
305
291
  | `equalsConstantTime` | function | `(a: string, b: string) => boolean` | Compares two strings in constant time when their lengths match, so a per-character mismatch never changes how long the comparison takes. |
@@ -1113,28 +1099,27 @@ still served through the fallback, because the operator configured that path.
1113
1099
 
1114
1100
  ### Admission: option bags admitted whole
1115
1101
 
1116
- Every factory admits its options bag whole through the strict `admitValue` function of `@orkestrel/contract`, against the compiled contract its options interface declares, before it reads a default. The store classes `MemorySessionStore`, `MemoryLimiterStore`, and `DatabaseSessionStore` admit in their constructors, so a direct `new` call and the factory refuse alike, and their messages lead with the class name. A bag must be a plain object: a class instance, an array, `null`, and a primitive refuse. A bag refuses on an undeclared key such as `origins` for `createCORS`, on a missing required key, on a wrong type, on an explicit `undefined`, and on a number outside its range; a `status` lies from 200 through 599, a `ms` is an integer from 1 through 2147483647 (the range `@orkestrel/timeout` enforces), a size is a non-negative finite number, a count is a non-negative integer, and `NaN` refuses everywhere. An absent bag (`undefined`) admits as `{}`, so a factory with a required key refuses it at that key.
1102
+ Every factory admits its options bag whole through the `own` method of the compiled contract its options interface declares, which reads the bag one time and refuses as the strict `admitValue` function of `@orkestrel/contract` does, against the compiled contract its options interface declares, before it reads a default. The store classes `MemorySessionStore`, `MemoryLimiterStore`, and `DatabaseSessionStore` admit in their constructors, so a direct `new` call and the factory refuse alike, and their messages lead with the class name. A bag must be a plain object: a class instance, an array, `null`, and a primitive refuse. A bag refuses on an undeclared key such as `origins` for `createCORS`, on a missing required key, on a wrong type, on an explicit `undefined`, and on a number outside its range; a `status` lies from 200 through 599, a `ms` is an integer from 1 through 2147483647 (the range `@orkestrel/timeout` enforces), a size is a non-negative finite number, a count is a non-negative integer, and `NaN` refuses everywhere. An absent bag (`undefined`) admits as `{}`, so a factory with a required key refuses it at that key.
1117
1103
 
1118
- Each refusal is a `ContractError`, and the message leads with the factory name. A refusal from `admitOptions` reports the first fault's path in `context.path`, every fault in `cause`, and, for an undeclared key, the declared keys in the message. `createForwarded` admits a union of its two forms, so its refusal carries the root path `[]` and a message that lists both forms. A foreign-key check (`admitForeign`) reports the key as `context.path`, such as `['store']`, with a message of the form `createSession: options.store must be an object with function members get, set, delete`. `renderChallenge` and the `createBearer` refusal of a `challenge` that names `error` report `['scheme']` or `['challenge', name]` as `context.path`, and carry no `cause`.
1104
+ Each refusal is a `ContractError`, and the message leads with the factory name. A refusal from `admitOptions` reports the first fault's path in `context.path`, every fault in `cause`, and, for an undeclared key, the declared keys in the message. `createForwarded` admits a union of its two forms, so its refusal carries the root path `[]` and a message that lists both forms. An implementation key that lacks a declared member reports the member as `context.path`, such as `['store', 'get']`, and a value that is not an object reports the key, such as `['store']`. `renderChallenge` and the `createBearer` refusal of a `challenge` that names `error` report `['scheme']` or `['challenge', name]` as `context.path`, and carry no `cause`.
1119
1105
 
1120
- An implementation key (`LimiterOptions.store`, `SessionOptions.transport`, `SessionOptions.store`, `CookieTransportOptions.signer`, `CSRFOptions.signer`, `AssetOptions.source`, and `AssetOptions.store`) is a foreign contract. The bag's contract carries it as present or absent, and `admitForeign` then checks each member the published interface declares, accepts a class instance and unknown members, and refuses a value that is not an object with every declared member a function, with a `ContractError` at the key. It reports the first implementation key that fails, in one sentence that names every member the interface declares, such as `get, set, delete`; it neither names the member that failed nor reports a fault for each member. The `cookie` record of `CookieTransportOptions` is an owned plain record the caller writes: the bag's contract admits its six members (`path`, `domain`, `maxAge`, `httpOnly`, `secure`, `sameSite`) and refuses any other key, so `maxage` refuses. `maxAge` is a finite number because a non-finite value writes `Max-Age=NaN` or `Max-Age=Infinity` into `Set-Cookie`.
1106
+ An implementation key (`LimiterOptions.store`, `SessionOptions.transport`, `SessionOptions.store`, `CookieTransportOptions.signer`, `CSRFOptions.signer`, `AssetOptions.source`, and `AssetOptions.store`) is an `interfaceShape` member of the bag's contract. The shape declares each member the published interface lists as a function. It holds a class instance, a callable, and an object whose prototype carries the members by identity, accepts unknown members, reads each declared member one time on admission and at most two times on a refusal, and refuses a missing member or a member that is not a function with one fault per member at the member's path, such as `['store', 'get']`. The same admission that refuses a malformed bag therefore refuses a malformed implementation key. The `cookie` record of `CookieTransportOptions` is an owned plain record the caller writes: the bag's contract admits its six members (`path`, `domain`, `maxAge`, `httpOnly`, `secure`, `sameSite`) and refuses any other key, so `maxage` refuses. `maxAge` is a finite number because a non-finite value writes `Max-Age=NaN` or `Max-Age=Infinity` into `Set-Cookie`.
1121
1107
 
1122
1108
  ```ts
1123
1109
  import {
1124
- admitForeign,
1125
1110
  admitOptions,
1126
- buildForeignContract,
1127
1111
  CORS_CONTRACT,
1128
1112
  DEADLINE_CONTRACT,
1113
+ SESSION_CONTRACT,
1129
1114
  } from '@orkestrel/middleware'
1130
1115
 
1131
1116
  admitOptions('createCORS', CORS_CONTRACT, { origin: ['https://app.example'] }) // returns
1132
1117
  admitOptions('createCORS', CORS_CONTRACT, { origins: ['https://app.example'] }) // throws a ContractError at ['origins']
1133
1118
  admitOptions('createDeadline', DEADLINE_CONTRACT, { ms: 1_000, status: 1000 }) // throws a ContractError at ['status']
1134
1119
 
1135
- const store = buildForeignContract(['get', 'set', 'delete'])
1136
- admitForeign('createSession', ['store'], store, new Map()) // returns: a class instance with the members
1137
- admitForeign('createSession', ['store'], store, {}) // throws a ContractError at ['store']
1120
+ const transport = { read: () => undefined, write: () => undefined, clear: () => undefined }
1121
+ admitOptions('createSession', SESSION_CONTRACT, { transport, store: new Map() }) // returns: a class instance with the members
1122
+ admitOptions('createSession', SESSION_CONTRACT, { transport, store: {} }) // throws a ContractError at ['store', 'get']
1138
1123
  ```
1139
1124
 
1140
1125
  ### Practices
@@ -1303,7 +1288,7 @@ console.log(extractFieldToken({ csrf: 'credential' }, 'csrf'))
1303
1288
  `resolveForwardedFor` matrices, `detectEncodings`, `compressBytes`, buffering-eligibility
1304
1289
  predicates, `transferSessionState`, `matchesSessionState`, `generateNonce`,
1305
1290
  `signCSRFToken` and `verifyCSRFToken` over the malformed-token table, `isPreflight`, `buildClient`,
1306
- `admitOptions` and `admitForeign`, traversal and SPA-fallback resolution, byte-signature matching, node zlib
1291
+ `admitOptions`, traversal and SPA-fallback resolution, byte-signature matching, node zlib
1307
1292
  compression, multipart limit resolution, boundary extraction, part-header
1308
1293
  parsing, `streamFile`'s pull-driven backpressure and descriptor release, and
1309
1294
  the uploaded-file operations, including `moveUploadedFile`'s cross-device
@@ -1276,8 +1276,7 @@ server, and the supervising Codex process remained present; no synthetic load wa
1276
1276
  - [`lsp.md`](lsp.md) — the dependency mirror for `@orkestrel/lsp`, whose client and stdio client
1277
1277
  transport carry the lint stage's conversation with the Oxlint language server.
1278
1278
  - [`pool.md`](pool.md) — the dependency mirror for `@orkestrel/pool`, which owns stage leases
1279
- and replacement. The catalog refresh carries the published 0.0.15 guide; the release visit must
1280
- refresh it to 0.0.16 alongside the dependency range.
1279
+ and replacement.
1281
1280
  - [`tool.md`](tool.md) — the dependency mirror for `@orkestrel/tool`, whose registry holds it.
1282
1281
  - [`contract.md`](contract.md) — the dependency mirror for `@orkestrel/contract`, whose shapes
1283
1282
  compile both the published tool schema and the guards.
@@ -1266,7 +1266,7 @@ standard error, so a piped value is never polluted.
1266
1266
  | Verb | Value |
1267
1267
  | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1268
1268
  | `new` | `MaterializeResult` — `target`, `written`, `skipped`, `removed` — plus `provenance` |
1269
- | `audit` | `Audit` — `findings` and `questions` — plus `releases` and `provenance`; findings carry `ownership` |
1269
+ | `audit` | `Audit` — `findings` and `questions` — plus `releases` and `provenance`, which carries `guides` when mirrors were compared; findings carry `ownership` |
1270
1270
  | `surface` | `owners` with each owner's `source`, `collisions` with each entry's `standing` (`error`, `recorded`, or `closed`), and `provenance` with `guides` and `record` |
1271
1271
  | `repair` | `MaterializeResult` plus `audit`, the terminal audit taken after the write, `releases`, and `provenance` |
1272
1272
  | `catalog` | `MaterializeResult` plus `mirrors`, `provenance`, optional `membership` with `entries`, `dropped`, and `releases`, and an explanatory `note` on a partial run |
@@ -2260,12 +2260,17 @@ target holds. The refusal is deliberate at `0.0.x` and there is no migration pat
2260
2260
 
2261
2261
  ## Fleet catalog
2262
2262
 
2263
- During `audit`, a present foreign guide whose bytes differ from the hosted guide produces a
2264
- non-blocking question whose `field` is `guides`. Its message names the mirror path and `catalog`
2265
- as the refresh action. The message says
2266
- "differs from the hosted guide": byte inequality establishes no chronology. The question sits
2267
- outside repair findings, so `repair` preserves a present mirror. The target's own guide and its
2268
- guide index are excluded, and the comparison follows the `guides` group selection.
2263
+ During an online `audit` that selects the `guides` group, each present `guides/*.md` mirror is
2264
+ compared with the guide on its package's `main` branch, the read `catalog` performs. A mirror
2265
+ differing from that guide produces a non-blocking question whose `field` is `guides`. Its message
2266
+ names the mirror path and `catalog` as the refresh action, or `catalog --all` when the target does
2267
+ not declare the package. The message says "differs from the guide on" the package's `main` branch:
2268
+ byte inequality establishes no chronology. A mirror that cannot be read from its repository
2269
+ produces a non-blocking `guides` question that names the cause and states that the mirror was not
2270
+ compared. The comparison covers a mirror only when the hosted catalog lists its package. The
2271
+ target's own guide, the guide index, and nested paths are excluded. Offline, `audit` reads no
2272
+ repository and raises no `guides` question. The question sits outside repair findings, so `repair`
2273
+ preserves a present mirror, and the `Materializer` audit raises no guide question.
2269
2274
 
2270
2275
  `catalog` rewrites one marker-bounded region in `CATALOG_AGENT_PATH` and nothing else in that file.
2271
2276
  The region holds a table with these columns:
@@ -2350,7 +2355,10 @@ the baseline toolchain a generated workspace receives is the toolchain scaffold
2350
2355
  browser framework can override a floor through `TOOLCHAIN_HOLDS`. The rows scaffold does
2351
2356
  not install are seeds — `@orkestrel/capture`, `@vitejs/plugin-vue`, `vue`, `vue-tsc`, `vite-plugin-singlefile`, and the
2352
2357
  application-server fleet packages — and each carries the highest triple its supported major served
2353
- when it was written.
2358
+ when it was written. The three application-server fleet seeds (`@orkestrel/middleware`,
2359
+ `@orkestrel/router`, and `@orkestrel/server`) carry the version the committed catalog in
2360
+ `.claude/agents/orkestrel.md` lists, and the constants proof holds them there and checks that the
2361
+ catalog's runtime and peer edges among the three admit the seeded versions.
2354
2362
  [`tests/src/core/constants.test.ts`](../tests/src/core/constants.test.ts) names that seeded set, so a
2355
2363
  row entering or leaving the manifest moves a test rather than passing unnoticed. `sass`, the one row
2356
2364
  of `STYLES_DEV_DEPENDENCIES`, is a seed as well: it carries the `^1.105.1` range the
@@ -2417,7 +2425,8 @@ alike.
2417
2425
 
2418
2426
  ### What each verb reads
2419
2427
 
2420
- `new`, `audit`, and `repair` read declared versions and the vendored host. `catalog` reads
2428
+ `new`, `audit`, and `repair` read declared versions and the vendored host. `audit` also reads the
2429
+ upstream guide of each present guide mirror when the `guides` group is selected. `catalog` reads
2421
2430
  organization membership, its packuments, and the selected guides. `overwrite` reads every surface
2422
2431
  that `repair` and `catalog` read. A network-forced floor is drift except for a successful `new` run;
2423
2432
  an explicit `--offline` floor is intentional, and the verb's result decides its exit. `catalog` has
@@ -2427,13 +2436,13 @@ Each verb resolves a surface's complete answer before it opens that surface's wr
2427
2436
  a partial answer never becomes a partial pin set. `overwrite` keeps the repair and removal work it
2428
2437
  committed before a later catalog refusal and records that refusal in `note`.
2429
2438
 
2430
- | Verb | Reads live | When the network forces a floor | With `--offline` |
2431
- | ----------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
2432
- | `new` | Declared versions and the vendored host | Writes the distributed version and host floors; exits `0` after creating the workspace | Reads no upstream surface, writes the same floors, and exits `0` after creating the workspace |
2433
- | `audit` | Declared versions and the vendored host | Compares through the distributed floors and exits `1` | Compares through the floors; exits `0` for an aligned target or `1` for drift |
2434
- | `repair` | Declared versions and the vendored host | Repairs from the distributed floors and exits `1`, even when the terminal audit is aligned | Repairs from the floors; the terminal audit decides exit `0` or `1` |
2435
- | `catalog` | Organization membership, its packuments, and the selected guides | Refreshes guides alone on a membership outage; refuses version failure; preserves present mirrors or fills absent mirrors from the verified host; exits `1` | Is a usage error; exits `2` and writes nothing |
2436
- | `overwrite` | Everything `repair` and `catalog` read | Keeps completed repair and deletion work, names each floor or refused catalog step in `note`, and exits `1` | Repairs, deletes, and writes version floors; skips `catalog`, records that refusal in `note`, and exits `1` |
2439
+ | Verb | Reads live | When the network forces a floor | With `--offline` |
2440
+ | ----------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
2441
+ | `new` | Declared versions and the vendored host | Writes the distributed version and host floors; exits `0` after creating the workspace | Reads no upstream surface, writes the same floors, and exits `0` after creating the workspace |
2442
+ | `audit` | Declared versions, the vendored host, and the present guide mirrors | Compares through the distributed floors, or reports `provenance.guides` as `floor` after an unread guide, and exits `1` | Compares through the floors and reads no guide; exits `0` for an aligned target or `1` for drift |
2443
+ | `repair` | Declared versions and the vendored host | Repairs from the distributed floors and exits `1`, even when the terminal audit is aligned | Repairs from the floors; the terminal audit decides exit `0` or `1` |
2444
+ | `catalog` | Organization membership, its packuments, and the selected guides | Refreshes guides alone on a membership outage; refuses version failure; preserves present mirrors or fills absent mirrors from the verified host; exits `1` | Is a usage error; exits `2` and writes nothing |
2445
+ | `overwrite` | Everything `repair` and `catalog` read | Keeps completed repair and deletion work, names each floor or refused catalog step in `note`, and exits `1` | Repairs, deletes, and writes version floors; skips `catalog`, records that refusal in `note`, and exits `1` |
2437
2446
 
2438
2447
  A fleet row is compared exactly — `^0.1.0` is stale the moment the registry serves `0.1.2` — and
2439
2448
  that inequality alone raises `audit` to exit `1`. A foreign row is compared inside its declared
@@ -338,7 +338,7 @@ These invariants hold across `src/server` ↔ `server.md`.
338
338
  4. **Startup is bounded and caller-cancellable.** `start(signal?)` observes
339
339
  caller cancellation only while binding; `timeouts.start` independently
340
340
  bounds the bind (`0` permits no startup window) and is an integer from 0
341
- through 2_147_483_647, or construction throws a `TypeError`. Cancellation
341
+ through 2_147_483_647, or construction throws a `ContractError` of code `range`. Cancellation
342
342
  or deadline expiry closes the partial listener, clears the startup
343
343
  deadline, resets the entity to `idle`, and rejects; expiry rejects with a
344
344
  `DOMException` named `TimeoutError`, while caller cancellation rejects
@@ -614,11 +614,11 @@ These invariants hold across `src/server` ↔ `server.md`.
614
614
  `m` is the smaller positive of `headers` and `request` as Node applies
615
615
  them, so each expires at most one such interval after it passes; with
616
616
  neither positive, Node keeps its own interval. Construction refuses,
617
- with a `TypeError` that names the key and its limit, a `headers` or
617
+ with a `ContractError` of code `range` that names the key and its limit, a `headers` or
618
618
  `request` that is not an integer from 0 through 2_147_483_647 and a
619
619
  `keepalive` that is not an integer from 0 through 2_147_482_647, because
620
620
  Node arms `keepalive` plus its buffer as one timer; and it refuses, with a
621
- `TypeError` that names both keys, a `headers` above `request` while
621
+ `ContractError` of code `range` that names both keys, a `headers` above `request` while
622
622
  `request` is positive: Node's own `headersTimeout ≤ requestTimeout`
623
623
  relation. No server timeout bounds the response; a response deadline is
624
624
  a middleware's, such as the `createDeadline` middleware of
@@ -733,7 +733,7 @@ const server = createServer<State>({
733
733
  })
734
734
  ```
735
735
 
736
- The dispatcher of the `@orkestrel/router` release that 0.0.29 depends on
736
+ The dispatcher of the `@orkestrel/router` release that 0.0.30 depends on
737
737
  answers a path that matches with no route for the method with `405` and an
738
738
  `Allow` header that lists `OPTIONS`. It answers a `HEAD` with no `HEAD` route
739
739
  by running the `GET` handler, cancelling that response's body, and sending its
@@ -797,7 +797,7 @@ deadline expires and cuts it. A request that such a connection sends after
797
797
  the listener closes is refused, and its connection is destroyed. A second
798
798
  `stop()` call made during the stop returns the first call's promise. The
799
799
  `drain` option is an integer from 0 through 2_147_483_647 milliseconds, and
800
- construction throws a `TypeError` for any other value.
800
+ construction throws a `ContractError` of code `range` for any other value.
801
801
 
802
802
  ```ts
803
803
  import { createServer } from '@orkestrel/server'
@@ -628,7 +628,7 @@
628
628
  "storage": "claude/agents/orkestrel.md",
629
629
  "destination": ".claude/agents/orkestrel.md",
630
630
  "executable": false,
631
- "digest": "b29b5a278e6c9d64603cdcf794ec6ef04ca1c769d6f7c1b1604905b7a646941e"
631
+ "digest": "5246f3925aa1cfefbeadec36ca8a741fa5ad0fe1e98d72dc160595802c5640da"
632
632
  },
633
633
  {
634
634
  "storage": "claude/agents/planner.md",
@@ -988,7 +988,7 @@
988
988
  "storage": "guides/abort.md",
989
989
  "destination": "guides/abort.md",
990
990
  "executable": false,
991
- "digest": "0e4806f67d06130b9a0f1635d999f30caff87b5e64f3b043202ae826233574db"
991
+ "digest": "698004e4eda87316929093ec1e67dd26f0c29be8c86b96aef40de7777254d41a"
992
992
  },
993
993
  {
994
994
  "storage": "guides/agent.md",
@@ -1006,7 +1006,7 @@
1006
1006
  "storage": "guides/browser.md",
1007
1007
  "destination": "guides/browser.md",
1008
1008
  "executable": false,
1009
- "digest": "cb79077f8e0df55e3eed41eb6636bcc732cb25b0e0e8be79f63a05c72445864c"
1009
+ "digest": "73eaef8bd226bee664e7f9759d0582b57e0c28a962a10cd7603fd0d60c9a76a8"
1010
1010
  },
1011
1011
  {
1012
1012
  "storage": "guides/budget.md",
@@ -1066,7 +1066,7 @@
1066
1066
  "storage": "guides/guide.md",
1067
1067
  "destination": "guides/guide.md",
1068
1068
  "executable": false,
1069
- "digest": "60696bb79f692a605a152cbee706829479e74f2f6ddf1651a5f821f24c68d441"
1069
+ "digest": "8800e587f6b61941240a8f20a52488a42036fda300a4f1c3c83f38bc3e8d1818"
1070
1070
  },
1071
1071
  {
1072
1072
  "storage": "guides/html.md",
@@ -1108,13 +1108,13 @@
1108
1108
  "storage": "guides/mcp.md",
1109
1109
  "destination": "guides/mcp.md",
1110
1110
  "executable": false,
1111
- "digest": "c549421c2e5257cfbe132ad3ad8744ddf3e89b11efee92abd8663cda2feb6d90"
1111
+ "digest": "b6ee90154f7b92988c5e04776d4242412a39d7fa367f9ac0dbac90dee90b18a0"
1112
1112
  },
1113
1113
  {
1114
1114
  "storage": "guides/middleware.md",
1115
1115
  "destination": "guides/middleware.md",
1116
1116
  "executable": false,
1117
- "digest": "d3a06d7904ebff0c028443c59d5b8a223a9c9c0aedb854fc2a03f7e3c078d3bb"
1117
+ "digest": "1933d17f2dbaf8c4fee8570f27cf224767e4f6f1a774b68e2eb0baeb929c0508"
1118
1118
  },
1119
1119
  {
1120
1120
  "storage": "guides/msg.md",
@@ -1144,7 +1144,7 @@
1144
1144
  "storage": "guides/probe.md",
1145
1145
  "destination": "guides/probe.md",
1146
1146
  "executable": false,
1147
- "digest": "fbe5d6256e44088ed571bf64793f876b94e393ccc210a0d914b843625c52b355"
1147
+ "digest": "101bb7d39130f8f8a8224d65e4066cc758a4644cb248bc2c553df99f7ffa4c5b"
1148
1148
  },
1149
1149
  {
1150
1150
  "storage": "guides/process.md",
@@ -1198,7 +1198,7 @@
1198
1198
  "storage": "guides/scaffold.md",
1199
1199
  "destination": "guides/scaffold.md",
1200
1200
  "executable": false,
1201
- "digest": "caabb0824320128d41b44dd5f7c9eaa444da900f402f03b8c8287b70682eb468"
1201
+ "digest": "c7c7aa6d46de191344b01668d7baca2e5a15c61dbce12cc6fe9c6e0215525439"
1202
1202
  },
1203
1203
  {
1204
1204
  "storage": "guides/sea.md",
@@ -1210,7 +1210,7 @@
1210
1210
  "storage": "guides/server.md",
1211
1211
  "destination": "guides/server.md",
1212
1212
  "executable": false,
1213
- "digest": "be54eea16d4c1ba9f1d56e193362d0137bc93bbd624096b68af29db90bfeabff"
1213
+ "digest": "cf2b0b9896b0f229b50f266d0af81f448cd8509503d7dc263f7c6b6b5360469f"
1214
1214
  },
1215
1215
  {
1216
1216
  "storage": "guides/sqlite.md",
@@ -1417,5 +1417,5 @@
1417
1417
  "scripts"
1418
1418
  ],
1419
1419
  "surface": [],
1420
- "digest": "e7ef07eee354d8f155640d7f012d1c538be5579b3d131e925b634e5940bba7b8"
1420
+ "digest": "e3865f03afe2d94007794c961ff1b40d2a6d707265fa6eb722b4aada898a32b7"
1421
1421
  }
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
4
4
  let _orkestrel_emitter = require("@orkestrel/emitter");
5
5
  var package_default = {
6
6
  name: "@orkestrel/scaffold",
7
- version: "0.0.139",
7
+ version: "0.0.140",
8
8
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
9
9
  keywords: [
10
10
  "audit",
@@ -96,20 +96,20 @@ var package_default = {
96
96
  "prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:templates && npm run test:distribution -- --mode release"
97
97
  },
98
98
  dependencies: {
99
- "@orkestrel/console": "^0.0.21",
99
+ "@orkestrel/console": "^0.0.22",
100
100
  "@orkestrel/contract": "^0.0.26",
101
- "@orkestrel/emitter": "^0.0.17",
102
- "@orkestrel/markdown": "^0.0.22",
103
- "@orkestrel/process": "^0.0.21",
104
- "@orkestrel/template": "^0.0.15"
101
+ "@orkestrel/emitter": "^0.0.18",
102
+ "@orkestrel/markdown": "^0.0.23",
103
+ "@orkestrel/process": "^0.0.22",
104
+ "@orkestrel/template": "^0.0.16"
105
105
  },
106
106
  devDependencies: {
107
107
  "@microsoft/api-extractor": "^7.60.1",
108
- "@orkestrel/browser": "^0.0.34",
109
- "@orkestrel/guide": "^0.0.32",
110
- "@orkestrel/html": "^0.0.17",
111
- "@orkestrel/probe": "^0.0.31",
112
- "@orkestrel/test": "^0.0.43",
108
+ "@orkestrel/browser": "^0.0.35",
109
+ "@orkestrel/guide": "^0.0.33",
110
+ "@orkestrel/html": "^0.0.18",
111
+ "@orkestrel/probe": "^0.0.32",
112
+ "@orkestrel/test": "^0.0.44",
113
113
  "@types/node": "^24.19.2",
114
114
  "@vitest/browser-playwright": "^5.1.0",
115
115
  "oxfmt": "^0.79.0",
@@ -902,9 +902,9 @@ var SHOWCASE_OVERRIDES = Object.freeze({ [`vite-plugin-singlefile@${SHOWCASE_DEV
902
902
  /** Lists the development dependencies a private server application adds. */
903
903
  var APP_SERVER_DEV_DEPENDENCIES = Object.freeze({
904
904
  "@orkestrel/emitter": package_default.dependencies["@orkestrel/emitter"],
905
- "@orkestrel/middleware": "^0.0.16",
906
- "@orkestrel/router": "^0.0.10",
907
- "@orkestrel/server": "^0.0.14"
905
+ "@orkestrel/middleware": "^0.0.36",
906
+ "@orkestrel/router": "^0.0.24",
907
+ "@orkestrel/server": "^0.0.30"
908
908
  });
909
909
  // src/core/templates.ts
910
910
  /**