loki-mode 5.2.3 → 5.3.0

package/README.md

@@ -25,6 +25,16 @@
 
 ---
 
+## Presentation
+
+![Loki Mode Presentation](docs/loki-mode-presentation.gif)
+
+*9 slides: Problem, Solution, 37 Agents, RARV Cycle, Benchmarks, Multi-Provider, Full Lifecycle*
+
+**[Download PPTX](docs/loki-mode-presentation.pptx)** for offline viewing
+
+---
+
 ## Usage
 
 ### Option 1: Claude Code Skill (Recommended)

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.2.3
+# Loki Mode v5.3.0
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -88,15 +88,17 @@ These rules are ABSOLUTE. Violating them is a critical failure.
 
 ## Model Selection
 
-| Task Type | Tier | Claude | Codex | Gemini |
-|-----------|------|--------|-------|--------|
-| PRD analysis, architecture, system design | **planning** | opus | effort=xhigh | thinking=high |
-| Feature implementation, complex bugs | **development** | sonnet | effort=high | thinking=medium |
-| Code review (always 3 parallel reviewers) | **development** | sonnet | effort=high | thinking=medium |
-| Integration tests, E2E, deployment | **development** | sonnet | effort=high | thinking=medium |
-| Unit tests, linting, docs, simple fixes | **fast** | haiku | effort=low | thinking=low |
+**Default (v5.3.0):** Haiku disabled for quality. Use `--allow-haiku` or `LOKI_ALLOW_HAIKU=true` to enable.
 
-**Parallelization rule (Claude only):** Launch up to 10 haiku agents simultaneously for independent tasks.
+| Task Type | Tier | Claude (default) | Claude (--allow-haiku) | Codex | Gemini |
+|-----------|------|------------------|------------------------|-------|--------|
+| PRD analysis, architecture, system design | **planning** | opus | opus | effort=xhigh | thinking=high |
+| Feature implementation, complex bugs | **development** | opus | sonnet | effort=high | thinking=medium |
+| Code review (always 3 parallel reviewers) | **development** | opus | sonnet | effort=high | thinking=medium |
+| Integration tests, E2E, deployment | **development** | opus | sonnet | effort=high | thinking=medium |
+| Unit tests, linting, docs, simple fixes | **fast** | sonnet | haiku | effort=low | thinking=low |
+
+**Parallelization rule (Claude only):** Launch up to 10 agents simultaneously for independent tasks.
 
 **Degraded mode (Codex/Gemini):** No parallel agents or Task tool. Runs RARV cycle sequentially. See `skills/model-selection.md`.
 
@@ -227,4 +229,4 @@ Auto-detected or force with `LOKI_COMPLEXITY`:
 
 ---
 
-**v5.2.3 | CoVe + MemEvolve + Quality Gates | ~230 lines core**
+**v5.3.0 | Haiku Control Flag + Quality Model Defaults | ~240 lines core**

package/VERSION

@@ -1 +1 @@
-5.2.3
+5.3.0

package/autonomy/run.sh

@@ -53,6 +53,12 @@
 #   LOKI_PERPETUAL_MODE        - Ignore ALL completion signals (default: false)
 #                                Set to 'true' for truly infinite operation
 #
+# Model Selection:
+#   LOKI_ALLOW_HAIKU           - Enable Haiku model for fast tier (default: false)
+#                                When false: Opus for dev/bugfix, Sonnet for tests/docs
+#                                When true:  Sonnet for dev, Haiku for tests/docs (original)
+#                                Use --allow-haiku flag or set to 'true'
+#
 # 2026 Research Enhancements:
 #   LOKI_PROMPT_REPETITION     - Enable prompt repetition for Haiku agents (default: true)
 #                                arXiv 2512.14982v1: Improves accuracy 4-5x on structured tasks
@@ -3867,6 +3873,11 @@ main() {
                 PARALLEL_MODE=true
                 shift
                 ;;
+            --allow-haiku)
+                export LOKI_ALLOW_HAIKU=true
+                log_info "Haiku model enabled for fast tier"
+                shift
+                ;;
             --provider)
                 if [[ -n "${2:-}" ]]; then
                     LOKI_PROVIDER="$2"
@@ -3909,6 +3920,7 @@ main() {
                 echo ""
                 echo "Options:"
                 echo "  --parallel           Enable git worktree-based parallel workflows"
+                echo "  --allow-haiku        Enable Haiku model for fast tier (default: disabled)"
                 echo "  --provider <name>    Provider: claude (default), codex, gemini"
                 echo "  --help, -h           Show this help message"
                 echo ""

package/bin/postinstall.js

@@ -13,7 +13,7 @@ const skillDir = path.join(homeDir, '.claude', 'skills', 'loki-mode');
 const packageDir = path.join(__dirname, '..');
 
 console.log('');
-console.log('Loki Mode v5.2.3 installed!');
+console.log('Loki Mode v5.2.4 installed!');
 console.log('');
 
 // Try to create skill symlink

package/package.json

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

package/providers/claude.sh

@@ -44,13 +44,23 @@ PROVIDER_HAS_MCP=true
 PROVIDER_MAX_PARALLEL=10
 
 # Model Configuration (Abstract Tiers)
+# Default: Haiku disabled for quality. Use --allow-haiku or LOKI_ALLOW_HAIKU=true to enable.
 PROVIDER_MODEL_PLANNING="claude-opus-4-5-20251101"
-PROVIDER_MODEL_DEVELOPMENT="claude-sonnet-4-5-20251101"
-PROVIDER_MODEL_FAST="claude-haiku-4-5-20251101"
+PROVIDER_MODEL_DEVELOPMENT="claude-opus-4-5-20251101"  # Opus for dev (was sonnet)
+if [ "${LOKI_ALLOW_HAIKU:-false}" = "true" ]; then
+    PROVIDER_MODEL_FAST="claude-haiku-4-5-20251101"
+    PROVIDER_MODEL_DEVELOPMENT="claude-sonnet-4-5-20251101"  # Sonnet for dev when haiku enabled
+else
+    PROVIDER_MODEL_FAST="claude-sonnet-4-5-20251101"  # Sonnet for fast (no haiku)
+fi
 
 # Model Selection (for Task tool)
 PROVIDER_TASK_MODEL_PARAM="model"
-PROVIDER_TASK_MODEL_VALUES=("opus" "sonnet" "haiku")
+if [ "${LOKI_ALLOW_HAIKU:-false}" = "true" ]; then
+    PROVIDER_TASK_MODEL_VALUES=("opus" "sonnet" "haiku")
+else
+    PROVIDER_TASK_MODEL_VALUES=("opus" "sonnet")  # No haiku option
+fi
 
 # Context and Limits
 PROVIDER_CONTEXT_WINDOW=200000
@@ -87,14 +97,28 @@ provider_invoke() {
 }
 
 # Model tier to Task tool model parameter value
+# Respects LOKI_ALLOW_HAIKU flag for tier mapping
 provider_get_tier_param() {
     local tier="$1"
-    case "$tier" in
-        planning) echo "opus" ;;
-        development) echo "sonnet" ;;
-        fast) echo "haiku" ;;
-        *) echo "sonnet" ;;  # default to development tier
-    esac
+    if [ "${LOKI_ALLOW_HAIKU:-false}" = "true" ]; then
+        # With haiku: original tier mapping
+        case "$tier" in
+            planning) echo "opus" ;;
+            development) echo "sonnet" ;;
+            fast) echo "haiku" ;;
+            *) echo "sonnet" ;;
+        esac
+    else
+        # Without haiku (default): upgrade all tiers
+        # - Development + bug fixes -> opus
+        # - Testing + documentation -> sonnet
+        case "$tier" in
+            planning) echo "opus" ;;
+            development) echo "opus" ;;  # Upgraded from sonnet
+            fast) echo "sonnet" ;;       # Upgraded from haiku
+            *) echo "opus" ;;            # Default to opus
+        esac
+    fi
 }
 
 # Tier-aware invocation (Claude supports model selection via --model flag)

package/skills/model-selection.md

@@ -20,11 +20,33 @@ Loki Mode supports three AI providers. Claude has full features; Codex and Gemin
 
 ## Abstract Model Tiers
 
-| Tier | Purpose | Claude | Codex | Gemini |
-|------|---------|--------|-------|--------|
-| **planning** | PRD analysis, architecture, system design | opus | effort=xhigh | thinking=high |
-| **development** | Feature implementation, complex bugs, tests | sonnet | effort=high | thinking=medium |
-| **fast** | Unit tests, docs, linting, simple tasks | haiku | effort=low | thinking=low |
+**Default (v5.3.0):** Haiku disabled for quality. All tasks use Opus or Sonnet.
+
+| Tier | Purpose | Claude (default) | Claude (--allow-haiku) | Codex | Gemini |
+|------|---------|------------------|------------------------|-------|--------|
+| **planning** | PRD analysis, architecture, system design | opus | opus | effort=xhigh | thinking=high |
+| **development** | Feature implementation, complex bugs, tests | opus | sonnet | effort=high | thinking=medium |
+| **fast** | Unit tests, docs, linting, simple tasks | sonnet | haiku | effort=low | thinking=low |
+
+### Enabling Haiku
+
+To enable Haiku for fast-tier tasks (cost optimization at potential quality trade-off):
+
+```bash
+# Via environment variable
+LOKI_ALLOW_HAIKU=true ./autonomy/run.sh ./prd.md
+
+# Via CLI flag
+./autonomy/run.sh --allow-haiku ./prd.md
+
+# Via loki CLI wrapper
+loki start --allow-haiku ./prd.md
+```
+
+When Haiku is enabled:
+- Development tier uses Sonnet (instead of Opus)
+- Fast tier uses Haiku (instead of Sonnet)
+- Planning tier always uses Opus (unchanged)
 
 ---
 
@@ -36,7 +58,7 @@ Loki Mode supports three AI providers. Claude has full features; Codex and Gemin
 | **development** | Development, QA, Deployment | Feature implementation, complex bugs, integration/E2E tests, code review, deployment |
 | **fast** | All other operations (parallel for Claude) | Unit tests, docs, bash commands, linting, monitoring |
 
-**Claude-specific model names:** opus, sonnet, haiku
+**Claude-specific model names:** opus, sonnet, haiku (haiku requires --allow-haiku flag)
 **Codex effort levels:** xhigh, high, medium, low
 **Gemini thinking levels:** high, medium, low