harnery 0.17.0 → 0.19.0

package/src/core/supervisor/plan-types.ts

@@ -1,4 +1,6 @@
 export const SUPERVISOR_PLAN_SCHEMA_VERSION = 1 as const;
+export const MAX_SUPERVISOR_PLAN_REVIEWERS = 5 as const;
+export const MAX_SUPERVISOR_PLAN_REVISION_ROUNDS = 3 as const;
 
 export interface SupervisorPlanTemplate {
   workflow: { path: string; sha256: string };
@@ -13,6 +15,10 @@ export interface SupervisorReplanningPolicy {
   max_work_items_per_plan: number;
   max_total_work_items: number;
   templates: Record<string, SupervisorPlanTemplate>;
+  review?: {
+    reviewer_specialists: string[];
+    max_revision_rounds: number;
+  };
 }
 
 export interface CreateSupervisorPlanTemplateInput {
@@ -28,6 +34,10 @@ export interface CreateSupervisorReplanningInput {
   maxWorkItemsPerPlan?: number;
   maxTotalWorkItems?: number;
   templates: Readonly<Record<string, CreateSupervisorPlanTemplateInput>>;
+  review?: {
+    reviewerSpecialists: readonly string[];
+    maxRevisionRounds: number;
+  };
 }
 
 export interface SupervisorPlanRequest {
@@ -35,12 +45,20 @@ export interface SupervisorPlanRequest {
   id: string;
   goal_id: string;
   sequence: number;
+  trigger?: "initial" | "recovery" | "milestone";
   trigger_fingerprint: string;
   prior_root_work_id: string;
   workflow_run_id: string;
   created_at: string;
 }
 
+export interface SupervisorPlanMilestone {
+  sequence: number;
+  title: string;
+  objective: string;
+  acceptance: string[];
+}
+
 export interface SupervisorPlanWorkSpec {
   key: string;
   title: string;
@@ -53,22 +71,68 @@ export interface SupervisorPlanWorkSpec {
 export interface SupervisorPlanProposal {
   schema_version: typeof SUPERVISOR_PLAN_SCHEMA_VERSION;
   plan_id: string;
-  decision: "apply" | "attention";
+  decision: "apply" | "complete" | "attention";
   rationale: string;
   root: string;
   work: SupervisorPlanWorkSpec[];
+  milestone?: SupervisorPlanMilestone;
   proposed_at: string;
 }
 
 export type SupervisorPlanEventType =
   | "plan.awaiting_approval"
   | "plan.resumed"
+  | "plan.reviewed"
   | "plan.proposed"
   | "plan.applied"
+  | "plan.completed"
   | "plan.rejected"
   | "plan.attention"
   | "plan.failed";
 
+export type SupervisorPlanReviewStatus = "passed" | "revision_exhausted" | "attention" | "failed";
+
+export type SupervisorPlanReviewVerdict = "approve" | "revise" | "attention";
+
+export interface SupervisorPlanReviewFinding {
+  code: string;
+  severity: "blocking" | "advisory";
+  summary: string;
+  recommendation: string;
+}
+
+export interface SupervisorPlanReviewReviewer {
+  specialist: string;
+  verdict: SupervisorPlanReviewVerdict;
+  rationale: string;
+  findings: SupervisorPlanReviewFinding[];
+}
+
+export interface SupervisorPlanReviewRound {
+  round: number;
+  candidate_sha256: string;
+  reviewers: SupervisorPlanReviewReviewer[];
+  outcome: "approved" | "revise" | "attention" | "failed";
+  revision_workflow_run_id?: string;
+}
+
+export interface SupervisorPlanReviewReceipt {
+  schema_version: typeof SUPERVISOR_PLAN_SCHEMA_VERSION;
+  plan_id: string;
+  status: SupervisorPlanReviewStatus;
+  candidate_sha256: string;
+  final_candidate: SupervisorPlanProposal;
+  rounds: SupervisorPlanReviewRound[];
+}
+
+export interface SupervisorPlanReviewSummary {
+  status: SupervisorPlanReviewStatus;
+  candidate_sha256: string;
+  rounds: number;
+  blocking_findings: number;
+  advisory_findings: number;
+}
+
 export interface SupervisorPlanEvent {
   schema_version: typeof SUPERVISOR_PLAN_SCHEMA_VERSION;
   plan_id: string;
@@ -88,6 +152,7 @@ export type SupervisorPlanStatus =
   | "resumable"
   | "proposed"
   | "applied"
+  | "completed"
   | "rejected"
   | "attention"
   | "failed";
@@ -95,6 +160,7 @@ export type SupervisorPlanStatus =
 export interface SupervisorPlanRecord {
   request: SupervisorPlanRequest;
   proposal?: SupervisorPlanProposal;
+  review?: SupervisorPlanReviewSummary;
   events: SupervisorPlanEvent[];
   status: SupervisorPlanStatus;
   approval_id?: string;
@@ -109,6 +175,8 @@ export interface SupervisorPlanHistory {
   generation: number;
   applied_work_ids: string[];
   materialized_work_ids: string[];
+  milestones_completed: number;
+  completed: boolean;
   latest?: SupervisorPlanRecord;
 }