@developerz.ai/aitm 0.0.0

package/dist/orchestrator/orchestrator.js

@@ -0,0 +1,180 @@
+// docs/architecture.md §Flow, docs/subagents.md §Composition
+// Top-level agent. Owns:
+//   - prompt composition (style payload + role prefix + rolling context)
+//   - routing between Planner / Worker / Reviewer (each exposed as a tool)
+//   - **PR creation** — title, body, commit message: docs say Worker opens the PR,
+//     but the Worker can be inconsistent on global-context narration. Orchestrator
+//     re-composes the commit message and opens the PR via GitHubClient, taking the
+//     Worker's draft as input. This is the reliability win: one place that knows
+//     the whole plan writes the PR-level prose.
+//
+// SDK references:
+//   docs/vendor/ai-sdk/chunk-04.md §"ToolLoopAgent"
+//   docs/vendor/ai-sdk/chunk-09.md §"Subagents" §"Controlling What the Model Sees"
+//   docs/vendor/ai-sdk/chunk-09.md §"Loop Control" — stopWhen: [stepCountIs(N), hasToolCall('done')]
+import { generateText, hasToolCall, Output, stepCountIs, ToolLoopAgent } from 'ai';
+import { ExecaError, execa } from 'execa';
+import { z } from 'zod';
+import { makePlannerTool, makeReviewerTool, makeWorkerTool, } from "./subagent-tools.js";
+export const defaultRunCmd = async (file, args, options) => {
+    try {
+        const r = await execa(file, [...args], options?.cwd ? { cwd: options.cwd } : {});
+        return {
+            stdout: typeof r.stdout === 'string' ? r.stdout : '',
+            stderr: typeof r.stderr === 'string' ? r.stderr : '',
+            exitCode: r.exitCode ?? 0,
+        };
+    }
+    catch (err) {
+        if (err instanceof ExecaError) {
+            return {
+                stdout: typeof err.stdout === 'string' ? err.stdout : '',
+                stderr: typeof err.stderr === 'string' ? err.stderr : '',
+                exitCode: err.exitCode ?? 1,
+            };
+        }
+        throw err;
+    }
+};
+// Inlined per CLAUDE.md "no premature abstraction". Full system prompt is
+// `agentConfig.contents + ORCHESTRATOR_ROLE_PREFIX + rollingContext`.
+export const ORCHESTRATOR_ROLE_PREFIX = [
+    '',
+    '## Role: Orchestrator',
+    '',
+    'You coordinate three subagents — Planner, Worker, Reviewer — each exposed as a tool.',
+    'You see the whole plan and the rolling context, so you also own per-PR prose:',
+    'the final commit message and the PR title + body.',
+    '',
+    'Flow:',
+    '  1. Call the planner tool once to produce the PR-group DAG.',
+    '  2. For each ready group, call the worker tool. The harness then commits + opens the PR.',
+    '  3. For each merged PR with unresolved review threads, call the reviewer tool.',
+    '  4. Stop when every group is merged or blocked.',
+    '',
+    'Rules:',
+    '  - Be specific and terse. No marketing prose.',
+    '  - Conventional commit subjects, ≤72 chars.',
+].join('\n');
+// Structured-output schema for PR composition. Title cap reinforces conventional-commit
+// brevity; body is free-form markdown.
+const PrCompositionSchema = z.object({
+    title: z.string().min(1).max(72),
+    body: z.string().min(1),
+});
+// Fallback session cap when caller passes null / 0 / negative `maxSessions`.
+export const DEFAULT_MAX_STEPS = 50;
+// Resolve the agent step cap from caller-provided `maxSessions`. Falls back to the
+// default when the value is null, zero, or negative. Exported for unit testing.
+export function resolveMaxSteps(maxSessions) {
+    return typeof maxSessions === 'number' && maxSessions > 0 ? maxSessions : DEFAULT_MAX_STEPS;
+}
+export class Orchestrator {
+    init;
+    constructor(init) {
+        this.init = init;
+    }
+    build(context) {
+        const commonDeps = {
+            credentials: this.init.credentials,
+            styleContents: this.init.agentConfig.contents,
+            rollingContext: this.init.rollingContext,
+        };
+        const tools = {
+            planner: makePlannerTool({ ...commonDeps, plannerTools: context.plannerTools }),
+            worker: makeWorkerTool({
+                ...commonDeps,
+                workerTools: context.workerTools,
+                worktreePath: context.worktreePath,
+                baseBranch: context.baseBranch,
+                group: context.group,
+            }),
+            reviewer: makeReviewerTool({
+                ...commonDeps,
+                reviewerTools: context.reviewerTools,
+                worktreePath: context.worktreePath,
+                pr: context.pr,
+                threads: context.threads,
+            }),
+        };
+        return new ToolLoopAgent({
+            model: this.init.credentials.modelFor('orchestrator'),
+            instructions: this.buildSystemPrompt(),
+            tools,
+            stopWhen: [stepCountIs(resolveMaxSteps(this.init.maxSessions)), hasToolCall('done')],
+        });
+    }
+    buildSystemPrompt() {
+        return [
+            this.init.agentConfig.contents,
+            ORCHESTRATOR_ROLE_PREFIX,
+            this.init.rollingContext,
+        ].join('\n');
+    }
+    // Re-write the Worker's draft commit message via the orchestrator model, then
+    // `git commit --amend` on the active worktree. Returns the new HEAD SHA.
+    async finalizeCommit(group, delivery, worktreePath) {
+        const refined = await this.refineCommitMessage(group, delivery);
+        const runCmd = this.init.runCmd ?? defaultRunCmd;
+        const amend = await runCmd('git', ['commit', '--amend', '-m', refined], { cwd: worktreePath });
+        if (amend.exitCode !== 0) {
+            throw new Error(`git commit --amend failed: ${amend.stderr.trim() || amend.stdout.trim()}`);
+        }
+        const sha = await runCmd('git', ['rev-parse', 'HEAD'], { cwd: worktreePath });
+        if (sha.exitCode !== 0) {
+            throw new Error(`git rev-parse HEAD failed: ${sha.stderr.trim() || sha.stdout.trim()}`);
+        }
+        return sha.stdout.trim();
+    }
+    // Compose PR title + body via the orchestrator model, then open the PR through the github
+    // client. Falls back to `aitm/<group.id>` when `group.branch` is unset.
+    async openPr(group, delivery, baseBranch) {
+        const { title, body } = await this.composePr(group, delivery);
+        const head = group.branch ?? `aitm/${group.id}`;
+        return this.init.github.createPr({ title, body, base: baseBranch, head });
+    }
+    async refineCommitMessage(group, delivery) {
+        const { text } = await generateText({
+            model: this.init.credentials.modelFor('orchestrator'),
+            prompt: this.buildCommitPrompt(group, delivery),
+        });
+        return text.trim();
+    }
+    buildCommitPrompt(group, delivery) {
+        return [
+            this.buildSystemPrompt(),
+            '',
+            'Rewrite the worker draft into a final commit message.',
+            'Subject ≤72 chars, conventional-commit style. Body optional, one paragraph.',
+            'Output ONLY the message — no labels, no quotes.',
+            '',
+            `PR group: ${group.id} — ${group.title}`,
+            `Worker draft: ${delivery.draftCommitMessage}`,
+            'Files changed:',
+            ...delivery.changes.map((c) => `  - ${c.kind} ${c.path}: ${c.summary}`),
+        ].join('\n');
+    }
+    async composePr(group, delivery) {
+        const result = await generateText({
+            model: this.init.credentials.modelFor('orchestrator'),
+            prompt: this.buildPrPrompt(group, delivery),
+            output: Output.object({ schema: PrCompositionSchema, name: 'PrComposition' }),
+        });
+        return result.experimental_output;
+    }
+    buildPrPrompt(group, delivery) {
+        return [
+            this.buildSystemPrompt(),
+            '',
+            'Compose the pull-request title and body for this PR group. Return JSON.',
+            '- title: conventional-commit style, ≤72 chars',
+            '- body: short summary + bulleted file changes + relevant rolling context',
+            '',
+            `PR group: ${group.id} — ${group.title}`,
+            `Worker draft message: ${delivery.draftCommitMessage}`,
+            'Files changed:',
+            ...delivery.changes.map((c) => `  - ${c.kind} ${c.path}: ${c.summary}`),
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator/orchestrator.js.map

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

package/dist/orchestrator/subagent-tools.d.ts

@@ -0,0 +1,44 @@
+import type { LanguageModel, Tool } from 'ai';
+import { z } from 'zod';
+import type { Role } from '../credentials/credentials.ts';
+import type { ReviewThread } from '../github/schema.ts';
+import type { PrGroup } from '../state/schema.ts';
+import { type PlannerResult, type PlannerTools } from '../subagents/planner.ts';
+import { type ReviewerResult, type ReviewerTools } from '../subagents/reviewer.ts';
+import { type WorkerResult, type WorkerTools } from '../subagents/worker.ts';
+export type ModelProvider = {
+    modelFor(role: Role): LanguageModel;
+};
+type CommonDeps = {
+    credentials: ModelProvider;
+    styleContents: string;
+    rollingContext: string;
+};
+export type PlannerToolDeps = CommonDeps & {
+    plannerTools: PlannerTools;
+};
+export type WorkerToolDeps = CommonDeps & {
+    workerTools: WorkerTools;
+    worktreePath: string;
+    baseBranch: string;
+    group: PrGroup;
+};
+export type ReviewerToolDeps = CommonDeps & {
+    reviewerTools: ReviewerTools;
+    worktreePath: string;
+    pr: number;
+    threads: ReviewThread[];
+};
+export type SubagentToolDeps = PlannerToolDeps & WorkerToolDeps & ReviewerToolDeps;
+declare const plannerInputSchema: z.ZodObject<{
+    goal: z.ZodString;
+    criteria: z.ZodOptional<z.ZodString>;
+    maxPrs: z.ZodNumber;
+}, z.core.$strip>;
+type PlannerToolInput = z.infer<typeof plannerInputSchema>;
+declare const emptyInputSchema: z.ZodObject<{}, z.core.$strip>;
+type EmptyInput = z.infer<typeof emptyInputSchema>;
+export declare function makePlannerTool(deps: PlannerToolDeps): Tool<PlannerToolInput, PlannerResult>;
+export declare function makeWorkerTool(deps: WorkerToolDeps): Tool<EmptyInput, WorkerResult>;
+export declare function makeReviewerTool(deps: ReviewerToolDeps): Tool<EmptyInput, ReviewerResult>;
+export {};

package/dist/orchestrator/subagent-tools.js

@@ -0,0 +1,133 @@
+// Wrap each subagent as a tool consumable by the Orchestrator agent.
+// Pattern verbatim from docs/vendor/ai-sdk/chunk-09.md §"Subagents" and §"Controlling What the
+// Model Sees" — `toModelOutput` keeps the Orchestrator context lean by collapsing the full
+// subagent result to a one-line `<role> [<status>]: <summary>`.
+//
+// Note: AI SDK 6 names the field `toModelOutput` (the SDK-5 name was
+// `experimental_toToolResultContent`; the task brief uses the older spelling).
+//
+// Each wrapper:
+//   - inputSchema  — Zod schema; the Orchestrator's model fills it in per call
+//   - execute      — builds the subagent via its factory using `credentials.modelFor(role)` and
+//                    runs the matching runner; returns the full structured result
+//   - toModelOutput — collapses that result to a single status line for the Orchestrator
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createPlannerAgent, PLANNER_SYSTEM_PREFIX, runPlanner, } from "../subagents/planner.js";
+import { createReviewerAgent, REVIEWER_SYSTEM_PREFIX, runReviewer, } from "../subagents/reviewer.js";
+import { createWorkerAgent, runWorker, WORKER_SYSTEM_PREFIX, } from "../subagents/worker.js";
+const plannerInputSchema = z.object({
+    goal: z.string().min(1).describe('User goal to plan PR groups for'),
+    criteria: z.string().optional().describe('Optional acceptance criteria'),
+    maxPrs: z.number().int().positive().describe('Cap on PR-group count'),
+});
+// Worker + Reviewer have all state bound in deps — the Orchestrator's model invokes them with
+// no arguments, signalling "process the currently-active group / review threads".
+const emptyInputSchema = z.object({});
+export function makePlannerTool(deps) {
+    return tool({
+        description: 'Run the Planner subagent. Given a goal, returns an ordered DAG of PR groups; each group is a single cohesive pull request.',
+        inputSchema: plannerInputSchema,
+        execute: async (input) => {
+            const agent = createPlannerAgent({
+                model: deps.credentials.modelFor('planner'),
+                tools: deps.plannerTools,
+                systemPrompt: deps.styleContents + PLANNER_SYSTEM_PREFIX,
+            });
+            return runPlanner(agent, {
+                goal: input.goal,
+                styleContents: deps.styleContents,
+                maxPrs: input.maxPrs,
+                ...(input.criteria !== undefined ? { criteria: input.criteria } : {}),
+            });
+        },
+        toModelOutput: ({ output }) => ({ type: 'text', value: summarizePlannerResult(output) }),
+    });
+}
+export function makeWorkerTool(deps) {
+    return tool({
+        description: 'Run the Worker subagent on the active PR group. Produces a file manifest, fans out per-file editors, commits on the group branch.',
+        inputSchema: emptyInputSchema,
+        execute: async () => {
+            const agent = createWorkerAgent({
+                model: deps.credentials.modelFor('worker'),
+                tools: deps.workerTools,
+                systemPrompt: deps.styleContents + WORKER_SYSTEM_PREFIX,
+            });
+            return runWorker(agent, {
+                group: deps.group,
+                worktreePath: deps.worktreePath,
+                baseBranch: deps.baseBranch,
+                styleContents: deps.styleContents,
+                rollingContext: deps.rollingContext,
+            });
+        },
+        toModelOutput: ({ output }) => ({ type: 'text', value: summarizeWorkerResult(output) }),
+    });
+}
+export function makeReviewerTool(deps) {
+    return tool({
+        description: 'Run the Reviewer subagent on outstanding PR review threads. Each thread resolves to fixed / replied / wontfix.',
+        inputSchema: emptyInputSchema,
+        execute: async () => {
+            const agent = createReviewerAgent({
+                model: deps.credentials.modelFor('reviewer'),
+                tools: deps.reviewerTools,
+                systemPrompt: deps.styleContents + REVIEWER_SYSTEM_PREFIX,
+            });
+            return runReviewer(agent, {
+                pr: deps.pr,
+                threads: deps.threads,
+                worktreePath: deps.worktreePath,
+                styleContents: deps.styleContents,
+            });
+        },
+        toModelOutput: ({ output }) => ({ type: 'text', value: summarizeReviewerResult(output) }),
+    });
+}
+// Cap per-line summary length so a verbose subagent reply (long IDs, multiline draft
+// commit messages, error payloads) can't bloat the orchestrator's context. 220 chars
+// is enough for a status line + a few tens of chars of free text.
+const MAX_SUMMARY_CHARS = 220;
+// Show only the first N planner group IDs, then `+M more` — the count alone is what
+// matters to the orchestrator; the orchestrator can re-read the plan if it needs the
+// full ID list.
+const MAX_PREVIEW_IDS = 8;
+function compactOneLine(text, max = MAX_SUMMARY_CHARS) {
+    return text.replace(/\s+/g, ' ').trim().slice(0, max);
+}
+function summarizePlannerResult(r) {
+    if (r.kind === 'ok') {
+        const ids = r.plan.groups.map((g) => g.id);
+        const preview = ids.slice(0, MAX_PREVIEW_IDS).join(', ');
+        const suffix = ids.length > MAX_PREVIEW_IDS ? `, +${ids.length - MAX_PREVIEW_IDS} more` : '';
+        return compactOneLine(`planner [ok]: ${r.plan.groups.length} group(s) — ${preview}${suffix}`);
+    }
+    if (r.kind === 'blocked')
+        return compactOneLine(`planner [blocked]: ${r.reason}`);
+    return compactOneLine(`planner [error]: ${r.error}`);
+}
+function summarizeWorkerResult(r) {
+    if (r.kind === 'ok') {
+        const d = r.delivery;
+        return compactOneLine(`worker [ok]: ${d.branch} — ${d.draftCommitMessage} (${d.changes.length} file(s))`);
+    }
+    if (r.kind === 'blocked')
+        return compactOneLine(`worker [blocked]: ${r.reason}`);
+    return compactOneLine(`worker [error]: ${r.error}`);
+}
+function summarizeReviewerResult(r) {
+    if (r.kind === 'ok') {
+        const counts = r.resolutions.reduce((acc, x) => {
+            acc[x.kind] = (acc[x.kind] ?? 0) + 1;
+            return acc;
+        }, {});
+        const parts = Object.entries(counts).map(([k, v]) => `${k}=${v}`);
+        const tail = parts.length > 0 ? ` — ${parts.join(', ')}` : '';
+        return compactOneLine(`reviewer [ok]: ${r.resolutions.length} resolution(s)${tail}`);
+    }
+    if (r.kind === 'blocked')
+        return compactOneLine(`reviewer [blocked]: ${r.reason}`);
+    return compactOneLine(`reviewer [error]: ${r.error}`);
+}
+//# sourceMappingURL=subagent-tools.js.map

package/dist/orchestrator/subagent-tools.js.map

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

package/dist/orchestrator/system-prompts.d.ts

@@ -0,0 +1,4 @@
+export declare const ORCHESTRATOR_PREFIX: string;
+export declare const PLANNER_PREFIX: string;
+export declare const WORKER_PREFIX: string;
+export declare const REVIEWER_PREFIX: string;

package/dist/orchestrator/system-prompts.js

@@ -0,0 +1,78 @@
+// Role system-prompt prefixes for each agent. Inlined per CLAUDE.md "no premature abstraction".
+// Appended after `agentConfig.contents` (house style) to form the full instructions string.
+export const ORCHESTRATOR_PREFIX = [
+    '',
+    '## Role: Orchestrator',
+    '',
+    'You coordinate three subagents — Planner, Worker, Reviewer — each exposed as a tool.',
+    'You see the whole plan and the rolling context, so you own per-PR prose:',
+    'the final commit message and the PR title + body.',
+    '',
+    'Flow:',
+    '  1. Call the planner tool once to produce the PR-group DAG.',
+    '  2. For each ready group, call the worker tool.',
+    '  3. For each merged PR with unresolved review threads, call the reviewer tool.',
+    '  4. Stop when every group is merged or blocked.',
+    '',
+    'Rules:',
+    '  - SRP: one concern per PR group, one tool call per concern.',
+    '  - Be specific and terse. No marketing prose.',
+    '  - Conventional commit subjects, ≤72 chars.',
+].join('\n');
+export const PLANNER_PREFIX = [
+    '',
+    '## Role: Planner',
+    '',
+    'You receive a goal and optional acceptance criteria.',
+    'You output a directed-acyclic plan of PR groups: each group is one cohesive pull request,',
+    'roughly 300 lines of code, that can be reviewed independently.',
+    '',
+    'Rules:',
+    '  - SRP: one coherent responsibility per PR group.',
+    '  - Ground the plan in the actual repo before emitting — use read-only tools.',
+    '  - Each group has a stable slug id, a one-line title, an ordered task list,',
+    '    and a dependsOn list of earlier group ids.',
+    '  - Prefer parallelizable siblings over a single linear chain.',
+    '  - Do not invent files. Do not propose work outside the repo.',
+    '  - Return JSON that matches the Plan schema exactly.',
+].join('\n');
+export const WORKER_PREFIX = [
+    '',
+    '## Role: Worker',
+    '',
+    'You receive one PR group: a coherent batch of tasks that land in a single pull request.',
+    'Work in two phases.',
+    '',
+    'Phase 1 — manifest. Use read-only tools to ground yourself in existing code,',
+    'then emit a FileManifest JSON listing every file to create/modify/delete plus a',
+    'one-line draft commit message. Do not edit yet.',
+    '',
+    'Phase 2 — edits. Each manifest entry is handled by a dedicated editor subagent.',
+    '',
+    'Rules:',
+    '  - SRP: one responsibility per file; split unrelated edits.',
+    '  - Stay inside the worktree provided. No work outside the repo.',
+    '  - draftCommitMessage subject ≤72 chars.',
+    '  - Return the FileManifest JSON exactly matching the schema.',
+].join('\n');
+export const REVIEWER_PREFIX = [
+    '',
+    '## Role: Reviewer',
+    '',
+    'You receive ONE unresolved PR review thread at a time and decide between three outcomes,',
+    'emitting a ThreadResolutionOutput JSON.',
+    '',
+    '- "fixed": the reviewer is right — make the code change, reply explaining the fix,',
+    '  resolve the thread, emit { kind: "fixed", commitMessage }.',
+    '- "replied": a question/clarification only — answer via reply, no code change,',
+    '  emit { kind: "replied" }.',
+    '- "wontfix": stale, out-of-scope, or disagree — reply with reason, resolve the thread,',
+    '  emit { kind: "wontfix", reason }.',
+    '',
+    'Rules:',
+    '  - SRP: one thread per invocation.',
+    '  - Stay inside the worktree. No work outside the repo.',
+    '  - Resolve the thread for "fixed" and "wontfix"; leave it open for "replied".',
+    '  - Return JSON that matches the ThreadResolutionOutput schema exactly.',
+].join('\n');
+//# sourceMappingURL=system-prompts.js.map

package/dist/orchestrator/system-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompts.js","sourceRoot":"","sources":["../../src/orchestrator/system-prompts.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,4FAA4F;AAE5F,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,sFAAsF;IACtF,0EAA0E;IAC1E,mDAAmD;IACnD,EAAE;IACF,OAAO;IACP,8DAA8D;IAC9D,kDAAkD;IAClD,iFAAiF;IACjF,kDAAkD;IAClD,EAAE;IACF,QAAQ;IACR,+DAA+D;IAC/D,gDAAgD;IAChD,8CAA8C;CAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE;IACF,kBAAkB;IAClB,EAAE;IACF,sDAAsD;IACtD,2FAA2F;IAC3F,gEAAgE;IAChE,EAAE;IACF,QAAQ;IACR,oDAAoD;IACpD,+EAA+E;IAC/E,8EAA8E;IAC9E,gDAAgD;IAChD,gEAAgE;IAChE,gEAAgE;IAChE,uDAAuD;CACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE;IACF,iBAAiB;IACjB,EAAE;IACF,yFAAyF;IACzF,qBAAqB;IACrB,EAAE;IACF,8EAA8E;IAC9E,iFAAiF;IACjF,iDAAiD;IACjD,EAAE;IACF,iFAAiF;IACjF,EAAE;IACF,QAAQ;IACR,8DAA8D;IAC9D,kEAAkE;IAClE,2CAA2C;IAC3C,+DAA+D;CAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,EAAE;IACF,mBAAmB;IACnB,EAAE;IACF,0FAA0F;IAC1F,yCAAyC;IACzC,EAAE;IACF,oFAAoF;IACpF,8DAA8D;IAC9D,gFAAgF;IAChF,6BAA6B;IAC7B,wFAAwF;IACxF,qCAAqC;IACrC,EAAE;IACF,QAAQ;IACR,qCAAqC;IACrC,yDAAyD;IACzD,gFAAgF;IAChF,yEAAyE;CAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/plan/plan-graph.d.ts

@@ -0,0 +1,11 @@
+import type { PrGroup } from '../state/schema.ts';
+export declare class PlanGraph {
+    private readonly groups;
+    private readonly index;
+    constructor(groups: ReadonlyArray<PrGroup>);
+    ready(): PrGroup[];
+    blocked(): PrGroup[];
+    byId(id: string): PrGroup | undefined;
+    isComplete(): boolean;
+    static validate(groups: ReadonlyArray<PrGroup>): void;
+}

package/dist/plan/plan-graph.js

@@ -0,0 +1,69 @@
+// Dependency DAG over PR groups. Drives concurrent execution in src/loop/work-loop.ts.
+// Why a graph and not a list — docs/task-groups.md (extended): large goals split into
+// independent PRs that can run in parallel. A linear list serializes work needlessly.
+export class PlanGraph {
+    groups;
+    index;
+    constructor(groups) {
+        this.groups = groups;
+        PlanGraph.validate(groups);
+        this.index = new Map(groups.map((g) => [g.id, g]));
+    }
+    // Groups currently ready to run: status === 'pending' AND all deps merged.
+    ready() {
+        return this.groups.filter((g) => g.status === 'pending' &&
+            g.dependsOn.every((dep) => this.index.get(dep)?.status === 'merged'));
+    }
+    // Groups blocked on at least one unmerged dep.
+    blocked() {
+        return this.groups.filter((g) => g.status === 'pending' &&
+            g.dependsOn.some((dep) => this.index.get(dep)?.status !== 'merged'));
+    }
+    byId(id) {
+        return this.index.get(id);
+    }
+    // True when every group is in a terminal state (merged or blocked).
+    isComplete() {
+        return this.groups.every((g) => g.status === 'merged' || g.status === 'blocked');
+    }
+    // Static: detect cycles + dangling deps at plan-acceptance time.
+    // DFS coloring — white=unvisited, gray=on stack, black=fully explored.
+    static validate(groups) {
+        const ids = new Set();
+        for (const g of groups) {
+            if (ids.has(g.id)) {
+                throw new Error(`PlanGraph: duplicate group id '${g.id}'`);
+            }
+            ids.add(g.id);
+        }
+        for (const g of groups) {
+            for (const dep of g.dependsOn) {
+                if (!ids.has(dep)) {
+                    throw new Error(`PlanGraph: group '${g.id}' depends on unknown group '${dep}'`);
+                }
+            }
+        }
+        const byId = new Map(groups.map((g) => [g.id, g]));
+        const color = new Map();
+        const visit = (id, path) => {
+            const state = color.get(id);
+            if (state === 'black')
+                return;
+            if (state === 'gray') {
+                const cycle = [...path.slice(path.indexOf(id)), id].join(' -> ');
+                throw new Error(`PlanGraph: cycle detected: ${cycle}`);
+            }
+            color.set(id, 'gray');
+            const node = byId.get(id);
+            if (node) {
+                for (const dep of node.dependsOn) {
+                    visit(dep, [...path, id]);
+                }
+            }
+            color.set(id, 'black');
+        };
+        for (const g of groups)
+            visit(g.id, []);
+    }
+}
+//# sourceMappingURL=plan-graph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-graph.js","sourceRoot":"","sources":["../../src/plan/plan-graph.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,sFAAsF;AACtF,sFAAsF;AAItF,MAAM,OAAO,SAAS;IAGS;IAFZ,KAAK,CAAuB;IAE7C,YAA6B,MAA8B;QAA9B,WAAM,GAAN,MAAM,CAAwB;QACzD,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,2EAA2E;IAC3E,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,SAAS;YACtB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC,CACvE,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,SAAS;YACtB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,oEAAoE;IACpE,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACnF,CAAC;IAED,iEAAiE;IACjE,uEAAuE;IACvE,MAAM,CAAC,QAAQ,CAAC,MAA8B;QAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC7D,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,+BAA+B,GAAG,GAAG,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;QAElD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,IAAc,EAAQ,EAAE;YACjD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,KAAK,KAAK,OAAO;gBAAE,OAAO;YAC9B,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACjC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/plan/schema.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export declare const PlannedTaskSchema: z.ZodObject<{
+    description: z.ZodString;
+    filesHint: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PlannedTask = z.infer<typeof PlannedTaskSchema>;
+export declare const PlannedGroupSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    tasks: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        filesHint: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PlannedGroup = z.infer<typeof PlannedGroupSchema>;
+export declare const PlanSchema: z.ZodObject<{
+    goal: z.ZodString;
+    criteria: z.ZodOptional<z.ZodString>;
+    groups: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        tasks: z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            filesHint: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Plan = z.infer<typeof PlanSchema>;

package/dist/plan/schema.js

@@ -0,0 +1,24 @@
+// Plan-time output of Planner subagent — see docs/subagents.md §Roster (Planner row).
+// PrGroup is persisted via src/state/schema.ts; the plan schema below is what
+// Planner returns to the Orchestrator before that persistence step.
+import { z } from 'zod';
+export const PlannedTaskSchema = z.object({
+    description: z.string(),
+    // Optional file hint helps Worker plan its parallel file-edit fanout.
+    // See docs/vendor/ai-sdk/chunk-09.md §"Orchestrator-Worker" — Worker uses this
+    // to emit a file manifest, then Promise.all over per-file editor subagents.
+    filesHint: z.array(z.string()).optional(),
+});
+export const PlannedGroupSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    tasks: z.array(PlannedTaskSchema),
+    // Group ids that must merge before this group runs. Empty = root of DAG.
+    dependsOn: z.array(z.string()).default([]),
+});
+export const PlanSchema = z.object({
+    goal: z.string(),
+    criteria: z.string().optional(),
+    groups: z.array(PlannedGroupSchema),
+});
+//# sourceMappingURL=schema.js.map

package/dist/plan/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/plan/schema.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,8EAA8E;AAC9E,oEAAoE;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,sEAAsE;IACtE,+EAA+E;IAC/E,4EAA4E;IAC5E,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACjC,yEAAyE;IACzE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;CACpC,CAAC,CAAC"}