@uluops/ops-sdk 1.8.1 → 1.8.4

package/CHANGELOG.md

@@ -4,6 +4,57 @@ All notable changes to `@uluops/ops-sdk` will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [Unreleased]
+
+## [1.8.4] - 2026-05-18
+
+### Fixed
+- **Breaking (type only):** `AgentPerformance.avgScore` and `AgentInfo.avgScore` renamed to `averageScore` — aligns with `AgentPerformanceResponseSchema` field name. Callers accessing `.avgScore` must update to `.averageScore`
+- `SaveRunInputSchema` now validates `definitionId` (UUID format) — was accepted by TypeScript interface but bypassed Zod client-side validation
+- `AgentInputSchema` now validates `definitionVersion` — field was silently stripped by Zod on save
+- `runs.save()` auto-generates idempotency key via `randomUUID()` when caller does not provide one — prevents duplicate runs on retry
+- Broken README import paths: `SaveRunInput` from `types/runs` (was `types/schemas`), `Credentials` from `config` (was `types/auth`)
+- Debug-mode unauthenticated warning no longer fires when email/password login is planned
+- `deleteProject`/`softDelete` deduplicated via private `deleteWithConfirmation` helper
+- `buildIssueListParams` widening cast removed — `QueryParams` assignable to `object` directly
+- `listIssuesWithCount` JSDoc upgraded to `@remarks` with full reliability caveat documentation
+- `toApiQuery` JSDoc now documents the `'all'` stripping convention with `StatusFilter`/`PriorityFilter` context
+- Ghost `dist/operations/admin.*` artifacts cleaned; build script now runs `rm -rf dist` before `tsc`
+- `response-schemas.ts` barrel removed from public `@uluops/ops-sdk/types` export (semver protection)
+- `getByMetric` now throws `InputValidationError` instead of bare `Error`
+- `validateUuid`/`validateRequiredString` now populate `errors[]` with synthetic Zod-compatible issues
+- `npm audit` gate added to `prepublishOnly` script
+
+### Added
+- `npm audit --audit-level=high` in `prepublishOnly` — blocks publish on high-severity vulnerabilities
+- SDK_VERSION sync test — asserts `constants.ts` matches `package.json` via `createRequire`
+- Tests for `getAgentRunsAnalysis`, `getAgentLifecycle`, `getAvatar` (3 previously untested public functions)
+- Response validation tests for `listByProject` and `getLatest` operations
+- `redactSensitive` boundary test at length=5
+- README: exports table expanded to 12 rows, sign-up URL, `AnalyticsMetric` type example, analysis output shapes
+- CHANGELOG: `[Unreleased]` section, missing `[1.7.0]` entry restored
+- JSDoc enriched on 6 analytics/project operations, `runs.save()` `@example`, `isValidMetric()` `@example`
+
+## [1.8.3] - 2026-05-18
+
+### Fixed
+- `TaxonomySchema` type alias renamed to `TaxonomyResponse` — "Schema" suffix was inconsistent with codebase convention where it means Zod runtime object. Deprecated `TaxonomySchema` alias preserved for backward compatibility.
+- `diff()`, `getLatest()`, `getDetails()` now route query parameters through `toApiQuery()` for consistent camelCase→snake_case conversion, matching all other operations
+- `InputValidationError` now exported from `@uluops/ops-sdk/errors` barrel — previously only accessible via `@uluops/ops-sdk/config`
+- JSDoc on `AgentInput`, `RecommendationInput`, `RunSummaryInput` updated from stale `save_features_list` references to `save_run`
+- Removed `category_performance` from `ANALYTICS_METRICS` — API does not support this metric
+
+## [1.8.2] - 2026-05-18
+
+### Added
+- `client.auth.getAvatar()` — was implemented in `operations/auth.ts` but missing from the `OpsClient.auth` namespace
+
+### Fixed
+- `SDK_VERSION` constant synced to match `package.json` (was stuck at `1.4.0`)
+
+### Removed
+- Deprecated `validateSaveFeaturesListInput` alias — use `validateSaveRunInput` directly
+
 ## [1.8.1] - 2026-05-12
 
 ### Changed
@@ -35,10 +86,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ## [1.7.1] - 2026-05-10
 
 ### Added
-- `analysisRecords` and `analysisSummary` fields on `UpdateRunInput` — enables post-hoc enrichment of runs with structured analysis data (replace semantics)
 - `agentName` field on `AnalysisRecordInput` and `AnalysisSummaryInput` — per-item agent attribution, overrides run-level default
 - `analysisSummary` on `UpdateRunInput` accepts single object or array of per-agent summaries
 
+## [1.7.0] - 2026-05-10
+
+### Added
+- `analysisRecords` and `analysisSummary` fields on `UpdateRunInput` — enables post-hoc enrichment of runs with structured analysis data (replace semantics)
+
 ## [1.6.0] - 2026-05-06
 
 ### Added

package/README.md

@@ -11,7 +11,7 @@
 
 Official TypeScript SDK with Zod runtime validation for the UluOps validation tracker API. Track validation runs, manage issues, analyze trends, and integrate AI validation pipelines into your workflow.
 
-**Current version: 1.8.0** | [Changelog](./CHANGELOG.md)
+**Current version: 1.8.4** | [Changelog](./CHANGELOG.md)
 
 ## Quick Start
 
@@ -71,7 +71,7 @@ const burndown = await client.analytics.getBurndown({
 });
 
 for (const [domain, trend] of Object.entries(burndown.trends)) {
-  console.log(`${domain}: ${trend.direction} (rate: ${trend.rate})`);
+  console.log(`${domain}: ${trend.trend} (avg daily change: ${trend.avgDailyChange})`);
 }
 ```
 
@@ -139,7 +139,7 @@ pnpm add @uluops/ops-sdk
 
 ## Authentication
 
-The SDK supports two authentication methods:
+The SDK supports two authentication methods. To get an API key, visit the [UluOps Dashboard](https://app.uluops.ai) or create one programmatically via `client.auth.createApiKey()`.
 
 ### API Key Authentication (Recommended)
 
@@ -227,8 +227,16 @@ import { loadCredentials, DEFAULT_BASE_URL } from '@uluops/ops-sdk/config';
 
 | Export Path | Contents |
 |------------|----------|
-| `@uluops/ops-sdk` | Main `OpsClient`, `OpsHttpClient`, auth strategies |
-| `@uluops/ops-sdk/types` | All TypeScript types and Zod schemas |
+| `@uluops/ops-sdk` | Main `OpsClient`, `OpsHttpClient`, auth strategies, config helpers, all types |
+| `@uluops/ops-sdk/types` | All TypeScript types and Zod input schemas |
+| `@uluops/ops-sdk/types/projects` | Project types only |
+| `@uluops/ops-sdk/types/issues` | Issue types only |
+| `@uluops/ops-sdk/types/runs` | Run types only |
+| `@uluops/ops-sdk/types/analytics` | Analytics types only |
+| `@uluops/ops-sdk/types/enums` | Priority, Status, Severity enums |
+| `@uluops/ops-sdk/types/responses` | API response types |
+| `@uluops/ops-sdk/types/schemas` | Zod input validation schemas |
+| `@uluops/ops-sdk/types/auth` | Auth/credential types |
 | `@uluops/ops-sdk/errors` | Error classes and utilities |
 | `@uluops/ops-sdk/config` | Configuration loaders and constants |
 
@@ -243,8 +251,8 @@ import type { Run } from '@uluops/ops-sdk/types/runs';
 import type { BurndownResult } from '@uluops/ops-sdk/types/analytics';
 import type { Priority, Status, Severity } from '@uluops/ops-sdk/types/enums';
 import type { ApiResponse } from '@uluops/ops-sdk/types/responses';
-import type { SaveRunInput } from '@uluops/ops-sdk/types/schemas';
-import type { Credentials } from '@uluops/ops-sdk/types/auth';
+import type { SaveRunInput } from '@uluops/ops-sdk/types/runs';
+import type { Credentials } from '@uluops/ops-sdk/config';
 ```
 
 ## API Reference
@@ -410,6 +418,15 @@ await client.auth.resetPassword({
 });
 ```
 
+#### `client.auth.getAvatar()`
+
+Get the current user's avatar as binary data.
+
+```typescript
+const { data, contentType } = await client.auth.getAvatar();
+// data: ArrayBuffer, contentType: e.g. 'image/png'
+```
+
 #### `client.auth.deleteAvatar()`
 
 Delete the current user's avatar.
@@ -677,7 +694,7 @@ Save a new validation run.
 | `project` | `string` | Yes | Project name or ID |
 | `workflowType` | `string` | Yes | Workflow type (e.g., `'post-implementation'`) |
 | `agents` | `AgentInput[]` | Yes | Array of agent results |
-| `recommendations` | `Recommendation[]` | No | Array of issues/recommendations |
+| `recommendations` | `Recommendation[]` | Yes | Array of issues/recommendations (use `[]` for empty) |
 | `summary` | `object` | No | Summary statistics |
 | `rawMarkdown` | `string` | No | Raw markdown report |
 | `idempotencyKey` | `string` | No | Key for duplicate prevention |
@@ -685,6 +702,8 @@ Save a new validation run.
 | `definitionName` | `string` | No | Definition name (e.g., `'code-validator'`) |
 | `definitionVersion` | `string` | No | Definition version (e.g., `'1.2.0'`) |
 | `definitionHash` | `string` | No | SHA-256 content hash of the definition |
+| `definitionId` | `string` | No | Registry definition UUID for direct identity linkage |
+| `timestamp` | `string` | No | ISO 8601 timestamp override (defaults to server time) |
 | `analysisRecords` | `AnalysisRecordInput[]` | No | Structured analysis records (v0.2.0) |
 | `analysisSummary` | `AnalysisSummaryInput \| AnalysisSummaryInput[]` | No | Single or per-agent array of analysis summaries (v1.8.1) |
 | `analysisSummary.explorationMaps` | `ExplorationMap[]` | No | Structural maps from explorer agents (v1.8.0) |
@@ -739,8 +758,8 @@ Preview what a save would do without persisting.
 const preview = await client.runs.validate({
   project: 'my-project',
   workflowType: 'post-implementation',
-  agents: [...],
-  recommendations: [...],
+  agents: [{ name: 'code-validator', score: 90, decision: 'PASS' }],
+  recommendations: [{ agent: 'code-validator', title: 'Unused import', priority: 'backlog', failure_code: 'STR-OMI/L' }],
 });
 
 console.log('Would create:', preview.wouldCreate);
@@ -832,7 +851,7 @@ const result = await client.runs.archive({
   keepLast: 10,
   reason: 'Quarterly cleanup',
 });
-console.log(`Archived ${result.archivedCount} runs`);
+console.log(`Archived ${result.archived} runs`);
 ```
 
 #### `client.runs.update(input)`
@@ -924,7 +943,7 @@ const { data, total } = await client.runs.getProjectAnalysis('my-project', {
   agentName: 'nietzsche-analyst',
   limit: 10,
 });
-// Track active/reactive ratio trend over time
+// data[0]: { decision, score, categoryScores, systemMetrics, runNumber, runTimestamp, workflowType }
 data.forEach(s => console.log(s.decision, s.systemMetrics));
 ```
 
@@ -942,10 +961,12 @@ Cross-project query for analysis records with filters (v0.3.0).
 
 ```typescript
 // Find all calcified conventions across all projects
-const { data } = await client.runs.queryAnalysisRecords({
+const { data, total } = await client.runs.queryAnalysisRecords({
   recordType: 'convention',
   classification: 'CALCIFIED',
 });
+// data[0]: { recordType, recordId, title, classification, severity, data: { ... } }
+console.log(`Found ${total} records`);
 ```
 
 #### `client.runs.getAgentRunsAnalysis(agentName, query)`
@@ -961,11 +982,11 @@ Get analysis summaries with run context for a specific agent. Returns analysis d
 | `query.offset` | `number` | No | Pagination offset |
 
 ```typescript
-const { data, total } = await client.runs.getAgentRunsAnalysis('epictetus-validator', {
+const { items, total } = await client.runs.getAgentRunsAnalysis('epictetus-validator', {
   project: 'my-project',
   limit: 10,
 });
-// data[0]: { decision, score, categoryScores, runNumber, runTimestamp, workflowType, snapshotScore, ... }
+// items[0]: { decision, score, categoryScores, runNumber, runTimestamp, workflowType, snapshotScore, ... }
 ```
 
 ---
@@ -989,7 +1010,7 @@ Create a user-submitted issue.
 | `lineNumber` | `number` | No | Line number |
 | `description` | `string` | No | Detailed description |
 | `failureCode` | `string` | No | Taxonomy code (e.g., `'SEM-VAL/H'`) |
-| `validator` | `string` | No | Validator name (defaults to `'user-submitted'`) |
+| `agent` | `string` | No | Agent name (defaults to `'user-submitted'`) |
 
 ```typescript
 const issue = await client.issues.create({
@@ -1044,7 +1065,7 @@ Get detailed issue information with occurrences and notes.
 const details = await client.issues.getDetails('issue-uuid-here');
 console.log('Occurrences:', details.occurrences);
 console.log('Notes:', details.notes);
-console.log('Related issues:', details.relatedIssues);
+console.log('History:', details.history);
 ```
 
 #### `client.issues.getByFingerprint(fingerprint, project)`
@@ -1079,7 +1100,7 @@ Get status change history for an issue.
 ```typescript
 const history = await client.issues.getHistory('issue-uuid');
 for (const entry of history) {
-  console.log(`${entry.fromStatus} -> ${entry.toStatus} at ${entry.changedAt}`);
+  console.log(`${entry.oldStatus} -> ${entry.newStatus} at ${entry.changedAt}`);
 }
 ```
 
@@ -1201,7 +1222,24 @@ Get performance metrics by agent.
 ```typescript
 const performance = await client.analytics.getAgentPerformance({ days: 30 });
 for (const agent of performance) {
-  console.log(`${agent.agent}: avg=${agent.avgScore}, pass=${agent.passRate}`);
+  console.log(`${agent.name}: avg=${agent.avgScore}, pass=${agent.passRate}`);
+}
+```
+
+#### `client.analytics.getAgentLifecycle(agentName, query)`
+
+Get version trajectory for a specific agent across time.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `agentName` | `string` | Yes | Agent name |
+| `query.project` | `string` | No | Filter by project |
+| `query.days` | `number` | No | Time window (default: 30) |
+
+```typescript
+const lifecycle = await client.analytics.getAgentLifecycle('code-validator', { days: 90 });
+for (const entry of lifecycle) {
+  console.log(`v${entry.definitionVersion}: avg=${entry.avgScore}, runs=${entry.runs}, pass=${entry.passRate}`);
 }
 ```
 
@@ -1228,7 +1266,7 @@ Get issue resolution rates by project.
 ```typescript
 const rates = await client.analytics.getResolutionRates();
 for (const rate of rates) {
-  console.log(`${rate.project}: ${rate.rate * 100}% resolved`);
+  console.log(`${rate.project}: ${rate.resolutionRate * 100}% resolved`);
 }
 ```
 
@@ -1245,7 +1283,7 @@ Get files with the most issues.
 ```typescript
 const hotspots = await client.analytics.getFileHotspots({ limit: 10 });
 for (const hotspot of hotspots) {
-  console.log(`${hotspot.filePath}: ${hotspot.issueCount} issues`);
+  console.log(`${hotspot.filePath}: ${hotspot.totalIssues} issues`);
 }
 ```
 
@@ -1266,10 +1304,10 @@ for (const d of distribution) {
 Get comprehensive taxonomy analytics.
 
 ```typescript
-const { data, computedAt } = await client.analytics.getFullTaxonomy();
-console.log('By domain:', data.byDomain);
-console.log('By mode:', data.byMode);
-console.log('By severity:', data.bySeverity);
+const taxonomy = await client.analytics.getFullTaxonomy();
+console.log('By domain:', taxonomy.byDomain);
+console.log('By mode:', taxonomy.byMode);
+console.log('By severity:', taxonomy.bySeverity);
 ```
 
 #### `client.analytics.getBurndown(query)`
@@ -1286,7 +1324,7 @@ Get burndown time series by failure domain.
 const burndown = await client.analytics.getBurndown({ days: 30 });
 console.log('Time series:', burndown.timeSeries);
 console.log('Trends:', burndown.trends);
-// { STR: { direction: 'declining', rate: -0.05 }, ... }
+// { STR: { trend: 'declining', avgDailyChange: -0.05, netChange: -12, confidence: 'high' }, ... }
 ```
 
 #### `client.analytics.getVelocity(query)`
@@ -1301,10 +1339,10 @@ Get velocity metrics per failure mode.
 
 ```typescript
 const velocity = await client.analytics.getVelocity({ alertThreshold: 10 });
-for (const mode of velocity.modes) {
-  console.log(`${mode.mode}: velocity=${mode.velocity}, trend=${mode.trend}`);
+for (const item of velocity.items) {
+  console.log(`${item.failureCode}: velocity=${item.velocityPercent}%, alert=${item.alert}`);
 }
-console.log('Alerts:', velocity.alerts);
+console.log('Summary:', velocity.summary);
 ```
 
 #### `client.analytics.getDiscovery(query)`
@@ -1337,9 +1375,9 @@ Get agent-taxonomy coverage matrix.
 ```typescript
 const matrix = await client.analytics.getAgentMatrix();
 console.log('Coverage matrix:', matrix.matrix);
-console.log('Blind spots:', matrix.blindSpots); // Domains not detected
-console.log('Single points:', matrix.singlePoints); // Only one agent detects
-console.log('High overlap:', matrix.highOverlap); // 3+ agents detect
+console.log('Blind spots:', matrix.analysis.blindSpots); // Domains not detected
+console.log('Single points:', matrix.analysis.singlePoints); // Only one agent detects
+console.log('High overlap:', matrix.analysis.highOverlap); // 3+ agents detect
 ```
 
 #### `client.analytics.getTrendSummary(query)`
@@ -1349,7 +1387,7 @@ Get general trend summary.
 ```typescript
 const trends = await client.analytics.getTrendSummary();
 for (const trend of trends) {
-  console.log(`${trend.metric}: ${trend.value} (${trend.change > 0 ? '+' : ''}${trend.change})`);
+  console.log(`${trend.period}: ${trend.newIssues} new, ${trend.resolvedIssues} resolved`);
 }
 ```
 
@@ -1357,10 +1395,13 @@ for (const trend of trends) {
 
 Get analytics by specific metric name.
 
-Available metrics: `agent_performance`, `resolution_rates`, `cross_project_patterns`, `file_hotspots`, `regression_analysis`, `trend_summary`, `cost_analysis`, `taxonomy_distribution`, `category_performance`.
+Available metrics: `agent_performance`, `resolution_rates`, `cross_project_patterns`, `file_hotspots`, `regression_analysis`, `trend_summary`, `cost_analysis`, `taxonomy_distribution`.
 
 ```typescript
-const costData = await client.analytics.getByMetric('cost_analysis', { days: 30 });
+import type { AnalyticsMetric } from '@uluops/ops-sdk';
+
+const metric: AnalyticsMetric = 'cost_analysis'; // IDE autocomplete for valid metrics
+const costData = await client.analytics.getByMetric(metric, { days: 30 });
 const regressions = await client.analytics.getByMetric('regression_analysis', { project: 'my-project' });
 ```
 
@@ -1375,18 +1416,7 @@ for (const v of agents) {
 }
 ```
 
-#### Deprecated Aliases
-
-The following analytics methods were renamed from "validator" to "agent" terminology. The old names still work but will be removed in a future major version:
 
-| Deprecated | Replacement |
-|-----------|-------------|
-| `getValidatorPerformance` | `getAgentPerformance` |
-| `getValidatorReliability` | `getAgentReliability` |
-| `getValidatorMatrix` | `getAgentMatrix` |
-| `listValidators` | `listAgents` |
-
-Similarly, `client.issues.edit()` is deprecated in favor of `client.issues.update()`.
 
 ---
 
@@ -1513,7 +1543,7 @@ try {
 | `ServiceUnavailableError` | 503 | Server unavailable |
 | `NetworkError` | - | Connection error |
 | `TimeoutError` | - | Request timeout |
-| `InputValidationError` | - | Client-side Zod validation failure (import from `@uluops/ops-sdk/config`) |
+| `InputValidationError` | - | Client-side Zod validation failure |
 
 ### Automatic Retries
 
@@ -1543,7 +1573,8 @@ Requests exceeding these limits will receive a `413 Payload Too Large` or `422 U
 The SDK includes Zod-based runtime validators for all mutating operations. Import them from `@uluops/ops-sdk/config`:
 
 ```typescript
-import { validateCreateProjectInput, InputValidationError } from '@uluops/ops-sdk/config';
+import { InputValidationError } from '@uluops/ops-sdk/errors';
+import { validateCreateProjectInput } from '@uluops/ops-sdk/config';
 
 try {
   const validated = validateCreateProjectInput({ name: '' }); // throws
@@ -1616,7 +1647,7 @@ console.log(config.baseUrl);
 
 ### Invalid API Key Format
 
-```
+```text
 Error: Invalid API key format. Keys must start with 'ulr_'
 ```
 
@@ -1629,7 +1660,7 @@ console.log(key); // ulr_abc123...
 
 ### Authentication Errors
 
-```
+```text
 UnauthorizedError: Authentication required
 ```
 
@@ -1645,7 +1676,7 @@ echo $ULUOPS_API_KEY
 
 ### Connection Errors
 
-```
+```text
 NetworkError: connect ECONNREFUSED 127.0.0.1:3100
 ```
 
@@ -1666,7 +1697,7 @@ const client = new OpsClient({
 
 ### Rate Limiting
 
-```
+```text
 RateLimitError: Rate limit exceeded. Retry after 60 seconds
 ```
 

package/dist/client.d.ts

@@ -1,38 +1,19 @@
+import { type HttpClientConfig } from './http/http-client.js';
 import * as analyticsOps from './operations/analytics.js';
 import type { RegisterInput, LoginInput, LoginResponse, RegisterResponse, UpdateProfileInput, ChangePasswordInput, ResetPasswordInput, CreateApiKeyInput, ApiKeyCreatedResponse, PublicApiKey, PublicSession, AuthUser, PublicUser } from './types/auth.js';
-import type { Project, CreateProjectInput, UpdateProjectInput, DeleteProjectInput, RenameProjectInput, ProjectSummaryResponse, PaginatedIssues, ProjectTrends, ProjectTrendsQuery, ListProjectIssuesQuery, BulkIssueStatusUpdate, MergeIssuesInput, MergeIssuesResult } from './types/projects.js';
+import type { Project, CreateProjectInput, UpdateProjectInput, DeleteProjectInput, RenameProjectInput, ProjectSummaryResponse, PaginatedIssues, ProjectTrends, ProjectTrendsQuery, ListProjectIssuesQuery, BulkIssueStatusUpdate, BulkIssueStatusResult, MergeIssuesInput, MergeIssuesResult } from './types/projects.js';
 import { type z } from 'zod';
 import type { Run, SaveRunInput, SaveRunResponse, ValidateRunResponse, RunDiffQuery, RunDiffResult, ArchiveRunsInput, ArchiveRunsResult, UpdateRunInput, UpdateRunByNumberInput, ListRunsQuery, RunDetails, ProjectAnalysisQuery, AnalysisRecordsQuery, AgentRunsAnalysisQuery } from './types/runs.js';
 import type { RunSummaryResponseSchema, RunAnalysisResponseSchema, ProjectAnalysisListResponseSchema, AnalysisRecordsListResponseSchema, AgentRunsAnalysisResponseSchema } from './types/response-schemas.js';
 import type { Issue, CreateUserIssueInput, UpdateIssueInput, UpdateIssueStatusInput, CreateIssueNoteInput, IssueNote, StatusHistory, IssueDetails, IssueSearchQuery, ListIssuesQuery, BulkStatusUpdateItem, StatusUpdateResult } from './types/issues.js';
-import type { AnalyticsQuery, AgentInfo, AgentReliabilityQuery, BurndownQuery, VelocityQuery, DiscoveryQuery, AgentMatrixQuery, TaxonomySchema } from './types/analytics.js';
-import { AgentPerformanceResponseSchema, AgentReliabilityResultResponseSchema, ResolutionRateResponseSchema, FileHotspotResponseSchema, TaxonomyDistributionResponseSchema, FullTaxonomyAnalyticsResponseSchema, BurndownResultResponseSchema, VelocityResultResponseSchema, DiscoveryResultResponseSchema, AgentMatrixResultResponseSchema, TrendSummaryResponseSchema } from './types/response-schemas.js';
+import type { AnalyticsQuery, AgentInfo, AgentLifecycleEntry, AgentReliabilityQuery, BurndownQuery, VelocityQuery, DiscoveryQuery, AgentMatrixQuery, TaxonomyResponse } from './types/analytics.js';
+import { AgentPerformanceResponseSchema, AgentReliabilityResultResponseSchema, ResolutionRateResponseSchema, FileHotspotResponseSchema, TaxonomyDistributionResponseSchema, FullTaxonomyAnalyticsResponseSchema, BurndownResultResponseSchema, VelocityResultResponseSchema, DiscoveryResultResponseSchema, AgentMatrixResultResponseSchema, TrendSummaryResponseSchema, BulkStatusUpdateResultResponseSchema } from './types/response-schemas.js';
 import type { MessageResponse, DeleteResult } from './types/responses.js';
 /**
- * OpsClient configuration options
+ * OpsClient configuration options.
+ * All HTTP-level options (baseUrl, timeout, retries, debug, auth) are available.
  */
-export interface OpsClientConfig {
-    /** API key for authentication (preferred) */
-    apiKey?: string;
-    /** Email for session-based auth */
-    email?: string;
-    /** Password for session-based auth */
-    password?: string;
-    /** Existing session token */
-    sessionToken?: string;
-    /** API base URL (defaults to https://api.uluops.ai/api/v1/ops; localhost:3100 when NODE_ENV=development) */
-    baseUrl?: string;
-    /** Request timeout in ms */
-    timeout?: number;
-    /** Number of retries for transient errors */
-    retries?: number;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Callback when session token is refreshed */
-    onTokenRefresh?: (token: string) => void;
-    /** Org slug for multi-tenancy — sets X-Org-Slug header on all requests */
-    orgSlug?: string;
-}
+export type OpsClientConfig = HttpClientConfig;
 /**
  * Main SDK client for the UluOps validation tracker API.
  *
@@ -94,6 +75,10 @@ export declare class OpsClient {
         updateProfile: (input: UpdateProfileInput) => Promise<{
             user: PublicUser;
         }>;
+        getAvatar: () => Promise<{
+            data: ArrayBuffer;
+            contentType: string;
+        }>;
         deleteAvatar: () => Promise<void>;
         listApiKeys: () => Promise<PublicApiKey[]>;
         createApiKey: (input?: CreateApiKeyInput) => Promise<ApiKeyCreatedResponse>;
@@ -115,10 +100,7 @@ export declare class OpsClient {
         getTrends: (idOrName: string, query?: ProjectTrendsQuery) => Promise<ProjectTrends>;
         listIssues: (idOrName: string, query?: ListProjectIssuesQuery) => Promise<Issue[]>;
         listIssuesWithCount: (idOrName: string, query?: ListProjectIssuesQuery) => Promise<PaginatedIssues>;
-        bulkUpdateIssueStatus: (idOrName: string, updates: BulkIssueStatusUpdate[]) => Promise<{
-            updated: number;
-            failed: string[];
-        }>;
+        bulkUpdateIssueStatus: (idOrName: string, updates: BulkIssueStatusUpdate[]) => Promise<BulkIssueStatusResult>;
         mergeIssues: (idOrName: string, input: MergeIssuesInput) => Promise<MergeIssuesResult>;
     };
     /** Validation run save, preview, diff, archive, and retrieval */
@@ -150,22 +132,17 @@ export declare class OpsClient {
         getHistory: (issueId: string) => Promise<StatusHistory[]>;
         updateStatus: (issueId: string, input: UpdateIssueStatusInput) => Promise<Issue>;
         update: (issueId: string, input: UpdateIssueInput) => Promise<Issue>;
-        /** @deprecated Use update instead */
-        edit: (issueId: string, input: UpdateIssueInput) => Promise<Issue>;
         addNote: (issueId: string, input: CreateIssueNoteInput) => Promise<IssueNote>;
         restore: (issueId: string) => Promise<Issue>;
         undoLastChange: (issueId: string) => Promise<Issue>;
-        bulkUpdateStatus: (updates: BulkStatusUpdateItem[]) => Promise<{
-            updated: number;
-            failed: string[];
-        }>;
+        bulkUpdateStatus: (updates: BulkStatusUpdateItem[]) => Promise<z.infer<typeof BulkStatusUpdateResultResponseSchema>>;
         listByProject: (projectId: string, query?: ListIssuesQuery) => Promise<Issue[]>;
     };
     /** Agent performance, taxonomy analytics, burndown, velocity, and discovery */
     readonly analytics: {
         getAgentPerformance: (query?: AnalyticsQuery) => Promise<z.infer<typeof AgentPerformanceResponseSchema>[]>;
         getAgentReliability: (query?: AgentReliabilityQuery) => Promise<z.infer<typeof AgentReliabilityResultResponseSchema>>;
-        getAgentLifecycle: (agentName: string, query?: AnalyticsQuery) => Promise<unknown>;
+        getAgentLifecycle: (agentName: string, query?: AnalyticsQuery) => Promise<AgentLifecycleEntry[]>;
         getResolutionRates: (query?: AnalyticsQuery) => Promise<z.infer<typeof ResolutionRateResponseSchema>[]>;
         getFileHotspots: (query?: AnalyticsQuery) => Promise<z.infer<typeof FileHotspotResponseSchema>[]>;
         getTaxonomyDistribution: (query?: AnalyticsQuery) => Promise<z.infer<typeof TaxonomyDistributionResponseSchema>[]>;
@@ -181,18 +158,10 @@ export declare class OpsClient {
          */
         getByMetric: (metric: analyticsOps.AnalyticsMetric, query?: AnalyticsQuery) => Promise<unknown>;
         listAgents: (query?: AnalyticsQuery) => Promise<AgentInfo[]>;
-        /** @deprecated Use getAgentPerformance instead */
-        getValidatorPerformance: (query?: AnalyticsQuery) => Promise<z.infer<typeof AgentPerformanceResponseSchema>[]>;
-        /** @deprecated Use getAgentReliability instead */
-        getValidatorReliability: (query?: AgentReliabilityQuery) => Promise<z.infer<typeof AgentReliabilityResultResponseSchema>>;
-        /** @deprecated Use getAgentMatrix instead */
-        getValidatorMatrix: (query?: AgentMatrixQuery) => Promise<z.infer<typeof AgentMatrixResultResponseSchema>>;
-        /** @deprecated Use listAgents instead */
-        listValidators: (query?: AnalyticsQuery) => Promise<AgentInfo[]>;
     };
     /** Failure taxonomy schema (domains, modes, severities) */
     readonly taxonomy: {
-        get: () => Promise<TaxonomySchema>;
+        get: () => Promise<TaxonomyResponse>;
     };
 }
 //# sourceMappingURL=client.d.ts.map

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

@@ -1,5 +1,6 @@
 import { OpsHttpClient } from './http/http-client.js';
 import { JwtSessionAuth } from './http/auth-strategy.js';
+import { loadCredentials } from './config/loaders.js';
 import * as authOps from './operations/auth.js';
 import * as projectOps from './operations/projects.js';
 import * as runOps from './operations/runs.js';
@@ -27,7 +28,22 @@ import * as taxonomyOps from './operations/taxonomy.js';
 export class OpsClient {
     httpClient;
     constructor(config = {}) {
+        // Auto-load credentials from env vars / .env / ~/.uluops/credentials.json
+        // if no explicit auth was provided in config
+        const hasExplicitAuth = config.apiKey || config.sessionToken || (config.email && config.password);
+        if (!hasExplicitAuth) {
+            const creds = loadCredentials();
+            if (creds.apiKey)
+                config = { ...config, apiKey: creds.apiKey };
+            else if (creds.sessionToken)
+                config = { ...config, sessionToken: creds.sessionToken };
+            else if (creds.email && creds.password)
+                config = { ...config, email: creds.email, password: creds.password };
+        }
         this.httpClient = new OpsHttpClient(config);
+        if (config.debug && !this.isAuthenticated() && !(config.email && config.password)) {
+            console.warn('[ops-sdk] No credentials found — call client.login() or set ULUOPS_API_KEY before making API requests.');
+        }
     }
     // ============================================
     // SESSION MANAGEMENT
@@ -81,6 +97,7 @@ export class OpsClient {
         getMe: () => authOps.getMe(this.httpClient),
         getProfile: () => authOps.getProfile(this.httpClient),
         updateProfile: (input) => authOps.updateProfile(this.httpClient, input),
+        getAvatar: () => authOps.getAvatar(this.httpClient),
         deleteAvatar: () => authOps.deleteAvatar(this.httpClient),
         listApiKeys: () => authOps.listApiKeys(this.httpClient),
         createApiKey: (input) => authOps.createApiKey(this.httpClient, input),
@@ -144,8 +161,6 @@ export class OpsClient {
         getHistory: (issueId) => issueOps.getHistory(this.httpClient, issueId),
         updateStatus: (issueId, input) => issueOps.updateStatus(this.httpClient, issueId, input),
         update: (issueId, input) => issueOps.update(this.httpClient, issueId, input),
-        /** @deprecated Use update instead */
-        edit: (issueId, input) => issueOps.update(this.httpClient, issueId, input),
         addNote: (issueId, input) => issueOps.addNote(this.httpClient, issueId, input),
         restore: (issueId) => issueOps.restore(this.httpClient, issueId),
         undoLastChange: (issueId) => issueOps.undoLastChange(this.httpClient, issueId),
@@ -175,15 +190,6 @@ export class OpsClient {
          */
         getByMetric: (metric, query) => analyticsOps.getByMetric(this.httpClient, metric, query),
         listAgents: (query) => analyticsOps.listAgents(this.httpClient, query),
-        // Backwards-compatible aliases
-        /** @deprecated Use getAgentPerformance instead */
-        getValidatorPerformance: (query) => analyticsOps.getAgentPerformance(this.httpClient, query),
-        /** @deprecated Use getAgentReliability instead */
-        getValidatorReliability: (query) => analyticsOps.getAgentReliability(this.httpClient, query),
-        /** @deprecated Use getAgentMatrix instead */
-        getValidatorMatrix: (query) => analyticsOps.getAgentMatrix(this.httpClient, query),
-        /** @deprecated Use listAgents instead */
-        listValidators: (query) => analyticsOps.listAgents(this.httpClient, query),
     };
     // ============================================
     // TAXONOMY OPERATIONS