@osovv/vv-opencode 0.35.23 → 0.35.24

package/dist/plugins/workflow/state.d.ts

@@ -1,17 +1,51 @@
-import type { TrackedAgentName } from "./protocol.js";
-export type WorkItemState = "open" | "awaiting_implementer" | "awaiting_spec_review" | "awaiting_code_review" | "needs_context" | "blocked" | "ready_to_close" | "closed";
+import type { ParsedResultBlock, TrackedAgentName } from "./protocol.js";
+export declare const WORK_ITEM_MODES: readonly ["implementation", "review_only"];
+export type WorkItemMode = (typeof WORK_ITEM_MODES)[number];
+export declare const REVIEWER_ROLES: readonly ["spec", "code"];
+export type ReviewerRole = (typeof REVIEWER_ROLES)[number];
+export type ReviewerAgentName = "vv-spec-reviewer" | "vv-code-reviewer";
+export type ReviewerResultStatus = "PASS" | "FAIL" | "NEEDS_CONTEXT";
+export type ReviewRoundResult = {
+    reviewer: ReviewerRole;
+    agent: ReviewerAgentName;
+    status: ReviewerResultStatus;
+    completedAt: string;
+};
+export type ReviewRound = {
+    round: number;
+    requiredReviewers: ReviewerRole[];
+    pendingReviewers: ReviewerRole[];
+    inFlightReviewers: ReviewerRole[];
+    completedReviewers: ReviewerRole[];
+    results: Partial<Record<ReviewerRole, ReviewRoundResult>>;
+    status: "active" | "completed";
+    createdAt: string;
+    completedAt?: string;
+};
+export type WorkItemState = "open" | "awaiting_implementer" | "awaiting_reviews" | "needs_context" | "blocked" | "ready_to_close" | "closed";
 export type WorkItemRecord = {
     sessionId: string;
     workItemId: string;
     key: string;
     title: string;
+    mode: WorkItemMode;
+    requiredReviewers: ReviewerRole[];
     state: WorkItemState;
+    currentRound?: ReviewRound;
+    completedReviewRoundCount: number;
     specReviewCount: number;
     codeReviewCount: number;
     createdAt: string;
     updatedAt: string;
     closedAt?: string;
 };
+export type OpenWorkItemInput = {
+    sessionId: string;
+    key: string;
+    title: string;
+    mode: WorkItemMode;
+    requiredReviewers: ReviewerRole[];
+};
 export type OpenWorkItemResult = {
     ok: true;
     reused: boolean;
@@ -19,9 +53,9 @@ export type OpenWorkItemResult = {
     header: string;
 } | {
     ok: false;
-    errorCode: "WORK_ITEM_KEY_CONFLICT";
+    errorCode: "INVALID_INPUT" | "WORK_ITEM_KEY_CONFLICT";
     message: string;
-    existingWorkItemId: string;
+    existingWorkItemId?: string;
 };
 export type CloseWorkItemResult = {
     ok: true;
@@ -29,15 +63,31 @@ export type CloseWorkItemResult = {
     header: string;
 } | {
     ok: false;
-    errorCode: "WORK_ITEM_NOT_FOUND" | "WORK_ITEM_ALREADY_CLOSED";
+    errorCode: "WORK_ITEM_NOT_FOUND" | "WORK_ITEM_ALREADY_CLOSED" | "READY_TO_CLOSE_REQUIRED";
+    message: string;
+};
+export type LaunchWorkItemErrorCode = "WORK_ITEM_NOT_FOUND" | "WORK_ITEM_ALREADY_CLOSED" | "INVALID_NEXT_AGENT" | "REVIEW_ROUND_NOT_ACTIVE" | "REVIEWER_NOT_REQUIRED" | "REVIEWER_ALREADY_IN_FLIGHT" | "REVIEWER_ALREADY_COMPLETED" | "REVIEW_ROUND_NEEDS_CONTEXT";
+export type BeginTrackedLaunchResult = {
+    ok: true;
+    record: WorkItemRecord;
+    reviewer?: ReviewerRole;
+    reviewRound: number;
+} | {
+    ok: false;
+    errorCode: LaunchWorkItemErrorCode;
     message: string;
+    allowedAgents: TrackedAgentName[];
 };
-export type TransitionWorkItemStateResult = {
+export type TrackedResultStateErrorCode = "WORK_ITEM_NOT_FOUND" | "WORK_ITEM_ALREADY_CLOSED" | "INVALID_RESULT_AGENT" | "REVIEW_ROUND_NOT_ACTIVE" | "REVIEWER_NOT_REQUIRED" | "REVIEWER_NOT_IN_FLIGHT" | "REVIEWER_ALREADY_COMPLETED";
+export type ApplyTrackedResultResult = {
     ok: true;
     record: WorkItemRecord;
+    fromState: WorkItemState;
+    toState: WorkItemState;
+    aggregateComplete: boolean;
 } | {
     ok: false;
-    errorCode: "WORK_ITEM_NOT_FOUND" | "WORK_ITEM_ALREADY_CLOSED" | "INVALID_STATE_TRANSITION" | "MISSING_TRANSITION_ACTOR";
+    errorCode: TrackedResultStateErrorCode;
     message: string;
 };
 export type WorkItemStoreData = {
@@ -46,41 +96,41 @@ export type WorkItemStoreData = {
     keyIndexBySession: Map<string, Map<string, string>>;
 };
 export type WorkItemStore = {
-    openWorkItem: (input: {
+    openWorkItem: (input: OpenWorkItemInput) => OpenWorkItemResult;
+    beginTrackedLaunch: (input: {
         sessionId: string;
-        key: string;
-        title: string;
-    }) => OpenWorkItemResult;
+        workItemId: string;
+        agent: TrackedAgentName;
+    }) => BeginTrackedLaunchResult;
+    applyTrackedResult: (input: {
+        sessionId: string;
+        workItemId: string;
+        result: ParsedResultBlock;
+    }) => ApplyTrackedResultResult;
     getWorkItem: (sessionId: string, workItemId: string) => WorkItemRecord | undefined;
     listWorkItems: (sessionId: string, options?: {
         includeClosed?: boolean;
     }) => WorkItemRecord[];
     closeWorkItem: (sessionId: string, workItemId: string) => CloseWorkItemResult;
-    transitionWorkItemState: (input: {
-        sessionId: string;
-        workItemId: string;
-        state: WorkItemState;
-        actor?: TrackedAgentName;
-    }) => TransitionWorkItemStateResult;
-    getReviewRound: (record: Pick<WorkItemRecord, "specReviewCount" | "codeReviewCount">) => number;
+    getReviewRound: (record: Pick<WorkItemRecord, "completedReviewRoundCount" | "currentRound">) => number;
     /** Expose internal store data for persistence snapshotting. */
     getStoreData: () => WorkItemStoreData;
 };
-export declare function getReviewRound(record: Pick<WorkItemRecord, "specReviewCount" | "codeReviewCount">): number;
+export declare function getReviewRound(record: Pick<WorkItemRecord, "completedReviewRoundCount" | "currentRound">): number;
 export declare function createWorkItemStore(hydrateData?: WorkItemStoreData | null): WorkItemStore;
-export declare function openWorkItem(store: WorkItemStore, input: {
+export declare function openWorkItem(store: WorkItemStore, input: OpenWorkItemInput): OpenWorkItemResult;
+export declare function beginTrackedLaunch(store: WorkItemStore, input: {
     sessionId: string;
-    key: string;
-    title: string;
-}): OpenWorkItemResult;
+    workItemId: string;
+    agent: TrackedAgentName;
+}): BeginTrackedLaunchResult;
+export declare function applyTrackedResult(store: WorkItemStore, input: {
+    sessionId: string;
+    workItemId: string;
+    result: ParsedResultBlock;
+}): ApplyTrackedResultResult;
 export declare function getWorkItem(store: WorkItemStore, sessionId: string, workItemId: string): WorkItemRecord | undefined;
 export declare function listWorkItems(store: WorkItemStore, sessionId: string, options?: {
     includeClosed?: boolean;
 }): WorkItemRecord[];
 export declare function closeWorkItem(store: WorkItemStore, sessionId: string, workItemId: string): CloseWorkItemResult;
-export declare function transitionWorkItemState(store: WorkItemStore, input: {
-    sessionId: string;
-    workItemId: string;
-    state: WorkItemState;
-    actor?: TrackedAgentName;
-}): TransitionWorkItemStateResult;