loki-mode 6.76.1 → 6.77.1

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes PRD to deployed product with minimal human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v6.76.1
+# Loki Mode v6.77.1
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -272,4 +272,4 @@ The following features are documented in skill modules but not yet fully automat
 | Quality gates 3-reviewer system | Implemented (v5.35.0) | 5 specialist reviewers in `skills/quality-gates.md`; execution in run.sh |
 | Benchmarks (HumanEval, SWE-bench) | Infrastructure only | Runner scripts and datasets exist in `benchmarks/`; no published results |
 
-**v6.76.1 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v6.77.1 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-6.76.1
+6.77.1

package/autonomy/openspec-adapter.py

@@ -345,9 +345,16 @@ def _parse_scenario(name: str, body: str) -> Dict[str, Any]:
 
 # -- Tasks Parsing ------------------------------------------------------------
 
-def parse_tasks(tasks_path: Path) -> Tuple[List[Dict[str, Any]], Dict[str, Dict[str, Any]]]:
+def parse_tasks(tasks_path: Path, change_name: str = "") -> Tuple[List[Dict[str, Any]], Dict[str, Dict[str, Any]]]:
     """Parse tasks.md into structured task list and source map.
 
+    Args:
+        tasks_path: path to the change's tasks.md
+        change_name: OpenSpec change name, used to scope task IDs so that IDs
+            from different changes cannot collide in the pending queue. Default
+            empty string preserves backward compatibility with any caller that
+            does not pass the argument.
+
     Returns:
         (tasks_list, source_map)
         tasks_list: list of task objects
@@ -373,7 +380,9 @@ def parse_tasks(tasks_path: Path) -> Tuple[List[Dict[str, Any]], Dict[str, Dict[
             checked = task_match.group(1).lower() == "x"
             task_id_num = task_match.group(2)
             description = task_match.group(3).strip()
-            task_id = f"openspec-{task_id_num}"
+            task_id = (
+                f"openspec-{change_name}-{task_id_num}" if change_name else f"openspec-{task_id_num}"
+            )
 
             task = {
                 "id": task_id,
@@ -696,7 +705,7 @@ def run(
     source_map: Dict[str, Dict[str, Any]] = {}
     tasks_path = change_dir / "tasks.md"
     if tasks_path.exists():
-        tasks_list, source_map = parse_tasks(tasks_path)
+        tasks_list, source_map = parse_tasks(tasks_path, change_name=change_name)
 
     # -- Parse design.md (optional) --
     design_data: Optional[Dict[str, str]] = None

package/autonomy/run.sh

@@ -1453,7 +1453,7 @@ get_provider_tier_param() {
             echo "${CLINE_DEFAULT_MODEL:-${LOKI_CLINE_MODEL:-default}}"
             ;;
         aider)
-            echo "${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-sonnet-4-5-20250929}}"
+            echo "${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-opus-4-7}}"
             ;;
         *)
             echo "development"
@@ -3143,7 +3143,7 @@ invoke_cline_capture() {
 invoke_aider() {
     local prompt="$1"
     shift
-    local model="${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-sonnet-4-5-20250929}}"
+    local model="${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-opus-4-7}}"
     local extra_flags="${LOKI_AIDER_FLAGS:-}"
     # shellcheck disable=SC2086
     # < /dev/null prevents aider from blocking on stdin in non-interactive mode
@@ -3156,7 +3156,7 @@ invoke_aider() {
 invoke_aider_capture() {
     local prompt="$1"
     shift
-    local model="${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-sonnet-4-5-20250929}}"
+    local model="${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-opus-4-7}}"
     local extra_flags="${LOKI_AIDER_FLAGS:-}"
     # shellcheck disable=SC2086
     aider --message "$prompt" --yes-always --no-auto-commits \
@@ -3594,9 +3594,13 @@ except: pass
     local prd_escaped
     prd_escaped=$(printf '%s' "${prd:-Codebase Analysis}" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g')
 
-    # Build enriched task JSON with pending task context
-    local task_json
-    if [[ -n "$next_task_context" ]]; then
+    # Build enriched task JSON with pending task context.
+    # Must initialize to empty: this script runs under `set -u` (line 152),
+    # so `local task_json` without a value leaves it unset. When the pending
+    # queue is empty, the enrichment `if` is skipped and the `-z` check below
+    # would fire on an unset variable and kill the run.
+    local task_json=""
+    if [[ -n "${next_task_context:-}" ]]; then
         task_json=$(python3 -c "
 import json, sys
 ctx = json.loads('''$next_task_context''')
@@ -3619,11 +3623,11 @@ if ctx.get('source'):
 if ctx.get('project'):
     task['project'] = ctx['project']
 print(json.dumps(task, indent=2))
-" 2>/dev/null)
+" 2>/dev/null) || task_json=""
     fi
 
     # Fallback to basic task JSON if enrichment failed
-    if [[ -z "$task_json" ]]; then
+    if [[ -z "${task_json:-}" ]]; then
         task_json=$(cat <<EOF
 {
   "id": "$task_id",
@@ -3749,7 +3753,7 @@ track_iteration_complete() {
     elif [ "${PROVIDER_NAME:-claude}" = "cline" ]; then
         model_tier="${CLINE_DEFAULT_MODEL:-${LOKI_CLINE_MODEL:-sonnet}}"
     elif [ "${PROVIDER_NAME:-claude}" = "aider" ]; then
-        model_tier="${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-sonnet-4-5-20250929}}"
+        model_tier="${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-opus-4-7}}"
     fi
     local phase="${LAST_KNOWN_PHASE:-}"
     [ -z "$phase" ] && phase=$(python3 -c "import json; print(json.load(open('.loki/state/orchestrator.json')).get('currentPhase', 'unknown'))" 2>/dev/null || echo "unknown")
@@ -8901,18 +8905,68 @@ bmad_write_back() {
 # OpenSpec Task Queue Population
 #===============================================================================
 
-# Populate the task queue from OpenSpec task artifacts
-# Only runs once -- skips if queue was already populated from OpenSpec
+# Compute a content hash for a file (cross-platform: uses Python hashlib so
+# behavior is identical on macOS and Linux, no md5/md5sum fork).
+_openspec_content_hash() {
+    local file="$1"
+    [[ -f "$file" ]] || { echo "none"; return 0; }
+    python3 -c "import hashlib,sys; print(hashlib.md5(open(sys.argv[1],'rb').read()).hexdigest())" "$file" 2>/dev/null || echo "none"
+}
+
+# Remove all tasks with source=="openspec" from a queue JSON file, preserving
+# every other source (prd, bmad, mirofish). Atomic: writes tmp + renames.
+purge_openspec_from_queue() {
+    local queue_file="$1"
+    [[ -f "$queue_file" ]] || return 0
+    local tmp="${queue_file}.tmp.$$"
+    if jq '[.[] | select(.source != "openspec")]' "$queue_file" > "$tmp" 2>/dev/null; then
+        local before after
+        before=$(jq 'length' "$queue_file" 2>/dev/null || echo 0)
+        after=$(jq 'length' "$tmp" 2>/dev/null || echo 0)
+        mv "$tmp" "$queue_file"
+        if [[ "$before" != "$after" ]]; then
+            log_info "Purged $((before - after)) OpenSpec tasks from $(basename "$queue_file")"
+        fi
+    else
+        rm -f "$tmp"
+        log_warn "Could not purge OpenSpec tasks from $(basename "$queue_file") (jq failed)"
+        return 1
+    fi
+}
+
+# Populate the task queue from OpenSpec task artifacts.
+# The sentinel .loki/queue/.openspec-populated is scoped per change:
+#   line 1 = change path, line 2 = content hash of openspec-tasks.json.
+# Same path + same hash -> skip (crash-restart preserves progress).
+# Different path -> change switched, purge stale tasks and repopulate.
+# Same path + different hash -> tasks.md edited, purge and repopulate.
 populate_openspec_queue() {
     # Skip if no OpenSpec tasks file
     if [[ ! -f ".loki/openspec-tasks.json" ]]; then
         return 0
     fi
 
-    # Skip if already populated (marker file)
-    if [[ -f ".loki/queue/.openspec-populated" ]]; then
-        log_info "OpenSpec queue already populated, skipping"
-        return 0
+    local sentinel=".loki/queue/.openspec-populated"
+    local current_path="${OPENSPEC_CHANGE_PATH:-}"
+    local current_hash
+    current_hash="$(_openspec_content_hash ".loki/openspec-tasks.json")"
+
+    if [[ -f "$sentinel" ]]; then
+        local stored_path stored_hash
+        stored_path="$(sed -n '1p' "$sentinel")"
+        stored_hash="$(sed -n '2p' "$sentinel")"
+        if [[ "$stored_path" == "$current_path" ]] && [[ "$stored_hash" == "$current_hash" ]]; then
+            log_info "OpenSpec queue already populated for this change (path + hash match), skipping"
+            return 0
+        fi
+        if [[ "$stored_path" != "$current_path" ]]; then
+            log_info "OpenSpec change switched (was: ${stored_path:-<legacy>}, now: ${current_path:-<unset>}) -- purging stale OpenSpec tasks"
+        else
+            log_info "OpenSpec tasks.md content changed (hash mismatch) -- purging and reloading"
+        fi
+        purge_openspec_from_queue ".loki/queue/pending.json"
+        purge_openspec_from_queue ".loki/queue/in-progress.json"
+        purge_openspec_from_queue ".loki/queue/completed.json"
     fi
 
     log_step "Populating task queue from OpenSpec tasks..."
@@ -8985,8 +9039,9 @@ OPENSPEC_QUEUE_EOF
         return 0
     fi
 
-    # Mark as populated so we don't re-add on restart
-    touch ".loki/queue/.openspec-populated"
+    # Mark as populated for this specific change + content hash so we don't
+    # re-add on restart but DO repopulate when change-switching or tasks.md edits.
+    printf '%s\n%s\n' "${OPENSPEC_CHANGE_PATH:-}" "$current_hash" > ".loki/queue/.openspec-populated"
     log_info "OpenSpec queue population complete"
 }
 
@@ -9836,7 +9891,13 @@ def process_stream():
                         elif tool == "Bash":
                             tool_desc = tool_input.get("description", tool_input.get("command", "")[:60])
                         elif tool == "Grep":
-                            tool_desc = f"pattern: {tool_input.get('pattern', '')}"
+                            # This Python block runs inside bash `python3 -u -c '...'`,
+                            # wrapped in a bash single-quoted string. A single-quoted
+                            # Python literal here would close bash SQ mid-code and
+                            # Python would receive a bare identifier instead of the
+                            # "pattern" string, crashing with NameError on every Grep
+                            # tool call. Use double quotes + concatenation only.
+                            tool_desc = "pattern: " + tool_input.get("pattern", "")
                         elif tool == "Glob":
                             tool_desc = tool_input.get("pattern", "")
 
@@ -9991,8 +10052,8 @@ if __name__ == "__main__":
                 ;;
             aider)
                 # Aider: Tier 3 - degraded mode, 18+ providers
-                echo "[loki] Aider model: ${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-sonnet-4-5-20250929}}, tier: $tier_param" >> "$log_file"
-                echo "[loki] Aider model: ${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-sonnet-4-5-20250929}}, tier: $tier_param" >> "$agent_log"
+                echo "[loki] Aider model: ${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-opus-4-7}}, tier: $tier_param" >> "$log_file"
+                echo "[loki] Aider model: ${AIDER_DEFAULT_MODEL:-${LOKI_AIDER_MODEL:-claude-opus-4-7}}, tier: $tier_param" >> "$agent_log"
                 { invoke_aider "$prompt" 2>&1 | tee -a "$log_file" "$agent_log" "$iter_output"; \
                 } && exit_code=0 || exit_code=$?
                 ;;

package/dashboard/__init__.py

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

package/dashboard/static/index.html

@@ -11085,7 +11085,7 @@ var LokiDashboard=(()=>{var kt=Object.defineProperty;var Yt=Object.getOwnPropert
           ${s}
         </div>
       </div>
-    `,this._bindEvents(),!this._paused){let r=t.querySelector(".activity-feed");r&&(r.scrollTop=0)}}};customElements.get("loki-activity-stream")||customElements.define("loki-activity-stream",ht);var $e={claude:{initial:"C",color:"#553DE9",bgColor:"rgba(85, 61, 233, 0.12)"},codex:{initial:"X",color:"#1FC5A8",bgColor:"rgba(31, 197, 168, 0.12)"},gemini:{initial:"G",color:"#2F71E3",bgColor:"rgba(47, 113, 227, 0.12)"},cline:{initial:"L",color:"#D4A03C",bgColor:"rgba(212, 160, 60, 0.12)"},aider:{initial:"A",color:"#C45B5B",bgColor:"rgba(196, 91, 91, 0.12)"}},Vt={healthy:"var(--loki-green, #1FC5A8)",degraded:"var(--loki-yellow, #D4A03C)",down:"var(--loki-red, #C45B5B)",unknown:"var(--loki-text-muted, #939084)"},ut=class extends u{static get observedAttributes(){return["api-url","theme"]}constructor(){super(),this._providers=[],this._expandedProvider=null,this._api=null,this._pollInterval=null}connectedCallback(){super.connectedCallback(),this._setupApi(),this._loadData(),this._startPolling()}disconnectedCallback(){super.disconnectedCallback(),this._stopPolling()}attributeChangedCallback(t,e,i){e!==i&&(t==="api-url"&&this._api&&(this._api.baseUrl=i,this._loadData()),t==="theme"&&this._applyTheme())}_setupApi(){let t=this.getAttribute("api-url")||window.location.origin;this._api=g({baseUrl:t})}_startPolling(){this._pollInterval=setInterval(()=>this._loadData(),1e4)}_stopPolling(){this._pollInterval&&(clearInterval(this._pollInterval),this._pollInterval=null)}async _loadData(){try{let t=await this._api._get("/api/v2/providers/health");this._providers=t.providers||[]}catch{this._providers.length===0&&(this._providers=this._getDemoData())}this.render()}_getDemoData(){return[{name:"claude",status:"healthy",latency_ms:245,tokens_used:125400,model:"claude-opus-4-6",api_version:"v1",rate_limit:{remaining:45,limit:50},cost_usd:3.42},{name:"codex",status:"degraded",latency_ms:890,tokens_used:45200,model:"gpt-5.3-codex",api_version:"v1",rate_limit:{remaining:12,limit:60},cost_usd:.87},{name:"gemini",status:"healthy",latency_ms:320,tokens_used:78600,model:"gemini-3-pro",api_version:"v1beta",rate_limit:{remaining:55,limit:60},cost_usd:1.15}]}_formatTokens(t){return t==null?"--":t>=1e6?(t/1e6).toFixed(1)+"M":t>=1e3?(t/1e3).toFixed(1)+"K":String(t)}_formatLatency(t){return t==null?"--":t<1e3?t+"ms":(t/1e3).toFixed(1)+"s"}_formatCost(t){return t==null?"--":"$"+t.toFixed(2)}_escapeHtml(t){return t?String(t).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;"):""}_toggleExpand(t){this._expandedProvider=this._expandedProvider===t?null:t,this.render()}_bindEvents(){this.shadowRoot.querySelectorAll(".provider-card").forEach(e=>{e.addEventListener("click",()=>{this._toggleExpand(e.dataset.provider)})})}_getStyles(){return`
+    `,this._bindEvents(),!this._paused){let r=t.querySelector(".activity-feed");r&&(r.scrollTop=0)}}};customElements.get("loki-activity-stream")||customElements.define("loki-activity-stream",ht);var $e={claude:{initial:"C",color:"#553DE9",bgColor:"rgba(85, 61, 233, 0.12)"},codex:{initial:"X",color:"#1FC5A8",bgColor:"rgba(31, 197, 168, 0.12)"},gemini:{initial:"G",color:"#2F71E3",bgColor:"rgba(47, 113, 227, 0.12)"},cline:{initial:"L",color:"#D4A03C",bgColor:"rgba(212, 160, 60, 0.12)"},aider:{initial:"A",color:"#C45B5B",bgColor:"rgba(196, 91, 91, 0.12)"}},Vt={healthy:"var(--loki-green, #1FC5A8)",degraded:"var(--loki-yellow, #D4A03C)",down:"var(--loki-red, #C45B5B)",unknown:"var(--loki-text-muted, #939084)"},ut=class extends u{static get observedAttributes(){return["api-url","theme"]}constructor(){super(),this._providers=[],this._expandedProvider=null,this._api=null,this._pollInterval=null}connectedCallback(){super.connectedCallback(),this._setupApi(),this._loadData(),this._startPolling()}disconnectedCallback(){super.disconnectedCallback(),this._stopPolling()}attributeChangedCallback(t,e,i){e!==i&&(t==="api-url"&&this._api&&(this._api.baseUrl=i,this._loadData()),t==="theme"&&this._applyTheme())}_setupApi(){let t=this.getAttribute("api-url")||window.location.origin;this._api=g({baseUrl:t})}_startPolling(){this._pollInterval=setInterval(()=>this._loadData(),1e4)}_stopPolling(){this._pollInterval&&(clearInterval(this._pollInterval),this._pollInterval=null)}async _loadData(){try{let t=await this._api._get("/api/v2/providers/health");this._providers=t.providers||[]}catch{this._providers.length===0&&(this._providers=this._getDemoData())}this.render()}_getDemoData(){return[{name:"claude",status:"healthy",latency_ms:245,tokens_used:125400,model:"claude-opus-4-7",api_version:"v1",rate_limit:{remaining:45,limit:50},cost_usd:3.42},{name:"codex",status:"degraded",latency_ms:890,tokens_used:45200,model:"gpt-5.3-codex",api_version:"v1",rate_limit:{remaining:12,limit:60},cost_usd:.87},{name:"gemini",status:"healthy",latency_ms:320,tokens_used:78600,model:"gemini-3-pro",api_version:"v1beta",rate_limit:{remaining:55,limit:60},cost_usd:1.15}]}_formatTokens(t){return t==null?"--":t>=1e6?(t/1e6).toFixed(1)+"M":t>=1e3?(t/1e3).toFixed(1)+"K":String(t)}_formatLatency(t){return t==null?"--":t<1e3?t+"ms":(t/1e3).toFixed(1)+"s"}_formatCost(t){return t==null?"--":"$"+t.toFixed(2)}_escapeHtml(t){return t?String(t).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;"):""}_toggleExpand(t){this._expandedProvider=this._expandedProvider===t?null:t,this.render()}_bindEvents(){this.shadowRoot.querySelectorAll(".provider-card").forEach(e=>{e.addEventListener("click",()=>{this._toggleExpand(e.dataset.provider)})})}_getStyles(){return`
       :host {
         display: block;
       }

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:** v6.76.1
+**Version:** v6.77.1
 
 ---
 

package/mcp/__init__.py

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "6.76.1",
+  "version": "6.77.1",
   "description": "Loki Mode by Autonomi - Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "agent",

package/providers/aider.sh

@@ -50,7 +50,20 @@ PROVIDER_MAX_PARALLEL=1
 # Aider supports 18+ providers; model configured via LOKI_AIDER_MODEL env var
 # or provider-specific env vars (OPENAI_API_KEY, OPENAI_API_BASE, etc.)
 # NOTE: Aider uses litellm for model routing, so full model strings are needed (not CLI aliases)
-AIDER_DEFAULT_MODEL="${LOKI_AIDER_MODEL:-${LOKI_MODEL_DEVELOPMENT:-claude-sonnet-4-5-20250929}}"
+# Aider default model -- reads from providers/model_catalog.json via models.sh when
+# available so new model releases only require updating that single catalog file.
+_aider_default_from_catalog() {
+    local script_dir
+    script_dir="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+    if [ -f "${script_dir}/models.sh" ]; then
+        # shellcheck source=./models.sh
+        source "${script_dir}/models.sh"
+        loki_latest_model aider development 2>/dev/null || echo "claude-opus-4-7"
+    else
+        echo "claude-opus-4-7"
+    fi
+}
+AIDER_DEFAULT_MODEL="${LOKI_AIDER_MODEL:-${LOKI_MODEL_DEVELOPMENT:-$(_aider_default_from_catalog)}}"
 PROVIDER_MODEL_PLANNING="$AIDER_DEFAULT_MODEL"
 PROVIDER_MODEL_DEVELOPMENT="$AIDER_DEFAULT_MODEL"
 PROVIDER_MODEL_FAST="$AIDER_DEFAULT_MODEL"

package/providers/claude.sh

@@ -45,7 +45,13 @@ PROVIDER_MAX_PARALLEL=10
 
 # Model Configuration (Abstract Tiers)
 # Default: Haiku disabled for quality. Use --allow-haiku or LOKI_ALLOW_HAIKU=true to enable.
-# Claude Code CLI resolves aliases (opus/sonnet/haiku) to latest versions automatically.
+# The Claude Code CLI resolves aliases (opus/sonnet/haiku) to the latest available
+# model at invocation time, so we pass aliases rather than dated IDs. The canonical
+# mapping lives in providers/model_catalog.json (single source of truth):
+#   opus   -> latest Opus   (e.g. claude-opus-4-7 -- 1M context, adaptive thinking)
+#   sonnet -> latest Sonnet (e.g. claude-sonnet-4-6)
+#   haiku  -> latest Haiku  (e.g. claude-haiku-4-5)
+# Override per tier with LOKI_CLAUDE_MODEL_PLANNING, _DEVELOPMENT, _FAST.
 CLAUDE_DEFAULT_PLANNING="opus"
 CLAUDE_DEFAULT_DEVELOPMENT="opus"  # Opus for dev (was sonnet)
 CLAUDE_DEFAULT_FAST="sonnet"
@@ -69,10 +75,18 @@ else
 fi
 
 # Context and Limits
-PROVIDER_CONTEXT_WINDOW=200000  # 200K default; 1M available in extended context beta
+# Opus 4.7 ships with 1M context at standard pricing (no long-context premium).
+# RARV-C uses this headroom for deeper memory retrieval and longer task budgets.
+PROVIDER_CONTEXT_WINDOW=1000000
 PROVIDER_MAX_OUTPUT_TOKENS=128000
 PROVIDER_RATE_LIMIT_RPM=50
 
+# Effort / thinking defaults for Opus 4.7 (used when Loki invokes the API
+# directly; the interactive CLI manages this automatically).
+PROVIDER_DEFAULT_EFFORT="${LOKI_CLAUDE_EFFORT:-xhigh}"     # xhigh recommended for coding
+PROVIDER_DEFAULT_THINKING="${LOKI_CLAUDE_THINKING:-adaptive}"
+PROVIDER_DEFAULT_TASK_BUDGET_TOKENS="${LOKI_CLAUDE_TASK_BUDGET:-0}"  # 0 = unset (open-ended)
+
 # Cost (USD per 1K tokens, approximate)
 PROVIDER_COST_INPUT_PLANNING=0.015
 PROVIDER_COST_OUTPUT_PLANNING=0.075

package/providers/cline.sh

@@ -51,7 +51,20 @@ PROVIDER_MAX_PARALLEL=1
 # Cline supports 12+ providers; model configured via LOKI_CLINE_MODEL env var
 # or `cline auth` one-time setup. Defaults are placeholders.
 # NOTE: Cline uses its own model routing, so full model strings are needed (not CLI aliases)
-CLINE_DEFAULT_MODEL="${LOKI_CLINE_MODEL:-${LOKI_MODEL_DEVELOPMENT:-claude-sonnet-4-5-20250929}}"
+# Cline default model -- reads from providers/model_catalog.json via models.sh when
+# available so new model releases only require updating that single catalog file.
+_cline_default_from_catalog() {
+    local script_dir
+    script_dir="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+    if [ -f "${script_dir}/models.sh" ]; then
+        # shellcheck source=./models.sh
+        source "${script_dir}/models.sh"
+        loki_latest_model cline development 2>/dev/null || echo "claude-opus-4-7"
+    else
+        echo "claude-opus-4-7"
+    fi
+}
+CLINE_DEFAULT_MODEL="${LOKI_CLINE_MODEL:-${LOKI_MODEL_DEVELOPMENT:-$(_cline_default_from_catalog)}}"
 PROVIDER_MODEL_PLANNING="$CLINE_DEFAULT_MODEL"
 PROVIDER_MODEL_DEVELOPMENT="$CLINE_DEFAULT_MODEL"
 PROVIDER_MODEL_FAST="$CLINE_DEFAULT_MODEL"

package/providers/model_catalog.json

@@ -0,0 +1,82 @@
+{
+  "_comment": "Canonical model catalog. Update this single file when a provider ships a new model. Providers/web-app/docs read from here.",
+  "schema_version": 1,
+  "updated": "2026-04-18",
+  "providers": {
+    "claude": {
+      "latest_planning": "claude-opus-4-7",
+      "latest_development": "claude-opus-4-7",
+      "latest_fast": "claude-sonnet-4-6",
+      "cli_aliases": {
+        "opus": "claude-opus-4-7",
+        "sonnet": "claude-sonnet-4-6",
+        "haiku": "claude-haiku-4-5"
+      },
+      "models": [
+        {
+          "id": "claude-opus-4-7",
+          "alias": "opus",
+          "tier": "planning",
+          "context_window": 1000000,
+          "max_output": 128000,
+          "notes": "Adaptive thinking, xhigh effort for agentic coding"
+        },
+        {
+          "id": "claude-sonnet-4-6",
+          "alias": "sonnet",
+          "tier": "development",
+          "context_window": 1000000,
+          "max_output": 64000
+        },
+        {
+          "id": "claude-haiku-4-5",
+          "alias": "haiku",
+          "tier": "fast",
+          "context_window": 200000,
+          "max_output": 64000
+        }
+      ]
+    },
+    "codex": {
+      "latest_planning": "gpt-5.3-codex",
+      "latest_development": "gpt-5.3-codex",
+      "latest_fast": "gpt-5.3-codex",
+      "models": [
+        { "id": "gpt-5.3-codex", "tier": "planning" },
+        { "id": "o3", "tier": "planning" },
+        { "id": "o4-mini", "tier": "fast" }
+      ],
+      "notes": "Codex uses a single model with effort level (xhigh/high/low) for tier differentiation"
+    },
+    "gemini": {
+      "latest_planning": "gemini-3-pro-preview",
+      "latest_development": "gemini-3-pro-preview",
+      "latest_fast": "gemini-3-flash-preview",
+      "models": [
+        { "id": "gemini-3-pro-preview", "tier": "planning", "context_window": 1000000 },
+        { "id": "gemini-3-flash-preview", "tier": "fast", "context_window": 1000000 }
+      ]
+    },
+    "cline": {
+      "latest_planning": "claude-opus-4-7",
+      "latest_development": "claude-opus-4-7",
+      "latest_fast": "claude-sonnet-4-6",
+      "models": [
+        { "id": "claude-opus-4-7", "tier": "planning" },
+        { "id": "claude-sonnet-4-6", "tier": "development" },
+        { "id": "gpt-4.1", "tier": "development" }
+      ]
+    },
+    "aider": {
+      "latest_planning": "claude-opus-4-7",
+      "latest_development": "claude-opus-4-7",
+      "latest_fast": "claude-sonnet-4-6",
+      "models": [
+        { "id": "claude-opus-4-7", "tier": "planning" },
+        { "id": "claude-sonnet-4-6", "tier": "development" },
+        { "id": "gpt-4.1", "tier": "development" },
+        { "id": "ollama_chat/deepseek-coder", "tier": "fast" }
+      ]
+    }
+  }
+}

package/providers/models.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# Dynamic model-catalog loader for Loki Mode providers.
+#
+# Instead of hardcoding dated model IDs (e.g. claude-sonnet-4-5-20250929)
+# throughout the codebase, every provider and caller reads from the single
+# source of truth at providers/model_catalog.json. When a new model ships,
+# update that one JSON file and every provider picks it up.
+#
+# Usage:
+#   source providers/models.sh
+#   model=$(loki_latest_model claude planning)   # -> claude-opus-4-7
+#   model=$(loki_latest_model gemini fast)       # -> gemini-3-flash-preview
+#
+# Env override order: LOKI_<PROVIDER>_MODEL_<TIER> > LOKI_<PROVIDER>_MODEL > catalog latest.
+
+# Resolve catalog path relative to this script, regardless of CWD.
+_LOKI_MODELS_SH_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+LOKI_MODEL_CATALOG="${LOKI_MODEL_CATALOG:-$_LOKI_MODELS_SH_DIR/model_catalog.json}"
+
+# Return the "latest_<tier>" id for a provider from the catalog.
+# Args: $1 provider (claude|codex|gemini|cline|aider)
+#       $2 tier     (planning|development|fast)
+loki_latest_model() {
+    local provider="${1:-claude}"
+    local tier="${2:-planning}"
+    local tier_upper
+    tier_upper=$(printf '%s' "$tier" | tr '[:lower:]' '[:upper:]')
+    local provider_upper
+    provider_upper=$(printf '%s' "$provider" | tr '[:lower:]' '[:upper:]')
+
+    # Env override chain
+    local override="LOKI_${provider_upper}_MODEL_${tier_upper}"
+    if [ -n "${!override:-}" ]; then
+        printf '%s' "${!override}"
+        return 0
+    fi
+    local generic_override="LOKI_${provider_upper}_MODEL"
+    if [ -n "${!generic_override:-}" ]; then
+        printf '%s' "${!generic_override}"
+        return 0
+    fi
+
+    if [ ! -f "$LOKI_MODEL_CATALOG" ]; then
+        return 1
+    fi
+    # Require python3 (all Loki runtimes ship with it).
+    python3 - "$LOKI_MODEL_CATALOG" "$provider" "$tier" <<'PY'
+import json, sys
+catalog_path, provider, tier = sys.argv[1], sys.argv[2], sys.argv[3]
+with open(catalog_path) as fh:
+    data = json.load(fh)
+p = data.get("providers", {}).get(provider)
+if not p:
+    sys.exit(1)
+model = p.get(f"latest_{tier}")
+if not model:
+    sys.exit(1)
+print(model)
+PY
+}
+
+# Print full catalog for a provider as lines: <id>\t<tier>\t<alias?>
+# Useful for `loki provider models <name>` output.
+loki_list_models() {
+    local provider="${1:-claude}"
+    if [ ! -f "$LOKI_MODEL_CATALOG" ]; then
+        return 1
+    fi
+    python3 - "$LOKI_MODEL_CATALOG" "$provider" <<'PY'
+import json, sys
+catalog_path, provider = sys.argv[1], sys.argv[2]
+with open(catalog_path) as fh:
+    data = json.load(fh)
+p = data.get("providers", {}).get(provider, {})
+for m in p.get("models", []):
+    alias = m.get("alias", "")
+    print(f"{m.get('id','')}\t{m.get('tier','')}\t{alias}")
+PY
+}

package/references/multi-provider.md

@@ -57,15 +57,15 @@ PROVIDER_MAX_PARALLEL=10       # Maximum concurrent agents
 
 #### Model Configuration
 ```bash
-PROVIDER_MODEL_PLANNING="claude-opus-4-6-20260201"
-PROVIDER_MODEL_DEVELOPMENT="claude-sonnet-4-5-20250929"
+PROVIDER_MODEL_PLANNING="claude-opus-4-7"
+PROVIDER_MODEL_DEVELOPMENT="claude-sonnet-4-6"
 PROVIDER_MODEL_FAST="claude-haiku-4-5-20251001"
 ```
 
 #### Rate Limiting
 ```bash
-PROVIDER_RATE_LIMIT_RPM=50     # Requests per minute
-PROVIDER_CONTEXT_WINDOW=200000 # Max context tokens
+PROVIDER_RATE_LIMIT_RPM=50      # Requests per minute
+PROVIDER_CONTEXT_WINDOW=1000000 # Max context tokens (Opus 4.7: 1M at standard pricing)
 PROVIDER_MAX_OUTPUT_TOKENS=128000
 ```
 

package/skills/production.md

@@ -226,7 +226,7 @@ def batch_code_review(files: list[str]) -> str:
         Request(
             custom_id=f"review-{i}-{file.replace('/', '-')}",
             params=MessageCreateParamsNonStreaming(
-                model="claude-sonnet-4-5",
+                model="claude-sonnet-4-6",
                 max_tokens=2048,
                 messages=[{
                     "role": "user",
@@ -275,7 +275,7 @@ requests = [
     Request(
         custom_id=f"review-{file}",
         params=MessageCreateParamsNonStreaming(
-            model="claude-sonnet-4-5",
+            model="claude-sonnet-4-6",
             max_tokens=2048,
             system=SHARED_SYSTEM,  # Identical across all requests
             messages=[{"role": "user", "content": f"Review: {code}"}]