@uluops/ops-sdk 5.11.0 → 5.11.1

package/CHANGELOG.md

@@ -6,6 +6,34 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [5.11.1] - 2026-08-02
+
+### Fixed
+
+- **Failure-code examples in TSDoc, error messages and README now use canonical codes.**
+  `SEM-VAL` was the worked example in five source sites and two README examples, and it is
+  not a valid code — `VAL` is an `EPI` mode, so `EPI-VAL` exists and `SEM-VAL` does not.
+  Codes are drawn from a closed set rather than composed from a domain and a mode
+  independently — 24 at the time of this fix, 28 since failure-taxonomy v1.1.0 added
+  `STR-ORG`, `SEM-CAT`, `PRA-ACT` and `EPI-SCP`. The count is stated as a range because
+  this entry is a record of a fix, not a live mode list; the authority is the
+  `failure_taxonomy` catalog served by `GET /taxonomy`.
+
+  These are TSDoc, so they surface in consumer IDE tooltips and the generated API docs —
+  the invalid example reached every downstream developer at the point of use. Affected:
+  `types/schemas.ts` (the "invalid failure code format" message), `types/enums.ts` ×2,
+  `config/validators.ts`, `operations/runs.ts` (`@example`), and README.
+
+  Two further non-canonical codes were found in README examples while verifying and are also
+  corrected: `PRA-SEC/C` (`SEC` is not a mode) on a SQL-injection example, now `SEM-INC/C`
+  to match `security-analyst`'s own convention, and a `STR-OMI/M` on a missing-error-handling
+  example, now `PRA-FRA/M`. The `runs.ts` `@example` pairing "Missing null check" now reads
+  `SEM-COM/M`, matching the worked example in the agent render template.
+
+  No behaviour change — the validation regex is unchanged and still checks format, not
+  membership. This corrects what the SDK *teaches*, not what it accepts.
+
+
 ## [5.11.0] - 2026-08-02
 
 ### Changed

package/README.md

@@ -811,7 +811,7 @@ const result = await client.runs.save({
       filePath: 'src/api/client.ts',
       lineNumber: 42,
       description: 'Add try-catch for network errors',
-      failureCode: 'SEM-VAL/M',
+      failureCode: 'PRA-FRA/M',
     },
   ],
   summary: {
@@ -1121,7 +1121,7 @@ Create a user-submitted issue.
 | `filePath` | `string` | No | File path where issue exists |
 | `lineNumber` | `number` | No | Line number |
 | `description` | `string` | No | Detailed description |
-| `failureCode` | `string` | No | Taxonomy code (e.g., `'SEM-VAL/H'`) |
+| `failureCode` | `string` | No | Taxonomy code (e.g., `'STR-OMI/H'`) |
 | `agent` | `string` | No | Agent name (defaults to `'user-submitted'`) |
 
 ```typescript
@@ -1134,7 +1134,7 @@ const issue = await client.issues.create({
   filePath: 'src/auth/login.ts',
   lineNumber: 45,
   description: 'SQL injection vulnerability in login query',
-  failureCode: 'PRA-SEC/C',
+  failureCode: 'SEM-INC/C',
 });
 ```
 

package/dist/config/constants.d.ts

@@ -35,5 +35,5 @@ export { SDK_VERSION };
 /**
  * User agent string for requests
  */
-export declare const USER_AGENT = "@uluops/ops-sdk/5.11.0";
+export declare const USER_AGENT = "@uluops/ops-sdk/5.11.1";
 //# sourceMappingURL=constants.d.ts.map

package/dist/config/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "5.11.0";
+export declare const SDK_VERSION = "5.11.1";
 //# sourceMappingURL=generated-version.d.ts.map

package/dist/config/generated-version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit
-export const SDK_VERSION = '5.11.0';
+export const SDK_VERSION = '5.11.1';
 //# sourceMappingURL=generated-version.js.map

package/dist/config/validators.d.ts

@@ -138,7 +138,7 @@ export declare function validateUpdateRunInput(data: unknown): z.infer<typeof Up
  * @param data - Raw input with required: `project` (1-200), `title` (1-500),
  *   `priority` ('critical' | 'high' | 'suggested' | 'backlog').
  *   Optional: `severity`, `category`, `description` (max 10000), `filePath`, `lineNumber`,
- *   `failureCode` (e.g. 'SEM-VAL/H'), `failureDomain`, `failureMode`, `agent`, `type`.
+ *   `failureCode` (e.g. 'STR-OMI/H'), `failureDomain`, `failureMode`, `agent`, `type`.
  * @returns Validated `CreateUserIssueInput`
  * @throws {InputValidationError} If required fields missing or constraints violated
  */

package/dist/config/validators.js

@@ -202,7 +202,7 @@ export function validateUpdateRunInput(data) {
  * @param data - Raw input with required: `project` (1-200), `title` (1-500),
  *   `priority` ('critical' | 'high' | 'suggested' | 'backlog').
  *   Optional: `severity`, `category`, `description` (max 10000), `filePath`, `lineNumber`,
- *   `failureCode` (e.g. 'SEM-VAL/H'), `failureDomain`, `failureMode`, `agent`, `type`.
+ *   `failureCode` (e.g. 'STR-OMI/H'), `failureDomain`, `failureMode`, `agent`, `type`.
  * @returns Validated `CreateUserIssueInput`
  * @throws {InputValidationError} If required fields missing or constraints violated
  */

package/dist/operations/runs.d.ts

@@ -18,7 +18,7 @@ import { RunSummaryResponseSchema, RunAnalysisResponseSchema, ProjectAnalysisLis
  *   project: 'my-project',
  *   workflowType: 'post-implementation',
  *   agents: [{ name: 'code-validator', score: 85, decision: 'PASS' }],
- *   recommendations: [{ agent: 'code-validator', title: 'Missing null check', priority: 'suggested', failureCode: 'SEM-VAL/M' }],
+ *   recommendations: [{ agent: 'code-validator', title: 'Missing null check', priority: 'suggested', failureCode: 'SEM-COM/M' }],
  * });
  * console.log(result.run.runNumber, result.correlation.newIssues);
  * ```

package/dist/operations/runs.js

@@ -18,7 +18,7 @@ import { validateSaveRunInput, validateArchiveRunsInput, validateUpdateRunInput,
  *   project: 'my-project',
  *   workflowType: 'post-implementation',
  *   agents: [{ name: 'code-validator', score: 85, decision: 'PASS' }],
- *   recommendations: [{ agent: 'code-validator', title: 'Missing null check', priority: 'suggested', failureCode: 'SEM-VAL/M' }],
+ *   recommendations: [{ agent: 'code-validator', title: 'Missing null check', priority: 'suggested', failureCode: 'SEM-COM/M' }],
  * });
  * console.log(result.run.runNumber, result.correlation.newIssues);
  * ```

package/dist/types/enums.d.ts

@@ -186,13 +186,13 @@ export declare const BulkFailureReason: {
 export type BulkFailureReason = (typeof BulkFailureReason)[keyof typeof BulkFailureReason];
 /**
  * Failure code regex pattern
- * Format: DOMAIN-MODE/SEVERITY (e.g., SEM-VAL/H)
+ * Format: DOMAIN-MODE/SEVERITY (e.g., STR-OMI/H)
  * Accepts any uppercase 3-letter domain — not restricted to well-known domains.
  */
 export declare const FAILURE_CODE_PATTERN: RegExp;
 /**
  * Failure mode pattern (without severity)
- * Format: DOMAIN-MODE (e.g., SEM-VAL)
+ * Format: DOMAIN-MODE (e.g., STR-OMI)
  * Accepts any uppercase 3-letter domain — not restricted to well-known domains.
  */
 export declare const FAILURE_MODE_PATTERN: RegExp;

package/dist/types/enums.js

@@ -178,13 +178,13 @@ export const BulkFailureReason = {
 };
 /**
  * Failure code regex pattern
- * Format: DOMAIN-MODE/SEVERITY (e.g., SEM-VAL/H)
+ * Format: DOMAIN-MODE/SEVERITY (e.g., STR-OMI/H)
  * Accepts any uppercase 3-letter domain — not restricted to well-known domains.
  */
 export const FAILURE_CODE_PATTERN = /^[A-Z]{3}-[A-Z]{3}\/[CHMLI]$/;
 /**
  * Failure mode pattern (without severity)
- * Format: DOMAIN-MODE (e.g., SEM-VAL)
+ * Format: DOMAIN-MODE (e.g., STR-OMI)
  * Accepts any uppercase 3-letter domain — not restricted to well-known domains.
  */
 export const FAILURE_MODE_PATTERN = /^[A-Z]{3}-[A-Z]{3}$/;

package/dist/types/schemas.js

@@ -32,7 +32,7 @@ export const IssueTypeSchema = z.enum(ISSUE_TYPES);
 export const NoteTypeSchema = z.enum(NOTE_TYPES);
 export const AvatarMimeTypeSchema = z.enum(AVATAR_MIME_TYPES);
 export const FailureCodeSchema = z.string().regex(FAILURE_CODE_PATTERN, {
-    message: 'Invalid failure code format. Expected: DOMAIN-MODE/SEVERITY (e.g., SEM-VAL/H)',
+    message: 'Invalid failure code format. Expected: DOMAIN-MODE/SEVERITY (e.g., STR-OMI/H)',
 });
 // ============================================
 // AUTH SCHEMAS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uluops/ops-sdk",
-  "version": "5.11.0",
+  "version": "5.11.1",
   "description": "SDK for the UluOps platform API — execution tracking, analytics, and auth",
   "type": "module",
   "main": "dist/index.js",