loki-mode 6.0.0 → 6.1.0

package/autonomy/loki

@@ -438,6 +438,7 @@ show_help() {
     echo "  --skip-memory    Skip loading memory context at startup"
     echo "  --compliance PRESET  Enable compliance mode (default|healthcare|fintech|government)"
     echo "  --budget USD     Set cost budget limit (display in dashboard/status)"
+    echo "  --bmad-project PATH  Use BMAD Method project artifacts as input"
     echo ""
     echo "Options for 'run' (v6.0.0):"
     echo "  --dry-run          Preview generated PRD without starting"
@@ -473,6 +474,7 @@ cmd_start() {
     local args=()
     local prd_file=""
     local provider=""
+    local bmad_project_path=""
 
     while [[ $# -gt 0 ]]; do
         case "$1" in
@@ -496,6 +498,7 @@ cmd_start() {
                 echo "  --skip-memory         Skip loading memory context at startup"
                 echo "  --compliance PRESET   Enable compliance mode (default|healthcare|fintech|government)"
                 echo "  --budget USD          Cost budget limit (auto-pause when exceeded)"
+                echo "  --bmad-project PATH   Use BMAD Method project artifacts as input"
                 echo "  --yes, -y             Skip confirmation prompts (auto-confirm)"
                 echo ""
                 echo "Environment Variables:"
@@ -510,6 +513,7 @@ cmd_start() {
                 echo "  loki start ./prd.md             # Start with PRD file"
                 echo "  loki start ./prd.md --parallel  # Parallel mode with worktrees"
                 echo "  loki start --provider codex     # Use OpenAI Codex CLI"
+                echo "  loki start --bmad-project ./my-project  # Start from BMAD artifacts"
                 echo "  loki start --yes                # Skip confirmation prompt"
                 echo "  LOKI_PRD_FILE=./prd.md loki start  # PRD via env var"
                 exit 0
@@ -581,6 +585,19 @@ cmd_start() {
                 export LOKI_AUTO_CONFIRM=true
                 shift
                 ;;
+            --bmad-project)
+                if [[ -n "${2:-}" ]]; then
+                    bmad_project_path="$2"
+                    shift 2
+                else
+                    echo -e "${RED}--bmad-project requires a path to a BMAD project directory${NC}"
+                    exit 1
+                fi
+                ;;
+            --bmad-project=*)
+                bmad_project_path="${1#*=}"
+                shift
+                ;;
             --budget)
                 if [[ -n "${2:-}" ]]; then
                     if ! echo "$2" | grep -qE '^[0-9]+(\.[0-9]+)?$'; then
@@ -619,6 +636,67 @@ cmd_start() {
         prd_file="$LOKI_PRD_FILE"
     fi
 
+    # BMAD project validation and adapter execution
+    if [[ -n "$bmad_project_path" ]]; then
+        # Resolve to absolute path
+        if [[ ! "$bmad_project_path" = /* ]]; then
+            bmad_project_path="$(cd "$bmad_project_path" 2>/dev/null && pwd)" || {
+                echo -e "${RED}Error: BMAD project path does not exist: $bmad_project_path${NC}"
+                exit 1
+            }
+        fi
+
+        # Validate path is a directory
+        if [[ ! -d "$bmad_project_path" ]]; then
+            echo -e "${RED}Error: BMAD project path is not a directory: $bmad_project_path${NC}"
+            exit 1
+        fi
+
+        # Check for BMAD artifacts (_bmad-output/ or common BMAD markers)
+        if [[ ! -d "$bmad_project_path/_bmad-output" ]]; then
+            echo -e "${YELLOW}Warning: No _bmad-output/ directory found in $bmad_project_path${NC}"
+            echo "Expected a BMAD Method project with _bmad-output/ artifacts."
+            echo -e "Continue anyway? [y/N] \\c"
+            local _auto="${LOKI_AUTO_CONFIRM:-${CI:-false}}"
+            if [[ "$_auto" == "true" ]]; then
+                echo "y (auto-confirmed)"
+            else
+                read -r _bmad_confirm
+                if [[ ! "$_bmad_confirm" =~ ^[Yy] ]]; then
+                    echo "Aborted."
+                    exit 0
+                fi
+            fi
+        fi
+
+        # Export for run.sh to access
+        export BMAD_PROJECT_PATH="$bmad_project_path"
+
+        # Ensure .loki directory exists for adapter output
+        mkdir -p "$LOKI_DIR"
+
+        # Run the BMAD adapter to normalize artifacts
+        echo -e "${CYAN}Running BMAD adapter...${NC}"
+        local adapter_script="${SCRIPT_DIR:-$(dirname "$0")}/bmad-adapter.py"
+        if [[ ! -f "$adapter_script" ]]; then
+            echo -e "${RED}Error: BMAD adapter not found at $adapter_script${NC}"
+            echo "Please ensure autonomy/bmad-adapter.py exists."
+            exit 1
+        fi
+
+        if ! python3 "$adapter_script" "$bmad_project_path" --output-dir "$LOKI_DIR" --validate; then
+            echo -e "${RED}Error: BMAD adapter failed. Check the project artifacts.${NC}"
+            exit 1
+        fi
+        echo -e "${GREEN}BMAD artifacts normalized successfully.${NC}"
+
+        # If no explicit PRD was provided, use the normalized BMAD PRD
+        if [[ -z "$prd_file" ]] && [[ -f "$LOKI_DIR/bmad-prd-normalized.md" ]]; then
+            prd_file="$LOKI_DIR/bmad-prd-normalized.md"
+            echo -e "${CYAN}Using normalized BMAD PRD: $prd_file${NC}"
+        fi
+    fi
+
     if [ -n "$prd_file" ]; then
         args+=("$prd_file")
     else

package/autonomy/prd-analyzer.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""PRD Quality Analyzer for Loki Mode v5.44.0
+"""PRD Quality Analyzer for Loki Mode v6.1.0
 
 Analyzes PRD structure and completeness using regex-based heuristics.
 Writes observations to .loki/prd-observations.md with quality score,
@@ -10,6 +10,7 @@ Stdlib only - no pip dependencies required.
 Usage:
     python3 prd-analyzer.py path/to/prd.md --output .loki/prd-observations.md
     python3 prd-analyzer.py path/to/prd.md --output .loki/prd-observations.md --interactive
+    python3 prd-analyzer.py path/to/prd.md --architecture path/to/architecture.md
 """
 
 import argparse
@@ -28,10 +29,13 @@ DIMENSIONS = {
         "weight": 1.5,
         "heading_patterns": [
             r"(?i)#+\s.*(?:feature|requirement|scope|functional|capability)",
+            r"(?i)^##\s+Functional\s+Requirements",
+            r"(?i)^##\s+Product\s+Scope",
         ],
         "content_patterns": [
             r"^\s*[-*]\s+\S",
             r"^\s*\d+\.\s+\S",
+            r"(?i)^FR\d+:",
         ],
         "description": "Numbered or bulleted list of features/requirements",
     },
@@ -55,6 +59,7 @@ DIMENSIONS = {
         "weight": 1.0,
         "heading_patterns": [
             r"(?i)#+\s.*(?:user\s+(?:stor|flow|journey)|persona|use\s+case)",
+            r"(?i)^##\s+User\s+Journeys",
         ],
         "content_patterns": [
             r"(?i)\bas\s+a\s+\w+",
@@ -68,11 +73,13 @@ DIMENSIONS = {
         "weight": 1.0,
         "heading_patterns": [
             r"(?i)#+\s.*(?:acceptance|criteria|definition\s+of\s+done|done\s+when)",
+            r"(?i)^##\s+Success\s+Criteria",
         ],
         "content_patterns": [
             r"^\s*-\s*\[\s*[xX ]?\s*\]",
             r"(?i)\bgiven\b.*\bwhen\b.*\bthen\b",
             r"(?i)\bmust\s+(?:be|have|support|handle)\b",
+            r"(?i)^\s*\*\*Given\*\*",
         ],
         "description": "Measurable completion criteria or checklists",
     },
@@ -107,6 +114,7 @@ DIMENSIONS = {
         "weight": 0.75,
         "heading_patterns": [
             r"(?i)#+\s.*(?:deploy|hosting|infra|ci.?cd|environment)",
+            r"(?i)^##\s+Non-Functional\s+Requirements",
         ],
         "content_patterns": [
             r"(?i)\b(?:deploy|hosting|ci.?cd|pipeline|staging|production)\b",
@@ -131,6 +139,7 @@ DIMENSIONS = {
         "weight": 1.0,
         "heading_patterns": [
             r"(?i)#+\s.*(?:security|auth|permission|access\s+control)",
+            r"(?i)^##\s+Non-Functional\s+Requirements",
         ],
         "content_patterns": [
             r"(?i)\b(?:auth(?:entication|orization)?|oauth|jwt|token)\b",
@@ -153,8 +162,9 @@ SCOPE_THRESHOLDS = [
 class PrdAnalyzer:
     """Analyzes PRD quality and completeness."""
 
-    def __init__(self, prd_path):
+    def __init__(self, prd_path, architecture_path=None):
         self.prd_path = Path(prd_path)
+        self.architecture_path = Path(architecture_path) if architecture_path else None
         self.content = ""
         self.lines = []
         self.results = {}
@@ -163,13 +173,20 @@ class PrdAnalyzer:
         self.score = 0.0
 
     def load(self):
-        """Load and validate the PRD file."""
+        """Load and validate the PRD file, optionally appending architecture doc."""
         if not self.prd_path.exists():
             raise FileNotFoundError(f"PRD file not found: {self.prd_path}")
         self.content = self.prd_path.read_text(encoding="utf-8", errors="replace")
         if not self.content.strip():
             raise ValueError(f"PRD file is empty: {self.prd_path}")
         self.lines = self.content.splitlines()
+        # Append architecture document lines for pattern matching
+        if self.architecture_path:
+            if not self.architecture_path.exists():
+                raise FileNotFoundError(f"Architecture file not found: {self.architecture_path}")
+            arch_content = self.architecture_path.read_text(encoding="utf-8", errors="replace")
+            if arch_content.strip():
+                self.lines.extend(arch_content.splitlines())
 
     def analyze(self):
         """Run all analysis dimensions and compute score."""
@@ -420,6 +437,11 @@ def main():
         default=".loki/prd-observations.md",
         help="Output path for observations (default: .loki/prd-observations.md)",
     )
+    parser.add_argument(
+        "--architecture",
+        metavar="PATH",
+        help="Optional architecture document to include in analysis",
+    )
     parser.add_argument(
         "--interactive",
         action="store_true",
@@ -428,7 +450,7 @@ def main():
     args = parser.parse_args()
 
     try:
-        analyzer = PrdAnalyzer(args.prd_path)
+        analyzer = PrdAnalyzer(args.prd_path, architecture_path=args.architecture)
         analyzer.analyze()
         observations = analyzer.generate_observations()
 

package/autonomy/run.sh

@@ -7034,21 +7034,163 @@ except: pass
 " 2>/dev/null || true)
     fi
 
+    # BMAD context injection (if available)
+    local bmad_context=""
+    if [[ -f ".loki/bmad-metadata.json" ]]; then
+        local bmad_arch=""
+        if [[ -f ".loki/bmad-architecture-summary.md" ]]; then
+            bmad_arch=$(head -c 16000 ".loki/bmad-architecture-summary.md")
+        fi
+        local bmad_tasks=""
+        if [[ -f ".loki/bmad-tasks.json" ]]; then
+            bmad_tasks=$(head -c 32000 ".loki/bmad-tasks.json")
+        fi
+        local bmad_validation=""
+        if [[ -f ".loki/bmad-validation.md" ]]; then
+            bmad_validation=$(head -c 8000 ".loki/bmad-validation.md")
+        fi
+        bmad_context="BMAD_CONTEXT: This project uses BMAD Method structured artifacts. Architecture decisions and epic/story breakdown are provided below."
+        if [[ -n "$bmad_arch" ]]; then
+            bmad_context="$bmad_context ARCHITECTURE DECISIONS: $bmad_arch"
+        fi
+        if [[ -n "$bmad_tasks" ]]; then
+            bmad_context="$bmad_context EPIC/STORY TASKS (from BMAD): $bmad_tasks"
+        fi
+        if [[ -n "$bmad_validation" ]]; then
+            bmad_context="$bmad_context ARTIFACT VALIDATION: $bmad_validation"
+        fi
+    fi
+
     if [ $retry -eq 0 ]; then
         if [ -n "$prd" ]; then
-            echo "Loki Mode with PRD at $prd. $human_directive $queue_tasks $checklist_status $app_runner_info $playwright_info $memory_context_section $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
+            echo "Loki Mode with PRD at $prd. $human_directive $queue_tasks $bmad_context $checklist_status $app_runner_info $playwright_info $memory_context_section $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
         else
-            echo "Loki Mode. $human_directive $queue_tasks $checklist_status $app_runner_info $playwright_info $memory_context_section $analysis_instruction $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
+            echo "Loki Mode. $human_directive $queue_tasks $bmad_context $checklist_status $app_runner_info $playwright_info $memory_context_section $analysis_instruction $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
         fi
     else
         if [ -n "$prd" ]; then
-            echo "Loki Mode - Resume iteration #$iteration (retry #$retry). PRD: $prd. $human_directive $queue_tasks $checklist_status $app_runner_info $playwright_info $memory_context_section $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
+            echo "Loki Mode - Resume iteration #$iteration (retry #$retry). PRD: $prd. $human_directive $queue_tasks $bmad_context $checklist_status $app_runner_info $playwright_info $memory_context_section $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
         else
-            echo "Loki Mode - Resume iteration #$iteration (retry #$retry). $human_directive $queue_tasks $checklist_status $app_runner_info $playwright_info $memory_context_section Use .loki/generated-prd.md if exists. $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
+            echo "Loki Mode - Resume iteration #$iteration (retry #$retry). $human_directive $queue_tasks $bmad_context $checklist_status $app_runner_info $playwright_info $memory_context_section Use .loki/generated-prd.md if exists. $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
         fi
     fi
 }
 
+#===============================================================================
+# BMAD Task Queue Population
+#===============================================================================
+
+# Populate the task queue from BMAD epic/story artifacts
+# Only runs once -- skips if queue was already populated from BMAD
+populate_bmad_queue() {
+    # Skip if no BMAD tasks file
+    if [[ ! -f ".loki/bmad-tasks.json" ]]; then
+        return 0
+    fi
+
+    # Skip if already populated (marker file)
+    if [[ -f ".loki/queue/.bmad-populated" ]]; then
+        log_info "BMAD queue already populated, skipping"
+        return 0
+    fi
+
+    log_step "Populating task queue from BMAD stories..."
+
+    # Ensure queue directory exists
+    mkdir -p ".loki/queue"
+
+    # Read BMAD tasks and create queue entries
+    python3 << 'BMAD_QUEUE_EOF' 2>/dev/null
+import json
+import os
+import sys
+
+bmad_tasks_path = ".loki/bmad-tasks.json"
+pending_path = ".loki/queue/pending.json"
+
+try:
+    with open(bmad_tasks_path, "r") as f:
+        bmad_data = json.load(f)
+except (json.JSONDecodeError, FileNotFoundError) as e:
+    print(f"Warning: Could not read BMAD tasks: {e}", file=sys.stderr)
+    sys.exit(0)
+
+# Extract stories from BMAD structure
+# Supports both flat list and nested epic/story format
+stories = []
+if isinstance(bmad_data, list):
+    stories = bmad_data
+elif isinstance(bmad_data, dict):
+    # Handle {"epics": [...]} or {"tasks": [...]} formats
+    for key in ("epics", "tasks", "stories"):
+        if key in bmad_data:
+            items = bmad_data[key]
+            if isinstance(items, list):
+                for item in items:
+                    if isinstance(item, dict) and "stories" in item:
+                        # Epic with nested stories
+                        epic_name = item.get("title", item.get("name", ""))
+                        for story in item["stories"]:
+                            if isinstance(story, dict):
+                                story.setdefault("epic", epic_name)
+                                stories.append(story)
+                    else:
+                        stories.append(item)
+            break
+
+if not stories:
+    print("No BMAD stories found to queue", file=sys.stderr)
+    sys.exit(0)
+
+# Load existing pending tasks (if any)
+existing = []
+if os.path.exists(pending_path):
+    try:
+        with open(pending_path, "r") as f:
+            data = json.load(f)
+            if isinstance(data, list):
+                existing = data
+            elif isinstance(data, dict) and "tasks" in data:
+                existing = data["tasks"]
+    except (json.JSONDecodeError, FileNotFoundError):
+        existing = []
+
+# Convert BMAD stories to queue task format
+for i, story in enumerate(stories):
+    if not isinstance(story, dict):
+        continue
+    task = {
+        "id": f"bmad-{i+1}",
+        "title": story.get("title", story.get("name", f"BMAD Story {i+1}")),
+        "description": story.get("description", story.get("action", "")),
+        "priority": story.get("priority", "medium"),
+        "source": "bmad",
+    }
+    epic = story.get("epic", "")
+    if epic:
+        task["epic"] = epic
+    acceptance = story.get("acceptance_criteria", story.get("criteria", []))
+    if acceptance:
+        task["acceptance_criteria"] = acceptance
+    existing.append(task)
+
+# Write updated pending queue
+with open(pending_path, "w") as f:
+    json.dump(existing, f, indent=2)
+
+print(f"Added {len(stories)} BMAD stories to task queue")
+BMAD_QUEUE_EOF
+
+    if [[ $? -ne 0 ]]; then
+        log_warn "Failed to populate BMAD queue (python3 error)"
+        return 0
+    fi
+
+    # Mark as populated so we don't re-add on restart
+    touch ".loki/queue/.bmad-populated"
+    log_info "BMAD queue population complete"
+}
+
 #===============================================================================
 # Main Autonomous Loop
 #===============================================================================
@@ -7130,6 +7272,9 @@ run_autonomous() {
         fi
     fi
 
+    # Populate task queue from BMAD artifacts (if present, runs once)
+    populate_bmad_queue
+
     # Check max iterations before starting
     if check_max_iterations; then
         log_error "Max iterations already reached. Reset with: rm .loki/autonomy-state.json"

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "6.0.0"
+__version__ = "6.1.0"
 
 # Expose the control app for easy import
 try:

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installation instructions for all platforms and use cases.
 
-**Version:** v6.0.0
+**Version:** v6.1.0
 
 ---