@amsterdamdatalabs/enact-factory 0.1.1

package/dist/core/types.d.ts

@@ -0,0 +1,432 @@
+import type { WorkItemRecordStatus } from '../workItems/schema.js';
+/**
+ * Agent session configuration
+ */
+export type ProjectConfig = {
+    name: string;
+    path: string;
+    heartbeatMs: number;
+    azdoLabel?: string;
+    enabled: boolean;
+    paused: boolean;
+    operators?: string[];
+};
+/**
+ * Agent status
+ */
+export type AgentStatus = {
+    name: string;
+    currentWorkItemId?: string;
+    lastHeartbeat?: number;
+    lastReport?: string;
+    state: 'idle' | 'working' | 'blocked' | 'paused';
+};
+/**
+ * Azdo project info
+ */
+export type AzdoProjectInfo = {
+    id: string;
+    name: string;
+    icon?: string;
+    color?: string;
+};
+/**
+ * Azdo workItem summary info
+ */
+export type AzdoWorkItemInfo = {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    state: string;
+    priority: number;
+    labels: string[];
+    comments: AzdoComment[];
+    /** Azdo project info */
+    project?: AzdoProjectInfo;
+};
+/**
+ * Azdo comment
+ */
+export type AzdoComment = {
+    id: string;
+    body: string;
+    createdAt: string;
+    user?: string;
+};
+/**
+ * Factory operational event (logs / future notification hooks)
+ */
+export type FactoryEvent = {
+    type: 'work_item_started' | 'work_item_completed' | 'work_item_blocked' | 'build_failed' | 'test_failed' | 'commit' | 'error' | 'ci_failed' | 'ci_recovered';
+    session: string;
+    message: string;
+    workItemId?: string;
+    timestamp: number;
+    url?: string;
+};
+export type ClosureContract = {
+    required: string[];
+    optional: string[];
+    tagOverrides?: Record<string, {
+        addRequired?: string[];
+        removeRequired?: string[];
+    }>;
+};
+/**
+ * Global configuration
+ */
+export type FactoryConfig = {
+    /** UI language: 'en' | 'ko' (default: 'en') */
+    language: 'en' | 'ko';
+    /** WorkItem source: 'auto' | 'azdo' | 'local' | 'disabled' */
+    workItemSource: 'auto' | 'azdo' | 'local' | 'disabled';
+    /** Database configuration */
+    database: {
+        type: 'sqlite' | 'postgres';
+        url?: string;
+        host?: string;
+        port?: number;
+        database?: string;
+        user?: string;
+        password?: string;
+        schema?: string;
+    };
+    /** Azdo API key */
+    azdoApiKey: string;
+    /** Azdo team ID */
+    azdoTeamId: string;
+    /** Agent session list */
+    projects: ProjectConfig[];
+    defaultHeartbeatMs: number;
+    /** Time window config (agent autonomous work restriction) */
+    timeWindow?: TimeWindowConfig;
+    /** Executor/Reviewer pair mode config */
+    pairMode?: PairModeConfig;
+    /** Autonomous execution mode config */
+    autonomous?: AutonomousStartupConfig;
+    /** Long-running workItem monitor configuration */
+    monitors?: LongRunningMonitorConfig[];
+    /** Daily status report scheduler config */
+    dailyReporter?: DailyReporterConfig;
+    /** Azure DevOps heartbeat sync config */
+    azureDevOps?: AzdoSyncConfig;
+    /** Closure contracts keyed by WorkItem type (e.g. 'PBI', 'Bug') */
+    closureContracts?: Record<string, ClosureContract>;
+    /** Lifecycle boolean declarations (capability matrix) */
+    lifecycle?: {
+        booleans: Array<{
+            id: string;
+            label?: string;
+            order?: number;
+            flippedBy: string[];
+            source?: string;
+        }>;
+    };
+    /** Operator scheduler configuration */
+    scheduler?: {
+        enabled: boolean;
+        pickNextOperator: {
+            strategy: string;
+            fallback: string;
+            respectOperatorLaneHint: boolean;
+        };
+    };
+};
+/**
+ * Bootstrap config loaded directly from config.toml before the canonical project
+ * registry is resolved. `projects` is only the legacy seed list used to
+ * bootstrap the Postgres-backed registry when it is empty.
+ */
+export type BootstrapFactoryConfig = FactoryConfig;
+/**
+ * Service state
+ */
+export type ServiceState = {
+    running: boolean;
+    startedAt?: number;
+    projects: Map<string, AgentStatus>;
+    timers: Map<string, NodeJS.Timeout>;
+};
+/**
+ * Time range
+ */
+export type TimeRange = {
+    start: string;
+    end: string;
+};
+/**
+ * Time window configuration
+ */
+export type TimeWindowConfig = {
+    /** Whether time restriction is enabled */
+    enabled: boolean;
+    /** Allowed work time ranges */
+    allowedWindows: TimeRange[];
+    /** Blocked time ranges (e.g. market hours) */
+    blockedWindows: TimeRange[];
+    /** Restricted days of week (0=Sun, 1=Mon, ..., 6=Sat) */
+    restrictedDays?: number[];
+    /** Timezone */
+    timezone?: string;
+};
+/**
+ * Executor/Reviewer pair mode configuration
+ */
+export type PairModeConfig = {
+    /** Enable pair mode */
+    enabled: boolean;
+    /** Executor max attempts */
+    maxAttempts: number;
+    /** Executor timeout (ms) */
+    executorTimeoutMs: number;
+    /** Reviewer timeout (ms) */
+    reviewerTimeoutMs: number;
+    /** Webhook URL (notification on complete/failure) */
+    webhookUrl?: string;
+    /** Auto Azdo status update */
+    autoAzdoUpdate: boolean;
+};
+/**
+ * Model configuration
+ */
+export type ModelConfig = {
+    /** Executor agent model */
+    executor: string;
+    /** Reviewer agent model */
+    reviewer: string;
+};
+/**
+ * Per-role configuration
+ */
+export type ReviewerConsensusConfig = {
+    /** Enable multi-reviewer consensus checks */
+    enabled?: boolean;
+    /** Additional reviewer models to run in addition to the primary reviewer model */
+    models?: string[];
+    /** Minimum number of approvals needed to pass (defaults to total reviewers run) */
+    requiredApprovals?: number;
+};
+export type StageConfig = {
+    enabled: boolean;
+    adapter?: 'claude' | 'codex' | 'responses' | 'cursor' | 'hermes' | 'opencode';
+    model: string;
+    timeoutMs: number;
+    escalateModel?: string;
+    escalateAfterIteration?: number;
+    maxTurns?: number;
+    consensus?: ReviewerConsensusConfig;
+};
+/**
+ * Pipeline stage
+ */
+export type PipelineStage = 'coder' | 'critic' | 'evaluator' | 'tester' | 'documenter' | 'auditor' | 'stage-documenter';
+/**
+ * Evaluator role configuration (LLM-as-a-Judge)
+ * Extends RoleConfig with evaluator-specific thresholds.
+ */
+export type EvaluatorStageConfig = StageConfig & {
+    passScore?: number;
+    maxRevisions?: number;
+};
+export type JobProfile = {
+    name: string;
+    minMinutes?: number;
+    maxMinutes?: number;
+    priority?: number;
+    roles?: Partial<Record<PipelineStage, string>>;
+};
+/**
+ * Per-project agent configuration
+ */
+export type ProjectAgentConfig = {
+    path: string;
+    azdoProjectId?: string;
+    stages?: {
+        coder?: Partial<StageConfig>;
+        critic?: Partial<StageConfig>;
+        evaluator?: Partial<EvaluatorStageConfig>;
+        tester?: Partial<StageConfig>;
+        documenter?: Partial<StageConfig>;
+        auditor?: Partial<StageConfig>;
+        'stage-documenter'?: Partial<StageConfig>;
+    };
+};
+export type DefaultStagesConfig = {
+    coder: StageConfig;
+    critic: StageConfig;
+    evaluator?: EvaluatorStageConfig;
+    tester?: StageConfig;
+    documenter?: StageConfig;
+    auditor?: StageConfig;
+    'stage-documenter'?: StageConfig;
+};
+/**
+ * WorkItem decomposition (Planner) configuration
+ */
+export type DecompositionConfig = {
+    /** Enable decomposition */
+    enabled: boolean;
+    /** Decomposition threshold (minutes) - workItems exceeding this estimate are decomposed */
+    thresholdMinutes: number;
+    /** Max decomposition depth (default: 2) - prevents infinite nesting */
+    maxDepth?: number;
+    /** Max children per workItem (default: 5) - prevents workItem explosion */
+    maxChildrenPerWorkItem?: number;
+    /** Daily workItem creation limit (default: 20) - prevents runaway creation */
+    dailyLimit?: number;
+    /** Auto-move to backlog if too complex or failing (default: true) */
+    autoBacklog?: boolean;
+    /** Planner model */
+    plannerModel: string;
+    /** Planner timeout (ms) - default 600000 (10min) */
+    plannerTimeoutMs: number;
+};
+/**
+ * Autonomous execution mode configuration
+ */
+/** Completion check strategy */
+export type CompletionCheck = {
+    type: 'exit-code';
+    successExitCode?: number;
+} | {
+    type: 'output-regex';
+    successPattern: string;
+    failurePattern?: string;
+} | {
+    type: 'http-status';
+    expectedStatus?: number;
+};
+/** Monitor configuration (registered via root config.toml or API) */
+export type LongRunningMonitorConfig = {
+    id: string;
+    name: string;
+    /**
+     * Argv-style command for status check. Executed via `execFile` without a
+     * shell — no pipes, redirects, or substitutions. If you need shell
+     * semantics, invoke a script you control: `["/opt/myprobe.sh", "arg"]`.
+     */
+    checkCommand: string[];
+    completionCheck: CompletionCheck;
+    /** Azdo workItem ID (comments on state change) */
+    workItemId?: string;
+    /** Check every Nth heartbeat (default 1 = every time) */
+    checkInterval?: number;
+    /** Timeout duration in hours (default 48) */
+    maxDurationHours?: number;
+    /** Discord notification (default true) */
+    notify?: boolean;
+    metadata?: Record<string, unknown>;
+};
+/** Monitor runtime state */
+export type MonitorState = 'pending' | 'running' | 'completed' | 'failed' | 'timeout';
+/** Runtime monitor (config + state) */
+export type LongRunningMonitor = LongRunningMonitorConfig & {
+    state: MonitorState;
+    registeredAt: number;
+    lastCheckedAt?: number;
+    checkCount: number;
+    heartbeatsSinceRegister: number;
+    lastOutput?: string;
+    lastExitCode?: number;
+};
+/**
+ * Pipeline guards configuration
+ */
+export interface PipelineGuardsConfig {
+    qualityGate: boolean;
+    fakeDataGuard: boolean;
+    conventionalCommits: boolean;
+    branchValidation: boolean;
+    uncertaintyDetection: boolean;
+    haltToAzdo: boolean;
+    registryCheck: boolean;
+    bsDetector: boolean;
+}
+export type AutonomousStartupConfig = {
+    /** Auto-enable on service start */
+    enabled: boolean;
+    /** Use Executor/Reviewer pair mode */
+    pairMode: boolean;
+    /** Execution schedule (cron expression) */
+    schedule: string;
+    /** Pair mode max attempts */
+    maxAttempts: number;
+    /** Allowed project paths */
+    allowedProjects: string[];
+    /** Model configuration (legacy) */
+    models?: ModelConfig;
+    /** Executor timeout (ms), 0 = unlimited (legacy) */
+    executorTimeoutMs?: number;
+    /** Reviewer timeout (ms), 0 = unlimited (legacy) */
+    reviewerTimeoutMs?: number;
+    /** Max concurrent workItems */
+    maxConcurrentWorkItems?: number;
+    /** Default stage configuration */
+    defaultStages?: DefaultStagesConfig;
+    /** Per-project agent configuration */
+    projectAgents?: ProjectAgentConfig[];
+    /** WorkItem decomposition config (Planner Agent) */
+    decomposition?: DecompositionConfig;
+    /** Git worktree mode: work in independent worktree per workItem and auto-create PR */
+    worktreeMode?: boolean;
+    /** WorkItem dispatch backend. Paseo is the Phase 2 default; legacy keeps the in-process pair pipeline. */
+    dispatchBackend?: 'paseo' | 'legacy';
+    /** Paseo CLI dispatch configuration. */
+    paseo?: {
+        cliPath: string;
+        provider: string;
+        mode: string;
+        detached: boolean;
+        useWorktree: boolean;
+        baseBranch?: string;
+        titlePrefix: string;
+        labels: Record<string, string>;
+        env: Record<string, string>;
+    };
+    /** Pipeline guards configuration */
+    guards?: Partial<PipelineGuardsConfig>;
+    /** Daily workItem completion cap (default: 6) */
+    dailyWorkItemCap?: number;
+    /** Cooldown between workItem completions in ms (default: 1800000 = 30min) */
+    interWorkItemCooldownMs?: number;
+    /** Job profiles used to select models based on workItem traits */
+    jobProfiles?: JobProfile[];
+};
+/**
+ * Azure DevOps heartbeat sync configuration
+ */
+export type AzdoSyncConfig = {
+    /** Enable the AzDO sync loop */
+    enabled: boolean;
+    /** AzDO organization name, e.g. 'amsterdamdatalabs' */
+    organization: string;
+    /** AzDO project name, e.g. 'Enact' */
+    project: string;
+    /** Sync interval in ms (default 30000) */
+    intervalMs: number;
+    /** Auth strategy: PAT or az-cli */
+    authStrategy: 'pat' | 'az-cli';
+    /** Env var name containing the PAT (when authStrategy='pat') */
+    patEnvVar?: string;
+    /** Optional WIQL area filter (e.g. 'Enact\\CLI') */
+    areaFilter?: string;
+    /** Custom AzDO field reference-name overrides */
+    fieldNames?: Partial<Record<string, string>>;
+    /** Inbound AzDO System.State -> local status overrides */
+    azdoStateToStatus?: Partial<Record<string, WorkItemRecordStatus>>;
+    /** Outbound local status -> AzDO System.State overrides */
+    statusToAzdoState?: Partial<Record<WorkItemRecordStatus, string>>;
+    /** AzDO states that count as terminal/closed for open-only sync queries */
+    terminalStates?: readonly string[];
+};
+/**
+ * Daily status report scheduler configuration
+ */
+export type DailyReporterConfig = {
+    /** Enable daily status reports */
+    enabled: boolean;
+    /** Cron schedule (default: "0 18 * * *" for 6 PM daily) */
+    schedule: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMlE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,wBAAwB;IACxB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,mBAAmB,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,CAAC;IAC7J,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC,CAAC;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,+CAA+C;IAC/C,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IACvD,6BAA6B;IAC7B,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;QAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,uCAAuC;IACvC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACtC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,yCAAyC;IACzC,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnD,yDAAyD;IACzD,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,KAAK,CAAC;YACd,EAAE,EAAE,MAAM,CAAC;YACX,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC,CAAC;KACJ,CAAC;IACF,uCAAuC;IACvC,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE;YAChB,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;YACjB,uBAAuB,EAAE,OAAO,CAAC;SAClC,CAAC;KACH,CAAC;CACH,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAExH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;KAC3C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,gBAAgB,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AAGH,gCAAgC;AAChC,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,qEAAqE;AACrE,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,4BAA4B;AAC5B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG;IAC1D,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kCAAkC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,sCAAsC;IACtC,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,oDAAoD;IACpD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,sFAAsF;IACtF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0GAA0G;IAC1G,eAAe,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACrC,wCAAwC;IACxC,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC7B,CAAC;IACF,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACvC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kEAAkE;IAClE,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,YAAY,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC/B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAClE,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE,2EAA2E;IAC3E,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/core/types.js

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

package/dist/core/types.js.map

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

package/dist/core/workItemMapper.d.ts

@@ -0,0 +1,39 @@
+import type { WorkItemRecord, OperatorLane } from '../workItems/schema.js';
+import type { EnactFactoryWorkItemState } from '../workItemState/store.js';
+import type { PairSession } from '../agents/agentPair.js';
+import type { PipelineResult } from '../agents/pairPipeline.js';
+import type { PrSidecarState } from '../core/prSidecar.js';
+import type { WorkItemPayload } from '../core/workItemPayload.js';
+import type { WorkItemKind } from '../core/workItemModel.js';
+/**
+ * Map an `WorkItem` + optional runtime sources to the canonical `WorkItemPayload`.
+ *
+ * This is a **pure function**: no I/O, no mutations, no side effects.
+ * All sources are read-only inputs; nothing is written.
+ *
+ * Priority order for execution phase / review state resolution:
+ * 1. `pipelineResult`  — most authoritative (final pipeline outcome)
+ * 2. `pair`            — active pair session (in-progress)
+ * 3. `workItemState`       — persisted workItem execution status
+ * 4. `workItem.status`    — fallback business-state derivation
+ *
+ * @param workItem         - The WorkItem record from the WorkItem store (required).
+ * @param workItemState     - Optional: persisted execution + worktree state.
+ * @param pair          - Optional: active or recently completed PairSession.
+ * @param pipelineResult - Optional: final PipelineResult for the last run.
+ * @param prState       - Optional: PR sidecar state from Wave 3.
+ */
+export declare function recordToWorkItemPayload(workItem: WorkItemRecord, workItemState?: EnactFactoryWorkItemState | null, pair?: PairSession | null, pipelineResult?: PipelineResult | null, prState?: PrSidecarState | null): WorkItemPayload;
+/**
+ * Deterministic mapping of AzDo work-item kind + tags → operator lane hint.
+ *
+ * Derivation rules (Phase 1 consolidation):
+ *  1. kind === 'Bug' | 'Backlog item' → `'ralph'`
+ *  2. All other kinds                 → `undefined` (no hint)
+ *
+ * The returned value is always validated against SCHEDULABLE_LANES; if the
+ * derived lane is not schedulable the function returns undefined. The project
+ * operators allowlist is enforced downstream by pickNextOperator.
+ */
+export declare function deriveOperatorLaneHint(kind: WorkItemKind, _tags: string[]): OperatorLane | undefined;
+//# sourceMappingURL=workItemMapper.d.ts.map

package/dist/core/workItemMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workItemMapper.d.ts","sourceRoot":"","sources":["../../src/core/workItemMapper.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAwB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAA2B,MAAM,0BAA0B,CAAC;AACnG,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,yBAAyB,CAAC;AAuOjF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EACxB,aAAa,CAAC,EAAE,yBAAyB,GAAG,IAAI,EAChD,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,EACzB,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,EACtC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,GAC9B,eAAe,CA0HjB;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,SAAS,CAapG"}