loki-mode 6.76.0 → 6.76.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 minimal human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v6.76.0
+# Loki Mode v6.76.1
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -272,4 +272,4 @@ The following features are documented in skill modules but not yet fully automat
 | Quality gates 3-reviewer system | Implemented (v5.35.0) | 5 specialist reviewers in `skills/quality-gates.md`; execution in run.sh |
 | Benchmarks (HumanEval, SWE-bench) | Infrastructure only | Runner scripts and datasets exist in `benchmarks/`; no published results |
 
-**v6.76.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v6.76.1 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-6.76.0
+6.76.1

package/autonomy/run.sh

@@ -5784,6 +5784,53 @@ run_doc_quality_gate() {
     [ "$score" -ge 70 ]
 }
 
+# ============================================================================
+# Magic Modules Debate Gate - Gate 12 (v6.77.0)
+# Runs when any .loki/magic/specs/*.md changed since last iteration.
+# Blocks iteration completion if debate flags any block severity.
+# ============================================================================
+
+run_magic_debate_gate() {
+    local specs_dir="$TARGET_DIR/.loki/magic/specs"
+    if [ ! -d "$specs_dir" ]; then
+        return 0
+    fi
+
+    local has_specs
+    has_specs=$(find "$specs_dir" -maxdepth 1 -name "*.md" 2>/dev/null | head -1)
+    if [ -z "$has_specs" ]; then
+        return 0
+    fi
+
+    # Auto-run update to catch stale generated files
+    log_info "Magic Modules: running incremental update"
+    (cd "$TARGET_DIR" && PYTHONPATH="$PROJECT_DIR" LOKI_PROVIDER="${PROVIDER_NAME:-claude}" \
+        "$PROJECT_DIR/autonomy/loki" magic update 2>&1 | tail -10) || true
+
+    # Run debate on most recently modified component
+    local latest_spec
+    latest_spec=$(find "$specs_dir" -maxdepth 1 -name "*.md" -type f -print0 2>/dev/null | xargs -0 ls -t 2>/dev/null | head -1)
+    if [ -z "$latest_spec" ]; then
+        return 0
+    fi
+    local latest_name
+    latest_name=$(basename "$latest_spec" .md)
+
+    log_info "Magic Modules: running debate on '$latest_name'"
+    local debate_out
+    debate_out=$(cd "$TARGET_DIR" && PYTHONPATH="$PROJECT_DIR" LOKI_PROVIDER="${PROVIDER_NAME:-claude}" \
+        timeout 300 "$PROJECT_DIR/autonomy/loki" magic debate "$latest_name" --rounds 2 2>&1 || true)
+
+    # Parse debate outcome; block if any persona set severity=block
+    if echo "$debate_out" | grep -qi '"severity"[[:space:]]*:[[:space:]]*"block"'; then
+        log_warn "Magic Modules Gate 12: debate returned BLOCK severity for '$latest_name'"
+        return 1
+    fi
+
+    log_info "Magic Modules Gate 12: PASS"
+    return 0
+}
+
 # ============================================================================
 # 3-Reviewer Parallel Code Review (v5.35.0)
 # Specialist pool from skills/quality-gates.md with blind review
@@ -7905,6 +7952,24 @@ except Exception as e:
 PYEOF
 }
 
+# Magic Modules COMPOUND: record successful component patterns (v6.77.0)
+# Called at end of each iteration to capture generated/updated components
+# as semantic memory patterns via magic.core.memory_bridge.
+_magic_compound_capture() {
+    local registry="$TARGET_DIR/.loki/magic/registry.json"
+    if [ ! -f "$registry" ]; then
+        return 0
+    fi
+    # Delegate to memory_bridge (built by agent 3)
+    PYTHONPATH="$PROJECT_DIR" python3 -c "
+try:
+    from magic.core.memory_bridge import capture_iteration_compound
+    capture_iteration_compound('${TARGET_DIR}', iteration=${ITERATION_COUNT:-0})
+except Exception as exc:
+    pass
+" 2>/dev/null || true
+}
+
 # Automatic episode capture with enriched context (v6.15.0)
 # Captures git changes, files modified, and RARV phase automatically
 # after every iteration -- no manual invocation needed.
@@ -8583,6 +8648,21 @@ except Exception:
 " 2>/dev/null || true)
     fi
 
+    # Magic Modules context injection
+    local magic_context=""
+    local magic_specs_dir="$TARGET_DIR/.loki/magic/specs"
+    if [ -d "$magic_specs_dir" ]; then
+        local spec_count
+        spec_count=$(find "$magic_specs_dir" -maxdepth 1 -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+        if [ "$spec_count" -gt 0 ]; then
+            local spec_list
+            spec_list=$(find "$magic_specs_dir" -maxdepth 1 -name "*.md" -exec basename {} .md \; 2>/dev/null | tr '\n' ',' | sed 's/,$//')
+            magic_context="MAGIC_MODULES: ${spec_count} component specs exist: ${spec_list}. To add or update a component: write markdown to ${magic_specs_dir}/<Name>.md and run 'loki magic update'. The spec becomes source of truth; implementation regenerates automatically. Debate runs in VERIFY phase -- if accessibility or performance blocks, refine the spec and re-run."
+        else
+            magic_context="MAGIC_MODULES: available. To create UI components, write spec at ${magic_specs_dir}/<Name>.md and run 'loki magic update'. Spec-driven generation produces React + Web Component variants with auto-generated tests. Debate gate runs in VERIFY."
+        fi
+    fi
+
     # Degraded providers with small models need simplified prompts
     # Full RARV/SDLC instructions overwhelm models < 30B parameters
     if [ "${PROVIDER_DEGRADED:-false}" = "true" ]; then
@@ -8607,15 +8687,15 @@ except Exception:
     else
         if [ $retry -eq 0 ]; then
             if [ -n "$prd" ]; then
-                echo "Loki Mode with PRD at $prd. $human_directive $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_context $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 $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_context $magic_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 $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_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"
+                echo "Loki Mode. $human_directive $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_context $magic_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 $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_context $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 $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_context $magic_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 $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_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"
+                echo "Loki Mode - Resume iteration #$iteration (retry #$retry). $human_directive $gate_failure_context $queue_tasks $bmad_context $openspec_context $mirofish_context $magic_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
     fi
@@ -9475,6 +9555,22 @@ run_autonomous() {
     # Populate task queue from PRD (if no adapters already populated, runs once)
     populate_prd_queue "$prd_path"
 
+    # Magic Modules BOOTSTRAP: extract design tokens from project so component
+    # generation matches the codebase design language from iteration 1.
+    if [ -x "${PROJECT_DIR}/autonomy/loki" ]; then
+        PYTHONPATH="${PROJECT_DIR}" python3 -c "
+try:
+    from magic.core.design_tokens import DesignTokens
+    dt = DesignTokens('${TARGET_DIR}')
+    observed = dt.extract_from_codebase(save=True)
+    print(f'[magic] Extracted design tokens: '
+          f'{len(observed.get(\"colors\",{}))} colors, '
+          f'{len(observed.get(\"spacing\",{}))} spacing')
+except Exception as exc:
+    print(f'[magic] Token extraction skipped: {exc}')
+" 2>&1 | grep -E '\[magic\]' || true
+    fi
+
     # Check max iterations before starting
     if check_max_iterations; then
         log_error "Max iterations already reached. Reset with: rm .loki/autonomy-state.json"
@@ -10087,6 +10183,18 @@ if __name__ == "__main__":
                     log_warn "Documentation coverage gate: Score below threshold ($dc_count consecutive)"
                 fi
             fi
+            # Magic Modules debate gate - Gate 12 (v6.77.0)
+            if [ "${LOKI_GATE_MAGIC_DEBATE:-true}" = "true" ] && [ "$ITERATION_COUNT" -gt 0 ]; then
+                log_info "Quality gate: magic modules debate..."
+                if run_magic_debate_gate; then
+                    clear_gate_failure "magic_debate"
+                else
+                    local md_count
+                    md_count=$(track_gate_failure "magic_debate")
+                    gate_failures="${gate_failures}magic_debate,"
+                    log_warn "Magic Modules debate gate: BLOCK severity detected ($md_count consecutive)"
+                fi
+            fi
             # Store gate failures for prompt injection
             if [ -n "$gate_failures" ]; then
                 echo "$gate_failures" > "${TARGET_DIR:-.}/.loki/quality/gate-failures.txt"
@@ -10106,6 +10214,9 @@ if __name__ == "__main__":
         auto_capture_episode "$ITERATION_COUNT" "$exit_code" "${rarv_phase:-iteration}" \
             "${prd_path:-codebase-analysis}" "$duration" "$log_file"
 
+        # Magic Modules COMPOUND capture (v6.77.0): record component patterns
+        _magic_compound_capture
+
         # BUG-QG-008: Track iteration for convergence regardless of exit code
         if type council_track_iteration &>/dev/null; then
             council_track_iteration "$log_file"

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "6.76.0"
+__version__ = "6.76.1"
 
 # 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.76.0
+**Version:** v6.76.1
 
 ---
 

package/mcp/__init__.py

@@ -57,4 +57,4 @@ try:
 except ImportError:
     __all__ = ['mcp']
 
-__version__ = '6.76.0'
+__version__ = '6.76.1'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "6.76.0",
+  "version": "6.76.1",
   "description": "Loki Mode by Autonomi - Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "agent",

package/references/magic-rarv-integration.md

@@ -0,0 +1,87 @@
+# Magic Modules in the RARV-C cycle
+
+Magic Modules is embedded in the autonomous orchestrator. Users do not
+run `loki magic` commands directly unless they want manual override.
+Agents invoke component generation, debate, and memory capture as part of
+normal RARV-C phase execution.
+
+This reference describes which phase does what.
+
+## BOOTSTRAP (before iteration 1)
+- `analyze_git_intelligence()` runs (from v6.75.0).
+- Magic-specific bootstrap:
+  - `magic.core.design_tokens.DesignTokens.extract_from_codebase(save=True)`
+    scans existing React and Web Components to learn the project's design
+    language. Result is stored at `.loki/magic/tokens.json`.
+  - Token extraction runs once per project; subsequent iterations read from
+    the saved file. Force re-extract with `rm .loki/magic/tokens.json`.
+- PRD scanner (`magic.core.prd_scanner.scan_and_seed`) reads the PRD and
+  seeds stub specs at `.loki/magic/specs/<Name>.md` for every UI component
+  the PRD mentions with high or medium confidence. Agents refine these
+  stubs during REASON and ACT phases.
+
+## REASON (start of each iteration)
+- Agents read existing specs from `.loki/magic/specs/` as part of the
+  context injected by `build_prompt()`.
+- `magic.core.memory_bridge.recall_similar_components()` surfaces prior
+  successful patterns for components with matching tags. Agents reuse these
+  patterns rather than designing from scratch.
+
+## ACT (the agent does work)
+- Agents do NOT need to invoke `loki magic generate` manually. The build
+  prompt tells them: write or update the markdown spec at
+  `.loki/magic/specs/<Name>.md` and the orchestrator regenerates
+  implementations during VERIFY.
+- If an agent needs to create a component not yet in the PRD, it writes
+  the spec and the next VERIFY pass picks it up.
+
+## VERIFY (end of each iteration)
+- `run_magic_debate_gate()` runs as Gate 12 (after Gate 11 documentation).
+- Sequence:
+  1. `loki magic update` regenerates any components whose specs are newer
+     than their implementations (SHA256 freshness check).
+  2. `loki magic debate <latest>` runs 2 rounds of the 4-persona debate
+     (Creative, Conservative, A11y, Performance).
+  3. If any persona returns `severity: block`, Gate 12 fails and the
+     iteration does not close. Agent receives the block reasons in the
+     next REASON phase and refines the spec.
+- Controllable via `LOKI_GATE_MAGIC_DEBATE=false` for prototyping.
+
+## COMPOUND (after iteration or run completes)
+- `_magic_compound_capture()` calls
+  `magic.core.memory_bridge.capture_iteration_compound()`.
+- Memory writes:
+  - Episodic: each generated component with its debate result and timing
+  - Semantic: tag clusters that consistently pass debate (3+ components,
+    >=80% pass rate) become "stable patterns" future iterations reuse
+  - Procedural: refinements to design tokens that survived multiple
+    iterations become promoted defaults
+
+## Human in the loop escalation
+Only one path requires human attention: when Gate 12 returns a block and
+the agent's spec refinement does not resolve it after 2 additional
+iterations. Orchestrator writes `.loki/signals/MAGIC_HITL_NEEDED` with
+the component name and block reasons; dashboard surfaces this in the
+Magic Page review queue.
+
+## End-to-end example
+PRD says: "Add a login form with email, password, and submit button."
+
+1. BOOTSTRAP: design tokens extracted (primary=#553DE9, etc.).
+   PRD scanner seeds `LoginForm.md`, `SubmitButton.md`.
+2. Iteration 1 REASON: agent reads both stubs, sees they are placeholders.
+3. Iteration 1 ACT: agent writes full props, behavior, a11y into the specs.
+4. Iteration 1 VERIFY: Gate 12 runs update (generates React + WC variants)
+   and debate. A11y persona blocks `SubmitButton` ("missing aria-disabled
+   when submitting"). Gate 12 fails.
+5. Iteration 2 REASON: agent reads block reason from `.loki/signals/` and
+   updates the spec's Accessibility section.
+6. Iteration 2 VERIFY: debate passes. Gate 12 passes. Iteration closes.
+7. COMPOUND: episode stored ("LoginForm generated, debate passed rounds=2,
+   12.4s"). Tag cluster `[form, auth]` now tracked with 2/2 pass rate.
+
+## Related
+- `skills/magic-modules.md` -- skill module for agents
+- `references/magic-modules-patterns.md` -- full API and pattern reference
+- `references/memory-system.md` -- memory engine details
+- `skills/quality-gates.md` -- all 12 gates documented

package/skills/00-index.md

@@ -10,6 +10,7 @@
 > - `references/memory-system.md` - Episodic/semantic/procedural memory
 > - `references/tool-orchestration.md` - NVIDIA ToolOrchestra efficiency metrics
 > - `references/quality-control.md` - Code review and guardrails
+> - `references/magic-rarv-integration.md` - Autonomous magic generation in RARV-C cycle
 
 ## Module Selection Rules
 
@@ -30,7 +31,7 @@
 | OpenSpec delta context, brownfield modifications | `openspec-integration.md` |
 | MiroFish market validation, `--mirofish` flag | `mirofish-integration.md` |
 | Writing/updating documentation, `loki docs` | `documentation.md` |
-| Component generation, `loki magic`, spec-driven UI | `magic-modules.md` |
+| UI components, design tokens, .loki/magic/, Gate 12 | `magic-modules.md` |
 | Legacy healing, modernization, archaeology | `healing.md` |
 | Plan deepening, knowledge extraction | `compound-learning.md` |