loki-mode 5.30.0 → 5.32.0

package/README.md

@@ -82,8 +82,44 @@ jobs:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           mode: review          # review, fix, or test
           provider: claude      # claude, codex, or gemini
-          max_iterations: 3     # higher = more thorough
-          budget_limit: '5.00'  # max cost in USD
+          max_iterations: 3     # sets LOKI_MAX_ITERATIONS env var
+          budget_limit: '5.00'  # max cost in USD (maps to --budget flag)
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+```
+
+**Prerequisites:**
+- An API key for your chosen provider (set as a repository secret):
+  - Claude: `ANTHROPIC_API_KEY`
+  - Codex: `OPENAI_API_KEY`
+  - Gemini: `GOOGLE_API_KEY`
+- The action automatically installs `loki-mode` and `@anthropic-ai/claude-code` (for the Claude provider)
+
+**Action Inputs:**
+
+| Input | Default | Description |
+|-------|---------|-------------|
+| `mode` | `review` | `review`, `fix`, or `test` |
+| `provider` | `claude` | `claude`, `codex`, or `gemini` |
+| `budget_limit` | `5.00` | Max cost in USD (maps to `--budget` CLI flag) |
+| `budget` | | Alias for `budget_limit` |
+| `max_iterations` | `3` | Sets `LOKI_MAX_ITERATIONS` env var |
+| `github_token` | (required) | GitHub token for PR comments |
+| `prd_file` | | Path to PRD file relative to repo root |
+| `auto_confirm` | `true` | Skip confirmation prompts (always true in CI) |
+| `install_claude` | `true` | Auto-install Claude Code CLI if not present |
+| `node_version` | `20` | Node.js version |
+
+**Using with a PRD file (fix/test modes):**
+
+```yaml
+- uses: asklokesh/loki-mode@v5
+  with:
+    mode: fix
+    prd_file: 'docs/my-prd.md'
+    github_token: ${{ secrets.GITHUB_TOKEN }}
+  env:
+    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 ```
 
 **Modes:**
@@ -390,6 +426,68 @@ Go get coffee. It'll be deployed when you get back.
 
 ---
 
+## Architecture
+
+```mermaid
+graph TB
+    PRD["PRD Document"] --> REASON
+
+    subgraph RARVC["RARV+C Cycle"]
+        direction TB
+        REASON["1. Reason"] --> ACT["2. Act"]
+        ACT --> REFLECT["3. Reflect"]
+        REFLECT --> VERIFY["4. Verify"]
+        VERIFY -->|"pass"| COMPOUND["5. Compound"]
+        VERIFY -->|"fail"| REASON
+        COMPOUND --> REASON
+    end
+
+    subgraph PROVIDERS["Provider Layer"]
+        CLAUDE["Claude Code<br/>(full features)"]
+        CODEX["Codex CLI<br/>(degraded)"]
+        GEMINI["Gemini CLI<br/>(degraded)"]
+    end
+
+    ACT --> PROVIDERS
+
+    subgraph AGENTS["Agent Swarms (41 types)"]
+        ENG["Engineering (8)"]
+        OPS["Operations (8)"]
+        BIZ["Business (8)"]
+        DATA["Data (3)"]
+        PROD["Product (3)"]
+        GROWTH["Growth (4)"]
+        REVIEW["Review (3)"]
+        ORCH["Orchestration (4)"]
+    end
+
+    PROVIDERS --> AGENTS
+
+    subgraph INFRA["Infrastructure"]
+        DASHBOARD["Dashboard<br/>(FastAPI + Web UI)"]
+        MEMORY["Memory System<br/>(Episodic/Semantic/Procedural)"]
+        COUNCIL["Completion Council<br/>(3-member voting)"]
+        QUEUE["Task Queue<br/>(.loki/queue/)"]
+    end
+
+    AGENTS --> QUEUE
+    VERIFY --> COUNCIL
+    REFLECT --> MEMORY
+    COMPOUND --> MEMORY
+    DASHBOARD -.->|"reads"| QUEUE
+    DASHBOARD -.->|"reads"| MEMORY
+```
+
+**Key components:**
+- **RARV+C Cycle** -- Reason, Act, Reflect, Verify, Compound. Every iteration follows this loop. Failed verification triggers retry from Reason.
+- **Provider Layer** -- Claude Code (full parallel agents, Task tool, MCP), Codex CLI and Gemini CLI (sequential, degraded mode).
+- **Agent Swarms** -- 41 specialized agent types across 7 swarms, spawned on demand based on project complexity.
+- **Completion Council** -- 3 members vote on whether the project is done. Anti-sycophancy devil's advocate on unanimous votes.
+- **Memory System** -- Episodic traces, semantic patterns, procedural skills. Progressive disclosure reduces context usage by 60-80%.
+- **Dashboard** -- FastAPI server reading `.loki/` flat files, with real-time web UI for task queue, agents, logs, and council state.
+
+---
+
 ## CLI Commands (v4.1.0)
 
 The `loki` CLI provides easy access to all Loki Mode features:

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.30.0
+# Loki Mode v5.32.0
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -267,4 +267,4 @@ Auto-detected or force with `LOKI_COMPLEXITY`:
 
 ---
 
-**v5.30.0 | Compound learning, specialist reviewers, deepen-plan | ~280 lines core**
+**v5.32.0 | loki doctor, dashboard themes, keyboard shortcuts, favicon | ~280 lines core**

package/VERSION

@@ -1 +1 @@
-5.30.0
+5.32.0