planpong 0.5.6 → 0.6.0

package/README.md

@@ -18,14 +18,18 @@ You need at least **one AI CLI** installed and authenticated:
 
 - **Claude Code** — `npm install -g @anthropic-ai/claude-code` (Anthropic API key or Max subscription)
 - **Codex CLI** — `npm install -g @openai/codex` (OpenAI API key)
+- **Gemini CLI** — `npm install -g @google/gemini-cli` (Google account auth — run `gemini` once to authenticate)
 
-If both are installed, planpong uses one for planning and the other for reviewing (configurable). If only one is available, it auto-fallbacks to using that CLI for both roles.
+If multiple are installed, planpong uses one for planning and a different one for reviewing (configurable). If only one is available, it auto-fallbacks to using that CLI for both roles.
+
+> **Note on gemini as reviewer:** the gemini CLI does not expose a stable session-resume mechanism, so reviewer rounds run without persistent context. Expect noticeably slower per-round wall time than claude or codex when gemini is the reviewer. The first time you load a config that selects gemini as reviewer, planpong prints a one-line warning to stderr.
 
 Verify your CLI works:
 
 ```sh
 claude --version   # or
-codex --version
+codex --version    # or
+gemini --version
 ```
 
 Planpong shells out to these CLIs — no API keys are configured in planpong itself.
@@ -36,6 +40,14 @@ Planpong shells out to these CLIs — no API keys are configured in planpong its
 npm install -g planpong
 ```
 
+Then run the interactive setup wizard:
+
+```sh
+planpong init
+```
+
+The wizard auto-detects which AI CLIs you have installed, lets you pick a planner + reviewer, and writes a working `planpong.yaml` for the current project. You can re-run it any time to tweak settings — only changed keys are written.
+
 ## Setup (Claude Code MCP)
 
 Add planpong as an MCP server so Claude Code can use it as a native tool:
@@ -69,8 +81,11 @@ Review my plan at docs/plans/my-feature.md using planpong
 Or use the slash commands (auto-installed with the MCP server):
 
 ```
-/planpong:review docs/plans/my-feature.md              # autonomous — runs to completion
-/planpong:review_interactive docs/plans/my-feature.md   # pauses between rounds for your input
+/planpong:review docs/plans/my-feature.md             # autonomous — runs to completion
+/planpong:review_interactive docs/plans/my-feature.md # pauses between rounds for your input
+/planpong:status <session_id>                         # current state and round history
+/planpong:sessions                                    # list all review sessions in this project
+/planpong:report <session_id>                         # detailed phase-specific report (direction confidence, risk register, round history)
 ```
 
 ### Via CLI
@@ -81,11 +96,11 @@ planpong review docs/plans/my-feature.md
 
 ## Configuration
 
-Optional. Create `planpong.yaml` in your project root:
+Optional. Run `planpong init` to generate this interactively, or create `planpong.yaml` in your project root by hand:
 
 ```yaml
 planner:
-  provider: claude # claude or codex
+  provider: claude # claude, codex, or gemini
   model: claude-opus-4-6 # provider-specific model name
   effort: high # reasoning effort level
 reviewer:
@@ -95,28 +110,40 @@ reviewer:
 max_rounds: 10
 plans_dir: docs/plans
 revision_mode: full # full or edits
-planner_mode: external # external or inline
+planner_mode: inline # inline or external (see below)
 ```
 
-All fields are optional. Defaults: claude (planner) + codex (reviewer), 10 rounds, `docs/plans/` directory.
+All fields are optional. Defaults: claude (planner) + codex (reviewer), 10 rounds, `docs/plans/` directory, `planner_mode: inline`, `revision_mode: full`, `human_in_loop: true`.
+
+### Planner mode: inline vs external
+
+`planner_mode` is the most consequential operational choice. It decides who actually rewrites the plan after each round of feedback:
+
+- **`inline` (default)** — when you're driving planpong from Claude Code, *you* are the planner. Planpong returns the reviewer's issues; Claude reads the plan, edits it directly, and reports its accept/reject/defer decisions back via `planpong_record_revision`. No second model is invoked, so revisions are fast and use the conversational context Claude already has.
+- **`external`** — planpong shells out to the configured planner provider (e.g. another `claude -p` or `codex exec` invocation) to produce the revision. Use this when running planpong outside Claude Code (CLI flow), or when you want a different model to plan than the one orchestrating.
+
+Inline is the right default for the Claude-Code-as-orchestrator workflow; external is the right default for `planpong review` from a plain shell.
 
 ### Viewing and changing config
 
 ```sh
 planpong config              # show resolved config with source annotations
 planpong config path         # print path to active config file
+planpong config keys         # list all keys with valid values, types, and defaults
+planpong config get <key>    # print a single resolved value
 planpong config set <key> <value>   # set a config value
 ```
 
 Examples:
 
 ```sh
-planpong config set reviewer.model gpt-5.3-codex
+planpong config set reviewer.provider gemini
+planpong config set reviewer.model gemini-2.5-pro
 planpong config set max_rounds 5
 planpong config set planner_mode inline
 ```
 
-Valid keys: `planner.provider`, `planner.model`, `planner.effort`, `reviewer.provider`, `reviewer.model`, `reviewer.effort`, `plans_dir`, `max_rounds`, `human_in_loop`, `revision_mode`, `planner_mode`.
+Valid keys: `planner.provider`, `planner.model`, `planner.effort`, `reviewer.provider`, `reviewer.model`, `reviewer.effort`, `plans_dir`, `max_rounds`, `human_in_loop`, `revision_mode`, `planner_mode`. Run `planpong config keys` for the canonical list with descriptions.
 
 ### Config via MCP
 
@@ -125,6 +152,16 @@ Two MCP tools are available for programmatic config access:
 - **`planpong_get_config`** — returns resolved config, file path, version, and per-key source provenance
 - **`planpong_set_config`** — dry-run by default (`confirm: false`); pass `confirm: true` to write
 
+### MCP API notes
+
+Planpong's MCP tools are designed to be safe under retries, duplicated calls, and orchestrator restarts:
+
+- **`planpong_revise` and `planpong_record_revision` require `expected_round`.** Pass the round number returned by the most recent `planpong_get_feedback`. Stale calls (round mismatched lower) and out-of-order calls (mismatched higher) return precise errors instead of double-charging the planner.
+- **Tool calls are replay-safe.** Calling `planpong_get_feedback` twice before the round's revision returns the existing feedback with `idempotent_replay: true` instead of re-invoking the reviewer. The same applies to `planpong_revise` and `planpong_record_revision` when the round's response artifact already exists.
+- **Per-session lock.** Mutating MCP tools acquire an exclusive lock at `.planpong/sessions/<id>/lock` so two overlapping clients cannot both advance the same session.
+
+Most users driving planpong through Claude Code never see these primitives — the slash commands and the orchestrator's instructions handle them. They matter if you're building an external MCP client.
+
 ## What it produces
 
 Planpong updates your plan file in-place and adds a status line tracking the review:

package/dist/bin/planpong.js

@@ -6,6 +6,7 @@ import { Command } from "commander";
 import { registerPlanCommand } from "../src/cli/commands/plan.js";
 import { registerReviewCommand } from "../src/cli/commands/review.js";
 import { registerConfigCommand } from "../src/cli/commands/config.js";
+import { registerInitCommand } from "../src/cli/commands/init.js";
 // Read version from the installed package.json so `planpong --version`
 // always reflects the actual installed version. Hardcoding it here
 // drifts every time we cut a release.
@@ -43,9 +44,20 @@ const program = new Command();
 program
     .name("planpong")
     .description("Multi-model plan review CLI — orchestrates AI agents for adversarial plan refinement")
-    .version(readPackageVersion());
+    .version(readPackageVersion())
+    .addHelpText("after", `
+Quick reference:
+  planpong init                Interactive first-run setup wizard
+  planpong config              Show current config values and sources
+  planpong config keys         List all settings with valid values and defaults
+  planpong config get <key>    Get a single setting
+  planpong config set <key> <value>  Change a setting
+
+  planpong review <plan-file>  Start adversarial review of a plan
+  planpong plan <requirements> Generate a plan and review it`);
 registerPlanCommand(program);
 registerReviewCommand(program);
 registerConfigCommand(program);
+registerInitCommand(program);
 program.parse();
 //# sourceMappingURL=planpong.js.map

package/dist/bin/planpong.js.map

@@ -1 +1 @@
-{"version":3,"file":"planpong.js","sourceRoot":"","sources":["../../bin/planpong.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,uEAAuE;AACvE,mEAAmE;AACnE,sCAAsC;AACtC,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,sEAAsE;AACtE,8BAA8B;AAC9B,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAGtD,CAAC;gBACF,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC/D,OAAO,GAAG,CAAC,OAAO,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM;YAC3B,IAAI,GAAG,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CACV,sFAAsF,CACvF;KACA,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEjC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"planpong.js","sourceRoot":"","sources":["../../bin/planpong.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,uEAAuE;AACvE,mEAAmE;AACnE,sCAAsC;AACtC,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,sEAAsE;AACtE,8BAA8B;AAC9B,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAGtD,CAAC;gBACF,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC/D,OAAO,GAAG,CAAC,OAAO,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM;YAC3B,IAAI,GAAG,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CACV,sFAAsF,CACvF;KACA,OAAO,CAAC,kBAAkB,EAAE,CAAC;KAC7B,WAAW,CACV,OAAO,EACP;;;;;;;;;6DASyD,CAC1D,CAAC;AAEJ,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/cli/commands/init.d.ts

@@ -0,0 +1,53 @@
+import type { Command } from "commander";
+import { type BatchPick } from "../../config/mutate.js";
+export interface WizardAnswers {
+    plannerProvider: string;
+    plannerModel: string;
+    reviewerProvider: string;
+    reviewerModel: string;
+    maxRounds: number;
+    plansDir: string;
+    plannerMode: "inline" | "external";
+}
+export interface DiskSnapshot {
+    planner?: {
+        provider?: string;
+        model?: string;
+    };
+    reviewer?: {
+        provider?: string;
+        model?: string;
+    };
+    max_rounds?: number;
+    plans_dir?: string;
+    planner_mode?: "inline" | "external";
+}
+/**
+ * Read planpong.yaml directly into a partial snapshot. Unlike loadConfig(),
+ * this does NOT merge defaults — fields the user never wrote remain
+ * undefined so the wizard can omit them from the batch write.
+ */
+export declare function readDiskSnapshot(cwd: string): DiskSnapshot;
+/**
+ * Pure formatter for the post-write summary. The auth reminder appears
+ * whenever gemini is picked for any role; it is intentionally a static
+ * message rather than a probe of auth state.
+ */
+export declare function formatPostWriteSummary(answers: WizardAnswers): string;
+/**
+ * Convert the wizard's answer object plus the on-disk-file snapshot into
+ * the batch picks list. Omits keys whose answer matches the on-disk value
+ * so the wizard never writes a default into an existing yaml the user
+ * didn't touch. Output order is stable to keep diff output predictable.
+ */
+export declare function answersToPicks(answers: WizardAnswers, disk: DiskSnapshot): BatchPick[];
+/**
+ * Detect whether stdin is a real TTY. Node sets `isTTY` to `true` for a TTY
+ * and leaves it `undefined` (NOT `false`) for pipes/redirects, so a strict
+ * `=== false` check would silently let the wizard fall through to inquirer
+ * and hang on the first prompt.
+ */
+export declare function isInteractiveTty(stdin: {
+    isTTY?: boolean;
+}): boolean;
+export declare function registerInitCommand(program: Command): void;

package/dist/src/cli/commands/init.js

@@ -0,0 +1,221 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { select, input, confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+import { setConfigValuesBatch, } from "../../config/mutate.js";
+import { getAllProviders, getInstallHint, } from "../../providers/registry.js";
+const CONFIG_FILENAMES = [
+    "planpong.yaml",
+    "planpong.yml",
+    ".planpong.yaml",
+    ".planpong.yml",
+];
+const GEMINI_REVIEWER_INLINE_WARNING = "warning: gemini reviewer rounds run without persistent session resumption.\n" +
+    "         expect noticeably slower per-round wall time than claude/codex.\n" +
+    "         tracked: see Future work in docs/plans/gemini-and-init-wizard.md";
+/**
+ * Read planpong.yaml directly into a partial snapshot. Unlike loadConfig(),
+ * this does NOT merge defaults — fields the user never wrote remain
+ * undefined so the wizard can omit them from the batch write.
+ */
+export function readDiskSnapshot(cwd) {
+    for (const filename of CONFIG_FILENAMES) {
+        const candidate = join(cwd, filename);
+        if (existsSync(candidate)) {
+            const raw = readFileSync(candidate, "utf-8");
+            return parseYaml(raw) ?? {};
+        }
+    }
+    return {};
+}
+/**
+ * Pure formatter for the post-write summary. The auth reminder appears
+ * whenever gemini is picked for any role; it is intentionally a static
+ * message rather than a probe of auth state.
+ */
+export function formatPostWriteSummary(answers) {
+    const lines = [];
+    lines.push("");
+    lines.push("Run 'planpong review <plan-file>' to start a review, or", "    'planpong plan <requirements>' to generate a new plan.");
+    if (answers.plannerProvider === "gemini" ||
+        answers.reviewerProvider === "gemini") {
+        lines.push("");
+        lines.push("Note: gemini requires Google account auth. Run `gemini` once", "      before invoking planpong if you haven't already.");
+    }
+    return lines.join("\n");
+}
+/**
+ * Convert the wizard's answer object plus the on-disk-file snapshot into
+ * the batch picks list. Omits keys whose answer matches the on-disk value
+ * so the wizard never writes a default into an existing yaml the user
+ * didn't touch. Output order is stable to keep diff output predictable.
+ */
+export function answersToPicks(answers, disk) {
+    const picks = [];
+    const add = (key, answer, diskValue) => {
+        if (answer === diskValue)
+            return;
+        picks.push({ key, rawValue: String(answer) });
+    };
+    add("planner.provider", answers.plannerProvider, disk.planner?.provider);
+    add("planner.model", answers.plannerModel, disk.planner?.model);
+    add("reviewer.provider", answers.reviewerProvider, disk.reviewer?.provider);
+    add("reviewer.model", answers.reviewerModel, disk.reviewer?.model);
+    add("max_rounds", answers.maxRounds, disk.max_rounds);
+    add("plans_dir", answers.plansDir, disk.plans_dir);
+    add("planner_mode", answers.plannerMode, disk.planner_mode);
+    return picks;
+}
+async function probeProviders() {
+    const all = getAllProviders();
+    return Promise.all(all.map(async (p) => ({ provider: p, available: await p.isAvailable() })));
+}
+function printDetectionTable(statuses) {
+    console.log(chalk.bold("\nDetected CLIs:"));
+    for (const s of statuses) {
+        const mark = s.available ? chalk.green("✓") : chalk.dim("✗");
+        const name = s.provider.name.padEnd(8);
+        if (s.available) {
+            console.log(`  ${mark} ${name}available`);
+        }
+        else {
+            console.log(`  ${mark} ${name}${chalk.dim("not installed — " + getInstallHint(s.provider.name))}`);
+        }
+    }
+    console.log();
+}
+/**
+ * Detect whether stdin is a real TTY. Node sets `isTTY` to `true` for a TTY
+ * and leaves it `undefined` (NOT `false`) for pipes/redirects, so a strict
+ * `=== false` check would silently let the wizard fall through to inquirer
+ * and hang on the first prompt.
+ */
+export function isInteractiveTty(stdin) {
+    return stdin.isTTY === true;
+}
+async function runWizard(cwd) {
+    if (!isInteractiveTty(process.stdin)) {
+        process.stderr.write("planpong init must run interactively. Use 'planpong config set <key> <value>' for scripted setup.\n");
+        process.exitCode = 1;
+        return;
+    }
+    console.log(chalk.bold("\nplanpong init") + chalk.dim(" — first-run setup\n"));
+    const statuses = await probeProviders();
+    printDetectionTable(statuses);
+    const installed = statuses.filter((s) => s.available);
+    if (installed.length === 0) {
+        console.error(chalk.red("No supported AI CLIs are installed."), "Install at least one of:");
+        for (const s of statuses) {
+            console.error(`  - ${getInstallHint(s.provider.name)}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const disk = readDiskSnapshot(cwd);
+    const installedChoices = installed.map((s) => ({
+        name: s.provider.name,
+        value: s.provider.name,
+    }));
+    const plannerProvider = await select({
+        message: "Planner provider:",
+        choices: installedChoices,
+        default: disk.planner?.provider ?? installedChoices[0].value,
+    });
+    const plannerModelChoices = (statuses.find((s) => s.provider.name === plannerProvider)?.provider.getModels() ?? []).map((m) => ({ name: m, value: m }));
+    const plannerModel = await select({
+        message: "Planner model:",
+        choices: plannerModelChoices,
+        default: disk.planner?.model ?? plannerModelChoices[0]?.value,
+    });
+    const reviewerProvider = await select({
+        message: "Reviewer provider:",
+        choices: installedChoices,
+        default: disk.reviewer?.provider ?? installedChoices[0].value,
+    });
+    if (reviewerProvider === plannerProvider) {
+        console.log(chalk.yellow("  note: planner and reviewer use the same provider. Adversarial signal is reduced when both roles share a model lineage."));
+    }
+    const reviewerModelChoices = (statuses.find((s) => s.provider.name === reviewerProvider)?.provider.getModels() ?? []).map((m) => ({ name: m, value: m }));
+    const reviewerModel = await select({
+        message: "Reviewer model:",
+        choices: reviewerModelChoices,
+        default: disk.reviewer?.model ?? reviewerModelChoices[0]?.value,
+    });
+    const maxRoundsRaw = await input({
+        message: "Maximum review rounds:",
+        default: String(disk.max_rounds ?? 10),
+        validate: (v) => {
+            const n = Number(v);
+            return Number.isInteger(n) && n >= 1 && n <= 50
+                ? true
+                : "Enter an integer between 1 and 50.";
+        },
+    });
+    const plansDir = await input({
+        message: "Plans directory:",
+        default: disk.plans_dir ?? "docs/plans",
+    });
+    const plannerMode = (await select({
+        message: "Planner mode:",
+        choices: [
+            { name: "inline (you act as the planner)", value: "inline" },
+            { name: "external (route revisions through the planner provider)", value: "external" },
+        ],
+        default: disk.planner_mode ?? "inline",
+    }));
+    if (reviewerProvider === "gemini") {
+        console.log("\n" + chalk.yellow(GEMINI_REVIEWER_INLINE_WARNING) + "\n");
+    }
+    const answers = {
+        plannerProvider,
+        plannerModel,
+        reviewerProvider,
+        reviewerModel,
+        maxRounds: Number(maxRoundsRaw),
+        plansDir,
+        plannerMode,
+    };
+    const picks = answersToPicks(answers, disk);
+    if (picks.length === 0) {
+        console.log(chalk.dim("No changes — your planpong.yaml already matches these answers."));
+        return;
+    }
+    console.log(chalk.bold("\nProposed changes:"));
+    for (const p of picks) {
+        console.log(`  ${p.key.padEnd(20)} → ${p.rawValue}`);
+    }
+    const proceed = await confirm({
+        message: existsSync(join(cwd, "planpong.yaml"))
+            ? "Update planpong.yaml with these changes?"
+            : "Write planpong.yaml in this directory?",
+        default: true,
+    });
+    if (!proceed) {
+        console.log(chalk.dim("Cancelled, no changes written."));
+        return;
+    }
+    const result = setConfigValuesBatch(cwd, picks);
+    console.log(chalk.green(result.created ? "Created" : "Updated"), result.configPath);
+    console.log(formatPostWriteSummary(answers));
+}
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Interactive setup wizard — produces a working planpong.yaml")
+        .action(async () => {
+        try {
+            await runWizard(process.cwd());
+        }
+        catch (err) {
+            const e = err;
+            if (e?.name === "ExitPromptError") {
+                console.log(chalk.dim("\nAborted, no changes written."));
+                return;
+            }
+            console.error(chalk.red("Error:"), e?.message ?? String(err));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/src/cli/commands/init.js.map

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

package/dist/src/cli/ui.js

@@ -1,10 +1,8 @@
 import chalk from "chalk";
 import ora from "ora";
-const SEVERITY_COLORS = {
-    P1: chalk.red.bold,
-    P2: chalk.yellow,
-    P3: chalk.blue,
-};
+import { severityFromFeedback } from "../core/operations.js";
+import { formatFeedbackDisplay } from "../core/presentation.js";
+import { getReviewPhase } from "../prompts/reviewer.js";
 const ACTION_COLORS = {
     accepted: chalk.green,
     rejected: chalk.red,
@@ -22,20 +20,14 @@ export function createSpinner(text) {
 export function printFeedbackSummary(round, feedback) {
     const verdictColor = feedback.verdict === "needs_revision" ? chalk.yellow : chalk.green;
     console.log(`\n${chalk.bold(`Round ${round} Review`)} — ${verdictColor(feedback.verdict)}`);
-    console.log(chalk.dim(feedback.summary));
-    if (feedback.issues.length === 0) {
-        console.log(chalk.green("  No issues found."));
-        return;
-    }
-    console.log();
-    for (const issue of feedback.issues) {
-        printIssue(issue);
-    }
-}
-function printIssue(issue) {
-    const colorFn = SEVERITY_COLORS[issue.severity] ?? chalk.white;
-    console.log(`  ${colorFn(issue.severity)} ${chalk.bold(issue.id)}: ${issue.title}`);
-    console.log(chalk.dim(`       ${issue.section}`));
+    const display = formatFeedbackDisplay({
+        round,
+        phase: getReviewPhase(round),
+        verdict: feedback.verdict,
+        severity: severityFromFeedback(feedback),
+        feedback,
+    });
+    console.log(display.markdown);
 }
 export function printRevisionSummary(round, revision) {
     console.log(`\n${chalk.bold(`Round ${round} Revision`)}`);

package/dist/src/cli/ui.js.map

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

package/dist/src/config/loader.d.ts

@@ -1,4 +1,9 @@
 import { type PlanpongConfig } from "../schemas/config.js";
+/**
+ * Reset the gemini-reviewer-warning gate. Test-only — the gate is a process-
+ * lifetime singleton in production so the warning fires exactly once.
+ */
+export declare function __resetGeminiReviewerWarningForTesting(): void;
 /**
  * Search upward from `cwd` for a config file path.
  * Returns the absolute path or null if no file is found.

package/dist/src/config/loader.js

@@ -3,6 +3,24 @@ import { join } from "node:path";
 import { parse as parseYaml } from "yaml";
 import { PlanpongConfigSchema, } from "../schemas/config.js";
 import { DEFAULT_CONFIG } from "./defaults.js";
+let geminiReviewerWarningFired = false;
+/**
+ * Reset the gemini-reviewer-warning gate. Test-only — the gate is a process-
+ * lifetime singleton in production so the warning fires exactly once.
+ */
+export function __resetGeminiReviewerWarningForTesting() {
+    geminiReviewerWarningFired = false;
+}
+function maybeEmitGeminiReviewerWarning(config) {
+    if (geminiReviewerWarningFired)
+        return;
+    if (config.reviewer.provider !== "gemini")
+        return;
+    geminiReviewerWarningFired = true;
+    process.stderr.write("warning: gemini reviewer rounds run without persistent session resumption.\n" +
+        "         expect noticeably slower per-round wall time than claude/codex.\n" +
+        "         tracked: see Future work in docs/plans/gemini-and-init-wizard.md\n");
+}
 const CONFIG_FILENAMES = [
     "planpong.yaml",
     "planpong.yml",
@@ -81,6 +99,8 @@ export function loadConfig(options) {
             fileConfig.planner_mode ??
             DEFAULT_CONFIG.planner_mode,
     };
-    return PlanpongConfigSchema.parse(merged);
+    const parsed = PlanpongConfigSchema.parse(merged);
+    maybeEmitGeminiReviewerWarning(parsed);
+    return parsed;
 }
 //# sourceMappingURL=loader.js.map

package/dist/src/config/loader.js.map

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

package/dist/src/config/mutate.d.ts

@@ -13,10 +13,36 @@ export interface SetConfigResult {
     after: unknown;
     created: boolean;
 }
+export interface BatchPick {
+    key: string;
+    rawValue: string;
+}
+export interface BatchPickResult {
+    key: string;
+    before: unknown;
+    after: unknown;
+}
+export interface SetConfigValuesBatchResult {
+    configPath: string;
+    created: boolean;
+    results: BatchPickResult[];
+}
 export declare function isValidKey(key: string): key is ValidKey;
 export declare function getValidKeys(): readonly string[];
 export declare function getKeyMetadata(): readonly KeyMeta[];
 export declare function getKeyMeta(key: string): KeyMeta | undefined;
+/**
+ * Apply many key/value picks to the project's planpong.yaml in one atomic
+ * write. Validates every pick (key allowlist, type coercion, merged-config
+ * schema) before any disk mutation, so a failing pick aborts the entire
+ * batch with the on-disk file byte-identical to its prior state.
+ *
+ * The single-key `setConfigValue` is a thin wrapper over this; the wizard
+ * flow calls this directly with all picks accumulated in memory.
+ */
+export declare function setConfigValuesBatch(cwd: string, picks: BatchPick[], opts?: {
+    dryRun?: boolean;
+}): SetConfigValuesBatchResult;
 export declare function setConfigValue(cwd: string, key: string, rawValue: string, opts?: {
     dryRun?: boolean;
 }): SetConfigResult;