planpong 0.5.6 → 0.6.0

package/dist/src/providers/gemini.d.ts

@@ -0,0 +1,58 @@
+import type { Provider, InvokeOptions, ProviderResponse, ProviderError } from "./types.js";
+/**
+ * Build argv for `gemini -p`. Pure function — no I/O.
+ *
+ * The `gemini` CLI's `-p/--prompt` flag requires a string value (the help text
+ * is misleading on this point). Per the CLI source, stdin content is appended
+ * to the `-p` argument, so passing `-p ""` plus a stdin pipe works the same as
+ * codex's `exec -` pattern: the model sees only the stdin content.
+ *
+ * `--skip-trust` bypasses the "trusted folder" gate added in gemini CLI 0.32.
+ * Without it, gemini exits 55 in any directory the user has not interactively
+ * acknowledged as trusted, which would block planpong runs in fresh repos,
+ * temp directories, and CI shells. The alternative escape hatch is the
+ * `GEMINI_CLI_TRUST_WORKSPACE=true` env var; we prefer the explicit flag so
+ * the contract is visible in process listings and not coupled to env state.
+ *
+ * Session resumption is not supported in v1 — `gemini --resume` accepts
+ * indices and `latest`, not UUIDs, so `newSessionId`/`resumeSessionId` are
+ * silently ignored. See the design doc at docs/plans/gemini-and-init-wizard.md
+ * (Future Work item #2) for the deferred follow-up.
+ */
+export declare function buildArgs(options: InvokeOptions): string[];
+export type ExtractResult = {
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    message: string;
+    code?: number;
+};
+/**
+ * Parse gemini's `--output-format json` envelope. Pure function.
+ *
+ * Envelope shape (verified against @google/gemini-cli@0.32 src/output/json-formatter.ts):
+ *   success: { session_id, response, stats }
+ *   error:   { session_id, error: { type, message, code } }
+ */
+export declare function extractResponse(stdout: string): ExtractResult;
+/**
+ * Classify a gemini invocation failure. v1 always returns `fatal` — gemini
+ * doesn't accept any structured-output flags so there is no capability axis
+ * to downgrade along.
+ */
+export declare function classifyError(stderr: string, exitCode: number): ProviderError;
+export declare class GeminiProvider implements Provider {
+    name: string;
+    invoke(prompt: string, options: InvokeOptions): Promise<ProviderResponse>;
+    isAvailable(): Promise<boolean>;
+    /**
+     * Always returns false in v1. Gemini's CLI does not expose a `--json-schema`
+     * or `--output-schema` flag, so structured-output mode is unavailable. See
+     * Future Work item #1 in docs/plans/gemini-and-init-wizard.md.
+     */
+    checkStructuredOutputSupport(): Promise<boolean>;
+    markNonCapable(): void;
+    getModels(): string[];
+    getEffortLevels(): string[];
+}

package/dist/src/providers/gemini.js

@@ -0,0 +1,169 @@
+import { execa } from "execa";
+import { assertMutuallyExclusiveSessions, logClassificationFailure, } from "./shared.js";
+const MODELS = ["gemini-2.5-pro", "gemini-3-pro", "gemini-2.5-flash"];
+/**
+ * Build argv for `gemini -p`. Pure function — no I/O.
+ *
+ * The `gemini` CLI's `-p/--prompt` flag requires a string value (the help text
+ * is misleading on this point). Per the CLI source, stdin content is appended
+ * to the `-p` argument, so passing `-p ""` plus a stdin pipe works the same as
+ * codex's `exec -` pattern: the model sees only the stdin content.
+ *
+ * `--skip-trust` bypasses the "trusted folder" gate added in gemini CLI 0.32.
+ * Without it, gemini exits 55 in any directory the user has not interactively
+ * acknowledged as trusted, which would block planpong runs in fresh repos,
+ * temp directories, and CI shells. The alternative escape hatch is the
+ * `GEMINI_CLI_TRUST_WORKSPACE=true` env var; we prefer the explicit flag so
+ * the contract is visible in process listings and not coupled to env state.
+ *
+ * Session resumption is not supported in v1 — `gemini --resume` accepts
+ * indices and `latest`, not UUIDs, so `newSessionId`/`resumeSessionId` are
+ * silently ignored. See the design doc at docs/plans/gemini-and-init-wizard.md
+ * (Future Work item #2) for the deferred follow-up.
+ */
+export function buildArgs(options) {
+    const args = ["-p", "", "--skip-trust", "--output-format", "json"];
+    if (options.model) {
+        args.push("-m", options.model);
+    }
+    return args;
+}
+/**
+ * Parse gemini's `--output-format json` envelope. Pure function.
+ *
+ * Envelope shape (verified against @google/gemini-cli@0.32 src/output/json-formatter.ts):
+ *   success: { session_id, response, stats }
+ *   error:   { session_id, error: { type, message, code } }
+ */
+export function extractResponse(stdout) {
+    let envelope;
+    try {
+        envelope = JSON.parse(stdout);
+    }
+    catch {
+        return {
+            ok: false,
+            message: "could not parse gemini JSON envelope",
+            code: undefined,
+        };
+    }
+    if (envelope === null || typeof envelope !== "object") {
+        return {
+            ok: false,
+            message: "could not parse gemini JSON envelope",
+            code: undefined,
+        };
+    }
+    const obj = envelope;
+    if (obj.error &&
+        typeof obj.error === "object" &&
+        obj.error !== null) {
+        const err = obj.error;
+        const message = typeof err.message === "string" ? err.message : "gemini reported error";
+        const code = typeof err.code === "number" ? err.code : undefined;
+        return { ok: false, message, code };
+    }
+    if (typeof obj.response === "string") {
+        return { ok: true, text: obj.response };
+    }
+    return {
+        ok: false,
+        message: "gemini envelope missing response and error fields",
+        code: undefined,
+    };
+}
+/**
+ * Classify a gemini invocation failure. v1 always returns `fatal` — gemini
+ * doesn't accept any structured-output flags so there is no capability axis
+ * to downgrade along.
+ */
+export function classifyError(stderr, exitCode) {
+    return {
+        kind: "fatal",
+        message: stderr.slice(0, 500) || `gemini exited with code ${exitCode}`,
+        exitCode,
+        stderr,
+    };
+}
+export class GeminiProvider {
+    name = "gemini";
+    async invoke(prompt, options) {
+        assertMutuallyExclusiveSessions(this.name, options);
+        const args = buildArgs(options);
+        const start = Date.now();
+        try {
+            const result = await execa("gemini", args, {
+                cwd: options.cwd,
+                preferLocal: true,
+                timeout: options.timeout ?? 600_000,
+                reject: false,
+                input: prompt,
+            });
+            const duration = Date.now() - start;
+            const exitCode = result.exitCode ?? 1;
+            const stdout = result.stdout ?? "";
+            if (stdout.trim().length > 0) {
+                const parsed = extractResponse(stdout);
+                if (parsed.ok) {
+                    return { ok: true, output: parsed.text, duration };
+                }
+                return {
+                    ok: false,
+                    error: {
+                        kind: "fatal",
+                        message: parsed.message,
+                        exitCode: parsed.code ?? exitCode,
+                        stderr: result.stderr,
+                    },
+                    duration,
+                };
+            }
+            logClassificationFailure(this.name, exitCode, result.stderr);
+            return {
+                ok: false,
+                error: classifyError(result.stderr ?? "", exitCode),
+                duration,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - start;
+            const message = error instanceof Error ? error.message : "Unknown error invoking gemini";
+            return {
+                ok: false,
+                error: { kind: "fatal", message, exitCode: 1 },
+                duration,
+            };
+        }
+    }
+    async isAvailable() {
+        try {
+            const result = await execa("gemini", ["--version"], {
+                preferLocal: true,
+                timeout: 5_000,
+                reject: false,
+            });
+            return result.exitCode === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Always returns false in v1. Gemini's CLI does not expose a `--json-schema`
+     * or `--output-schema` flag, so structured-output mode is unavailable. See
+     * Future Work item #1 in docs/plans/gemini-and-init-wizard.md.
+     */
+    async checkStructuredOutputSupport() {
+        return false;
+    }
+    markNonCapable() {
+        // No-op for symmetry with the other providers; v1 is permanently non-capable.
+    }
+    getModels() {
+        return MODELS;
+    }
+    getEffortLevels() {
+        return ["default"];
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/src/providers/gemini.js.map

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

package/dist/src/providers/registry.js

@@ -1,9 +1,15 @@
 import { ClaudeProvider } from "./claude.js";
 import { CodexProvider } from "./codex.js";
-const ALL_PROVIDERS = [new ClaudeProvider(), new CodexProvider()];
+import { GeminiProvider } from "./gemini.js";
+const ALL_PROVIDERS = [
+    new ClaudeProvider(),
+    new CodexProvider(),
+    new GeminiProvider(),
+];
 const INSTALL_HINTS = {
     claude: "Install Claude Code: npm install -g @anthropic-ai/claude-code (requires Anthropic API key or Max subscription)",
     codex: "Install Codex CLI: npm install -g @openai/codex (requires OpenAI API key)",
+    gemini: "Install Gemini CLI: npm install -g @google/gemini-cli, then run `gemini` once to complete Google account auth before invoking planpong.",
 };
 export async function getAvailableProviders() {
     const results = await Promise.all(ALL_PROVIDERS.map(async (p) => ({

package/dist/src/providers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/providers/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,aAAa,GAAe,CAAC,IAAI,cAAc,EAAE,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC;AAE9E,MAAM,aAAa,GAA2B;IAC5C,MAAM,EACJ,gHAAgH;IAClH,KAAK,EACH,2EAA2E;CAC9E,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9B,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE;KACjC,CAAC,CAAC,CACJ,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,OAAO,aAAa,CAAC,YAAY,CAAC,IAAI,gBAAgB,YAAY,OAAO,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/providers/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,aAAa,GAAe;IAChC,IAAI,cAAc,EAAE;IACpB,IAAI,aAAa,EAAE;IACnB,IAAI,cAAc,EAAE;CACrB,CAAC;AAEF,MAAM,aAAa,GAA2B;IAC5C,MAAM,EACJ,gHAAgH;IAClH,KAAK,EACH,2EAA2E;IAC7E,MAAM,EACJ,yIAAyI;CAC5I,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9B,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE;KACjC,CAAC,CAAC,CACJ,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,OAAO,aAAa,CAAC,YAAY,CAAC,IAAI,gBAAgB,YAAY,OAAO,CAAC;AAC5E,CAAC"}

package/dist/src/providers/shared.d.ts

@@ -0,0 +1,16 @@
+import type { InvokeOptions } from "./types.js";
+/**
+ * Reject the impossible state where a caller asks the provider to both
+ * initialize a fresh session AND resume an existing one. The operations-layer
+ * state machine never passes both today, so this is purely defensive — but
+ * all providers throw the same error so the parity is uniform.
+ */
+export declare function assertMutuallyExclusiveSessions(providerName: string, options: InvokeOptions): void;
+/**
+ * Emit a single-line debug breadcrumb when a provider invocation produces no
+ * usable output and is about to be classified as a failure. Matches the
+ * `[<provider>-provider] exit=<code> stderr=<truncated>` format originally
+ * added to the claude provider so triage logs read the same regardless of
+ * which CLI failed.
+ */
+export declare function logClassificationFailure(providerName: string, exitCode: number, stderr: string | undefined): void;

package/dist/src/providers/shared.js

@@ -0,0 +1,22 @@
+/**
+ * Reject the impossible state where a caller asks the provider to both
+ * initialize a fresh session AND resume an existing one. The operations-layer
+ * state machine never passes both today, so this is purely defensive — but
+ * all providers throw the same error so the parity is uniform.
+ */
+export function assertMutuallyExclusiveSessions(providerName, options) {
+    if (options.newSessionId && options.resumeSessionId) {
+        throw new Error(`${providerName} provider: newSessionId and resumeSessionId are mutually exclusive`);
+    }
+}
+/**
+ * Emit a single-line debug breadcrumb when a provider invocation produces no
+ * usable output and is about to be classified as a failure. Matches the
+ * `[<provider>-provider] exit=<code> stderr=<truncated>` format originally
+ * added to the claude provider so triage logs read the same regardless of
+ * which CLI failed.
+ */
+export function logClassificationFailure(providerName, exitCode, stderr) {
+    process.stderr.write(`[${providerName}-provider] exit=${exitCode} stderr=${stderr?.slice(0, 500) ?? ""}\n`);
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/providers/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/providers/shared.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,YAAoB,EACpB,OAAsB;IAEtB,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,GAAG,YAAY,oEAAoE,CACpF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAAoB,EACpB,QAAgB,EAChB,MAA0B;IAE1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,YAAY,mBAAmB,QAAQ,WAAW,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,CACtF,CAAC;AACJ,CAAC"}

package/dist/src/providers/types.d.ts

@@ -71,7 +71,7 @@ export interface Provider {
     /**
      * Probe the underlying CLI to determine whether structured output is
      * supported. Result is cached for the session lifetime. If the probe
-     * fails or times out, returns false (use legacy path).
+     * fails or times out, returns false (use prompted path).
      */
     checkStructuredOutputSupport(): Promise<boolean>;
     /**

package/dist/src/schemas/metrics.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export declare const InvocationAttemptSchema: z.ZodObject<{
-    mode: z.ZodEnum<["structured", "legacy"]>;
+    mode: z.ZodEffects<z.ZodEnum<["structured", "prompted"]>, "structured" | "prompted", unknown>;
     provider: z.ZodString;
     model: z.ZodNullable<z.ZodString>;
     effort: z.ZodNullable<z.ZodString>;
@@ -16,28 +16,28 @@ export declare const InvocationAttemptSchema: z.ZodObject<{
     provider: string;
     model: string | null;
     effort: string | null;
-    ok: boolean;
-    mode: "structured" | "legacy";
+    mode: "structured" | "prompted";
     prompt_chars: number;
     prompt_lines: number;
     output_chars: number | null;
     output_lines: number | null;
     duration_ms: number;
+    ok: boolean;
     error_kind: "capability" | "fatal" | "parse" | "zod" | "edit-retry" | null;
     error_exit_code: number | null;
 }, {
     provider: string;
     model: string | null;
     effort: string | null;
-    ok: boolean;
-    mode: "structured" | "legacy";
     prompt_chars: number;
     prompt_lines: number;
     output_chars: number | null;
     output_lines: number | null;
     duration_ms: number;
+    ok: boolean;
     error_kind: "capability" | "fatal" | "parse" | "zod" | "edit-retry" | null;
     error_exit_code: number | null;
+    mode?: unknown;
 }>;
 export declare const RoundMetricsSchema: z.ZodObject<{
     schema_version: z.ZodLiteral<1>;
@@ -49,7 +49,7 @@ export declare const RoundMetricsSchema: z.ZodObject<{
     completed_at: z.ZodString;
     total_duration_ms: z.ZodNumber;
     attempts: z.ZodArray<z.ZodObject<{
-        mode: z.ZodEnum<["structured", "legacy"]>;
+        mode: z.ZodEffects<z.ZodEnum<["structured", "prompted"]>, "structured" | "prompted", unknown>;
         provider: z.ZodString;
         model: z.ZodNullable<z.ZodString>;
         effort: z.ZodNullable<z.ZodString>;
@@ -65,28 +65,28 @@ export declare const RoundMetricsSchema: z.ZodObject<{
         provider: string;
         model: string | null;
         effort: string | null;
-        ok: boolean;
-        mode: "structured" | "legacy";
+        mode: "structured" | "prompted";
         prompt_chars: number;
         prompt_lines: number;
         output_chars: number | null;
         output_lines: number | null;
         duration_ms: number;
+        ok: boolean;
         error_kind: "capability" | "fatal" | "parse" | "zod" | "edit-retry" | null;
         error_exit_code: number | null;
     }, {
         provider: string;
         model: string | null;
         effort: string | null;
-        ok: boolean;
-        mode: "structured" | "legacy";
         prompt_chars: number;
         prompt_lines: number;
         output_chars: number | null;
         output_lines: number | null;
         duration_ms: number;
+        ok: boolean;
         error_kind: "capability" | "fatal" | "parse" | "zod" | "edit-retry" | null;
         error_exit_code: number | null;
+        mode?: unknown;
     }>, "many">;
     revision_mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<["full", "edits"]>>>;
     edits_attempted: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -109,13 +109,13 @@ export declare const RoundMetricsSchema: z.ZodObject<{
         provider: string;
         model: string | null;
         effort: string | null;
-        ok: boolean;
-        mode: "structured" | "legacy";
+        mode: "structured" | "prompted";
         prompt_chars: number;
         prompt_lines: number;
         output_chars: number | null;
         output_lines: number | null;
         duration_ms: number;
+        ok: boolean;
         error_kind: "capability" | "fatal" | "parse" | "zod" | "edit-retry" | null;
         error_exit_code: number | null;
     }[];
@@ -140,15 +140,15 @@ export declare const RoundMetricsSchema: z.ZodObject<{
         provider: string;
         model: string | null;
         effort: string | null;
-        ok: boolean;
-        mode: "structured" | "legacy";
         prompt_chars: number;
         prompt_lines: number;
         output_chars: number | null;
         output_lines: number | null;
         duration_ms: number;
+        ok: boolean;
         error_kind: "capability" | "fatal" | "parse" | "zod" | "edit-retry" | null;
         error_exit_code: number | null;
+        mode?: unknown;
     }[];
     revision_mode?: "edits" | "full" | null | undefined;
     planner_mode?: "external" | "inline" | undefined;

package/dist/src/schemas/metrics.js

@@ -1,6 +1,17 @@
 import { z } from "zod";
+// Schema-enforcement mode for a single provider invocation:
+// - "structured": output shape was constrained at the API level via the
+//   provider's schema flag (`--json-schema`, `--output-schema`).
+// - "prompted": output shape was requested through prompt instructions
+//   wrapped in `<planpong-feedback>` / `<planpong-revision>` tags, then
+//   extracted and parsed. Used when the provider lacks a schema flag
+//   (e.g., gemini) or after a structured-mode failure downgrades.
+//
+// Reads accept the historical name `"legacy"` and normalize it to
+// `"prompted"` so metrics files written before the rename still parse.
+const InvocationModeSchema = z.preprocess((value) => (value === "legacy" ? "prompted" : value), z.enum(["structured", "prompted"]));
 export const InvocationAttemptSchema = z.object({
-    mode: z.enum(["structured", "legacy"]),
+    mode: InvocationModeSchema,
     provider: z.string(),
     model: z.string().nullable(),
     effort: z.string().nullable(),
@@ -12,7 +23,7 @@ export const InvocationAttemptSchema = z.object({
     ok: z.boolean(),
     // `edit-retry` marks the targeted retry pass for failed edits in
     // edits-mode revisions. It is not a state-machine downgrade — the
-    // structured/legacy mode is captured in `mode` independently.
+    // structured/prompted mode is captured in `mode` independently.
     error_kind: z
         .enum(["capability", "fatal", "parse", "zod", "edit-retry"])
         .nullable(),

package/dist/src/schemas/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/schemas/metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/schemas/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4DAA4D;AAC5D,wEAAwE;AACxE,iEAAiE;AACjE,uEAAuE;AACvE,wEAAwE;AACxE,qEAAqE;AACrE,kEAAkE;AAClE,EAAE;AACF,kEAAkE;AAClE,uEAAuE;AACvE,MAAM,oBAAoB,GAAG,CAAC,CAAC,UAAU,CACvC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,EACpD,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,iEAAiE;IACjE,kEAAkE;IAClE,gEAAgE;IAChE,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;SAC3D,QAAQ,EAAE;IACb,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,2EAA2E;AAC3E,2EAA2E;AAC3E,sEAAsE;AACtE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACjD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACrE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACrE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,mEAAmE;IACnE,qEAAqE;IACrE,oEAAoE;IACpE,kEAAkE;IAClE,WAAW;IACX,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAiBH,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,iBAAiB;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;KAClC,CAAC;AACJ,CAAC"}

package/dist/src/schemas/session.d.ts

@@ -51,13 +51,13 @@ export declare const SessionSchema: z.ZodObject<{
         model?: string | undefined;
         effort?: string | undefined;
     };
-    plannerMode: "external" | "inline";
     repoRoot: string;
     planPath: string;
     planPathAbsolute: string;
     currentRound: number;
     startedAt: string;
     planHash: string;
+    plannerMode: "external" | "inline";
     initialLineCount?: number | undefined;
     reviewerSessionId?: string | undefined;
     reviewerSessionInitialized?: boolean | undefined;
@@ -80,9 +80,9 @@ export declare const SessionSchema: z.ZodObject<{
     currentRound: number;
     startedAt: string;
     planHash: string;
-    plannerMode?: "external" | "inline" | undefined;
     initialLineCount?: number | undefined;
     reviewerSessionId?: string | undefined;
     reviewerSessionInitialized?: boolean | undefined;
+    plannerMode?: "external" | "inline" | undefined;
 }>;
 export type Session = z.infer<typeof SessionSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planpong",
-  "version": "0.5.6",
+  "version": "0.6.0",
   "description": "Multi-model adversarial plan review — orchestrates AI agents to critique and refine implementation plans",
   "type": "module",
   "bin": {
@@ -28,7 +28,8 @@
     "adversarial",
     "ai-agents",
     "claude",
-    "codex"
+    "codex",
+    "gemini"
   ],
   "repository": {
     "type": "git",