@kortexya/reasoninglayer 4.2.1 → 5.0.0

package/README.md

@@ -119,6 +119,7 @@ await client.inference.forwardChain({ maxIterations: 100 }, { timeoutMs: 600_000
 | `audit`         | Conversation audit chain | append, list, count, verify integrity                              |
 | `analysis`      | Analysis                 | FCA sort discovery, attribute exploration, rule-base certification |
 | `compliance`    | Compliance               | audit receipts, EU AI Act conformity                               |
+| `vocabulary`    | Governed vocabulary      | candidates, assessment, review, release, activation, label search  |
 
 A row per area, not per client — the SDK ships 100 resource clients in all.
 
@@ -233,11 +234,29 @@ try {
 }
 ```
 
+A governed vocabulary refusal (`client.vocabulary`) is a `VocabularyRefusedError` with a
+closed `code`; branch on the code, not on the status:
+
+```typescript
+import { MutationOutcomeUnconfirmedError, VocabularyRefusedError } from '@kortexya/reasoninglayer';
+
+try {
+  await steward.vocabulary.approve(candidateId, request, { idempotencyKey });
+} catch (error) {
+  if (error instanceof MutationOutcomeUnconfirmedError) {
+    // Unknown outcome: repeat with the SAME key, or read error.recovery.
+  } else if (error instanceof VocabularyRefusedError) {
+    console.log(error.status, error.code); // e.g. 403 vocabulary_separation_of_duties
+  }
+}
+```
+
 Error hierarchy:
 
 ```
 ReasoningLayerError
   +-- ApiError (HTTP 4xx/5xx: status, errorCode, body, headers) and its subclasses
+  |     +-- VocabularyRefusedError (code, current, findings, conflicts, authority, plugin, refusal)
   +-- TimeoutError
   +-- ValidationError
   +-- NetworkError
@@ -303,7 +322,7 @@ pnpm run typecheck              # Type check (tsc --noEmit)
 pnpm test                       # Run tests
 pnpm run test:watch             # Watch mode
 pnpm run lint                   # Lint (eslint src/ tests/)
-pnpm run test:ci                # Full gate: typecheck + lint + test
+pnpm run test:ci                # Full gate: typecheck + lint + format + request options + normalizer drops + test
 pnpm run update-api-spec [url]  # Fetch backend OpenAPI spec + regenerate src/api-spec/generated/
 pnpm run docs:build             # Build documentation site
 ```
@@ -316,7 +335,7 @@ pnpm run docs:build             # Build documentation site
 
 | SDK Version | Min Backend Version | Node | Browser |
 | ----------- | ------------------- | ---- | ------- |
-| 4.2.0       | engine `cfd780622`  | 20+  | ES2022+ |
+| 5.0.0       | engine `feafe936f`  | 20+  | ES2022+ |
 
 ## License