Skip to content

Commit 47eea7a

Browse files
committed
chore(docs): regenerate the api reference from the merged tree
The merge of `origin/main` brought fourteen newly registered error codes into `ERROR_CODE_LEDGER`; this branch adds three. Neither side's bytes can be text merged into the other — both files are generated — so `os-regen-merge.sh` took main's side in the merge commit and this commit re-derives them from the merged source with `gen:schema && gen:docs`. `contract.mdx`'s `Enum<... +N more>` counter reads `+325` = main's `+322` plus this branch's three. `error-code-ledger.mdx` carries both sides' rows; all four hook-result codes (the three added here and the `find()` sibling) are present. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018rzQyhLGC5iVs11V3TzRs5
1 parent e031554 commit 47eea7a

2 files changed

Lines changed: 37 additions & 5 deletions

File tree

content/docs/references/api/contract.mdx

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ const result = ApiErrorSchema.parse(data);
2727

2828
| Property | Type | Required | Description |
2929
| :--- | :--- | :--- | :--- |
30-
| **code** | `Enum<'VALIDATION_ERROR' \| 'INVALID_FIELD' \| 'MISSING_REQUIRED_FIELD' \| 'INVALID_FORMAT' \| 'VALUE_TOO_LONG' \| 'VALUE_TOO_SHORT' \| 'VALUE_OUT_OF_RANGE' \| … +311 more>` || Error code (e.g. VALIDATION_ERROR; StandardErrorCode ∪ the ledger the serving side registers — ERROR_CODE_LEDGER for framework packages) |
30+
| **code** | `Enum<'VALIDATION_ERROR' \| 'INVALID_FIELD' \| 'MISSING_REQUIRED_FIELD' \| 'INVALID_FORMAT' \| 'VALUE_TOO_LONG' \| 'VALUE_TOO_SHORT' \| 'VALUE_OUT_OF_RANGE' \| … +325 more>` || Error code (e.g. VALIDATION_ERROR; StandardErrorCode ∪ the ledger the serving side registers — ERROR_CODE_LEDGER for framework packages) |
3131
| **declaredCode** | `string` | optional | The producer-declared code, verbatim, when it is not a member of the closed `code` vocabulary — the open, author-authored channel (app-specific spellings; ADR-0112) |
3232
| **message** | `string` || Readable error message |
3333
| **userMessage** | `string` | optional | Producer-marked user-facing refusal text, verbatim. Present exactly when the producer opted in at throw time; consumers render it to end users and keep their generic substitution for anything unmarked. Status-agnostic; never replaces `message`. |
@@ -142,6 +142,8 @@ const result = ApiErrorSchema.parse(data);
142142
* `DOMAIN_VERIFICATION_DISABLED`
143143
* `DOMAIN_VERIFICATION_FAILED`
144144
* `DRIVER_UNAVAILABLE`
145+
* `DUPLICATE_ARTIFACT_OBJECT_NAME`
146+
* `DUPLICATE_ARTIFACT_PACKAGE`
145147
* `DUPLICATE_REQUEST`
146148
* `DUPLICATE_SOURCE_NOT_A_BASE`
147149
* `ELIGIBILITY_UNEVALUABLE`
@@ -197,6 +199,8 @@ const result = ApiErrorSchema.parse(data);
197199
* `IMPORT_JOB_CREATE_FAILED`
198200
* `IMPORT_ROW_FAILED`
199201
* `INTERNAL`
202+
* `INVALID_ARTIFACT_PACKAGES`
203+
* `INVALID_ARTIFACT_PACKAGE_ENTRY`
200204
* `INVALID_EMAIL`
201205
* `INVALID_EXPIRY`
202206
* `INVALID_METADATA`
@@ -223,17 +227,21 @@ const result = ApiErrorSchema.parse(data);
223227
* `MARKETPLACE_PROXY_FAILED`
224228
* `MARKETPLACE_STORAGE_FAILED`
225229
* `MARKETPLACE_UNAVAILABLE`
230+
* `MEMORY_MULTI_TENANT_UNSUPPORTED`
226231
* `METADATA_BRANCH`
227232
* `METADATA_CONFLICT`
228233
* `METADATA_NOT_FOUND`
229234
* `METADATA_SCHEMA_INVALID`
235+
* `MIXED_ARTIFACT_COLLECTION_SHAPE`
236+
* `MONGODB_MULTI_TENANT_UNSUPPORTED`
230237
* `MULTI_UPDATE_HOOK_KEY_DIVERGENCE`
231238
* `NAMESPACE_CONFLICT`
232239
* `NAMESPACE_PREFIX`
233240
* `NEEDS_PASSWORD`
234241
* `NODE_FAILURE`
235242
* `NOTHING_TO_PURGE`
236243
* `NOT_ATTEMPTED`
244+
* `NOT_COMPENSABLE`
237245
* `NOT_CREATABLE`
238246
* `NOT_FOUND`
239247
* `NOT_OVERRIDABLE`
@@ -243,6 +251,7 @@ const result = ApiErrorSchema.parse(data);
243251
* `NO_IDENTITY`
244252
* `NO_MATCH`
245253
* `NO_PENDING_VERIFICATION`
254+
* `NO_SUCH_RUN`
246255
* `OAUTH_REGISTER_FAILED`
247256
* `OBJECT_API_DISABLED`
248257
* `OBJECT_API_METHOD_NOT_ALLOWED`
@@ -262,10 +271,13 @@ const result = ApiErrorSchema.parse(data);
262271
* `PAYLOAD_TOO_LARGE`
263272
* `PERMISSION_NOT_ALLOWED`
264273
* `PHONE_NOT_ENABLED`
274+
* `PLAN_CHANGED`
275+
* `PLUGIN_CONTRACT_VIOLATION`
265276
* `PLUGIN_INSTALL_FAILED`
266277
* `PLUGIN_MANIFEST_INVALID`
267278
* `PLUGIN_REGISTER_FAILED`
268279
* `PLUGIN_UI_REQUIRED_KEY_MISSING`
280+
* `PREFLIGHT_FAILED`
269281
* `PROJECT_MEMBERSHIP_REQUIRED`
270282
* `PROJECT_NOT_FOUND`
271283
* `PROJECT_PROVISIONING`
@@ -304,6 +316,7 @@ const result = ApiErrorSchema.parse(data);
304316
* `SCHEDULES_LIST_FAILED`
305317
* `SCHEDULE_DELETE_FAILED`
306318
* `SELF_REGISTRATION_CLOSED`
319+
* `SERVICE_NOT_REGISTERED`
307320
* `SETTINGS_ACTION_FAILED`
308321
* `SETTINGS_CRYPTO_UNAVAILABLE`
309322
* `SETTINGS_ENGINE_NOT_BOUND`
@@ -354,6 +367,7 @@ const result = ApiErrorSchema.parse(data);
354367
* `VALIDATION_FAILED`
355368
* `VERSION_NOT_FOUND`
356369
* `VERSION_NOT_RESTORABLE`
370+
* `WALLED_MEMBERSHIP_POLICY_UNDECLARED`
357371
* `WRITABLE_PACKAGE_REQUIRED`
358372
* `WRONG_PASSWORD`
359373

content/docs/references/api/error-code-ledger.mdx

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -161,10 +161,14 @@ best-effort catch that logs and continues. Its throw site and constant
161161
host boot matching is not wire vocabulary.
162162
⚠️ That SECOND ground is superseded by #16404 ("Door or no door" above): a
163163
boot refusal that ships in `dist` is owed a row, so the codes left out or
164-
retired on the "not wire vocabulary" reasoning — the remaining
165-
`boot-refusal` rows of `dispatcher-error-vocabulary.ts` — are registrations
166-
owed under the ruling, not re-argued per card. What still retires a row is
167-
the FIRST ground only: no producer left anywhere in `packages/**` source.
164+
retired on the "not wire vocabulary" reasoning were registrations owed
165+
under the ruling, not re-argued per card — #16449 registered the nine
166+
measured on its tree, and #16649 the fourteen `boot-refusal` rows
167+
`dispatcher-error-vocabulary.ts` still carried, among them
168+
`MONGODB_MULTI_TENANT_UNSUPPORTED` itself, back under
169+
`@objectstack/driver-mongodb` with the #8035 removal reversed on the
170+
record. What still retires a row is the FIRST ground only: no producer
171+
left anywhere in `packages/**` source.
168172
Before deleting a row, check that no producer remains repo-wide AND
169173
that no consumer — including `objectui` and `cloud` — reads the literal;
170174
tests that merely CONSTRUCT the code are not producers, and a test pinned to
@@ -297,6 +301,8 @@ const result = ErrorCode.parse(data);
297301
* `DOMAIN_VERIFICATION_DISABLED`
298302
* `DOMAIN_VERIFICATION_FAILED`
299303
* `DRIVER_UNAVAILABLE`
304+
* `DUPLICATE_ARTIFACT_OBJECT_NAME`
305+
* `DUPLICATE_ARTIFACT_PACKAGE`
300306
* `DUPLICATE_REQUEST`
301307
* `DUPLICATE_SOURCE_NOT_A_BASE`
302308
* `ELIGIBILITY_UNEVALUABLE`
@@ -352,6 +358,8 @@ const result = ErrorCode.parse(data);
352358
* `IMPORT_JOB_CREATE_FAILED`
353359
* `IMPORT_ROW_FAILED`
354360
* `INTERNAL`
361+
* `INVALID_ARTIFACT_PACKAGES`
362+
* `INVALID_ARTIFACT_PACKAGE_ENTRY`
355363
* `INVALID_EMAIL`
356364
* `INVALID_EXPIRY`
357365
* `INVALID_METADATA`
@@ -378,17 +386,21 @@ const result = ErrorCode.parse(data);
378386
* `MARKETPLACE_PROXY_FAILED`
379387
* `MARKETPLACE_STORAGE_FAILED`
380388
* `MARKETPLACE_UNAVAILABLE`
389+
* `MEMORY_MULTI_TENANT_UNSUPPORTED`
381390
* `METADATA_BRANCH`
382391
* `METADATA_CONFLICT`
383392
* `METADATA_NOT_FOUND`
384393
* `METADATA_SCHEMA_INVALID`
394+
* `MIXED_ARTIFACT_COLLECTION_SHAPE`
395+
* `MONGODB_MULTI_TENANT_UNSUPPORTED`
385396
* `MULTI_UPDATE_HOOK_KEY_DIVERGENCE`
386397
* `NAMESPACE_CONFLICT`
387398
* `NAMESPACE_PREFIX`
388399
* `NEEDS_PASSWORD`
389400
* `NODE_FAILURE`
390401
* `NOTHING_TO_PURGE`
391402
* `NOT_ATTEMPTED`
403+
* `NOT_COMPENSABLE`
392404
* `NOT_CREATABLE`
393405
* `NOT_FOUND`
394406
* `NOT_OVERRIDABLE`
@@ -398,6 +410,7 @@ const result = ErrorCode.parse(data);
398410
* `NO_IDENTITY`
399411
* `NO_MATCH`
400412
* `NO_PENDING_VERIFICATION`
413+
* `NO_SUCH_RUN`
401414
* `OAUTH_REGISTER_FAILED`
402415
* `OBJECT_API_DISABLED`
403416
* `OBJECT_API_METHOD_NOT_ALLOWED`
@@ -417,10 +430,13 @@ const result = ErrorCode.parse(data);
417430
* `PAYLOAD_TOO_LARGE`
418431
* `PERMISSION_NOT_ALLOWED`
419432
* `PHONE_NOT_ENABLED`
433+
* `PLAN_CHANGED`
434+
* `PLUGIN_CONTRACT_VIOLATION`
420435
* `PLUGIN_INSTALL_FAILED`
421436
* `PLUGIN_MANIFEST_INVALID`
422437
* `PLUGIN_REGISTER_FAILED`
423438
* `PLUGIN_UI_REQUIRED_KEY_MISSING`
439+
* `PREFLIGHT_FAILED`
424440
* `PROJECT_MEMBERSHIP_REQUIRED`
425441
* `PROJECT_NOT_FOUND`
426442
* `PROJECT_PROVISIONING`
@@ -459,6 +475,7 @@ const result = ErrorCode.parse(data);
459475
* `SCHEDULES_LIST_FAILED`
460476
* `SCHEDULE_DELETE_FAILED`
461477
* `SELF_REGISTRATION_CLOSED`
478+
* `SERVICE_NOT_REGISTERED`
462479
* `SETTINGS_ACTION_FAILED`
463480
* `SETTINGS_CRYPTO_UNAVAILABLE`
464481
* `SETTINGS_ENGINE_NOT_BOUND`
@@ -509,6 +526,7 @@ const result = ErrorCode.parse(data);
509526
* `VALIDATION_FAILED`
510527
* `VERSION_NOT_FOUND`
511528
* `VERSION_NOT_RESTORABLE`
529+
* `WALLED_MEMBERSHIP_POLICY_UNDECLARED`
512530
* `WRITABLE_PACKAGE_REQUIRED`
513531
* `WRONG_PASSWORD`
514532

0 commit comments

Comments
 (0)