loki-mode 5.3.0 → 5.4.1

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes PRD to deployed product with zero human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v5.3.0
+# Loki Mode v5.4.1
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -182,11 +182,11 @@ GROWTH ──[continuous improvement loop]──> GROWTH
 ```bash
 # Standard mode (Claude - full features)
 claude --dangerously-skip-permissions
-# Then say: "Loki Mode" or "Loki Mode with PRD at path/to/prd.md"
+# Then say: "Loki Mode" or "Loki Mode with PRD at path/to/prd.md" (or .json)
 
-# With provider selection
+# With provider selection (supports .md and .json PRDs)
 ./autonomy/run.sh --provider claude ./prd.md   # Default, full features
-./autonomy/run.sh --provider codex ./prd.md    # GPT-5.2 Codex, degraded mode
+./autonomy/run.sh --provider codex ./prd.json  # GPT-5.2 Codex, degraded mode
 ./autonomy/run.sh --provider gemini ./prd.md   # Gemini 3 Pro, degraded mode
 
 # Or via CLI wrapper
@@ -210,11 +210,23 @@ When running with `autonomy/run.sh`, you can intervene:
 | Method | Effect |
 |--------|--------|
 | `touch .loki/PAUSE` | Pauses after current session |
-| `echo "instructions" > .loki/HUMAN_INPUT.md` | Injects instructions into next prompt |
+| `echo "instructions" > .loki/HUMAN_INPUT.md` | Injects directive into next prompt (executed immediately) |
 | `touch .loki/STOP` | Stops immediately |
 | Ctrl+C (once) | Pauses, shows options |
 | Ctrl+C (twice) | Exits immediately |
 
+### Hints vs Directives
+
+| Type | File | Behavior |
+|------|------|----------|
+| **Hint** | `.loki/CONTINUITY.md` "Mistakes & Learnings" | Passive memory - remembered but not acted upon |
+| **Directive** | `.loki/HUMAN_INPUT.md` | Active instruction - executed BEFORE normal tasks |
+
+**Example directive** (check all .astro files):
+```bash
+echo "Check all .astro files for missing BaseLayout imports. Fix any issues found. Add a compilation test to prevent this regression." > .loki/HUMAN_INPUT.md
+```
+
 ---
 
 ## Complexity Tiers (v3.4.0)
@@ -229,4 +241,4 @@ Auto-detected or force with `LOKI_COMPLEXITY`:
 
 ---
 
-**v5.3.0 | Haiku Control Flag + Quality Model Defaults | ~240 lines core**
+**v5.4.1 | Empty Array Fix | ~245 lines core**

package/VERSION

@@ -1 +1 @@
-5.3.0
+5.4.1

package/autonomy/run.sh

@@ -583,7 +583,25 @@ detect_complexity() {
     local prd_complexity="standard"
     if [ -n "$prd_path" ] && [ -f "$prd_path" ]; then
         local prd_words=$(wc -w < "$prd_path" | tr -d ' ')
-        local feature_count=$(grep -c "^##\|^- \[" "$prd_path" 2>/dev/null || echo "0")
+        local feature_count=0
+
+        # Detect PRD format and count features accordingly
+        if [[ "$prd_path" == *.json ]]; then
+            # JSON PRD: count features, requirements, tasks arrays
+            if command -v jq &>/dev/null; then
+                feature_count=$(jq '
+                    [.features, .requirements, .tasks, .user_stories, .epics] |
+                    map(select(. != null) | if type == "array" then length else 0 end) |
+                    add // 0
+                ' "$prd_path" 2>/dev/null || echo "0")
+            else
+                # Fallback: count array elements by pattern
+                feature_count=$(grep -c '"title"\|"name"\|"feature"\|"requirement"' "$prd_path" 2>/dev/null || echo "0")
+            fi
+        else
+            # Markdown PRD: count headers and checkboxes
+            feature_count=$(grep -c "^##\|^- \[" "$prd_path" 2>/dev/null || echo "0")
+        fi
 
         if [ "$prd_words" -lt 200 ] && [ "$feature_count" -lt 5 ]; then
             prd_complexity="simple"
@@ -3261,17 +3279,23 @@ build_prompt() {
         fi
     fi
 
+    # Human directive injection (from HUMAN_INPUT.md)
+    local human_directive=""
+    if [ -n "${LOKI_HUMAN_INPUT:-}" ]; then
+        human_directive="HUMAN_DIRECTIVE (PRIORITY): $LOKI_HUMAN_INPUT Execute this directive BEFORE continuing normal tasks."
+    fi
+
     if [ $retry -eq 0 ]; then
         if [ -n "$prd" ]; then
-            echo "Loki Mode with PRD at $prd. $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
+            echo "Loki Mode with PRD at $prd. $human_directive $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
         else
-            echo "Loki Mode. $analysis_instruction $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
+            echo "Loki Mode. $human_directive $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. $context_injection $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
+            echo "Loki Mode - Resume iteration #$iteration (retry #$retry). PRD: $prd. $human_directive $context_injection $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
         else
-            echo "Loki Mode - Resume iteration #$iteration (retry #$retry). $context_injection 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 $context_injection Use .loki/generated-prd.md if exists. $rarv_instruction $memory_instruction $compaction_reminder $completion_instruction $sdlc_instruction $autonomous_suffix"
         fi
     fi
 }
@@ -3290,10 +3314,14 @@ run_autonomous() {
         log_step "No PRD provided, searching for existing PRD files..."
         local found_prd=""
 
-        # Search common PRD file patterns
-        for pattern in "PRD.md" "prd.md" "REQUIREMENTS.md" "requirements.md" "SPEC.md" "spec.md" \
-                       "docs/PRD.md" "docs/prd.md" "docs/REQUIREMENTS.md" "docs/requirements.md" \
-                       "docs/SPEC.md" "docs/spec.md" ".github/PRD.md" "PROJECT.md" "project.md"; do
+        # Search common PRD file patterns (markdown and JSON)
+        for pattern in "PRD.md" "prd.md" "PRD.json" "prd.json" \
+                       "REQUIREMENTS.md" "requirements.md" "requirements.json" \
+                       "SPEC.md" "spec.md" "spec.json" \
+                       "docs/PRD.md" "docs/prd.md" "docs/PRD.json" "docs/prd.json" \
+                       "docs/REQUIREMENTS.md" "docs/requirements.md" "docs/requirements.json" \
+                       "docs/SPEC.md" "docs/spec.md" "docs/spec.json" \
+                       ".github/PRD.md" ".github/PRD.json" "PROJECT.md" "project.md" "project.json"; do
             if [ -f "$pattern" ]; then
                 found_prd="$pattern"
                 break
@@ -3306,6 +3334,9 @@ run_autonomous() {
         elif [ -f ".loki/generated-prd.md" ]; then
             log_info "Using previously generated PRD: .loki/generated-prd.md"
             prd_path=".loki/generated-prd.md"
+        elif [ -f ".loki/generated-prd.json" ]; then
+            log_info "Using previously generated PRD: .loki/generated-prd.json"
+            prd_path=".loki/generated-prd.json"
         else
             log_info "No PRD found - will analyze codebase and generate one"
         fi
@@ -3341,6 +3372,15 @@ run_autonomous() {
             return 0
         fi
 
+        # Check for human intervention (PAUSE, HUMAN_INPUT.md, STOP)
+        local intervention_result
+        intervention_result=$(check_human_intervention; echo $?)
+        intervention_result=${intervention_result##*$'\n'}  # Get exit code
+        case $intervention_result in
+            1) continue ;;  # PAUSE handled, restart loop
+            2) return 0 ;;  # STOP requested
+        esac
+
         local prompt=$(build_prompt $retry "$prd_path" $ITERATION_COUNT)
 
         echo ""
@@ -3941,7 +3981,12 @@ main() {
                 ;;
         esac
     done
-    set -- "${REMAINING_ARGS[@]}"
+    # Safe expansion for empty arrays with set -u
+    if [ ${#REMAINING_ARGS[@]} -gt 0 ]; then
+        set -- "${REMAINING_ARGS[@]}"
+    else
+        set --
+    fi
 
     # Validate PRD if provided
     if [ -n "$PRD_PATH" ] && [ ! -f "$PRD_PATH" ]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "5.3.0",
+  "version": "5.4.1",
   "description": "Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "claude",