@g-abhishek/gitx 0.1.1 → 0.1.4

package/dist/ai/openAiAi.js

@@ -0,0 +1,388 @@
+/**
+ * OpenAiAi — OpenAI Chat Completions API integration.
+ *
+ * Authentication: OPENAI_API_KEY env var or stored config key.
+ * Model:          defaults to gpt-4o. Override via GITX_AI_MODEL env var.
+ *
+ * All methods use the same structured JSON prompt pattern as ClaudeAi.
+ */
+import axios, { isAxiosError } from "axios";
+import { GitxError } from "../utils/errors.js";
+const OPENAI_API = "https://api.openai.com/v1/chat/completions";
+const DEFAULT_MODEL = "gpt-4o";
+const MAX_TOKENS = 4096;
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function getModel(override) {
+    return process.env["GITX_AI_MODEL"] ?? override ?? DEFAULT_MODEL;
+}
+async function callOpenAi(system, userPrompt, apiKey, model) {
+    const body = {
+        model,
+        max_tokens: MAX_TOKENS,
+        messages: [
+            { role: "system", content: system },
+            { role: "user", content: userPrompt },
+        ],
+    };
+    try {
+        const { data } = await axios.post(OPENAI_API, body, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            timeout: 60_000,
+        });
+        return data.choices[0]?.message?.content?.trim() ?? "";
+    }
+    catch (err) {
+        if (isAxiosError(err)) {
+            const status = err.response?.status;
+            const msg = err.response?.data?.error ??
+                err.message;
+            if (status === 401) {
+                throw new GitxError("OpenAI API authentication failed. Check OPENAI_API_KEY.", { exitCode: 1, cause: err });
+            }
+            if (status === 429) {
+                throw new GitxError("OpenAI rate limit exceeded. Wait a moment and retry.", { exitCode: 1, cause: err });
+            }
+            throw new GitxError(`OpenAI API error (${status ?? "network"}): ${String(msg)}`, { exitCode: 1, cause: err });
+        }
+        throw new GitxError(`Unexpected OpenAI error: ${String(err)}`, {
+            exitCode: 1,
+            cause: err,
+        });
+    }
+}
+function extractJson(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (fenced?.[1])
+        return fenced[1].trim();
+    const start = text.search(/[{[]/);
+    const endBrace = text.lastIndexOf("}");
+    const endBracket = text.lastIndexOf("]");
+    const end = Math.max(endBrace, endBracket);
+    if (start !== -1 && end !== -1 && end > start)
+        return text.slice(start, end + 1);
+    return text.trim();
+}
+function parseJson(text, fallback) {
+    try {
+        return JSON.parse(extractJson(text));
+    }
+    catch {
+        return fallback;
+    }
+}
+// ─── OpenAiAi ─────────────────────────────────────────────────────────────────
+export class OpenAiAi {
+    apiKey;
+    model;
+    /**
+     * @param apiKey  OpenAI API key. Falls back to OPENAI_API_KEY env var.
+     * @param model   Model override. Falls back to GITX_AI_MODEL then gpt-4o.
+     */
+    constructor(apiKey, model) {
+        const key = apiKey ?? process.env["OPENAI_API_KEY"];
+        if (!key) {
+            throw new GitxError("No OpenAI API key available. Run `gitx config set openai` or set OPENAI_API_KEY.", { exitCode: 2 });
+        }
+        this.apiKey = key;
+        this.model = getModel(model);
+    }
+    /** Check whether an OpenAI API key is available without instantiating. */
+    static isAvailable(key) {
+        return Boolean(key ?? process.env["OPENAI_API_KEY"]);
+    }
+    async analyzeTask(input) {
+        const system = `You are an expert software engineer. Analyze the given development task and respond with ONLY valid JSON matching this exact structure (no prose, no markdown):
+{
+  "task": "<the original task string>",
+  "intent": "<one of: refactor | bugfix | feature | chore | unknown>",
+  "summary": "<one sentence explaining what needs to be done>",
+  "assumptions": ["<assumption 1>", "<assumption 2>"],
+  "risks": ["<risk 1>", "<risk 2>"]
+}`;
+        const text = await callOpenAi(system, `Task: ${input}`, this.apiKey, this.model);
+        const parsed = parseJson(text, {});
+        return {
+            task: input,
+            intent: parsed.intent ?? "unknown",
+            summary: parsed.summary ?? "Unable to analyze task.",
+            assumptions: Array.isArray(parsed.assumptions) ? parsed.assumptions : [],
+            risks: Array.isArray(parsed.risks) ? parsed.risks : [],
+        };
+    }
+    async generatePlan(context) {
+        const ctx = context;
+        const taskDesc = ctx.task ?? "Unknown task";
+        const analysisSummary = ctx.analysis?.summary ?? "";
+        const fileList = ctx.repoFiles?.slice(0, 50).join("\n") ?? "(not provided)";
+        const fileContentsSection = ctx.fileContents && Object.keys(ctx.fileContents).length > 0
+            ? `\n\nRelevant file contents:\n${Object.entries(ctx.fileContents)
+                .map(([p, c]) => `--- ${p} ---\n${c}`)
+                .join("\n\n")}`
+            : "";
+        const system = `You are an expert software engineer creating a step-by-step implementation plan. Respond with ONLY valid JSON:
+{
+  "steps": [
+    { "id": "step-1", "title": "<short title>", "description": "<detailed description>" }
+  ]
+}
+Keep steps atomic and ordered. Each step should touch one logical concern.`;
+        const userPrompt = `Task: ${taskDesc}
+Analysis: ${analysisSummary}
+Repo files (top 50):
+${fileList}${fileContentsSection}`;
+        const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);
+        const parsed = parseJson(text, { steps: [] });
+        const steps = Array.isArray(parsed.steps) ? parsed.steps : [];
+        if (steps.length === 0) {
+            return { steps: [{ id: "step-1", title: "Analyze & implement", description: taskDesc }] };
+        }
+        return { steps };
+    }
+    async generateDiffs(step) {
+        const s = step;
+        const stepId = s.id ?? "step-1";
+        const fileContentsSection = s.fileContents && Object.keys(s.fileContents).length > 0
+            ? `\n\nCurrent file contents:\n${Object.entries(s.fileContents)
+                .map(([p, c]) => `--- ${p} ---\n${c}`)
+                .join("\n\n")}`
+            : "\n\n(No existing file contents — create new files as needed.)";
+        const system = `You are an expert software engineer. Generate unified diffs for the given implementation step.
+Respond with ONLY valid JSON:
+{
+  "stepId": "<step id>",
+  "diffs": [
+    {
+      "path": "<relative file path>",
+      "unifiedDiff": "<valid unified diff starting with --- a/path and +++ b/path>"
+    }
+  ]
+}
+
+Rules for unified diffs:
+- Start with: --- a/<path>\\n+++ b/<path>
+- Use @@ -<start>,<count> +<start>,<count> @@ context headers
+- Lines starting with ' ' are context (unchanged)
+- Lines starting with '-' are removed
+- Lines starting with '+' are added
+- For new files use: --- /dev/null\\n+++ b/<path>
+- Always include 3 lines of context around changes`;
+        const userPrompt = `Task: ${s.task ?? ""}
+Step ID: ${stepId}
+Step Title: ${s.title ?? ""}
+Step Description: ${s.description ?? ""}${fileContentsSection}`;
+        const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);
+        const parsed = parseJson(text, { stepId, diffs: [] });
+        return {
+            stepId,
+            diffs: Array.isArray(parsed.diffs) ? parsed.diffs : [],
+        };
+    }
+    async summarizeChanges(diff) {
+        const d = diff;
+        const diffContent = d.rawDiff ??
+            (d.diffs ?? [])
+                .flatMap((dr) => dr.diffs.map((f) => `File: ${f.path}\n${f.unifiedDiff}`))
+                .join("\n\n") ??
+            "(no diffs)";
+        const system = `You are a technical writer. Summarize code changes for a pull request. Respond with ONLY valid JSON:
+{
+  "summary": "<2-3 sentence plain-English summary of what changed and why>",
+  "filesChanged": [
+    { "path": "<file path>", "changeType": "<add | modify | delete>" }
+  ]
+}`;
+        const text = await callOpenAi(system, `Changes:\n${diffContent}`, this.apiKey, this.model);
+        const parsed = parseJson(text, {
+            summary: "",
+            filesChanged: [],
+        });
+        return {
+            summary: parsed.summary ?? "Code changes applied.",
+            filesChanged: Array.isArray(parsed.filesChanged) ? parsed.filesChanged : [],
+        };
+    }
+    async suggestFixes(comment) {
+        const c = comment;
+        const commentsText = (c.comments ?? [])
+            .map((co) => `[${co.author ?? "reviewer"}${co.path ? ` on ${co.path}:${co.line ?? ""}` : ""}]: ${co.body}`)
+            .join("\n\n");
+        const fileContentsSection = c.fileContents && Object.keys(c.fileContents).length > 0
+            ? `\n\nCurrent file contents:\n${Object.entries(c.fileContents)
+                .map(([p, content]) => `--- ${p} ---\n${content}`)
+                .join("\n\n")}`
+            : "";
+        const system = `You are an expert code reviewer suggesting fixes for pull request review comments. Respond with ONLY valid JSON:
+{
+  "suggestedEdits": [
+    {
+      "path": "<file path>",
+      "rationale": "<why this change addresses the comment>",
+      "unifiedDiff": "<valid unified diff>"
+    }
+  ]
+}
+If a comment doesn't require a code change, omit it from suggestedEdits.`;
+        const userPrompt = `PR Title: ${c.prTitle ?? ""}
+PR Body: ${c.prBody ?? ""}
+
+Review Comments:
+${commentsText}${fileContentsSection}`;
+        const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);
+        const parsed = parseJson(text, { suggestedEdits: [] });
+        return {
+            suggestedEdits: Array.isArray(parsed.suggestedEdits) ? parsed.suggestedEdits : [],
+        };
+    }
+    async reviewPR(context) {
+        const ctx = context;
+        const diffSection = ctx.diff
+            ? `\n\nDiff (unified):\n${ctx.diff.slice(0, 8000)}`
+            : "";
+        const commentsSection = ctx.comments && ctx.comments.length > 0
+            ? `\n\nExisting review comments:\n${ctx.comments
+                .map((c) => `[${c.author}${c.path ? ` @ ${c.path}` : ""}]: ${c.body}`)
+                .join("\n")}`
+            : "";
+        const system = `You are an expert code reviewer. Review the given pull request thoroughly and respond with ONLY valid JSON:
+{
+  "summary": "<2-4 sentence overall assessment>",
+  "issues": [
+    { "severity": "<critical|warning|suggestion>", "description": "<specific issue>", "file": "<optional file>", "line": null }
+  ],
+  "positives": ["<good thing 1>", "<good thing 2>"],
+  "verdict": "<approve|request_changes|comment>"
+}
+
+Severity guide:
+- critical: bugs, security issues, data loss risk
+- warning: code quality, performance, missing error handling
+- suggestion: style, naming, minor improvements`;
+        const userPrompt = `PR Title: ${ctx.prTitle ?? ""}
+PR Description: ${ctx.prBody ?? ""}${diffSection}${commentsSection}`;
+        const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);
+        const parsed = parseJson(text, {
+            summary: "",
+            issues: [],
+            positives: [],
+            verdict: "comment",
+        });
+        return {
+            summary: parsed.summary ?? "Review could not be generated.",
+            issues: Array.isArray(parsed.issues) ? parsed.issues : [],
+            positives: Array.isArray(parsed.positives) ? parsed.positives : [],
+            verdict: (["approve", "request_changes", "comment"].includes(parsed.verdict ?? ""))
+                ? parsed.verdict
+                : "comment",
+        };
+    }
+    async generatePrContent(commits, diff, stat) {
+        const system = `You are an expert software engineer writing pull request descriptions.
+You are given a list of commits on the branch and the unified diff of all changes.
+
+The input may contain:
+  - "=== Changed files (complete list) ===" — the full --stat summary of every file touched
+  - "=== Detailed diff ===" — the actual patch (may be truncated for large changesets)
+
+When a file list is present, use it as the authoritative source of ALL changed files.
+Do not ignore files that appear in the list but are absent from the truncated diff.
+
+Produce a clear, informative PR title and description:
+
+Rules:
+- title: short, human-readable, present-tense. No conventional-commit prefix. Max 72 chars.
+- body: 2-4 sentences describing WHAT changed and WHY. Cover ALL files from the list.
+  Plain English, no bullet points.
+
+Respond with ONLY valid JSON (no markdown fences):
+{"title":"<PR title>","body":"<PR description>"}`;
+        const commitList = commits.slice(0, 20).join("\n");
+        const diffSection = stat
+            ? `=== Changed files (complete list) ===\n${stat}\n\n=== Detailed diff ===\n${diff.slice(0, 16000)}`
+            : `Diff:\n${diff.slice(0, 16000)}`;
+        const userPrompt = `Commits on this branch:\n${commitList}\n\n${diffSection}`;
+        const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);
+        const parsed = parseJson(text, {});
+        return {
+            title: parsed.title?.trim() ?? "Update branch",
+            body: parsed.body?.trim() ?? "",
+        };
+    }
+    async resolveConflict(filePath, conflictContent) {
+        const system = `You are an expert software engineer resolving git merge conflicts.
+
+The file contains standard git conflict markers:
+  <<<<<<< HEAD  — changes on the current branch
+  =======       — separator
+  >>>>>>> theirs — incoming changes
+
+Your task:
+1. Understand BOTH sides of every conflict.
+2. Produce a single correct version preserving the intent of BOTH changes where possible.
+3. If the sides are genuinely contradictory, set confidence to "low".
+
+Rules:
+- Remove ALL conflict markers from the output.
+- Do NOT add explanatory comments.
+- Keep all non-conflicting code exactly as-is.
+- Output must be syntactically valid.
+
+Respond with ONLY valid JSON (no markdown fences):
+{"resolved":"<full resolved file content>","confidence":"high|low","explanation":"<one sentence>"}`;
+        const userPrompt = `File: ${filePath}\n\n${conflictContent.slice(0, 20000)}`;
+        const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);
+        const parsed = parseJson(text, {});
+        return {
+            resolved: parsed.resolved ?? conflictContent,
+            confidence: parsed.confidence === "low" ? "low" : "high",
+            explanation: parsed.explanation?.trim() ?? "Conflict resolved.",
+        };
+    }
+    async generateCommitMessage(diff) {
+        const system = `You are an expert software engineer writing git commit messages.
+You receive either a plain unified diff OR a structured input with:
+  - "=== Changed files (complete list) ===" — the full --stat summary of every file touched
+  - "=== Detailed diff ===" — the actual patch (may be truncated for large changesets)
+
+When a file list is present, use it as the authoritative source of ALL changes.
+Do not ignore files that appear in the list but are missing from the truncated diff.
+
+Produce ONE CONVENTIONAL COMMIT covering all the changes:
+
+Rules:
+- subject: "<type>(<scope>): <imperative description>"
+  - type: feat | fix | refactor | chore | docs | test | perf | ci | style | build
+  - scope: the primary area affected; omit if changes span many unrelated areas
+  - description: imperative mood, no period, 72 chars max for the whole subject line
+  - if several distinct features or fixes are present, pick the most impactful for the subject
+- body: cover EVERY significant change visible in the file list. For each distinct change,
+  one sentence on what was done and why. Plain English, no bullet lists, no repetition of the subject.
+
+Respond with ONLY valid JSON (no markdown fences):
+{"subject":"<subject line>","body":"<body covering all changes, or empty string>"}`;
+        const text = await callOpenAi(system, `Diff:\n${diff.slice(0, 20000)}`, this.apiKey, this.model);
+        const parsed = parseJson(text, {});
+        return {
+            subject: parsed.subject?.trim() ?? "chore: update files",
+            body: parsed.body?.trim() || undefined,
+        };
+    }
+    async reviewPRDetailed(context) {
+        const { buildSeniorReviewSystem, buildSeniorReviewPrompt, parseSeniorReview } = await import("./reviewHelpers.js");
+        const text = await callOpenAi(buildSeniorReviewSystem(), buildSeniorReviewPrompt(context), this.apiKey, this.model);
+        return parseSeniorReview(text);
+    }
+    async generateFix(context) {
+        const { buildFixSystem, buildFixPrompt, parseFixResponse } = await import("./reviewHelpers.js");
+        const text = await callOpenAi(buildFixSystem(), buildFixPrompt(context), this.apiKey, this.model);
+        return parseFixResponse(text, context.filePath, context.line);
+    }
+    async ask(question, context) {
+        const { buildAskSystem, buildAskPrompt, parseAskResponse } = await import("./reviewHelpers.js");
+        const text = await callOpenAi(buildAskSystem(), buildAskPrompt(question, context), this.apiKey, this.model);
+        return parseAskResponse(text);
+    }
+}
+//# sourceMappingURL=openAiAi.js.map

package/dist/ai/openAiAi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openAiAi.js","sourceRoot":"","sources":["../../src/ai/openAiAi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OpenAiAi — OpenAI Chat Completions API integration.\n *\n * Authentication: OPENAI_API_KEY env var or stored config key.\n * Model:          defaults to gpt-4o. Override via GITX_AI_MODEL env var.\n *\n * All methods use the same structured JSON prompt pattern as ClaudeAi.\n */\n\nimport axios, { isAxiosError } from \"axios\";\nimport { GitxError } from \"../utils/errors.js\";\nimport type {\n  AiAnalyzeTaskResponse,\n  AiClient,\n  AiGenerateDiffsResponse,\n  AiGeneratePlanResponse,\n  AiReviewPRResponse,\n  AiSuggestFixesResponse,\n  AiSummarizeChangesResponse,\n} from \"./types.js\";\n\nconst OPENAI_API = \"https://api.openai.com/v1/chat/completions\";\nconst DEFAULT_MODEL = \"gpt-4o\";\nconst MAX_TOKENS = 4096;\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction getModel(override?: string): string {\n  return process.env[\"GITX_AI_MODEL\"] ?? override ?? DEFAULT_MODEL;\n}\n\ninterface ChatMessage {\n  role: \"system\" | \"user\" | \"assistant\";\n  content: string;\n}\n\ninterface OpenAiRequestBody {\n  model: string;\n  max_tokens: number;\n  messages: ChatMessage[];\n}\n\ninterface OpenAiResponseBody {\n  choices: Array<{\n    message: { role: string; content: string };\n    finish_reason: string;\n  }>;\n}\n\nasync function callOpenAi(\n  system: string,\n  userPrompt: string,\n  apiKey: string,\n  model: string\n): Promise<string> {\n  const body: OpenAiRequestBody = {\n    model,\n    max_tokens: MAX_TOKENS,\n    messages: [\n      { role: \"system\", content: system },\n      { role: \"user\", content: userPrompt },\n    ],\n  };\n\n  try {\n    const { data } = await axios.post<OpenAiResponseBody>(OPENAI_API, body, {\n      headers: {\n        Authorization: `Bearer ${apiKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      timeout: 60_000,\n    });\n\n    return data.choices[0]?.message?.content?.trim() ?? \"\";\n  } catch (err) {\n    if (isAxiosError(err)) {\n      const status = err.response?.status;\n      const msg =\n        (err.response?.data as Record<string, unknown> | undefined)?.error ??\n        err.message;\n      if (status === 401) {\n        throw new GitxError(\n          \"OpenAI API authentication failed. Check OPENAI_API_KEY.\",\n          { exitCode: 1, cause: err }\n        );\n      }\n      if (status === 429) {\n        throw new GitxError(\n          \"OpenAI rate limit exceeded. Wait a moment and retry.\",\n          { exitCode: 1, cause: err }\n        );\n      }\n      throw new GitxError(\n        `OpenAI API error (${status ?? \"network\"}): ${String(msg)}`,\n        { exitCode: 1, cause: err }\n      );\n    }\n    throw new GitxError(`Unexpected OpenAI error: ${String(err)}`, {\n      exitCode: 1,\n      cause: err,\n    });\n  }\n}\n\nfunction extractJson(text: string): string {\n  const fenced = text.match(/```(?:json)?\\s*([\\s\\S]*?)```/);\n  if (fenced?.[1]) return fenced[1].trim();\n  const start = text.search(/[{[]/);\n  const endBrace = text.lastIndexOf(\"}\");\n  const endBracket = text.lastIndexOf(\"]\");\n  const end = Math.max(endBrace, endBracket);\n  if (start !== -1 && end !== -1 && end > start) return text.slice(start, end + 1);\n  return text.trim();\n}\n\nfunction parseJson<T>(text: string, fallback: T): T {\n  try {\n    return JSON.parse(extractJson(text)) as T;\n  } catch {\n    return fallback;\n  }\n}\n\n// ─── OpenAiAi ─────────────────────────────────────────────────────────────────\n\nexport class OpenAiAi implements AiClient {\n  private readonly apiKey: string;\n  private readonly model: string;\n\n  /**\n   * @param apiKey  OpenAI API key. Falls back to OPENAI_API_KEY env var.\n   * @param model   Model override. Falls back to GITX_AI_MODEL then gpt-4o.\n   */\n  constructor(apiKey?: string, model?: string) {\n    const key = apiKey ?? process.env[\"OPENAI_API_KEY\"];\n    if (!key) {\n      throw new GitxError(\n        \"No OpenAI API key available. Run `gitx config set openai` or set OPENAI_API_KEY.\",\n        { exitCode: 2 }\n      );\n    }\n    this.apiKey = key;\n    this.model = getModel(model);\n  }\n\n  /** Check whether an OpenAI API key is available without instantiating. */\n  static isAvailable(key?: string): boolean {\n    return Boolean(key ?? process.env[\"OPENAI_API_KEY\"]);\n  }\n\n  async analyzeTask(input: string): Promise<AiAnalyzeTaskResponse> {\n    const system = `You are an expert software engineer. Analyze the given development task and respond with ONLY valid JSON matching this exact structure (no prose, no markdown):\n{\n  \"task\": \"<the original task string>\",\n  \"intent\": \"<one of: refactor | bugfix | feature | chore | unknown>\",\n  \"summary\": \"<one sentence explaining what needs to be done>\",\n  \"assumptions\": [\"<assumption 1>\", \"<assumption 2>\"],\n  \"risks\": [\"<risk 1>\", \"<risk 2>\"]\n}`;\n\n    const text = await callOpenAi(system, `Task: ${input}`, this.apiKey, this.model);\n    const parsed = parseJson<Partial<AiAnalyzeTaskResponse>>(text, {});\n    return {\n      task: input,\n      intent: (parsed.intent as AiAnalyzeTaskResponse[\"intent\"]) ?? \"unknown\",\n      summary: parsed.summary ?? \"Unable to analyze task.\",\n      assumptions: Array.isArray(parsed.assumptions) ? parsed.assumptions : [],\n      risks: Array.isArray(parsed.risks) ? parsed.risks : [],\n    };\n  }\n\n  async generatePlan(context: unknown): Promise<AiGeneratePlanResponse> {\n    const ctx = context as {\n      task?: string;\n      analysis?: AiAnalyzeTaskResponse;\n      repoFiles?: string[];\n      fileContents?: Record<string, string>;\n    };\n\n    const taskDesc = ctx.task ?? \"Unknown task\";\n    const analysisSummary = ctx.analysis?.summary ?? \"\";\n    const fileList = ctx.repoFiles?.slice(0, 50).join(\"\\n\") ?? \"(not provided)\";\n    const fileContentsSection =\n      ctx.fileContents && Object.keys(ctx.fileContents).length > 0\n        ? `\\n\\nRelevant file contents:\\n${Object.entries(ctx.fileContents)\n            .map(([p, c]) => `--- ${p} ---\\n${c}`)\n            .join(\"\\n\\n\")}`\n        : \"\";\n\n    const system = `You are an expert software engineer creating a step-by-step implementation plan. Respond with ONLY valid JSON:\n{\n  \"steps\": [\n    { \"id\": \"step-1\", \"title\": \"<short title>\", \"description\": \"<detailed description>\" }\n  ]\n}\nKeep steps atomic and ordered. Each step should touch one logical concern.`;\n\n    const userPrompt = `Task: ${taskDesc}\nAnalysis: ${analysisSummary}\nRepo files (top 50):\n${fileList}${fileContentsSection}`;\n\n    const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);\n    const parsed = parseJson<Partial<AiGeneratePlanResponse>>(text, { steps: [] });\n    const steps = Array.isArray(parsed.steps) ? parsed.steps : [];\n\n    if (steps.length === 0) {\n      return { steps: [{ id: \"step-1\", title: \"Analyze & implement\", description: taskDesc }] };\n    }\n    return { steps };\n  }\n\n  async generateDiffs(step: unknown): Promise<AiGenerateDiffsResponse> {\n    const s = step as {\n      id?: string;\n      title?: string;\n      description?: string;\n      task?: string;\n      fileContents?: Record<string, string>;\n    };\n\n    const stepId = s.id ?? \"step-1\";\n    const fileContentsSection =\n      s.fileContents && Object.keys(s.fileContents).length > 0\n        ? `\\n\\nCurrent file contents:\\n${Object.entries(s.fileContents)\n            .map(([p, c]) => `--- ${p} ---\\n${c}`)\n            .join(\"\\n\\n\")}`\n        : \"\\n\\n(No existing file contents — create new files as needed.)\";\n\n    const system = `You are an expert software engineer. Generate unified diffs for the given implementation step.\nRespond with ONLY valid JSON:\n{\n  \"stepId\": \"<step id>\",\n  \"diffs\": [\n    {\n      \"path\": \"<relative file path>\",\n      \"unifiedDiff\": \"<valid unified diff starting with --- a/path and +++ b/path>\"\n    }\n  ]\n}\n\nRules for unified diffs:\n- Start with: --- a/<path>\\\\n+++ b/<path>\n- Use @@ -<start>,<count> +<start>,<count> @@ context headers\n- Lines starting with ' ' are context (unchanged)\n- Lines starting with '-' are removed\n- Lines starting with '+' are added\n- For new files use: --- /dev/null\\\\n+++ b/<path>\n- Always include 3 lines of context around changes`;\n\n    const userPrompt = `Task: ${s.task ?? \"\"}\nStep ID: ${stepId}\nStep Title: ${s.title ?? \"\"}\nStep Description: ${s.description ?? \"\"}${fileContentsSection}`;\n\n    const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);\n    const parsed = parseJson<Partial<AiGenerateDiffsResponse>>(text, { stepId, diffs: [] });\n    return {\n      stepId,\n      diffs: Array.isArray(parsed.diffs) ? parsed.diffs : [],\n    };\n  }\n\n  async summarizeChanges(diff: unknown): Promise<AiSummarizeChangesResponse> {\n    const d = diff as { diffs?: AiGenerateDiffsResponse[]; rawDiff?: string };\n    const diffContent =\n      d.rawDiff ??\n      (d.diffs ?? [])\n        .flatMap((dr) => dr.diffs.map((f) => `File: ${f.path}\\n${f.unifiedDiff}`))\n        .join(\"\\n\\n\") ??\n      \"(no diffs)\";\n\n    const system = `You are a technical writer. Summarize code changes for a pull request. Respond with ONLY valid JSON:\n{\n  \"summary\": \"<2-3 sentence plain-English summary of what changed and why>\",\n  \"filesChanged\": [\n    { \"path\": \"<file path>\", \"changeType\": \"<add | modify | delete>\" }\n  ]\n}`;\n\n    const text = await callOpenAi(system, `Changes:\\n${diffContent}`, this.apiKey, this.model);\n    const parsed = parseJson<Partial<AiSummarizeChangesResponse>>(text, {\n      summary: \"\",\n      filesChanged: [],\n    });\n    return {\n      summary: parsed.summary ?? \"Code changes applied.\",\n      filesChanged: Array.isArray(parsed.filesChanged) ? parsed.filesChanged : [],\n    };\n  }\n\n  async suggestFixes(comment: unknown): Promise<AiSuggestFixesResponse> {\n    const c = comment as {\n      comments?: Array<{ body: string; path?: string; line?: number; author?: string }>;\n      prTitle?: string;\n      prBody?: string;\n      fileContents?: Record<string, string>;\n    };\n\n    const commentsText = (c.comments ?? [])\n      .map(\n        (co) =>\n          `[${co.author ?? \"reviewer\"}${co.path ? ` on ${co.path}:${co.line ?? \"\"}` : \"\"}]: ${co.body}`\n      )\n      .join(\"\\n\\n\");\n\n    const fileContentsSection =\n      c.fileContents && Object.keys(c.fileContents).length > 0\n        ? `\\n\\nCurrent file contents:\\n${Object.entries(c.fileContents)\n            .map(([p, content]) => `--- ${p} ---\\n${content}`)\n            .join(\"\\n\\n\")}`\n        : \"\";\n\n    const system = `You are an expert code reviewer suggesting fixes for pull request review comments. Respond with ONLY valid JSON:\n{\n  \"suggestedEdits\": [\n    {\n      \"path\": \"<file path>\",\n      \"rationale\": \"<why this change addresses the comment>\",\n      \"unifiedDiff\": \"<valid unified diff>\"\n    }\n  ]\n}\nIf a comment doesn't require a code change, omit it from suggestedEdits.`;\n\n    const userPrompt = `PR Title: ${c.prTitle ?? \"\"}\nPR Body: ${c.prBody ?? \"\"}\n\nReview Comments:\n${commentsText}${fileContentsSection}`;\n\n    const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);\n    const parsed = parseJson<Partial<AiSuggestFixesResponse>>(text, { suggestedEdits: [] });\n    return {\n      suggestedEdits: Array.isArray(parsed.suggestedEdits) ? parsed.suggestedEdits : [],\n    };\n  }\n\n  async reviewPR(context: unknown): Promise<AiReviewPRResponse> {\n    const ctx = context as {\n      prTitle?: string;\n      prBody?: string;\n      diff?: string;\n      comments?: Array<{ body: string; author: string; path?: string }>;\n    };\n\n    const diffSection = ctx.diff\n      ? `\\n\\nDiff (unified):\\n${ctx.diff.slice(0, 8000)}`\n      : \"\";\n    const commentsSection =\n      ctx.comments && ctx.comments.length > 0\n        ? `\\n\\nExisting review comments:\\n${ctx.comments\n            .map((c) => `[${c.author}${c.path ? ` @ ${c.path}` : \"\"}]: ${c.body}`)\n            .join(\"\\n\")}`\n        : \"\";\n\n    const system = `You are an expert code reviewer. Review the given pull request thoroughly and respond with ONLY valid JSON:\n{\n  \"summary\": \"<2-4 sentence overall assessment>\",\n  \"issues\": [\n    { \"severity\": \"<critical|warning|suggestion>\", \"description\": \"<specific issue>\", \"file\": \"<optional file>\", \"line\": null }\n  ],\n  \"positives\": [\"<good thing 1>\", \"<good thing 2>\"],\n  \"verdict\": \"<approve|request_changes|comment>\"\n}\n\nSeverity guide:\n- critical: bugs, security issues, data loss risk\n- warning: code quality, performance, missing error handling\n- suggestion: style, naming, minor improvements`;\n\n    const userPrompt = `PR Title: ${ctx.prTitle ?? \"\"}\nPR Description: ${ctx.prBody ?? \"\"}${diffSection}${commentsSection}`;\n\n    const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);\n    const parsed = parseJson<Partial<AiReviewPRResponse>>(text, {\n      summary: \"\",\n      issues: [],\n      positives: [],\n      verdict: \"comment\",\n    });\n\n    return {\n      summary: parsed.summary ?? \"Review could not be generated.\",\n      issues: Array.isArray(parsed.issues) ? parsed.issues : [],\n      positives: Array.isArray(parsed.positives) ? parsed.positives : [],\n      verdict: ([\"approve\", \"request_changes\", \"comment\"].includes(parsed.verdict ?? \"\"))\n        ? (parsed.verdict as AiReviewPRResponse[\"verdict\"])\n        : \"comment\",\n    };\n  }\n\n  async generatePrContent(commits: string[], diff: string, stat?: string): Promise<import(\"./types.js\").AiPrContentResponse> {\n    const system = `You are an expert software engineer writing pull request descriptions.\nYou are given a list of commits on the branch and the unified diff of all changes.\n\nThe input may contain:\n  - \"=== Changed files (complete list) ===\" — the full --stat summary of every file touched\n  - \"=== Detailed diff ===\" — the actual patch (may be truncated for large changesets)\n\nWhen a file list is present, use it as the authoritative source of ALL changed files.\nDo not ignore files that appear in the list but are absent from the truncated diff.\n\nProduce a clear, informative PR title and description:\n\nRules:\n- title: short, human-readable, present-tense. No conventional-commit prefix. Max 72 chars.\n- body: 2-4 sentences describing WHAT changed and WHY. Cover ALL files from the list.\n  Plain English, no bullet points.\n\nRespond with ONLY valid JSON (no markdown fences):\n{\"title\":\"<PR title>\",\"body\":\"<PR description>\"}`;\n\n    const commitList = commits.slice(0, 20).join(\"\\n\");\n    const diffSection = stat\n      ? `=== Changed files (complete list) ===\\n${stat}\\n\\n=== Detailed diff ===\\n${diff.slice(0, 16000)}`\n      : `Diff:\\n${diff.slice(0, 16000)}`;\n    const userPrompt = `Commits on this branch:\\n${commitList}\\n\\n${diffSection}`;\n    const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);\n    const parsed = parseJson<Partial<import(\"./types.js\").AiPrContentResponse>>(text, {});\n    return {\n      title: parsed.title?.trim() ?? \"Update branch\",\n      body: parsed.body?.trim() ?? \"\",\n    };\n  }\n\n  async resolveConflict(filePath: string, conflictContent: string): Promise<import(\"./types.js\").AiConflictResolutionResponse> {\n    const system = `You are an expert software engineer resolving git merge conflicts.\n\nThe file contains standard git conflict markers:\n  <<<<<<< HEAD  — changes on the current branch\n  =======       — separator\n  >>>>>>> theirs — incoming changes\n\nYour task:\n1. Understand BOTH sides of every conflict.\n2. Produce a single correct version preserving the intent of BOTH changes where possible.\n3. If the sides are genuinely contradictory, set confidence to \"low\".\n\nRules:\n- Remove ALL conflict markers from the output.\n- Do NOT add explanatory comments.\n- Keep all non-conflicting code exactly as-is.\n- Output must be syntactically valid.\n\nRespond with ONLY valid JSON (no markdown fences):\n{\"resolved\":\"<full resolved file content>\",\"confidence\":\"high|low\",\"explanation\":\"<one sentence>\"}`;\n\n    const userPrompt = `File: ${filePath}\\n\\n${conflictContent.slice(0, 20000)}`;\n    const text = await callOpenAi(system, userPrompt, this.apiKey, this.model);\n    const parsed = parseJson<Partial<import(\"./types.js\").AiConflictResolutionResponse>>(text, {});\n    return {\n      resolved: parsed.resolved ?? conflictContent,\n      confidence: parsed.confidence === \"low\" ? \"low\" : \"high\",\n      explanation: parsed.explanation?.trim() ?? \"Conflict resolved.\",\n    };\n  }\n  async generateCommitMessage(diff: string): Promise<import(\"./types.js\").AiCommitMessageResponse> {\n    const system = `You are an expert software engineer writing git commit messages.\nYou receive either a plain unified diff OR a structured input with:\n  - \"=== Changed files (complete list) ===\" — the full --stat summary of every file touched\n  - \"=== Detailed diff ===\" — the actual patch (may be truncated for large changesets)\n\nWhen a file list is present, use it as the authoritative source of ALL changes.\nDo not ignore files that appear in the list but are missing from the truncated diff.\n\nProduce ONE CONVENTIONAL COMMIT covering all the changes:\n\nRules:\n- subject: \"<type>(<scope>): <imperative description>\"\n  - type: feat | fix | refactor | chore | docs | test | perf | ci | style | build\n  - scope: the primary area affected; omit if changes span many unrelated areas\n  - description: imperative mood, no period, 72 chars max for the whole subject line\n  - if several distinct features or fixes are present, pick the most impactful for the subject\n- body: cover EVERY significant change visible in the file list. For each distinct change,\n  one sentence on what was done and why. Plain English, no bullet lists, no repetition of the subject.\n\nRespond with ONLY valid JSON (no markdown fences):\n{\"subject\":\"<subject line>\",\"body\":\"<body covering all changes, or empty string>\"}`;\n\n    const text = await callOpenAi(system, `Diff:\\n${diff.slice(0, 20000)}`, this.apiKey, this.model);\n    const parsed = parseJson<Partial<import(\"./types.js\").AiCommitMessageResponse>>(text, {});\n    return {\n      subject: parsed.subject?.trim() ?? \"chore: update files\",\n      body: parsed.body?.trim() || undefined,\n    };\n  }\n\n  async reviewPRDetailed(\n    context: Parameters<import(\"./types.js\").AiClient[\"reviewPRDetailed\"]>[0]\n  ): Promise<import(\"./types.js\").AiDetailedReviewResponse> {\n    const { buildSeniorReviewSystem, buildSeniorReviewPrompt, parseSeniorReview } = await import(\"./reviewHelpers.js\");\n    const text = await callOpenAi(\n      buildSeniorReviewSystem(),\n      buildSeniorReviewPrompt(context),\n      this.apiKey,\n      this.model\n    );\n    return parseSeniorReview(text);\n  }\n\n  async generateFix(\n    context: Parameters<import(\"./types.js\").AiClient[\"generateFix\"]>[0]\n  ): Promise<import(\"./types.js\").AiFixResponse> {\n    const { buildFixSystem, buildFixPrompt, parseFixResponse } = await import(\"./reviewHelpers.js\");\n    const text = await callOpenAi(\n      buildFixSystem(),\n      buildFixPrompt(context),\n      this.apiKey,\n      this.model\n    );\n    return parseFixResponse(text, context.filePath, context.line);\n  }\n\n  async ask(\n    question: string,\n    context: import(\"./types.js\").AiAskContext\n  ): Promise<import(\"./types.js\").AiAskResponse> {\n    const { buildAskSystem, buildAskPrompt, parseAskResponse } = await import(\"./reviewHelpers.js\");\n    const text = await callOpenAi(buildAskSystem(), buildAskPrompt(question, context), this.apiKey, this.model);\n    return parseAskResponse(text);\n  }\n}\n"]}

package/dist/ai/reviewHelpers.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Shared helpers for the senior-developer PR review.
+ *
+ * buildSeniorReviewSystem()  — the AI system prompt
+ * buildSeniorReviewPrompt()  — formats the user-facing context block
+ * parseSeniorReview()        — safely parses the AI JSON response
+ */
+import type { AiAskContext, AiAskResponse, AiDetailedReviewResponse, AiFixResponse } from "./types.js";
+export declare function buildSeniorReviewSystem(): string;
+export declare function buildSeniorReviewPrompt(context: {
+    prTitle: string;
+    prBody: string;
+    author: string;
+    headBranch: string;
+    baseBranch: string;
+    diff: string;
+    changedFiles: Record<string, string>;
+    contextFiles: Record<string, string>;
+    repoFileList: string[];
+    existingComments: Array<{
+        author: string;
+        body: string;
+        path?: string;
+        line?: number;
+    }>;
+}): string;
+export declare function parseSeniorReview(text: string): AiDetailedReviewResponse;
+/**
+ * System prompt for the AI fix generator.
+ * Instructs the model to produce a minimal, targeted line-range replacement.
+ */
+export declare function buildFixSystem(): string;
+/**
+ * Build the user prompt for a single fix request.
+ * Includes the comment, file content with line numbers, and the relevant diff.
+ */
+export declare function buildFixPrompt(ctx: {
+    comment: string;
+    commentAuthor: string;
+    filePath: string;
+    line: number;
+    fileContent: string;
+    fileDiff: string;
+}): string;
+/**
+ * Safely parse the AI response for a fix request.
+ * Returns a safe fallback (isDiscussion + low confidence) on parse failure.
+ */
+export declare function parseFixResponse(text: string, filePath: string, line: number): AiFixResponse;
+/**
+ * Builds the system prompt for `gitx ask`.
+ * Includes the full command reference and setup guidance so the AI can answer
+ * both "how do I…" questions and "is X configured?" diagnostics.
+ */
+export declare function buildAskSystem(): string;
+/**
+ * Builds the user-turn prompt for `gitx ask`, injecting live repo context
+ * and the full gitx setup status so the AI can answer diagnostic questions accurately.
+ */
+export declare function buildAskPrompt(question: string, ctx: AiAskContext): string;
+/**
+ * Safely parses the AI JSON response for `gitx ask`.
+ * Falls back to using the raw text as the answer if JSON parsing fails.
+ */
+export declare function parseAskResponse(raw: string): AiAskResponse;
+//# sourceMappingURL=reviewHelpers.d.ts.map

package/dist/ai/reviewHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewHelpers.d.ts","sourceRoot":"","sources":["../../src/ai/reviewHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIvG,wBAAgB,uBAAuB,IAAI,MAAM,CAwChD;AAwJD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IACP,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzF,GACA,MAAM,CA6FR;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAkCxE;AAID;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAsBvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAgCT;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAgD5F;AAoCD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAgCvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAoE1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAa3D"}