loki-mode 6.4.0 → 6.6.0

package/events/emit.sh

@@ -43,7 +43,7 @@ fi
 
 # JSON escape helper: handles \, ", and control characters
 json_escape() {
-    printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g; s/\r/\\r/g' | tr -d '\n'
+    printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g; s/\r/\\r/g' | awk '{if(NR>1) printf "\\n"; printf "%s", $0}'
 }
 
 # Build payload JSON

package/mcp/__init__.py

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

package/mcp/server.py

@@ -20,6 +20,7 @@ import os
 import json
 import logging
 import threading
+import uuid
 from datetime import datetime, timezone
 from typing import Optional, List, Dict, Any
 
@@ -563,11 +564,11 @@ async def loki_memory_store_pattern(
         from memory.schemas import SemanticPattern
 
         base_path = safe_path_join('.loki', 'memory')
-        engine = MemoryEngine(base_path)
+        engine = MemoryEngine(base_path=base_path)
         engine.initialize()
 
         pattern_obj = SemanticPattern(
-            id=f"pattern-{datetime.now(timezone.utc).strftime('%Y%m%d%H%M%S')}",
+            id=f"pattern-{datetime.now(timezone.utc).strftime('%Y%m%d%H%M%S')}-{uuid.uuid4().hex[:8]}",
             pattern=pattern,
             category=category,
             conditions=[],
@@ -821,7 +822,7 @@ async def loki_state_get() -> str:
         try:
             from memory.engine import MemoryEngine
             memory_path = safe_path_join('.loki', 'memory')
-            engine = MemoryEngine(memory_path)
+            engine = MemoryEngine(base_path=memory_path)
             state["memory_stats"] = engine.get_stats()
         except Exception:
             state["memory_stats"] = None
@@ -1004,9 +1005,13 @@ async def loki_start_project(prd_content: str = "", prd_path: str = "") -> str:
     try:
         content = prd_content
         if not content and prd_path:
-            resolved = safe_path_join('.', prd_path)
-            if os.path.exists(resolved):
-                with safe_open(resolved, 'r') as f:
+            # Resolve relative paths against project root, absolute paths used as-is
+            if os.path.isabs(prd_path):
+                resolved = os.path.realpath(prd_path)
+            else:
+                resolved = os.path.realpath(os.path.join(get_project_root(), prd_path))
+            if os.path.exists(resolved) and os.path.isfile(resolved):
+                with open(resolved, 'r', encoding='utf-8') as f:
                     content = f.read()
             else:
                 return json.dumps({"error": f"PRD file not found: {prd_path}"})

package/memory/embeddings.py

@@ -307,6 +307,10 @@ class TextChunker:
         if len(text) <= max_size:
             return [text]
 
+        # Guard against infinite loop when overlap >= max_size
+        if overlap >= max_size:
+            overlap = 0
+
         chunks = []
         start = 0
         while start < len(text):
@@ -1062,12 +1066,17 @@ class EmbeddingEngine:
         # Find texts that need computing
         texts_to_compute = []
         indices_to_compute = []
-        for i, (text, key) in enumerate(zip(texts, cache_keys)):
-            if not self.config.cache_enabled or cached_results.get(key) is None:
-                texts_to_compute.append(text)
-                indices_to_compute.append(i)
-            else:
-                self._metrics["cache_hits"] += 1
+        if not self.config.cache_enabled:
+            # No cache - all texts need computing
+            texts_to_compute = list(texts)
+            indices_to_compute = list(range(len(texts)))
+        else:
+            for i, (text, key) in enumerate(zip(texts, cache_keys)):
+                if cached_results.get(key) is None:
+                    texts_to_compute.append(text)
+                    indices_to_compute.append(i)
+                else:
+                    self._metrics["cache_hits"] += 1
 
         # Compute missing embeddings
         new_embeddings = None

package/memory/engine.py

@@ -881,6 +881,21 @@ class MemoryEngine:
             for e in errors_raw
         ]
 
+        # Parse last_accessed datetime
+        last_accessed = None
+        last_accessed_raw = data.get("last_accessed")
+        if last_accessed_raw:
+            if isinstance(last_accessed_raw, str):
+                if last_accessed_raw.endswith("Z"):
+                    last_accessed_raw = last_accessed_raw[:-1]
+                last_accessed = datetime.fromisoformat(last_accessed_raw)
+                if last_accessed.tzinfo is None:
+                    last_accessed = last_accessed.replace(tzinfo=timezone.utc)
+            elif isinstance(last_accessed_raw, datetime):
+                last_accessed = last_accessed_raw
+                if last_accessed.tzinfo is None:
+                    last_accessed = last_accessed.replace(tzinfo=timezone.utc)
+
         return EpisodeTrace(
             id=data.get("id", ""),
             task_id=data.get("task_id", ""),
@@ -897,6 +912,9 @@ class MemoryEngine:
             tokens_used=data.get("tokens_used", 0),
             files_read=data.get("files_read", context.get("files_involved", [])),
             files_modified=data.get("files_modified", []),
+            importance=data.get("importance", 0.5),
+            last_accessed=last_accessed,
+            access_count=data.get("access_count", 0),
         )
 
     def _dict_to_pattern(self, data: Dict[str, Any]) -> SemanticPattern:
@@ -924,6 +942,21 @@ class MemoryEngine:
             for link in links_raw
         ]
 
+        # Parse last_accessed datetime
+        last_accessed = None
+        last_accessed_raw = data.get("last_accessed")
+        if last_accessed_raw:
+            if isinstance(last_accessed_raw, str):
+                if last_accessed_raw.endswith("Z"):
+                    last_accessed_raw = last_accessed_raw[:-1]
+                last_accessed = datetime.fromisoformat(last_accessed_raw)
+                if last_accessed.tzinfo is None:
+                    last_accessed = last_accessed.replace(tzinfo=timezone.utc)
+            elif isinstance(last_accessed_raw, datetime):
+                last_accessed = last_accessed_raw
+                if last_accessed.tzinfo is None:
+                    last_accessed = last_accessed.replace(tzinfo=timezone.utc)
+
         return SemanticPattern(
             id=data.get("id", ""),
             pattern=data.get("pattern", ""),
@@ -936,6 +969,9 @@ class MemoryEngine:
             usage_count=data.get("usage_count", 0),
             last_used=last_used,
             links=links,
+            importance=data.get("importance", 0.5),
+            last_accessed=last_accessed,
+            access_count=data.get("access_count", 0),
         )
 
     def _dict_to_skill(self, data: Dict[str, Any]) -> ProceduralSkill:
@@ -945,6 +981,22 @@ class MemoryEngine:
             ErrorFix.from_dict(e) if isinstance(e, dict) else e
             for e in raw_errors
         ]
+
+        # Parse last_accessed datetime
+        last_accessed = None
+        last_accessed_raw = data.get("last_accessed")
+        if last_accessed_raw:
+            if isinstance(last_accessed_raw, str):
+                if last_accessed_raw.endswith("Z"):
+                    last_accessed_raw = last_accessed_raw[:-1]
+                last_accessed = datetime.fromisoformat(last_accessed_raw)
+                if last_accessed.tzinfo is None:
+                    last_accessed = last_accessed.replace(tzinfo=timezone.utc)
+            elif isinstance(last_accessed_raw, datetime):
+                last_accessed = last_accessed_raw
+                if last_accessed.tzinfo is None:
+                    last_accessed = last_accessed.replace(tzinfo=timezone.utc)
+
         return ProceduralSkill(
             id=data.get("id", ""),
             name=data.get("name", ""),
@@ -953,6 +1005,10 @@ class MemoryEngine:
             steps=data.get("steps", []),
             common_errors=common_errors,
             exit_criteria=data.get("exit_criteria", []),
+            example_usage=data.get("example_usage"),
+            importance=data.get("importance", 0.5),
+            last_accessed=last_accessed,
+            access_count=data.get("access_count", 0),
         )
 
     def _skill_to_markdown(self, skill: Dict[str, Any]) -> str:

package/memory/schemas.py

@@ -20,9 +20,13 @@ from typing import Optional, List, Dict, Any
 def _to_utc_isoformat(dt: datetime) -> str:
     """Convert datetime to UTC ISO 8601 string with Z suffix.
 
-    Handles both timezone-aware and timezone-naive datetimes,
-    and avoids double-suffixing if already has timezone info.
+    Handles both timezone-aware and timezone-naive datetimes.
+    If dt has a non-UTC timezone, converts to UTC first.
     """
+    # If timezone-aware and not UTC, convert to UTC
+    if dt.tzinfo is not None and dt.utcoffset() != timezone.utc.utcoffset(None):
+        dt = dt.astimezone(timezone.utc)
+
     iso = dt.isoformat()
     # If already has timezone offset like +00:00, replace with Z
     if iso.endswith("+00:00"):

package/memory/storage.py

@@ -233,7 +233,7 @@ class MemoryStorage:
             path: Path to JSON file
 
         Returns:
-            Parsed JSON as dictionary, or None if file doesn't exist
+            Parsed JSON as dictionary, or None if file doesn't exist or is corrupted
         """
         path = Path(path)
         if not path.exists():
@@ -241,7 +241,10 @@ class MemoryStorage:
 
         with self._file_lock(path, exclusive=False):
             with open(path, "r") as f:
-                return json.load(f)
+                try:
+                    return json.load(f)
+                except json.JSONDecodeError:
+                    return None
 
     def _generate_id(self, prefix: str) -> str:
         """

package/memory/token_economics.py

@@ -505,9 +505,12 @@ class TokenEconomics:
             Ratio of discovery_tokens / read_tokens (0.0 if no reads)
         """
         read_tokens = self.metrics["read_tokens"]
+        discovery_tokens = self.metrics["discovery_tokens"]
         if read_tokens == 0:
+            if discovery_tokens > 0:
+                return 999.99  # Sentinel: all discovery, no productive reads
             return 0.0
-        return self.metrics["discovery_tokens"] / read_tokens
+        return discovery_tokens / read_tokens
 
     def get_savings_percent(self) -> float:
         """

package/package.json

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

package/providers/aider.sh

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+# Aider Provider Configuration (18+ Providers, Tier 3)
+# Shell-sourceable config for loki-mode multi-provider support
+
+# Provider Functions (for external use)
+# =====================================
+# These functions provide a clean interface for external scripts:
+#   provider_detect()           - Check if CLI is installed
+#   provider_version()          - Get CLI version
+#   provider_invoke()           - Invoke with prompt (autonomous mode)
+#   provider_invoke_with_tier() - Invoke with tier-specific model selection
+#   provider_get_tier_param()   - Map tier name to model name
+#
+# Usage:
+#   source providers/aider.sh
+#   if provider_detect; then
+#       provider_invoke "Your prompt here"
+#   fi
+#
+# Note: autonomy/run.sh uses inline invocation for streaming support
+# and real-time agent tracking. These functions are intended for
+# simpler scripts, wrappers, and external integrations.
+# =====================================
+
+# Provider Identity
+PROVIDER_NAME="aider"
+PROVIDER_DISPLAY_NAME="Aider (18+ Providers)"
+PROVIDER_CLI="aider"
+
+# CLI Invocation
+# Aider uses --message for single-instruction mode, --yes-always for auto-approve
+# Prompt is passed via --message flag, not positional
+PROVIDER_AUTONOMOUS_FLAG="--yes-always"
+PROVIDER_PROMPT_FLAG="--message"
+PROVIDER_PROMPT_POSITIONAL=false
+
+# Skill System
+# Aider does not have a native skills directory
+PROVIDER_SKILL_DIR=""
+PROVIDER_SKILL_FORMAT="none"
+
+# Capability Flags
+PROVIDER_HAS_SUBAGENTS=false
+PROVIDER_HAS_PARALLEL=false
+PROVIDER_HAS_TASK_TOOL=false
+PROVIDER_HAS_MCP=false
+PROVIDER_MAX_PARALLEL=1
+
+# Model Configuration
+# Aider supports 18+ providers; model configured via LOKI_AIDER_MODEL env var
+# or provider-specific env vars (OPENAI_API_KEY, OPENAI_API_BASE, etc.)
+PROVIDER_MODEL_PLANNING="${LOKI_AIDER_MODEL:-claude-3.7-sonnet}"
+PROVIDER_MODEL_DEVELOPMENT="${LOKI_AIDER_MODEL:-claude-3.7-sonnet}"
+PROVIDER_MODEL_FAST="${LOKI_AIDER_MODEL:-claude-3.7-sonnet}"
+
+# No Task tool - model is configured externally
+PROVIDER_TASK_MODEL_PARAM=""
+PROVIDER_TASK_MODEL_VALUES=()
+
+# Context and Limits (varies by underlying model, conservative defaults)
+PROVIDER_CONTEXT_WINDOW=200000
+PROVIDER_MAX_OUTPUT_TOKENS=128000
+PROVIDER_RATE_LIMIT_RPM=60
+
+# Cost (varies by underlying provider, not tracked by loki)
+PROVIDER_COST_INPUT_PLANNING=0.003
+PROVIDER_COST_OUTPUT_PLANNING=0.015
+PROVIDER_COST_INPUT_DEV=0.003
+PROVIDER_COST_OUTPUT_DEV=0.015
+PROVIDER_COST_INPUT_FAST=0.003
+PROVIDER_COST_OUTPUT_FAST=0.015
+
+# Degraded Mode
+PROVIDER_DEGRADED=true
+PROVIDER_DEGRADED_REASONS=(
+    "No subagent support"
+    "Sequential execution only"
+    "No Task tool or MCP"
+)
+
+# Detection function - check if provider CLI is available
+provider_detect() {
+    command -v aider >/dev/null 2>&1
+}
+
+# Version check function
+provider_version() {
+    aider --version 2>/dev/null | head -1
+}
+
+# Invocation function
+# --message: single instruction mode (process and exit)
+# --yes-always: auto-approve all prompts
+# --no-auto-commits: loki manages git
+provider_invoke() {
+    local prompt="$1"
+    shift
+    local model="${LOKI_AIDER_MODEL:-claude-3.7-sonnet}"
+    local extra_flags="${LOKI_AIDER_FLAGS:-}"
+    # shellcheck disable=SC2086
+    aider --message "$prompt" \
+          --yes-always \
+          --no-auto-commits \
+          --model "$model" \
+          $extra_flags "$@" 2>&1
+}
+
+# Model tier to parameter (Aider uses single model, returns model name)
+provider_get_tier_param() {
+    local tier="$1"
+    echo "${LOKI_AIDER_MODEL:-claude-3.7-sonnet}"
+}
+
+# Dynamic model resolution (v6.0.0)
+# Aider uses a single externally-configured model, so tier resolution
+# just returns the configured model name. maxTier has no effect.
+resolve_model_for_tier() {
+    local tier="$1"
+    echo "${LOKI_AIDER_MODEL:-claude-3.7-sonnet}"
+}
+
+# Tier-aware invocation
+# Aider uses a single model configured externally, tier has no effect
+provider_invoke_with_tier() {
+    local tier="$1"
+    local prompt="$2"
+    shift 2
+    provider_invoke "$prompt" "$@"
+}

package/providers/cline.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+# Cline CLI Provider Configuration (Multi-Provider, Tier 2)
+# Shell-sourceable config for loki-mode multi-provider support
+
+# Provider Functions (for external use)
+# =====================================
+# These functions provide a clean interface for external scripts:
+#   provider_detect()           - Check if CLI is installed
+#   provider_version()          - Get CLI version
+#   provider_invoke()           - Invoke with prompt (autonomous mode)
+#   provider_invoke_with_tier() - Invoke with tier-specific model selection
+#   provider_get_tier_param()   - Map tier name to model name
+#
+# Usage:
+#   source providers/cline.sh
+#   if provider_detect; then
+#       provider_invoke "Your prompt here"
+#   fi
+#
+# Note: autonomy/run.sh uses inline invocation for streaming support
+# and real-time agent tracking. These functions are intended for
+# simpler scripts, wrappers, and external integrations.
+# =====================================
+
+# Provider Identity
+PROVIDER_NAME="cline"
+PROVIDER_DISPLAY_NAME="Cline CLI (Multi-Provider)"
+PROVIDER_CLI="cline"
+
+# CLI Invocation
+# Cline CLI v2.5+ uses -y / --yolo for autonomous mode
+# Prompt is passed as positional argument
+PROVIDER_AUTONOMOUS_FLAG="-y"
+PROVIDER_PROMPT_FLAG=""
+PROVIDER_PROMPT_POSITIONAL=true
+
+# Skill System
+# Cline does not have a native skills directory
+PROVIDER_SKILL_DIR=""
+PROVIDER_SKILL_FORMAT="none"
+
+# Capability Flags
+# Cline has subagents and MCP -- NOT fully degraded (Tier 2)
+PROVIDER_HAS_SUBAGENTS=true
+PROVIDER_HAS_PARALLEL=false
+PROVIDER_HAS_TASK_TOOL=false
+PROVIDER_HAS_MCP=true
+PROVIDER_MAX_PARALLEL=1
+
+# Model Configuration
+# Cline supports 12+ providers; model configured via LOKI_CLINE_MODEL env var
+# or `cline auth` one-time setup. Defaults are placeholders.
+PROVIDER_MODEL_PLANNING="${LOKI_CLINE_MODEL:-claude-sonnet-4-5-20250929}"
+PROVIDER_MODEL_DEVELOPMENT="${LOKI_CLINE_MODEL:-claude-sonnet-4-5-20250929}"
+PROVIDER_MODEL_FAST="${LOKI_CLINE_MODEL:-claude-sonnet-4-5-20250929}"
+
+# No Task tool - model is configured externally
+PROVIDER_TASK_MODEL_PARAM=""
+PROVIDER_TASK_MODEL_VALUES=()
+
+# Context and Limits (varies by underlying provider, conservative defaults)
+PROVIDER_CONTEXT_WINDOW=200000
+PROVIDER_MAX_OUTPUT_TOKENS=128000
+PROVIDER_RATE_LIMIT_RPM=60
+
+# Cost (varies by underlying provider, not tracked by loki)
+PROVIDER_COST_INPUT_PLANNING=0.003
+PROVIDER_COST_OUTPUT_PLANNING=0.015
+PROVIDER_COST_INPUT_DEV=0.003
+PROVIDER_COST_OUTPUT_DEV=0.015
+PROVIDER_COST_INPUT_FAST=0.003
+PROVIDER_COST_OUTPUT_FAST=0.015
+
+# Degraded Mode
+# Cline is NOT degraded -- it has subagents and MCP (Tier 2: near-full)
+PROVIDER_DEGRADED=false
+PROVIDER_DEGRADED_REASONS=()
+
+# Detection function - check if provider CLI is available
+provider_detect() {
+    command -v cline >/dev/null 2>&1
+}
+
+# Version check function
+provider_version() {
+    cline --version 2>/dev/null | head -1
+}
+
+# Invocation function
+# Uses -y (YOLO) for autonomous mode, positional prompt
+provider_invoke() {
+    local prompt="$1"
+    shift
+    local model="${LOKI_CLINE_MODEL:-}"
+    local model_flag=""
+    [[ -n "$model" ]] && model_flag="-m $model"
+    # shellcheck disable=SC2086
+    cline -y $model_flag "$prompt" "$@" 2>&1
+}
+
+# Model tier to parameter (Cline uses single model, returns model name)
+provider_get_tier_param() {
+    local tier="$1"
+    echo "${LOKI_CLINE_MODEL:-default}"
+}
+
+# Dynamic model resolution (v6.0.0)
+# Cline uses a single externally-configured model, so tier resolution
+# just returns the configured model name. maxTier has no effect.
+resolve_model_for_tier() {
+    local tier="$1"
+    echo "${LOKI_CLINE_MODEL:-default}"
+}
+
+# Tier-aware invocation
+# Cline uses a single model configured externally, tier has no effect
+provider_invoke_with_tier() {
+    local tier="$1"
+    local prompt="$2"
+    shift 2
+    provider_invoke "$prompt" "$@"
+}

package/providers/loader.sh

@@ -5,7 +5,7 @@
 PROVIDERS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # List of supported providers
-SUPPORTED_PROVIDERS=("claude" "codex" "gemini")
+SUPPORTED_PROVIDERS=("claude" "codex" "gemini" "cline" "aider")
 
 # Default provider
 DEFAULT_PROVIDER="claude"

package/skills/model-selection.md

@@ -2,13 +2,15 @@
 
 ## Multi-Provider Support (v5.0.0)
 
-Loki Mode supports three AI providers. Claude has full features; Codex and Gemini run in **degraded mode** (sequential execution only, no Task tool, no parallel agents).
+Loki Mode supports five AI providers. Claude has full features; all others run in **degraded mode** (sequential execution only, no Task tool, no parallel agents).
 
 | Provider | Full Features | Degraded | CLI Flag |
 |----------|---------------|----------|----------|
 | **Claude Code** | Yes | No | `--provider claude` (default) |
 | **OpenAI Codex CLI** | No | Yes | `--provider codex` |
 | **Google Gemini CLI** | No | Yes | `--provider gemini` |
+| **Cline CLI** | No | Yes | `--provider cline` |
+| **Aider** | No | Yes | `--provider aider` |
 
 **Degraded mode limitations:**
 - No Task tool (cannot spawn subagents)