@amsterdamdatalabs/enact-operator 0.1.2

package/dist/lanes/ultrawork/index.d.ts

@@ -0,0 +1,159 @@
+import { type PhaseTransitionEvent, type GateProfile, type GoalScope, type ClosureScope } from '../../operator/operatorRuntimeCore.js';
+import type { PreservedState, RetargetMode } from '../../shared/workflow/activation/modeMatrix.js';
+import type { OperatorReviewItem } from '../../operator/runtime.js';
+import type { UltraworkPhaseContext } from './phases.js';
+export type UltraworkPhase = 'clarify' | 'plan' | 'execute' | 'verify' | 'review' | 'blocked' | 'completed' | 'aborted';
+export type UltraworkRoute = 'direct' | 'deep-interview' | 'plan-only' | 'team-escalated';
+export interface UltraworkEscalation {
+    active: boolean;
+    teamId?: string;
+    reason?: string;
+    escalatedAt?: string;
+}
+export interface UltraworkVerification {
+    phase: UltraworkPhase;
+    evidence: string;
+    recordedAt: string;
+    /** Phase 3: closure scope. Stored independently — never re-derived at read time. */
+    closureScope?: ClosureScope;
+}
+export interface UltraworkRetargetEvent {
+    oldIntent: string;
+    newIntent: string;
+    retargetMode: RetargetMode;
+    preservedState: PreservedState;
+    reason?: string;
+}
+export interface UltraworkHistoryEntry {
+    phase: UltraworkPhase;
+    route?: UltraworkRoute;
+    at: string;
+    by?: string;
+    note?: string;
+    retargetEvent?: UltraworkRetargetEvent;
+}
+export interface UltraworkActivationMetadata {
+    rawMarker?: string;
+    source?: 'hook' | 'cli' | 'mcp';
+    detectedAt?: string;
+    originalGoal?: string;
+    [key: string]: unknown;
+}
+export type UltraworkClosureState = 'none' | 'integration_pending' | 'integration_approved' | 'goal_closed';
+export interface UltraworkChildTask {
+    id: string;
+    intent: string;
+    createdAt: string;
+    status: 'pending' | 'completed' | 'cancelled';
+}
+export interface UltraworkSubagent {
+    id: string;
+    status: 'active' | 'completed' | 'failed' | 'cancelled';
+    startedAt: string;
+    completedAt?: string;
+    summary?: string;
+}
+export interface UltraworkScenario {
+    class: 'happy' | 'edge' | 'regression';
+    description: string;
+    passCondition: string;
+    surfaceArtifact: string;
+}
+export type UltraworkScenarioContract = 'PASS' | 'FAIL';
+export type UltraworkReviewerVerdict = 'UNCONDITIONAL_APPROVE' | 'looks good but requires minor cleanup';
+export interface UltraworkState {
+    schemaVersion: 1;
+    id: string;
+    active: boolean;
+    phase: UltraworkPhase;
+    route: UltraworkRoute;
+    intent: string;
+    sessionId?: string;
+    planId?: string;
+    researchIds: string[];
+    /**
+     * @deprecated Opaque legacy refs only; not mirrored into `state/tasks.json` runtime records.
+     * Prefer `childTasks` for operator-local sub-work.
+     */
+    taskIds: string[];
+    childTasks: UltraworkChildTask[];
+    escalation: UltraworkEscalation;
+    verifications: UltraworkVerification[];
+    blockerReason?: string;
+    abortReason?: string;
+    completionSummary?: string;
+    history: UltraworkHistoryEntry[];
+    activationMetadata?: UltraworkActivationMetadata;
+    createdAt: string;
+    updatedAt: string;
+    /** Phase 3: closure state — parallel to phase, NOT merged into UltraworkPhase union. Default 'none'. */
+    closureState: UltraworkClosureState;
+    goalScope?: GoalScope;
+    gateProfile?: GateProfile;
+    /** Optional operator task ref. */
+    taskId?: string;
+    /** Optional external assignment id from control-plane handoff. */
+    assignmentId?: string;
+    /** Durable subagent run ledger for ultrawork lane visibility. */
+    subagents: UltraworkSubagent[];
+    scenarios?: UltraworkScenario[];
+    scenarioContract?: UltraworkScenarioContract;
+    reviewerGateTriggered?: boolean;
+    reviewerVerdict?: UltraworkReviewerVerdict;
+}
+export declare const ULTRAWORK_TRANSITIONS: Record<UltraworkPhase, UltraworkPhase[]>;
+/** Phase-inference context from ultrawork state only (no tasks.json reads). */
+export declare function buildUltraworkPhaseContext(state: UltraworkState, reviews: OperatorReviewItem[], root?: string): UltraworkPhaseContext;
+export declare function startUltrawork(root: string, opts: {
+    intent: string;
+    sessionId?: string;
+    route?: UltraworkRoute;
+    activationMetadata?: UltraworkActivationMetadata;
+    gateProfile?: GateProfile;
+    goalScope?: GoalScope;
+    /** Operator task id to link at start time. */
+    taskId?: string;
+    /** External assignment id to link at start time. */
+    assignmentId?: string;
+}): UltraworkState;
+export declare function getUltrawork(root: string): UltraworkState | null;
+export declare function routeUltrawork(root: string, route: UltraworkRoute, note?: string): UltraworkState;
+export declare function advanceUltrawork(root: string, opts: {
+    toPhase: UltraworkPhase;
+    note?: string;
+    by?: string;
+    trigger?: PhaseTransitionEvent['trigger'];
+}): UltraworkState;
+export declare function escalateToTeam(root: string, teamId: string, reason: string): UltraworkState;
+export declare function recordUltraworkVerification(root: string, evidence: string, options?: {
+    scenarios?: UltraworkScenario[];
+    reviewerVerdict?: UltraworkReviewerVerdict;
+}): UltraworkState;
+export declare function linkPlan(root: string, planId: string): UltraworkState;
+export declare function linkTaskRef(root: string, taskId: string): UltraworkState;
+export declare function retargetUltrawork(root: string, opts: {
+    intent: string;
+    mode: RetargetMode;
+    goalScope?: GoalScope;
+    gateProfile?: GateProfile;
+    note?: string;
+    by?: string;
+}): UltraworkState;
+export declare function completeUltraworkChildTask(root: string, childTaskId: string, opts?: {
+    by?: string;
+    note?: string;
+}): UltraworkState;
+export declare function cancelUltraworkChildTask(root: string, childTaskId: string, opts?: {
+    by?: string;
+    note?: string;
+}): UltraworkState;
+export declare function linkResearch(root: string, researchId: string): UltraworkState;
+export declare function completeUltrawork(root: string, summary: string): UltraworkState;
+export declare function blockUltrawork(root: string, reason: string): UltraworkState;
+export declare function abortUltrawork(root: string, reason: string): UltraworkState;
+export declare function setUltraworkClosureState(root: string, closureState: UltraworkClosureState, note?: string): UltraworkState;
+export declare function linkUltraworkTask(root: string, taskId: string): UltraworkState;
+export declare function linkUltraworkAssignment(root: string, assignmentId: string): UltraworkState;
+export declare function unlinkUltraworkTask(root: string): UltraworkState;
+export declare function unlinkUltraworkAssignment(root: string): UltraworkState;
+//# sourceMappingURL=index.d.ts.map

package/dist/lanes/ultrawork/index.d.ts.map

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