loki-mode 7.7.2 → 7.7.4

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes a spec (PRD, GitHub issue, OpenAPI doc, etc.) to deployed product with minimal human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v7.7.2
+# Loki Mode v7.7.4
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -381,4 +381,4 @@ See `CHANGELOG.md` entries [7.5.7], [7.5.8], [7.5.13] for the per-fix list and r
 
 ---
 
-**v7.7.2 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v7.7.4 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-7.7.2
+7.7.4

package/autonomy/run.sh

@@ -8714,6 +8714,66 @@ except Exception as e:
 PYEOF
 }
 
+# v7.7.3 F-3 fix: intelligent USAGE.md regeneration. Called at session end
+# (after completion-promise fulfilled). Reads the FINAL project state
+# (file tree + package manifests + recent commits) and asks Claude
+# (haiku tier) to emit a USAGE.md tailored to the actual stack.
+#
+# Best-effort: any failure (no provider, network, parse) returns silently
+# without disrupting completion. Costs ~$0.01-0.05 per session (one
+# haiku call). Set LOKI_INTELLIGENT_USAGE=0 to skip entirely.
+_intelligent_usage_regen() {
+    local target_dir="${TARGET_DIR:-.}"
+    local usage_path="$target_dir/USAGE.md"
+    # Find a working `claude` binary; if absent, bail silently.
+    if ! command -v claude >/dev/null 2>&1; then
+        return 0
+    fi
+    # Snapshot project state. Keep it small (< ~4 KiB) so the prompt
+    # stays cache-stable across sessions.
+    local _tree _manifests _commits _state_prompt
+    _tree=$(cd "$target_dir" && find . -maxdepth 3 -type f \
+        -not -path './node_modules/*' -not -path './.loki/*' \
+        -not -path './.git/*' -not -path './venv/*' -not -path './.venv/*' \
+        -not -path './dist/*' -not -path './build/*' 2>/dev/null | head -30)
+    # Capture package manifests inline so the model sees real scripts.
+    _manifests=""
+    for f in package.json requirements.txt pyproject.toml Cargo.toml go.mod composer.json Gemfile; do
+        if [ -f "$target_dir/$f" ]; then
+            _manifests="${_manifests}=== $f ===\n$(head -50 "$target_dir/$f" 2>/dev/null)\n\n"
+        fi
+    done
+    _commits=$(cd "$target_dir" && git log --oneline -10 2>/dev/null || true)
+
+    log_info "Regenerating USAGE.md from final project state (intelligent mode)..."
+    local _ic_prompt="You are writing a USAGE.md for the project below. Detect the stack from the manifest files; emit a concise (under 100 lines) Markdown doc with sections: ## Prerequisites, ## Install, ## Start, ## Verify (2-3 copy-paste curl/browser/CLI commands with expected output), ## Stop. Use the ACTUAL command names from package.json scripts or pyproject entry points -- never generic placeholders. Output ONLY the Markdown body (no code-fence wrapper, no preamble).
+
+=== Project tree (max 30 files, 3 levels deep) ===
+${_tree}
+
+=== Manifest files ===
+${_manifests}
+
+=== Last 10 commits ===
+${_commits}"
+
+    # Use haiku for cheap, fast generation. --dangerously-skip-permissions
+    # because this is a one-shot non-interactive call.
+    local _ic_out
+    _ic_out=$(printf '%s' "$_ic_prompt" \
+        | timeout 60 claude --dangerously-skip-permissions --model haiku -p - 2>/dev/null \
+        | head -200)
+    # Sanity check: response must look like Markdown (starts with # or ##).
+    if [ -z "$_ic_out" ] || ! printf '%s' "$_ic_out" | head -1 | grep -qE '^#'; then
+        log_info "Intelligent USAGE regen returned non-Markdown or empty; keeping existing USAGE.md."
+        return 0
+    fi
+    printf '%s\n' "$_ic_out" > "$usage_path"
+    log_info "USAGE.md regenerated intelligently from final project state -> $usage_path"
+    return 0
+}
+
+
 # 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.
@@ -11544,6 +11604,16 @@ if __name__ == "__main__":
                     log_header "TASK COMPLETION CLAIMED (via loki_complete_task)"
                 fi
                 log_info "Explicit completion signal detected."
+                # v7.7.3 F-3 fix: intelligent USAGE.md regeneration. The static
+                # USAGE_DOC_INSTRUCTION in build_prompt gets the agent to write
+                # SOMETHING; this hook re-runs a cheap model call with the FINAL
+                # project state to refine that output (or write it if missing).
+                # Default-on per the "no user flag" mandate; set
+                # LOKI_INTELLIGENT_USAGE=0 to disable. Best-effort: failures
+                # never block completion.
+                if [ "${LOKI_INTELLIGENT_USAGE:-1}" != "0" ]; then
+                    _intelligent_usage_regen 2>/dev/null || true
+                fi
                 # Run memory consolidation on successful completion
                 log_info "Running memory consolidation..."
                 run_memory_consolidation

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "7.7.2"
+__version__ = "7.7.4"
 
 # 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:** v7.7.2
+**Version:** v7.7.4
 
 ---
 

package/loki-ts/dist/loki.js

@@ -1,5 +1,5 @@
 // @bun
-var _7=Object.defineProperty;var I7=(K)=>K;function P7(K,$){this[K]=I7.bind(null,$)}var b=(K,$)=>{for(var z in $)_7(K,z,{get:$[z],enumerable:!0,configurable:!0,set:P7.bind($,z)})};var R=(K,$)=>()=>(K&&($=K(K=0)),$);var V1=import.meta.require;var e1={};b(e1,{lokiDir:()=>P,homeLokiDir:()=>k1,findRepoRootForVersion:()=>N1,REPO_ROOT:()=>p});import{resolve as u,dirname as S1}from"path";import{fileURLToPath as L7}from"url";import{existsSync as J1}from"fs";import{homedir as R7}from"os";function E7(){let K=i1;for(let $=0;$<6;$++){if(J1(u(K,"VERSION"))&&J1(u(K,"autonomy/run.sh")))return K;let z=S1(K);if(z===K)break;K=z}return u(i1,"..","..","..")}function N1(K){let $=K;for(let z=0;z<6;z++){if(J1(u($,"VERSION"))&&J1(u($,"autonomy/run.sh")))return $;let Q=S1($);if(Q===$)break;$=Q}return u(K,"..","..","..")}function P(){return process.env.LOKI_DIR??u(process.cwd(),".loki")}function k1(){return u(R7(),".loki")}var i1,p;var y=R(()=>{i1=S1(L7(import.meta.url));p=E7()});import{readFileSync as x7}from"fs";import{resolve as F7,dirname as w7}from"path";import{fileURLToPath as S7}from"url";function G1(){if(n!==null)return n;let K="7.7.2";if(typeof K==="string"&&K.length>0)return n=K,n;try{let $=w7(S7(import.meta.url)),z=N1($);n=x7(F7(z,"VERSION"),"utf-8").trim()}catch{n="unknown"}return n}var n=null;var D1=R(()=>{y()});var $0={};b($0,{runOrThrow:()=>N7,run:()=>S,commandVersion:()=>D7,commandExists:()=>D,ShellError:()=>C1});async function S(K,$={}){let z=Bun.spawn({cmd:[...K],stdout:"pipe",stderr:"pipe",env:$.env?{...process.env,...$.env}:process.env,cwd:$.cwd}),Q,X;if($.timeoutMs&&$.timeoutMs>0)Q=setTimeout(()=>{try{z.kill("SIGTERM")}catch{}X=setTimeout(()=>{try{z.kill("SIGKILL")}catch{}},2000)},$.timeoutMs);try{let[H,Z,q]=await Promise.all([new Response(z.stdout).text(),new Response(z.stderr).text(),z.exited]);return{stdout:H,stderr:Z,exitCode:q}}finally{if(Q)clearTimeout(Q);if(X)clearTimeout(X)}}async function N7(K,$={}){let z=await S(K,$);if(z.exitCode!==0)throw new C1(`command failed (${z.exitCode}): ${K.join(" ")}`,z.exitCode,z.stdout,z.stderr);return z}async function D(K){let $=k7(K),z=await S(["sh","-c",`command -v ${$}`],{timeoutMs:5000});if(z.exitCode===0)return z.stdout.trim()||null;return null}function k7(K){if(!/^[A-Za-z0-9._/-]+$/.test(K))throw Error(`refused to shell-escape suspect token: ${K}`);return K}async function D7(K,$="--version"){if(!await D(K))return null;let Q=await S([K,$],{timeoutMs:5000});if(Q.exitCode!==0)return null;return((Q.stdout||Q.stderr).split(/\r?\n/)[0]?.trim()??"")||null}var C1;var c=R(()=>{C1=class C1 extends Error{message;exitCode;stdout;stderr;constructor(K,$,z,Q){super(K);this.message=K;this.exitCode=$;this.stdout=z;this.stderr=Q;this.name="ShellError"}}});function l(K){return C7?"":K}var C7,E,C,x,O6,O,k,F,W;var a=R(()=>{C7=(process.env.NO_COLOR??"").length>0;E=l("\x1B[0;31m"),C=l("\x1B[0;32m"),x=l("\x1B[1;33m"),O6=l("\x1B[0;34m"),O=l("\x1B[0;36m"),k=l("\x1B[1m"),F=l("\x1B[2m"),W=l("\x1B[0m")});import{existsSync as c7}from"fs";async function t(){if(z1!==void 0)return z1;let K="/opt/homebrew/bin/python3.12";if(c7(K))return z1=K,K;let $=await D("python3.12");if($)return z1=$,$;let z=await D("python3");return z1=z,z}async function s(K,$={}){let z=await t();if(!z)return{stdout:"",stderr:"python3 not found",exitCode:127};return S([z,"-c",K],$)}var z1;var Q1=R(()=>{c()});var G0={};b(G0,{runStatus:()=>z5});import{existsSync as N,readFileSync as Z1,readdirSync as H0,statSync as W0}from"fs";import{resolve as w,basename as a7}from"path";async function r7(){if(await D("jq"))return!0;return process.stdout.write(`${E}Error: jq is required but not installed.${W}
+var _7=Object.defineProperty;var I7=(K)=>K;function P7(K,$){this[K]=I7.bind(null,$)}var b=(K,$)=>{for(var z in $)_7(K,z,{get:$[z],enumerable:!0,configurable:!0,set:P7.bind($,z)})};var R=(K,$)=>()=>(K&&($=K(K=0)),$);var V1=import.meta.require;var e1={};b(e1,{lokiDir:()=>P,homeLokiDir:()=>k1,findRepoRootForVersion:()=>N1,REPO_ROOT:()=>p});import{resolve as u,dirname as S1}from"path";import{fileURLToPath as L7}from"url";import{existsSync as J1}from"fs";import{homedir as R7}from"os";function E7(){let K=i1;for(let $=0;$<6;$++){if(J1(u(K,"VERSION"))&&J1(u(K,"autonomy/run.sh")))return K;let z=S1(K);if(z===K)break;K=z}return u(i1,"..","..","..")}function N1(K){let $=K;for(let z=0;z<6;z++){if(J1(u($,"VERSION"))&&J1(u($,"autonomy/run.sh")))return $;let Q=S1($);if(Q===$)break;$=Q}return u(K,"..","..","..")}function P(){return process.env.LOKI_DIR??u(process.cwd(),".loki")}function k1(){return u(R7(),".loki")}var i1,p;var y=R(()=>{i1=S1(L7(import.meta.url));p=E7()});import{readFileSync as x7}from"fs";import{resolve as F7,dirname as w7}from"path";import{fileURLToPath as S7}from"url";function G1(){if(n!==null)return n;let K="7.7.4";if(typeof K==="string"&&K.length>0)return n=K,n;try{let $=w7(S7(import.meta.url)),z=N1($);n=x7(F7(z,"VERSION"),"utf-8").trim()}catch{n="unknown"}return n}var n=null;var D1=R(()=>{y()});var $0={};b($0,{runOrThrow:()=>N7,run:()=>S,commandVersion:()=>D7,commandExists:()=>D,ShellError:()=>C1});async function S(K,$={}){let z=Bun.spawn({cmd:[...K],stdout:"pipe",stderr:"pipe",env:$.env?{...process.env,...$.env}:process.env,cwd:$.cwd}),Q,X;if($.timeoutMs&&$.timeoutMs>0)Q=setTimeout(()=>{try{z.kill("SIGTERM")}catch{}X=setTimeout(()=>{try{z.kill("SIGKILL")}catch{}},2000)},$.timeoutMs);try{let[H,Z,q]=await Promise.all([new Response(z.stdout).text(),new Response(z.stderr).text(),z.exited]);return{stdout:H,stderr:Z,exitCode:q}}finally{if(Q)clearTimeout(Q);if(X)clearTimeout(X)}}async function N7(K,$={}){let z=await S(K,$);if(z.exitCode!==0)throw new C1(`command failed (${z.exitCode}): ${K.join(" ")}`,z.exitCode,z.stdout,z.stderr);return z}async function D(K){let $=k7(K),z=await S(["sh","-c",`command -v ${$}`],{timeoutMs:5000});if(z.exitCode===0)return z.stdout.trim()||null;return null}function k7(K){if(!/^[A-Za-z0-9._/-]+$/.test(K))throw Error(`refused to shell-escape suspect token: ${K}`);return K}async function D7(K,$="--version"){if(!await D(K))return null;let Q=await S([K,$],{timeoutMs:5000});if(Q.exitCode!==0)return null;return((Q.stdout||Q.stderr).split(/\r?\n/)[0]?.trim()??"")||null}var C1;var c=R(()=>{C1=class C1 extends Error{message;exitCode;stdout;stderr;constructor(K,$,z,Q){super(K);this.message=K;this.exitCode=$;this.stdout=z;this.stderr=Q;this.name="ShellError"}}});function l(K){return C7?"":K}var C7,E,C,x,O6,O,k,F,W;var a=R(()=>{C7=(process.env.NO_COLOR??"").length>0;E=l("\x1B[0;31m"),C=l("\x1B[0;32m"),x=l("\x1B[1;33m"),O6=l("\x1B[0;34m"),O=l("\x1B[0;36m"),k=l("\x1B[1m"),F=l("\x1B[2m"),W=l("\x1B[0m")});import{existsSync as c7}from"fs";async function t(){if(z1!==void 0)return z1;let K="/opt/homebrew/bin/python3.12";if(c7(K))return z1=K,K;let $=await D("python3.12");if($)return z1=$,$;let z=await D("python3");return z1=z,z}async function s(K,$={}){let z=await t();if(!z)return{stdout:"",stderr:"python3 not found",exitCode:127};return S([z,"-c",K],$)}var z1;var Q1=R(()=>{c()});var G0={};b(G0,{runStatus:()=>z5});import{existsSync as N,readFileSync as Z1,readdirSync as H0,statSync as W0}from"fs";import{resolve as w,basename as a7}from"path";async function r7(){if(await D("jq"))return!0;return process.stdout.write(`${E}Error: jq is required but not installed.${W}
 `),process.stdout.write(`Install with:
 `),process.stdout.write(`  brew install jq    (macOS)
 `),process.stdout.write(`  apt install jq     (Debian/Ubuntu)
@@ -550,4 +550,4 @@ Set LOKI_LEGACY_BASH=1 to force the bash CLI for every command.
 `),2}default:return process.stderr.write(`Unknown command: ${$}
 `),process.stderr.write(j7),2}}process.on("SIGINT",()=>process.exit(130));process.on("SIGTERM",()=>process.exit(143));var z6=await $6(Bun.argv.slice(2));process.exit(z6);
 
-//# debugId=031A27C701A5C40664756E2164756E21
+//# debugId=3CF8E903E8680F4764756E2164756E21

package/mcp/__init__.py

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "7.7.2",
+  "version": "7.7.4",
   "description": "Loki Mode by Autonomi. Multi-agent autonomous SDLC framework. Spec to deployed app: PRD, GitHub issue, OpenAPI/JSON/YAML, or one-line brief. 4 AI providers (Claude Code, OpenAI Codex, Cline, Aider). 11 quality gates.",
   "keywords": [
     "agent",

package/skills/sdlc-fleet.md

@@ -0,0 +1,145 @@
+# SDLC Fleet Pattern (skill module)
+
+**Established:** v7.7.4 (2026-05-24)
+**Origin:** user mandate "agent teams with senior most developers, Loki architects, sdet team and council of reviewers exist and coordinate and work in parallel"
+**Proven by:** v7.6.0 fleet ship (architect + 3 principal engineers + SDET + 3-reviewer council + real-user QA) demonstrated the pattern works end-to-end.
+
+This skill describes the STANDING pattern for shipping any non-trivial change in Loki Mode. The integrator (Claude Code session) is responsible for orchestrating the roles below. Each role is a Loki Agent call.
+
+## When to invoke this pattern
+
+Apply this pattern when shipping ANY of:
+
+- A new feature touching > 3 files
+- A bug fix touching agent runtime, council, memory, or auto-spawn surfaces
+- A MINOR or MAJOR release
+- A change with cross-route parity implications (bash + Bun + TS)
+- A change the user has marked "critical" or "production-blocking"
+
+Skip this pattern (acceptable shortcuts) when:
+
+- Single-line typo fix in user-facing strings
+- Pure docs edit (no code change)
+- A revert of a previously-shipped change with no new logic
+- An emergency hotfix where waiting on parallel agents would exceed the production-impact window
+
+## The 6 roles
+
+### 1. Architect (1 agent, Plan subagent_type, model: opus)
+
+**Job:** Design the change end-to-end before any code is written. Produces a written plan saved as `docs/<TOPIC>-PLAN.md`.
+
+**Inputs:** the original user directive verbatim + relevant source files + any prior council findings.
+
+**Outputs:** a markdown plan with: scope, acceptance criteria, implementation steps, file-level diffs sketch, testing plan, risks + mitigations, NOT-tested honest disclosure.
+
+**Output is BINDING** for the dev fleet -- don't change scope without re-architecting.
+
+### 2. Product Owner (the integrator, NOT a separate agent)
+
+**Job:** Lock scope before implementation. Use `AskUserQuestion` to surface ambiguity to the user. NEVER guess at scope.
+
+**Output:** explicit user answer that locks the acceptance criteria.
+
+### 3. Dev Fleet (3-5 principal engineers in parallel, model: opus)
+
+**Job:** Implement independent slices of the architect's plan IN PARALLEL. Each engineer gets a single self-contained task with explicit file references and binding constraints.
+
+**Pattern:** spawn N agents via `Agent` tool with `run_in_background: true` in ONE message (parallel). Each agent gets:
+
+- The architect's plan section relevant to their slice
+- A SINGLE deliverable (one fix, one feature, one file)
+- Binding constraints (no version bumps, no commits, no emojis, no em dashes, NO destructive operations)
+- Explicit "report back in N words" cap
+
+The integrator does NOT delegate synthesis -- they integrate the parallel outputs themselves.
+
+### 4. SDET (1-2 agents, model: opus)
+
+**Job:** Write tests + capture screenshots. For each shipped feature:
+
+- One or more bash / Playwright tests asserting acceptance criteria
+- For UI surfaces: screenshot capture with `chrome --headless --screenshot` or Playwright
+- For backends: curl-based smoke tests
+
+**Output:** test files + screenshot artifacts under `artifacts/<release>-screens/`.
+
+### 5. Council Reviewers (3 agents, parallel, model: 2 opus + 1 sonnet)
+
+**Job:** Independent code review. Binding gate: unanimous APPROVE required to ship.
+
+**Pattern:** spawn 3 agents in parallel via `Agent` tool. Each gets:
+
+- The full file diff at HEAD
+- Their specialized focus (e.g. "frontend correctness", "backend / integration risk", "release readiness")
+- Strict output format: `VOTE: APPROVE | CONCERN | REJECT` + findings list + reasoning
+
+On any CONCERN or REJECT:
+
+1. Integrator reads source + validates concern
+2. If valid: dispatch fix agent + RE-RUN entire council on post-fix state
+3. If invalid: refute with evidence + re-spawn ONLY the dissenting reviewer with the refutation
+4. Loop until 3-of-3 APPROVE
+5. "2-of-3 is good enough" is NEVER acceptable
+
+### 6. Real-User QA (1 agent OR the integrator directly)
+
+**Job:** Install the just-shipped release fresh from npm/bun, run a user-realistic scenario end-to-end, capture screenshots, report any breakage.
+
+**Pattern:** after `gh release` confirms, run:
+
+```bash
+bun install -g loki-mode@<NEW_VERSION>
+loki --version  # confirm new version on PATH
+# Then exercise the new feature in a user-realistic way:
+loki <new-command> ...  # the change we just shipped
+```
+
+Capture:
+- Exit codes
+- Output structure
+- Any unexpected errors / warnings
+- Browser screenshots if UI surface
+
+## Parallel-execution rules
+
+When spawning multiple agents in the SAME message:
+
+- Use `Agent` tool with `run_in_background: true`
+- Send all N tool calls in a SINGLE message (parallel scheduling)
+- Each agent gets a SELF-CONTAINED prompt (no shared context)
+- Each agent gets a SHORT response cap (under 250 words)
+- The integrator INTEGRATES the parallel outputs -- never delegates synthesis
+
+Anti-pattern: spawning agents sequentially when work is independent. Always parallel.
+
+## Honest acknowledgements pattern
+
+Every CHANGELOG entry that ships work via this pattern MUST include:
+
+```markdown
+### NOT tested in this release
+
+- <each test that was skipped + reason>
+- <any feature shipped without end-to-end real-user repro>
+- <any divergence from architect plan + workaround>
+```
+
+Failing to disclose is fabrication. CLAUDE.md MEMORY.md "Be real, no fabrication, no lying" applies.
+
+## Reference run: v7.6.0 LSP integration
+
+Demonstrated this pattern works:
+
+1. **Architect** (Plan agent): designed Merge-3 in `docs/MERGE3-PLAN.md`
+2. **Product Owner** (integrator + AskUserQuestion): user chose merge scope
+3. **Dev Fleet** (3 principal engineers in parallel): Engineer A fixed memory PYTHONPATH; Engineer B added USAGE.md auto-gen across bash + TS; Engineer C added Memory drill-down UI
+4. **SDET** (Explore + Playwright): captured 20+ UI screenshots, ran 24-scenario CLI permutation test
+5. **Council** (2 Opus + 1 Sonnet): 2 rounds; round 1 had 2 CONCERN-major; fixes applied; round 2 unanimous APPROVE
+6. **Real-user QA**: fresh `bun install -g loki-mode@7.7.0` + ran on a different stack (Python Flask) than dev test + verified USAGE.md auto-generated + Memory drill-down rendered in a real browser
+
+Result: 4 releases shipped that day with all 8 GitHub workflows SUCCESS on each.
+
+## Per-release checklist (always)
+
+See `artifacts/ROADMAP-v7.6.2-v7.7.0.md` "Per-release CLAUDE.md checklist" section for the binding 14-step checklist (architect plan, 14 version bumps, CHANGELOG, pre-publish validation, council, local-ci, individual staging, push, workflow validation, distribution validation, real-user smoke test, UI screenshot regression, cleanup).