loki-mode 7.7.0 → 7.7.2

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.0
+# Loki Mode v7.7.2
 
 **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.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v7.7.2 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-7.7.0
+7.7.2

package/autonomy/loki

@@ -2285,7 +2285,8 @@ if not os.path.isdir(loki_dir):
     result['status'] = 'inactive'
     result['phase'] = None
     result['iteration'] = 0
-    result['provider'] = env_provider
+    result['provider'] = env_provider if os.environ.get('LOKI_PROVIDER', '') else 'claude'
+    result['provider_source'] = 'env' if os.environ.get('LOKI_PROVIDER', '') else 'default'
     result['dashboard_url'] = None
     result['pid'] = None
     result['elapsed_time'] = 0
@@ -2343,13 +2344,27 @@ else:
         result['phase'] = None
         result['iteration'] = 0
 
-# Provider
+# Provider + provider_source (v7.7.2 B-5 clarity: surface WHY this
+# value won the resolution race: 'saved' vs 'env' vs 'default').
 provider_file = os.path.join(loki_dir, 'state', 'provider')
 if os.path.isfile(provider_file):
-    with open(provider_file) as f:
-        result['provider'] = f.read().strip()
+    try:
+        with open(provider_file) as f:
+            saved = f.read().strip()
+    except OSError:
+        saved = ''
 else:
+    saved = ''
+env_set = os.environ.get('LOKI_PROVIDER', '') != ''
+if saved:
+    result['provider'] = saved
+    result['provider_source'] = 'saved'
+elif env_set:
     result['provider'] = env_provider
+    result['provider_source'] = 'env'
+else:
+    result['provider'] = 'claude'
+    result['provider_source'] = 'default'
 
 # PID
 pid_file = os.path.join(loki_dir, 'loki.pid')
@@ -2817,6 +2832,15 @@ cmd_provider() {
             echo "  info     Show provider details"
             echo "  models   Show resolved model configuration for all providers"
             echo ""
+            echo "Precedence (v7.7.2 -- highest wins):"
+            echo "  1. loki start --provider NAME         CLI flag (per-invocation)"
+            echo "  2. .loki/state/provider               saved value (per-project)"
+            echo "  3. LOKI_PROVIDER env var              shell session default"
+            echo "  4. claude                             built-in default"
+            echo ""
+            echo "  Note: 'loki status' reflects the SAVED provider, not the env var."
+            echo "  Run 'loki provider set <name>' to make a project-level choice persist."
+            echo ""
             echo "Examples:"
             echo "  loki provider show"
             echo "  loki provider set claude"

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "7.7.0"
+__version__ = "7.7.2"
 
 # Expose the control app for easy import
 try:

package/dashboard/server.py

@@ -5207,6 +5207,46 @@ async def get_checklist():
         return {"status": "error", "categories": [], "summary": {"total": 0, "verified": 0, "failing": 0, "pending": 0}}
 
 
+@app.get("/api/usage")
+async def get_usage_doc():
+    """v7.7.1 F-1 follow-up: return the auto-generated USAGE.md from the
+    project root so Dashboard + Lab can surface "how to run / test the app".
+
+    Returns {exists: bool, content: str|None, path: str, size: int, mtime: float}.
+    Path-traversal hardened: resolves to PROJECT_ROOT/USAGE.md verbatim, no
+    user-controlled path component. Reads up to 256 KiB; truncates with a
+    `truncated: true` flag if larger.
+    """
+    loki_dir = _get_loki_dir()
+    project_root = loki_dir.parent
+    usage_path = project_root / "USAGE.md"
+    out = {
+        "exists": False,
+        "content": None,
+        "path": str(usage_path),
+        "size": 0,
+        "mtime": 0.0,
+        "truncated": False,
+    }
+    if not usage_path.is_file():
+        return out
+    try:
+        st = usage_path.stat()
+        out["exists"] = True
+        out["size"] = st.st_size
+        out["mtime"] = st.st_mtime
+        MAX_BYTES = 256 * 1024  # 256 KiB cap
+        if st.st_size > MAX_BYTES:
+            out["truncated"] = True
+            with usage_path.open("r", encoding="utf-8", errors="replace") as f:
+                out["content"] = f.read(MAX_BYTES) + "\n\n... [truncated]"
+        else:
+            out["content"] = usage_path.read_text(encoding="utf-8", errors="replace")
+    except OSError as e:
+        out["error"] = str(e)
+    return out
+
+
 @app.get("/api/checklist/summary")
 async def get_checklist_summary():
     """Get checklist verification summary."""

package/dashboard/static/index.html

@@ -702,6 +702,40 @@
             <h3 style="font-family: 'DM Serif Display', Georgia, serif; font-size: 1.15rem; font-weight: 400; color: var(--loki-text-primary); margin-bottom: 12px;">Learning Metrics</h3>
             <loki-learning-dashboard id="learning-dashboard" time-range="7d"></loki-learning-dashboard>
           </div>
+          <!-- v7.7.1 F-1 follow-up: How to Run (USAGE.md) -->
+          <div>
+            <h3 style="font-family: 'DM Serif Display', Georgia, serif; font-size: 1.15rem; font-weight: 400; color: var(--loki-text-primary); margin-bottom: 12px;">How to Run (USAGE.md)</h3>
+            <div id="usage-doc-panel" style="background: var(--loki-bg-card, #1a1a1a); border: 1px solid var(--loki-border, #333); border-radius: 5px; padding: 12px;">
+              <div id="usage-doc-meta" style="font-size: 11px; color: var(--loki-text-muted, #888); margin-bottom: 8px;">Loading...</div>
+              <pre id="usage-doc-content" style="margin: 0; padding: 12px; background: var(--loki-bg-secondary, #111); border-radius: 4px; font-family: 'JetBrains Mono', monospace; font-size: 12px; white-space: pre-wrap; word-break: break-word; color: var(--loki-text-primary, #eee); max-height: 480px; overflow: auto;"></pre>
+            </div>
+            <script>
+              (function(){
+                function loadUsage(){
+                  fetch('/api/usage').then(function(r){ return r.json(); }).then(function(j){
+                    var meta = document.getElementById('usage-doc-meta');
+                    var body = document.getElementById('usage-doc-content');
+                    if (!meta || !body) return;
+                    if (!j || !j.exists){
+                      meta.textContent = 'USAGE.md not generated yet. Loki writes it at the end of each session.';
+                      body.textContent = '';
+                      return;
+                    }
+                    var size = j.size > 1024 ? (j.size/1024).toFixed(1) + ' KB' : j.size + ' B';
+                    var when = j.mtime ? new Date(j.mtime*1000).toLocaleString() : '';
+                    meta.textContent = j.path + '  (' + size + (j.truncated ? ', truncated' : '') + ', ' + when + ')';
+                    body.textContent = j.content || '';
+                  }).catch(function(e){
+                    var meta = document.getElementById('usage-doc-meta');
+                    if (meta) meta.textContent = 'Failed to load USAGE.md: ' + (e && e.message ? e.message : 'unknown');
+                  });
+                }
+                loadUsage();
+                // Re-poll on interval so a fresh USAGE.md appears after a session.
+                setInterval(loadUsage, 15000);
+              })();
+            </script>
+          </div>
         </div>
       </div>
 

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.0
+**Version:** v7.7.2
 
 ---
 

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.0";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.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}
 `),process.stdout.write(`Install with:
 `),process.stdout.write(`  brew install jq    (macOS)
 `),process.stdout.write(`  apt install jq     (Debian/Ubuntu)
@@ -76,7 +76,8 @@ if not os.path.isdir(loki_dir):
     result['status'] = 'inactive'
     result['phase'] = None
     result['iteration'] = 0
-    result['provider'] = env_provider
+    result['provider'] = env_provider if os.environ.get('LOKI_PROVIDER', '') else 'claude'
+    result['provider_source'] = 'env' if os.environ.get('LOKI_PROVIDER', '') else 'default'
     result['dashboard_url'] = None
     result['pid'] = None
     result['elapsed_time'] = 0
@@ -134,13 +135,26 @@ else:
         result['phase'] = None
         result['iteration'] = 0
 
-# Provider
+# Provider + provider_source (v7.7.2 B-5 clarity, parity with bash)
 provider_file = os.path.join(loki_dir, 'state', 'provider')
 if os.path.isfile(provider_file):
-    with open(provider_file) as f:
-        result['provider'] = f.read().strip()
+    try:
+        with open(provider_file) as f:
+            saved = f.read().strip()
+    except OSError:
+        saved = ''
 else:
+    saved = ''
+env_set = os.environ.get('LOKI_PROVIDER', '') != ''
+if saved:
+    result['provider'] = saved
+    result['provider_source'] = 'saved'
+elif env_set:
     result['provider'] = env_provider
+    result['provider_source'] = 'env'
+else:
+    result['provider'] = 'claude'
+    result['provider_source'] = 'default'
 
 # PID
 pid_file = os.path.join(loki_dir, 'loki.pid')
@@ -536,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=348EAA6B87891DE264756E2164756E21
+//# debugId=031A27C701A5C40664756E2164756E21

package/mcp/__init__.py

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "7.7.0",
+  "version": "7.7.2",
   "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",