@lumenflow/core 3.2.0 → 3.2.1

package/dist/domain/orchestration.schemas.d.ts

@@ -0,0 +1,307 @@
+/**
+ * Orchestration Domain Schemas
+ *
+ * Zod schemas for runtime validation of orchestration domain types.
+ * Single source of truth - types are inferred from these schemas.
+ *
+ * @module orchestration.schemas
+ * @see {@link ./orchestration.types.ts} - Types inferred from these schemas
+ * @see {@link ./orchestration.constants.ts} - Constants used in validation
+ */
+import { z } from 'zod';
+/**
+ * Schema for global orchestration status.
+ * Shows high-level dashboard metrics at a glance.
+ */
+export declare const GlobalStatusSchema: z.ZodObject<{
+    activeWUs: z.ZodNumber;
+    completed24h: z.ZodNumber;
+    blocked: z.ZodNumber;
+    gatesFailing: z.ZodNumber;
+    longestRunning: z.ZodNullable<z.ZodObject<{
+        wuId: z.ZodString;
+        lane: z.ZodEnum<{
+            "Framework: Core": "Framework: Core";
+            "Framework: CLI": "Framework: CLI";
+            "Framework: Memory": "Framework: Memory";
+            "Framework: Agent": "Framework: Agent";
+            "Framework: Metrics": "Framework: Metrics";
+            "Framework: Initiatives": "Framework: Initiatives";
+            "Framework: Shims": "Framework: Shims";
+            "Operations: Infrastructure": "Operations: Infrastructure";
+            "Operations: CI/CD": "Operations: CI/CD";
+            "Content: Documentation": "Content: Documentation";
+        }>;
+        durationMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    pendingMandatory: z.ZodArray<z.ZodObject<{
+        wuId: z.ZodString;
+        agent: z.ZodEnum<{
+            "general-purpose": "general-purpose";
+            "lumenflow-pm": "lumenflow-pm";
+            "test-engineer": "test-engineer";
+            "code-reviewer": "code-reviewer";
+            "bug-triage": "bug-triage";
+            "lumenflow-enforcer": "lumenflow-enforcer";
+            "lumenflow-doc-sync": "lumenflow-doc-sync";
+        }>;
+    }, z.core.$strip>>;
+    activeSession: z.ZodNullable<z.ZodObject<{
+        sessionId: z.ZodString;
+        wuId: z.ZodString;
+        started: z.ZodString;
+        contextTier: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+        incidentsLogged: z.ZodNumber;
+    }, z.core.$strip>>;
+    worktreesWithUncommittedChanges: z.ZodArray<z.ZodObject<{
+        wuId: z.ZodString;
+        worktreePath: z.ZodString;
+        uncommittedFileCount: z.ZodNumber;
+        lastActivityTimestamp: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for per-agent metrics.
+ * Tracks invocation counts, pass rates, and timing.
+ */
+export declare const AgentMetricSchema: z.ZodObject<{
+    invoked: z.ZodNumber;
+    passRate: z.ZodNumber;
+    avgDurationMs: z.ZodNumber;
+    lastRun: z.ZodNullable<z.ZodObject<{
+        wuId: z.ZodString;
+        timestamp: z.ZodString;
+        result: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for WU progress tracking.
+ * Shows DoD progress and agent status per WU.
+ */
+export declare const WUProgressSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    lane: z.ZodEnum<{
+        "Framework: Core": "Framework: Core";
+        "Framework: CLI": "Framework: CLI";
+        "Framework: Memory": "Framework: Memory";
+        "Framework: Agent": "Framework: Agent";
+        "Framework: Metrics": "Framework: Metrics";
+        "Framework: Initiatives": "Framework: Initiatives";
+        "Framework: Shims": "Framework: Shims";
+        "Operations: Infrastructure": "Operations: Infrastructure";
+        "Operations: CI/CD": "Operations: CI/CD";
+        "Content: Documentation": "Content: Documentation";
+    }>;
+    title: z.ZodString;
+    dodProgress: z.ZodNumber;
+    dodTotal: z.ZodLiteral<11>;
+    agents: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        pass: "pass";
+        pending: "pending";
+        fail: "fail";
+        skipped: "skipped";
+    }>>;
+    headline: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for timeline events.
+ * Records orchestration history for dashboard display.
+ */
+export declare const TimelineEventSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    event: z.ZodEnum<{
+        done: "done";
+        gates: "gates";
+        block: "block";
+        claim: "claim";
+        agent: "agent";
+    }>;
+    wuId: z.ZodString;
+    detail: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        error: "error";
+        warning: "warning";
+    }>;
+}, z.core.$strip>;
+/**
+ * Schema for dashboard alerts.
+ * Highlights items requiring attention.
+ */
+export declare const AlertSchema: z.ZodObject<{
+    severity: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    message: z.ZodString;
+    wuId: z.ZodString;
+    action: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for orchestration suggestions.
+ * Recommendations for next actions.
+ */
+export declare const SuggestionSchema: z.ZodObject<{
+    id: z.ZodString;
+    priority: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    action: z.ZodString;
+    reason: z.ZodString;
+    command: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for execution plans.
+ * Proposed sequence of orchestration actions.
+ */
+export declare const ExecutionPlanSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        order: z.ZodNumber;
+        agent: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            pass: "pass";
+            pending: "pending";
+            fail: "fail";
+            skipped: "skipped";
+        }>;
+    }, z.core.$strip>>;
+    estimatedTokens: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for user choices on execution plans.
+ */
+export declare const UserChoiceSchema: z.ZodObject<{
+    choice: z.ZodEnum<{
+        approve: "approve";
+        reject: "reject";
+        edit: "edit";
+    }>;
+    modifications: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for complete dashboard data.
+ * Aggregates all data needed for dashboard rendering.
+ */
+export declare const DashboardDataSchema: z.ZodObject<{
+    globalStatus: z.ZodObject<{
+        activeWUs: z.ZodNumber;
+        completed24h: z.ZodNumber;
+        blocked: z.ZodNumber;
+        gatesFailing: z.ZodNumber;
+        longestRunning: z.ZodNullable<z.ZodObject<{
+            wuId: z.ZodString;
+            lane: z.ZodEnum<{
+                "Framework: Core": "Framework: Core";
+                "Framework: CLI": "Framework: CLI";
+                "Framework: Memory": "Framework: Memory";
+                "Framework: Agent": "Framework: Agent";
+                "Framework: Metrics": "Framework: Metrics";
+                "Framework: Initiatives": "Framework: Initiatives";
+                "Framework: Shims": "Framework: Shims";
+                "Operations: Infrastructure": "Operations: Infrastructure";
+                "Operations: CI/CD": "Operations: CI/CD";
+                "Content: Documentation": "Content: Documentation";
+            }>;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>>;
+        pendingMandatory: z.ZodArray<z.ZodObject<{
+            wuId: z.ZodString;
+            agent: z.ZodEnum<{
+                "general-purpose": "general-purpose";
+                "lumenflow-pm": "lumenflow-pm";
+                "test-engineer": "test-engineer";
+                "code-reviewer": "code-reviewer";
+                "bug-triage": "bug-triage";
+                "lumenflow-enforcer": "lumenflow-enforcer";
+                "lumenflow-doc-sync": "lumenflow-doc-sync";
+            }>;
+        }, z.core.$strip>>;
+        activeSession: z.ZodNullable<z.ZodObject<{
+            sessionId: z.ZodString;
+            wuId: z.ZodString;
+            started: z.ZodString;
+            contextTier: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+            incidentsLogged: z.ZodNumber;
+        }, z.core.$strip>>;
+        worktreesWithUncommittedChanges: z.ZodArray<z.ZodObject<{
+            wuId: z.ZodString;
+            worktreePath: z.ZodString;
+            uncommittedFileCount: z.ZodNumber;
+            lastActivityTimestamp: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    agentMetrics: z.ZodRecord<z.ZodString, z.ZodObject<{
+        invoked: z.ZodNumber;
+        passRate: z.ZodNumber;
+        avgDurationMs: z.ZodNumber;
+        lastRun: z.ZodNullable<z.ZodObject<{
+            wuId: z.ZodString;
+            timestamp: z.ZodString;
+            result: z.ZodEnum<{
+                pass: "pass";
+                fail: "fail";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    wuProgress: z.ZodArray<z.ZodObject<{
+        wuId: z.ZodString;
+        lane: z.ZodEnum<{
+            "Framework: Core": "Framework: Core";
+            "Framework: CLI": "Framework: CLI";
+            "Framework: Memory": "Framework: Memory";
+            "Framework: Agent": "Framework: Agent";
+            "Framework: Metrics": "Framework: Metrics";
+            "Framework: Initiatives": "Framework: Initiatives";
+            "Framework: Shims": "Framework: Shims";
+            "Operations: Infrastructure": "Operations: Infrastructure";
+            "Operations: CI/CD": "Operations: CI/CD";
+            "Content: Documentation": "Content: Documentation";
+        }>;
+        title: z.ZodString;
+        dodProgress: z.ZodNumber;
+        dodTotal: z.ZodLiteral<11>;
+        agents: z.ZodRecord<z.ZodString, z.ZodEnum<{
+            pass: "pass";
+            pending: "pending";
+            fail: "fail";
+            skipped: "skipped";
+        }>>;
+        headline: z.ZodString;
+    }, z.core.$strip>>;
+    timeline: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        event: z.ZodEnum<{
+            done: "done";
+            gates: "gates";
+            block: "block";
+            claim: "claim";
+            agent: "agent";
+        }>;
+        wuId: z.ZodString;
+        detail: z.ZodString;
+        severity: z.ZodEnum<{
+            info: "info";
+            error: "error";
+            warning: "warning";
+        }>;
+    }, z.core.$strip>>;
+    alerts: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        message: z.ZodString;
+        wuId: z.ZodString;
+        action: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=orchestration.schemas.d.ts.map

package/dist/domain/orchestration.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.schemas.d.ts","sourceRoot":"","sources":["../../src/domain/orchestration.schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuDxB;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB7B,CAAC;AAWH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;iBAS5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;iBAe3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAW9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;iBAStB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAW3B,CAAC;AAgBH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAO9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;iBAK3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW9B,CAAC"}

package/dist/domain/orchestration.schemas.js

@@ -0,0 +1,214 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Orchestration Domain Schemas
+ *
+ * Zod schemas for runtime validation of orchestration domain types.
+ * Single source of truth - types are inferred from these schemas.
+ *
+ * @module orchestration.schemas
+ * @see {@link ./orchestration.types.ts} - Types inferred from these schemas
+ * @see {@link ./orchestration.constants.ts} - Constants used in validation
+ */
+import { z } from 'zod';
+import { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, DOD_TOTAL, } from './orchestration.constants.js';
+/**
+ * Schema for the longest running WU information.
+ */
+const LongestRunningSchema = z.object({
+    wuId: z.string().min(1),
+    lane: z.enum(LANES),
+    durationMs: z.number().nonnegative(),
+});
+/**
+ * Schema for pending mandatory agent information.
+ */
+const PendingMandatorySchema = z.object({
+    wuId: z.string().min(1),
+    agent: z.enum(AGENT_NAMES),
+});
+/**
+ * Schema for active agent session (WU-1438).
+ */
+const ActiveSessionSchema = z.object({
+    sessionId: z.string().uuid(),
+    wuId: z.string().min(1),
+    started: z.string().datetime(),
+    contextTier: z.union([z.literal(1), z.literal(2), z.literal(3)]),
+    incidentsLogged: z.number().int().nonnegative(),
+});
+/**
+ * Schema for worktree with uncommitted changes (WU-1748).
+ * Used for cross-agent visibility of abandoned WU work.
+ */
+const WorktreeWithUncommittedChangesSchema = z.object({
+    /** WU ID extracted from worktree branch name */
+    wuId: z.string().min(1),
+    /** Worktree directory path */
+    worktreePath: z.string().min(1),
+    /** Number of uncommitted files */
+    uncommittedFileCount: z.number().int().nonnegative(),
+    /** Last git activity timestamp (ISO 8601) */
+    lastActivityTimestamp: z.string(),
+});
+/**
+ * Schema for global orchestration status.
+ * Shows high-level dashboard metrics at a glance.
+ */
+export const GlobalStatusSchema = z.object({
+    /** Number of WUs currently in progress */
+    activeWUs: z.number().int().nonnegative(),
+    /** Number of WUs completed in the last 24 hours */
+    completed24h: z.number().int().nonnegative(),
+    /** Number of currently blocked WUs */
+    blocked: z.number().int().nonnegative(),
+    /** Number of WUs with failing gates */
+    gatesFailing: z.number().int().nonnegative(),
+    /** Information about the longest running WU, or null if none active */
+    longestRunning: LongestRunningSchema.nullable(),
+    /** List of WUs with pending mandatory agents */
+    pendingMandatory: z.array(PendingMandatorySchema),
+    /** Current active agent session, or null if none (WU-1438) */
+    activeSession: ActiveSessionSchema.nullable(),
+    /** Worktrees with uncommitted changes for cross-agent visibility (WU-1748) */
+    worktreesWithUncommittedChanges: z.array(WorktreeWithUncommittedChangesSchema),
+});
+/**
+ * Schema for last run information within agent metrics.
+ */
+const LastRunSchema = z.object({
+    wuId: z.string().min(1),
+    timestamp: z.string().datetime(),
+    result: z.enum(['pass', 'fail']),
+});
+/**
+ * Schema for per-agent metrics.
+ * Tracks invocation counts, pass rates, and timing.
+ */
+export const AgentMetricSchema = z.object({
+    /** Total number of times this agent has been invoked */
+    invoked: z.number().int().nonnegative(),
+    /** Pass rate as percentage (0-100) */
+    passRate: z.number().min(0).max(100),
+    /** Average duration in milliseconds */
+    avgDurationMs: z.number().nonnegative(),
+    /** Information about the most recent run, or null if never run */
+    lastRun: LastRunSchema.nullable(),
+});
+/**
+ * Schema for WU progress tracking.
+ * Shows DoD progress and agent status per WU.
+ */
+export const WUProgressSchema = z.object({
+    /** Work Unit ID (e.g., "WU-1234") */
+    wuId: z.string().min(1),
+    /** Lane the WU is assigned to */
+    lane: z.enum(LANES),
+    /** Human-readable title of the WU */
+    title: z.string().min(1),
+    /** Current DoD checkpoint progress (0 to DOD_TOTAL) */
+    dodProgress: z.number().int().min(0).max(DOD_TOTAL),
+    /** Total DoD checkpoints (always DOD_TOTAL) */
+    dodTotal: z.literal(DOD_TOTAL),
+    /** Status of each agent that has been or should be run */
+    agents: z.record(z.string(), z.enum(AGENT_RESULT_STATUSES)),
+    /** Tufte-style headline sentence describing current state */
+    headline: z.string(),
+});
+/**
+ * Schema for timeline events.
+ * Records orchestration history for dashboard display.
+ */
+export const TimelineEventSchema = z.object({
+    /** ISO 8601 timestamp of the event */
+    timestamp: z.string().datetime(),
+    /** Type of orchestration event */
+    event: z.enum(TIMELINE_EVENT_TYPES),
+    /** Associated Work Unit ID */
+    wuId: z.string().min(1),
+    /** Human-readable event description */
+    detail: z.string(),
+    /** Visual severity for display */
+    severity: z.enum(EVENT_SEVERITY_LEVELS),
+});
+/**
+ * Schema for dashboard alerts.
+ * Highlights items requiring attention.
+ */
+export const AlertSchema = z.object({
+    /** Alert severity level */
+    severity: z.enum(SEVERITY_LEVELS),
+    /** Human-readable alert message */
+    message: z.string().min(1),
+    /** Associated Work Unit ID */
+    wuId: z.string().min(1),
+    /** Suggested action or command */
+    action: z.string().min(1),
+});
+/**
+ * Schema for orchestration suggestions.
+ * Recommendations for next actions.
+ */
+export const SuggestionSchema = z.object({
+    /** Unique suggestion identifier */
+    id: z.string().min(1),
+    /** Suggestion priority level */
+    priority: z.enum(SEVERITY_LEVELS),
+    /** Short action description */
+    action: z.string().min(1),
+    /** Reason for the suggestion */
+    reason: z.string().min(1),
+    /** CLI command to execute the suggestion */
+    command: z.string().min(1),
+});
+/**
+ * Schema for execution plan steps.
+ */
+const ExecutionStepSchema = z.object({
+    /** Execution order (1-based) */
+    order: z.number().int().positive(),
+    /** Agent to run (if applicable) */
+    agent: z.string().optional(),
+    /** Action to perform (if not an agent) */
+    action: z.string().optional(),
+    /** Step execution status */
+    status: z.enum(AGENT_RESULT_STATUSES),
+});
+/**
+ * Schema for execution plans.
+ * Proposed sequence of orchestration actions.
+ */
+export const ExecutionPlanSchema = z.object({
+    /** Work Unit ID this plan is for */
+    wuId: z.string().min(1),
+    /** Ordered list of steps to execute */
+    steps: z.array(ExecutionStepSchema),
+    /** Estimated token cost for the full plan */
+    estimatedTokens: z.number().int().nonnegative(),
+});
+/**
+ * Schema for user choices on execution plans.
+ */
+export const UserChoiceSchema = z.object({
+    /** User's choice */
+    choice: z.enum(USER_CHOICE_OPTIONS),
+    /** Modifications if choice is 'edit' */
+    modifications: z.array(z.string()).optional(),
+});
+/**
+ * Schema for complete dashboard data.
+ * Aggregates all data needed for dashboard rendering.
+ */
+export const DashboardDataSchema = z.object({
+    /** Global status metrics */
+    globalStatus: GlobalStatusSchema,
+    /** Per-agent metrics keyed by agent name */
+    agentMetrics: z.record(z.string(), AgentMetricSchema),
+    /** Progress for all active WUs */
+    wuProgress: z.array(WUProgressSchema),
+    /** Recent timeline events */
+    timeline: z.array(TimelineEventSchema),
+    /** Current alerts */
+    alerts: z.array(AlertSchema),
+});
+//# sourceMappingURL=orchestration.schemas.js.map

package/dist/domain/orchestration.schemas.js.map

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

package/dist/domain/orchestration.types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Orchestration Domain Types
+ *
+ * TypeScript types inferred from Zod schemas.
+ * Single source of truth - schemas validate at runtime, types at compile time.
+ *
+ * @module orchestration.types
+ * @see {@link ./orchestration.schemas.ts} - Schemas these types are inferred from
+ * @see {@link ./orchestration.constants.ts} - Constants and derived types
+ */
+import type { z } from 'zod';
+import type { GlobalStatusSchema, AgentMetricSchema, WUProgressSchema, TimelineEventSchema, AlertSchema, SuggestionSchema, ExecutionPlanSchema, UserChoiceSchema, DashboardDataSchema } from './orchestration.schemas.js';
+export type { Lane, AgentName, SeverityLevel, AgentResultStatus, TimelineEventType, EventSeverityLevel, UserChoiceOption, MandatoryAgentName, } from './orchestration.constants.js';
+export { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, MANDATORY_AGENT_NAMES, } from './orchestration.constants.js';
+/**
+ * Global orchestration status.
+ * Shows high-level dashboard metrics at a glance.
+ *
+ * @example
+ * const status: GlobalStatus = {
+ *   activeWUs: 2,
+ *   completed24h: 5,
+ *   blocked: 1,
+ *   gatesFailing: 0,
+ *   longestRunning: { wuId: 'WU-1234', lane: 'Intelligence', durationMs: 2700000 },
+ *   pendingMandatory: [{ wuId: 'WU-1235', agent: 'security-auditor' }],
+ * };
+ */
+export type GlobalStatus = z.infer<typeof GlobalStatusSchema>;
+/**
+ * Per-agent metrics for dashboard display.
+ * Tracks invocation counts, pass rates, and timing.
+ *
+ * @example
+ * const metric: AgentMetric = {
+ *   invoked: 3,
+ *   passRate: 100,
+ *   avgDurationMs: 120000,
+ *   lastRun: { wuId: 'WU-1234', timestamp: '2025-01-15T10:00:00Z', result: 'pass' },
+ * };
+ */
+export type AgentMetric = z.infer<typeof AgentMetricSchema>;
+/**
+ * Work Unit progress for dashboard display.
+ * Shows DoD progress and agent status per WU.
+ *
+ * @example
+ * const progress: WUProgress = {
+ *   wuId: 'WU-1234',
+ *   lane: 'Intelligence',
+ *   title: 'LLM Classification Feature',
+ *   dodProgress: 8,
+ *   dodTotal: 11,
+ *   agents: { 'llm-reviewer': 'pass', 'code-reviewer': 'pending' },
+ *   headline: 'Blocked on code-reviewer - awaiting approval',
+ * };
+ */
+export type WUProgress = z.infer<typeof WUProgressSchema>;
+/**
+ * Timeline event for orchestration history.
+ * Records key events for dashboard display.
+ *
+ * @example
+ * const event: TimelineEvent = {
+ *   timestamp: '2025-01-15T09:00:00Z',
+ *   event: 'claim',
+ *   wuId: 'WU-1234',
+ *   detail: 'Claimed for Intelligence lane',
+ *   severity: 'info',
+ * };
+ */
+export type TimelineEvent = z.infer<typeof TimelineEventSchema>;
+/**
+ * Dashboard alert for items requiring attention.
+ *
+ * @example
+ * const alert: Alert = {
+ *   severity: 'high',
+ *   message: 'Mandatory agent not yet invoked',
+ *   wuId: 'WU-1235',
+ *   action: 'Run security-auditor before wu:done',
+ * };
+ */
+export type Alert = z.infer<typeof AlertSchema>;
+/**
+ * Orchestration suggestion for next actions.
+ *
+ * @example
+ * const suggestion: Suggestion = {
+ *   id: 'sug-001',
+ *   priority: 'high',
+ *   action: 'Run security-auditor',
+ *   reason: 'WU touches auth paths',
+ *   command: 'pnpm orchestrate:run security-auditor',
+ * };
+ */
+export type Suggestion = z.infer<typeof SuggestionSchema>;
+/**
+ * Execution plan for proposed orchestration actions.
+ *
+ * @example
+ * const plan: ExecutionPlan = {
+ *   wuId: 'WU-1234',
+ *   steps: [
+ *     { order: 1, agent: 'llm-reviewer', status: 'pending' },
+ *     { order: 2, action: 'gates', status: 'pending' },
+ *   ],
+ *   estimatedTokens: 5000,
+ * };
+ */
+export type ExecutionPlan = z.infer<typeof ExecutionPlanSchema>;
+/**
+ * User choice on execution plan confirmation.
+ *
+ * @example
+ * const choice: UserChoice = { choice: 'approve' };
+ * const editChoice: UserChoice = { choice: 'edit', modifications: ['Skip step 2'] };
+ */
+export type UserChoice = z.infer<typeof UserChoiceSchema>;
+/**
+ * Complete dashboard data aggregating all metrics.
+ * This is the main data structure passed to renderers.
+ *
+ * @example
+ * const data: DashboardData = {
+ *   globalStatus: { ... },
+ *   agentMetrics: { 'security-auditor': { ... } },
+ *   wuProgress: [{ ... }],
+ *   timeline: [{ ... }],
+ *   alerts: [{ ... }],
+ * };
+ */
+export type DashboardData = z.infer<typeof DashboardDataSchema>;
+//# sourceMappingURL=orchestration.types.d.ts.map

package/dist/domain/orchestration.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.types.d.ts","sourceRoot":"","sources":["../../src/domain/orchestration.types.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EACV,IAAI,EACJ,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,KAAK,EACL,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/domain/orchestration.types.js

@@ -0,0 +1,5 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// Re-export const values as well
+export { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, MANDATORY_AGENT_NAMES, } from './orchestration.constants.js';
+//# sourceMappingURL=orchestration.types.js.map

package/dist/domain/orchestration.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.types.js","sourceRoot":"","sources":["../../src/domain/orchestration.types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAsCzC,iCAAiC;AACjC,OAAO,EACL,KAAK,EACL,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}