@almightygpt/core 0.9.1 → 0.10.0

package/dist/auth/validator.js

@@ -13,14 +13,20 @@
  *   - Google:    tiny generateContent call against gemini-2.5-flash
  *
  * Cost is fractions of a cent per call. Latency is ~1-3 seconds.
- * Failure surfaces the provider's exact error message so the user
- * can fix it.
+ *
+ * **Error handling (per Codex v0.8 P2 #6):** failure responses are
+ * parsed into a short user-safe message + status code. We never
+ * return the raw provider body to the user — those bodies can include
+ * request IDs, billing/account state, org/project details, quota
+ * metadata, or other account information that's too noisy for CLI
+ * logs. The raw body is available via the `rawBody` field for callers
+ * that explicitly want it (e.g. debug mode).
+ *
+ * **Default models (per Codex v0.8 P2 #5):** sourced from
+ * `adapters/defaults.ts` — the single source of truth — so the
+ * validator can't drift from the adapters.
  */
-const DEFAULT_VALIDATION_MODELS = {
-    openai: "gpt-4o",
-    anthropic: "claude-sonnet-4-6",
-    google: "gemini-2.5-flash",
-};
+import { DEFAULT_MODELS } from "../adapters/defaults.js";
 const VALIDATION_TIMEOUT_MS = 15_000;
 /**
  * Validate that a key can actually invoke the model real reviews use.
@@ -28,25 +34,33 @@ const VALIDATION_TIMEOUT_MS = 15_000;
  * on programmer errors like an unsupported provider).
  */
 export async function validateKey(provider, key) {
+    const start = Date.now();
     try {
+        let result;
         switch (provider) {
             case "openai":
-                return await validateOpenAI(key);
+                result = await validateOpenAI(key);
+                break;
             case "anthropic":
-                return await validateAnthropic(key);
+                result = await validateAnthropic(key);
+                break;
             case "google":
-                return await validateGoogle(key);
+                result = await validateGoogle(key);
+                break;
         }
+        result.latencyMs = Date.now() - start;
+        return result;
     }
     catch (err) {
         return {
             ok: false,
-            error: err instanceof Error ? err.message : String(err),
+            error: friendlyNetworkError(err),
+            latencyMs: Date.now() - start,
         };
     }
 }
 async function validateOpenAI(key) {
-    const model = DEFAULT_VALIDATION_MODELS.openai;
+    const model = DEFAULT_MODELS.openai;
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), VALIDATION_TIMEOUT_MS);
     try {
@@ -64,7 +78,13 @@ async function validateOpenAI(key) {
             signal: controller.signal,
         });
         if (!res.ok) {
-            return { ok: false, error: await res.text().catch(() => res.statusText) };
+            const rawBody = await res.text().catch(() => "");
+            return {
+                ok: false,
+                statusCode: res.status,
+                error: normalizeOpenAIError(res.status, rawBody),
+                rawBody,
+            };
         }
         const data = (await res.json());
         return { ok: true, model: data.model ?? model };
@@ -74,7 +94,7 @@ async function validateOpenAI(key) {
     }
 }
 async function validateAnthropic(key) {
-    const model = DEFAULT_VALIDATION_MODELS.anthropic;
+    const model = DEFAULT_MODELS.anthropic;
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), VALIDATION_TIMEOUT_MS);
     try {
@@ -93,7 +113,13 @@ async function validateAnthropic(key) {
             signal: controller.signal,
         });
         if (!res.ok) {
-            return { ok: false, error: await res.text().catch(() => res.statusText) };
+            const rawBody = await res.text().catch(() => "");
+            return {
+                ok: false,
+                statusCode: res.status,
+                error: normalizeAnthropicError(res.status, rawBody),
+                rawBody,
+            };
         }
         const data = (await res.json());
         return { ok: true, model: data.model ?? model };
@@ -103,14 +129,11 @@ async function validateAnthropic(key) {
     }
 }
 async function validateGoogle(key) {
-    const model = DEFAULT_VALIDATION_MODELS.google;
+    const model = DEFAULT_MODELS.google;
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), VALIDATION_TIMEOUT_MS);
     try {
-        // Use x-goog-api-key header rather than ?key= URL parameter. URLs
-        // leak into proxy logs, HTTP tooling, crash diagnostics. The header
-        // path is supported by all v1beta endpoints. Codex's v0.8 security
-        // review flagged the URL-key approach as a P1.
+        // x-goog-api-key header (per v0.9.1 fix) — never the URL query.
         const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`;
         const res = await fetch(url, {
             method: "POST",
@@ -125,7 +148,13 @@ async function validateGoogle(key) {
             signal: controller.signal,
         });
         if (!res.ok) {
-            return { ok: false, error: await res.text().catch(() => res.statusText) };
+            const rawBody = await res.text().catch(() => "");
+            return {
+                ok: false,
+                statusCode: res.status,
+                error: normalizeGoogleError(res.status, rawBody, key),
+                rawBody,
+            };
         }
         return { ok: true, model };
     }
@@ -133,4 +162,80 @@ async function validateGoogle(key) {
         clearTimeout(timer);
     }
 }
+// ─── Error normalization (Codex v0.8 P2 #6) ──────────────────────────
+//
+// Parse known provider JSON error shapes into short, user-safe messages.
+// Never echo the raw key back even by accident (defense in depth: we
+// also redact anything that looks like the submitted key).
+function normalizeOpenAIError(status, rawBody) {
+    // OpenAI shape: { "error": { "message": "...", "type": "...", "code": "..." } }
+    try {
+        const parsed = JSON.parse(rawBody);
+        const msg = parsed.error?.message;
+        if (msg)
+            return `[${status}] OpenAI: ${truncate(msg, 200)}`;
+    }
+    catch {
+        /* fall through */
+    }
+    return statusOnlyMessage("OpenAI", status);
+}
+function normalizeAnthropicError(status, rawBody) {
+    // Anthropic shape: { "type": "error", "error": { "type": "...", "message": "..." } }
+    try {
+        const parsed = JSON.parse(rawBody);
+        const msg = parsed.error?.message;
+        if (msg)
+            return `[${status}] Anthropic: ${truncate(msg, 200)}`;
+    }
+    catch {
+        /* fall through */
+    }
+    return statusOnlyMessage("Anthropic", status);
+}
+function normalizeGoogleError(status, rawBody, submittedKey) {
+    // Google shape: { "error": { "code": N, "message": "...", "status": "..." } }
+    try {
+        const parsed = JSON.parse(rawBody);
+        let msg = parsed.error?.message ?? "";
+        // Belt-and-braces redaction: Google sometimes echoes the key in
+        // error messages (e.g. "API key not valid. Pass a valid API key.")
+        // — we don't ship the actual key value if it ever ends up here.
+        if (submittedKey && msg.includes(submittedKey)) {
+            msg = msg.replace(submittedKey, "<redacted-key>");
+        }
+        if (msg)
+            return `[${status}] Google: ${truncate(msg, 200)}`;
+    }
+    catch {
+        /* fall through */
+    }
+    return statusOnlyMessage("Google", status);
+}
+function statusOnlyMessage(provider, status) {
+    if (status === 401 || status === 403) {
+        return `[${status}] ${provider} rejected the key (unauthorized).`;
+    }
+    if (status === 429) {
+        return `[${status}] ${provider} rate-limited or quota exceeded.`;
+    }
+    if (status >= 500) {
+        return `[${status}] ${provider} returned a server error; try again.`;
+    }
+    return `[${status}] ${provider} returned an unrecognized error.`;
+}
+function truncate(s, n) {
+    return s.length <= n ? s : s.slice(0, n - 1) + "…";
+}
+function friendlyNetworkError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("abort")) {
+        return "Validation timed out (network or provider too slow).";
+    }
+    if (msg.includes("ENOTFOUND") || msg.includes("ECONNREFUSED")) {
+        return "Could not reach the provider (network issue).";
+    }
+    // Generic — but never include random stack data; just the message.
+    return `Network error: ${truncate(msg, 200)}`;
+}
 //# sourceMappingURL=validator.js.map

package/dist/auth/validator.js.map

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

package/dist/index.d.ts

@@ -12,7 +12,7 @@
  *   - review/     ✅ task #11 diff review pipeline (with #12/#13/#14 wiring)
  *   - budget/     ✅ task #14 BudgetTracker + BudgetExceededError
  */
-export declare const VERSION = "0.9.1";
+export declare const VERSION = "0.10.0";
 export { startMcpServer } from "./mcp/server.js";
 export { checkGitStatus, assertSafeToWrite, GitStatusDirtyError, type GitStatusCheck, } from "./git/status.js";
 export { installTemplate, hasExistingConfig, type InstallOptions, type InstallResult, } from "./templates/install.js";
@@ -34,5 +34,7 @@ export type { ReviewEvent, ReviewEventHandler, AgentRoleInRun, } from "./review/
 export { resolveApiKey, requireApiKey, type ResolveOptions, } from "./auth/resolver.js";
 export { getKeychain, _resetKeychainCache, type KeychainAdapter, } from "./auth/keychain.js";
 export { validateKey, type ValidationResult } from "./auth/validator.js";
+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, PROVIDER_KEY_URLS, type ProviderId, type KeySource, type KeyResolution, } from "./auth/types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,OAAO,WAAW,CAAC;AAGhC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -12,7 +12,7 @@
  *   - review/     ✅ task #11 diff review pipeline (with #12/#13/#14 wiring)
  *   - budget/     ✅ task #14 BudgetTracker + BudgetExceededError
  */
-export const VERSION = "0.9.1";
+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";
 // Git safety primitives
@@ -41,5 +41,8 @@ export { BudgetTracker, BudgetExceededError, } from "./review/budget.js";
 export { resolveApiKey, requireApiKey, } from "./auth/resolver.js";
 export { getKeychain, _resetKeychainCache, } from "./auth/keychain.js";
 export { validateKey } from "./auth/validator.js";
+// Plan subsystem (v0.10.0+) — Worker plan + Reviewer plan-review
+export { runWorkerPlan, } from "./plan/run-plan.js";
+export { runPlanReview, } from "./plan/run-plan-review.js";
 export { AuthMissingError, PROVIDER_ENV_VARS, PROVIDER_KEY_URLS, } from "./auth/types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,4EAA4E;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wBAAwB;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAEhC,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,WAAW;AACX,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,GAQd,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAA6C,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACP,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,GAIf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,GAGf,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,GAGxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAqC,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAO5B,2DAA2D;AAC3D,OAAO,EACL,aAAa,EACb,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAyB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAEhC,4EAA4E;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wBAAwB;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAEhC,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,WAAW;AACX,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,GAQd,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAA6C,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACP,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,GAIf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,GAGf,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,GAGxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAqC,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAO5B,2DAA2D;AAC3D,OAAO,EACL,aAAa,EACb,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAyB,MAAM,qBAAqB,CAAC;AACzE,iEAAiE;AACjE,OAAO,EACL,aAAa,GAGd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,GAGd,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,iBAAiB,CAAC"}

package/dist/plan/run-plan-review.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `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).
+ */
+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;
+}
+export declare function runPlanReview(opts: PlanReviewOptions): Promise<PlanReviewResult>;
+//# sourceMappingURL=run-plan-review.d.ts.map

package/dist/plan/run-plan-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-plan-review.d.ts","sourceRoot":"","sources":["../../src/plan/run-plan-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA+DD,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAgK3B"}

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

@@ -0,0 +1,224 @@
+/**
+ * `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";
+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, planContent) {
+    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) {
+    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;
+    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 = {
+        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 = {
+        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, requireConcreteWeaknesses) {
+    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;
+}
+//# sourceMappingURL=run-plan-review.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * `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).
+ */
+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;
+}
+export declare function runWorkerPlan(opts: PlanOptions): Promise<PlanResult>;
+//# sourceMappingURL=run-plan.d.ts.map

package/dist/plan/run-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-plan.d.ts","sourceRoot":"","sources":["../../src/plan/run-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AA6CD,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAoJ1E"}