codex-workflow-v2 2.0.0-alpha.1

package/dist/src/workflow.d.ts

@@ -0,0 +1,93 @@
+import { type ContextEnvelope, type DiscoveryState, type MilestonePlanInput, type MilestoneState, type KnowledgeSelection, type GraphBinding, type GraphKind, type GraphMode, type GraphRefreshEvidence, type GraphRefreshRequest, type ProjectKnowledgeMap, type ReviewInput, type TaskPlanInput, type TaskState, type WriterLease, type WorkflowRole, type WorkspaceOwner } from './contracts.js';
+import { type RepositoryIdentity } from './repository.js';
+import { WriterLockManager } from './state/lock.js';
+import { FileStateStore } from './state/store.js';
+export interface DiscoveryInput {
+    goal: string;
+    outcome?: string;
+    facts?: string[];
+    decisions?: string[];
+    assumptions?: string[];
+    unknowns?: string[];
+    blockingUnknowns?: string[];
+    scope?: string[];
+    outOfScope?: string[];
+    constraints?: string[];
+    acceptance?: string[];
+}
+export interface DiscoveryPatch extends Omit<DiscoveryInput, 'goal'> {
+    goal?: string;
+    resolveUnknowns?: string[];
+}
+export interface WorkflowContext {
+    identity: RepositoryIdentity;
+    store: FileStateStore;
+    locks: WriterLockManager;
+}
+export declare class WorkflowService {
+    readonly store: FileStateStore;
+    private readonly now;
+    constructor(store?: FileStateStore, now?: () => Date);
+    context(repository: string): WorkflowContext;
+    startDiscovery(repository: string, input: DiscoveryInput): DiscoveryState;
+    updateDiscovery(repository: string, discoveryId: string, expectedRevision: number, patch: DiscoveryPatch): DiscoveryState;
+    materializeTask(repository: string, discoveryId: string, expectedRevision: number, title: string, baseBranch?: string, milestoneId?: string | null): {
+        discovery: DiscoveryState;
+        task: TaskState;
+        taskRoot: string;
+    };
+    materializeMilestone(repository: string, discoveryId: string, expectedRevision: number, title: string, baseBranch?: string): {
+        discovery: DiscoveryState;
+        milestone: MilestoneState;
+        milestoneRoot: string;
+    };
+    setMilestonePlan(repository: string, milestoneId: string, expectedRevision: number, plan: MilestonePlanInput): MilestoneState;
+    authorizeMilestone(repository: string, milestoneId: string, expectedRevision: number, actor: string, reason?: string): MilestoneState;
+    validateMilestone(repository: string, milestoneId: string, expectedRevision: number): MilestoneState;
+    acceptMilestone(repository: string, milestoneId: string, expectedRevision: number, actor: string): MilestoneState;
+    cancelMilestone(repository: string, milestoneId: string, expectedRevision: number, reason: string): MilestoneState;
+    setTaskPlan(repository: string, taskId: string, expectedRevision: number, plan: TaskPlanInput): TaskState;
+    authorizeTask(repository: string, taskId: string, expectedRevision: number, actor: string, reason?: string): TaskState;
+    startTask(repository: string, taskId: string, expectedRevision: number, workspaceOwner: WorkspaceOwner): TaskState;
+    runStep(repository: string, taskId: string, stepId: string, expectedRevision: number, owner: string, writerToken: string | null): {
+        task: TaskState;
+        lease: WriterLease;
+        envelope: ContextEnvelope;
+    };
+    taskContext(repository: string, taskId: string, role: Exclude<WorkflowRole, 'scope-lead' | 'worker'>): ContextEnvelope;
+    completeStep(repository: string, taskId: string, stepId: string, expectedRevision: number, writerToken: string, notes: string[]): TaskState;
+    submitTask(repository: string, taskId: string, expectedRevision: number, writerToken: string): TaskState;
+    recordReview(repository: string, taskId: string, expectedRevision: number, review: ReviewInput): TaskState;
+    setTaskResult(repository: string, taskId: string, expectedRevision: number, summary: string, limitations: string[]): TaskState;
+    acceptTask(repository: string, taskId: string, expectedRevision: number, actor: string): TaskState;
+    syncTaskBase(repository: string, taskId: string, expectedRevision: number): TaskState;
+    mergeTask(repository: string, taskId: string, expectedRevision: number, writerToken: string): TaskState;
+    confirmExternalMerge(repository: string, taskId: string, expectedRevision: number, writerToken: string): TaskState;
+    status(repository: string): {
+        projectId: string;
+        discoveries: DiscoveryState[];
+        tasks: TaskState[];
+        milestones: MilestoneState[];
+    };
+    scanKnowledgeMap(repository: string): ProjectKnowledgeMap;
+    showKnowledgeMap(repository: string): ProjectKnowledgeMap;
+    knowledgeMapStatus(repository: string): ProjectKnowledgeMap;
+    approveKnowledgeMap(repository: string, expectedRevision: number, selections: KnowledgeSelection[], actor: string): ProjectKnowledgeMap;
+    reconcileKnowledgeMap(repository: string, expectedRevision: number): ProjectKnowledgeMap;
+    graphRefreshRequest(repository: string, graphKind: GraphKind, mode?: GraphMode): GraphRefreshRequest;
+    graphStatus(repository: string, graphKind: GraphKind, mode?: GraphMode): {
+        request: GraphRefreshRequest;
+        binding: GraphBinding | null;
+    };
+    bindGraph(repository: string, expectedRevision: number | null, request: GraphRefreshRequest, evidence: GraphRefreshEvidence): GraphBinding;
+    recordGraphFallback(repository: string, graphKind: GraphKind, mode: GraphMode, expectedRevision: number | null, reason: string): GraphBinding;
+    next(repository: string): Record<string, unknown>;
+    private assertExecutionAuthorizationFresh;
+    private assertMilestoneAuthorizationFresh;
+    private readGraphBindingOrNull;
+    private requireActiveKnowledgeMap;
+    private assertKnowledgeMapBinding;
+    private assertTaskKnowledgeBinding;
+    private validateKnowledgeTargets;
+    private assertReviewFresh;
+}