opencode-athena 0.8.1-beta.3 → 0.8.1-beta.4

package/README.md

@@ -334,6 +334,75 @@ Version control is critical. Automatic commits can:
 
 With `autoGitOperations: false`, agents track progress via `athena_update_status()` instead, which updates `sprint-status.yaml` without git operations.
 
+### BMAD Path Overrides
+
+By default, Athena auto-detects BMAD file locations using BMAD METHOD v6 conventions. However, you can override any file path if your project uses non-standard locations or naming conventions.
+
+**Automatic detection features:**
+- ✅ Case-insensitive search (finds `prd.md`, `PRD.md`, `Prd.md`)
+- ✅ Multiple search paths (planning-artifacts, docs, sprint-artifacts)
+- ✅ Nested vs flat story structures
+
+**Override paths when needed:**
+
+```json
+{
+  "bmad": {
+    "paths": {
+      "stories": "custom/stories",
+      "sprintStatus": "custom/sprint.yaml",
+      "prd": "planning/requirements.md",
+      "architecture": "design/system-arch.md",
+      "epics": "backlog/epic-list.md"
+    }
+  }
+}
+```
+
+**Available path overrides:**
+
+| Field | Default Detection | Example Override |
+|-------|-------------------|------------------|
+| `stories` | `docs/implementation-artifacts/stories/` or `docs/sprint-artifacts/` (flat structure) | `"dev/user-stories"` |
+| `sprintStatus` | `sprint-status.yaml` in implementation or sprint artifacts | `"status/current-sprint.yaml"` |
+| `prd` | `PRD.md` (case-insensitive) in planning artifacts or docs | `"planning/product-requirements.md"` |
+| `architecture` | `architecture.md` (case-insensitive) in planning artifacts or docs | `"docs/system-design.md"` |
+| `epics` | `epics.md` (case-insensitive) in planning artifacts or docs | `"backlog/epic-definitions.md"` |
+
+**Path format:**
+- All paths are relative to project root
+- Use forward slashes (`/`) even on Windows
+- Set to `null` to use automatic detection (default)
+
+**Use case example:**
+
+If your project has a non-standard structure:
+```
+my-project/
+├── planning/
+│   ├── requirements.md       # Instead of PRD.md
+│   └── system-design.md      # Instead of architecture.md
+└── dev/
+    ├── sprint-status.yaml
+    └── stories/
+        ├── story-1-1.md
+        └── story-1-2.md
+```
+
+Configure overrides:
+```json
+{
+  "bmad": {
+    "paths": {
+      "stories": "dev/stories",
+      "sprintStatus": "dev/sprint-status.yaml",
+      "prd": "planning/requirements.md",
+      "architecture": "planning/system-design.md"
+    }
+  }
+}
+```
+
 ## 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/config/schemas/athena.schema.json

@@ -140,6 +140,37 @@
           "default": 3,
           "minimum": 0,
           "maximum": 10
+        },
+        "paths": {
+          "type": "object",
+          "description": "Optional path overrides for BMAD artifacts (null = auto-detect)",
+          "properties": {
+            "stories": {
+              "type": ["string", "null"],
+              "description": "Custom path to stories directory (null = auto-detect nested or flat structure)",
+              "default": null
+            },
+            "sprintStatus": {
+              "type": ["string", "null"],
+              "description": "Custom path to sprint-status.yaml file (null = auto-detect with case-insensitive search)",
+              "default": null
+            },
+            "prd": {
+              "type": ["string", "null"],
+              "description": "Custom path to PRD.md file (null = auto-detect with case-insensitive search)",
+              "default": null
+            },
+            "architecture": {
+              "type": ["string", "null"],
+              "description": "Custom path to architecture.md file (null = auto-detect with case-insensitive search)",
+              "default": null
+            },
+            "epics": {
+              "type": ["string", "null"],
+              "description": "Custom path to epics.md file (null = auto-detect with case-insensitive search)",
+              "default": null
+            }
+          }
         }
       },
       "required": ["defaultTrack", "autoStatusUpdate", "parallelStoryLimit"]

package/dist/cli/index.js

@@ -937,7 +937,14 @@ var SubscriptionSchema = z.object({
 var BmadConfigSchema = z.object({
   defaultTrack: z.enum(["quick-flow", "bmad-method", "enterprise"]),
   autoStatusUpdate: z.boolean(),
-  parallelStoryLimit: z.number().int().min(0).max(10)
+  parallelStoryLimit: z.number().int().min(0).max(10),
+  paths: z.object({
+    stories: z.string().nullable().optional().describe("Custom path to stories directory (null = auto-detect)"),
+    sprintStatus: z.string().nullable().optional().describe("Custom path to sprint-status.yaml file (null = auto-detect)"),
+    prd: z.string().nullable().optional().describe("Custom path to PRD.md file (null = auto-detect)"),
+    architecture: z.string().nullable().optional().describe("Custom path to architecture.md file (null = auto-detect)"),
+    epics: z.string().nullable().optional().describe("Custom path to epics.md file (null = auto-detect)")
+  }).optional()
 });
 var FeaturesSchema = z.object({
   bmadBridge: z.boolean(),
@@ -1485,7 +1492,14 @@ function generateAthenaConfig(answers) {
     bmad: {
       defaultTrack: methodology.defaultTrack,
       autoStatusUpdate: methodology.autoStatusUpdate,
-      parallelStoryLimit: advanced.parallelStoryLimit ?? 3
+      parallelStoryLimit: advanced.parallelStoryLimit ?? 3,
+      paths: {
+        stories: null,
+        sprintStatus: null,
+        prd: null,
+        architecture: null,
+        epics: null
+      }
     },
     features: featuresToFlags(features.enabledFeatures),
     mcps: mcpsToFlags(features.mcps)
@@ -2294,6 +2308,28 @@ var MIGRATIONS = [
     toVersion: "0.7.0",
     description: "Reorganize athena files into dedicated directory",
     migrateAthena: (config) => config
+  },
+  {
+    fromVersion: "0.7.0",
+    toVersion: "0.8.0",
+    description: "Add BMAD path overrides: sprintStatus, prd, architecture, epics",
+    migrateAthena: (config) => {
+      const bmad = config.bmad || {};
+      const paths = bmad.paths || {};
+      if (paths.sprintStatus === void 0) {
+        paths.sprintStatus = null;
+      }
+      if (paths.prd === void 0) {
+        paths.prd = null;
+      }
+      if (paths.architecture === void 0) {
+        paths.architecture = null;
+      }
+      if (paths.epics === void 0) {
+        paths.epics = null;
+      }
+      return { ...config, bmad: { ...bmad, paths } };
+    }
   }
 ];
 function migrateLegacyFiles() {