@uluops/ops-sdk 3.3.0 → 3.4.0

package/CHANGELOG.md

@@ -6,6 +6,76 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.4.0] - 2026-06-16
+
+Consumer-experience polish from a `consumer-validate` pipeline run (docs 93 /
+public-interface 91 / dx 88, all gates passed). No runtime behavior changes to
+existing successful calls; one error type is now more specific (see Changed).
+
+### Security
+
+- **Defensive string-length ceilings on issue-domain response fields (CWE-20).**
+  Completes the bounding started in 3.2.1, which covered only the history-event
+  schemas: `IssueResponseSchema` (fingerprint, title, failureMode, category,
+  agent, filePath), `OccurrenceResponseSchema` (agentName, description, filePath),
+  `IssueNoteResponseSchema` (content, createdBy), and `StatusHistoryResponseSchema`
+  (reason) now carry `.max()` bounds set at-or-above the tracker DB column sizes
+  (verified against prod 2026-06-16, with margin against future widenings). An
+  unbounded `z.string()` let a degenerate or malicious server force a large heap
+  allocation on the calling host before any consumer-side gate could run (the CLI
+  consumes these schemas in issue-picker mode and `formatIssue`); oversized
+  payloads now throw `ZodError` at parse time instead. Compliant servers are
+  unaffected. The reusable `MAX_*` ceiling constants are consolidated above the
+  schemas, and `createMockIssue` now eagerly validates against the schema so a
+  malformed/oversized test fixture fails at construction. Two tests assert the
+  bound fires on an oversized title (600 chars) and fingerprint (200 chars).
+
+### Fixed
+
+- **`bulkUpdateStatus` README example corrected.** The example iterated the result
+  in a `for…of` loop and read `result.success` / `result.issueId` / `result.error` —
+  but the method returns an aggregate object `{ updated: number, failed: string[] }`,
+  so the documented code threw `TypeError: results is not iterable` at runtime. The
+  API and TypeScript types were always correct; only the example was wrong.
+- **`NotFoundError.details` README comment corrected** to the real shape
+  (`{ resource: "Project '…' not found" }`, not `{ id: '…' }`).
+- **`client.issues.search()` `query` parameter documented as optional** (it is
+  `query?: string`; filter-only searches are valid) — the parameter table previously
+  marked it required.
+- **Stale README version header** (was `3.2.1`) updated.
+
+### Changed
+
+- **`OpsHttpClient` now throws `InputValidationError` (not a base `Error`) for an
+  invalid `orgSlug`.** Aligns with every other constructor-time validation so callers
+  branching on `instanceof InputValidationError` catch it. `InputValidationError`
+  extends `Error`, so existing `instanceof Error` / catch-all handlers are unaffected.
+
+### Docs
+
+- **`client.issues.softDelete(issueId)` is now documented** in the README Issue
+  Operations section (previously the only public method with no README entry).
+- **Error type guards documented.** Added a "Type Guards" section covering all twelve
+  guards (`isNotFoundError`, `isRateLimitError`, …) exported from `@uluops/ops-sdk/errors`.
+- **Every `OpsClient` namespace delegate now carries inline JSDoc**, so IDE hover over
+  `client.runs.save`, `client.issues.search`, etc. surfaces a summary and an
+  `@see` link to the underlying operation instead of a bare signature.
+- **`loadCredentials` / `loadConfig` gained full `@param`/`@returns` JSDoc** documenting
+  the `options > env > file` priority chain, plus a JSDoc block on the `OpsHttpClient`
+  constructor, `buildIssueListParams`, and the config import example at the package root
+  (now showing `loadConfig`, `loadEnvFiles`, `ENV_VARS`, `API_KEY_PREFIX`).
+- **TypeDoc API-reference generation added** (`npm run docs:api` → `docs/api`,
+  `@internal` excluded). `typedoc` added as a dev dependency.
+
+### Internal
+
+- **Leaked internal helpers tagged `@internal`** (no longer surfaced in generated docs;
+  still exported to avoid a breaking change): `createErrorFromStatus`
+  (`@uluops/ops-sdk/errors`); `getGlobalConfigDir`, `getCredentialsPath`,
+  `loadStoredCredentials`, `isApiKey`, `validateCredentials`, `validateUuid`,
+  `validateRequiredString`, `validatePositiveInt` (`@uluops/ops-sdk/config`). These are
+  plumbing re-exported for advanced/tooling consumers and are not covered by semver.
+
 ## [3.3.0] - 2026-06-16
 
 ### Changed

package/README.md

@@ -11,7 +11,7 @@
 
 Official TypeScript SDK with Zod runtime validation for the UluOps platform API. Track execution runs, manage issues, analyze trends, and integrate agent pipelines into your workflow.
 
-**Current version: 3.2.1** | [Changelog](./CHANGELOG.md)
+**Current version: 3.4.0** | [Changelog](./CHANGELOG.md)
 
 ## Quick Start
 
@@ -227,8 +227,15 @@ import {
   RateLimitError,
 } from '@uluops/ops-sdk/errors';
 
-// Config utilities
-import { loadCredentials, DEFAULT_BASE_URL } from '@uluops/ops-sdk/config';
+// Config utilities (also re-exported from the package root)
+import {
+  loadCredentials,   // resolve credentials from options > env > credentials.json
+  loadConfig,        // resolve full config (credentials + connection settings)
+  loadEnvFiles,      // load .env files into process.env before reading config
+  DEFAULT_BASE_URL,  // default API base URL
+  ENV_VARS,          // map of the env var names the SDK reads
+  API_KEY_PREFIX,    // expected API key prefix ('ulr_')
+} from '@uluops/ops-sdk/config';
 ```
 
 ### Package Exports
@@ -1058,7 +1065,7 @@ Search issues across projects.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `query` | `string` | Yes | Search query |
+| `query` | `string` | No | Search query (omit for filter-only searches) |
 | `projects` | `string[]` | No | Filter by projects |
 | `agents` | `string[]` | No | Filter by agents |
 | `status` | `Status` | No | Filter by status |
@@ -1203,6 +1210,14 @@ Restore a soft-deleted issue.
 const issue = await client.issues.restore('issue-uuid');
 ```
 
+#### `client.issues.softDelete(issueId)`
+
+Soft-delete an active issue. Reversible via `restore()`. Returns `{ deleted: true }`.
+
+```typescript
+await client.issues.softDelete('issue-uuid');
+```
+
 #### `client.issues.undoLastChange(issueId)`
 
 Undo the last status change on an issue.
@@ -1221,12 +1236,12 @@ const results = await client.issues.bulkUpdateStatus([
   { issueId: 'issue-2', status: 'deferred', reason: 'Not a priority' },
 ]);
 
-// Each result includes per-item success/failure — some items may fail
-// while others succeed (e.g., issue not found, invalid status transition)
-for (const result of results) {
-  if (!result.success) {
-    console.warn(`Failed to update ${result.issueId}: ${result.error}`);
-  }
+// The result is an aggregate object — `updated` counts the successes and
+// `failed` lists the issue IDs that could not be updated (e.g., not found
+// or an invalid status transition).
+console.log(`Updated ${results.updated} issue(s)`);
+if (results.failed.length > 0) {
+  console.warn('Failed issue IDs:', results.failed);
 }
 ```
 
@@ -1560,7 +1575,7 @@ try {
 } catch (error) {
   if (error instanceof NotFoundError) {
     console.log(error.message); // "Project 'non-existent' not found"
-    console.log(error.details); // { id: 'non-existent' }
+    console.log(error.details); // { resource: "Project 'non-existent' not found" }
   } else if (error instanceof UnauthorizedError) {
     console.log('Please authenticate');
   } else if (error instanceof RateLimitError) {
@@ -1590,6 +1605,41 @@ try {
 | `TimeoutError` | - | Request timeout |
 | `InputValidationError` | - | Client-side Zod validation failure |
 
+### Type Guards
+
+Every error class also ships a type guard. These are an alternative to `instanceof`
+that narrows the error type without importing the class — useful in `switch`-style
+handling or when you only need a subset of the hierarchy:
+
+```typescript
+import {
+  isOpsApiError,        // any server-returned API error
+  isNotFoundError,      // 404
+  isUnauthorizedError,  // 401
+  isForbiddenError,     // 403
+  isValidationError,    // 400
+  isConflictError,      // 409
+  isUnprocessableError, // 422
+  isRateLimitError,     // 429
+  isPayloadTooLargeError, // 413
+  isServiceUnavailableError, // 503
+  isNetworkError,       // connection failure
+  isTimeoutError,       // request timeout
+} from '@uluops/ops-sdk/errors';
+
+try {
+  await client.runs.save(input);
+} catch (error) {
+  if (isNotFoundError(error)) {
+    // handle missing resource
+  } else if (isRateLimitError(error)) {
+    console.log(`Retry after ${error.details?.retryAfter}s`);
+  } else if (isOpsApiError(error)) {
+    console.log(`API error: ${error.code} - ${error.message}`);
+  }
+}
+```
+
 ### Automatic Retries
 
 The SDK automatically retries on transient errors (502, 503, 504, 429) and network failures (DNS, connection reset, ECONNREFUSED) with exponential backoff:

package/dist/client.d.ts

@@ -69,117 +69,193 @@ export declare class OpsClient {
     getAuthType(): 'api_key' | 'session' | null;
     /** Authentication, API keys, sessions, and user profile management */
     readonly auth: {
+        /** Register a new user account. */
         register: (input: RegisterInput) => Promise<RegisterResponse>;
+        /** Log in with email + password, returning a session token. */
         login: (input: LoginInput) => Promise<LoginResponse>;
+        /** Revoke all active sessions for the current user. */
         logoutAll: () => Promise<{
             sessionsRevoked: number;
         }>;
+        /** Trigger a password-reset email for the given address. */
         forgotPassword: (email: string) => Promise<MessageResponse>;
+        /** Complete a password reset using a token from the reset email. */
         resetPassword: (input: ResetPasswordInput) => Promise<MessageResponse>;
+        /** Change the current user's password (requires current password). */
         changePassword: (input: ChangePasswordInput) => Promise<MessageResponse>;
+        /** Set a first-time password for OAuth/admin-created accounts. */
         setPassword: (password: string) => Promise<MessageResponse>;
+        /** Get the authenticated user (auth-scoped view). */
         getMe: () => Promise<AuthUser>;
+        /** Get the current user's public profile. */
         getProfile: () => Promise<{
             user: PublicUser;
         }>;
+        /** Update the current user's profile (partial; at least one field). */
         updateProfile: (input: UpdateProfileInput) => Promise<{
             user: PublicUser;
         }>;
+        /** Fetch the current user's avatar bytes and content type. */
         getAvatar: () => Promise<{
             data: ArrayBuffer;
             contentType: string;
         }>;
+        /** Remove the current user's avatar. */
         deleteAvatar: () => Promise<void>;
+        /** List the current user's API keys (metadata only). */
         listApiKeys: () => Promise<PublicApiKey[]>;
+        /** Create an API key; the secret is returned once, on creation. */
         createApiKey: (input?: CreateApiKeyInput) => Promise<ApiKeyCreatedResponse>;
+        /** Revoke an API key by id. */
         revokeApiKey: (keyId: string) => Promise<void>;
+        /** List the current user's active sessions. */
         listSessions: () => Promise<PublicSession[]>;
+        /** Revoke a single session by id. */
         revokeSession: (sessionId: string) => Promise<void>;
     };
     /** Project CRUD, summaries, trends, issue listing, and bulk operations */
     readonly projects: {
+        /** List all projects visible to the caller. */
         list: () => Promise<Project[]>;
+        /** Get a project by id or name. */
         get: (idOrName: string) => Promise<Project>;
+        /** Create a new project. */
         create: (input: CreateProjectInput) => Promise<Project>;
+        /** Update a project's metadata. */
         update: (idOrName: string, input: UpdateProjectInput) => Promise<Project>;
+        /** Permanently delete a project (requires confirmation). */
         delete: (idOrName: string, input: DeleteProjectInput) => Promise<DeleteResult>;
+        /** Soft-delete a project; reversible via `restore()`. */
         softDelete: (idOrName: string, input: DeleteProjectInput) => Promise<DeleteResult>;
+        /** Restore a soft-deleted project. */
         restore: (idOrName: string) => Promise<Project>;
+        /** Rename a project. */
         rename: (input: RenameProjectInput) => Promise<Project>;
+        /** Get aggregate summary stats for a project. */
         getSummary: (idOrName: string) => Promise<ProjectSummaryResponse>;
+        /** Get time-series trends for a project. */
         getTrends: (idOrName: string, query?: ProjectTrendsQuery) => Promise<ProjectTrends>;
+        /** List a project's issues (filtered). */
         listIssues: (idOrName: string, query?: ListProjectIssuesQuery) => Promise<Issue[]>;
+        /** List a project's issues with a total count for pagination. */
         listIssuesWithCount: (idOrName: string, query?: ListProjectIssuesQuery) => Promise<PaginatedIssues>;
+        /** Bulk-update the status of many issues in a project. */
         bulkUpdateIssueStatus: (idOrName: string, updates: BulkIssueStatusUpdate[]) => Promise<BulkIssueStatusResult>;
+        /** Merge duplicate issues within a project. */
         mergeIssues: (idOrName: string, input: MergeIssuesInput) => Promise<MergeIssuesResult>;
     };
     /** Execution run save, preview, diff, archive, and retrieval */
     readonly runs: {
+        /** Save an execution run (agents, scores, recommendations). */
         save: (input: SaveRunInput, options?: {
             _skipClientValidation?: boolean;
         }) => Promise<SaveRunResponse>;
+        /** Preview a save without persisting (dry-run). */
         validate: (input: SaveRunInput, options?: {
             _skipClientValidation?: boolean;
         }) => Promise<ValidateRunResponse>;
+        /** Diff two runs to surface regressions/improvements. */
         diff: (query: RunDiffQuery) => Promise<RunDiffResult>;
+        /** Archive old runs by number/date/keep-last filter. */
         archive: (input: ArchiveRunsInput) => Promise<ArchiveRunsResult>;
+        /** Update a run identified by project + run number. */
         update: (input: UpdateRunByNumberInput, options?: {
             _skipClientValidation?: boolean;
         }) => Promise<Run>;
+        /** List run summaries for a project. */
         listByProject: (projectId: string, query?: ListRunsQuery) => Promise<RunSummary[]>;
+        /** Get the latest run for a project (optionally by workflow type). */
         getLatest: (projectId: string, workflowType?: string) => Promise<Run>;
+        /** Get full details for a run (defaults to latest when runNumber omitted). */
         getDetails: (projectId: string, runNumber?: number) => Promise<RunDetails>;
+        /** Get a single run by its id. */
         get: (runId: string) => Promise<Run>;
+        /** Update a run identified directly by id. */
         updateById: (runId: string, input: UpdateRunInput, options?: {
             _skipClientValidation?: boolean;
         }) => Promise<Run>;
+        /** Delete a run by id. */
         delete: (runId: string) => Promise<DeleteResult>;
+        /** Get the structured analysis attached to a run. */
         getAnalysis: (runId: string) => Promise<RunAnalysis>;
+        /** List analyses across a project's runs. */
         getProjectAnalysis: (projectId: string, query?: ProjectAnalysisQuery) => Promise<ProjectAnalysisList>;
+        /** Query individual analysis records across runs. */
         queryAnalysisRecords: (query?: AnalysisRecordsQuery) => Promise<AnalysisRecordsList>;
+        /** Get per-run analysis history for a single agent. */
         getAgentRunsAnalysis: (agentName: string, query: AgentRunsAnalysisQuery) => Promise<AgentRunsAnalysis>;
     };
     /** Issue CRUD, search, status management, notes, and bulk operations */
     readonly issues: {
+        /** Create a user-submitted issue. */
         create: (input: CreateUserIssueInput) => Promise<Issue>;
+        /** Search issues by text/filters. */
         search: (query: IssueSearchQuery) => Promise<Issue[]>;
+        /** Get an issue by its fingerprint within a project. */
         getByFingerprint: (fingerprint: string, project: string) => Promise<Issue>;
+        /** Update an issue's status by fingerprint + project. */
         updateStatusByFingerprint: (fingerprint: string, project: string, input: UpdateIssueStatusInput) => Promise<StatusUpdateResult>;
+        /** Get an issue by id. */
         get: (issueId: string) => Promise<Issue>;
+        /** Get an issue with notes and history detail. */
         getDetails: (issueId: string) => Promise<IssueDetails>;
+        /** Get an issue's change history. */
         getHistory: (issueId: string) => Promise<IssueHistoryEnvelope>;
+        /** Update an issue's status by id. */
         updateStatus: (issueId: string, input: UpdateIssueStatusInput) => Promise<Issue>;
+        /** Update an issue's metadata by id. */
         update: (issueId: string, input: UpdateIssueInput) => Promise<Issue>;
+        /** Add a note to an issue. */
         addNote: (issueId: string, input: CreateIssueNoteInput) => Promise<IssueNote>;
+        /** Restore a soft-deleted issue. */
         restore: (issueId: string) => Promise<Issue>;
+        /** Soft-delete an active issue; reversible via `restore()`. */
         softDelete: (issueId: string) => Promise<DeleteResult>;
+        /** Undo the most recent change to an issue. */
         undoLastChange: (issueId: string) => Promise<Issue>;
+        /** Bulk-update issue statuses; returns `{ updated, failed }`. */
         bulkUpdateStatus: (updates: BulkStatusUpdateItem[]) => Promise<BulkIssueStatusResult>;
+        /** List a project's issues by project id (filtered). */
         listByProject: (projectId: string, query?: ListIssuesQuery) => Promise<Issue[]>;
     };
     /** Agent performance, taxonomy analytics, burndown, velocity, and discovery */
     readonly analytics: {
+        /** Get per-agent performance metrics. */
         getAgentPerformance: (query?: AnalyticsQuery) => Promise<AgentPerformance[]>;
+        /** Get agent reliability (convergence/recurrence) metrics. */
         getAgentReliability: (query?: AgentReliabilityQuery) => Promise<AgentReliabilityResult>;
+        /** Get an agent's lifecycle timeline. */
         getAgentLifecycle: (agentName: string, query?: AnalyticsQuery) => Promise<AgentLifecycleEntry[]>;
+        /** Get issue resolution-rate metrics. */
         getResolutionRates: (query?: AnalyticsQuery) => Promise<ResolutionRateResult[]>;
+        /** Get files with the most recurring issues. */
         getFileHotspots: (query?: AnalyticsQuery) => Promise<FileHotspotResult[]>;
+        /** Get the distribution of issues across the failure taxonomy. */
         getTaxonomyDistribution: (query?: AnalyticsQuery) => Promise<TaxonomyDistributionResult[]>;
+        /** Get the full taxonomy analytics breakdown. */
         getFullTaxonomy: (query?: AnalyticsQuery) => Promise<FullTaxonomyAnalyticsResult>;
+        /** Get issue burndown over time. */
         getBurndown: (query?: BurndownQuery) => Promise<BurndownResultResponse>;
+        /** Get resolution velocity over time. */
         getVelocity: (query?: VelocityQuery) => Promise<VelocityResultResponse>;
+        /** Get issue-discovery rate metrics. */
         getDiscovery: (query?: DiscoveryQuery) => Promise<DiscoveryResultResponse>;
+        /** Get the agent comparison matrix. */
         getAgentMatrix: (query?: AgentMatrixQuery) => Promise<AgentMatrixResultResponse>;
+        /** Get a high-level trend summary. */
         getTrendSummary: (query?: AnalyticsQuery) => Promise<TrendSummaryResult[]>;
         /**
          * Get analytics by metric name (generic endpoint).
          * Returns unvalidated data — use typed methods (getAgentPerformance, etc.) for validated responses.
+         *
          */
         getByMetric: (metric: analyticsOps.AnalyticsMetric, query?: AnalyticsQuery) => Promise<unknown>;
+        /** List agents known to the analytics layer. */
         listAgents: (query?: AnalyticsQuery) => Promise<AgentInfo[]>;
     };
     /** Failure taxonomy schema (domains, modes, severities) */
     readonly taxonomy: {
+        /** Get the failure-taxonomy schema (domains, modes, severities). */
         get: () => Promise<TaxonomyResponse>;
     };
 }

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -110,22 +110,39 @@ export class OpsClient {
     // ============================================
     /** Authentication, API keys, sessions, and user profile management */
     auth = {
+        /** Register a new user account. */
         register: (input) => authOps.register(this.httpClient, input),
+        /** Log in with email + password, returning a session token. */
         login: (input) => authOps.login(this.httpClient, input),
+        /** Revoke all active sessions for the current user. */
         logoutAll: () => authOps.logoutAll(this.httpClient),
+        /** Trigger a password-reset email for the given address. */
         forgotPassword: (email) => authOps.forgotPassword(this.httpClient, email),
+        /** Complete a password reset using a token from the reset email. */
         resetPassword: (input) => authOps.resetPassword(this.httpClient, input),
+        /** Change the current user's password (requires current password). */
         changePassword: (input) => authOps.changePassword(this.httpClient, input),
+        /** Set a first-time password for OAuth/admin-created accounts. */
         setPassword: (password) => authOps.setPassword(this.httpClient, password),
+        /** Get the authenticated user (auth-scoped view). */
         getMe: () => authOps.getMe(this.httpClient),
+        /** Get the current user's public profile. */
         getProfile: () => authOps.getProfile(this.httpClient),
+        /** Update the current user's profile (partial; at least one field). */
         updateProfile: (input) => authOps.updateProfile(this.httpClient, input),
+        /** Fetch the current user's avatar bytes and content type. */
         getAvatar: () => authOps.getAvatar(this.httpClient),
+        /** Remove the current user's avatar. */
         deleteAvatar: () => authOps.deleteAvatar(this.httpClient),
+        /** List the current user's API keys (metadata only). */
         listApiKeys: () => authOps.listApiKeys(this.httpClient),
+        /** Create an API key; the secret is returned once, on creation. */
         createApiKey: (input) => authOps.createApiKey(this.httpClient, input),
+        /** Revoke an API key by id. */
         revokeApiKey: (keyId) => authOps.revokeApiKey(this.httpClient, keyId),
+        /** List the current user's active sessions. */
         listSessions: () => authOps.listSessions(this.httpClient),
+        /** Revoke a single session by id. */
         revokeSession: (sessionId) => authOps.revokeSession(this.httpClient, sessionId),
     };
     // ============================================
@@ -133,19 +150,33 @@ export class OpsClient {
     // ============================================
     /** Project CRUD, summaries, trends, issue listing, and bulk operations */
     projects = {
+        /** List all projects visible to the caller. */
         list: () => projectOps.list(this.httpClient),
+        /** Get a project by id or name. */
         get: (idOrName) => projectOps.get(this.httpClient, idOrName),
+        /** Create a new project. */
         create: (input) => projectOps.create(this.httpClient, input),
+        /** Update a project's metadata. */
         update: (idOrName, input) => projectOps.update(this.httpClient, idOrName, input),
+        /** Permanently delete a project (requires confirmation). */
         delete: (idOrName, input) => projectOps.deleteProject(this.httpClient, idOrName, input),
+        /** Soft-delete a project; reversible via `restore()`. */
         softDelete: (idOrName, input) => projectOps.softDelete(this.httpClient, idOrName, input),
+        /** Restore a soft-deleted project. */
         restore: (idOrName) => projectOps.restore(this.httpClient, idOrName),
+        /** Rename a project. */
         rename: (input) => projectOps.rename(this.httpClient, input),
+        /** Get aggregate summary stats for a project. */
         getSummary: (idOrName) => projectOps.getSummary(this.httpClient, idOrName),
+        /** Get time-series trends for a project. */
         getTrends: (idOrName, query) => projectOps.getTrends(this.httpClient, idOrName, query),
+        /** List a project's issues (filtered). */
         listIssues: (idOrName, query) => projectOps.listIssues(this.httpClient, idOrName, query),
+        /** List a project's issues with a total count for pagination. */
         listIssuesWithCount: (idOrName, query) => projectOps.listIssuesWithCount(this.httpClient, idOrName, query),
+        /** Bulk-update the status of many issues in a project. */
         bulkUpdateIssueStatus: (idOrName, updates) => projectOps.bulkUpdateIssueStatus(this.httpClient, idOrName, updates),
+        /** Merge duplicate issues within a project. */
         mergeIssues: (idOrName, input) => projectOps.mergeIssues(this.httpClient, idOrName, input),
     };
     // ============================================
@@ -153,21 +184,36 @@ export class OpsClient {
     // ============================================
     /** Execution run save, preview, diff, archive, and retrieval */
     runs = {
+        /** Save an execution run (agents, scores, recommendations). */
         save: (input, options) => runOps.save(this.httpClient, input, options),
+        /** Preview a save without persisting (dry-run). */
         validate: (input, options) => runOps.validate(this.httpClient, input, options),
+        /** Diff two runs to surface regressions/improvements. */
         diff: (query) => runOps.diff(this.httpClient, query),
+        /** Archive old runs by number/date/keep-last filter. */
         archive: (input) => runOps.archive(this.httpClient, input),
+        /** Update a run identified by project + run number. */
         update: (input, options) => runOps.update(this.httpClient, input, options),
+        /** List run summaries for a project. */
         listByProject: (projectId, query) => runOps.listByProject(this.httpClient, projectId, query),
+        /** Get the latest run for a project (optionally by workflow type). */
         getLatest: (projectId, workflowType) => runOps.getLatest(this.httpClient, projectId, workflowType),
+        /** Get full details for a run (defaults to latest when runNumber omitted). */
         getDetails: (projectId, runNumber) => runOps.getDetails(this.httpClient, projectId, runNumber),
+        /** Get a single run by its id. */
         get: (runId) => runOps.get(this.httpClient, runId),
+        /** Update a run identified directly by id. */
         updateById: (runId, input, options) => runOps.updateById(this.httpClient, runId, input, options),
+        /** Delete a run by id. */
         delete: (runId) => runOps.deleteRun(this.httpClient, runId),
         // Analysis operations (v0.3.0)
+        /** Get the structured analysis attached to a run. */
         getAnalysis: (runId) => runOps.getAnalysis(this.httpClient, runId),
+        /** List analyses across a project's runs. */
         getProjectAnalysis: (projectId, query) => runOps.getProjectAnalysis(this.httpClient, projectId, query),
+        /** Query individual analysis records across runs. */
         queryAnalysisRecords: (query) => runOps.queryAnalysisRecords(this.httpClient, query),
+        /** Get per-run analysis history for a single agent. */
         getAgentRunsAnalysis: (agentName, query) => runOps.getAgentRunsAnalysis(this.httpClient, agentName, query),
     };
     // ============================================
@@ -175,20 +221,35 @@ export class OpsClient {
     // ============================================
     /** Issue CRUD, search, status management, notes, and bulk operations */
     issues = {
+        /** Create a user-submitted issue. */
         create: (input) => issueOps.create(this.httpClient, input),
+        /** Search issues by text/filters. */
         search: (query) => issueOps.search(this.httpClient, query),
+        /** Get an issue by its fingerprint within a project. */
         getByFingerprint: (fingerprint, project) => issueOps.getByFingerprint(this.httpClient, fingerprint, project),
+        /** Update an issue's status by fingerprint + project. */
         updateStatusByFingerprint: (fingerprint, project, input) => issueOps.updateStatusByFingerprint(this.httpClient, fingerprint, project, input),
+        /** Get an issue by id. */
         get: (issueId) => issueOps.get(this.httpClient, issueId),
+        /** Get an issue with notes and history detail. */
         getDetails: (issueId) => issueOps.getDetails(this.httpClient, issueId),
+        /** Get an issue's change history. */
         getHistory: (issueId) => issueOps.getHistory(this.httpClient, issueId),
+        /** Update an issue's status by id. */
         updateStatus: (issueId, input) => issueOps.updateStatus(this.httpClient, issueId, input),
+        /** Update an issue's metadata by id. */
         update: (issueId, input) => issueOps.update(this.httpClient, issueId, input),
+        /** Add a note to an issue. */
         addNote: (issueId, input) => issueOps.addNote(this.httpClient, issueId, input),
+        /** Restore a soft-deleted issue. */
         restore: (issueId) => issueOps.restore(this.httpClient, issueId),
+        /** Soft-delete an active issue; reversible via `restore()`. */
         softDelete: (issueId) => issueOps.softDelete(this.httpClient, issueId),
+        /** Undo the most recent change to an issue. */
         undoLastChange: (issueId) => issueOps.undoLastChange(this.httpClient, issueId),
+        /** Bulk-update issue statuses; returns `{ updated, failed }`. */
         bulkUpdateStatus: (updates) => issueOps.bulkUpdateStatus(this.httpClient, updates),
+        /** List a project's issues by project id (filtered). */
         listByProject: (projectId, query) => issueOps.listByProject(this.httpClient, projectId, query),
     };
     // ============================================
@@ -196,23 +257,37 @@ export class OpsClient {
     // ============================================
     /** Agent performance, taxonomy analytics, burndown, velocity, and discovery */
     analytics = {
+        /** Get per-agent performance metrics. */
         getAgentPerformance: (query) => analyticsOps.getAgentPerformance(this.httpClient, query),
+        /** Get agent reliability (convergence/recurrence) metrics. */
         getAgentReliability: (query) => analyticsOps.getAgentReliability(this.httpClient, query),
+        /** Get an agent's lifecycle timeline. */
         getAgentLifecycle: (agentName, query) => analyticsOps.getAgentLifecycle(this.httpClient, agentName, query),
+        /** Get issue resolution-rate metrics. */
         getResolutionRates: (query) => analyticsOps.getResolutionRates(this.httpClient, query),
+        /** Get files with the most recurring issues. */
         getFileHotspots: (query) => analyticsOps.getFileHotspots(this.httpClient, query),
+        /** Get the distribution of issues across the failure taxonomy. */
         getTaxonomyDistribution: (query) => analyticsOps.getTaxonomyDistribution(this.httpClient, query),
+        /** Get the full taxonomy analytics breakdown. */
         getFullTaxonomy: (query) => analyticsOps.getFullTaxonomy(this.httpClient, query),
+        /** Get issue burndown over time. */
         getBurndown: (query) => analyticsOps.getBurndown(this.httpClient, query),
+        /** Get resolution velocity over time. */
         getVelocity: (query) => analyticsOps.getVelocity(this.httpClient, query),
+        /** Get issue-discovery rate metrics. */
         getDiscovery: (query) => analyticsOps.getDiscovery(this.httpClient, query),
+        /** Get the agent comparison matrix. */
         getAgentMatrix: (query) => analyticsOps.getAgentMatrix(this.httpClient, query),
+        /** Get a high-level trend summary. */
         getTrendSummary: (query) => analyticsOps.getTrendSummary(this.httpClient, query),
         /**
          * Get analytics by metric name (generic endpoint).
          * Returns unvalidated data — use typed methods (getAgentPerformance, etc.) for validated responses.
+         *
          */
         getByMetric: (metric, query) => analyticsOps.getByMetric(this.httpClient, metric, query),
+        /** List agents known to the analytics layer. */
         listAgents: (query) => analyticsOps.listAgents(this.httpClient, query),
     };
     // ============================================
@@ -220,6 +295,7 @@ export class OpsClient {
     // ============================================
     /** Failure taxonomy schema (domains, modes, severities) */
     taxonomy = {
+        /** Get the failure-taxonomy schema (domains, modes, severities). */
         get: () => taxonomyOps.get(this.httpClient),
     };
 }