@almightygpt/core 0.9.2 → 0.10.0

package/dist/plan/run-plan.js.map

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

package/dist/runs/types.d.ts

@@ -9,7 +9,7 @@
  *   - audit what was sent to which provider,
  *   - drive the future VS Code / dashboard / CLI history views.
  */
-export type RunType = "review-diff" | "review-path" | "review-requirement" | "review-worker-reviewer";
+export type RunType = "review-diff" | "review-path" | "review-requirement" | "review-worker-reviewer" | "plan" | "review-plan";
 export type RunStatus = "running" | "completed" | "failed" | "aborted_budget";
 export interface AgentMetrics {
     agent: string;

package/dist/runs/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almightygpt/core",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "Core orchestrator, adapters, config, runs, and review logic for AlmightyGPT",
   "license": "MIT",
   "type": "module",

package/src/adapters/factory.ts

@@ -0,0 +1,45 @@
+/**
+ * Adapter factory — single place to map (name, provider) → concrete
+ * Adapter instance.
+ *
+ * Extracted from review/run-diff-review.ts during v0.10.0 (plan
+ * module) so the plan + review pipelines share the same factory and
+ * a new adapter only needs to be wired in one place.
+ */
+
+import { type Adapter } from "./types.js";
+import { MockAdapter } from "./mock.js";
+import { OpenAIAdapter } from "./openai.js";
+import { ClaudeAdapter } from "./claude.js";
+import { GeminiAdapter } from "./gemini.js";
+
+export function makeAdapter(name: string, provider: string): Adapter {
+  switch (provider) {
+    case "openai":
+      return new OpenAIAdapter(name);
+    case "anthropic":
+      return new ClaudeAdapter(name);
+    case "google":
+      return new GeminiAdapter(name);
+    case "mock":
+      return new MockAdapter();
+    default:
+      throw new Error(
+        `Provider "${provider}" not supported. ` +
+          `Use "openai", "anthropic", "google", or "mock".`,
+      );
+  }
+}
+
+export function envHintForProvider(provider: string): string {
+  switch (provider) {
+    case "openai":
+      return "Export OPENAI_API_KEY in your environment.";
+    case "anthropic":
+      return "Export ANTHROPIC_API_KEY in your environment.";
+    case "google":
+      return "Export GOOGLE_API_KEY (or GEMINI_API_KEY) in your environment.";
+    default:
+      return "";
+  }
+}

package/src/index.ts

@@ -13,7 +13,7 @@
  *   - budget/     ✅ task #14 BudgetTracker + BudgetExceededError
  */
 
-export const VERSION = "0.9.2";
+export const VERSION = "0.10.0";
 
 // MCP server (v0.9.0+) — exposes AlmightyGPT's review surface as MCP tools.
 export { startMcpServer } from "./mcp/server.js";
@@ -143,6 +143,18 @@ export {
   type KeychainAdapter,
 } from "./auth/keychain.js";
 export { validateKey, type ValidationResult } from "./auth/validator.js";
+// Plan subsystem (v0.10.0+) — Worker plan + Reviewer plan-review
+export {
+  runWorkerPlan,
+  type PlanOptions,
+  type PlanResult,
+} from "./plan/run-plan.js";
+export {
+  runPlanReview,
+  type PlanReviewOptions,
+  type PlanReviewResult,
+} from "./plan/run-plan-review.js";
+
 export {
   AuthMissingError,
   PROVIDER_ENV_VARS,

package/src/plan/run-plan-review.ts

@@ -0,0 +1,302 @@
+/**
+ * `almightygpt review --plan <file>` — Reviewer AI critiques a PLAN
+ * doc (not a git diff). Same review primitives as runDiffReview but
+ * the input is the plan markdown and the framing tells the Reviewer
+ * to critique the plan's structure, completeness, and risks rather
+ * than line-by-line code.
+ *
+ * Output lands at `<reviewsDir>/plan-<topic>.md` (prefix distinguishes
+ * plan reviews from diff reviews when they share the same topic name).
+ */
+
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { loadConfig } from "../config/load.js";
+import { makeAdapter } from "../adapters/factory.js";
+import { AdapterError } from "../adapters/types.js";
+import { assembleMemory } from "../review/memory.js";
+import {
+  createRunFolder,
+  writeRunMetadata,
+  writeRunInput,
+  writeAgentOutput,
+  collectGitContext,
+} from "../runs/folder.js";
+import {
+  writeHumanReviewFile,
+  preflightReviewFileCollision,
+} from "../review/write.js";
+
+export interface PlanReviewOptions {
+  repoRoot: string;
+  topic: string;
+  /** Path (relative to repoRoot) to the plan markdown to review. */
+  planPath: string;
+  reviewer?: string;
+  force?: boolean;
+}
+
+export interface PlanReviewResult {
+  reviewPath: string;
+  reviewBytes: number;
+  reviewer: string;
+  provider: string;
+  modelUsed: string;
+  tokensIn: number;
+  cachedTokensIn: number;
+  tokensOut: number;
+  costUsd: number;
+  latencyMs: number;
+  memorySources: { path: string; bytes: number }[];
+  memoryMissing: string[];
+  runId: string;
+  runFolder: string;
+  shallowWarning?: string;
+}
+
+const PLAN_REVIEW_SYSTEM_FRAMING = [
+  "You are the Reviewer AI in an AlmightyGPT Plan-review stage.",
+  "",
+  "WHAT YOU ARE REVIEWING: the PLAN markdown supplied below. NOT a git",
+  "diff and NOT code — a plan that a Worker AI drafted in response to a",
+  "human's requirement. The plan has not been implemented yet. Your job",
+  "is to find what's WRONG with the plan: missing steps, hidden",
+  "dependencies, risks the Worker didn't surface, ambiguous decisions,",
+  "things that will break in production, edge cases the test plan misses.",
+  "",
+  "WHAT THE ORCHESTRATOR OWNS (do NOT include these in your response):",
+  "  - The H1 title (orchestrator prepends `# Plan Review: <topic>`).",
+  "  - The header block with model / tokens / cost.",
+  "  - The `## Cost and Latency` and `## Appendix: Raw Outputs` sections.",
+  "",
+  "WHAT YOU MUST PRODUCE — start with `## Decision Required` and emit",
+  "ONLY these sections in this order:",
+  "  ## Decision Required",
+  "  ## Highest-Risk Findings",
+  "  ## Concrete Weaknesses",
+  "  ## Worker Plan Summary",
+  "  ## Test Plan",
+  "  ## Human Decision",
+  "",
+  "ANTI-SYCOPHANCY (non-negotiable):",
+  "  - Find at least 3 concrete weaknesses with specific file / step / line",
+  "    references from the plan.",
+  "  - A finding without a specific anchor is too vague.",
+  "  - 'Looks good, minor suggestions' is a FAILED review — recalibrate.",
+  "",
+  "REVIEW LENS — focus on what plans commonly get wrong:",
+  "  - Steps assume capabilities that don't exist yet",
+  "  - Risks section underweights production blast radius",
+  "  - Test plan is generic ('add tests') instead of named cases",
+  "  - Open questions are missing things the human will actually need to",
+  "    decide before implementation",
+  "  - Affected modules list is incomplete (the plan touches more surfaces",
+  "    than it admits)",
+  "  - Migration / rollback story is missing or hand-wavy",
+].join("\n");
+
+function buildPlanReviewUserMessage(
+  topic: string,
+  planContent: string,
+): string {
+  return [
+    `# Plan-review request — topic: \`${topic}\``,
+    "",
+    "## The plan to review",
+    "",
+    "```markdown",
+    planContent.trim(),
+    "```",
+    "",
+    "## Your task",
+    "",
+    "Critique the plan above using the structure in your system prompt.",
+    "Start your response with `## Decision Required` (no H1, no preamble).",
+  ].join("\n");
+}
+
+export async function runPlanReview(
+  opts: PlanReviewOptions,
+): Promise<PlanReviewResult> {
+  const config = await loadConfig(opts.repoRoot);
+
+  const reviewerName = opts.reviewer ?? config.defaults.reviewer;
+  if (!reviewerName) {
+    throw new Error(
+      "No reviewer specified. Pass --reviewer <name> or set defaults.reviewer in .almightygpt/config.yaml.",
+    );
+  }
+  const agentConfig = config.agents[reviewerName];
+  if (!agentConfig) {
+    throw new Error(
+      `Reviewer "${reviewerName}" not found in .almightygpt/config.yaml agents map.`,
+    );
+  }
+  if (!agentConfig.enabled) {
+    throw new Error(`Reviewer "${reviewerName}" is disabled in .almightygpt/config.yaml.`);
+  }
+
+  const adapter = makeAdapter(reviewerName, agentConfig.provider);
+  if (!(await adapter.isAvailable())) {
+    throw new AdapterError(
+      `Adapter "${reviewerName}" (${agentConfig.provider}) is not available. Set the provider's API key.`,
+      reviewerName,
+    );
+  }
+
+  // Plan reviews land at <reviewsDir>/plan-<topic>.md so they don't
+  // collide with diff reviews on the same topic.
+  const planReviewTopic = `plan-${opts.topic}`;
+  await preflightReviewFileCollision(
+    opts.repoRoot,
+    config.reviewsDir,
+    planReviewTopic,
+    opts.force ?? false,
+  );
+
+  // Load the plan to review.
+  let planContent: string;
+  try {
+    planContent = await readFile(join(opts.repoRoot, opts.planPath), "utf8");
+  } catch (err) {
+    throw new Error(
+      `Could not read plan file at ${opts.planPath}: ${err instanceof Error ? err.message : String(err)}`,
+    );
+  }
+
+  const runFolder = await createRunFolder({
+    repoRoot: opts.repoRoot,
+    runsDir: config.runsDir,
+    topic: planReviewTopic,
+    type: "review-plan",
+  });
+  const createdAt = new Date().toISOString();
+
+  const memory = await assembleMemory(opts.repoRoot, agentConfig.memoryFile);
+  const systemPrompt = PLAN_REVIEW_SYSTEM_FRAMING + "\n\n" + memory.text;
+  const userMessage = buildPlanReviewUserMessage(opts.topic, planContent);
+
+  await writeRunInput(runFolder.absPath, userMessage);
+
+  const adapterOut = await adapter.execute({
+    role: "reviewer",
+    systemPrompt,
+    userMessage,
+  });
+
+  await writeAgentOutput(runFolder.absPath, "reviewer", adapterOut.content);
+
+  // Shallow detection: same rule as diff reviews — need N concrete
+  // weaknesses with anchors.
+  const shallowWarning = detectShallowPlanReview(
+    adapterOut.content,
+    config.review.requireConcreteWeaknesses,
+  );
+
+  const writeOpts: Parameters<typeof writeHumanReviewFile>[0] = {
+    repoRoot: opts.repoRoot,
+    reviewsDir: config.reviewsDir,
+    topic: planReviewTopic,
+    reviewerName,
+    reviewerProvider: adapter.provider,
+    modelUsed: adapterOut.modelUsed,
+    body: adapterOut.content,
+    metrics: {
+      tokensIn: adapterOut.tokensIn,
+      tokensOut: adapterOut.tokensOut,
+      costUsd: adapterOut.costUsd,
+      latencyMs: adapterOut.latencyMs,
+    },
+    runFolder: runFolder.relPath,
+  };
+  if (shallowWarning) writeOpts.shallowWarning = shallowWarning;
+  if (opts.force) writeOpts.force = opts.force;
+  const written = await writeHumanReviewFile(writeOpts);
+
+  const git = await collectGitContext(opts.repoRoot);
+  await writeRunMetadata(runFolder.absPath, {
+    id: runFolder.id,
+    type: "review-plan",
+    createdAt,
+    finishedAt: new Date().toISOString(),
+    workspacePath: opts.repoRoot,
+    topic: planReviewTopic,
+    git,
+    input: { source: "requirement-file", path: opts.planPath },
+    agents: [
+      {
+        name: reviewerName,
+        role: "reviewer",
+        provider: agentConfig.provider,
+        enabled: true,
+      },
+    ],
+    adapterVersions: [],
+    status: "completed",
+    metrics: [
+      {
+        agent: reviewerName,
+        role: "reviewer",
+        provider: adapter.provider,
+        model: adapterOut.modelUsed,
+        tokensIn: adapterOut.tokensIn,
+        cachedTokensIn: adapterOut.cachedTokensIn ?? 0,
+        tokensOut: adapterOut.tokensOut,
+        costUsd: adapterOut.costUsd,
+        latencyMs: adapterOut.latencyMs,
+      },
+    ],
+    totals: {
+      tokensIn: adapterOut.tokensIn,
+      tokensOut: adapterOut.tokensOut,
+      costUsd: adapterOut.costUsd,
+      latencyMs: adapterOut.latencyMs,
+    },
+    reviewPath: written.path,
+    budget: {
+      maxCostPerRunUsd: config.budget.maxCostPerRunUsd,
+      maxTokensPerRun: config.budget.maxTokensPerRun,
+    },
+  });
+
+  const result: PlanReviewResult = {
+    reviewPath: written.path,
+    reviewBytes: written.bytes,
+    reviewer: reviewerName,
+    provider: adapter.provider,
+    modelUsed: adapterOut.modelUsed,
+    tokensIn: adapterOut.tokensIn,
+    cachedTokensIn: adapterOut.cachedTokensIn ?? 0,
+    tokensOut: adapterOut.tokensOut,
+    costUsd: adapterOut.costUsd,
+    latencyMs: adapterOut.latencyMs,
+    memorySources: memory.sources,
+    memoryMissing: memory.missing,
+    runId: runFolder.id,
+    runFolder: runFolder.relPath,
+  };
+  if (shallowWarning) result.shallowWarning = shallowWarning;
+  return result;
+}
+
+/** Same shallow heuristic as diff reviews — count file/step/line anchors. */
+function detectShallowPlanReview(
+  content: string,
+  requireConcreteWeaknesses: number,
+): string | undefined {
+  const anchorPattern = /\b(?:file|step|line|section)[:\s][\w\-./]+/gi;
+  const anchors = content.match(anchorPattern) ?? [];
+  const weaknessesSection = content.match(
+    /## Concrete Weaknesses([\s\S]*?)(?=##|$)/i,
+  );
+  const weaknessBullets =
+    weaknessesSection?.[1]?.match(/^\s*[-*\d.]/gm)?.length ?? 0;
+
+  if (anchors.length === 0) {
+    return "Plan review has zero anchored references (file / step / line). The Reviewer may not have engaged with specifics — consider re-running.";
+  }
+  if (weaknessBullets < requireConcreteWeaknesses) {
+    return `Plan review listed ${weaknessBullets} concrete weaknesses, fewer than the configured minimum of ${requireConcreteWeaknesses}. Output may be shallow — consider re-running with a more rigorous Reviewer.`;
+  }
+  return undefined;
+}

package/src/plan/run-plan.ts

@@ -0,0 +1,247 @@
+/**
+ * `almightygpt plan` — Worker AI reads a free-text requirement +
+ * project memory, produces a structured plan markdown.
+ *
+ * Distinct from the review pipeline because the INPUT is a
+ * requirement (a sentence or paragraph from the user describing
+ * what they want), not a git diff. Output is a plan doc with
+ * required sections — same shape on every run so the Reviewer
+ * downstream knows what to expect.
+ *
+ * Plans land at `docs/<worker>-plans/<topic>.md`. The Reviewer step
+ * then runs against this plan via the `review --plan <file>` mode
+ * (see run-plan-review.ts).
+ */
+
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { loadConfig } from "../config/load.js";
+import { makeAdapter } from "../adapters/factory.js";
+import { AdapterError } from "../adapters/types.js";
+import { assembleMemory } from "../review/memory.js";
+import {
+  createRunFolder,
+  writeRunMetadata,
+  writeRunInput,
+  writeAgentOutput,
+  collectGitContext,
+} from "../runs/folder.js";
+import { assertSafeToWrite } from "../git/status.js";
+
+export interface PlanOptions {
+  repoRoot: string;
+  topic: string;
+  requirement: string;
+  worker?: string;
+  force?: boolean;
+}
+
+export interface PlanResult {
+  planPath: string;
+  planBytes: number;
+  worker: string;
+  provider: string;
+  modelUsed: string;
+  tokensIn: number;
+  cachedTokensIn: number;
+  tokensOut: number;
+  costUsd: number;
+  latencyMs: number;
+  memorySources: { path: string; bytes: number }[];
+  memoryMissing: string[];
+  runId: string;
+  runFolder: string;
+}
+
+const PLAN_SYSTEM_FRAMING = [
+  "You are the Worker AI in an AlmightyGPT Plan stage.",
+  "",
+  "WHAT YOU ARE DOING: turning a free-text requirement (the user message",
+  "below) into a structured plan markdown that a Reviewer AI will then",
+  "critique. You are NOT writing code — only the plan. The human will",
+  "approve / reject / refine the plan, and only then will implementation",
+  "happen (in a separate tool).",
+  "",
+  "WHAT THE ORCHESTRATOR OWNS (do NOT include these in your response):",
+  "  - The H1 title (the orchestrator prepends `# Plan: <topic>`).",
+  "  - The header block with model / tokens / cost.",
+  "",
+  "WHAT YOU MUST PRODUCE — emit exactly these sections in this order:",
+  "  ## Goal",
+  "  ## Affected modules / surfaces",
+  "  ## Step-by-step approach",
+  "  ## Risks",
+  "  ## Test plan",
+  "  ## Open questions",
+  "",
+  "STYLE:",
+  "  - Be concrete. Name specific files, classes, functions, env vars.",
+  "  - Write so the Reviewer can find concrete things to critique.",
+  "  - Open questions are not a weakness; they're the things you'd ask",
+  "    the human if you could. Surface them.",
+].join("\n");
+
+function buildPlanUserMessage(topic: string, requirement: string): string {
+  return [
+    `# Plan request — topic: \`${topic}\``,
+    "",
+    "## Requirement (from human)",
+    "",
+    requirement.trim(),
+    "",
+    "## Your task",
+    "",
+    "Produce the plan markdown using the structure in your system prompt.",
+    "Start your response with `## Goal` (no H1, no preamble).",
+  ].join("\n");
+}
+
+export async function runWorkerPlan(opts: PlanOptions): Promise<PlanResult> {
+  const config = await loadConfig(opts.repoRoot);
+
+  const workerName = opts.worker ?? config.defaults.worker;
+  if (!workerName) {
+    throw new Error(
+      "No worker specified. Pass --worker <name> or set defaults.worker in .almightygpt/config.yaml.",
+    );
+  }
+  const agentConfig = config.agents[workerName];
+  if (!agentConfig) {
+    throw new Error(
+      `Worker "${workerName}" not found in .almightygpt/config.yaml agents map.`,
+    );
+  }
+  if (!agentConfig.enabled) {
+    throw new Error(`Worker "${workerName}" is disabled in .almightygpt/config.yaml.`);
+  }
+
+  const adapter = makeAdapter(workerName, agentConfig.provider);
+  if (!(await adapter.isAvailable())) {
+    throw new AdapterError(
+      `Adapter "${workerName}" (${agentConfig.provider}) is not available. Set the provider's API key.`,
+      workerName,
+    );
+  }
+
+  // Plans land at docs/<worker>-plans/<topic>.md — symmetric with reviews.
+  const plansDir = `docs/${workerName}-plans`;
+  const planRel = `${plansDir}/${opts.topic}.md`;
+  await assertSafeToWrite(opts.repoRoot, planRel, opts.force ?? false);
+
+  const runFolder = await createRunFolder({
+    repoRoot: opts.repoRoot,
+    runsDir: config.runsDir,
+    topic: opts.topic,
+    type: "plan",
+  });
+  const createdAt = new Date().toISOString();
+
+  const memory = await assembleMemory(opts.repoRoot, agentConfig.memoryFile);
+  const systemPrompt = PLAN_SYSTEM_FRAMING + "\n\n" + memory.text;
+  const userMessage = buildPlanUserMessage(opts.topic, opts.requirement);
+
+  await writeRunInput(runFolder.absPath, userMessage);
+
+  const adapterOut = await adapter.execute({
+    role: "worker",
+    systemPrompt,
+    userMessage,
+  });
+
+  await writeAgentOutput(runFolder.absPath, "worker", adapterOut.content);
+
+  // Compose the final plan file: orchestrator-owned header + worker body.
+  const header = [
+    `# Plan: ${opts.topic}`,
+    "",
+    `> Worker: \`${workerName}\` (${adapter.provider}, ${adapterOut.modelUsed})`,
+    `> Generated: ${new Date().toISOString()}`,
+    `> Tokens: ${adapterOut.tokensIn} in / ${adapterOut.tokensOut} out`,
+    `> Cost: $${adapterOut.costUsd.toFixed(4)} USD`,
+    `> Run folder: \`${runFolder.relPath}\``,
+    "",
+  ].join("\n");
+
+  const footer = [
+    "",
+    "---",
+    "",
+    "## How this plan was produced",
+    "",
+    `The AlmightyGPT Plan stage produced this. Worker (\`${workerName}\`)`,
+    `read the requirement above + the project's memory files.`,
+    "",
+    "**Next stage:** cross-AI review with `almightygpt review --plan",
+    `${planRel} --reviewer codex --topic ${opts.topic}\` (Reviewer critiques`,
+    "this plan), then human approval, then implementation in your",
+    "preferred coding tool.",
+  ].join("\n");
+
+  const planContent = header + adapterOut.content.trim() + footer;
+  const planAbs = join(opts.repoRoot, planRel);
+  await mkdir(dirname(planAbs), { recursive: true });
+  await writeFile(planAbs, planContent, "utf8");
+
+  const gitContext = await collectGitContext(opts.repoRoot);
+  await writeRunMetadata(runFolder.absPath, {
+    id: runFolder.id,
+    type: "plan",
+    createdAt,
+    finishedAt: new Date().toISOString(),
+    workspacePath: opts.repoRoot,
+    topic: opts.topic,
+    git: gitContext,
+    input: { source: "requirement-file" },
+    agents: [
+      {
+        name: workerName,
+        role: "worker",
+        provider: agentConfig.provider,
+        enabled: true,
+      },
+    ],
+    adapterVersions: [],
+    status: "completed",
+    metrics: [
+      {
+        agent: workerName,
+        role: "worker",
+        provider: adapter.provider,
+        model: adapterOut.modelUsed,
+        tokensIn: adapterOut.tokensIn,
+        cachedTokensIn: adapterOut.cachedTokensIn ?? 0,
+        tokensOut: adapterOut.tokensOut,
+        costUsd: adapterOut.costUsd,
+        latencyMs: adapterOut.latencyMs,
+      },
+    ],
+    totals: {
+      tokensIn: adapterOut.tokensIn,
+      tokensOut: adapterOut.tokensOut,
+      costUsd: adapterOut.costUsd,
+      latencyMs: adapterOut.latencyMs,
+    },
+    reviewPath: planRel,
+    budget: {
+      maxCostPerRunUsd: config.budget.maxCostPerRunUsd,
+      maxTokensPerRun: config.budget.maxTokensPerRun,
+    },
+  });
+
+  return {
+    planPath: planRel,
+    planBytes: planContent.length,
+    worker: workerName,
+    provider: adapter.provider,
+    modelUsed: adapterOut.modelUsed,
+    tokensIn: adapterOut.tokensIn,
+    cachedTokensIn: adapterOut.cachedTokensIn ?? 0,
+    tokensOut: adapterOut.tokensOut,
+    costUsd: adapterOut.costUsd,
+    latencyMs: adapterOut.latencyMs,
+    memorySources: memory.sources,
+    memoryMissing: memory.missing,
+    runId: runFolder.id,
+    runFolder: runFolder.relPath,
+  };
+}

package/src/runs/types.ts

@@ -14,7 +14,9 @@ export type RunType =
   | "review-diff"
   | "review-path"
   | "review-requirement"
-  | "review-worker-reviewer";
+  | "review-worker-reviewer"
+  | "plan"
+  | "review-plan";
 
 export type RunStatus = "running" | "completed" | "failed" | "aborted_budget";