loki-mode 5.56.2 → 5.57.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 v5.56.2
+# Loki Mode v5.57.1
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -263,4 +263,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 |
 
-**v5.56.2 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v5.57.1 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-5.56.2
+5.57.1

package/autonomy/loki

@@ -419,6 +419,7 @@ show_help() {
     echo "  doctor [--json]  Check system prerequisites and skill symlinks"
     echo "  setup-skill      Create skill symlinks for all providers"
     echo "  watchdog [cmd]   Process health monitoring (status|help)"
+    echo "  remote [PRD]     Start remote session (connect from phone/browser, Claude Pro/Max)"
     echo "  version          Show version"
     echo "  help             Show this help"
     echo ""
@@ -455,6 +456,8 @@ show_help() {
     echo "  loki issue 123                # Generate PRD from issue #123"
     echo "  loki issue 123 --start        # Generate PRD and start Loki Mode"
     echo "  loki issue https://github.com/owner/repo/issues/123  # From URL"
+    echo "  loki remote                   # Start remote session (phone/browser)"
+    echo "  loki remote ./prd.md          # Remote session with PRD context"
     echo ""
     echo "Environment Variables:"
     echo "  See: $RUN_SH (header comments)"
@@ -4851,7 +4854,7 @@ cmd_migrate_help() {
 }
 
 cmd_migrate_list() {
-    python3 -c "
+    PYTHONPATH="${SKILL_DIR:-.}" python3 -c "
 import sys
 sys.path.insert(0, '.')
 from dashboard.migration_engine import list_migrations
@@ -4897,7 +4900,7 @@ cmd_migrate_status() {
         return 1
     fi
 
-    python3 -c "
+    PYTHONPATH="${SKILL_DIR:-.}" python3 -c "
 import json, sys
 sys.path.insert(0, '.')
 from dashboard.migration_engine import MigrationPipeline
@@ -4952,7 +4955,7 @@ print(data.get('id', ''))
 " "$plan_file" 2>/dev/null || echo "")
 
     if [ -n "$migration_id_for_plan" ]; then
-        python3 -c "
+        PYTHONPATH="${SKILL_DIR:-.}" python3 -c "
 import sys
 sys.path.insert(0, '.')
 from dashboard.migration_engine import MigrationPipeline
@@ -5118,7 +5121,7 @@ if manifests:
 
     # Create migration via engine
     local create_result
-    create_result=$(python3 -c "
+    create_result=$(PYTHONPATH="${SKILL_DIR:-.}" python3 -c "
 import json, sys
 sys.path.insert(0, '.')
 from dashboard.migration_engine import MigrationPipeline
@@ -5212,7 +5215,7 @@ print(json.dumps({'id': manifest.id, 'dir': str(pipeline.migration_dir)}))
         echo -e "${CYAN}[Phase: ${p}]${NC} Starting..."
 
         # Start phase via engine
-        python3 -c "
+        PYTHONPATH="${SKILL_DIR:-.}" python3 -c "
 import sys
 sys.path.insert(0, '.')
 from dashboard.migration_engine import MigrationPipeline
@@ -5223,31 +5226,140 @@ pipeline.start_phase(sys.argv[2])
             return 1
         }
 
-        # Phase-specific logic
+        # Phase-specific logic -- invoke Claude to do real work
+        local phase_prompt=""
         case "$p" in
             understand)
                 echo -e "  ${DIM}Analyzing codebase structure...${NC}"
-                echo -e "  ${DIM}Detecting languages, frameworks, dependencies...${NC}"
-                echo -e "  ${DIM}Building dependency graph...${NC}"
+                phase_prompt="You are performing the UNDERSTAND phase of a codebase migration.
+Target: ${target}
+Codebase: ${codebase_path}
+
+Tasks:
+1. Analyze the full codebase structure (languages, frameworks, dependencies, architecture)
+2. Create the docs directory: mkdir -p ${migration_dir}/docs
+3. Write analysis documentation to ${migration_dir}/docs/analysis.md
+3. Identify migration seams (logical boundaries for incremental migration) and write them to ${migration_dir}/seams.json as a JSON array of objects with fields: id, name, description, files (array of file paths), dependencies (array of seam ids), priority (high/medium/low)
+
+You MUST create both files. The migration cannot proceed without them.
+Write the analysis doc first, then the seams.json."
                 ;;
             guardrail)
-                echo -e "  ${DIM}Identifying existing tests...${NC}"
-                echo -e "  ${DIM}Creating rollback checkpoints...${NC}"
-                echo -e "  ${DIM}Setting up safety nets...${NC}"
+                echo -e "  ${DIM}Setting up safety nets and characterization tests...${NC}"
+                phase_prompt="You are performing the GUARDRAIL phase of a codebase migration.
+Target: ${target}
+Codebase: ${codebase_path}
+Migration dir: ${migration_dir}
+
+Read ${migration_dir}/docs/analysis.md and ${migration_dir}/seams.json for context.
+
+Tasks:
+1. Identify existing tests and create characterization tests that capture current behavior
+2. Write ${migration_dir}/features.json as a JSON array of objects with fields: id, name, description, test_command (shell command to verify), passes (boolean, set to true for existing passing behavior)
+3. Create a git checkpoint: cd ${codebase_path} && git stash || true
+
+All features in features.json must have passes: true for the gate to pass."
                 ;;
             migrate)
-                echo -e "  ${DIM}Executing migration transforms (${parallel} parallel agents)...${NC}"
-                echo -e "  ${DIM}Applying incremental changes...${NC}"
+                echo -e "  ${DIM}Executing migration transforms...${NC}"
+                phase_prompt="You are performing the MIGRATE phase of a codebase migration.
+Target: ${target}
+Codebase: ${codebase_path}
+Migration dir: ${migration_dir}
+
+Read ${migration_dir}/docs/analysis.md, ${migration_dir}/seams.json, and ${migration_dir}/features.json for context.
+
+Tasks:
+1. Create a migration plan and write it to ${migration_dir}/migration-plan.json with fields: target, source_path, steps (array of objects with: id, name, description, status set to 'completed' after you do the step)
+2. Execute the actual code migration transforms in ${codebase_path} -- convert code from the current framework/language to ${target}
+3. Update each step status to 'completed' as you finish it
+4. Work incrementally seam by seam from ${migration_dir}/seams.json
+
+All steps must have status: completed for the gate to pass."
                 ;;
             verify)
                 echo -e "  ${DIM}Running verification suite...${NC}"
-                echo -e "  ${DIM}Checking regression tests...${NC}"
-                echo -e "  ${DIM}Validating build output...${NC}"
+                phase_prompt="You are performing the VERIFY phase of a codebase migration.
+Target: ${target}
+Codebase: ${codebase_path}
+Migration dir: ${migration_dir}
+
+Tasks:
+1. Run syntax validation on all migrated files
+2. Run any test commands from ${migration_dir}/features.json to verify behavior is preserved
+3. Check for common migration issues (missing imports, broken references, etc.)
+4. Write a verification report to ${migration_dir}/docs/verification-report.md
+5. Summarize what was migrated, what works, and any remaining issues"
+                ;;
+        esac
+
+        # Invoke Claude to execute the phase
+        local phase_exit=0
+        if [ -n "$phase_prompt" ]; then
+            local provider_name="${LOKI_PROVIDER:-claude}"
+            case "$provider_name" in
+                claude)
+                    (cd "$codebase_path" && claude --dangerously-skip-permissions -p "$phase_prompt" --output-format stream-json --verbose 2>&1) | \
+                        while IFS= read -r line; do
+                            # Extract text from stream-json
+                            if echo "$line" | python3 -c "
+import sys, json
+try:
+    d = json.loads(sys.stdin.read())
+    if d.get('type') == 'assistant':
+        for item in d.get('message', {}).get('content', []):
+            if item.get('type') == 'text':
+                print(item.get('text', ''), end='')
+except Exception: pass
+" 2>/dev/null; then
+                                true
+                            fi
+                        done
+                    phase_exit=${PIPESTATUS[0]}
+                    ;;
+                codex)
+                    (cd "$codebase_path" && codex exec --full-auto "$phase_prompt" 2>&1) || phase_exit=$?
+                    ;;
+                gemini)
+                    (cd "$codebase_path" && gemini --approval-mode=yolo "$phase_prompt" 2>&1) || phase_exit=$?
+                    ;;
+            esac
+        fi
+
+        # Verify phase gate artifacts exist before advancing
+        local gate_ok=true
+        case "$p" in
+            understand)
+                if [ ! -f "${migration_dir}/docs/analysis.md" ] || [ ! -f "${migration_dir}/seams.json" ]; then
+                    echo -e "${RED}Error: Phase 'understand' did not produce required artifacts${NC}"
+                    echo -e "${DIM}  Expected: docs/analysis.md, seams.json${NC}"
+                    gate_ok=false
+                fi
+                ;;
+            guardrail)
+                if [ ! -f "${migration_dir}/features.json" ]; then
+                    echo -e "${RED}Error: Phase 'guardrail' did not produce required artifacts${NC}"
+                    echo -e "${DIM}  Expected: features.json${NC}"
+                    gate_ok=false
+                fi
+                ;;
+            migrate)
+                if [ ! -f "${migration_dir}/migration-plan.json" ]; then
+                    echo -e "${RED}Error: Phase 'migrate' did not produce required artifacts${NC}"
+                    echo -e "${DIM}  Expected: migration-plan.json${NC}"
+                    gate_ok=false
+                fi
                 ;;
         esac
 
+        if [ "$gate_ok" != "true" ]; then
+            echo -e "${YELLOW}Phase '$p' artifacts missing. Migration halted.${NC}"
+            echo -e "${DIM}Re-run with: loki migrate <path> --target ${target} --phase ${p} --resume${NC}"
+            return 1
+        fi
+
         # Complete phase via engine
-        python3 -c "
+        PYTHONPATH="${SKILL_DIR:-.}" python3 -c "
 import sys
 sys.path.insert(0, '.')
 from dashboard.migration_engine import MigrationPipeline
@@ -5627,6 +5739,9 @@ main() {
         syslog)
             cmd_syslog "$@"
             ;;
+        remote|rc)
+            cmd_remote "$@"
+            ;;
         version|--version|-v)
             cmd_version
             ;;
@@ -8483,6 +8598,146 @@ for line in sys.stdin:
     esac
 }
 
+# Remote Control - start a remote-controllable Claude session
+cmd_remote() {
+    local rc_flags=()
+    local prd_file=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --help|-h)
+                echo -e "${BOLD}loki remote${NC} - Start a remote-controllable Claude Code session"
+                echo ""
+                echo "Usage: loki remote [PRD] [options]"
+                echo ""
+                echo "Starts a Claude Code Remote Control session with Loki Mode skill"
+                echo "pre-loaded. Connect from your phone, tablet, or any browser via"
+                echo "claude.ai/code or the Claude mobile app."
+                echo ""
+                echo "Arguments:"
+                echo "  PRD                   Path to PRD file (optional)"
+                echo ""
+                echo "Options:"
+                echo "  --verbose             Show detailed connection and session logs"
+                echo "  --sandbox             Enable sandboxing for filesystem/network isolation"
+                echo "  --no-sandbox          Disable sandboxing (default)"
+                echo ""
+                echo "Requirements:"
+                echo "  - Claude Code CLI installed"
+                echo "  - Anthropic Pro or Max plan (API keys not supported)"
+                echo "  - Signed in via 'claude' then '/login'"
+                echo ""
+                echo "Examples:"
+                echo "  loki remote                    # Start remote session"
+                echo "  loki remote ./prd.md           # Remote session with PRD context"
+                echo "  loki remote --verbose          # Verbose connection logging"
+                echo ""
+                echo "Once connected from your device, say:"
+                echo "  \"Loki Mode\"                    # Start autonomous mode"
+                echo "  \"Loki Mode with PRD at path\"   # Start with specific PRD"
+                exit 0
+                ;;
+            --verbose)
+                rc_flags+=("--verbose")
+                shift
+                ;;
+            --sandbox)
+                rc_flags+=("--sandbox")
+                shift
+                ;;
+            --no-sandbox)
+                rc_flags+=("--no-sandbox")
+                shift
+                ;;
+            --provider|--provider=*)
+                echo -e "${RED}Error: Remote Control only supports the Claude provider${NC}"
+                echo "The --provider flag is not available for 'loki remote'."
+                exit 1
+                ;;
+            -*)
+                echo -e "${RED}Unknown option: $1${NC}"
+                echo "Run 'loki remote --help' for usage."
+                exit 1
+                ;;
+            *)
+                if [ -z "$prd_file" ]; then
+                    prd_file="$1"
+                else
+                    echo -e "${RED}Error: Unexpected argument: $1${NC}"
+                    echo "Run 'loki remote --help' for usage."
+                    exit 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    # Validate Claude CLI is available
+    if ! command -v claude >/dev/null 2>&1; then
+        echo -e "${RED}Error: Claude Code CLI not found${NC}"
+        echo "Install: https://docs.anthropic.com/en/docs/claude-code"
+        exit 1
+    fi
+
+    # Remote control is Claude-only
+    local provider="${LOKI_PROVIDER:-claude}"
+    if [ "$provider" != "claude" ]; then
+        echo -e "${RED}Error: Remote Control is only available with Claude provider${NC}"
+        echo "Current provider: $provider"
+        echo "Remote Control requires Claude Code with a Pro or Max plan."
+        exit 1
+    fi
+
+    # Ensure skill symlink exists so SKILL.md is available in the session
+    local skill_link="$HOME/.claude/skills/loki-mode"
+    if [ ! -f "$skill_link/SKILL.md" ] && [ -n "$SKILL_DIR" ]; then
+        mkdir -p "$HOME/.claude/skills" 2>/dev/null || true
+        ln -sf "$SKILL_DIR" "$skill_link" 2>/dev/null || true
+    fi
+
+    # Resolve PRD to absolute path
+    local prd_abs=""
+    if [ -n "$prd_file" ]; then
+        if [ ! -f "$prd_file" ]; then
+            echo -e "${RED}Error: PRD file not found: $prd_file${NC}"
+            exit 1
+        fi
+        prd_abs="$(cd "$(dirname "$prd_file")" && pwd)/$(basename "$prd_file")"
+    fi
+
+    # Start dashboard in background if enabled
+    if [ "${LOKI_DASHBOARD:-true}" = "true" ]; then
+        cmd_api start >/dev/null 2>&1 &
+    fi
+
+    local version=$(get_version)
+    echo -e "${BOLD}Loki Mode v$version - Remote Control${NC}"
+    echo ""
+    echo -e "${CYAN}Starting Claude Code Remote Control session...${NC}"
+    echo -e "${DIM}Connect from phone, tablet, or browser via claude.ai/code${NC}"
+    echo -e "${DIM}Press spacebar in the terminal to show QR code for mobile${NC}"
+    echo ""
+    if [ -n "$prd_abs" ]; then
+        echo -e "${GREEN}PRD loaded:${NC} $prd_abs"
+        echo ""
+        echo -e "Once connected, say:"
+        echo -e "  ${BOLD}Loki Mode with PRD at $prd_abs${NC}"
+    else
+        echo -e "Once connected, say:"
+        echo -e "  ${BOLD}Loki Mode${NC}"
+    fi
+    echo ""
+
+    # Track session start
+    record_session_start
+
+    # Emit event
+    emit_event session cli remote_start "prd=${prd_abs:-none}"
+
+    # Hand off to claude remote-control
+    exec claude remote-control ${rc_flags[@]+"${rc_flags[@]}"}
+}
+
 # Syslog/SIEM integration management
 cmd_syslog() {
     local subcommand="${1:-help}"

package/dashboard/__init__.py

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

package/dashboard/migration_engine.py

@@ -307,12 +307,14 @@ class MigrationPipeline:
         return phase_data.get("status", "pending")
 
     def start_phase(self, phase: str) -> None:
-        """Start a phase (transition from pending to in_progress)."""
+        """Start a phase (transition from pending to in_progress). Idempotent if already in_progress."""
         if phase not in PHASE_ORDER:
             raise ValueError(f"Unknown phase: {phase}")
         with self._lock:
             manifest = self._load_manifest_unlocked()
             current_status = manifest.phases[phase]["status"]
+            if current_status == "in_progress":
+                return  # Already started, idempotent
             if current_status != "pending":
                 raise RuntimeError(
                     f"Cannot start phase '{phase}': status is '{current_status}', expected 'pending'"

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:** v5.56.2
+**Version:** v5.57.1
 
 ---
 

package/mcp/__init__.py

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

package/package.json

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