pi-harness-runtime 0.10.5 → 0.10.7

package/packages/write-review/src/types.ts

@@ -0,0 +1,88 @@
+/**
+ * Write-Review Loop Types
+ *
+ * State machine for two-agent write-review coordination.
+ */
+
+/**
+ * Review phases
+ */
+export type ReviewPhase =
+  | "idle"
+  | "writing"
+  | "pending_review"
+  | "reviewing"
+  | "approved"
+  | "blocked"
+  | "changes_requested";
+
+/**
+ * Review verdict
+ */
+export type Verdict = "approved" | "changes_requested" | "blocked";
+
+/**
+ * Blackboard status record
+ */
+export interface WriteReviewStatus {
+  projectPath: string;
+  phase: ReviewPhase;
+  writerDone: boolean;
+  writerMessage?: string;
+  iteration: number;
+  verdict?: Verdict;
+  verdictMessage?: string;
+  reviewerStarted?: string;  // ISO timestamp
+  codeFiles?: string[];     // Files written
+  changesRequested?: string[];  // Changes needed
+  approvedAt?: string;     // ISO timestamp
+  blockedAt?: string;      // ISO timestamp
+  updatedAt: string;
+  createdAt: string;
+}
+
+/**
+ * Review trigger context
+ */
+export interface ReviewTriggerContext {
+  projectPath: string;
+  promptFile: string;
+  promptContent: string;
+  triggerType: "wiki_read" | "manual" | "code_written";
+}
+
+/**
+ * Extension config
+ */
+export interface WriteReviewConfig {
+  debug?: boolean;
+  blackboardDir?: string;  // Default: "{project}/.write-review"
+  wikiDir?: string;        // Default: "{project}/wiki"
+  enabled?: boolean;
+}
+
+/**
+ * Agent roles
+ */
+export const AGENT_ROLES = {
+  WRITER: "writer",      // Minimax - reads wiki, writes code
+  REVIEWER: "reviewer",  // Uses pi-subagents review-loop
+  HELPER: "helper",     // worker - notes tasks to todo
+} as const;
+
+export type AgentRole = typeof AGENT_ROLES[keyof typeof AGENT_ROLES];
+
+/**
+ * State transition helpers
+ */
+export function isTerminalPhase(phase: ReviewPhase): boolean {
+  return phase === "approved" || phase === "blocked";
+}
+
+export function needsReview(phase: ReviewPhase): boolean {
+  return phase === "pending_review" || phase === "reviewing";
+}
+
+export function canWrite(phase: ReviewPhase): boolean {
+  return phase === "idle" || phase === "writing" || phase === "changes_requested";
+}