loki-mode 11.18.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.18.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.18.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.18.0
+11.20.0

package/dashboard/__init__.py

@@ -7,6 +7,6 @@ Modules:
     control: Session control helpers (status, atomic writes, origin check)
 """
 
-__version__ = "11.18.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.18.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.18.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.18.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=4D848EF2E7DD75F8F5F0665DF7717B6D
+//# debugId=1C6B0BF2D739E7FB0A438A0B127FC984

package/mcp/__init__.py

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

package/memory/embeddings.py

@@ -6,6 +6,7 @@ with support for multiple providers:
 - Local: sentence-transformers (default, no API key required)
 - OpenAI: text-embedding-3-small/large
 - Cohere: embed-english-v3.0
+- Voyage: voyage-code-4 (code retrieval; opt-in only via LOKI_EMBEDDING_PROVIDER=voyage)
 
 Features:
 - Provider fallback chain for resilience
@@ -60,6 +61,7 @@ class EmbeddingProvider(Enum):
     LOCAL = "local"
     OPENAI = "openai"
     COHERE = "cohere"
+    VOYAGE = "voyage"
 
 
 class ChunkingStrategy(Enum):
@@ -88,6 +90,7 @@ class EmbeddingConfig:
     # API keys (loaded from env if not provided)
     openai_api_key: Optional[str] = None
     cohere_api_key: Optional[str] = None
+    voyage_api_key: Optional[str] = None
 
     # Chunking settings
     chunking_strategy: str = "semantic"
@@ -126,6 +129,11 @@ class EmbeddingConfig:
         "multilingual": "embed-multilingual-v3.0",
     }
 
+    VOYAGE_MODELS = {
+        "default": "voyage-code-4",
+        "general": "voyage-4",
+    }
+
     # Model dimensions
     MODEL_DIMENSIONS = {
         "all-MiniLM-L6-v2": 384,
@@ -137,6 +145,10 @@ class EmbeddingConfig:
         "embed-english-v3.0": 1024,
         "embed-english-light-v3.0": 384,
         "embed-multilingual-v3.0": 1024,
+        "voyage-code-4": 1024,
+        "voyage-4": 1024,
+        "voyage-code-3": 1024,
+        "voyage-3": 1024,
     }
 
     def __post_init__(self):
@@ -145,6 +157,8 @@ class EmbeddingConfig:
             self.openai_api_key = os.environ.get("OPENAI_API_KEY")
         if self.cohere_api_key is None:
             self.cohere_api_key = os.environ.get("COHERE_API_KEY")
+        if self.voyage_api_key is None:
+            self.voyage_api_key = os.environ.get("VOYAGE_API_KEY")
 
         # Set default model based on provider
         if self.model is None:
@@ -154,6 +168,8 @@ class EmbeddingConfig:
                 self.model = self.OPENAI_MODELS["default"]
             elif self.provider == "cohere":
                 self.model = self.COHERE_MODELS["default"]
+            elif self.provider == "voyage":
+                self.model = self.VOYAGE_MODELS["default"]
 
         # Update dimension based on model
         if self.model in self.MODEL_DIMENSIONS:
@@ -167,6 +183,7 @@ class EmbeddingConfig:
             model=os.environ.get("LOKI_EMBEDDING_MODEL"),
             openai_api_key=os.environ.get("OPENAI_API_KEY"),
             cohere_api_key=os.environ.get("COHERE_API_KEY"),
+            voyage_api_key=os.environ.get("VOYAGE_API_KEY"),
             chunking_strategy=os.environ.get("LOKI_EMBEDDING_CHUNKING", "semantic"),
             include_context=os.environ.get("LOKI_EMBEDDING_CONTEXT", "true").lower() == "true",
         )
@@ -217,6 +234,7 @@ class EmbeddingConfig:
             "timeout": self.timeout,
             "has_openai_key": self.openai_api_key is not None,
             "has_cohere_key": self.cohere_api_key is not None,
+            "has_voyage_key": self.voyage_api_key is not None,
         }
 
 
@@ -770,6 +788,83 @@ class CohereEmbeddingProvider(BaseEmbeddingProvider):
         return self._cohere_available and self.api_key is not None
 
 
+class VoyageEmbeddingProvider(BaseEmbeddingProvider):
+    """Voyage AI embedding provider (voyage-code-4 for code retrieval).
+
+    Remote: sends text to a third party. Registered only when the user
+    names it via LOKI_EMBEDDING_PROVIDER=voyage; a VOYAGE_API_KEY alone
+    never selects it.
+    """
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        model: str = "voyage-code-4",
+        dimension: int = 1024,
+        timeout: float = 30.0
+    ):
+        self.api_key = api_key or os.environ.get("VOYAGE_API_KEY")
+        self.model = model
+        self.dimension = dimension
+        self.timeout = timeout
+        self._client: Optional[Any] = None
+        self._voyage_available = False
+
+        try:
+            import voyageai  # noqa: F401
+            self._voyage_available = True
+        except ImportError:
+            logger.warning("voyageai package not installed. Install with: pip install voyageai")
+
+    def _get_client(self) -> Any:
+        """Get or create Voyage client."""
+        if self._client is None:
+            import voyageai
+            self._client = voyageai.Client(
+                api_key=self.api_key,
+                timeout=self.timeout
+            )
+        return self._client
+
+    def embed(self, text: str) -> np.ndarray:
+        """Generate embedding for a single text."""
+        return self.embed_batch([text])[0]
+
+    def embed_batch(self, texts: List[str]) -> np.ndarray:
+        """Generate embeddings for multiple texts."""
+        if not texts:
+            return np.empty((0, self.dimension), dtype=np.float32)
+
+        if not self.is_available():
+            raise RuntimeError("Voyage provider not available")
+
+        client = self._get_client()
+
+        # Voyage accepts up to 128 inputs per request
+        embeddings = []
+        batch_size = 128
+
+        for i in range(0, len(texts), batch_size):
+            batch = texts[i:i + batch_size]
+            response = client.embed(
+                batch,
+                model=self.model,
+                input_type="document"
+            )
+            embeddings.extend(response.embeddings)
+
+        return np.array(embeddings, dtype=np.float32)
+
+    def get_dimension(self) -> int:
+        return self.dimension
+
+    def get_name(self) -> str:
+        return "voyage"
+
+    def is_available(self) -> bool:
+        return self._voyage_available and self.api_key is not None
+
+
 # -----------------------------------------------------------------------------
 # Main Embedding Engine
 # -----------------------------------------------------------------------------
@@ -873,6 +968,22 @@ class EmbeddingEngine:
                 timeout=self.config.timeout,
             )
 
+        # Voyage is opt-in only: registered when named as the provider or an
+        # explicit fallback, never from the presence of VOYAGE_API_KEY alone.
+        voyage_named = (
+            self.config.provider == "voyage"
+            or "voyage" in self.config.fallback_providers
+        )
+        if self.config.voyage_api_key and voyage_named:
+            voyage_model = self.config.model if self.config.provider == "voyage" else "voyage-code-4"
+            voyage_dim = self.config.MODEL_DIMENSIONS.get(voyage_model, 1024)
+            self._providers["voyage"] = VoyageEmbeddingProvider(
+                api_key=self.config.voyage_api_key,
+                model=voyage_model,
+                dimension=voyage_dim,
+                timeout=self.config.timeout,
+            )
+
         # Set primary provider
         if self.config.provider in self._providers:
             provider = self._providers[self.config.provider]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "loki-mode",
   "mcpName": "io.github.asklokesh/loki-mode",
-  "version": "11.18.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": "96bf456ce704b32f454588206efa07da8f46ebf8"
+  "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.18.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.