gv-ai 1.0.0 → 1.1.0

package/.gv-ai/cron.log

@@ -0,0 +1,25 @@
+Error: Oh My Zsh can't be loaded from: . You need to run zsh instead.
+Here's the process tree:
+
+ PPID   PID COMMAND
+    1   520 /usr/sbin/cron
+  520 60485 /usr/sbin/cron
+60485 60486 /bin/sh -c /Users/souvikmahapatra/projects/gv-ai/.gv-ai/scripts/orchestrator.sh >> /Users/souvikmahapatra/projects/gv-ai/.gv-ai/cron.log 2>&1
+60486 60487 /bin/bash /Users/souvikmahapatra/projects/gv-ai/.gv-ai/scripts/orchestrator.sh
+
+/Users/souvikmahapatra/.zshrc: line 107: pyenv: command not found
+/Users/souvikmahapatra/.zshrc: line 112: pyenv: command not found
+/Users/souvikmahapatra/.zshrc: line 113: pyenv: command not found
+/Users/souvikmahapatra/.zshrc: line 123: autoload: command not found
+/Users/souvikmahapatra/.bun/_bun: line 922: syntax error near unexpected token `('
+/Users/souvikmahapatra/.bun/_bun: line 922: `    local -a packages_full_path=(${global_node_modules}/*(N))'
+/Users/souvikmahapatra/.bun/_bun: line 924: _alternative: command not found
+/Users/souvikmahapatra/.bun/_bun: line 925: syntax error near unexpected token `}'
+/Users/souvikmahapatra/.bun/_bun: line 925: `}'
+/Users/souvikmahapatra/projects/gv-ai/.gv-ai/scripts/orchestrator.sh: line 35: export: `  SENTRY_PROJECTS: tal ai prod tal ai stag=': not a valid identifier
+/Users/souvikmahapatra/projects/gv-ai/.gv-ai/scripts/orchestrator.sh: line 35: export: `  TELEGRAM_BOT_TOKEN: 7895808491:AAHWA31cob6g0oq1YPdLc2KjCXgFX4y6by0=': not a valid identifier
+/Users/souvikmahapatra/projects/gv-ai/.gv-ai/scripts/orchestrator.sh: line 35: export: `  TELEGRAM_CHAT_ID: 1827747473=': not a valid identifier
+🚀 Starting Sentry Resolver Run: 20260118-075502
+📂 Project Root: /Users/souvikmahapatra/projects/gv-ai
+🔍 Fetching issues...
+⚠️ No issues.json created. Check /Users/souvikmahapatra/projects/gv-ai/.gv-ai/runs/20260118-075502/fetcher.log

package/.gv-ai/env.json

@@ -0,0 +1,5 @@
+{
+  "SENTRY_PROJECTS": "tal ai prod, tal ai stag",
+  "TELEGRAM_BOT_TOKEN": "7895808491:AAHWA31cob6g0oq1YPdLc2KjCXgFX4y6by0",
+  "TELEGRAM_CHAT_ID": "1827747473"
+}

package/.gv-ai/opencode.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "sentry": {
+      "type": "remote",
+      "url": "https://mcp.sentry.dev/mcp",
+      "oauth": {}
+    },
+    "linear": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "mcp-remote",
+        "https://mcp.linear.app/sse"
+      ],
+      "enabled": true
+    }
+  },
+  "agent": {
+    "gv-fetcher": {
+      "prompt": "{file:prompts/fetcher.md}",
+      "tools": {
+        "sentry_find_organizations": true,
+        "sentry_find_projects": true,
+        "sentry_search_issues": true,
+        "write": true,
+        "read": true
+      }
+    },
+    "gv-rca": {
+      "prompt": "{file:prompts/rca.md}",
+      "tools": {
+        "sentry_find_organizations": true,
+        "sentry_get_issue_details": true,
+        "sentry_analyze_issue_with_seer": true,
+        "read": true,
+        "notify": true
+      }
+    },
+    "gv-fixer": {
+      "prompt": "{file:prompts/fixer.md}",
+      "tools": {
+        "edit": true,
+        "bash": true,
+        "read": true,
+        "write": true,
+        "notify": true
+      }
+    }
+  },
+  "permission": {
+    "bash": "allow",
+    "edit": "allow",
+    "write": "allow",
+    "read": "allow"
+  }
+}

package/.gv-ai/prompts/fetcher.md

@@ -0,0 +1,42 @@
+tools:
+  bash: false
+  write: true
+  edit: false
+  sentry_find_organizations: true
+  sentry_find_projects: true
+  sentry_search_events: false
+  sentry_search_issues: true
+---
+
+You are the **Issue Fetcher & Prioritizer Agent**.
+
+### TASK
+Your goal is to identify the most critical Sentry issues for the requested projects and save them for processing.
+
+### INSTRUCTIONS
+1.  **Identify Targets**:
+    *   You have been provided a list of **Sentry Projects** in the prompt.
+    *   Use your available Sentry tools to resolve the Organization and Project Slugs necessary to query them.
+2.  **Query Sentry**:
+    *   Search for unresolved issues (`is:unresolved level:error`) in these projects.
+    *   Limit: 20 issues per project.
+3.  **Prioritize**:
+    *   Score issues (0-100) based on User Count, Event Frequency, and Age.
+    *   Select the **Top 5** highest scoring issues.
+4.  **Output**:
+    *   Read `state.json` (if exists) and exclude IDs in `processed_ids`.
+    *   Write the filtered list to `issues.json` in the current directory.
+
+### OUTPUT FORMAT (issues.json)
+```json
+[
+  {
+    "id": "SENTRY-123",
+    "title": "Error Title",
+    "organization": "org-slug",
+    "project": "project-slug",
+    "priority_score": 95,
+    "reason": "High impact"
+  }
+]
+```

package/.gv-ai/prompts/fixer.md

@@ -0,0 +1,43 @@
+---
+description: Implement code fixes and create Pull Requests
+mode: primary
+tools:
+  bash: true
+  write: true
+  edit: true
+  read: true
+  notify: true
+---
+
+You are the **Fixer Agent**.
+
+### TASK
+Implement the fix proposed in the RCA and submit a Pull Request.
+
+### INPUT
+*   Read `rca.md` in the current directory.
+*   The current directory is `.gv-ai/runs/<timestamp>/<issue_id>/`.
+
+### INSTRUCTIONS
+1.  **Preparation**:
+    *   Read `rca.md` to understand the plan.
+    *   **Git**: Ensure you are on the base branch (usually `main` or `master`). Pull latest.
+    *   **Branch**: Create a new branch: `fix/sentry-<issue_id>-<timestamp>`.
+2.  **Implementation**:
+    *   Use `edit` to modify the code.
+    *   **Verify**: If possible, run a relevant test (or create a temporary test case) to ensure the fix works and doesn't break syntax.
+    *   **Lint**: Run `npm run lint` (or equivalent) if available.
+3.  **Commit & PR**:
+    *   `git commit -am "fix(sentry): Resolve <issue_id> - <brief description>"`
+    *   `git push -u origin <branch_name>`
+    *   Create PR using `gh pr create`:
+        *   Title: `fix: Resolve Sentry Issue <issue_id>`
+        *   Body: Include summary from `rca.md`.
+4.  **Notify**:
+    *   Use `notify` tool: "✅ *Fix Implemented* for [Issue ID]\nPR: [PR URL]"
+5.  **Artifact**:
+    *   Write `fix_result.json` with the PR URL and status.
+
+### CONSTRAINTS
+*   Do NOT change unrelated code.
+*   If you cannot verify the fix (e.g., tests fail), abort and notify with a clear error message.

package/.gv-ai/prompts/rca.md

@@ -0,0 +1,47 @@
+tools:
+  bash: true
+  write: true
+  edit: false
+  read: true
+  sentry_find_organizations: true
+  sentry_get_issue_details: true
+  sentry_get_issue_tag_values: true
+  sentry_analyze_issue_with_seer: true
+  notify: true
+---
+
+You are the **RCA (Root Cause Analysis) Agent**.
+
+### TASK
+Analyze the provided Sentry issue to determine the root cause and fixability.
+
+### INPUT
+*   **Issue ID** (e.g., `SENTRY-123`) provided in the prompt.
+*   **Context**: You are running in `.gv-ai/runs/<timestamp>/<issue_id>/`.
+
+### INSTRUCTIONS
+1.  **Analyze Issue**:
+    *   Use your tools (`sentry_get_issue_details`, `sentry_analyze_issue_with_seer`) to inspect the issue.
+    *   If you need the Organization slug and it wasn't provided, use your tools to find it.
+    *   **Verify Code**: Check the local codebase (`grep`/`read`) to confirm the file and line number from the stack trace exist.
+2.  **Determine Root Cause**:
+    *   Identify the logic error.
+    *   Assess **Fixability** (High/Medium/Low).
+3.  **Report**:
+    *   Write `rca.md` with your findings.
+4.  **Notify**:
+    *   Send a Telegram summary using the `notify` tool.
+
+### OUTPUT FORMAT (rca.md)
+```markdown
+# RCA: SENTRY-123
+## Root Cause
+...
+## Evidence
+...
+## Proposed Fix
+...
+## Assessment
+- **Confidence**: High/Medium/Low
+- **Action**: Fix / Ticket / Skip
+```

package/.gv-ai/runs/20260118-075502/fetcher.log

@@ -0,0 +1 @@
+/Users/souvikmahapatra/projects/gv-ai/.gv-ai/scripts/orchestrator.sh: line 55: opencode: command not found

package/.gv-ai/scripts/orchestrator.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Ensure we have a path (Cron often has limited path)
+export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:$PATH"
+
+# Try to source user profile for NVM/Node/etc
+if [ -f "$HOME/.bashrc" ]; then source "$HOME/.bashrc"; fi
+if [ -f "$HOME/.zshrc" ]; then source "$HOME/.zshrc"; fi
+if [ -f "$HOME/.profile" ]; then source "$HOME/.profile"; fi
+
+# Directory Setup
+# Resolve the directory where this script resides (.gv-ai/scripts)
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+# Base dir is parent of scripts (.gv-ai)
+BASE_DIR="$(dirname "$SCRIPT_DIR")"
+# Project Root is parent of .gv-ai
+PROJECT_ROOT="$(dirname "$BASE_DIR")"
+
+RUN_ID=$(date +%Y%m%d-%H%M%S)
+RUN_DIR="$BASE_DIR/runs/$RUN_ID"
+STATE_FILE="$BASE_DIR/state.json"
+ENV_FILE="$BASE_DIR/env.json"
+
+mkdir -p "$RUN_DIR"
+
+# Load Environment Variables from env.json
+if [ -f "$ENV_FILE" ]; then
+  # Simple parser for flat JSON string/number values
+  while IFS='=' read -r key value; do
+    # Remove quotes and comma
+    key=$(echo "$key" | tr -d '",')
+    value=$(echo "$value" | tr -d '",')
+    # Export if not empty
+    if [[ ! -z "$key" && "$key" != "{" && "$key" != "}" ]]; then
+      export "$key=$value"
+    fi
+  done < <(cat "$ENV_FILE" | grep ":")
+fi
+
+# Export Config Dir for OpenCode to find custom tools
+export OPENCODE_CONFIG_DIR="$BASE_DIR"
+
+echo "🚀 Starting Sentry Resolver Run: $RUN_ID"
+echo "📂 Project Root: $PROJECT_ROOT"
+
+# ---------------------------------------------------------
+# Phase 1: Fetch Issues
+# ---------------------------------------------------------
+echo "🔍 Fetching issues..."
+cd "$RUN_DIR" || exit 1
+
+# Run opencode from Project Root so it can access project files if needed
+cd "$PROJECT_ROOT" || exit 1
+
+opencode run \
+  --agent gv-fetcher \
+  --prompt "Fetch critical issues for projects: ${SENTRY_PROJECTS}. Write output to $RUN_DIR/issues.json" \
+  > "$RUN_DIR/fetcher.log" 2>&1
+
+if [ ! -f "$RUN_DIR/issues.json" ]; then
+  echo "⚠️ No issues.json created. Check $RUN_DIR/fetcher.log"
+  exit 0
+fi
+
+# ---------------------------------------------------------
+# Phase 2: Process Loop
+# ---------------------------------------------------------
+# Use node to parse the issues.json because bash JSON parsing is painful
+node -e "
+const fs = require('fs');
+const issues = JSON.parse(fs.readFileSync('$RUN_DIR/issues.json', 'utf8'));
+issues.forEach(issue => console.log(issue.id));
+" > "$RUN_DIR/issue_list.txt"
+
+while read -r ISSUE_ID; do
+  if [ -z "$ISSUE_ID" ]; then continue; fi
+  
+  echo "⚙️ Processing Issue: $ISSUE_ID"
+  ISSUE_DIR="$RUN_DIR/$ISSUE_ID"
+  mkdir -p "$ISSUE_DIR"
+  
+  # RCA Phase
+  echo "  - Running RCA..."
+  opencode run \
+    --agent gv-rca \
+    --prompt "Perform RCA for $ISSUE_ID. Working directory: $ISSUE_DIR" \
+    > "$ISSUE_DIR/rca.log" 2>&1
+    
+  if [ ! -f "$ISSUE_DIR/rca.md" ]; then
+    echo "  ⚠️ RCA failed to produce report."
+    continue
+  fi
+  
+  # Decision Check
+  # We look for 'Action: Fix' in the RCA markdown
+  ACTION=$(grep -i "Action:" "$ISSUE_DIR/rca.md" | head -n 1)
+  
+  if [[ "$ACTION" == *"Fix"* ]]; then
+    echo "  - Decision: FIX. Running Fixer..."
+    opencode run \
+      --agent gv-fixer \
+      --prompt "Fix $ISSUE_ID. RCA is at $ISSUE_DIR/rca.md" \
+      > "$ISSUE_DIR/fixer.log" 2>&1
+  else
+    echo "  - Decision: SKIP/TICKET ($ACTION)"
+  fi
+  
+  # Update State (Append to processed list)
+  # In a real impl, we'd read/write JSON properly. For now, we assume fetcher handles filtering.
+  # But we should append to a processed log.
+  echo "$ISSUE_ID processed at $(date)" >> "$BASE_DIR/processed_log.txt"
+  
+done < "$RUN_DIR/issue_list.txt"
+
+echo "✅ Run Complete."

package/.gv-ai/tool/notify.ts

@@ -0,0 +1,51 @@
+import { tool } from "@opencode-ai/plugin";
+
+export default tool({
+  description: "Send a notification via Telegram",
+  args: {
+    message: tool.schema.string().describe("The message to send"),
+  },
+  async execute(args) {
+    const fs = await import("fs/promises");
+    const path = await import("path");
+
+    // Load secrets from .gv-ai/env.json (this file is in .gv-ai/tool/)
+    const envPath = path.join(__dirname, "..", "env.json");
+
+    let config;
+    try {
+      const envContent = await fs.readFile(envPath, "utf-8");
+      config = JSON.parse(envContent);
+    } catch {
+      return "Error: Could not load .gv-ai/env.json";
+    }
+
+    const { TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID } = config;
+    if (!TELEGRAM_BOT_TOKEN || !TELEGRAM_CHAT_ID) {
+      return "Error: Telegram credentials missing in env.json";
+    }
+
+    const text = `🤖 *Tal Auto-Fixer*\n\n${args.message}`;
+
+    try {
+      const res = await fetch(
+        `https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            chat_id: TELEGRAM_CHAT_ID,
+            text,
+            parse_mode: "Markdown",
+          }),
+        }
+      );
+      const result = await res.json();
+      return result.ok
+        ? "Notification sent."
+        : `Telegram Error: ${result.description}`;
+    } catch (e: any) {
+      return `Network Error: ${e.message}`;
+    }
+  },
+});

package/dist/cli.js

@@ -5508,6 +5508,7 @@ var {
 var isUpKey = (key, keybindings = []) => key.name === "up" || keybindings.includes("vim") && key.name === "k" || keybindings.includes("emacs") && key.ctrl && key.name === "p";
 var isDownKey = (key, keybindings = []) => key.name === "down" || keybindings.includes("vim") && key.name === "j" || keybindings.includes("emacs") && key.ctrl && key.name === "n";
 var isSpaceKey = (key) => key.name === "space";
+var isBackspaceKey = (key) => key.name === "backspace";
 var isTabKey = (key) => key.name === "tab";
 var isNumberKey = (key) => "1234567890".includes(key.name);
 var isEnterKey = (key) => key.name === "enter" || key.name === "return";
@@ -6802,6 +6803,90 @@ var esm_default3 = createPrompt((config, done) => {
   const message = theme.style.message(config.message, status);
   return `${prefix} ${message}${defaultValue} ${formattedValue}`;
 });
+// node_modules/@inquirer/input/dist/esm/index.js
+var inputTheme = {
+  validationFailureMode: "keep"
+};
+var esm_default4 = createPrompt((config, done) => {
+  const { prefill = "tab" } = config;
+  const theme = makeTheme(inputTheme, config.theme);
+  const [status, setStatus] = useState("idle");
+  const [defaultValue = "", setDefaultValue] = useState(config.default);
+  const [errorMsg, setError] = useState();
+  const [value, setValue] = useState("");
+  const prefix = usePrefix({ status, theme });
+  async function validate(value2) {
+    const { required, pattern, patternError = "Invalid input" } = config;
+    if (required && !value2) {
+      return "You must provide a value";
+    }
+    if (pattern && !pattern.test(value2)) {
+      return patternError;
+    }
+    if (typeof config.validate === "function") {
+      return await config.validate(value2) || "You must provide a valid value";
+    }
+    return true;
+  }
+  useKeypress(async (key, rl) => {
+    if (status !== "idle") {
+      return;
+    }
+    if (isEnterKey(key)) {
+      const answer = value || defaultValue;
+      setStatus("loading");
+      const isValid = await validate(answer);
+      if (isValid === true) {
+        setValue(answer);
+        setStatus("done");
+        done(answer);
+      } else {
+        if (theme.validationFailureMode === "clear") {
+          setValue("");
+        } else {
+          rl.write(value);
+        }
+        setError(isValid);
+        setStatus("idle");
+      }
+    } else if (isBackspaceKey(key) && !value) {
+      setDefaultValue(undefined);
+    } else if (isTabKey(key) && !value) {
+      setDefaultValue(undefined);
+      rl.clearLine(0);
+      rl.write(defaultValue);
+      setValue(defaultValue);
+    } else {
+      setValue(rl.line);
+      setError(undefined);
+    }
+  });
+  useEffect((rl) => {
+    if (prefill === "editable" && defaultValue) {
+      rl.write(defaultValue);
+      setValue(defaultValue);
+    }
+  }, []);
+  const message = theme.style.message(config.message, status);
+  let formattedValue = value;
+  if (typeof config.transformer === "function") {
+    formattedValue = config.transformer(value, { isFinal: status === "done" });
+  } else if (status === "done") {
+    formattedValue = theme.style.answer(value);
+  }
+  let defaultStr;
+  if (defaultValue && status !== "done" && !value) {
+    defaultStr = theme.style.defaultAnswer(defaultValue);
+  }
+  let error = "";
+  if (errorMsg) {
+    error = theme.style.error(errorMsg);
+  }
+  return [
+    [prefix, message, defaultStr, formattedValue].filter((v) => v !== undefined).join(" "),
+    error
+  ];
+});
 // node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
 var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
@@ -14910,8 +14995,258 @@ Step 3: Creating instruction files...
   }
 }
 
+// src/commands/sentry-resolver.ts
+import fs3 from "fs/promises";
+import path8 from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+var __filename2 = fileURLToPath3(import.meta.url);
+var __dirname2 = path8.dirname(__filename2);
+async function sentryResolverInitCommand() {
+  console.log(source_default.bold.cyan(`
+\uD83D\uDEE1️  GV-AI Sentry Resolver Setup
+`));
+  console.log(source_default.dim(`This will configure an automated agent to triage and fix Sentry issues.
+`));
+  try {
+    const baseDir = path8.join(process.cwd(), ".gv-ai");
+    try {
+      await fs3.access(baseDir);
+      console.log(source_default.yellow(`
+⚠️  .gv-ai directory already exists.`));
+      const shouldOverwrite = await esm_default3({
+        message: "Do you want to overwrite the existing configuration? (This will reset env.json and prompts)",
+        default: false
+      });
+      if (!shouldOverwrite) {
+        console.log(source_default.yellow("Setup cancelled. Existing configuration preserved."));
+        return;
+      }
+    } catch {}
+    const sentryProjects = await esm_default4({ message: "Sentry Project Names (comma separated):" });
+    const telegramToken = await esm_default4({ message: "Telegram Bot Token:" });
+    const telegramChatId = await esm_default4({ message: "Telegram Chat ID:" });
+    const config = {
+      SENTRY_PROJECTS: sentryProjects,
+      TELEGRAM_BOT_TOKEN: telegramToken,
+      TELEGRAM_CHAT_ID: telegramChatId
+    };
+    const spinner = ora("Creating .gv-ai directory structure...").start();
+    await fs3.mkdir(path8.join(baseDir, "runs"), { recursive: true });
+    await fs3.mkdir(path8.join(baseDir, "scripts"), { recursive: true });
+    await fs3.mkdir(path8.join(baseDir, "prompts"), { recursive: true });
+    await fs3.mkdir(path8.join(baseDir, "tool"), { recursive: true });
+    await fs3.writeFile(path8.join(baseDir, "env.json"), JSON.stringify(config, null, 2));
+    spinner.succeed("Created .gv-ai/ and env.json");
+    const templateSpinner = ora("Copying templates...").start();
+    const templateDirCandidates = [
+      path8.join(__dirname2, "../templates/sentry-resolver"),
+      path8.join(__dirname2, "templates/sentry-resolver"),
+      path8.join(__dirname2, "../src/templates/sentry-resolver")
+    ];
+    let templateDir = "";
+    for (const dir of templateDirCandidates) {
+      try {
+        await fs3.access(dir);
+        templateDir = dir;
+        break;
+      } catch {}
+    }
+    if (!templateDir) {
+      throw new Error(`Could not locate templates. Searched: ${templateDirCandidates.join(", ")}`);
+    }
+    await fs3.copyFile(path8.join(templateDir, "prompts/fetcher.md"), path8.join(baseDir, "prompts/fetcher.md"));
+    await fs3.copyFile(path8.join(templateDir, "prompts/rca.md"), path8.join(baseDir, "prompts/rca.md"));
+    await fs3.copyFile(path8.join(templateDir, "prompts/fixer.md"), path8.join(baseDir, "prompts/fixer.md"));
+    await fs3.copyFile(path8.join(templateDir, "scripts/orchestrator.sh"), path8.join(baseDir, "scripts/orchestrator.sh"));
+    await fs3.chmod(path8.join(baseDir, "scripts/orchestrator.sh"), 493);
+    await fs3.copyFile(path8.join(templateDir, "tool/notify.ts.template"), path8.join(baseDir, "tool/notify.ts"));
+    templateSpinner.succeed("Templates copied");
+    const configSpinner = ora("Generating bot configuration...").start();
+    const botConfig = {
+      $schema: "https://opencode.ai/config.json",
+      mcp: {
+        sentry: {
+          type: "remote",
+          url: "https://mcp.sentry.dev/mcp",
+          oauth: {}
+        },
+        linear: {
+          type: "local",
+          command: ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse"],
+          enabled: true
+        }
+      },
+      agent: {
+        "gv-fetcher": {
+          prompt: "{file:prompts/fetcher.md}",
+          tools: {
+            sentry_find_organizations: true,
+            sentry_find_projects: true,
+            sentry_search_issues: true,
+            write: true,
+            read: true
+          }
+        },
+        "gv-rca": {
+          prompt: "{file:prompts/rca.md}",
+          tools: {
+            sentry_find_organizations: true,
+            sentry_get_issue_details: true,
+            sentry_analyze_issue_with_seer: true,
+            read: true,
+            notify: true
+          }
+        },
+        "gv-fixer": {
+          prompt: "{file:prompts/fixer.md}",
+          tools: {
+            edit: true,
+            bash: true,
+            read: true,
+            write: true,
+            notify: true
+          }
+        }
+      },
+      permission: {
+        bash: "allow",
+        edit: "allow",
+        write: "allow",
+        read: "allow"
+      }
+    };
+    await fs3.writeFile(path8.join(baseDir, "opencode.json"), JSON.stringify(botConfig, null, 2));
+    configSpinner.succeed("Bot configuration generated (.gv-ai/opencode.json)");
+    const cronSpinner = ora("Setting up cron job...").start();
+    const scriptPath = path8.join(baseDir, "scripts/orchestrator.sh");
+    const cronSchedule = "0 */4 * * *";
+    const cronJob = `${cronSchedule} ${scriptPath} >> ${path8.join(baseDir, "cron.log")} 2>&1`;
+    try {
+      let currentCrontab = "";
+      try {
+        const { stdout } = await execa("crontab", ["-l"]);
+        currentCrontab = stdout;
+      } catch (e) {}
+      if (!currentCrontab.includes(scriptPath)) {
+        const newCrontab = currentCrontab + (currentCrontab ? `
+` : "") + cronJob + `
+`;
+        await execa("sh", ["-c", `echo "${newCrontab}" | crontab -`]);
+        cronSpinner.succeed("Cron job registered");
+      } else {
+        cronSpinner.info("Cron job already exists");
+      }
+    } catch (e) {
+      cronSpinner.warn(`Failed to set crontab: ${e.message}. You may need to add it manually.`);
+      console.log(source_default.dim(`Manual entry: ${cronJob}`));
+    }
+    try {
+      const gitignorePath = path8.join(process.cwd(), ".gitignore");
+      const gitignore = await fs3.readFile(gitignorePath, "utf-8").catch(() => "");
+      const entry = `
+# GV-AI Automation
+.gv-ai/`;
+      if (!gitignore.includes(".gv-ai")) {
+        await fs3.appendFile(gitignorePath, entry + `
+`);
+        console.log(source_default.green("Added .gv-ai/ to .gitignore"));
+      }
+    } catch (e) {}
+    console.log(source_default.bold.green(`
+✅ Initialization Complete!`));
+    console.log(source_default.dim(`
+    - Config: .gv-ai/env.json
+    - Logs:   .gv-ai/runs/
+    - Cron:   Runs every 5 minutes
+    
+    To test manually:
+    $ .gv-ai/scripts/orchestrator.sh
+    `));
+  } catch (error) {
+    console.error(source_default.red(`
+❌ Error: ${error.message}`));
+    process.exit(1);
+  }
+}
+async function sentryResolverCronSetCommand(value) {
+  const baseDir = path8.join(process.cwd(), ".gv-ai");
+  const scriptPath = path8.join(baseDir, "scripts/orchestrator.sh");
+  const cronRegex = /^(@(annually|yearly|monthly|weekly|daily|hourly|reboot))|(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)$/;
+  let cronSchedule = "";
+  if (value.endsWith("m")) {
+    const mins = parseInt(value.slice(0, -1));
+    if (isNaN(mins) || mins < 1 || mins > 59) {
+      console.error(source_default.red(`❌ Invalid minutes: ${value}. Use format: 5m, 10m, 30m`));
+      process.exit(1);
+    }
+    cronSchedule = `*/${mins} * * * *`;
+  } else if (value.endsWith("h")) {
+    const hours = parseInt(value.slice(0, -1));
+    if (isNaN(hours) || hours < 1 || hours > 23) {
+      console.error(source_default.red(`❌ Invalid hours: ${value}. Use format: 1h, 4h, 12h`));
+      process.exit(1);
+    }
+    cronSchedule = `0 */${hours} * * *`;
+  } else if (cronRegex.test(value)) {
+    cronSchedule = value;
+  } else {
+    console.error(source_default.red(`❌ Invalid format. Use: 5m, 2h, or cron expression`));
+    process.exit(1);
+  }
+  console.log(source_default.cyan(`
+⏰ Setting cron to: ${cronSchedule}`));
+  try {
+    let currentCrontab = "";
+    try {
+      const { stdout } = await execa("crontab", ["-l"]);
+      currentCrontab = stdout;
+    } catch {}
+    const cleanedCrontab = currentCrontab.split(`
+`).filter((line) => !line.includes(scriptPath)).join(`
+`);
+    const cronJob = `${cronSchedule} ${scriptPath} >> ${path8.join(baseDir, "cron.log")} 2>&1`;
+    const newCrontab = (cleanedCrontab ? cleanedCrontab + `
+` : "") + cronJob + `
+`;
+    await execa("sh", ["-c", `echo "${newCrontab}" | crontab -`]);
+    console.log(source_default.green("✅ Cron job updated!"));
+  } catch (e) {
+    console.error(source_default.red(`❌ Failed to update cron: ${e.message}`));
+    process.exit(1);
+  }
+}
+async function sentryResolverCronDisableCommand() {
+  const baseDir = path8.join(process.cwd(), ".gv-ai");
+  const scriptPath = path8.join(baseDir, "scripts/orchestrator.sh");
+  console.log(source_default.cyan(`
+\uD83D\uDED1 Disabling cron job...`));
+  try {
+    let currentCrontab = "";
+    try {
+      const { stdout } = await execa("crontab", ["-l"]);
+      currentCrontab = stdout;
+    } catch {}
+    if (!currentCrontab.includes(scriptPath)) {
+      console.log(source_default.yellow("Cron job not found."));
+      return;
+    }
+    const cleanedCrontab = currentCrontab.split(`
+`).filter((line) => !line.includes(scriptPath)).join(`
+`);
+    await execa("sh", ["-c", `echo "${cleanedCrontab}" | crontab -`]);
+    console.log(source_default.green("✅ Cron job disabled!"));
+  } catch (e) {
+    console.error(source_default.red(`❌ Failed to disable cron: ${e.message}`));
+    process.exit(1);
+  }
+}
+
 // src/cli.ts
 var program2 = new Command;
 program2.name("gv-ai").description("CLI tool to enforce Linear ticket tracking across AI coding tools").version("1.0.0");
 program2.command("project").description("Manage project configuration").command("init").description("Initialize GV AI project setup").action(initCommand);
+var sentryResolver = program2.command("sentry-resolver").description("Manage Sentry automated resolution");
+sentryResolver.command("init").description("Initialize Sentry Resolver bot").action(sentryResolverInitCommand);
+sentryResolver.command("cron").description("Manage cron schedule").command("set <interval>").description('Set cron interval (e.g., 5m, 2h, "*/10 * * * *")').action((interval) => sentryResolverCronSetCommand(interval));
+sentryResolver.command("disable").description("Disable the cron job").action(sentryResolverCronDisableCommand);
 program2.parse();

package/dist/commands/sentry-resolver.d.ts

@@ -0,0 +1,4 @@
+export declare function sentryResolverInitCommand(): Promise<void>;
+export declare function sentryResolverCronSetCommand(value: string): Promise<void>;
+export declare function sentryResolverCronDisableCommand(): Promise<void>;
+//# sourceMappingURL=sentry-resolver.d.ts.map

package/dist/commands/sentry-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry-resolver.d.ts","sourceRoot":"","sources":["../../src/commands/sentry-resolver.ts"],"names":[],"mappings":"AAWA,wBAAsB,yBAAyB,kBAkO9C;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,MAAM,iBAuD/D;AAED,wBAAsB,gCAAgC,kBA6BrD"}

package/dist/commands/show-template.d.ts

@@ -0,0 +1,2 @@
+export declare function showTemplateCommand(): Promise<void>;
+//# sourceMappingURL=show-template.d.ts.map

package/dist/commands/show-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-template.d.ts","sourceRoot":"","sources":["../../src/commands/show-template.ts"],"names":[],"mappings":"AAEA,wBAAsB,mBAAmB,kBAExC"}

package/dist/templates/agents-md.ts

@@ -0,0 +1,91 @@
+export const AGENTS_MD_TEMPLATE = `# AGENTS.md
+
+## Linear Ticket Enforcement
+
+**CRITICAL**: Before making ANY code changes (editing files, creating files, running commands that modify state), you MUST have a confirmed Linear ticket.
+
+### Pre-Implementation Gate
+
+When the user requests implementation work:
+
+1. **Ask what they're working on** (if not clear from context)
+2. **Search Linear for relevant tickets** using Linear MCP tools
+3. **Fetch all Linear projects** to show available options
+4. **Present a numbered list** to the user:
+
+   \`\`\`
+   Found potential matches:
+   1. [PROJ-123]: Ticket title here
+   2. [PROJ-456]: Another ticket title
+
+   Or create new ticket in:
+   3. Backend API (BACK)
+   4. Platform Infrastructure (PLAT)
+   5. Mobile App (MOB)
+
+   Which one? (enter number)
+   \`\`\`
+
+5. **Wait for user to select a number**
+6. **Confirm the selection** before proceeding with any implementation
+
+### Free Actions (No Ticket Required)
+
+You may freely help with:
+- Answering questions about code
+- Explaining how code works
+- Discussing approaches and solutions
+- Debugging and analysis (without making changes)
+- Code review and suggestions
+- General brainstorming
+
+### Gated Actions (Ticket Required)
+
+You MUST have a confirmed Linear ticket before:
+- Creating new files
+- Editing existing files
+- Running commands that modify state (git commits, npm install, etc.)
+- Creating branches or pull requests
+- Deploying or publishing
+
+### During Implementation
+
+Once a ticket is confirmed:
+- Update the Linear ticket with progress comments as you work
+- Set ticket status to "In Progress" when starting
+- Link commits and branches to the ticket
+- Keep the ticket updated with any blockers or decisions
+
+### PR Creation
+
+When creating a pull request:
+- Use Linear's branch naming convention (if available)
+- Automatically link the PR to the associated ticket
+- Update the ticket status to "In Review"
+- Add a comment to the ticket with the PR link
+
+### Multi-Ticket Sessions
+
+If work touches multiple features or areas:
+- Identify all relevant tickets at the start
+- Confirm with the user which tickets to track
+- Update each ticket appropriately as you work on related code
+- Keep tickets in sync with the work being done
+
+### Ad-hoc Tickets
+
+When creating a new ad-hoc ticket:
+- Ask the user which Linear project to create it in
+- Use the user's description as the ticket title
+- Automatically add an "ad-hoc" label
+- Assign the ticket to the current user (if possible)
+- Set the status to "In Progress"
+
+### Important Notes
+
+- **Always confirm** before associating work with a ticket
+- **Never guess** which ticket applies - always ask the user
+- **Show ticket details** (title, description preview) when asking for confirmation
+- **Handle errors gracefully** if Linear API is unavailable
+- **Be patient** - the user may need time to find the right ticket
+`;

package/dist/templates/sentry-resolver/prompts/fetcher.md

@@ -0,0 +1,42 @@
+tools:
+  bash: false
+  write: true
+  edit: false
+  sentry_find_organizations: true
+  sentry_find_projects: true
+  sentry_search_events: false
+  sentry_search_issues: true
+---
+
+You are the **Issue Fetcher & Prioritizer Agent**.
+
+### TASK
+Your goal is to identify the most critical Sentry issues for the requested projects and save them for processing.
+
+### INSTRUCTIONS
+1.  **Identify Targets**:
+    *   You have been provided a list of **Sentry Projects** in the prompt.
+    *   Use your available Sentry tools to resolve the Organization and Project Slugs necessary to query them.
+2.  **Query Sentry**:
+    *   Search for unresolved issues (`is:unresolved level:error`) in these projects.
+    *   Limit: 20 issues per project.
+3.  **Prioritize**:
+    *   Score issues (0-100) based on User Count, Event Frequency, and Age.
+    *   Select the **Top 5** highest scoring issues.
+4.  **Output**:
+    *   Read `state.json` (if exists) and exclude IDs in `processed_ids`.
+    *   Write the filtered list to `issues.json` in the current directory.
+
+### OUTPUT FORMAT (issues.json)
+```json
+[
+  {
+    "id": "SENTRY-123",
+    "title": "Error Title",
+    "organization": "org-slug",
+    "project": "project-slug",
+    "priority_score": 95,
+    "reason": "High impact"
+  }
+]
+```

package/dist/templates/sentry-resolver/prompts/fixer.md

@@ -0,0 +1,43 @@
+---
+description: Implement code fixes and create Pull Requests
+mode: primary
+tools:
+  bash: true
+  write: true
+  edit: true
+  read: true
+  notify: true
+---
+
+You are the **Fixer Agent**.
+
+### TASK
+Implement the fix proposed in the RCA and submit a Pull Request.
+
+### INPUT
+*   Read `rca.md` in the current directory.
+*   The current directory is `.gv-ai/runs/<timestamp>/<issue_id>/`.
+
+### INSTRUCTIONS
+1.  **Preparation**:
+    *   Read `rca.md` to understand the plan.
+    *   **Git**: Ensure you are on the base branch (usually `main` or `master`). Pull latest.
+    *   **Branch**: Create a new branch: `fix/sentry-<issue_id>-<timestamp>`.
+2.  **Implementation**:
+    *   Use `edit` to modify the code.
+    *   **Verify**: If possible, run a relevant test (or create a temporary test case) to ensure the fix works and doesn't break syntax.
+    *   **Lint**: Run `npm run lint` (or equivalent) if available.
+3.  **Commit & PR**:
+    *   `git commit -am "fix(sentry): Resolve <issue_id> - <brief description>"`
+    *   `git push -u origin <branch_name>`
+    *   Create PR using `gh pr create`:
+        *   Title: `fix: Resolve Sentry Issue <issue_id>`
+        *   Body: Include summary from `rca.md`.
+4.  **Notify**:
+    *   Use `notify` tool: "✅ *Fix Implemented* for [Issue ID]\nPR: [PR URL]"
+5.  **Artifact**:
+    *   Write `fix_result.json` with the PR URL and status.
+
+### CONSTRAINTS
+*   Do NOT change unrelated code.
+*   If you cannot verify the fix (e.g., tests fail), abort and notify with a clear error message.

package/dist/templates/sentry-resolver/prompts/rca.md

@@ -0,0 +1,47 @@
+tools:
+  bash: true
+  write: true
+  edit: false
+  read: true
+  sentry_find_organizations: true
+  sentry_get_issue_details: true
+  sentry_get_issue_tag_values: true
+  sentry_analyze_issue_with_seer: true
+  notify: true
+---
+
+You are the **RCA (Root Cause Analysis) Agent**.
+
+### TASK
+Analyze the provided Sentry issue to determine the root cause and fixability.
+
+### INPUT
+*   **Issue ID** (e.g., `SENTRY-123`) provided in the prompt.
+*   **Context**: You are running in `.gv-ai/runs/<timestamp>/<issue_id>/`.
+
+### INSTRUCTIONS
+1.  **Analyze Issue**:
+    *   Use your tools (`sentry_get_issue_details`, `sentry_analyze_issue_with_seer`) to inspect the issue.
+    *   If you need the Organization slug and it wasn't provided, use your tools to find it.
+    *   **Verify Code**: Check the local codebase (`grep`/`read`) to confirm the file and line number from the stack trace exist.
+2.  **Determine Root Cause**:
+    *   Identify the logic error.
+    *   Assess **Fixability** (High/Medium/Low).
+3.  **Report**:
+    *   Write `rca.md` with your findings.
+4.  **Notify**:
+    *   Send a Telegram summary using the `notify` tool.
+
+### OUTPUT FORMAT (rca.md)
+```markdown
+# RCA: SENTRY-123
+## Root Cause
+...
+## Evidence
+...
+## Proposed Fix
+...
+## Assessment
+- **Confidence**: High/Medium/Low
+- **Action**: Fix / Ticket / Skip
+```

package/dist/templates/sentry-resolver/scripts/orchestrator.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Ensure we have a path (Cron often has limited path)
+export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:$PATH"
+
+# Try to source user profile for NVM/Node/etc
+if [ -f "$HOME/.bashrc" ]; then source "$HOME/.bashrc"; fi
+if [ -f "$HOME/.zshrc" ]; then source "$HOME/.zshrc"; fi
+if [ -f "$HOME/.profile" ]; then source "$HOME/.profile"; fi
+
+# Directory Setup
+# Resolve the directory where this script resides (.gv-ai/scripts)
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+# Base dir is parent of scripts (.gv-ai)
+BASE_DIR="$(dirname "$SCRIPT_DIR")"
+# Project Root is parent of .gv-ai
+PROJECT_ROOT="$(dirname "$BASE_DIR")"
+
+RUN_ID=$(date +%Y%m%d-%H%M%S)
+RUN_DIR="$BASE_DIR/runs/$RUN_ID"
+STATE_FILE="$BASE_DIR/state.json"
+ENV_FILE="$BASE_DIR/env.json"
+
+mkdir -p "$RUN_DIR"
+
+# Load Environment Variables from env.json
+if [ -f "$ENV_FILE" ]; then
+  # Simple parser for flat JSON string/number values
+  while IFS='=' read -r key value; do
+    # Remove quotes and comma
+    key=$(echo "$key" | tr -d '",')
+    value=$(echo "$value" | tr -d '",')
+    # Export if not empty
+    if [[ ! -z "$key" && "$key" != "{" && "$key" != "}" ]]; then
+      export "$key=$value"
+    fi
+  done < <(cat "$ENV_FILE" | grep ":")
+fi
+
+# Export Config Dir for OpenCode to find custom tools
+export OPENCODE_CONFIG_DIR="$BASE_DIR"
+
+echo "🚀 Starting Sentry Resolver Run: $RUN_ID"
+echo "📂 Project Root: $PROJECT_ROOT"
+
+# ---------------------------------------------------------
+# Phase 1: Fetch Issues
+# ---------------------------------------------------------
+echo "🔍 Fetching issues..."
+cd "$RUN_DIR" || exit 1
+
+# Run opencode from Project Root so it can access project files if needed
+cd "$PROJECT_ROOT" || exit 1
+
+opencode run \
+  --agent gv-fetcher \
+  --prompt "Fetch critical issues for projects: ${SENTRY_PROJECTS}. Write output to $RUN_DIR/issues.json" \
+  > "$RUN_DIR/fetcher.log" 2>&1
+
+if [ ! -f "$RUN_DIR/issues.json" ]; then
+  echo "⚠️ No issues.json created. Check $RUN_DIR/fetcher.log"
+  exit 0
+fi
+
+# ---------------------------------------------------------
+# Phase 2: Process Loop
+# ---------------------------------------------------------
+# Use node to parse the issues.json because bash JSON parsing is painful
+node -e "
+const fs = require('fs');
+const issues = JSON.parse(fs.readFileSync('$RUN_DIR/issues.json', 'utf8'));
+issues.forEach(issue => console.log(issue.id));
+" > "$RUN_DIR/issue_list.txt"
+
+while read -r ISSUE_ID; do
+  if [ -z "$ISSUE_ID" ]; then continue; fi
+  
+  echo "⚙️ Processing Issue: $ISSUE_ID"
+  ISSUE_DIR="$RUN_DIR/$ISSUE_ID"
+  mkdir -p "$ISSUE_DIR"
+  
+  # RCA Phase
+  echo "  - Running RCA..."
+  opencode run \
+    --agent gv-rca \
+    --prompt "Perform RCA for $ISSUE_ID. Working directory: $ISSUE_DIR" \
+    > "$ISSUE_DIR/rca.log" 2>&1
+    
+  if [ ! -f "$ISSUE_DIR/rca.md" ]; then
+    echo "  ⚠️ RCA failed to produce report."
+    continue
+  fi
+  
+  # Decision Check
+  # We look for 'Action: Fix' in the RCA markdown
+  ACTION=$(grep -i "Action:" "$ISSUE_DIR/rca.md" | head -n 1)
+  
+  if [[ "$ACTION" == *"Fix"* ]]; then
+    echo "  - Decision: FIX. Running Fixer..."
+    opencode run \
+      --agent gv-fixer \
+      --prompt "Fix $ISSUE_ID. RCA is at $ISSUE_DIR/rca.md" \
+      > "$ISSUE_DIR/fixer.log" 2>&1
+  else
+    echo "  - Decision: SKIP/TICKET ($ACTION)"
+  fi
+  
+  # Update State (Append to processed list)
+  # In a real impl, we'd read/write JSON properly. For now, we assume fetcher handles filtering.
+  # But we should append to a processed log.
+  echo "$ISSUE_ID processed at $(date)" >> "$BASE_DIR/processed_log.txt"
+  
+done < "$RUN_DIR/issue_list.txt"
+
+echo "✅ Run Complete."

package/dist/templates/sentry-resolver/tool/notify.ts.template

@@ -0,0 +1,51 @@
+import { tool } from "@opencode-ai/plugin";
+
+export default tool({
+  description: "Send a notification via Telegram",
+  args: {
+    message: tool.schema.string().describe("The message to send"),
+  },
+  async execute(args) {
+    const fs = await import("fs/promises");
+    const path = await import("path");
+
+    // Load secrets from .gv-ai/env.json (this file is in .gv-ai/tool/)
+    const envPath = path.join(__dirname, "..", "env.json");
+
+    let config;
+    try {
+      const envContent = await fs.readFile(envPath, "utf-8");
+      config = JSON.parse(envContent);
+    } catch {
+      return "Error: Could not load .gv-ai/env.json";
+    }
+
+    const { TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID } = config;
+    if (!TELEGRAM_BOT_TOKEN || !TELEGRAM_CHAT_ID) {
+      return "Error: Telegram credentials missing in env.json";
+    }
+
+    const text = `🤖 *Tal Auto-Fixer*\n\n${args.message}`;
+
+    try {
+      const res = await fetch(
+        `https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            chat_id: TELEGRAM_CHAT_ID,
+            text,
+            parse_mode: "Markdown",
+          }),
+        }
+      );
+      const result = await res.json();
+      return result.ok
+        ? "Notification sent."
+        : `Telegram Error: ${result.description}`;
+    } catch (e: any) {
+      return `Network Error: ${e.message}`;
+    }
+  },
+});

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "gv-ai",
-  "version": "1.0.0",
-  "description": "Internal CLI tool for GV team - Linear ticket enforcement",
+  "version": "1.1.0",
+  "description": "Internal CLI tool for GV team - Linear ticket enforcement and automated Sentry issue resolution",
   "type": "module",
   "bin": {
     "gv-ai": "./dist/cli.js"
   },
   "scripts": {
-    "build": "bun build src/cli.ts --outdir dist --target node --format esm && bun run build:types",
+    "build": "bun build src/cli.ts --outdir dist --target node --format esm && cp -r src/templates dist/ && bun run build:types",
     "build:types": "tsc --emitDeclarationOnly",
     "dev": "bun run src/cli.ts",
     "start": "bun run dist/cli.js",