loki-mode 5.30.0 → 5.31.0

package/README.md

@@ -82,8 +82,44 @@ jobs:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           mode: review          # review, fix, or test
           provider: claude      # claude, codex, or gemini
-          max_iterations: 3     # higher = more thorough
-          budget_limit: '5.00'  # max cost in USD
+          max_iterations: 3     # sets LOKI_MAX_ITERATIONS env var
+          budget_limit: '5.00'  # max cost in USD (maps to --budget flag)
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+```
+
+**Prerequisites:**
+- An API key for your chosen provider (set as a repository secret):
+  - Claude: `ANTHROPIC_API_KEY`
+  - Codex: `OPENAI_API_KEY`
+  - Gemini: `GOOGLE_API_KEY`
+- The action automatically installs `loki-mode` and `@anthropic-ai/claude-code` (for the Claude provider)
+
+**Action Inputs:**
+
+| Input | Default | Description |
+|-------|---------|-------------|
+| `mode` | `review` | `review`, `fix`, or `test` |
+| `provider` | `claude` | `claude`, `codex`, or `gemini` |
+| `budget_limit` | `5.00` | Max cost in USD (maps to `--budget` CLI flag) |
+| `budget` | | Alias for `budget_limit` |
+| `max_iterations` | `3` | Sets `LOKI_MAX_ITERATIONS` env var |
+| `github_token` | (required) | GitHub token for PR comments |
+| `prd_file` | | Path to PRD file relative to repo root |
+| `auto_confirm` | `true` | Skip confirmation prompts (always true in CI) |
+| `install_claude` | `true` | Auto-install Claude Code CLI if not present |
+| `node_version` | `20` | Node.js version |
+
+**Using with a PRD file (fix/test modes):**
+
+```yaml
+- uses: asklokesh/loki-mode@v5
+  with:
+    mode: fix
+    prd_file: 'docs/my-prd.md'
+    github_token: ${{ secrets.GITHUB_TOKEN }}
+  env:
+    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 ```
 
 **Modes:**

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 zero human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v5.30.0
+# Loki Mode v5.31.0
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -267,4 +267,4 @@ Auto-detected or force with `LOKI_COMPLEXITY`:
 
 ---
 
-**v5.30.0 | Compound learning, specialist reviewers, deepen-plan | ~280 lines core**
+**v5.31.0 | Shell completions, GitHub Action enhancements, auto-confirm | ~280 lines core**

package/VERSION

@@ -1 +1 @@
-5.30.0
+5.31.0

package/autonomy/loki

@@ -317,6 +317,7 @@ show_help() {
     echo "  voice [cmd]      Voice input for PRD creation (status|listen|dictate|speak|start)"
     echo "  import           Import GitHub issues as tasks"
     echo "  config [cmd]     Manage configuration (show|init|edit|path)"
+    echo "  completions [bash|zsh]  Output shell completion scripts"
     echo "  memory [cmd]     Cross-project learnings (list|show|search|stats)"
     echo "  compound [cmd]   Knowledge compounding (list|show|search|run|stats)"
     echo "  council [cmd]    Completion council (status|verdicts|convergence|force-review|report)"
@@ -389,12 +390,22 @@ cmd_start() {
                 echo "  --sandbox             Run in Docker sandbox"
                 echo "  --skip-memory         Skip loading memory context at startup"
                 echo "  --budget USD          Cost budget limit (auto-pause when exceeded)"
+                echo "  --yes, -y             Skip confirmation prompts (auto-confirm)"
+                echo ""
+                echo "Environment Variables:"
+                echo "  LOKI_PRD_FILE         Path to PRD file (alternative to positional arg)"
+                echo "  LOKI_AUTO_CONFIRM     Set to 'true' to skip confirmation prompts"
+                echo "  CI                    When 'true', auto-confirms prompts"
+                echo "  LOKI_MAX_ITERATIONS   Max iteration count"
+                echo "  LOKI_BUDGET_LIMIT     Cost budget limit in USD"
                 echo ""
                 echo "Examples:"
                 echo "  loki start                      # Interactive or resume existing"
                 echo "  loki start ./prd.md             # Start with PRD file"
                 echo "  loki start ./prd.md --parallel  # Parallel mode with worktrees"
                 echo "  loki start --provider codex     # Use OpenAI Codex CLI"
+                echo "  loki start --yes                # Skip confirmation prompt"
+                echo "  LOKI_PRD_FILE=./prd.md loki start  # PRD via env var"
                 exit 0
                 ;;
             --provider)
@@ -444,6 +455,10 @@ cmd_start() {
                 export LOKI_SKIP_MEMORY=true
                 shift
                 ;;
+            --yes|-y)
+                export LOKI_AUTO_CONFIRM=true
+                shift
+                ;;
             --budget)
                 if [[ -n "${2:-}" ]]; then
                     if ! echo "$2" | grep -qE '^[0-9]+(\.[0-9]+)?$'; then
@@ -477,19 +492,29 @@ cmd_start() {
         esac
     done
 
+    # Support LOKI_PRD_FILE environment variable as fallback
+    if [ -z "$prd_file" ] && [ -n "${LOKI_PRD_FILE:-}" ]; then
+        prd_file="$LOKI_PRD_FILE"
+    fi
+
     if [ -n "$prd_file" ]; then
         args+=("$prd_file")
     else
         # No PRD file specified -- warn and confirm before consuming API credits
-        echo -e "${YELLOW}Warning: No PRD file specified.${NC}"
-        echo "Loki Mode will start autonomous execution in the current directory"
-        echo "without a requirements document."
-        echo ""
-        echo -e "This will consume API credits. Continue? [y/N] \c"
-        read -r confirm
-        if [[ ! "$confirm" =~ ^[Yy] ]]; then
-            echo "Aborted. Usage: loki start <path-to-prd.md>"
-            exit 0
+        # Auto-confirm in CI environments or when LOKI_AUTO_CONFIRM is set
+        if [[ "${LOKI_AUTO_CONFIRM:-}" == "true" ]] || [[ "${CI:-}" == "true" ]]; then
+            echo -e "${YELLOW}Warning: No PRD file specified. Auto-confirming (CI mode).${NC}"
+        else
+            echo -e "${YELLOW}Warning: No PRD file specified.${NC}"
+            echo "Loki Mode will start autonomous execution in the current directory"
+            echo "without a requirements document."
+            echo ""
+            echo -e "This will consume API credits. Continue? [y/N] \c"
+            read -r confirm
+            if [[ ! "$confirm" =~ ^[Yy] ]]; then
+                echo "Aborted. Usage: loki start <path-to-prd.md>"
+                exit 0
+            fi
         fi
     fi
 
@@ -3568,6 +3593,9 @@ main() {
         version|--version|-v)
             cmd_version
             ;;
+	completions)
+            cmd_completions "$@"
+            ;;
         help|--help|-h)
             show_help
             ;;
@@ -3845,9 +3873,13 @@ for filename in ['patterns.jsonl', 'mistakes.jsonl', 'successes.jsonl']:
             local type="${2:-}"
 
             if [ -z "$type" ]; then
-                echo -e "${YELLOW}This will delete ALL cross-project learnings.${NC}"
-                echo -n "Are you sure? (yes/no): "
-                read -r confirm
+                if [[ "${LOKI_AUTO_CONFIRM:-}" == "true" ]] || [[ "${CI:-}" == "true" ]]; then
+                    confirm="yes"
+                else
+                    echo -e "${YELLOW}This will delete ALL cross-project learnings.${NC}"
+                    echo -n "Are you sure? (yes/no): "
+                    read -r confirm
+                fi
                 if [ "$confirm" = "yes" ]; then
                     rm -rf "$learnings_dir"
                     mkdir -p "$learnings_dir"
@@ -5888,4 +5920,54 @@ for line in sys.stdin:
     esac
 }
 
+# Output shell completion scripts
+cmd_completions() {
+    local shell="${1:-bash}"
+    local skill_dir
+    
+    # Find the skill directory (where autonomy/loki is located)
+    skill_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+    local completions_dir="$skill_dir/completions"
+    
+    case "$shell" in
+        bash)
+            if [ -f "$completions_dir/loki.bash" ]; then
+                cat "$completions_dir/loki.bash"
+            else
+                echo -e "${RED}Error: Bash completion script not found at $completions_dir/loki.bash${NC}" >&2
+                exit 1
+            fi
+            ;;
+        zsh)
+            if [ -f "$completions_dir/_loki" ]; then
+                cat "$completions_dir/_loki"
+            else
+                echo -e "${RED}Error: Zsh completion script not found at $completions_dir/_loki${NC}" >&2
+                exit 1
+            fi
+            ;;
+        *)
+            echo -e "${BOLD}Loki Shell Completions${NC}"
+            echo ""
+            echo "Output shell completion scripts for bash or zsh."
+            echo ""
+            echo "Usage: loki completions <shell>"
+            echo ""
+            echo "Shells:"
+            echo "  bash    Bash completion script"
+            echo "  zsh     Zsh completion script"
+            echo ""
+            echo "Installation:"
+            echo ""
+            echo "Bash:"
+            echo "  eval \"\$(loki completions bash)\" >> ~/.bashrc"
+            echo ""
+            echo "Zsh:"
+            echo "  eval \"\$(loki completions zsh)\" >> ~/.zshrc"
+            echo ""
+            exit 1
+            ;;
+    esac
+}
+
 main "$@"

package/autonomy/run.sh

@@ -712,15 +712,28 @@ emit_learning_signal() {
 
 # Track iteration timing for efficiency signals
 ITERATION_START_MS=""
+
+# Get current time in milliseconds (portable: works on macOS BSD date and GNU date)
+_now_ms() {
+    local ms
+    ms=$(date +%s%3N 2>/dev/null)
+    # macOS BSD date doesn't support %N -- outputs literal "N" or "%3N"
+    # Detect non-numeric output and fall back to seconds * 1000
+    case "$ms" in
+        *[!0-9]*) echo $(( $(date +%s) * 1000 )) ;;
+        *)        echo "$ms" ;;
+    esac
+}
+
 record_iteration_start() {
-    ITERATION_START_MS=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
+    ITERATION_START_MS=$(_now_ms)
 }
 
 # Get iteration duration in milliseconds
 get_iteration_duration_ms() {
     if [ -n "$ITERATION_START_MS" ]; then
         local end_ms
-        end_ms=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
+        end_ms=$(_now_ms)
         echo $((end_ms - ITERATION_START_MS))
     else
         echo "0"
@@ -2577,7 +2590,7 @@ track_iteration_complete() {
     elif [ "${PROVIDER_NAME:-claude}" = "gemini" ]; then
         model_tier="gemini-3-pro"
     fi
-    local phase="$current_phase"
+    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")
     cat > ".loki/metrics/efficiency/iteration-${iteration}.json" << EFF_EOF
 {

package/dashboard/__init__.py

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

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 Complete installation instructions for all platforms and use cases.
 
-**Version:** v5.30.0
+**Version:** v5.31.0
 
 ---
 
@@ -20,6 +20,7 @@ Complete installation instructions for all platforms and use cases.
 - [Anthropic API Console](#anthropic-api-console)
 - [Verify Installation](#verify-installation)
 - [Ports](#ports)
+- [Shell Completions](#shell-completions)
 - [Troubleshooting](#troubleshooting)
 
 ---
@@ -36,7 +37,7 @@ npm install -g loki-mode
 brew tap asklokesh/tap && brew install loki-mode
 
 # Option C: Docker
-docker pull asklokesh/loki-mode:5.30.0
+docker pull asklokesh/loki-mode:5.31.0
 
 # Option D: Git clone
 git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
@@ -227,7 +228,7 @@ Run Loki Mode in a container for isolated execution.
 
 ```bash
 # Pull the image
-docker pull asklokesh/loki-mode:5.30.0
+docker pull asklokesh/loki-mode:5.31.0
 
 # Or use docker-compose
 curl -o docker-compose.yml https://raw.githubusercontent.com/asklokesh/loki-mode/main/docker-compose.yml
@@ -237,10 +238,10 @@ curl -o docker-compose.yml https://raw.githubusercontent.com/asklokesh/loki-mode
 
 ```bash
 # Run with a PRD file
-docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.30.0 start ./my-prd.md
+docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.31.0 start ./my-prd.md
 
 # Interactive mode
-docker run -it -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.30.0
+docker run -it -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.31.0
 
 # Using docker-compose
 docker-compose run loki start ./my-prd.md
@@ -253,7 +254,7 @@ Pass your configuration via environment variables:
 ```bash
 docker run -e LOKI_MAX_RETRIES=100 -e LOKI_BASE_WAIT=120 \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:5.30.0 start ./my-prd.md
+  asklokesh/loki-mode:5.31.0 start ./my-prd.md
 ```
 
 ### Updating
@@ -369,12 +370,12 @@ Pass the provider as an environment variable:
 # Use Codex with Docker
 docker run -e LOKI_PROVIDER=codex \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:5.30.0 start ./my-prd.md
+  asklokesh/loki-mode:5.31.0 start ./my-prd.md
 
 # Use Gemini with Docker
 docker run -e LOKI_PROVIDER=gemini \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:5.30.0 start ./my-prd.md
+  asklokesh/loki-mode:5.31.0 start ./my-prd.md
 ```
 
 ### Degraded Mode
@@ -611,6 +612,107 @@ CORS_ALLOWED_ORIGINS="http://localhost:3000,https://my-dashboard.example.com" lo
 
 ---
 
+## Shell Completions
+
+Enable tab completion for the `loki` CLI to support subcommands, flags, and file arguments.
+
+---
+
+## Bash Setup
+
+### Option 1: Permanent Setup (Recommended)
+
+Add the source command to your startup file so completions load every time you open a terminal.
+
+Add this line to your `~/.bashrc` (Linux) or `~/.bash_profile` (macOS):
+
+```bash
+source /path/to/loki/completions/loki.bash
+```
+
+---
+
+### Option 2: Manual Sourcing (Temporary)
+
+If you only want to enable completions for your current terminal session (for example, for testing), run:
+
+```bash
+source completions/loki.bash
+```
+
+---
+
+### Optional: Smoother Bash Experience
+
+By default, Bash requires two **TAB** presses to show the completion menu. To make it instant (similar to Zsh) and cycle through options more easily, add the following lines to your `~/.inputrc` file:
+
+```bash
+# Show menu immediately on first TAB
+set show-all-if-ambiguous on
+
+# Case-insensitive completion (optional)
+set completion-ignore-case on
+```
+
+> **Note:** You will need to restart your terminal for `~/.inputrc` changes to take effect.
+
+---
+
+## Zsh Setup
+
+Zsh completions require the script to be located in a directory listed in your `$fpath`.
+
+### Permanent Setup
+
+Add the `loki` completions directory to your `$fpath` in `~/.zshrc` **before** initializing completions:
+
+```bash
+# 1. Add the completions directory to fpath
+fpath=(/path/to/loki/completions $fpath)
+
+# 2. Initialize completions
+autoload -Uz compinit && compinit
+```
+
+---
+
+## Testing Completions
+
+After installation, restart your shell or source your configuration file, then verify:
+
+### Bash
+
+```bash
+loki <TAB>            # Should immediately list subcommands
+loki start -<TAB>     # Should list flags (--provider, --parallel, etc.)
+```
+
+### Zsh
+
+```bash
+loki <TAB>                # Should show subcommands with descriptions
+loki start --pro<TAB>     # Should autocomplete to --provider
+```
+
+---
+
+## Completion Features
+
+The completion scripts support:
+
+* **Subcommands**
+  `start`, `stop`, `pause`, `resume`, `status`, `dashboard`, `import`, `council`, `memory`, `provider`, `config`, `help`, `completions`
+
+* **Smart Context**
+
+  * `loki start --provider <TAB>` shows only installed providers (`claude`, `codex`, `gemini`).
+  * `loki start <TAB>` defaults to file completion for PRD templates.
+
+* **Nested Commands**
+  Handles specific subcommands for `council`, `memory`, and `config`.
+
+---
+
 ## Troubleshooting
 
 ### Skill Not Found

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "5.30.0",
+  "version": "5.31.0",
   "description": "Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "claude",