opencode-athena 0.3.0 → 0.5.0

package/README.md

@@ -290,6 +290,50 @@ Custom model fields:
   - `contextWindow`: Context window size in tokens
   - `supportsTemperature`: Whether temperature can be adjusted
 
+### Git Operations Policy
+
+By default, Athena prevents agents from automatically performing git operations (commits, pushes, branch creation). This ensures developers maintain full control over version control.
+
+**Default behavior** (`autoGitOperations: false`):
+- ✅ Agents can read git state (`git status`, `git diff`, `git log`)
+- ❌ Agents cannot automatically commit, push, or create branches
+- ⚠️ If an agent attempts a git write operation, a warning is injected
+- 📝 Agents must ask for explicit user permission before git operations
+
+**Enable automatic git operations:**
+
+Set `features.autoGitOperations: true` in `athena.json`:
+
+```json
+{
+  "features": {
+    "autoGitOperations": true
+  }
+}
+```
+
+Or during installation, check the "Auto Git Operations" feature.
+
+**Covered operations:**
+- **Git commits & pushes:** `git commit`, `git push`
+- **Branch operations:** `git checkout -b`, `git branch`, `git switch -c`, `git switch --create`
+- **Merging & rebasing:** `git merge`, `git rebase`, `git cherry-pick`
+- **Stashing & tags:** `git stash`, `git tag`
+- **Reset operations:** `git reset` (all variants: --soft, --mixed, --hard)
+- **GitHub PR operations:** `gh pr create`, `gh pr edit`, `gh pr merge`, `gh pr close`, `gh pr review`
+- **GitHub issue operations:** `gh issue create`, `gh issue edit`, `gh issue close`
+- **GitHub release operations:** `gh release create`, `gh release edit`, `gh release delete`
+
+**Why this is the default:**
+
+Version control is critical. Automatic commits can:
+- Create unclear commit messages
+- Commit unintended changes
+- Disrupt branch strategies
+- Bypass code review processes
+
+With `autoGitOperations: false`, agents track progress via `athena_update_status()` instead, which updates `sprint-status.yaml` without git operations.
+
 ## GitHub Copilot Support
 
 Athena supports GitHub Copilot as a model provider, allowing you to use Claude, GPT, and Gemini models through your Copilot subscription. This is especially useful for enterprise users who only have access to LLMs through Copilot.

package/commands/athena-debug.md

@@ -4,6 +4,44 @@ description: Debug an issue using Oracle's deep reasoning capabilities
 
 # Athena Debug - Oracle-Powered Debugging
 
+## Git Operations Policy
+
+**⚠️ AUTOMATIC GIT OPERATIONS ARE PROHIBITED**
+
+You must NOT perform any git operations automatically:
+- ❌ Do NOT run `git commit` to save changes
+- ❌ Do NOT run `git push` to push to remote
+- ❌ Do NOT run `git checkout -b` or `git branch` to create branches
+- ❌ Do NOT run `git merge`, `git rebase`, or `git cherry-pick`
+- ❌ Do NOT run `gh pr create` or other GitHub CLI operations
+
+**Git operations are ONLY permitted if the user explicitly requests them.**
+
+Examples of explicit permission:
+- User says: "Please commit these fixes"
+- User says: "Create a branch for this bugfix"
+- User says: "Push to origin" or "Create a PR"
+
+**If you believe git operations would be helpful, ASK the user first:**
+```
+I've fixed the issue. Would you like me to:
+1. Commit the fix to git, or
+2. Leave git operations for you to handle manually?
+```
+
+**To track story progress without git, use:**
+```
+athena_update_status({
+  storyId: "X.Y",
+  status: "in_progress",
+  notes: "Fixed issue: [description]"
+})
+```
+
+This updates sprint-status.yaml without requiring git commits.
+
+---
+
 Use Oracle, the debugging specialist, to analyze and fix complex issues with systematic hypothesis-driven debugging.
 
 **You are Sisyphus, the orchestrator.** You will coordinate Oracle's deep reasoning with automated tools to efficiently diagnose and fix issues.

package/commands/athena-dev.md

@@ -4,6 +4,44 @@ description: Implement the current BMAD story using Sisyphus and specialized sub
 
 # Athena Dev - Story Implementation
 
+## Git Operations Policy
+
+**⚠️ AUTOMATIC GIT OPERATIONS ARE PROHIBITED**
+
+You must NOT perform any git operations automatically:
+- ❌ Do NOT run `git commit` to save changes
+- ❌ Do NOT run `git push` to push to remote
+- ❌ Do NOT run `git checkout -b` or `git branch` to create branches
+- ❌ Do NOT run `git merge`, `git rebase`, or `git cherry-pick`
+- ❌ Do NOT run `gh pr create` or other GitHub CLI operations
+
+**Git operations are ONLY permitted if the user explicitly requests them.**
+
+Examples of explicit permission:
+- User says: "Please commit these changes"
+- User says: "Create a branch called feature-x"
+- User says: "Push to origin" or "Create a PR"
+
+**If you believe git operations would be helpful, ASK the user first:**
+```
+I've completed the implementation. Would you like me to:
+1. Commit these changes to git, or
+2. Leave git operations for you to handle manually?
+```
+
+**To track story progress without git, use:**
+```
+athena_update_status({
+  storyId: "X.Y",
+  status: "completed",
+  completionSummary: "What was implemented..."
+})
+```
+
+This updates sprint-status.yaml without requiring git commits.
+
+---
+
 You are implementing a BMAD story using OpenCode Athena's full capabilities.
 
 **You are Sisyphus, the orchestrator.** You will coordinate subagents and tools to implement this story efficiently and correctly.

package/commands/athena-parallel.md

@@ -8,6 +8,23 @@ description: Work on multiple stories in parallel using background agents
 > 
 > This command describes **planned functionality** that is not yet available. The `athena_parallel` tool is a placeholder. This document describes the intended behavior for future implementation.
 
+## Git Operations Policy
+
+**⚠️ AUTOMATIC GIT OPERATIONS ARE PROHIBITED**
+
+You must NOT perform any git operations automatically:
+- ❌ Do NOT run `git commit` to save changes
+- ❌ Do NOT run `git push` to push to remote
+- ❌ Do NOT run `git checkout -b` or `git branch` to create branches
+- ❌ Do NOT run `git merge`, `git rebase`, or `git cherry-pick`
+- ❌ Do NOT run `gh pr create` or other GitHub CLI operations
+
+**Git operations are ONLY permitted if the user explicitly requests them.**
+
+When working on multiple stories in parallel, git operations become especially important to coordinate manually. Always ask the user before performing any git operations.
+
+---
+
 Execute multiple BMAD stories simultaneously using background agents for maximum throughput.
 
 ## Planned Behavior
@@ -161,7 +178,7 @@ opencode
 ```
 # Start story 2.1 in background
 background_task({
-  agent: "general",
+  agent: "Sisyphus",
   prompt: "Implement BMAD story 2.1. Load context with athena_get_story({storyId: '2.1'}), implement following /athena-dev workflow, update status when complete.",
   description: "Story 2.1 implementation"
 })
@@ -199,7 +216,7 @@ async function executeParallel(storyIds: string[]) {
   
   // 3. Spawn background agents
   const tasks = storyIds.map(id => ({
-    agent: "general", // or dedicated story-impl agent
+    agent: "Sisyphus",
     prompt: generateStoryPrompt(id),
   }));
   

package/commands/athena-research.md

@@ -4,6 +4,23 @@ description: Research patterns, implementations, or documentation using Libraria
 
 # Athena Research - Librarian-Powered Research
 
+## Git Operations Policy
+
+**⚠️ AUTOMATIC GIT OPERATIONS ARE PROHIBITED**
+
+You must NOT perform any git operations automatically:
+- ❌ Do NOT run `git commit` to save changes
+- ❌ Do NOT run `git push` to push to remote
+- ❌ Do NOT run `git checkout -b` or `git branch` to create branches
+- ❌ Do NOT run `git merge`, `git rebase`, or `git cherry-pick`
+- ❌ Do NOT run `gh pr create` or other GitHub CLI operations
+
+**Git operations are ONLY permitted if the user explicitly requests them.**
+
+This command focuses on research and should rarely involve git operations. If you believe git operations are needed, ASK the user first.
+
+---
+
 Use Librarian, the research specialist, to find patterns, examples, and documentation from multiple sources.
 
 **You are Sisyphus, the orchestrator.** You will coordinate Librarian's research capabilities with Explore for comprehensive information gathering.

package/commands/athena-review-story.md

@@ -33,7 +33,7 @@ This review runs in a **separate context** to preserve main session tokens.
 Use background_task to spawn a review agent:
 
 background_task({
-  agent: "general",
+  agent: "oracle",
   description: "Party review of {identifier}",
   prompt: `
 You are performing a party review for Athena.
@@ -134,7 +134,7 @@ For each recommended agent, spawn a background task:
 ```
 # Spawn in parallel - all at once
 background_task({
-  agent: "general",
+  agent: "oracle",
   description: "Architect analysis of {identifier}",
   prompt: `
 You are Winston, the Software Architect from BMAD.

package/commands/athena-review.md

@@ -4,6 +4,44 @@ description: Run a combined quality gate on the current story implementation
 
 # Athena Review - Automated Quality Gate
 
+## Git Operations Policy
+
+**⚠️ AUTOMATIC GIT OPERATIONS ARE PROHIBITED**
+
+You must NOT perform any git operations automatically:
+- ❌ Do NOT run `git commit` to save changes
+- ❌ Do NOT run `git push` to push to remote
+- ❌ Do NOT run `git checkout -b` or `git branch` to create branches
+- ❌ Do NOT run `git merge`, `git rebase`, or `git cherry-pick`
+- ❌ Do NOT run `gh pr create` or other GitHub CLI operations
+
+**Git operations are ONLY permitted if the user explicitly requests them.**
+
+Examples of explicit permission:
+- User says: "Please commit these changes"
+- User says: "Create a branch called feature-x"
+- User says: "Push to origin" or "Create a PR"
+
+**If you believe git operations would be helpful, ASK the user first:**
+```
+The quality gate passed! Would you like me to:
+1. Commit these changes to git, or
+2. Leave git operations for you to handle manually?
+```
+
+**To track story progress without git, use:**
+```
+athena_update_status({
+  storyId: "X.Y",
+  status: "completed",
+  completionSummary: "What was implemented..."
+})
+```
+
+This updates sprint-status.yaml without requiring git commits.
+
+---
+
 Perform a comprehensive quality review by orchestrating **oh-my-opencode Oracle code review** and **BMAD adversarial review**, both powered by Oracle's deep reasoning capabilities.
 
 **You are Sisyphus, the orchestrator.** You will coordinate multiple review perspectives and synthesize the findings.

package/commands/athena-status.md

@@ -4,6 +4,23 @@ description: View and manage BMAD sprint status
 
 # Athena Status - Sprint Status Management
 
+## Git Operations Policy
+
+**⚠️ AUTOMATIC GIT OPERATIONS ARE PROHIBITED**
+
+You must NOT perform any git operations automatically:
+- ❌ Do NOT run `git commit` to save changes
+- ❌ Do NOT run `git push` to push to remote
+- ❌ Do NOT run `git checkout -b` or `git branch` to create branches
+- ❌ Do NOT run `git merge`, `git rebase`, or `git cherry-pick`
+- ❌ Do NOT run `gh pr create` or other GitHub CLI operations
+
+**Git operations are ONLY permitted if the user explicitly requests them.**
+
+This command focuses on status management and should not involve git operations.
+
+---
+
 View current sprint progress and manage story statuses. This command helps you track where you are in the sprint and what to work on next.
 
 ## Quick Status Check

package/config/presets/copilot-only.json

@@ -14,7 +14,8 @@
     "librarian": "github-copilot/claude-haiku-4.5",
     "frontend": "github-copilot/claude-sonnet-4.5",
     "documentWriter": "github-copilot/gemini-2.5-pro",
-    "multimodalLooker": "github-copilot/gemini-2.5-pro"
+    "multimodalLooker": "github-copilot/gemini-2.5-pro",
+    "explore": "github-copilot/gpt-5-mini"
   },
   "bmad": {
     "defaultTrack": "bmad-method",
@@ -28,7 +29,8 @@
     "notifications": true,
     "contextMonitor": true,
     "commentChecker": true,
-    "lspTools": true
+    "lspTools": true,
+    "autoGitOperations": false
   },
   "mcps": {
     "context7": true,

package/config/presets/enterprise.json

@@ -15,13 +15,15 @@
     "frontend": "google/gemini-2.5-pro",
     "documentWriter": "anthropic/claude-opus-4-5",
     "multimodalLooker": "google/gemini-2.5-pro",
+    "explore": "google/gemini-2.5-flash",
     "settings": {
       "sisyphus": { "thinkingLevel": "high" },
       "oracle": { "thinkingLevel": "high" },
       "librarian": { "thinkingLevel": "medium" },
       "frontend": { "temperature": 0.5 },
       "documentWriter": { "temperature": 0.4 },
-      "multimodalLooker": { "temperature": 0.2 }
+      "multimodalLooker": { "temperature": 0.2 },
+      "explore": { "thinkingLevel": "off", "temperature": 0.2 }
     }
   },
   "bmad": {
@@ -36,7 +38,8 @@
     "notifications": true,
     "contextMonitor": true,
     "commentChecker": true,
-    "lspTools": true
+    "lspTools": true,
+    "autoGitOperations": false
   },
   "mcps": {
     "context7": true,

package/config/presets/minimal.json

@@ -12,10 +12,12 @@
     "sisyphus": "anthropic/claude-sonnet-4-5",
     "oracle": "anthropic/claude-sonnet-4-5",
     "librarian": "anthropic/claude-sonnet-4-5",
+    "explore": "anthropic/claude-sonnet-4-5",
     "settings": {
       "sisyphus": { "temperature": 0.2 },
       "oracle": { "temperature": 0.1 },
-      "librarian": { "temperature": 0.3 }
+      "librarian": { "temperature": 0.3 },
+      "explore": { "temperature": 0.2 }
     }
   },
   "bmad": {
@@ -30,7 +32,8 @@
     "notifications": false,
     "contextMonitor": false,
     "commentChecker": false,
-    "lspTools": true
+    "lspTools": true,
+    "autoGitOperations": false
   },
   "mcps": {
     "context7": true,

package/config/presets/solo-quick.json

@@ -12,10 +12,12 @@
     "sisyphus": "anthropic/claude-sonnet-4-5-thinking",
     "oracle": "anthropic/claude-sonnet-4-5-thinking",
     "librarian": "anthropic/claude-sonnet-4-5",
+    "explore": "anthropic/claude-sonnet-4-5",
     "settings": {
       "sisyphus": { "thinkingLevel": "medium" },
       "oracle": { "thinkingLevel": "high" },
-      "librarian": { "temperature": 0.3 }
+      "librarian": { "temperature": 0.3 },
+      "explore": { "temperature": 0.2 }
     }
   },
   "bmad": {
@@ -30,7 +32,8 @@
     "notifications": true,
     "contextMonitor": true,
     "commentChecker": true,
-    "lspTools": true
+    "lspTools": true,
+    "autoGitOperations": false
   },
   "mcps": {
     "context7": true,

package/config/presets/standard.json

@@ -15,13 +15,15 @@
     "frontend": "anthropic/claude-sonnet-4-5",
     "documentWriter": "google/gemini-2.5-pro",
     "multimodalLooker": "google/gemini-2.5-flash",
+    "explore": "google/gemini-2.5-flash",
     "settings": {
       "sisyphus": { "thinkingLevel": "medium" },
       "oracle": { "thinkingLevel": "high" },
       "librarian": { "thinkingLevel": "low" },
       "frontend": { "temperature": 0.5 },
       "documentWriter": { "temperature": 0.4 },
-      "multimodalLooker": { "temperature": 0.2 }
+      "multimodalLooker": { "temperature": 0.2 },
+      "explore": { "thinkingLevel": "off", "temperature": 0.2 }
     }
   },
   "bmad": {
@@ -36,7 +38,8 @@
     "notifications": true,
     "contextMonitor": true,
     "commentChecker": true,
-    "lspTools": true
+    "lspTools": true,
+    "autoGitOperations": false
   },
   "mcps": {
     "context7": true,

package/config/schemas/athena.schema.json

@@ -92,6 +92,10 @@
           "type": "string",
           "description": "Model for image analysis agent"
         },
+        "explore": {
+          "type": "string",
+          "description": "Model for fast codebase exploration agent"
+        },
         "settings": {
           "type": "object",
           "description": "Optional agent-specific settings for temperature and thinking level",
@@ -102,6 +106,7 @@
             "frontend": { "$ref": "#/definitions/agentSettings" },
             "documentWriter": { "$ref": "#/definitions/agentSettings" },
             "multimodalLooker": { "$ref": "#/definitions/agentSettings" },
+            "explore": { "$ref": "#/definitions/agentSettings" },
             "overrides": {
               "type": "object",
               "description": "Per-model overrides (key: model ID, value: settings)",
@@ -149,7 +154,8 @@
         "notifications": { "type": "boolean", "default": true },
         "contextMonitor": { "type": "boolean", "default": true },
         "commentChecker": { "type": "boolean", "default": true },
-        "lspTools": { "type": "boolean", "default": true }
+        "lspTools": { "type": "boolean", "default": true },
+        "autoGitOperations": { "type": "boolean", "default": false, "description": "Allow agents to perform git/gh operations automatically (false = requires explicit user permission)" }
       }
     },
     "mcps": {