loki-mode 7.45.1 → 7.46.0

package/docs/COMPARISON.md

@@ -14,8 +14,8 @@
 | **Type** | Skill/Framework | Enterprise Platform | Standalone Agent | Cloud Agent | AI IDE | CLI Agent | AI IDE | AI IDE | Cloud Agent | AI IDE (OSS) |
 | **Autonomy Level** | High (minimal human) | High | Full | High | Medium-High | High | High | High | High | High |
 | **Max Runtime** | Unlimited | Async/Scheduled | Hours | Per-task | Session | Session | Days | Async | Per-task | Session |
-| **Pricing** | Free (OSS) | Enterprise | $20/mo | ChatGPT Plus | $20/mo | API costs | Free preview | Free preview | $19/mo | Free (OSS) |
-| **Open Source** | Yes | No | No | No | No | No | No | No | No | Yes |
+| **Pricing** | Free (source-available) | Enterprise | $20/mo | ChatGPT Plus | $20/mo | API costs | Free preview | Free preview | $19/mo | Free (OSS) |
+| **Source model** | Source-available (BUSL-1.1) | No | No | No | No | No | No | No | No | Yes |
 | **GitHub Stars** | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | 70.9k |
 
 ---
@@ -37,7 +37,7 @@
 |---------|--------------|-----------|-----------|------------|----------|-----------------|--------------|--------------|
 | **Code Review** | 3 blind reviewers + devil's advocate | Basic | Basic | BugBot PR | Property-based | Artifacts | Doc/Review | Basic |
 | **Anti-Sycophancy** | Yes (CONSENSAGENT) | No | No | No | No | No | No | No |
-| **Quality Gates** | 11 gates + PBT | Basic | Sandbox | Tests | Spec validation | Artifact checks | Tests | Permissions |
+| **Quality Gates** | 8 gates + PBT | Basic | Sandbox | Tests | Spec validation | Artifact checks | Tests | Permissions |
 | **Constitutional AI** | Yes (principles) | No | Refusal training | No | No | No | No | No |
 
 ---
@@ -146,10 +146,10 @@
 
 | Feature | **Zencoder** | **Loki Mode** | **Assessment** |
 |---------|-------------|---------------|----------------|
-| **Four Pillars** | Structured Workflows, SDD, Multi-Agent Verification, Parallel Execution | SDLC + RARV + 9 Gates + Worktrees | TIE |
+| **Four Pillars** | Structured Workflows, SDD, Multi-Agent Verification, Parallel Execution | SDLC + RARV + 8 Gates + Worktrees | TIE |
 | **Spec-Driven Dev** | Specs as first-class objects | OpenAPI-first | TIE |
 | **Multi-Agent Verification** | Model diversity (Claude vs OpenAI, 54% improvement) | 3 blind reviewers + devil's advocate | Different approach (N/A for Claude Code - only Claude models) |
-| **Quality Gates** | Built-in verification loops | 7 explicit gates + anti-sycophancy | **Loki Mode** |
+| **Quality Gates** | Built-in verification loops | 8 explicit gates + anti-sycophancy | **Loki Mode** |
 | **Memory System** | Not documented | 3-tier episodic/semantic/procedural | **Loki Mode** |
 | **Agent Specialization** | Custom Zen Agents | 41 pre-defined specialized agent roles | **Loki Mode** |
 | **CI Failure Analysis** | Explicit pattern with auto-fix | DevOps agent only | **ADOPTED from Zencoder** |
@@ -178,7 +178,7 @@
 
 ### Where Loki Mode EXCEEDS Zencoder
 
-1. **Quality Control**: 7 explicit gates + blind review + devil's advocate vs built-in loops
+1. **Quality Control**: 8 explicit gates + blind review + devil's advocate vs built-in loops
 2. **Memory System**: 3-tier (episodic/semantic/procedural) with cross-project learning
 3. **Agent Specialization**: 41 pre-defined specialized agent roles across 8 domains
 4. **Anti-Sycophancy**: CONSENSAGENT patterns prevent reviewer groupthink
@@ -207,7 +207,7 @@
 | **Skills** | Progressive disclosure | 6 slash commands | N/A | 129 skills | N/A | 35 skills | Memory focus |
 | **Multi-Provider** | Yes (Claude/Codex/Gemini) | 3 CLIs (separate) | No | No | No | No | No |
 | **Memory System** | 3-tier (episodic/semantic/procedural) | None | N/A | N/A | Hybrid | N/A | SQLite+FTS5 |
-| **Quality Gates** | 11 gates + Completion Council | User verify only | Two-Stage Review | N/A | Consensus | Tiered | N/A |
+| **Quality Gates** | 8 gates + Completion Council | User verify only | Two-Stage Review | N/A | Consensus | Tiered | N/A |
 | **Context Mgmt** | Standard | Fresh per task (core innovation) | Fresh per task | N/A | N/A | N/A | Progressive |
 | **Autonomy** | High (minimal human) | Semi (checkpoints) | Human-guided | Human-guided | Orchestrated | Human-guided | N/A |
 
@@ -232,7 +232,7 @@ These are patterns from competing projects that are **practically and scientific
 |----------|---------|-------------------------|
 | **Multi-Provider Support** | Only skill supporting Claude, Codex, and Gemini with graceful degradation | All 8 competitors are Claude-only |
 | **RARV Cycle** | Reason-Act-Reflect-Verify is more rigorous than Plan-Execute | Most use simple Plan-Execute |
-| **11-Gate Quality System** | Static analysis + 3 reviewers + devil's advocate + anti-sycophancy + severity blocking + coverage + debate + backward-compat (healing) + Phase 1 closure | Superpowers has 2-stage, others have less |
+| **8-Gate Quality System** | Static analysis + test suite (pass/fail) + 3 blind reviewers with severity blocking + devil's advocate + mock-integrity + test-mutation + documentation coverage + Magic Modules debate (backward-compat is a conditional healing auditor) + Phase 1 closure | Superpowers has 2-stage, others have less |
 | **Constitutional AI Integration** | Principles-based self-critique from Anthropic research | None have this |
 | **Anti-Sycophancy (CONSENSAGENT)** | Blind review + devil's advocate prevents groupthink | None have this |
 | **Provider Abstraction Layer** | Clean degradation from full-featured to sequential-only | Claude-only projects can't degrade |
@@ -359,12 +359,12 @@ Tiered agent architecture with explicit escalation:
 |-----------|-------------------|
 | **Autonomy** | Designed for high autonomy with minimal human intervention |
 | **Multi-Agent** | 41 prompt-defined agent roles in 8 domains adopted per phase (parallel review council + optional worktree streams on Claude, sequential elsewhere) vs 1-8 in competitors, with all output gated by blind review + council |
-| **Quality** | 11 gates + blind review + devil's advocate + property-based testing |
+| **Quality** | 8 gates + blind review + devil's advocate + property-based testing |
 | **Research** | 10+ academic papers integrated vs proprietary/undisclosed |
 | **Anti-Sycophancy** | Only agent with CONSENSAGENT-based blind review |
 | **Memory** | 3-tier memory (episodic/semantic/procedural) + review learning + cross-project |
 | **Transformation** | Code migration workflows (language, database, framework) |
-| **Cost** | Free (open source) vs $20-500/month |
+| **Cost** | Free (source-available, BUSL-1.1) vs $20-500/month |
 | **Customization** | Full source access vs black box |
 
 ---

package/docs/COMPETITIVE-ANALYSIS.md

@@ -20,7 +20,7 @@ GSD is the closest competitor -- a context engineering system that spawns fresh
 | Adoption | 594 stars, 6K/wk npm | 11,903 stars, 21K/wk npm | GSD (20x) |
 | Simplicity | Complex (5.4K-line run.sh, 12 Python modules) | Simple (markdown agents + slash commands) | GSD |
 | Full autonomy | Walk away, come back to deployed product | Human checkpoints at discuss/verify/milestone | Loki |
-| Quality gates | 9-gate + Completion Council + anti-sycophancy | User verification only | Loki |
+| Quality gates | 8-gate + Completion Council + anti-sycophancy | User verification only | Loki |
 | Memory system | Episodic/semantic/procedural + vector search | None | Loki |
 | Context management | Standard | Fresh subagent contexts per task (core innovation) | GSD |
 | Time to value | Learn architecture, understand CLI flags | `npx get-shit-done-cc` and go | GSD |

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 The flagship product of [Autonomi](https://www.autonomi.dev/). Loki Mode is a spec-driven autonomous builder with a built-in trust layer that takes any spec to a deployed product and verifies completion with evidence (quality gates plus a completion council), not just a "done" claim. Complete installation instructions for all platforms and use cases.
 
-**Version:** v7.45.1
+**Version:** v7.46.0
 
 ---
 
@@ -389,7 +389,7 @@ provider works inside the container. Provide auth with your Anthropic API key:
 # Run Loki Mode in Docker (Claude provider, API-key auth)
 docker run --rm -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:7.45.1 start ./my-spec.md
+  asklokesh/loki-mode:7.46.0 start ./my-spec.md
 ```
 
 ##### docker compose + .env (no host install)

package/docs/P0-SWEEP-PLAN.md

@@ -0,0 +1,163 @@
+# P0 Verification-Credibility Sweep -- Architecture Plan
+
+Persisted from the Architect (opus). Every line number re-verified by grep.
+Goal: make Loki's verification layer honest and real. A hollow wedge is
+existential for a "proof of done" product. Fix or remove every false/hollow gate
+claim, wire the unwired detectors, make anti-sycophancy act.
+
+## 0. Verified ground truth
+
+- P0-1: enforce_test_coverage() at autonomy/run.sh:7031. `local coverage_pct=0`
+  at 7038 is never reassigned; no coverage tool invoked. 7257 emits min_coverage
+  (the threshold), not a measured value. Gate decides purely on test_passed.
+- P0-2: skills/quality-gates.md:5-17 lists 11 gates; gates 1 (Input Guardrails)
+  and 5 (Output Guardrails) have NO gate function. wiki/Quality-Gates.md:14-28
+  duplicates. (21 'guardrail' refs in autonomy/ are CLI help/comments/flags.)
+- P0-3: tests/detect-mock-problems.sh + tests/detect-test-mutations.sh invoked
+  0 times in autonomy/run.sh. quality-gates.md:74-77 claims HIGH=FAIL.
+- P0-4: anti-sycophancy block run.sh:8316-8323 only logs + writes
+  anti-sycophancy.txt. No Devil's-Advocate re-review. INERT. Bun mirror
+  loki-ts/src/runner/quality_gates.ts:804-808 equally inert.
+- Gate inventory: phantom (Input/Output Guardrails); wired-but-unlisted
+  (run_magic_debate_gate at run.sh:14067); "Gate 10 Backward Compat" is the
+  legacy-healing-auditor SPECIALIST (run.sh:7875-7979), conditional, not a loop
+  gate; "Gate 6 Severity Blocking" is the block policy inside code review, not a
+  function.
+
+### Functions actually invoked in orchestration (run.sh:13938-14084)
+enforce_static_analysis (13945); enforce_test_coverage (13967); run_code_review
+(13987); run_doc_quality_gate (14058); run_magic_debate_gate (14070); plus
+conditional legacy-healing-auditor reviewer.
+
+## 1. Canonical final gate list (THE CONTRACT -- docs transcribe, never recompute)
+
+Honest count after this sweep: 8 gates.
+
+| # | Gate | Function / mechanism | Blocking | Opt-out flag |
+|---|------|---------------------|----------|--------------|
+| 1 | Static Analysis | enforce_static_analysis (run.sh:6699) | Yes (ladder) | PHASE_STATIC_ANALYSIS=false |
+| 2 | Test Suite (pass/fail) | enforce_test_coverage (run.sh:7031) | Yes (red blocks) | PHASE_UNIT_TESTS=false |
+| 3 | Blind Code Review (3-reviewer council + severity blocking) | run_code_review (run.sh:7788) | Yes (Crit/High block) | PHASE_CODE_REVIEW=false |
+| 4 | Anti-Sycophancy / Devil's Advocate (on unanimous PASS) | run_code_review sub-step (run.sh:8316+) | Yes (DA Crit/High block) | LOKI_GATE_DEVILS_ADVOCATE=false |
+| 5 | Mock Integrity Detector | enforce_mock_integrity -> tests/detect-mock-problems.sh | Yes (HIGH blocks) | LOKI_GATE_MOCK=false |
+| 6 | Test Mutation Detector | enforce_mutation_integrity -> tests/detect-test-mutations.sh | Yes (HIGH blocks) | LOKI_GATE_MUTATION=false |
+| 7 | Documentation Coverage | run_doc_quality_gate (run.sh:7388) | Yes | LOKI_GATE_DOC_COVERAGE=false |
+| 8 | Magic Modules Debate | run_magic_debate_gate (run.sh:7495) | Yes (BLOCK sev) | LOKI_GATE_MAGIC_DEBATE=false |
+
+Conditional auditor (documented separately, NOT numbered): Backward-Compatibility
+/ legacy-healing-auditor (healing mode only). Removed: Input/Output Guardrails.
+
+### Doc files to update to "8 gates" (docs owner)
+README.md (22,29,196,255); SKILL.md (3,10); CLAUDE.md (44);
+plugins/loki-mode/README.md (4); wiki/Quality-Gates.md (14-48);
+wiki/Environment-Variables.md (62); wiki/Home.md (3,13); wiki/CLI-Reference.md
+(230); docs/cursor-comparison.md (14,177,195); docs/COMPARISON.md (40,210,362);
+skills/quality-gates.md (5,13,14-17,19-66,69-82,650,655,668); skills/00-index.md
+(51). CHANGELOG.md: NEW top entry ONLY; never rewrite historical entries
+(5837/6181/6335/6340).
+
+## 2. P0-1 Coverage honesty (Fix B) -- Slice A (run.sh owner) + Slice B (docs)
+- run.sh: remove dead `local coverage_pct=0` (7038). Relabel logs: 13966
+  "test suite (pass/fail)"; 7265/7270 "Test suite gate".
+- KEEP the min_coverage JSON field at 7257 (consumed by autonomy/loki:27529-27530,
+  16138 and asserted in tests/test-report-command.sh:116,
+  tests/test-completion-council-affirmative-evidence.sh:126,
+  tests/test-evidence-gate.sh:155). Only change misleading consumer strings in
+  autonomy/loki (27530, 16138) to "Min coverage TARGET (not measured)".
+- docs (skills/quality-gates.md): :13 drop ">80% coverage" -> "coverage % not
+  measured in this release"; :650/:655 reword to pass/fail + target-only; :668
+  remove coverage.json artifact line. Note Fix A (real measurement) as follow-up.
+
+## 3. P0-2 Phantom guardrails -- Slice B (docs only)
+Remove gates 1 & 5 entirely (do not "mark planned"). Renumber to the 8-gate
+table. Edit skills/quality-gates.md:5-17, wiki/Quality-Gates.md:14-28, + all
+list files in section 1.
+
+## 4. P0-3 Wire detectors -- Slice A (run.sh) + Slice D (scripts) + Slice C (Bun)
+Exit-code asymmetry (load-bearing):
+- detect-mock-problems.sh exits 1 on CRITICAL/HIGH (179-182), 0 otherwise.
+  Exit code already = block-on-HIGH.
+- detect-test-mutations.sh exits 0 unless --strict; --strict blocks on ANY
+  finding (over-blocks MED/LOW). DO NOT use --strict. Wrapper greps stdout for
+  [HIGH] to decide block; route MED/LOW to findings injection.
+
+New run.sh functions (place after run_magic_debate_gate ~7560):
+  enforce_mock_integrity()      # HIGH -> return 1; MED/LOW -> findings file
+  enforce_mutation_integrity()  # grep -c '\[HIGH\]' >0 -> return 1; MED/LOW -> findings
+Both cd "${TARGET_DIR}", use LOKI_GATE_TIMEOUT wrapping, write findings into
+${TARGET_DIR}/.loki/quality/ for the Phase-1 findings injector.
+
+Orchestration insert: after the pause-check at 13983, before code-review at
+13985. Mirror the existing pattern with track_gate_failure/clear_gate_failure +
+gate_failures string. Toggles LOKI_GATE_MOCK / LOKI_GATE_MUTATION (matches
+existing LOKI_GATE_DOC_COVERAGE / LOKI_GATE_MAGIC_DEBATE convention).
+
+Detector-script (Slice D): optional --block-high mode on detect-test-mutations.sh
+(exit 2 on HIGH) keeping --strict intact; OR rely on wrapper grep (no script
+change). Verify detect-mock-problems.sh exit semantics. Do NOT touch run.sh.
+
+## 5. P0-4 Anti-sycophancy acts -- Slice A (run.sh) + Slice C (Bun)
+Read run_code_review 7788-8316 first. At 8316-8323 unanimous block: dispatch ONE
+Devil's-Advocate reviewer reusing the existing reviewer-invocation +
+parse_verdict helpers; if DA returns Crit/High set has_blocking=true so the
+EXISTING block at 8326-8330 fires (return 1). Keep anti-sycophancy.txt for audit.
+Gate behind LOKI_GATE_DEVILS_ADVOCATE (default true).
+
+## 6. P0-5 Honest per-gate table -- Slice B (docs)
+Replace skills/quality-gates.md:5-17 + prose 19-82 with the 8-gate table plus
+columns: detects X / does NOT detect Y / opt-out flag / blocking. Honesty
+entries: gate 2 "does NOT detect coverage %"; gate 5 "does NOT detect semantic
+correctness of mocks"; gate 6 "does NOT detect logically-correct-but-weak
+assertions".
+
+## 7. Bash <-> Bun parity matrix
+| Change | Bun mirror | File |
+|--------|-----------|------|
+| P0-1 label/honesty | Yes (light) | quality_gates.ts runTestCoverage (402): no false % strings |
+| P0-2 gate count | docs only | -- |
+| P0-3 mock gate | Yes | quality_gates.ts: add mock_integrity to GateName (69-74) + runMockIntegrity + sequence (1474-1480) + toggle |
+| P0-3 mutation gate | Yes | quality_gates.ts: add mutation_integrity + runMutationIntegrity + sequence + toggle |
+| P0-4 devil's advocate | Yes | quality_gates.ts runCodeReview (709), inert at 804-808: add DA dispatch + block |
+| P0-5 doc table | docs only | -- |
+Bun escalation ladder is generic; new gates inherit once added to union+sequence.
+
+## 8. Slice boundaries (independent; no file collisions)
+- Slice A -- run.sh runtime (ONE owner, serialized): P0-1 (run.sh + autonomy/loki
+  strings), P0-3 new funcs + orchestration insert, P0-4. Owns autonomy/run.sh +
+  autonomy/loki exclusively.
+- Slice B -- Docs (ONE owner): P0-2 + P0-5 + all "11->8 gates" edits. Both edit
+  skills/quality-gates.md so MUST be one slice. New CHANGELOG entry only.
+- Slice C -- Bun parity (ONE owner): loki-ts/src/runner/quality_gates.ts only.
+- Slice D -- Detector scripts (ONE owner): tests/detect-test-mutations.sh
+  --block-high; verify detect-mock-problems.sh. No run.sh.
+- Slice E -- SDET tests (ONE owner; after A/C/D): fixtures + assertions.
+Order: D and B parallel anytime; A depends on D contract; C mirrors A; E last.
+
+## 9. Test plan (SDET, Slice E)
+- P0-1: grep assert no ">80%"/"min_coverage: 80% # Never drop"/"coverage.json"
+  in any list doc. Behavior: passing tests pass, failing tests block.
+- P0-2: grep assert zero live "11 gates"/"Input Guardrails"/"Output Guardrails"
+  (CHANGELOG excepted); "8" present in quality-gates.md + wiki.
+- P0-3 mock: fixture with tautological assertion -> enforce_mock_integrity
+  returns 1, BLOCKS, track_gate_failure increments. Clean -> 0, clears. MED-only
+  -> 0 + findings file.
+- P0-3 mutation: fixture commit changing assertion values + impl (HIGH) ->
+  returns 1, BLOCKS. MED-only -> 0 + findings (proves not over-blocking).
+- P0-4: unanimous PASS + DA High -> run_code_review returns 1. Unanimous PASS +
+  DA clean -> 0 + anti-sycophancy.txt exists.
+- Parity: Bun sequence includes mock_integrity + mutation_integrity; runCodeReview
+  blocks on DA High; existing loki-ts tests green.
+
+## 10. Risks + binding constraints
+Risks: (1) min_coverage JSON field has live consumers + 3 test assertions -- keep
+field, fix strings only. (2) mutation --strict over-blocks -- parse HIGH instead.
+(3) detectors run against TARGET project test files -- cd TARGET_DIR + timeout
+wrap. (4) stale cross-file comment line refs exist; do not chase, do not add new.
+
+Binding constraints (every dev agent): NO version bumps (integrator once); NO
+commits/push; NO emojis; NO em dashes; full gate applies (touches runtime/gates/
+parity); stay inside your slice file ownership; run.sh is single-owner.
+
+Canonical count decision: 8 (recommended). Keeping backward-compat numbered
+would make it 9 but reintroduces the listed-but-not-a-loop-gate honesty gap this
+sweep exists to close.

package/docs/architecture/STATE-MACHINES.md

@@ -972,7 +972,7 @@ Source: `run.sh:7880-7881` (checklist_should_verify, checklist_verify)
 
 ## 7. Quality Gates
 
-### 7.1 Nine-Gate Pipeline
+### 7.1 Eight-Gate Pipeline
 
 Source: `skills/quality-gates.md`
 
@@ -980,40 +980,39 @@ Source: `skills/quality-gates.md`
   Code Change
       |
       v
-  Gate 1: Static Analysis (CodeQL, ESLint)
-      |──BLOCK (critical findings)──> [REJECTED]
+  Gate 1: Static Analysis (CodeQL, ESLint/Pylint, type-checker)
+      |──BLOCK (severity ladder)──> [REJECTED]
       v
-  Gate 2: Type Check (tsc --noEmit)
+  Gate 2: Test Suite (pass/fail; red blocks; coverage % not measured this release)
       |──BLOCK──> [REJECTED]
       v
-  Gate 3: Unit Tests (>80% coverage, 100% pass)
-      |──BLOCK──> [REJECTED]
-      v
-  Gate 4: Integration Tests
-      |──BLOCK──> [REJECTED]
-      v
-  Gate 5: 3-Reviewer Blind Review (see 7.3)
+  Gate 3: Blind 3-Reviewer Review with severity blocking (see 7.3)
       |──BLOCK (Critical/High severity)──> [REJECTED]
       v
-  Gate 6: Anti-Sycophancy Check
-      |──BLOCK (devil's advocate finds issues)──> [REJECTED]
+  Gate 4: Anti-Sycophancy Devil's Advocate (on unanimous PASS)
+      |──BLOCK (devil's advocate Crit/High findings)──> [REJECTED]
       v
-  Gate 7: Security Scan
-      |──BLOCK──> [REJECTED]
+  Gate 5: Mock Integrity Detector
+      |──BLOCK (HIGH findings)──> [REJECTED]
       v
-  Gate 8: Performance Check
-      |──BLOCK──> [REJECTED]
+  Gate 6: Test Mutation Detector
+      |──BLOCK (HIGH findings)──> [REJECTED]
       v
-  Gate 9: E2E / Playwright
+  Gate 7: Documentation Coverage
       |──BLOCK──> [REJECTED]
       v
+  Gate 8: Magic Modules Debate
+      |──BLOCK (BLOCK-severity findings)──> [REJECTED]
+      v
   [APPROVED]
 ```
 
+Backward-compatibility is a conditional healing-mode auditor, not a numbered gate.
+
 Gate status values: `passed`, `failed`, `skipped`
 Persistence: `.loki/dashboard-state.json` field `qualityGates`
 Severity levels: `critical`, `high`, `medium`, `low`
-Blocking threshold: Critical and High always block; Medium blocks by default.
+Blocking threshold: Critical and High block; Medium and Low are advisory.
 
 ### 7.2 Model Escalation
 

package/docs/architecture/bmad-loki-voice-agent-council-analysis.md

@@ -57,5 +57,5 @@ architecture, and adversarial review -- complementing Loki Mode's autonomous exe
 1. P0 must ship independently and prove value before P1/P2 begin
 2. No runtime dependency on BMAD repo -- adapter reads BMAD output artifacts only
 3. Zero regression on existing non-BMAD workflows
-4. All code must pass existing 9-gate quality system
+4. All code must pass existing 8-gate quality system
 5. Context budget: BMAD additions must stay under 15K tokens per iteration

package/docs/auto-claude-comparison.md

@@ -120,21 +120,24 @@ Loki Mode implements CONSENSAGENT (ACL 2025):
 **Verdict: Loki Mode wins** - Research-backed quality assurance.
 
 ### 5. Quality Gates
-Loki Mode has 14 quality gates:
+Loki Mode runs 8 deterministic quality gates plus full SDLC phase coverage.
+
+The 8 deterministic quality gates: static analysis (CodeQL, ESLint), test suite (pass/fail), blind 3-reviewer review with severity blocking, anti-sycophancy Devil's Advocate, mock-integrity, test-mutation, documentation coverage, and Magic Modules debate. (Backward-compatibility is a conditional healing-mode auditor, not a numbered gate.)
+
+Beyond the gates, the SDLC pipeline covers these phases:
 1. Static analysis (CodeQL, ESLint)
-2. Unit tests (>80% coverage)
+2. Unit tests (test suite passes; coverage % not measured this release)
 3. API/Integration tests
 4. E2E tests (Playwright)
 5. Security scanning (OWASP)
-6. SAML/OIDC/SSO integration
-7. Parallel code review (3 reviewers)
-8. Performance/load testing
-9. Accessibility (WCAG)
-10. Regression testing
-11. UAT simulation
-12. Anti-sycophancy check
-13. Scale-aware review intensity
-14. Continuous monitoring
+6. Parallel code review (3 reviewers)
+7. Performance/load testing
+8. Accessibility (WCAG)
+9. Regression testing
+10. UAT simulation
+11. Anti-sycophancy check
+12. Scale-aware review intensity
+13. Continuous monitoring
 
 **Auto-Claude:** Single QA validation loop (up to 50 iterations).
 

package/docs/certification/01-core-concepts/lesson.md

@@ -105,19 +105,20 @@ Full agent type definitions are in `references/agent-types.md`.
 
 ## Quality Gates
 
-Loki Mode enforces a 9-gate quality system. Code must pass all applicable gates before moving forward:
+Loki Mode enforces an 8-gate quality system. Code must pass all applicable gates before moving forward:
 
 | Gate | Name | Purpose |
 |------|------|---------|
-| 1 | Input Guardrails | Validate scope, detect injection, check constraints |
-| 2 | Static Analysis | CodeQL, ESLint/Pylint, type checking |
-| 3 | Blind Review System | 3 specialist reviewers in parallel, blind to each other |
-| 4 | Anti-Sycophancy Check | If reviewers unanimously approve, run a Devil's Advocate reviewer |
-| 5 | Output Guardrails | Validate code quality, spec compliance, no secrets |
-| 6 | Severity-Based Blocking | Critical/High/Medium = BLOCK; Low/Cosmetic = TODO |
-| 7 | Test Coverage Gates | Unit: 100% pass, >80% coverage; Integration: 100% pass |
-| 8 | Mock Detector | Flags tests that mock internal modules instead of real code |
-| 9 | Test Mutation Detector | Detects assertion value changes alongside implementation changes |
+| 1 | Static Analysis | CodeQL, ESLint/Pylint, type checking |
+| 2 | Test Suite (pass/fail) | Red blocks; coverage % not measured this release |
+| 3 | Blind Code Review (3-reviewer council + severity blocking) | 3 specialist reviewers in parallel, blind to each other; Critical/High = BLOCK; Medium/Low advisory |
+| 4 | Anti-Sycophancy / Devil's Advocate | If reviewers unanimously approve, run a Devil's Advocate reviewer |
+| 5 | Mock Integrity Detector | Flags tests that mock internal modules instead of real code |
+| 6 | Test Mutation Detector | Detects assertion value changes alongside implementation changes |
+| 7 | Documentation Coverage | README exists, docs freshness, API docs for packages |
+| 8 | Magic Modules Debate | Spec-vs-implementation debate on generated Magic Modules |
+
+A conditional backward-compatibility / legacy-healing auditor also runs in healing mode (not one of the 8 numbered gates).
 
 The blind review system (Gate 3) selects 3 reviewers from a pool of 5 named specialists:
 
@@ -179,4 +180,4 @@ Every Loki Mode project uses these files in the `.loki/` directory:
 
 ## Summary
 
-Loki Mode is an autonomous multi-agent system that follows the RARV cycle to build software from PRDs. It uses 41 agent types organized into 8 domains, enforces quality through 9 gates with blind peer review, and maintains episodic/semantic/procedural memory for continuous learning. Projects are classified into simple, standard, or complex tiers that determine the number of phases executed.
+Loki Mode is an autonomous multi-agent system that follows the RARV cycle to build software from PRDs. It uses 41 agent types organized into 8 domains, enforces quality through 8 gates with blind peer review, and maintains episodic/semantic/procedural memory for continuous learning. Projects are classified into simple, standard, or complex tiers that determine the number of phases executed.

package/docs/certification/01-core-concepts/quiz.md

@@ -45,7 +45,7 @@ D) test-coverage-auditor
 A) 3
 B) 5
 C) 7
-D) 9
+D) 8
 
 ---
 
@@ -67,12 +67,12 @@ D) complex
 
 ---
 
-**Question 8:** What is the minimum test coverage required by Gate 7 (Test Coverage Gates)?
+**Question 8:** What does Gate 7 (Documentation Coverage) check?
 
-A) 50%
-B) 60%
-C) 80%
-D) 100%
+A) That unit test coverage is at least 80%
+B) That every function has an inline comment
+C) That a README exists, docs are fresh within 10 commits, and packages have API docs
+D) That cyclomatic complexity stays under 10
 
 ---
 

package/docs/certification/05-troubleshooting/lesson.md

@@ -17,30 +17,40 @@ This module covers diagnosing and resolving common issues in Loki Mode: gate fai
 
 ## Quality Gate Failures
 
-When a quality gate fails, identify which gate triggered the failure:
+When a quality gate fails, identify which gate triggered the failure (the 8-gate
+system is detailed in `skills/quality-gates.md`):
 
-**Gates 1-6 (Review gates):**
+**Gates 1-2 (Static analysis and test suite):**
+- Gate 1 (Static Analysis): fix CodeQL/ESLint/Pylint/type-checker findings
+- Gate 2 (Test Suite): the test runner must pass; red blocks. Coverage % is not
+  measured this release. Fix failing tests before proceeding (never delete or
+  skip tests)
+
+**Gates 3-4 (Review gates):**
 - Check the review output for severity levels
-- Critical/High/Medium = BLOCK (must fix)
+- Critical/High = BLOCK; Medium/Low advisory (recommended to fix)
 - Low/Cosmetic = TODO (informational)
 - If all 3 reviewers pass unanimously, Gate 4 runs Devil's Advocate
 
-**Gate 7 (Test coverage):**
-- Unit tests must have 100% pass rate and >80% coverage
-- Integration tests must have 100% pass rate
-- Fix failing tests before proceeding (never delete or skip tests)
-
-**Gate 8 (Mock detector):**
+**Gate 5 (Mock integrity detector):**
 - Runs `tests/detect-mock-problems.sh`
 - Flags tests that mock internal modules instead of using real code
 - Flags tautological assertions and high internal mock ratios
-- Disable with `LOKI_GATE_MOCK_DETECTOR=false` (not recommended)
+- Disable with `LOKI_GATE_MOCK=false` (not recommended)
 
-**Gate 9 (Test mutation detector):**
+**Gate 6 (Test mutation detector):**
 - Runs `tests/detect-test-mutations.sh`
 - Detects assertion values changed alongside implementation (test fitting)
-- Detects low assertion density and missing pass/fail tracking
-- Disable with `LOKI_GATE_MUTATION_DETECTOR=false` (not recommended)
+- Detects low assertion density
+- Disable with `LOKI_GATE_MUTATION=false` (not recommended)
+
+**Gate 7 (Documentation coverage):**
+- Checks README presence, docs freshness within 10 commits, and API docs for packages
+- Disable with `LOKI_GATE_DOC_COVERAGE=false` (not recommended for packages)
+
+**Gate 8 (Magic Modules debate):**
+- Runs the spec-vs-implementation debate on generated Magic Modules
+- BLOCK-severity findings block; disable with `LOKI_GATE_MAGIC_DEBATE=false`
 
 ## Circuit Breaker System
 

package/docs/certification/05-troubleshooting/quiz.md

@@ -67,11 +67,11 @@ D) Removes the entire `.loki/` directory
 
 ---
 
-**Question 8:** Which environment variable disables Gate 8 (Mock Detector)?
+**Question 8:** Which environment variable disables Gate 5 (Mock Integrity Detector)?
 
-A) `LOKI_SKIP_MOCK_CHECK=true`
+A) `LOKI_GATE_MOCK=false`
 B) `LOKI_GATE_MOCK_DETECTOR=false`
-C) `LOKI_DISABLE_GATE_8=true`
+C) `LOKI_DISABLE_GATE_5=true`
 D) `LOKI_NO_MOCK_DETECTION=true`
 
 ---

package/docs/certification/answer-key.md

@@ -12,10 +12,10 @@ This file contains answers for all module quizzes and the final certification ex
 | 2 | C | 41 agent types: 37 domain + 4 orchestration |
 | 3 | B | After 5 failures, the task moves to `.loki/queue/dead-letter.json` |
 | 4 | C | architecture-strategist is always one of the 3 selected reviewers |
-| 5 | D | 9 quality gates (Input Guardrails through Test Mutation Detector) |
+| 5 | D | 8 quality gates (Static Analysis through Magic Modules Debate); backward-compatibility is a conditional healing-mode auditor, not one of the 8 |
 | 6 | B | Episodic, semantic, and procedural memory |
 | 7 | B | Simple tier uses 3 phases |
-| 8 | C | Gate 7 requires >80% unit test coverage |
+| 8 | C | Gate 7 (Documentation Coverage) checks README presence, docs freshness within 10 commits, and API docs for packages; coverage % is not measured this release |
 | 9 | C | Claude Code supports full features; Codex and Gemini run in degraded mode |
 | 10 | B | If all 3 reviewers unanimously approve, a Devil's Advocate reviewer runs |
 

package/docs/certification/certification-exam.md

@@ -49,7 +49,7 @@ D) test-coverage-auditor
 A) 3
 B) 5
 C) 7
-D) 9
+D) 8
 
 ---
 
@@ -71,12 +71,12 @@ D) complex
 
 ---
 
-**Question 8:** What is the minimum test coverage required by Gate 7?
+**Question 8:** What does Gate 7 (Documentation Coverage) check?
 
-A) 50%
-B) 60%
-C) 80%
-D) 100%
+A) That unit test coverage is at least 80%
+B) That every function has an inline comment
+C) That a README exists, docs are fresh within 10 commits, and packages have API docs
+D) That cyclomatic complexity stays under 10
 
 ---
 
@@ -439,11 +439,11 @@ D) Removes the entire `.loki/` directory
 
 ---
 
-**Question 48:** Which environment variable disables Gate 8 (Mock Detector)?
+**Question 48:** Which environment variable disables Gate 5 (Mock Integrity Detector)?
 
-A) `LOKI_GATE_MOCK_DETECTOR=false`
+A) `LOKI_GATE_MOCK=false`
 B) `LOKI_SKIP_MOCK_CHECK=true`
-C) `LOKI_DISABLE_GATE_8=true`
+C) `LOKI_DISABLE_GATE_5=true`
 D) `LOKI_NO_MOCK_DETECTION=true`
 
 ---

package/docs/competitive/bolt-new-analysis.md

@@ -409,7 +409,7 @@ These are bolt.new weaknesses that Loki Mode already solves or can emphasize:
 
 #### R5: Advertise Production Readiness as Key Differentiator
 - **bolt.new's gap**: 70% done code, no tests, no review, $5-20K remediation
-- **Loki Mode's advantage**: RARV cycle, 10 quality gates, 3-reviewer system, automated testing
+- **Loki Mode's advantage**: RARV cycle, 8 quality gates, 3-reviewer system, automated testing
 - **Action**: Create comparison content showing: "bolt.new gives you a prototype. Loki Mode gives you a product."
 - **Messaging**: "From PRD to production, not PRD to prototype"