loki-mode 11.19.0 → 11.20.0

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: An autonomous software factory that knows what it is supposed to deliver, and proves it did. Use when the user says Loki Mode or asks to build, fix or verify software autonomously.
 ---
 
-# Loki Mode v11.19.0
+# Loki Mode v11.20.0
 
 **Current entry points (Loki 10 engine):** `loki "<task>"`, `loki owner/repo#N` and `loki quick "<task>"` run the Loki 10 engine and end with a signed receipt (`loki verify`). `loki backlog owner/repo --all` runs many issues in parallel. Guide: `docs/v10/GUIDE.md`. The skill instructions below, and `loki start`, describe the previous bash loop. PRD-file starts (`loki start ./prd.md`) and the opencode provider still run on it until FC38-SWEEP ports them; the legacy-engine command and the LOKI_ENGINE switch remain removed. Prefer `loki owner/repo#N` for issues.
 
@@ -483,4 +483,4 @@ See `CHANGELOG.md` entries [7.5.7], [7.5.8], [7.5.13] for the per-fix list and r
 
 ---
 
-**v11.19.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**
+**v11.20.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**

package/VERSION

@@ -1 +1 @@
-11.19.0
+11.20.0

package/dashboard/__init__.py

@@ -7,6 +7,6 @@ Modules:
     control: Session control helpers (status, atomic writes, origin check)
 """
 
-__version__ = "11.19.0"
+__version__ = "11.20.0"
 
 __all__ = ["__version__"]

package/docs/CLI-REFERENCE.md

@@ -1,6 +1,6 @@
 # CLI reference
 
-Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.19.0. Do not edit by hand.
+Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.20.0. Do not edit by hand.
 Hidden and legacy-only commands are omitted; see `docs/v10/CLI-MODERN.md` for the full inventory.
 
 | Command | Description |

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 Loki Mode, by [Autonomi](https://www.autonomi.dev/), turns a spec or an issue into a verified pull request with a receipt you can check. This page covers installing it, a first run, and the options around it.
 
-**Version:** v11.19.0
+**Version:** v11.20.0
 
 **Engine note:** `loki start` is the primary command. `loki start`, `loki "<task>"`, `loki owner/repo#N` and `loki quick` all run the Loki 10 engine, whatever the flag order or input form (PRD file, issue ref, task or one-word brief). The previous loop runs only on `--engine legacy`, `LOKI_ENGINE=legacy`, or for one call when a flag Loki 10 cannot honor is present. See the [user guide](v10/GUIDE.md) and the [5-minute quickstart](QUICKSTART.md).
 

package/loki-ts/dist/loki.js

@@ -1,5 +1,5 @@
 // @bun
-var ky0=Object.create;var{getPrototypeOf:xy0,defineProperty:UK,getOwnPropertyNames:wi,getOwnPropertyDescriptor:Sy0}=Object,_i=Object.prototype.hasOwnProperty;function ki(Z){return this[Z]}var yy0,by0,vy0=(Z,$,J)=>{var X=Z!=null&&typeof Z==="object";if(X){var Y=$?yy0??=new WeakMap:by0??=new WeakMap,Q=Y.get(Z);if(Q)return Q}J=Z!=null?ky0(xy0(Z)):{};let z=$||!Z||!Z.__esModule?UK(J,"default",{value:Z,enumerable:!0}):J;for(let W of wi(Z))if(!_i.call(z,W))UK(z,W,{get:ki.bind(Z,W),enumerable:!0});if(X)Y.set(Z,z);return z},hy0=(Z)=>{var $=(Di??=new WeakMap).get(Z),J;if($)return $;if($=UK({},"__esModule",{value:!0}),Z&&typeof Z==="object"||typeof Z==="function"){for(var X of wi(Z))if(!_i.call($,X))UK($,X,{get:ki.bind(Z,X),enumerable:!(J=Sy0(Z,X))||J.enumerable})}return Di.set(Z,$),$},Di,vN=(Z,$)=>()=>($||Z(($={exports:{}}).exports,$),$.exports);var fy0=(Z)=>Z;function gy0(Z,$){this[Z]=fy0.bind(null,$)}var A0=(Z,$)=>{for(var J in $)UK(Z,J,{get:$[J],enumerable:!0,configurable:!0,set:gy0.bind($,J)})};var S=(Z,$)=>()=>(Z&&($=Z(Z=0)),$);var s9=import.meta.require;var Si={};A0(Si,{lokiDir:()=>P0,homeLokiDir:()=>B2,findRepoRootForVersion:()=>BK,REPO_ROOT:()=>F0});import{resolve as AZ,dirname as mR}from"path";import{fileURLToPath as my0}from"url";import{existsSync as hN}from"fs";import{homedir as uy0}from"os";function py0(){let Z=xi;for(let $=0;$<6;$++){if(hN(AZ(Z,"VERSION"))&&hN(AZ(Z,"autonomy/run.sh")))return Z;let J=mR(Z);if(J===Z)break;Z=J}return AZ(xi,"..","..","..")}function BK(Z){let $=Z;for(let J=0;J<6;J++){if(hN(AZ($,"VERSION"))&&hN(AZ($,"autonomy/run.sh")))return $;let X=mR($);if(X===$)break;$=X}return AZ(Z,"..","..","..")}function P0(){return process.env.LOKI_DIR??AZ(process.cwd(),".loki")}function B2(){return AZ(uy0(),".loki")}var xi,F0;var n0=S(()=>{xi=mR(my0(import.meta.url));F0=py0()});import{readFileSync as dy0}from"fs";import{resolve as cy0,dirname as ly0}from"path";import{fileURLToPath as ay0}from"url";function q6(){if(D1!==null)return D1;let Z="11.19.0";if(typeof Z==="string"&&Z.length>0)return D1=Z,D1;try{let $=ly0(ay0(import.meta.url)),J=BK($);D1=dy0(cy0(J,"VERSION"),"utf-8").trim()}catch{D1="unknown"}return D1}var D1=null;var LZ=S(()=>{n0()});import{mkdirSync as pR,readFileSync as fN,realpathSync as iy0,statSync as oy0,writeFileSync as dR}from"fs";import{dirname as XY,join as uR,resolve as yi}from"path";function ey0(){return yi(B2(),"cache","update-check.json")}function jZ(Z){let $=/^(\d+)\.(\d+)\.(\d+)$/.exec(Z.trim());if(!$)return null;return[Number($[1]),Number($[2]),Number($[3])]}function NK(Z,$){let J=jZ(Z),X=jZ($);if(!J||!X)return!1;let[Y,Q,z]=J,[W,K,V]=X;if(Y!==W)return Y>W;if(Q!==K)return Q>K;return z>V}function bi(){let Z=(process.env.LOKI_NO_UPDATE_CHECK??"").trim().toLowerCase();if(Z==="1"||Z==="true"||Z==="yes")return!0;if(process.env.CI)return!0;if(!process.stdout.isTTY)return!0;return!1}function vi(Z){try{let $=fN(Z,"utf-8"),J=JSON.parse($);if(typeof J.checkedAt==="number"&&typeof J.latest==="string"&&jZ(J.latest)!==null)return{checkedAt:J.checkedAt,latest:J.latest}}catch{}return null}function Zb0(Z){try{let $=JSON.parse(fN(Z,"utf-8")).failedAt;if(typeof $==="number")return $}catch{}return null}function $b0(Z,$){let J=vi(Z);try{pR(XY(Z),{recursive:!0}),dR(Z,JSON.stringify({...J??{},failedAt:$}),"utf-8")}catch{}}function Jb0(Z,$){try{pR(XY(Z),{recursive:!0}),dR(Z,JSON.stringify($),"utf-8")}catch{}}async function Xb0(){try{let Z=await fetch(ny0,{signal:AbortSignal.timeout(ry0),headers:{accept:"application/json"}});if(!Z.ok)return null;let $=await Z.json();if(typeof $.version==="string"&&jZ($.version)!==null)return $.version}catch{}return null}async function Yb0(Z=Date.now(),$=Xb0,J=ey0()){let X=vi(J);if(X&&Z-X.checkedAt<sy0)return X.latest;let Y=Zb0(J);if(Y!==null&&Z-Y>=0&&Z-Y<ty0)return null;let Q=await $();if(Q===null)return $b0(J,Z),null;return Jb0(J,{checkedAt:Z,latest:Q}),Q}function Qb0(Z,$=process.env){if(jZ(Z)===null)return null;let X=$.PATH;if(!X)return null;let Y=new Set;for(let Q of X.split(":")){if(!Q)continue;let z=uR(Q,"loki"),W;try{oy0(z),W=iy0(z)}catch{continue}if(Y.has(W))continue;Y.add(W);try{let K=uR(XY(XY(W)),"package.json"),V=JSON.parse(fN(K,"utf8")).version;if(typeof V!=="string")continue;if(NK(V,Z))return{path:z,version:V}}catch{continue}}return null}function zb0(){return yi(B2(),"cache","last-seen-version.json")}function Wb0(Z,$={}){try{if(bi())return!1;if(jZ(Z)===null)return!1;let J=$.seenFile??zb0(),X=null;try{let Q=JSON.parse(fN(J,"utf-8")).version;if(typeof Q==="string"&&jZ(Q)!==null)X=Q}catch{}if(X!==null&&!NK(Z,X))return!1;try{pR(XY(J),{recursive:!0}),dR(J,JSON.stringify({version:Z}),"utf-8")}catch{return!1}if(X===null)return!1;return($.write??((Q)=>process.stderr.write(Q)))(`Loki Mode upgraded ${X} -> ${Z}. What is new: https://github.com/asklokesh/loki-mode/releases/tag/v${Z}
+var ky0=Object.create;var{getPrototypeOf:xy0,defineProperty:UK,getOwnPropertyNames:wi,getOwnPropertyDescriptor:Sy0}=Object,_i=Object.prototype.hasOwnProperty;function ki(Z){return this[Z]}var yy0,by0,vy0=(Z,$,J)=>{var X=Z!=null&&typeof Z==="object";if(X){var Y=$?yy0??=new WeakMap:by0??=new WeakMap,Q=Y.get(Z);if(Q)return Q}J=Z!=null?ky0(xy0(Z)):{};let z=$||!Z||!Z.__esModule?UK(J,"default",{value:Z,enumerable:!0}):J;for(let W of wi(Z))if(!_i.call(z,W))UK(z,W,{get:ki.bind(Z,W),enumerable:!0});if(X)Y.set(Z,z);return z},hy0=(Z)=>{var $=(Di??=new WeakMap).get(Z),J;if($)return $;if($=UK({},"__esModule",{value:!0}),Z&&typeof Z==="object"||typeof Z==="function"){for(var X of wi(Z))if(!_i.call($,X))UK($,X,{get:ki.bind(Z,X),enumerable:!(J=Sy0(Z,X))||J.enumerable})}return Di.set(Z,$),$},Di,vN=(Z,$)=>()=>($||Z(($={exports:{}}).exports,$),$.exports);var fy0=(Z)=>Z;function gy0(Z,$){this[Z]=fy0.bind(null,$)}var A0=(Z,$)=>{for(var J in $)UK(Z,J,{get:$[J],enumerable:!0,configurable:!0,set:gy0.bind($,J)})};var S=(Z,$)=>()=>(Z&&($=Z(Z=0)),$);var s9=import.meta.require;var Si={};A0(Si,{lokiDir:()=>P0,homeLokiDir:()=>B2,findRepoRootForVersion:()=>BK,REPO_ROOT:()=>F0});import{resolve as AZ,dirname as mR}from"path";import{fileURLToPath as my0}from"url";import{existsSync as hN}from"fs";import{homedir as uy0}from"os";function py0(){let Z=xi;for(let $=0;$<6;$++){if(hN(AZ(Z,"VERSION"))&&hN(AZ(Z,"autonomy/run.sh")))return Z;let J=mR(Z);if(J===Z)break;Z=J}return AZ(xi,"..","..","..")}function BK(Z){let $=Z;for(let J=0;J<6;J++){if(hN(AZ($,"VERSION"))&&hN(AZ($,"autonomy/run.sh")))return $;let X=mR($);if(X===$)break;$=X}return AZ(Z,"..","..","..")}function P0(){return process.env.LOKI_DIR??AZ(process.cwd(),".loki")}function B2(){return AZ(uy0(),".loki")}var xi,F0;var n0=S(()=>{xi=mR(my0(import.meta.url));F0=py0()});import{readFileSync as dy0}from"fs";import{resolve as cy0,dirname as ly0}from"path";import{fileURLToPath as ay0}from"url";function q6(){if(D1!==null)return D1;let Z="11.20.0";if(typeof Z==="string"&&Z.length>0)return D1=Z,D1;try{let $=ly0(ay0(import.meta.url)),J=BK($);D1=dy0(cy0(J,"VERSION"),"utf-8").trim()}catch{D1="unknown"}return D1}var D1=null;var LZ=S(()=>{n0()});import{mkdirSync as pR,readFileSync as fN,realpathSync as iy0,statSync as oy0,writeFileSync as dR}from"fs";import{dirname as XY,join as uR,resolve as yi}from"path";function ey0(){return yi(B2(),"cache","update-check.json")}function jZ(Z){let $=/^(\d+)\.(\d+)\.(\d+)$/.exec(Z.trim());if(!$)return null;return[Number($[1]),Number($[2]),Number($[3])]}function NK(Z,$){let J=jZ(Z),X=jZ($);if(!J||!X)return!1;let[Y,Q,z]=J,[W,K,V]=X;if(Y!==W)return Y>W;if(Q!==K)return Q>K;return z>V}function bi(){let Z=(process.env.LOKI_NO_UPDATE_CHECK??"").trim().toLowerCase();if(Z==="1"||Z==="true"||Z==="yes")return!0;if(process.env.CI)return!0;if(!process.stdout.isTTY)return!0;return!1}function vi(Z){try{let $=fN(Z,"utf-8"),J=JSON.parse($);if(typeof J.checkedAt==="number"&&typeof J.latest==="string"&&jZ(J.latest)!==null)return{checkedAt:J.checkedAt,latest:J.latest}}catch{}return null}function Zb0(Z){try{let $=JSON.parse(fN(Z,"utf-8")).failedAt;if(typeof $==="number")return $}catch{}return null}function $b0(Z,$){let J=vi(Z);try{pR(XY(Z),{recursive:!0}),dR(Z,JSON.stringify({...J??{},failedAt:$}),"utf-8")}catch{}}function Jb0(Z,$){try{pR(XY(Z),{recursive:!0}),dR(Z,JSON.stringify($),"utf-8")}catch{}}async function Xb0(){try{let Z=await fetch(ny0,{signal:AbortSignal.timeout(ry0),headers:{accept:"application/json"}});if(!Z.ok)return null;let $=await Z.json();if(typeof $.version==="string"&&jZ($.version)!==null)return $.version}catch{}return null}async function Yb0(Z=Date.now(),$=Xb0,J=ey0()){let X=vi(J);if(X&&Z-X.checkedAt<sy0)return X.latest;let Y=Zb0(J);if(Y!==null&&Z-Y>=0&&Z-Y<ty0)return null;let Q=await $();if(Q===null)return $b0(J,Z),null;return Jb0(J,{checkedAt:Z,latest:Q}),Q}function Qb0(Z,$=process.env){if(jZ(Z)===null)return null;let X=$.PATH;if(!X)return null;let Y=new Set;for(let Q of X.split(":")){if(!Q)continue;let z=uR(Q,"loki"),W;try{oy0(z),W=iy0(z)}catch{continue}if(Y.has(W))continue;Y.add(W);try{let K=uR(XY(XY(W)),"package.json"),V=JSON.parse(fN(K,"utf8")).version;if(typeof V!=="string")continue;if(NK(V,Z))return{path:z,version:V}}catch{continue}}return null}function zb0(){return yi(B2(),"cache","last-seen-version.json")}function Wb0(Z,$={}){try{if(bi())return!1;if(jZ(Z)===null)return!1;let J=$.seenFile??zb0(),X=null;try{let Q=JSON.parse(fN(J,"utf-8")).version;if(typeof Q==="string"&&jZ(Q)!==null)X=Q}catch{}if(X!==null&&!NK(Z,X))return!1;try{pR(XY(J),{recursive:!0}),dR(J,JSON.stringify({version:Z}),"utf-8")}catch{return!1}if(X===null)return!1;return($.write??((Q)=>process.stderr.write(Q)))(`Loki Mode upgraded ${X} -> ${Z}. What is new: https://github.com/asklokesh/loki-mode/releases/tag/v${Z}
 `),!0}catch{return!1}}function Kb0(Z){let $=Z.replace(/\\/g,"/");if($.includes("/Cellar/"))return"brew upgrade loki-mode";if(/\/pnpm\//.test($)||$.includes("/.pnpm/"))return"pnpm add -g loki-mode  (or npm i -g loki-mode)";if($.includes("/yarn/global/")||$.includes("/.yarn/"))return"yarn global add loki-mode  (or npm i -g loki-mode)";if($.includes("/.bun/"))return"bun install -g loki-mode  (or npm i -g loki-mode)";if($.includes("/lib/node_modules/"))return"npm i -g loki-mode  (or bun install -g loki-mode)";if($.includes("/homebrew/"))return"brew upgrade loki-mode";return"bun install -g loki-mode  (or npm i -g loki-mode)"}async function hi(Z,$={}){try{if(bi())return;if(jZ(Z)===null)return;let J=$.write??((Q)=>process.stderr.write(Q));Wb0(Z,{write:J,...$.cacheFile?{seenFile:uR(XY($.cacheFile),"last-seen-version.json")}:{}});let X=Qb0(Z,$.env??process.env);if(X!==null){J(`Loki Mode ${X.version} is installed but not the one running (you are running ${Z}).
   Another loki earlier on PATH is winning. Newer copy: ${X.path}
   Run \`which -a loki\` to see the order, then remove or re-point the earlier entry.
@@ -3236,4 +3236,4 @@ Unknown commands exit 2 with a suggestion; run 'loki help' for the full list.
 `);{let{suggestCommand:X}=await Promise.resolve().then(() => (t7(),No)),Y=$===void 0?void 0:X($);if(Y)process.stderr.write(`Did you mean 'loki ${Y}'?
 `)}return process.stderr.write(Ty0),2}}DF0();var Py0=()=>globalThis[Symbol.for("loki.ownsStopSignals")]===!0;process.on("SIGINT",()=>{if(!Py0())process.exit(130)});process.on("SIGTERM",()=>{if(!Py0())process.exit(143)});var aH9=await lH9(Bun.argv.slice(2));process.exit(aH9);
 
-//# debugId=68A80C3FAC4009458196680E365035F7
+//# debugId=1C6B0BF2D739E7FB0A438A0B127FC984

package/mcp/__init__.py

@@ -75,4 +75,4 @@ try:
 except ImportError:
     __all__ = ['mcp']
 
-__version__ = '11.19.0'
+__version__ = '11.20.0'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "loki-mode",
   "mcpName": "io.github.asklokesh/loki-mode",
-  "version": "11.19.0",
+  "version": "11.20.0",
   "description": "An autonomous software factory that knows what it is supposed to deliver, and proves it did.",
   "keywords": [
     "agent",
@@ -160,5 +160,5 @@
   "dependencies": {
     "@resvg/resvg-wasm": "^2.6.2"
   },
-  "gitHead": "3ce6902a1ec7ecec2cf0294e55ea96cb735f8bc0"
+  "gitHead": "f75f7870ffb623de7e2ec4c5c130d2fb136a910f"
 }

package/plugins/loki-mode/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "loki-mode",
   "displayName": "Loki Mode",
-  "version": "11.19.0",
+  "version": "11.20.0",
   "description": "Autonomous spec-to-product build system with a built-in trust layer (RARV-C closure loop, 8 quality gates, completion council). Ships Loki's spec-hardening, drift-detection, and deterministic PR verification commands plus the Loki MCP server.",
   "author": {
     "name": "Autonomi",

package/skills/00-index.md

@@ -1,5 +1,33 @@
 # Skill Modules Index
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Module Selection Rules](#module-selection-rules)
+- [Module Descriptions](#module-descriptions)
+  - [model-selection.md](#model-selectionmd)
+  - [quality-gates.md](#quality-gatesmd)
+  - [patterns-advanced.md](#patterns-advancedmd)
+  - [testing.md](#testingmd)
+  - [production.md](#productionmd)
+  - [troubleshooting.md](#troubleshootingmd)
+  - [agents.md](#agentsmd)
+  - [artifacts.md](#artifactsmd)
+  - [parallel-workflows.md](#parallel-workflowsmd)
+  - [github-integration.md](#github-integrationmd)
+  - [openspec-integration.md](#openspec-integrationmd)
+  - [mirofish-integration.md](#mirofish-integrationmd)
+  - [documentation.md](#documentationmd)
+  - [compound-learning.md (v5.30.0)](#compound-learningmd-v5300)
+  - [healing.md (v6.67.0)](#healingmd-v6670)
+  - [sdlc-fleet.md](#sdlc-fleetmd)
+  - [factory-operations.md](#factory-operationsmd)
+  - [release-cadence.md](#release-cadencemd)
+  - [extending.md](#extendingmd)
+  - [providers.md (v5.0.0)](#providersmd-v500)
+- [How to Load](#how-to-load)
+<!-- TOC:END -->
+
 **Load 1-3 modules based on your current task. Do not load all modules.**
 
 > **Full documentation:** For comprehensive details, see `references/` directory:

package/skills/agents.md

@@ -1,5 +1,19 @@
 # Agent Dispatch & Structured Prompting
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [How Agents Actually Work](#how-agents-actually-work)
+- [Structured Prompting Template](#structured-prompting-template)
+- [Specialist Review Pattern (v5.30.0)](#specialist-review-pattern-v5300)
+- [Confidence-Based Routing](#confidence-based-routing)
+- [Agent Handoffs](#agent-handoffs)
+- [Project AGENTS.md](#project-agentsmd)
+- [A2A-Inspired Communication (Google Protocol)](#a2a-inspired-communication-google-protocol)
+- [Agentic Patterns Reference (awesome-agentic-patterns)](#agentic-patterns-reference-awesome-agentic-patterns)
+- [The 41 Agent Roles (37 Domain + 4 Orchestration)](#the-41-agent-roles-37-domain--4-orchestration)
+<!-- TOC:END -->
+
 > **Full agent type definitions:** See `references/agent-types.md` for complete 41 agent role specifications across 8 domains (Engineering, Operations, Business, Data, Product, Growth, Review, Orchestration). These are prompt-defined specifications the orchestrator adopts per phase; parallelism on Claude Code comes from the blind review council, the adversarial reviewer, and optional git-worktree streams, sequential on other providers.
 
 ---

package/skills/artifacts.md

@@ -1,5 +1,17 @@
 # Artifact Generation & Code Transformation
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Artifact Generation (Antigravity Pattern)](#artifact-generation-antigravity-pattern)
+- [Artifact Types](#artifact-types)
+  - [Verification Report](#verification-report)
+  - [Architecture Diff](#architecture-diff)
+  - [Screenshot Gallery](#screenshot-gallery)
+- [Code Transformation Agent (Amazon Q Pattern)](#code-transformation-agent-amazon-q-pattern)
+- [Release Notes Generation](#release-notes-generation)
+<!-- TOC:END -->
+
 ## Artifact Generation (Antigravity Pattern)
 
 **Auto-generate verifiable deliverables for audit trail without human intervention.**

package/skills/compound-learning.md

@@ -1,5 +1,25 @@
 # Compound Learning & Deep Planning
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Knowledge Compounding (Post-VERIFY)](#knowledge-compounding-post-verify)
+  - [When to Compound](#when-to-compound)
+  - [When NOT to Compound](#when-not-to-compound)
+  - [Solution File Format](#solution-file-format)
+  - [Categories](#categories)
+  - [YAML Frontmatter Fields](#yaml-frontmatter-fields)
+- [Loading Solutions (REASON Phase)](#loading-solutions-reason-phase)
+  - [Matching Logic](#matching-logic)
+  - [Context Injection Format](#context-injection-format)
+- [Deepen-Plan Phase](#deepen-plan-phase)
+  - [When to Run](#when-to-run)
+  - [Research Agents (4 parallel -- launch in ONE message)](#research-agents-4-parallel----launch-in-one-message)
+  - [After All 4 Complete](#after-all-4-complete)
+  - [Example Output Integration](#example-output-integration)
+- [Composable Phases](#composable-phases)
+<!-- TOC:END -->
+
 **Inspired by:** Compound Engineering Plugin (Every/Kieran Klaassen) -- knowledge compounding philosophy where each unit of work makes subsequent work easier.
 
 ---

package/skills/documentation.md

@@ -1,5 +1,23 @@
 # Documentation Skill Module
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Research Foundation](#research-foundation)
+- [When to Load This Module](#when-to-load-this-module)
+- [Documentation Types](#documentation-types)
+- [Model Selection](#model-selection)
+- [Repowise Integration](#repowise-integration)
+  - [Detection](#detection)
+- [Documentation Quality Criteria](#documentation-quality-criteria)
+- [Prompts](#prompts)
+  - [For README generation](#for-readme-generation)
+  - [For ARCHITECTURE generation](#for-architecture-generation)
+  - [For API documentation](#for-api-documentation)
+  - [For DECISIONS documentation](#for-decisions-documentation)
+- [Integration with Other Skills](#integration-with-other-skills)
+<!-- TOC:END -->
+
 ## Research Foundation
 
 | Source | Key Contribution | Citation |

package/skills/extending.md

@@ -1,5 +1,18 @@
 # Extending the Loop
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [What is actually extensible today](#what-is-actually-extensible-today)
+- [The reviewer seam (R10)](#the-reviewer-seam-r10)
+  - [Install](#install)
+  - [When it fires](#when-it-fires)
+- [Three invariants you cannot override](#three-invariants-you-cannot-override)
+- [Manifests are data, never code](#manifests-are-data-never-code)
+- [`src/plugins/` is NOT a seam (status: unwired)](#srcplugins-is-not-a-seam-status-unwired)
+- [Adding a real gate](#adding-a-real-gate)
+<!-- TOC:END -->
+
 **When to load:** you want to add your own reviewer, agent, or gate to the RARV
 loop without editing engine files.
 

package/skills/factory-operations.md

@@ -1,5 +1,28 @@
 # Factory Operations (skill module)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [1. Roles: what each one DECIDES vs what it ADVISES](#1-roles-what-each-one-decides-vs-what-it-advises)
+- [2. Partition: how two teams never edit the same file](#2-partition-how-two-teams-never-edit-the-same-file)
+  - [2.1 Per-file ownership is the primary mechanism](#21-per-file-ownership-is-the-primary-mechanism)
+  - [2.2 Worktree isolation is the EXCEPTION, not the default](#22-worktree-isolation-is-the-exception-not-the-default)
+  - [2.3 A red test during a review window may be someone else's mutation](#23-a-red-test-during-a-review-window-may-be-someone-elses-mutation)
+- [3. WIP limit](#3-wip-limit)
+  - [3.1 Why one gate, not more](#31-why-one-gate-not-more)
+  - [3.2 Why 3 implementation streams](#32-why-3-implementation-streams)
+  - [3.3 The admission rule](#33-the-admission-rule)
+- [4. Escalation: what a blocked team does instead of waiting](#4-escalation-what-a-blocked-team-does-instead-of-waiting)
+  - [4.1 A stall is a measurement problem, not a patience problem](#41-a-stall-is-a-measurement-problem-not-a-patience-problem)
+  - [4.2 An exit code reports a PROCESS, never the WORLD](#42-an-exit-code-reports-a-process-never-the-world)
+- [5. Release windows: main is WIP=1](#5-release-windows-main-is-wip1)
+- [6. Contended main: verify ancestry, never force](#6-contended-main-verify-ancestry-never-force)
+- [7. The void measurement: the failure shape that costs the most](#7-the-void-measurement-the-failure-shape-that-costs-the-most)
+  - [7.1 The three rules that follow](#71-the-three-rules-that-follow)
+  - [7.2 Why this is a COORDINATION rule, not a testing tip](#72-why-this-is-a-coordination-rule-not-a-testing-tip)
+  - [7.3 If this module is ever trimmed](#73-if-this-module-is-ever-trimmed)
+<!-- TOC:END -->
+
 **Purpose:** the operating system for running multiple agent teams against this
 repo at once without losing work, without false greens, and without the teams
 blocking each other.

package/skills/github-integration.md

@@ -1,5 +1,32 @@
 # GitHub Integration (v5.41.0)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Quick Reference](#quick-reference)
+- [Environment Variables](#environment-variables)
+- [Issue Import Workflow](#issue-import-workflow)
+  - [1. Check gh CLI Authentication](#1-check-gh-cli-authentication)
+  - [2. Import Open Issues](#2-import-open-issues)
+  - [3. Priority Mapping](#3-priority-mapping)
+- [PR Creation Workflow](#pr-creation-workflow)
+  - [PR Body Template](#pr-body-template)
+- [Status Sync Workflow](#status-sync-workflow)
+- [Usage Examples](#usage-examples)
+  - [Import Issues and Create PR](#import-issues-and-create-pr)
+  - [Sync with Specific Repo](#sync-with-specific-repo)
+  - [Filter by Milestone](#filter-by-milestone)
+- [Multiple issues at once (parallel, reliably)](#multiple-issues-at-once-parallel-reliably)
+  - [Sequential (simplest, one process, one checkout)](#sequential-simplest-one-process-one-checkout)
+  - [Concurrent (one isolated run PER issue)](#concurrent-one-isolated-run-per-issue)
+  - [Inside a Claude Code session (the Loki Mode skill)](#inside-a-claude-code-session-the-loki-mode-skill)
+- [CLI Commands](#cli-commands)
+- [Dashboard API](#dashboard-api)
+- [Sync Behavior](#sync-behavior)
+- [Error Handling](#error-handling)
+- [gh CLI Quick Reference](#gh-cli-quick-reference)
+<!-- TOC:END -->
+
 **When:** Importing issues from GitHub, creating PRs, syncing task status back
 
 > **Requires:** `gh` CLI authenticated (`gh auth status`)

package/skills/healing.md

@@ -1,5 +1,33 @@
 # Legacy System Healing
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Research Foundation](#research-foundation)
+- [When to Load This Module](#when-to-load-this-module)
+- [Core Principles](#core-principles)
+  - [1. Friction is Semantics (Amazon AGI Lab)](#1-friction-is-semantics-amazon-agi-lab)
+  - [2. Characterize Before Modifying (Feathers)](#2-characterize-before-modifying-feathers)
+  - [3. Strangler Fig Pattern (Fowler)](#3-strangler-fig-pattern-fowler)
+  - [4. Anti-Corruption Layer (Evans, DDD)](#4-anti-corruption-layer-evans-ddd)
+  - [5. System-Boundary Verification (RepoMod-Bench)](#5-system-boundary-verification-repomod-bench)
+- [Healing Pipeline](#healing-pipeline)
+  - [Phase Gates](#phase-gates)
+- [Healing RARV Cycle](#healing-rarv-cycle)
+  - [RARV-C Closure Flags (v7.5.0+)](#rarv-c-closure-flags-v750)
+- [Structured Fault Injection (Honest Alternative to RL Gyms)](#structured-fault-injection-honest-alternative-to-rl-gyms)
+- [Multi-Agent Decomposition (AWS Transform Pattern)](#multi-agent-decomposition-aws-transform-pattern)
+- [Health Score Formula](#health-score-formula)
+- [Healing-Specific Code Review](#healing-specific-code-review)
+- [Healing Metrics](#healing-metrics)
+  - [Golden-master boundary equivalence (modernize -> validate gate)](#golden-master-boundary-equivalence-modernize---validate-gate)
+- [Healing Signals](#healing-signals)
+- [Environment Variables](#environment-variables)
+- [Known Limitations](#known-limitations)
+- [Quick Reference](#quick-reference)
+- [Checkpoint metadata hardening (v7.5.8)](#checkpoint-metadata-hardening-v758)
+<!-- TOC:END -->
+
 ## Research Foundation
 
 This module synthesizes ideas from multiple validated sources. Each technique is cited.

package/skills/magic-modules.md

@@ -1,5 +1,29 @@
 # Magic Modules Skill
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Research Foundation](#research-foundation)
+- [When to Load This Module](#when-to-load-this-module)
+- [Core Concept](#core-concept)
+  - [1. Spec-First Generation (MagicModules -- Roman Nurik)](#1-spec-first-generation-magicmodules----roman-nurik)
+  - [2. Multi-Persona Debate (MoMoA -- Reto Meier)](#2-multi-persona-debate-momoa----reto-meier)
+- [Commands](#commands)
+- [Workflow Integration](#workflow-integration)
+  - [With RARV Cycle](#with-rarv-cycle)
+  - [With Documentation System (`loki docs`)](#with-documentation-system-loki-docs)
+  - [With Git Intelligence](#with-git-intelligence)
+  - [With Quality Gates](#with-quality-gates)
+- [File Layout](#file-layout)
+- [Design Tokens](#design-tokens)
+- [Generation Targets](#generation-targets)
+- [Debate Personas](#debate-personas)
+- [Anti-Patterns](#anti-patterns)
+- [Quick Reference](#quick-reference)
+- [Integration with Other Skills](#integration-with-other-skills)
+- [See Also](#see-also)
+<!-- TOC:END -->
+
 ## Research Foundation
 
 | Source | Key Contribution | Citation |

package/skills/memory.md

@@ -1,5 +1,25 @@
 # Memory Integration (v7.2.0+)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Flag hierarchy](#flag-hierarchy)
+- [Schema mapping](#schema-mapping)
+- [How RARV-C uses managed memory](#how-rarv-c-uses-managed-memory)
+  - [REASON phase (read augment)](#reason-phase-read-augment)
+  - [REFLECT/VERIFY phase (shadow-write)](#reflectverify-phase-shadow-write)
+  - [Completion council (augment + verdict)](#completion-council-augment--verdict)
+  - [Session-boot hydrate](#session-boot-hydrate)
+- [Multiagent council (research preview)](#multiagent-council-research-preview)
+- [Cross-session learning](#cross-session-learning)
+- [PII redaction](#pii-redaction)
+- [Observability](#observability)
+- [Honest disclosure: what is NOT tested](#honest-disclosure-what-is-not-tested)
+- [Rollback](#rollback)
+- [Troubleshooting](#troubleshooting)
+- [References](#references)
+<!-- TOC:END -->
+
 Loki Mode ships two memory layers:
 
 1. **Local memory** (`.loki/memory/`) -- project-scoped, authoritative, versioned

package/skills/model-selection.md

@@ -1,5 +1,39 @@
 # Model Selection & Task Tool
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Session-Pinned Model (default)](#session-pinned-model-default)
+- [Fable 5 (top-tier advisory model)](#fable-5-top-tier-advisory-model)
+  - [Mid-flight model switching](#mid-flight-model-switching)
+  - [Architecture-tier opt-in: `LOKI_FABLE_ARCHITECT`](#architecture-tier-opt-in-loki_fable_architect)
+  - [Financial / physical-stakes work (manual override, by design)](#financial--physical-stakes-work-manual-override-by-design)
+  - [Cost estimate honesty](#cost-estimate-honesty)
+- [Multi-Provider Support (v5.0.0)](#multi-provider-support-v500)
+- [Abstract Model Tiers](#abstract-model-tiers)
+  - [Enabling Haiku](#enabling-haiku)
+- [Model Selection by SDLC Phase](#model-selection-by-sdlc-phase)
+- [Task Tool Examples (Claude Only)](#task-tool-examples-claude-only)
+  - [Provider Detection in Code](#provider-detection-in-code)
+- [Task Categories](#task-categories)
+- [Parallelization Strategy (Claude Only)](#parallelization-strategy-claude-only)
+- [Extended Thinking Mode](#extended-thinking-mode)
+  - [Claude Adaptive Thinking (Effort Parameter)](#claude-adaptive-thinking-effort-parameter)
+  - [Codex --sandbox workspace-write Flag](#codex---sandbox-workspace-write-flag)
+- [Prompt Repetition for Haiku](#prompt-repetition-for-haiku)
+- [Advanced Parameters](#advanced-parameters)
+- [Confidence-Based Routing](#confidence-based-routing)
+- [Tiered Agent Escalation Triggers](#tiered-agent-escalation-triggers)
+  - [Tier Definitions](#tier-definitions)
+  - [Automatic Escalation Triggers](#automatic-escalation-triggers)
+  - [Threshold Rationale](#threshold-rationale)
+  - [Always-HIGH Triggers (No Escalation Path)](#always-high-triggers-no-escalation-path)
+  - [De-escalation Triggers (Cost Optimization)](#de-escalation-triggers-cost-optimization)
+  - [Escalation Flow Diagram](#escalation-flow-diagram)
+  - [Implementation in Provider Context](#implementation-in-provider-context)
+  - [Metrics for Tier Optimization](#metrics-for-tier-optimization)
+<!-- TOC:END -->
+
 ## Session-Pinned Model (default)
 
 Since v6.81.0, the main RARV loop uses **one pinned model per session** instead of rotating models per RARV phase. This eliminates per-iteration tier churn and keeps the main loop behavior predictable.

package/skills/openspec-integration.md

@@ -1,5 +1,21 @@
 # OpenSpec Integration
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [When This Module Applies](#when-this-module-applies)
+- [Delta-Aware Development Rules](#delta-aware-development-rules)
+  - [ADDED Requirements](#added-requirements)
+  - [MODIFIED Requirements](#modified-requirements)
+  - [REMOVED Requirements](#removed-requirements)
+- [Task Execution](#task-execution)
+- [Scenario Verification](#scenario-verification)
+- [Source Mapping](#source-mapping)
+- [Complexity Levels](#complexity-levels)
+- [Output Files Reference](#output-files-reference)
+- [Common Mistakes](#common-mistakes)
+<!-- TOC:END -->
+
 > **Reference:** OpenSpec delta specs use ADDED/MODIFIED/REMOVED sections to describe changes to existing system behavior. See `.loki/openspec/delta-context.json` for the parsed delta context injected into your prompt.
 
 ---

package/skills/parallel-workflows.md

@@ -1,5 +1,49 @@
 # Parallel Workflows with Git Worktrees
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Why Worktree-Based Parallelism](#why-worktree-based-parallelism)
+- [Parallel Work Streams](#parallel-work-streams)
+- [Worktree Management Commands](#worktree-management-commands)
+  - [Create Feature Worktree](#create-feature-worktree)
+  - [Create Testing Worktree (based on main)](#create-testing-worktree-based-on-main)
+  - [Merge Completed Work](#merge-completed-work)
+  - [List and Clean Worktrees](#list-and-clean-worktrees)
+- [Orchestrator Workflow](#orchestrator-workflow)
+- [Supervisor / Judge Pattern](#supervisor--judge-pattern)
+  - [When the supervisor runs](#when-the-supervisor-runs)
+  - [Inputs and outputs](#inputs-and-outputs)
+  - [Resource state as input](#resource-state-as-input)
+- [Dynamic Resource-Aware Session Concurrency](#dynamic-resource-aware-session-concurrency)
+  - [Env knobs (all read in `autonomy/run.sh`)](#env-knobs-all-read-in-autonomyrunsh)
+  - [Honest ceiling: dozens, not thousands](#honest-ceiling-dozens-not-thousands)
+- [Claude Session Per Worktree](#claude-session-per-worktree)
+- [Inter-Stream Communication](#inter-stream-communication)
+  - [Signal Files](#signal-files)
+  - [Workflow Triggers](#workflow-triggers)
+- [Parallel Testing Strategy](#parallel-testing-strategy)
+  - [Continuous Testing Worktree](#continuous-testing-worktree)
+  - [Parallel Test Execution](#parallel-test-execution)
+- [Documentation Stream](#documentation-stream)
+  - [Auto-Documentation Triggers](#auto-documentation-triggers)
+  - [Blog Stream (if site has blog)](#blog-stream-if-site-has-blog)
+- [Worktree State Tracking](#worktree-state-tracking)
+  - [Orchestrator State Schema](#orchestrator-state-schema)
+  - [Dashboard Integration](#dashboard-integration)
+- [Spawn Parallel Streams Script](#spawn-parallel-streams-script)
+- [Optimistic Concurrency Control](#optimistic-concurrency-control)
+  - [The Problem with Locks](#the-problem-with-locks)
+  - [Optimistic Concurrency Pattern](#optimistic-concurrency-pattern)
+  - [Implementation](#implementation)
+  - [When to Use](#when-to-use)
+- [Limitations and Considerations](#limitations-and-considerations)
+  - [When NOT to Use Worktrees](#when-not-to-use-worktrees)
+  - [Merge Conflict Resolution](#merge-conflict-resolution)
+  - [Resource Considerations](#resource-considerations)
+- [Integration with Existing Patterns](#integration-with-existing-patterns)
+<!-- TOC:END -->
+
 > **Research basis:** Claude Code git worktrees pattern, Anthropic "One Feature at a Time" harness, HN production patterns on context isolation.
 
 ---

package/skills/patterns-advanced.md

@@ -1,5 +1,16 @@
 # Advanced Patterns
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Problem Classification with Expert Hints (OptiMind Pattern)](#problem-classification-with-expert-hints-optimind-pattern)
+- [Ensemble Solution Generation (OptiMind Pattern)](#ensemble-solution-generation-optimind-pattern)
+- [Formal State Machines (k8s-valkey-operator Pattern)](#formal-state-machines-k8s-valkey-operator-pattern)
+- [Constitutional AI Self-Critique (Anthropic)](#constitutional-ai-self-critique-anthropic)
+- [Debate-Based Verification (DeepMind)](#debate-based-verification-deepmind)
+- [Code-Only Agent Pattern (rijnard.com)](#code-only-agent-pattern-rijnardcom)
+<!-- TOC:END -->
+
 ## Problem Classification with Expert Hints (OptiMind Pattern)
 
 **Classify problems before solving. Apply domain-specific expert hints.**

package/skills/production.md

@@ -1,5 +1,24 @@
 # Production Patterns
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [HN 2025 Production Patterns](#hn-2025-production-patterns)
+- [Proactive Context Management (OpenCode Pattern)](#proactive-context-management-opencode-pattern)
+- [Sub-Agents for Context Isolation](#sub-agents-for-context-isolation)
+- [Git Worktree Isolation (Cursor Pattern)](#git-worktree-isolation-cursor-pattern)
+- [Atomic Checkpoint/Rollback (Cursor Pattern)](#atomic-checkpointrollback-cursor-pattern)
+- [CI/CD Automation (Zencoder Patterns)](#cicd-automation-zencoder-patterns)
+  - [CI Failure Analysis and Auto-Resolution](#ci-failure-analysis-and-auto-resolution)
+  - [Automated Review Comment Resolution](#automated-review-comment-resolution)
+  - [Continuous Dependency Management](#continuous-dependency-management)
+- [Batch Processing (Claude API)](#batch-processing-claude-api)
+  - [When to Use Batch API](#when-to-use-batch-api)
+  - [Batch API Limits](#batch-api-limits)
+  - [Implementation Pattern](#implementation-pattern)
+  - [Batch + Prompt Caching](#batch--prompt-caching)
+<!-- TOC:END -->
+
 ## HN 2025 Production Patterns
 
 Narrow scope, deterministic outer loops and context engineering live in `references/production-patterns.md` (single source). The sections below cover deployment-side patterns.

package/skills/providers.md

@@ -1,5 +1,23 @@
 # Multi-Provider Support
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Provider Comparison](#provider-comparison)
+- [Provider Selection](#provider-selection)
+- [Any Model, Any Provider (ANTHROPIC_BASE_URL)](#any-model-any-provider-anthropic_base_url)
+  - [Keeping the model catalog current](#keeping-the-model-catalog-current)
+- [Claude Code (Default, Full Features)](#claude-code-default-full-features)
+- [OpenAI Codex CLI (Experimental, Degraded Mode)](#openai-codex-cli-experimental-degraded-mode)
+- [Cline CLI (Tier 2 - Near-Full, 12+ Providers)](#cline-cli-tier-2---near-full-12-providers)
+- [Aider (Tier 3 - Degraded, 18+ Providers)](#aider-tier-3---degraded-18-providers)
+- [opencode (Model-Agnostic, 75+ Providers)](#opencode-model-agnostic-75-providers)
+- [Degraded Mode Behavior](#degraded-mode-behavior)
+- [Provider Configuration Files](#provider-configuration-files)
+- [Choosing a Provider](#choosing-a-provider)
+- [Guardrail Parity (engine10)](#guardrail-parity-engine10)
+<!-- TOC:END -->
+
 Loki Mode supports five AI providers for autonomous execution.
 
 ## Provider Comparison