loki-mode 7.7.21 → 7.7.24

package/README.md

@@ -24,15 +24,15 @@
 
 ## Why Loki Mode?
 
-- **Truly autonomous** -- Describe what you want, walk away, come back to working code with tests
+- **Spec to product, autonomously** -- Describe what you want, walk away, come back to working code with tests. Loki runs the full RARV-C closure loop (Reason - Act - Reflect - Verify - Close) until the work is actually done, not just attempted.
 - **Production quality built in** -- 11 quality gates (`skills/quality-gates.md`), blind 3-reviewer code review (`run.sh:run_code_review()`), anti-sycophancy checks
+- **Cross-project memory** -- Episodic/semantic/procedural memory with vector search; knowledge learned on one project surfaces on the next (v5.15.0+, see `memory/engine.py`)
 - **Self-hosted and private** -- Your keys, your infrastructure, no data leaves your network
-- **4 active AI providers** -- Claude, Codex, Cline, Aider with automatic failover (`loki-ts/src/runner/providers.ts`). Gemini CLI deprecated v7.5.18; Antigravity CLI coming soon.
 - **Legacy system healing** -- `loki heal` archaeology/stabilize/isolate/modernize/validate phases (v6.67.0, see `skills/healing.md`)
-- **Memory system** -- Episodic/semantic/procedural with vector search (v5.15.0, see `memory/engine.py`)
 - **MCP server** -- 15 tools including ChromaDB code search (`mcp/server.py`)
 - **Full-stack output** -- Source code, tests, Docker configs, CI/CD pipelines, audit logs
-- **Open source** -- Free for personal, internal, and academic use. No vendor lock-in.
+- **Provider-agnostic** -- runs on Claude, Codex, Cline, or Aider with automatic failover (`loki-ts/src/runner/providers.ts`); no vendor lock-in. Gemini CLI deprecated v7.5.18; Antigravity CLI coming soon.
+- **Open source** -- Free for personal, internal, and academic use.
 
 ---
 
@@ -302,7 +302,9 @@ Loki Mode is the only platform that is fully self-hosted, open source, and inclu
 
 ---
 
-## Multi-Provider Support
+## Provider-Agnostic Runtime
+
+Loki's autonomy and quality loop are the product; the underlying coding CLI is swappable. Loki runs on any of the providers below so you are never locked to one vendor.
 
 | Provider | Status | Autonomous Flag | Parallel Agents | Install |
 |----------|--------|:-:|:-:|---------|

package/SKILL.md

@@ -1,15 +1,15 @@
 ---
 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.
+description: Autonomous spec-to-product system. Triggers on "Loki Mode". Takes a spec (PRD, GitHub issue, OpenAPI doc, etc.) to deployed product via the RARV-C closure loop, with minimal human intervention. Provider-agnostic. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v7.7.21
+# Loki Mode v7.7.24
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
 **Spec in, product out.** A "spec" is whatever describes the work: a Markdown PRD, a GitHub issue, an OpenAPI doc, a Jira ticket -- a PRD is one form of spec.
 
-**Multi-provider (stable since v5.0.0):** Claude/Codex/Cline/Aider with abstract model tiers and degraded mode for non-Claude providers. Gemini deprecated v7.5.18. See `skills/providers.md`. **Current track (v7.7.x):** LSP grounding as first-class agent tool (v7.7.0-v7.7.9; lsp_get_diagnostics actually-returns-diagnostics regression fix v7.7.14), provider_source cli (v7.7.11-v7.7.12 bash/bun parity), Docker/bash-3.2 robustness (v7.7.13), audit chain cross-file verification fix (v7.7.15), Phase 1 RARV-C closure (real provider judges, gate-failure flock, synthetic PRD e2e, status `--json`).
+**Provider-agnostic (stable since v5.0.0):** runs on Claude/Codex/Cline/Aider with abstract model tiers and degraded mode for non-Claude providers; no vendor lock-in. Gemini deprecated v7.5.18. See `skills/providers.md`. **Current track (v7.7.x):** LSP grounding as first-class agent tool (v7.7.0-v7.7.9; lsp_get_diagnostics actually-returns-diagnostics regression fix v7.7.14), provider_source cli (v7.7.11-v7.7.12 bash/bun parity), Docker/bash-3.2 robustness (v7.7.13), audit chain cross-file verification fix (v7.7.15), Phase 1 RARV-C closure (real provider judges, gate-failure flock, synthetic PRD e2e, status `--json`).
 
 **Runtime migration:** Bash-to-Bun migration. Read-only commands (`version`, `status`, `stats`, `doctor`, `provider show/list`, `memory list/index`) flow through Bun runtime via `bin/loki` since v7.3.0. Every other command remains on the Bash runtime (`autonomy/loki`). Rollback: `LOKI_LEGACY_BASH=1`. See `UPGRADING.md` and `docs/architecture/ADR-001-runtime-migration.md`.
 
@@ -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.21 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v7.7.24 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-7.7.21
+7.7.24

package/autonomy/loki

@@ -299,6 +299,30 @@ load_memory_context() {
         return 0
     fi
 
+    # v7.7.23 privacy opt-out (excellence bar 6): honor a per-project
+    # .loki/config.json {"memory": {"disabled": true}} flag. Lets a user
+    # disable ALL memory capture/retrieval for a sensitive project without
+    # setting an env var on every invocation.
+    if [ -f "$LOKI_DIR/config.json" ]; then
+        # v7.7.23 council fix (Opus 2): FAIL-CLOSED. A config.json that
+        # exists but cannot be parsed prints 'true' (suppress memory) so
+        # a JSON typo on a sensitive project does not silently re-enable
+        # retrieval. Only the no-config case (outer -f guard false)
+        # proceeds with memory on.
+        local _mem_disabled
+        _mem_disabled=$(python3 -c "
+import json, sys
+try:
+    d = json.load(open('$LOKI_DIR/config.json'))
+    print('true' if d.get('memory', {}).get('disabled') is True else 'false')
+except Exception:
+    print('true')  # malformed config -> fail closed (suppress memory)
+" 2>/dev/null || echo "true")
+        if [ "$_mem_disabled" = "true" ]; then
+            return 0
+        fi
+    fi
+
     # Check if python3 is available (required for memory system)
     if ! command -v python3 &> /dev/null; then
         echo -e "${YELLOW}Warning: python3 not found - memory context loading disabled${NC}" >&2
@@ -15054,6 +15078,7 @@ except Exception as e:
             echo ""
             echo "  loki memory ingest --from-claude-transcript <path>  # v7.7.18"
             echo "  loki memory ingest --from-stdin                     # v7.7.18"
+            echo "  loki memory replay <episode-id> [--json]            # v7.7.22"
             echo "  loki memory crossproject --for 'build api'          # v7.7.20"
             echo "  loki memory graph --export graph.json               # v7.7.20"
             echo "  loki memory graph rebuild                           # v7.7.20"
@@ -15138,6 +15163,41 @@ print(json.dumps({'episode_path': path}))
             fi
             ;;
 
+        replay)
+            # v7.7.22 wow feature: READ-ONLY deterministic session replay.
+            # Renders a past episode's action timeline + current state of
+            # touched files. Does NOT re-execute (LLM tool_uses are
+            # non-deterministic + re-running edits could clobber work;
+            # --apply deferred to a future release).
+            # Usage: loki memory replay <episode-id> [--json]
+            shift  # drop "replay"
+            local _replay_id=""
+            local _replay_json="false"
+            while [ $# -gt 0 ]; do
+                case "$1" in
+                    --json) _replay_json="true"; shift ;;
+                    -h|--help) echo "Usage: loki memory replay <episode-id> [--json]"; return 0 ;;
+                    *) [ -z "$_replay_id" ] && _replay_id="$1"; shift ;;
+                esac
+            done
+            if [ -z "$_replay_id" ]; then
+                echo -e "${RED}Usage: loki memory replay <episode-id> [--json]${NC}"
+                exit 1
+            fi
+            local _replay_mem
+            _replay_mem="$(pwd)/.loki/memory"
+            PYTHONPATH="${SKILL_DIR:-$(pwd)}" _LOKI_REPLAY_JSON="$_replay_json" python3 -c "
+import sys, os, json
+from memory.replay import replay_episode, render_markdown
+report = replay_episode(sys.argv[1], sys.argv[2])
+if os.environ.get('_LOKI_REPLAY_JSON') == 'true':
+    print(json.dumps(report, indent=2, default=str))
+else:
+    print(render_markdown(report))
+sys.exit(0 if report.get('found') else 1)
+" "$_replay_id" "$_replay_mem"
+            ;;
+
         crossproject)
             # v7.7.20: surface cross-project knowledge-graph patterns
             # (wakes the previously-dead memory/knowledge_graph.py).

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "7.7.21"
+__version__ = "7.7.24"
 
 # 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.21
+**Version:** v7.7.24
 
 ---
 
@@ -32,7 +32,7 @@ setting any flag to `0`.
 
 ### Earlier highlights still in scope
 - Bash-to-Bun runtime migration in progress (see `UPGRADING.md`)
-- 4-provider support: Claude (full), Codex, Cline, Aider
+- Provider-agnostic runtime: Claude (full), Codex, Cline, Aider (no vendor lock-in)
 - Memory system (episodic / semantic / procedural)
 - ChromaDB semantic code search via MCP
 

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 v=(K,$)=>{for(var Q in $)_7(K,Q,{get:$[Q],enumerable:!0,configurable:!0,set:P7.bind($,Q)})};var R=(K,$)=>()=>(K&&($=K(K=0)),$);var t=import.meta.require;var e1={};v(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 Q=S1(K);if(Q===K)break;K=Q}return u(i1,"..","..","..")}function N1(K){let $=K;for(let Q=0;Q<6;Q++){if(J1(u($,"VERSION"))&&J1(u($,"autonomy/run.sh")))return $;let X=S1($);if(X===$)break;$=X}return u(K,"..","..","..")}function P(){return process.env.LOKI_DIR??u(process.cwd(),".loki")}function k1(){return u(R7(),".loki")}var i1,p;var g=R(()=>{i1=S1(L7(import.meta.url));p=E7()});import{readFileSync as F7}from"fs";import{resolve as w7,dirname as x7}from"path";import{fileURLToPath as S7}from"url";function G1(){if(o!==null)return o;let K="7.7.21";if(typeof K==="string"&&K.length>0)return o=K,o;try{let $=x7(S7(import.meta.url)),Q=N1($);o=F7(w7(Q,"VERSION"),"utf-8").trim()}catch{o="unknown"}return o}var o=null;var D1=R(()=>{g()});var $0={};v($0,{runOrThrow:()=>N7,run:()=>k,commandVersion:()=>D7,commandExists:()=>h,ShellError:()=>C1});async function k(K,$={}){let Q=Bun.spawn({cmd:[...K],stdout:"pipe",stderr:"pipe",env:$.env?{...process.env,...$.env}:process.env,cwd:$.cwd}),X,Z;if($.timeoutMs&&$.timeoutMs>0)X=setTimeout(()=>{try{Q.kill("SIGTERM")}catch{}Z=setTimeout(()=>{try{Q.kill("SIGKILL")}catch{}},2000)},$.timeoutMs);try{let[W,z,q]=await Promise.all([new Response(Q.stdout).text(),new Response(Q.stderr).text(),Q.exited]);return{stdout:W,stderr:z,exitCode:q}}finally{if(X)clearTimeout(X);if(Z)clearTimeout(Z)}}async function N7(K,$={}){let Q=await k(K,$);if(Q.exitCode!==0)throw new C1(`command failed (${Q.exitCode}): ${K.join(" ")}`,Q.exitCode,Q.stdout,Q.stderr);return Q}async function h(K){let $=k7(K),Q=await k(["sh","-c",`command -v ${$}`],{timeoutMs:5000});if(Q.exitCode===0)return Q.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 h(K))return null;let X=await k([K,$],{timeoutMs:5000});if(X.exitCode!==0)return null;return((X.stdout||X.stderr).split(/\r?\n/)[0]?.trim()??"")||null}var C1;var n=R(()=>{C1=class C1 extends Error{message;exitCode;stdout;stderr;constructor(K,$,Q,X){super(K);this.message=K;this.exitCode=$;this.stdout=Q;this.stderr=X;this.name="ShellError"}}});function c(K){return C7?"":K}var C7,E,b,F,T6,O,D,w,H;var a=R(()=>{C7=(process.env.NO_COLOR??"").length>0;E=c("\x1B[0;31m"),b=c("\x1B[0;32m"),F=c("\x1B[1;33m"),T6=c("\x1B[0;34m"),O=c("\x1B[0;36m"),D=c("\x1B[1m"),w=c("\x1B[2m"),H=c("\x1B[0m")});import{existsSync as c7}from"fs";async function i(){if(X1!==void 0)return X1;let K="/opt/homebrew/bin/python3.12";if(c7(K))return X1=K,K;let $=await h("python3.12");if($)return X1=$,$;let Q=await h("python3");return X1=Q,Q}async function s(K,$={}){let Q=await i();if(!Q)return{stdout:"",stderr:"python3 not found",exitCode:127};return k([Q,"-c",K],$)}var X1;var Z1=R(()=>{n()});var G0={};v(G0,{runStatus:()=>Q5});import{existsSync as N,readFileSync as W1,readdirSync as W0,statSync as H0}from"fs";import{resolve as x,basename as a7}from"path";async function r7(){if(await h("jq"))return!0;return process.stdout.write(`${E}Error: jq is required but not installed.${H}
+var _7=Object.defineProperty;var I7=(K)=>K;function P7(K,$){this[K]=I7.bind(null,$)}var v=(K,$)=>{for(var Q in $)_7(K,Q,{get:$[Q],enumerable:!0,configurable:!0,set:P7.bind($,Q)})};var R=(K,$)=>()=>(K&&($=K(K=0)),$);var t=import.meta.require;var e1={};v(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 Q=S1(K);if(Q===K)break;K=Q}return u(i1,"..","..","..")}function N1(K){let $=K;for(let Q=0;Q<6;Q++){if(J1(u($,"VERSION"))&&J1(u($,"autonomy/run.sh")))return $;let X=S1($);if(X===$)break;$=X}return u(K,"..","..","..")}function P(){return process.env.LOKI_DIR??u(process.cwd(),".loki")}function k1(){return u(R7(),".loki")}var i1,p;var g=R(()=>{i1=S1(L7(import.meta.url));p=E7()});import{readFileSync as F7}from"fs";import{resolve as w7,dirname as x7}from"path";import{fileURLToPath as S7}from"url";function G1(){if(o!==null)return o;let K="7.7.24";if(typeof K==="string"&&K.length>0)return o=K,o;try{let $=x7(S7(import.meta.url)),Q=N1($);o=F7(w7(Q,"VERSION"),"utf-8").trim()}catch{o="unknown"}return o}var o=null;var D1=R(()=>{g()});var $0={};v($0,{runOrThrow:()=>N7,run:()=>k,commandVersion:()=>D7,commandExists:()=>h,ShellError:()=>C1});async function k(K,$={}){let Q=Bun.spawn({cmd:[...K],stdout:"pipe",stderr:"pipe",env:$.env?{...process.env,...$.env}:process.env,cwd:$.cwd}),X,Z;if($.timeoutMs&&$.timeoutMs>0)X=setTimeout(()=>{try{Q.kill("SIGTERM")}catch{}Z=setTimeout(()=>{try{Q.kill("SIGKILL")}catch{}},2000)},$.timeoutMs);try{let[W,z,q]=await Promise.all([new Response(Q.stdout).text(),new Response(Q.stderr).text(),Q.exited]);return{stdout:W,stderr:z,exitCode:q}}finally{if(X)clearTimeout(X);if(Z)clearTimeout(Z)}}async function N7(K,$={}){let Q=await k(K,$);if(Q.exitCode!==0)throw new C1(`command failed (${Q.exitCode}): ${K.join(" ")}`,Q.exitCode,Q.stdout,Q.stderr);return Q}async function h(K){let $=k7(K),Q=await k(["sh","-c",`command -v ${$}`],{timeoutMs:5000});if(Q.exitCode===0)return Q.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 h(K))return null;let X=await k([K,$],{timeoutMs:5000});if(X.exitCode!==0)return null;return((X.stdout||X.stderr).split(/\r?\n/)[0]?.trim()??"")||null}var C1;var n=R(()=>{C1=class C1 extends Error{message;exitCode;stdout;stderr;constructor(K,$,Q,X){super(K);this.message=K;this.exitCode=$;this.stdout=Q;this.stderr=X;this.name="ShellError"}}});function c(K){return C7?"":K}var C7,E,b,F,T6,O,D,w,H;var a=R(()=>{C7=(process.env.NO_COLOR??"").length>0;E=c("\x1B[0;31m"),b=c("\x1B[0;32m"),F=c("\x1B[1;33m"),T6=c("\x1B[0;34m"),O=c("\x1B[0;36m"),D=c("\x1B[1m"),w=c("\x1B[2m"),H=c("\x1B[0m")});import{existsSync as c7}from"fs";async function i(){if(X1!==void 0)return X1;let K="/opt/homebrew/bin/python3.12";if(c7(K))return X1=K,K;let $=await h("python3.12");if($)return X1=$,$;let Q=await h("python3");return X1=Q,Q}async function s(K,$={}){let Q=await i();if(!Q)return{stdout:"",stderr:"python3 not found",exitCode:127};return k([Q,"-c",K],$)}var X1;var Z1=R(()=>{n()});var G0={};v(G0,{runStatus:()=>Q5});import{existsSync as N,readFileSync as W1,readdirSync as W0,statSync as H0}from"fs";import{resolve as x,basename as a7}from"path";async function r7(){if(await h("jq"))return!0;return process.stdout.write(`${E}Error: jq is required but not installed.${H}
 `),process.stdout.write(`Install with:
 `),process.stdout.write(`  brew install jq    (macOS)
 `),process.stdout.write(`  apt install jq     (Debian/Ubuntu)
@@ -585,4 +585,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 X6=await Q6(Bun.argv.slice(2));process.exit(X6);
 
-//# debugId=0F0FAE2834FF534B64756E2164756E21
+//# debugId=2B5B8BCEF68E54B364756E2164756E21

package/mcp/__init__.py

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

package/mcp/server.py

@@ -1010,17 +1010,18 @@ async def loki_memory_capture_session_summary(
     try:
         from memory.ingest import ingest_from_summary, _capture_disabled
 
-        if _capture_disabled():
+        base_path = safe_path_join('.loki', 'memory')
+        # v7.7.23: pass base_path so the .loki/config.json memory.disabled
+        # opt-out is honored in addition to the env escape hatch.
+        if _capture_disabled(base_path):
             _emit_tool_event_async(
                 'loki_memory_capture_session_summary', 'complete',
-                result_status='skipped', error='disabled via env'
+                result_status='skipped', error='disabled via env or config'
             )
             return json.dumps({
-                "error": "memory capture disabled via LOKI_MEMORY_CAPTURE_DISABLED",
+                "error": "memory capture disabled (LOKI_MEMORY_CAPTURE_DISABLED or .loki/config.json memory.disabled)",
                 "disabled": True,
             })
-
-        base_path = safe_path_join('.loki', 'memory')
         path = ingest_from_summary(
             base_path,
             goal=goal,

package/memory/ingest.py

@@ -125,13 +125,34 @@ def _scrub_path(path: str) -> str:
     return path
 
 
-def _capture_disabled() -> bool:
-    """Honor `LOKI_MEMORY_CAPTURE_DISABLED=true` escape hatch."""
-    return os.environ.get("LOKI_MEMORY_CAPTURE_DISABLED", "").lower() in (
-        "true",
-        "1",
-        "yes",
-    )
+def _capture_disabled(memory_base: Optional[str] = None) -> bool:
+    """True when capture should be skipped.
+
+    Honors the `LOKI_MEMORY_CAPTURE_DISABLED=true` env escape hatch AND
+    (v7.7.23 privacy opt-out, excellence bar 6) a per-project
+    `.loki/config.json` `{"memory": {"disabled": true}}` flag. When
+    `memory_base` is provided (e.g. `<root>/.loki/memory`), the config
+    is resolved as its sibling `<root>/.loki/config.json`.
+    """
+    if os.environ.get("LOKI_MEMORY_CAPTURE_DISABLED", "").lower() in ("true", "1", "yes"):
+        return True
+    if memory_base:
+        # v7.7.23 council fix (Opus 2): FAIL-CLOSED. If a config.json
+        # EXISTS but cannot be parsed, the user's intent is ambiguous and
+        # the safe privacy default is to SUPPRESS capture (leaked data is
+        # irreversible; lost memory is recoverable). Only the no-config
+        # case fails open (capture proceeds = default behavior).
+        config_path = Path(memory_base).parent / "config.json"
+        if config_path.is_file():
+            try:
+                with open(config_path) as f:
+                    cfg = json.load(f)
+            except Exception:
+                # Config present but unreadable/malformed -> fail closed.
+                return True
+            if isinstance(cfg, dict) and cfg.get("memory", {}).get("disabled") is True:
+                return True
+    return False
 
 
 def _log_to_errors(memory_base: str, function_name: str, exc: BaseException) -> None:
@@ -301,7 +322,7 @@ def ingest_from_claude_transcript(
         Path to the written episode JSON on success; None on failure
         (silent fail, error logged to `.errors.log`).
     """
-    if _capture_disabled():
+    if _capture_disabled(memory_base):
         return None
     try:
         path = Path(transcript_path)
@@ -409,7 +430,7 @@ def ingest_from_summary(
 
     Returns episode path on success, None on failure.
     """
-    if _capture_disabled():
+    if _capture_disabled(memory_base):
         return None
     try:
         from memory.engine import MemoryEngine, create_storage

package/memory/knowledge_graph.py

@@ -167,30 +167,54 @@ class OrganizationKnowledgeGraph:
             self._graph = json.load(f)
         return self._graph
 
+    _STOPWORDS = {
+        'the', 'a', 'an', 'to', 'for', 'of', 'and', 'or', 'with', 'without',
+        'is', 'are', 'be', 'up', 'on', 'in', 'by', 'not', 'make', 'choose',
+        'store', 'how', 'do', 'i', 'we', 'my', 'our', 'this', 'that',
+    }
+
+    @classmethod
+    def _tokenize(cls, text):
+        """Lowercase, split on non-alphanumerics, drop stopwords + 1-2 char tokens."""
+        import re
+        toks = re.split(r'[^a-z0-9]+', str(text or '').lower())
+        return {t for t in toks if len(t) > 2 and t not in cls._STOPWORDS}
+
     def query_patterns(self, query, max_results=10):
-        """Simple keyword search across stored patterns.
+        """Keyword search across stored patterns.
+
+        Scores by token overlap between the query and each pattern's
+        name/pattern/description/category fields. Token overlap (not
+        whole-string substring) lets natural-language goals like "make
+        the charge endpoint safe to retry" match a pattern named
+        "idempotency-key-on-charge". A full-string substring hit still
+        gets a bonus, preserving prior behavior for exact queries.
 
-        Searches across 'name', 'pattern', 'description', and 'category'
-        fields for compatibility with both simple dicts and SemanticPattern
-        schema.
+        Searches 'name', 'pattern', 'description', and 'category' for
+        compatibility with both simple dicts and the SemanticPattern schema.
         """
         patterns = self.load_patterns(limit=1000)
         query_lower = query.lower()
+        query_tokens = self._tokenize(query)
         scored = []
+        # Per-field weight applied to each overlapping token.
+        fields = (('name', 3), ('pattern', 3), ('category', 2), ('description', 1))
         for p in patterns:
             score = 0
-            name = p.get('name', '').lower()
-            pattern_text = p.get('pattern', '').lower()
-            desc = p.get('description', '').lower()
-            category = p.get('category', '').lower()
-            if query_lower in name:
-                score += 3
-            if query_lower in pattern_text:
-                score += 3
-            if query_lower in desc:
-                score += 1
-            if query_lower in category:
-                score += 2
+            for field, weight in fields:
+                value = p.get(field, '')
+                if not value:
+                    continue
+                # Coerce non-string field values (a hand-edited or
+                # future-schema JSONL row could store a list/int) so we
+                # never crash on .lower() in the live retrieval path.
+                value_lower = str(value).lower()
+                # Whole-query substring bonus (preserves exact-match behavior).
+                if query_lower and query_lower in value_lower:
+                    score += weight
+                # Token-overlap scoring (enables NL-goal retrieval).
+                overlap = query_tokens & self._tokenize(value)
+                score += weight * len(overlap)
             if score > 0:
                 scored.append((score, p))
         scored.sort(key=lambda x: -x[0])

package/memory/replay.py

@@ -0,0 +1,192 @@
+"""v7.7.22: deterministic READ-ONLY session replay.
+
+Wow feature 1 from the memory excellence bar: no competitor offers
+session replay. `loki memory replay <episode-id>` re-renders a past
+episode's recorded action sequence as a timeline, annotated with the
+CURRENT state of each touched file (still exists? changed since the
+episode? present in git?). This answers "what did that session do, and
+what has changed since" without re-executing anything.
+
+DESIGN DECISION (v7.7.22): replay is READ-ONLY. It does NOT re-run the
+recorded tool_use sequence. LLM tool_uses are non-deterministic and
+re-running Edit/Write against the current repo could clobber
+uncommitted work. The `--apply` re-execution mode is deliberately
+deferred to a future release with proper sandboxing + confirmation.
+
+Output: a structured dict (the CLI renders Markdown or emits JSON).
+Never raises; returns an error dict on failure.
+"""
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+
+def _file_changed_since(repo_root: str, file_path: str, since_iso: Optional[str]) -> str:
+    """Return a current-state annotation for `file_path`.
+
+    One of: "missing", "unchanged-since", "changed-since",
+    "exists-no-timestamp", "exists-not-in-git". Best-effort; never raises.
+    """
+    abs_path = file_path if os.path.isabs(file_path) else os.path.join(repo_root, file_path)
+    if not os.path.exists(abs_path):
+        return "missing"
+    if not since_iso:
+        return "exists-no-timestamp"
+    # Use git to see if the file changed after the episode timestamp.
+    try:
+        # Normalize the ISO timestamp for git --since.
+        since = since_iso.replace("Z", "+00:00")
+        result = subprocess.run(
+            ["git", "-C", repo_root, "log", "--oneline", f"--since={since}", "--", file_path],
+            capture_output=True, text=True, timeout=10,
+        )
+        if result.returncode != 0:
+            return "exists-not-in-git"
+        commits = [ln for ln in result.stdout.splitlines() if ln.strip()]
+        return "changed-since" if commits else "unchanged-since"
+    except (subprocess.SubprocessError, OSError):
+        return "exists-no-timestamp"
+
+
+def replay_episode(
+    episode_id: str,
+    memory_base: str,
+    repo_root: Optional[str] = None,
+) -> Dict[str, Any]:
+    """Build a read-only replay report for `episode_id`.
+
+    Args:
+        episode_id: The episode id (without the `task-` prefix).
+        memory_base: Path to the project's `.loki/memory/` directory.
+        repo_root: Repo root for current-state annotations. Defaults to
+            the parent-of-parent of memory_base (i.e. the project root).
+
+    Returns:
+        dict: {episode_id, found, timestamp, goal, outcome, agent,
+        timeline:[{step, tool, target, timestamp}], files:[{path,
+        state}], summary:{steps, files_touched, files_missing,
+        files_changed_since}} or {error: ...}.
+    """
+    try:
+        from memory.storage import MemoryStorage
+        storage = MemoryStorage(memory_base)
+        episode = storage.load_episode(episode_id)
+        if episode is None:
+            return {"episode_id": episode_id, "found": False,
+                    "error": f"episode '{episode_id}' not found in {memory_base}"}
+
+        if repo_root is None:
+            # memory_base is typically <root>/.loki/memory
+            repo_root = str(Path(memory_base).resolve().parent.parent)
+
+        ts = episode.get("timestamp")
+        context = episode.get("context", {}) if isinstance(episode.get("context"), dict) else {}
+        goal = context.get("goal") or episode.get("goal") or episode.get("summary", "")
+
+        # Timeline from action_log (v7.7.18 format). Fall back to
+        # tools_used (older episode format) if action_log is empty.
+        timeline: List[Dict[str, Any]] = []
+        action_log = episode.get("action_log") or []
+        if action_log:
+            for i, a in enumerate(action_log, 1):
+                if isinstance(a, dict):
+                    timeline.append({
+                        "step": i,
+                        "tool": a.get("action", a.get("tool", "?")),
+                        "target": a.get("target", a.get("input", "")),
+                        "timestamp": a.get("t", a.get("timestamp", 0)),
+                    })
+        else:
+            for i, t in enumerate(episode.get("tools_used", []) or [], 1):
+                timeline.append({"step": i, "tool": str(t), "target": "", "timestamp": 0})
+
+        # Current-state annotations for touched files.
+        touched = []
+        seen = set()
+        for f in (episode.get("files_modified") or []) + (episode.get("files_changed") or []):
+            if f and f not in seen:
+                seen.add(f)
+                touched.append(f)
+        files = []
+        missing = 0
+        changed = 0
+        for f in touched:
+            state = _file_changed_since(repo_root, f, ts)
+            if state == "missing":
+                missing += 1
+            elif state == "changed-since":
+                changed += 1
+            files.append({"path": f, "state": state})
+
+        return {
+            "episode_id": episode_id,
+            "found": True,
+            "timestamp": ts,
+            "goal": str(goal)[:500],
+            "outcome": episode.get("outcome", "unknown"),
+            "agent": episode.get("agent", "unknown"),
+            "timeline": timeline,
+            "files": files,
+            "summary": {
+                "steps": len(timeline),
+                "files_touched": len(touched),
+                "files_missing": missing,
+                "files_changed_since": changed,
+            },
+            "mode": "read-only (dry-run); --apply re-execution deferred to a future release",
+            "generated_at": datetime.now(timezone.utc).isoformat(),
+        }
+    except Exception as e:
+        return {"episode_id": episode_id, "found": False, "error": str(e)}
+
+
+def render_markdown(report: Dict[str, Any]) -> str:
+    """Render a replay report dict as a human-readable Markdown timeline."""
+    if not report.get("found"):
+        return f"# Replay: {report.get('episode_id', '?')}\n\nNot found: {report.get('error', 'unknown error')}\n"
+    # v7.7.22 council fix (Opus 2): use .get() defaults throughout so a
+    # hand-built or partial report dict cannot KeyError. The CLI always
+    # passes a complete replay_episode() result, but render_markdown is
+    # public and may be called with sparse input.
+    lines = [
+        f"# Replay: {report.get('episode_id', '?')}",
+        "",
+        f"- Goal: {report.get('goal', '')}",
+        f"- Outcome: {report.get('outcome')}",
+        f"- Agent: {report.get('agent')}",
+        f"- Recorded: {report.get('timestamp')}",
+        f"- Mode: {report.get('mode')}",
+        "",
+        "## Timeline",
+        "",
+    ]
+    timeline = report.get("timeline") or []
+    if timeline:
+        for step in timeline:
+            lines.append(f"{step.get('step', '?')}. **{step.get('tool', '?')}** {step.get('target', '')}")
+    else:
+        lines.append("(no recorded actions)")
+    lines += ["", "## Files touched (current state)", ""]
+    files = report.get("files") or []
+    if files:
+        for f in files:
+            lines.append(f"- `{f.get('path', '?')}` -- {f.get('state', '?')}")
+    else:
+        lines.append("(none)")
+    s = report.get("summary") or {}
+    lines += [
+        "",
+        "## Summary",
+        "",
+        f"- Steps: {s['steps']}",
+        f"- Files touched: {s['files_touched']}",
+        f"- Now missing: {s['files_missing']}",
+        f"- Changed since episode: {s['files_changed_since']}",
+        "",
+    ]
+    return "\n".join(lines)

package/package.json

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