@uluops/core 0.5.0

package/dist/types/registry.d.ts

@@ -0,0 +1,232 @@
+import type { DefinitionType, Domain, AgentType } from './execution.js';
+import type { AgentDefinition } from './agent.js';
+import type { CommandDefinition } from './command.js';
+import type { WorkflowDefinition } from './workflow.js';
+import type { PipelineDefinition } from './pipeline.js';
+/**
+ * Resolved definition from registry
+ */
+export interface ResolvedDefinition {
+    /** Definition type */
+    type: DefinitionType;
+    /** Definition name */
+    name: string;
+    /** Resolved version */
+    version: string;
+    /** SHA-256 hash of source YAML */
+    hash: string;
+    /** Raw YAML content */
+    yaml: string;
+    /** Parsed definition */
+    definition: AgentDefinition | CommandDefinition | WorkflowDefinition | PipelineDefinition;
+    /** Rendered runtime - type depends on agentType */
+    runtime: ValidatorRuntime | ExecutorRuntime | WorkflowRuntime | PipelineRuntime;
+    /** Domain classification */
+    domain: Domain;
+    /** Agent type (only for agents/commands) */
+    agentType?: AgentType;
+}
+/**
+ * Runtime configuration for validator agents
+ */
+export interface ValidatorRuntime {
+    /** Complete system prompt */
+    prompt: string;
+    /** Agent interface metadata (tools, name, etc.) */
+    interface?: {
+        tools?: string[];
+        [key: string]: unknown;
+    };
+    /** Default execution settings */
+    defaults: {
+        model: string;
+        timeout: number;
+        maxTokens?: number;
+        temperature?: number;
+        thresholds?: {
+            pass?: number;
+            warn?: number;
+        };
+    };
+    /** Scoring configuration */
+    config: {
+        maxScore: number;
+        threshold: number;
+        categories: CategoryConfig[];
+        outputSchema: string;
+    };
+}
+/**
+ * Runtime configuration for executor agents
+ */
+export interface ExecutorRuntime {
+    /** Complete system prompt */
+    prompt: string;
+    /** Agent interface metadata (tools, name, etc.) */
+    interface?: {
+        tools?: string[];
+        [key: string]: unknown;
+    };
+    /** Default execution settings */
+    defaults: {
+        model: string;
+        timeout: number;
+        maxTokens?: number;
+        temperature?: number;
+    };
+    /** Execution configuration */
+    config: {
+        mode: string;
+        inputs: InputConfig[];
+        tasks: TaskConfig[];
+        outputs: OutputConfig[];
+        completionCriteria: string[];
+        outputSchema: string;
+    };
+}
+/**
+ * Scoring category configuration
+ */
+export interface CategoryConfig {
+    name: string;
+    weight: number;
+    criteria: CriteriaConfig[];
+    description?: string;
+}
+/**
+ * Individual scoring criterion
+ */
+export interface CriteriaConfig {
+    name: string;
+    points: number;
+    description?: string;
+}
+/**
+ * Input configuration for executors
+ */
+export interface InputConfig {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+    required?: boolean;
+    default?: unknown;
+}
+/**
+ * Task configuration for executors
+ */
+export interface TaskConfig {
+    id: string;
+    name: string;
+    description: string;
+    depends_on?: string[];
+}
+/**
+ * Output configuration for executors
+ */
+export interface OutputConfig {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+}
+/**
+ * Runtime configuration for workflows
+ */
+export interface WorkflowRuntime {
+    phases: PhaseConfig[];
+    onFailure: 'stop' | 'continue' | 'abort' | 'warn';
+    aggregation: AggregationConfig;
+    outputs?: OutputMapping[];
+}
+/**
+ * Runtime configuration for pipelines
+ */
+export interface PipelineRuntime {
+    stages: StageConfig[];
+    triggers: TriggerConfig[];
+    state: StateConfig;
+}
+/**
+ * Workflow phase configuration
+ */
+export interface PhaseConfig {
+    id: string;
+    name: string;
+    type?: 'validate' | 'execute' | 'mixed';
+    commands: string[];
+    depends_on?: string[];
+    gate?: {
+        threshold: number;
+        aggregate?: 'min' | 'max' | 'average';
+        on_fail?: 'stop' | 'warn' | 'abort';
+    };
+    inputs?: Record<string, string>;
+    skip_if?: string;
+}
+/**
+ * Score aggregation configuration
+ */
+export interface AggregationConfig {
+    method: 'average' | 'weighted_average' | 'min' | 'max' | 'sum';
+    weights?: Record<string, number>;
+}
+/**
+ * Output mapping for workflows
+ */
+export interface OutputMapping {
+    name: string;
+    source: string;
+}
+/**
+ * Pipeline stage configuration
+ */
+export interface StageConfig {
+    id: string;
+    name: string;
+    type: 'workflow' | 'command';
+    ref: string;
+    depends_on?: string[];
+    condition?: string;
+}
+/**
+ * Pipeline trigger configuration
+ */
+export interface TriggerConfig {
+    type: 'webhook' | 'schedule' | 'event' | 'manual';
+    event?: string;
+    cron?: string;
+}
+/**
+ * Pipeline state configuration
+ */
+export interface StateConfig {
+    persistence: boolean;
+    ttl: string;
+}
+/**
+ * Definition summary for listings
+ */
+export interface DefinitionSummary {
+    type: DefinitionType;
+    name: string;
+    version: string;
+    displayName: string;
+    description: string;
+    domain: Domain;
+    subdomain?: string;
+    agentType?: AgentType;
+    status: 'draft' | 'published' | 'deprecated' | 'archived';
+    tags?: string[];
+}
+/**
+ * Definition reference (for dependency tracking)
+ */
+export interface Reference {
+    fromType: DefinitionType;
+    fromName: string;
+    fromVersion: string;
+    toType: DefinitionType;
+    toName: string;
+    toVersion: string;
+    context: string;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/types/registry.d.ts.map

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

package/dist/types/registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/types/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":""}

package/dist/types/tools.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool definition for LLM API
+ */
+export interface Tool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * Tool use request from LLM
+ */
+export interface ToolUseBlock {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Tool result to send back to LLM
+ */
+export interface ToolResult {
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/types/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types/tools.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":""}

package/dist/types/validation.d.ts

@@ -0,0 +1,237 @@
+import type { ExecutionResult, Recommendation } from './execution.js';
+import type { AgentResult } from './agent.js';
+/**
+ * Validator snapshot for API submission
+ * Matches Validation API's validator object format
+ */
+export interface ValidatorSnapshot {
+    /** Validator name */
+    name: string;
+    /** Score (0-100) */
+    score: number;
+    /** Maximum possible score */
+    max_score?: number;
+    /** Status (e.g., 'PASS', 'FAIL', 'WARN') */
+    status: string;
+    /** Model used */
+    model?: string;
+    /** Token usage metrics */
+    tokens?: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation?: number;
+        cache_read?: number;
+        total_effective?: number;
+    };
+    /** Execution duration in milliseconds */
+    duration_ms?: number;
+}
+/**
+ * Recommendation payload for API submission
+ * Uses snake_case to match Validation API format
+ */
+export interface RecommendationPayload {
+    /** Source validator */
+    validator: string;
+    /** Issue title */
+    title: string;
+    /** Priority level */
+    priority: 'critical' | 'suggested' | 'backlog';
+    /** Severity level */
+    severity?: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    /** Failure code (e.g., 'STR-SYN/C') */
+    failure_code?: string;
+    /** Failure domain */
+    failure_domain?: 'STR' | 'SEM' | 'PRA' | 'EPI';
+    /** Failure mode code */
+    failure_mode?: string;
+    /** Issue category */
+    category?: string;
+    /** File path */
+    file_path?: string;
+    /** Line number */
+    line_number?: number;
+    /** Detailed description */
+    description?: string;
+    /** Classification confidence */
+    classification_confidence?: 'high' | 'medium' | 'low';
+    /** Who classified this */
+    classified_by?: 'validator' | 'classifier' | 'human';
+    /** Secondary failure codes */
+    secondary_failure_codes?: string[];
+    /** Taxonomy version */
+    taxonomy_version?: string;
+}
+/**
+ * Run submission request to Validation API
+ */
+export interface ValidationRunRequest {
+    /** Project name */
+    project: string;
+    /** Workflow type (e.g., 'post-implementation', 'ship') */
+    workflow_type: string;
+    /** Idempotency key for duplicate prevention */
+    idempotency_key?: string;
+    /** Validator snapshots */
+    validators: ValidatorSnapshot[];
+    /** Recommendations/issues found */
+    recommendations: RecommendationPayload[];
+    /** Run timestamp */
+    timestamp?: string;
+    /** Raw markdown output */
+    raw_markdown?: string;
+    /** Summary statistics */
+    summary?: {
+        all_gates_passed: boolean;
+        average_score: number;
+    };
+}
+/**
+ * Correlated issue from API response
+ */
+export interface CorrelatedIssue {
+    /** Issue UUID */
+    id: string;
+    /** Issue title */
+    title: string;
+    /** SHA-256 fingerprint */
+    fingerprint: string;
+    /** Occurrence count (for recurring issues) */
+    occurrenceCount?: number;
+    /** Run ID where resolved (for regressions) */
+    resolvedRunId?: string;
+}
+/**
+ * Raw API response from POST /v1/runs
+ */
+export interface ValidationAPIRunResponse {
+    data: {
+        run: {
+            id: string;
+            projectId: string;
+            runNumber: number;
+            workflowType: string;
+            timestamp: string;
+            allGatesPassed: boolean;
+            averageScore: number;
+            idempotencyKey?: string;
+        };
+        validators: ValidatorSnapshot[];
+        correlation: {
+            new_issues: CorrelatedIssue[];
+            recurring_issues: CorrelatedIssue[];
+            regressions: CorrelatedIssue[];
+        };
+        deduplicated: boolean;
+    };
+}
+/**
+ * SDK's high-level run submission input
+ */
+export interface RunSubmission {
+    /** Project name */
+    project: string;
+    /** Workflow/definition name */
+    workflowType: string;
+    /** Execution result to submit (agent results are also accepted) */
+    result: ExecutionResult | AgentResult;
+    /** Optional idempotency key */
+    idempotencyKey?: string;
+    /** Optional raw markdown output */
+    rawMarkdown?: string;
+}
+/**
+ * SDK's high-level response after submission.
+ *
+ * Correlation contains issue counts from the Validation API.
+ * For full issue details (CorrelatedIssue arrays), use `@uluops/ops-sdk` directly.
+ */
+export interface RunSubmissionResponse {
+    /** Unique run identifier */
+    runId: string;
+    /** Run number within project */
+    runNumber: number;
+    /** Project ID */
+    projectId: string;
+    /** Dashboard URL for this run */
+    dashboardUrl: string;
+    /** Whether all validation gates passed */
+    allGatesPassed: boolean;
+    /** Average score across validators */
+    averageScore: number;
+    /** Issue correlation counts from validation API */
+    correlation: {
+        newIssues: number;
+        recurringIssues: number;
+        regressions: number;
+    };
+    /** Whether this was a deduplicated response */
+    deduplicated: boolean;
+}
+/**
+ * Recommendation with fingerprint from validation service
+ */
+export interface FingerprintedRecommendation extends Recommendation {
+    /** Stable fingerprint for correlation */
+    fingerprint: string;
+    /** First seen timestamp */
+    firstSeen: string;
+    /** Occurrence count across runs */
+    occurrenceCount: number;
+    /** Status */
+    status: 'new' | 'recurring' | 'resolved';
+}
+/**
+ * Regression information
+ */
+export interface RegressionInfo {
+    /** Recommendation that regressed */
+    recommendation: FingerprintedRecommendation;
+    /** Previous run where it was resolved */
+    previousRunId: string;
+    /** How long it was resolved */
+    resolvedDuration: string;
+}
+/**
+ * Query options for validation service run history
+ */
+export interface ValidationQueryOptions {
+    /** Filter by project */
+    project?: string;
+    /** Filter by workflow type */
+    workflowType?: string;
+    /** Limit results (1-100) */
+    limit?: number;
+}
+/**
+ * Run history entry - matches Validation API Run model
+ */
+export interface RunHistoryEntry {
+    /** Run UUID */
+    id: string;
+    /** Project UUID */
+    projectId: string;
+    /** Sequential run number within project */
+    runNumber: number;
+    /** Workflow type */
+    workflowType: string;
+    /** Run timestamp */
+    timestamp: string;
+    /** Whether all validation gates passed */
+    allGatesPassed: boolean;
+    /** Average score across validators */
+    averageScore: number;
+    /** Raw markdown output (if stored) */
+    rawMarkdown?: string;
+    /** Archive timestamp (if archived) */
+    archivedAt?: string;
+    /** Archive reason (if archived) */
+    archiveReason?: string;
+    /** Idempotency key (if provided) */
+    idempotencyKey?: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

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

package/dist/types/validation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.js.map

package/dist/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":""}

package/dist/types/workflow.d.ts

@@ -0,0 +1,131 @@
+import type { ExecutionResult, ExecutionMetrics, Domain } from './execution.js';
+import type { CommandResult } from './command.js';
+/**
+ * Workflow definition - multi-phase command orchestration
+ */
+export interface WorkflowDefinition {
+    workflow: {
+        /** Workflow metadata */
+        interface: {
+            name: string;
+            version: string;
+            displayName: string;
+            description: string;
+            domain: Domain;
+            subdomain?: string;
+        };
+        /** Phase orchestration */
+        orchestration: {
+            /** Ordered phases */
+            phases: PhaseDefinition[];
+            /** Behavior on phase failure */
+            on_failure: 'stop' | 'continue' | 'abort' | 'warn';
+            /** Maximum concurrent phases (default: unlimited) */
+            max_parallel?: number;
+        };
+        /** Result aggregation */
+        aggregation: {
+            /** Score aggregation */
+            score: {
+                method: 'average' | 'weighted_average' | 'min' | 'max' | 'sum';
+                weights?: Record<string, number>;
+            };
+            /** Decision mapping */
+            decision: {
+                SHIP: string;
+                HOLD: string;
+                BLOCK: string;
+            };
+        };
+    };
+}
+/**
+ * Phase definition within a workflow
+ */
+export interface PhaseDefinition {
+    id: string;
+    name: string;
+    /** Phase type hint */
+    type?: 'validate' | 'execute' | 'mixed';
+    /** Commands to execute in this phase (refs in name@version format) */
+    commands: string[];
+    /** Execute commands in parallel */
+    parallel?: boolean;
+    /** Phase dependencies */
+    depends_on?: string[];
+    /** Input mappings from previous phases */
+    inputs?: Record<string, string>;
+    /** Skip condition expression */
+    skip_if?: string;
+    /** Phase gate (validators only) */
+    gate?: {
+        threshold: number;
+        aggregate: 'average' | 'min' | 'max';
+        on_fail: 'stop' | 'warn' | 'abort';
+    };
+}
+/**
+ * Workflow execution result
+ */
+export interface WorkflowResult extends ExecutionResult {
+    type: 'workflow';
+    /** Phase-by-phase results */
+    phases: PhaseResult[];
+    /** Path to generated features list (if enabled) */
+    featuresListPath?: string;
+    /** Workflow-specific metrics */
+    metrics: WorkflowMetrics;
+}
+/**
+ * Workflow-specific metrics
+ */
+export interface WorkflowMetrics extends ExecutionMetrics {
+    /** Number of phases executed */
+    phasesExecuted: number;
+    /** Number of phases passed */
+    phasesPassed: number;
+    /** Number of phases warned */
+    phasesWarned: number;
+    /** Number of phases blocked */
+    phasesBlocked: number;
+    /** Number of phases skipped */
+    phasesSkipped: number;
+    /** Number of phases aborted */
+    phasesAborted: number;
+    /** Per-command metrics breakdown */
+    commands: CommandMetricsSummary[];
+}
+/**
+ * Per-command metrics within a workflow
+ */
+export interface CommandMetricsSummary {
+    name: string;
+    score: number;
+    decision: string;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    costUsd?: number;
+}
+/**
+ * Result for a single phase
+ */
+export interface PhaseResult {
+    /** Phase identifier */
+    id: string;
+    /** Phase display name */
+    name: string;
+    /** Phase decision */
+    decision: 'passed' | 'warned' | 'blocked' | 'skipped' | 'aborted';
+    /** Command results within phase */
+    commands: CommandResult[];
+    /** Gate threshold that was applied */
+    gateThreshold: number;
+    /** Aggregated phase score */
+    score: number;
+    /** Phase duration */
+    durationMs: number;
+    /** Error message when phase threw (blocked phases only) */
+    error?: string;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/types/workflow.d.ts.map

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

package/dist/types/workflow.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow.js.map