opencode-athena 0.8.1 → 0.9.0-beta.0

package/README.md

@@ -180,6 +180,56 @@ Agents are recommended based on finding types:
 - **Quick Review [Q]**: Accept Phase 1 findings, skip discussion. Best for low-severity issues.
 - **Full Discussion [D]**: Run Phases 2-3 with parallel agents and informed discussion. Best for complex or high-severity findings.
 
+## BMAD ↔ Todo Sync
+
+Athena automatically synchronizes BMAD story checkboxes with oh-my-opencode's todo tool:
+
+- **Automatic population**: Story tasks appear in your todo list when loading a story
+- **Two-way sync**: Marking todos complete updates BMAD file checkboxes
+- **Athena-themed format**: `[2.3ΔAC1] Task description`
+- **Compaction-safe**: Works seamlessly after session compaction
+- **Story context**: Prefix tells you where to look for full details
+
+### How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    WRITE-THROUGH CACHE MODEL                            │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│   BMAD Files (Source of Truth)        Todo Cache (Session View)         │
+│   ┌─────────────────────────┐         ┌─────────────────────────┐       │
+│   │ story-2-3.md            │         │ [2.3ΔAC1] Login      ○  │       │
+│   │ - [ ] AC1: Login        │◄────────│ [2.3ΔAC2] Logout     ✓  │       │
+│   │ - [x] AC2: Logout       │  Write  │ [2.3ΔTask1] Tests    ○  │       │
+│   │ - [ ] Task: Add tests   │  back   │                         │       │
+│   └─────────────────────────┘         └─────────────────────────┘       │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+When you call `athena_get_story`, todos are extracted from the story file's checkboxes and returned in a format ready for `todowrite`. Marking a todo complete automatically updates the corresponding checkbox in the BMAD file.
+
+### Todo Format
+
+| BMAD Section | Todo Prefix | Example |
+|--------------|-------------|---------|
+| Acceptance Criteria | `AC{n}` | `[2.3ΔAC1] Users can login` |
+| Tasks/Subtasks | `Task{n}` | `[2.3ΔTask3] Write tests` |
+| Implementation Notes | `Fix{n}` | `[2.3ΔFix2] Hardcoded secret` |
+
+### Configuration
+
+Todo sync is enabled by default. To disable:
+
+```json
+{
+  "features": {
+    "todoSync": false
+  }
+}
+```
+
 ## Configuration
 
 Configuration files are stored in `~/.config/opencode/`:

package/commands/athena-dev.md

@@ -115,6 +115,34 @@ This is a **fresh implementation** - proceed with the normal workflow:
 - Verify implementation (Step 4)
 - Complete the story (Step 5)
 
+## Step 1.5: Sync Todos (Automatic)
+
+When `athena_get_story` returns, it includes a `todos` section with BMAD tasks formatted for the todo list.
+
+**Call todowrite to populate your task list:**
+
+```
+todowrite({
+  todos: [
+    // Use the todos array from athena_get_story response
+  ]
+})
+```
+
+This syncs the BMAD story checkboxes to your todo list:
+- `[2.3ΔAC1] Implement login endpoint` → Acceptance Criterion 1
+- `[2.3ΔTask3] Write integration tests` → Task 3  
+- `[2.3ΔFix2] Hardcoded JWT secret` → Implementation Notes finding
+
+**As you complete tasks:**
+- Mark todos complete via `todowrite`
+- The BMAD file checkboxes update automatically
+- Progress is preserved even after session compaction
+
+**Need more context on a task?**
+- The prefix tells you where to look: `[2.3ΔAC1]` → Story 2.3, AC section
+- Read the story file: `docs/stories/story-2-3.md`
+
 ## Step 2: Plan Your Approach
 
 Before diving into code, plan your implementation strategy:

package/dist/cli/index.js

@@ -954,7 +954,8 @@ var FeaturesSchema = z.object({
   contextMonitor: z.boolean(),
   commentChecker: z.boolean(),
   lspTools: z.boolean(),
-  autoGitOperations: z.boolean().default(false)
+  autoGitOperations: z.boolean().default(false),
+  todoSync: z.boolean().default(true)
 });
 var McpsSchema = z.object({
   context7: z.boolean(),
@@ -1447,7 +1448,8 @@ function featuresToFlags(enabledFeatures) {
     contextMonitor: enabledFeatures.includes("context-monitor"),
     commentChecker: enabledFeatures.includes("comment-checker"),
     lspTools: enabledFeatures.includes("lsp-tools"),
-    autoGitOperations: enabledFeatures.includes("auto-git-operations")
+    autoGitOperations: enabledFeatures.includes("auto-git-operations"),
+    todoSync: true
   };
 }
 function mcpsToFlags(mcps) {
@@ -1711,7 +1713,8 @@ function buildMinimalConfig(answers) {
       contextMonitor: features.enabledFeatures.includes("context-monitor"),
       commentChecker: features.enabledFeatures.includes("comment-checker"),
       lspTools: features.enabledFeatures.includes("lsp-tools"),
-      autoGitOperations: false
+      autoGitOperations: false,
+      todoSync: true
     },
     mcps: {
       context7: features.mcps.includes("context7"),
@@ -2330,6 +2333,18 @@ var MIGRATIONS = [
       }
       return { ...config, bmad: { ...bmad, paths } };
     }
+  },
+  {
+    fromVersion: "0.8.0",
+    toVersion: "0.9.0",
+    description: "Add BMAD todo sync feature flag: todoSync",
+    migrateAthena: (config) => {
+      const features = config.features || {};
+      if (features.todoSync === void 0) {
+        features.todoSync = true;
+      }
+      return { ...config, features };
+    }
   }
 ];
 function migrateLegacyFiles() {