loki-mode 7.11.0 → 7.12.0

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Autonomous spec-to-product system. Triggers on "Loki Mode". Takes a spec (PRD, GitHub issue, OpenAPI doc, etc.) to deployed product via the RARV-C closure loop, with minimal human intervention. Provider-agnostic. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v7.11.0
+# Loki Mode v7.12.0
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -381,4 +381,4 @@ See `CHANGELOG.md` entries [7.5.7], [7.5.8], [7.5.13] for the per-fix list and r
 
 ---
 
-**v7.11.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v7.12.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-7.11.0
+7.12.0

package/autonomy/loki

@@ -739,6 +739,17 @@ detect_arg_type() {
         return 0
     fi
 
+    # R7 (zero-config first run): a one-line brief. An arg that contains
+    # whitespace and matched none of the file/issue/path patterns above is a
+    # natural-language brief (e.g. "build a todo app"), NOT a PRD path. This is
+    # additive: a single-token arg with no whitespace still falls through to
+    # "unknown" (PRD-path back-compat) below. The `--brief` flag is the
+    # deterministic escape hatch for the rare single-word brief.
+    if [[ "$arg" == *[[:space:]]* ]]; then
+        echo "brief"
+        return 0
+    fi
+
     # Fallback: unknown. Caller treats as PRD for backward compat.
     echo "unknown"
 }
@@ -752,6 +763,7 @@ cmd_start() {
     local args=()
     local prd_file=""
     local provider=""
+    local brief_text=""           # R7: explicit one-line brief (--brief "...")
     local bmad_project_path=""
     local openspec_change_path=""
     local mirofish_url=""
@@ -784,6 +796,8 @@ cmd_start() {
                 echo "  PRD mode    - path ending in .md/.json/.txt/.yaml -> build from PRD"
                 echo "  ISSUE mode  - GitHub/GitLab/Jira/Azure DevOps URL, owner/repo#N,"
                 echo "                PROJ-123, #123, or bare number -> generate PRD from issue"
+                echo "  BRIEF mode  - a quoted one-line description (with spaces) -> fast"
+                echo "                zero-config first run; visible artifact + proof quickly"
                 echo "  no input    - analyze current directory, auto-generate PRD"
                 echo ""
                 echo "Arguments:"
@@ -793,6 +807,7 @@ cmd_start() {
                 echo "Explicit mode flags (override auto-detection):"
                 echo "  --prd FILE            Force PRD mode with FILE"
                 echo "  --issue URL|NUM       Force issue mode with URL or number"
+                echo "  --brief \"TEXT\"        Force zero-config brief mode (fast first run)"
                 echo ""
                 echo "Options:"
                 echo "  --provider NAME       AI provider: claude (default), codex, cline, aider"
@@ -816,6 +831,7 @@ cmd_start() {
                 echo "  --mirofish-bg         Run MiroFish pipeline in background"
                 echo "  --no-mirofish         Disable MiroFish even if env var is set"
                 echo "  --no-plan             Skip auto-shown PRD analysis at startup"
+                echo "  --brief \"TEXT\"        Zero-config fast first run from a one-line brief"
                 echo "  --yes, -y             Skip confirmation prompts (auto-confirm)"
                 echo ""
                 echo "Issue-mode options (only used when input is an ISSUE-REF):"
@@ -836,6 +852,8 @@ cmd_start() {
                 echo ""
                 echo "Examples:"
                 echo "  loki start                              # Interactive, analyze current dir"
+                echo "  loki start \"build a todo app\"           # BRIEF mode (zero-config fast run)"
+                echo "  loki start --brief \"snake\"              # BRIEF mode (single-word escape hatch)"
                 echo "  loki start ./prd.md                     # PRD mode"
                 echo "  loki start https://github.com/o/r/issues/42  # ISSUE mode (GitHub)"
                 echo "  loki start 123                          # ISSUE mode (current repo GitHub issue)"
@@ -1065,6 +1083,22 @@ cmd_start() {
                 no_plan=true
                 shift
                 ;;
+            --brief)
+                # R7: explicit one-line brief (escape hatch for single-word
+                # briefs that detect_arg_type would otherwise treat as a PRD
+                # path). Forces the zero-config first-run brief sub-path.
+                if [[ -n "${2:-}" ]] && [[ "${2:-}" != --* ]]; then
+                    brief_text="$2"
+                    shift 2
+                else
+                    echo -e "${RED}--brief requires a one-line description (e.g., --brief \"build a todo app\")${NC}"
+                    exit 1
+                fi
+                ;;
+            --brief=*)
+                brief_text="${1#*=}"
+                shift
+                ;;
             --budget)
                 if [[ -n "${2:-}" ]]; then
                     if ! echo "$2" | grep -qE '^[0-9]+(\.[0-9]+)?$'; then
@@ -1184,12 +1218,21 @@ cmd_start() {
     done
 
     # v6.84.0: Unified dispatch based on explicit flags or auto-detection
-    # Precedence: --issue > --prd > positional auto-detect > LOKI_PRD_FILE env
+    # Precedence: --brief > --issue > --prd > positional auto-detect >
+    #             LOKI_PRD_FILE env
     local detected_type=""
-    if [ -n "$explicit_mode" ]; then
+    if [ -n "$brief_text" ]; then
+        # R7: explicit --brief always forces the zero-config brief sub-path.
+        detected_type="brief"
+    elif [ -n "$explicit_mode" ]; then
         detected_type="$explicit_mode"
     elif [ -n "$positional_arg" ]; then
         detected_type=$(detect_arg_type "$positional_arg")
+        # R7: a positional one-line brief (whitespace, not a file/issue) maps to
+        # the brief sub-path; capture the text from the positional arg.
+        if [ "$detected_type" = "brief" ]; then
+            brief_text="$positional_arg"
+        fi
     elif [ -n "${LOKI_PRD_FILE:-}" ]; then
         detected_type="prd"
         prd_file="$LOKI_PRD_FILE"
@@ -1229,6 +1272,51 @@ cmd_start() {
         return $?
     fi
 
+    # R7 (zero-config first run): BRIEF mode. The user gave a one-line brief
+    # (`loki start "build a todo app"` or `loki start --brief "..."`). Synthesize
+    # a forward-looking PRD, switch to the lightweight TTFV profile (honest fast:
+    # capped iterations, council off, simple tier, heavy phases off), and mark
+    # LOKI_TTFV=1 so run.sh prints the "what next / go deeper" framing at the
+    # end. Then fall through to the normal flow, which appends prd_file to args
+    # and execs run.sh. This is additive -- nothing here changes the PRD/issue
+    # paths above.
+    if [ "$detected_type" = "brief" ]; then
+        local version
+        version=$(get_version)
+        local _ttfv_max_iter="${LOKI_MAX_ITERATIONS:-3}"
+        mkdir -p "$LOKI_DIR" 2>/dev/null || true
+        local brief_prd="$LOKI_DIR/brief-prd-$$.md"
+        synthesize_brief_prd "$brief_prd" "$brief_text"
+        prd_file="$brief_prd"
+
+        # Apply the shared lightweight profile and flag the TTFV first-run path.
+        # The signal value ("brief") drives the end-of-run wording in run.sh so
+        # the message matches what actually ran (lightweight, council off).
+        set_ttfv_lightweight_profile "$_ttfv_max_iter"
+        export LOKI_TTFV=brief
+        # Skip the heavy auto-plan analysis -- the brief path is the fast path,
+        # and we already printed the upfront framing below.
+        no_plan=true
+
+        echo -e "${BOLD}Loki Mode v$version - Zero-config first run${NC}"
+        echo ""
+        echo -e "${CYAN}Brief:${NC} $brief_text"
+        echo -e "${DIM}Fast first pass: $_ttfv_max_iter iterations max, council off, simple tier.${NC}"
+        echo -e "${DIM}You will get a runnable artifact and a proof-of-run quickly.${NC}"
+        echo -e "${DIM}Go deeper later with: loki start (full RARV-C depth).${NC}"
+        echo -e "${GREEN}Brief PRD written${NC} to $brief_prd"
+        echo ""
+    fi
+
+    # R7: existing-repo no-arg path also gets the TTFV "what next" framing at the
+    # end of the run. Execution here is UNCHANGED (full-depth no-PRD codebase
+    # analysis + generated-PRD-reuse); we only add accurate end-of-run framing.
+    # The signal value ("repo") drives the full-depth wording in run.sh so the
+    # message does not falsely claim a lightweight pass.
+    if [ "$detected_type" = "empty" ] && [ -z "${LOKI_TTFV:-}" ]; then
+        export LOKI_TTFV=repo
+    fi
+
     # PRD mode: positional arg is the PRD file (if not already set via --prd)
     if [ "$detected_type" = "prd" ] && [ -z "$prd_file" ]; then
         prd_file="$positional_arg"
@@ -8847,6 +8935,65 @@ cmd_demo() {
     return $start_exit
 }
 
+# R7 (zero-config first run): set the lightweight TTFV execution profile.
+# Shared by `cmd_quick` and the `loki start "<brief>"` brief sub-path so the
+# fast first pass means the same thing in both: capped iterations, completion
+# council off, simple complexity tier, heavy phases off. This is HONEST fast --
+# it genuinely shortens the path to first visible value; it does not fake
+# progress. Depth is opt-in via a plain `loki start` re-run.
+# Usage: set_ttfv_lightweight_profile [max_iter]
+set_ttfv_lightweight_profile() {
+    local max_iter="${1:-${LOKI_MAX_ITERATIONS:-3}}"
+    export LOKI_MAX_ITERATIONS="$max_iter"
+    export LOKI_COMPLEXITY=simple
+    export LOKI_COUNCIL_ENABLED=false
+    export LOKI_PHASE_CODE_REVIEW=false
+    export LOKI_PHASE_PERFORMANCE=false
+    export LOKI_PHASE_ACCESSIBILITY=false
+    export LOKI_PHASE_REGRESSION=false
+    export LOKI_PHASE_UAT=false
+    export LOKI_PHASE_WEB_RESEARCH=false
+}
+
+# R7: synthesize a forward-looking PRD from a one-line brief. Writes to a
+# unique path (caller-provided) and echoes nothing -- the file is the output.
+# Kept DISTINCT from .loki/generated-prd.md (codebase-analysis artifact) so it
+# never pollutes the v7.8.1 generated-PRD-reuse signature logic. The brief text
+# is the project intent; the rest is a minimal scaffold the agent fills in.
+# Usage: synthesize_brief_prd <output_file> <brief_text>
+synthesize_brief_prd() {
+    local out_file="$1"
+    local brief_text="$2"
+    local out_dir
+    out_dir="$(dirname "$out_file")"
+    mkdir -p "$out_dir" 2>/dev/null || true
+    cat > "$out_file" << BRIEFEOF
+# Project Brief
+
+## Overview
+$brief_text
+
+## Requirements
+- Build the smallest working version of the above that a user can see and run.
+- Prefer a runnable artifact (a page, a CLI, an API endpoint) over scaffolding.
+- Follow conventional structure for the chosen stack; keep dependencies minimal.
+- Write a short README describing how to run it.
+
+## Success Criteria
+- A user can run the result and observe the core behavior described above.
+- No errors on a clean start; the happy path works end to end.
+
+## Constraints
+- This is a fast first pass (zero-config first run). Keep scope tight.
+- Do not over-engineer; depth and hardening come on a later full run.
+- No emojis, no em dashes in code, comments, or docs.
+
+---
+
+**Mode:** Brief (zero-config first run, lightweight first pass)
+BRIEFEOF
+}
+
 # Quick mode - lightweight single-task execution
 cmd_quick() {
     # v7.6.3 B-11 fix: --help previously fell through to provider invocation
@@ -8934,16 +9081,9 @@ QPRDEOF
     echo -e "${GREEN}Quick PRD generated${NC} at $quick_prd"
     echo ""
 
-    # Set lightweight execution environment
-    export LOKI_MAX_ITERATIONS="$max_iter"
-    export LOKI_COMPLEXITY=simple
-    export LOKI_COUNCIL_ENABLED=false
-    export LOKI_PHASE_CODE_REVIEW=false
-    export LOKI_PHASE_PERFORMANCE=false
-    export LOKI_PHASE_ACCESSIBILITY=false
-    export LOKI_PHASE_REGRESSION=false
-    export LOKI_PHASE_UAT=false
-    export LOKI_PHASE_WEB_RESEARCH=false
+    # Set lightweight execution environment (shared TTFV profile -- see
+    # set_ttfv_lightweight_profile; same profile the R7 brief sub-path uses).
+    set_ttfv_lightweight_profile "$max_iter"
 
     # Record start for efficiency tracking
     record_session_start

package/autonomy/run.sh

@@ -4121,6 +4121,69 @@ generate_proof_of_run() {
     return 0
 }
 
+# print_ttfv_next_steps: R7 zero-config first-run "what next / go deeper"
+# message. The wording MUST match what actually ran, so it branches on the mode:
+#   - brief: a one-line brief ran on the lightweight profile (council off,
+#            simple tier, capped iterations). Proof contains diffs, cost, time
+#            (council verdicts are absent because the council was disabled).
+#   - repo:  a no-arg in-repo run analyzed the codebase and ran at full depth
+#            (council on). Proof contains diffs, cost, time, and council
+#            verdicts.
+# This function only prints; the caller owns the TTY gate. Never fails the run.
+# Usage: print_ttfv_next_steps <mode> <result>
+print_ttfv_next_steps() {
+    local mode="${1:-}"
+    local result="${2:-0}"
+    local loki_dir="${TARGET_DIR:-.}/.loki"
+    local proofs_dir="$loki_dir/proofs"
+
+    echo ""
+    echo "============================================================"
+    if [ "$result" = "0" ]; then
+        echo "  First pass complete. Here is what you have:"
+    else
+        echo "  First pass ended early. Here is what was produced:"
+    fi
+    echo "============================================================"
+    echo ""
+    echo "  What I did:"
+    if [ "$mode" = "brief" ]; then
+        echo "    - Worked from your one-line brief on a fast, lightweight first"
+        echo "      pass (council off, simple tier, capped iterations)."
+        echo "    - Generated a proof-of-run (diffs, cost, time)."
+    else
+        echo "    - Analyzed your codebase and generated a PRD, then ran a full"
+        echo "      first pass (council on, full RARV-C depth)."
+        echo "    - Generated a proof-of-run (diffs, cost, time, council verdicts)."
+    fi
+    echo ""
+    echo "  See the visible artifact (proof-of-run):"
+    if [ -d "$proofs_dir" ]; then
+        local latest
+        latest=$(ls -1t "$proofs_dir" 2>/dev/null | head -1)
+        if [ -n "$latest" ]; then
+            echo "    loki proof open $latest"
+            echo "    (or open $proofs_dir/$latest/index.html)"
+        else
+            echo "    loki proof list"
+        fi
+    else
+        echo "    loki proof list"
+    fi
+    echo ""
+    if [ "$mode" = "brief" ]; then
+        echo "  Go deeper (full RARV-C depth, council-gated):"
+        echo "    loki start                 # continue / harden this project"
+        echo "    loki start ./prd.md        # build from a full PRD"
+    else
+        echo "  Next steps:"
+        echo "    loki start ./prd.md        # build from a full PRD"
+        echo "    loki start \"<one line>\"    # fast first pass from a brief"
+    fi
+    echo ""
+    return 0
+}
+
 track_iteration_complete() {
     local iteration="$1"
     local exit_code="${2:-0}"
@@ -13335,6 +13398,15 @@ main() {
         generate_proof_of_run "$result" || true
     fi
 
+    # R7 (zero-config first run): "what next / go deeper" framing. Only when the
+    # CLI flagged this as a TTFV first run and stdout is a TTY, so it stays
+    # silent in CI / pipes and never fires for normal PRD runs. The wording
+    # branches on the mode (brief = lightweight first pass; repo = full-depth
+    # codebase analysis) so the message always matches what actually ran.
+    if [ -n "${LOKI_TTFV:-}" ] && [ -t 1 ]; then
+        print_ttfv_next_steps "${LOKI_TTFV}" "$result" || true
+    fi
+
     # Create PR from agent branch if branch protection was enabled
     create_session_pr
     audit_agent_action "session_stop" "Session ended" "result=$result,iterations=$ITERATION_COUNT"

package/dashboard/__init__.py

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

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:** v7.11.0
+**Version:** v7.12.0
 
 ---
 

package/docs/R7-ZERO-CONFIG-FIRST-RUN-PLAN.md

@@ -0,0 +1,137 @@
+# R7: Zero-config killer first run (time-to-first-value)
+
+Design note for the R7 release in the competitive-stickiness arc. Worktree
+deliverable for the integrator to cherry-pick. NO version bumps here.
+
+## Goal
+
+Convert trials to habits. The #1 acquisition-to-retention gate is the first
+run. Today a blank first run is mediocre and Loki's deep RARV-C / council can
+feel heavy on run 1. R7 = a frictionless first run: a user types
+`loki start "<one line>"` (or `loki start` in an existing repo) and sees a
+VISIBLE valuable artifact in minutes, with depth opt-in later.
+
+Honest "fast": we do NOT fake progress. We actually shorten the path by running
+a lightweight execution profile first (capped iterations, completion council
+off, simple complexity tier, heavy phases off) so the first visible artifact
+plus a proof-of-run land quickly. "Go deeper" = re-run plain `loki start` for
+the full RARV-C depth.
+
+## Verified current behavior (real code, traced 2026-06-03)
+
+- `cmd_start()` (`autonomy/loki:746`) is the unified entry. It parses args,
+  calls `detect_arg_type()` (`autonomy/loki:667`), then dispatches:
+  issue -> `cmd_run`; prd -> sets `prd_file`; empty -> no-PRD path; unknown
+  -> treated as a PRD path for back-compat.
+- `cmd_start` ends in `_loki_new_session_exec "$RUN_SH" ...` (`autonomy/loki:1678`).
+  Every branch of `_loki_new_session_exec` (`autonomy/loki:167-186`) uses
+  `exec`, so NOTHING after that line in `cmd_start` runs. Any end-of-run
+  message must live in `run.sh`, not after the exec in `cmd_start`.
+- `cmd_quick()` (`autonomy/loki:8849`) already synthesizes a PRD from a
+  one-line task and sets the lightweight profile
+  (`LOKI_MAX_ITERATIONS=3`, `LOKI_COMPLEXITY=simple`,
+  `LOKI_COUNCIL_ENABLED=false`, heavy phases off), then execs `run.sh`.
+- No-PRD + generated-PRD-reuse (v7.8.1): in `run.sh` around line 11102,
+  `decide_generated_prd_action()` (`run.sh:4032`) returns reuse|update|generate
+  for the no-arg in-repo path; signature persisted by
+  `persist_prd_signature_if_present()` (`run.sh:4064`).
+- Proof-of-run (R1): `generate_proof_of_run()` (`run.sh:4101`) wraps
+  `autonomy/lib/proof-generator.py`. It runs at session end (`run.sh:13312`)
+  on both success and failure, gated only by `LOKI_PROOF` (NOT by council
+  state), writing `.loki/proofs/<run_id>/{proof.json,index.html}`. Viewable
+  via `loki proof list` / `loki proof open <id>` (Bun-routed, `bin/loki:119`).
+
+### The exact gap R7 closes (traced, not assumed)
+
+`loki start "build a todo app"` TODAY:
+1. `detect_arg_type("build a todo app")` returns `unknown` (has spaces, no
+   extension, not a file, not an issue ref).
+2. The PRD-not-found guard at `autonomy/loki:1243` and `:1268` only fires for
+   `*.md|*.json|*.txt|*.yaml|*.yml`, so a brief with spaces slips past.
+3. `prd_file="build a todo app"` is passed to `run.sh`, which fails:
+   `[ERROR] PRD file not found: build a todo app`.
+
+So the one-line-brief path is broken today. R7 makes it work. This is ADDITIVE:
+no existing valid input (`.md` PRD, issue ref, single-token name) changes
+behavior.
+
+## Design (additive, no behavior change to existing inputs)
+
+1. `detect_arg_type`: add a `brief` return ONLY for args that contain
+   whitespace and match none of the file/issue/path patterns. A single-token
+   `unknown` arg still falls back to PRD path (back-compat preserved).
+2. `--brief "<text>"` explicit flag: deterministic escape hatch for the rare
+   single-word brief (e.g. `loki start --brief "snake"`).
+3. Shared helper `synthesize_brief_prd <file> <text>`: factored so `cmd_quick`
+   and the new brief path write the same forward-looking PRD. The brief PRD is
+   written to `.loki/brief-prd-$$.md` -- DISTINCT from `.loki/generated-prd.md`
+   so it never pollutes the v7.8.1 generated-PRD-reuse signature logic
+   (generated-prd is for codebase analysis of an existing repo; brief is a
+   forward spec).
+4. `cmd_start` brief sub-path: set the lightweight TTFV profile (same env as
+   quick), synthesize the brief PRD, set `LOKI_TTFV=brief`, then continue
+   through the normal exec path. Upfront framing ("fast first pass") is printed
+   BEFORE the exec.
+5. `cmd_start` no-arg in-repo path: UNCHANGED execution (existing no-PRD +
+   reuse, full RARV-C depth), but set `LOKI_TTFV=repo` so the end-of-run
+   what-next framing appears.
+6. `run.sh` end-of-session: after proof generation, when `LOKI_TTFV` is set and
+   stdout is a TTY, call `print_ttfv_next_steps <mode> <result>`. The wording
+   BRANCHES on mode so the message always matches what actually ran:
+   - `brief`: lightweight first pass, council off; proof has diffs/cost/time
+     (NO council verdicts, because the council was disabled).
+   - `repo`: full-depth codebase analysis, council on; proof has
+     diffs/cost/time/council verdicts.
+   Both point at `loki proof list` / `loki proof open` (the visible artifact)
+   and the depth opt-in. Gated so it is silent in CI / pipes and never fires
+   for normal PRD runs. Factored into `print_ttfv_next_steps` so it is
+   unit-testable.
+
+Honesty note: the `brief` message intentionally does NOT advertise "council
+verdicts" because brief mode runs with the council off (`_collect_council` in
+proof-generator.py finds no council state, so that proof section is blank on the
+brief path). The `repo` message claims verdicts because the full-depth path runs
+the council. This keeps the end-of-run summary truthful per the no-fabrication
+rule.
+
+### Why fast is honest
+
+The brief path uses the same lightweight profile `cmd_quick` already ships:
+3 iterations max, council off, simple tier, heavy phases (perf, a11y,
+regression, UAT, web-research) off. That genuinely shortens the path to first
+visible value. We do not print fake progress or claim work that did not happen;
+the proof-of-run is generated from real `.loki/` state. Depth is opt-in: the
+end-of-run message tells the user to re-run plain `loki start` (or
+`loki start <prd.md>`) for the full council-gated build.
+
+## Parity (bash + Bun)
+
+`loki start` and `loki quick` are NOT in the Bun shim allowlist
+(`bin/loki:119`), so dispatch is bash-only by design; this change is bash-only
+for the CLI surface. The runtime pieces it reuses are already shared across
+routes: `proof-generator.py` (one implementation, both routes) and the no-PRD /
+generated-PRD-reuse path in `run.sh` (both routes source run.sh). No Bun CLI
+change is required for parity.
+
+## Files
+
+- `autonomy/loki`: `detect_arg_type` brief return; `--brief` flag;
+  `synthesize_brief_prd` helper; `cmd_quick` refactor to use it; `cmd_start`
+  brief sub-path + `LOKI_TTFV` wiring; help text.
+- `autonomy/run.sh`: end-of-session TTFV what-next block.
+- `tests/cli/test_zero_config_first_run.sh`: new test suite.
+
+## Tests (no paid runs; mock via early exit)
+
+Following `tests/cli/test_start_run_unified.sh`: extract `detect_arg_type` and
+`synthesize_brief_prd` in a subshell and assert on them; force `cmd_start` to
+exit before `run.sh` boots via `--provider nonexistent-provider`.
+
+- `detect_arg_type("build a todo app")` = `brief`; single tokens still `unknown`;
+  `.md` still `prd`; issue refs still `issue`; empty still `empty`.
+- `synthesize_brief_prd` writes a PRD containing the brief text and TTFV markers.
+- `loki start "<brief>"` enters the brief path (lightweight env, not
+  "PRD file not found").
+- `loki start --brief "<one word>"` works.
+- existing-repo no-arg path still routes to no-PRD (unchanged).
+- `loki start <prd.md>` (real PRD) still routes to PRD mode (no regression).

package/loki-ts/dist/loki.js

@@ -1,5 +1,5 @@
 // @bun
-var N7=Object.defineProperty;var k7=(K)=>K;function D7(K,$){this[K]=k7.bind(null,$)}var v=(K,$)=>{for(var Q in $)N7(K,Q,{get:$[Q],enumerable:!0,configurable:!0,set:D7.bind($,Q)})};var E=(K,$)=>()=>(K&&($=K(K=0)),$);var $1=import.meta.require;var z0={};v(z0,{lokiDir:()=>w,homeLokiDir:()=>v1,findRepoRootForVersion:()=>y1,REPO_ROOT:()=>c});import{resolve as p,dirname as b1}from"path";import{fileURLToPath as C7}from"url";import{existsSync as O1}from"fs";import{homedir as h7}from"os";function b7(){let K=Z0;for(let $=0;$<6;$++){if(O1(p(K,"VERSION"))&&O1(p(K,"autonomy/run.sh")))return K;let Q=b1(K);if(Q===K)break;K=Q}return p(Z0,"..","..","..")}function y1(K){let $=K;for(let Q=0;Q<6;Q++){if(O1(p($,"VERSION"))&&O1(p($,"autonomy/run.sh")))return $;let X=b1($);if(X===$)break;$=X}return p(K,"..","..","..")}function w(){return process.env.LOKI_DIR??p(process.cwd(),".loki")}function v1(){return p(h7(),".loki")}var Z0,c;var g=E(()=>{Z0=b1(C7(import.meta.url));c=b7()});import{readFileSync as y7}from"fs";import{resolve as v7,dirname as g7}from"path";import{fileURLToPath as m7}from"url";function T1(){if(r!==null)return r;let K="7.11.0";if(typeof K==="string"&&K.length>0)return r=K,r;try{let $=g7(m7(import.meta.url)),Q=y1($);r=y7(v7(Q,"VERSION"),"utf-8").trim()}catch{r="unknown"}return r}var r=null;var g1=E(()=>{g()});var V0={};v(V0,{runOrThrow:()=>f7,run:()=>N,commandVersion:()=>p7,commandExists:()=>y,ShellError:()=>m1});async function N(K,$={}){let Q=Bun.spawn({cmd:[...K],stdout:"pipe",stderr:"pipe",env:$.env?{...process.env,...$.env}:process.env,cwd:$.cwd}),X,Z;if($.timeoutMs&&$.timeoutMs>0)X=setTimeout(()=>{try{Q.kill("SIGTERM")}catch{}Z=setTimeout(()=>{try{Q.kill("SIGKILL")}catch{}},2000)},$.timeoutMs);try{let[z,H,U]=await Promise.all([new Response(Q.stdout).text(),new Response(Q.stderr).text(),Q.exited]);return{stdout:z,stderr:H,exitCode:U}}finally{if(X)clearTimeout(X);if(Z)clearTimeout(Z)}}async function f7(K,$={}){let Q=await N(K,$);if(Q.exitCode!==0)throw new m1(`command failed (${Q.exitCode}): ${K.join(" ")}`,Q.exitCode,Q.stdout,Q.stderr);return Q}async function y(K){let $=u7(K),Q=await N(["sh","-c",`command -v ${$}`],{timeoutMs:5000});if(Q.exitCode===0)return Q.stdout.trim()||null;return null}function u7(K){if(!/^[A-Za-z0-9._/-]+$/.test(K))throw Error(`refused to shell-escape suspect token: ${K}`);return K}async function p7(K,$="--version"){if(!await y(K))return null;let X=await N([K,$],{timeoutMs:5000});if(X.exitCode!==0)return null;return((X.stdout||X.stderr).split(/\r?\n/)[0]?.trim()??"")||null}var m1;var l=E(()=>{m1=class m1 extends Error{message;exitCode;stdout;stderr;constructor(K,$,Q,X){super(K);this.message=K;this.exitCode=$;this.stdout=Q;this.stderr=X;this.name="ShellError"}}});function d(K){return c7?"":K}var c7,A,h,x,u6,_,k,D,V;var o=E(()=>{c7=(process.env.NO_COLOR??"").length>0;A=d("\x1B[0;31m"),h=d("\x1B[0;32m"),x=d("\x1B[1;33m"),u6=d("\x1B[0;34m"),_=d("\x1B[0;36m"),k=d("\x1B[1m"),D=d("\x1B[2m"),V=d("\x1B[0m")});import{existsSync as e7}from"fs";async function Q1(){if(U1!==void 0)return U1;let K="/opt/homebrew/bin/python3.12";if(e7(K))return U1=K,K;let $=await y("python3.12");if($)return U1=$,$;let Q=await y("python3");return U1=Q,Q}async function t(K,$={}){let Q=await Q1();if(!Q)return{stdout:"",stderr:"python3 not found",exitCode:127};return N([Q,"-c",K],$)}var U1;var q1=E(()=>{l()});var A0={};v(A0,{runStatus:()=>B5});import{existsSync as C,readFileSync as Z1,readdirSync as G0,statSync as B0}from"fs";import{resolve as S,basename as Z5}from"path";import{homedir as z5}from"os";async function V5(){if(await y("jq"))return!0;return process.stdout.write(`${A}Error: jq is required but not installed.${V}
+var N7=Object.defineProperty;var k7=(K)=>K;function D7(K,$){this[K]=k7.bind(null,$)}var v=(K,$)=>{for(var Q in $)N7(K,Q,{get:$[Q],enumerable:!0,configurable:!0,set:D7.bind($,Q)})};var E=(K,$)=>()=>(K&&($=K(K=0)),$);var $1=import.meta.require;var z0={};v(z0,{lokiDir:()=>w,homeLokiDir:()=>v1,findRepoRootForVersion:()=>y1,REPO_ROOT:()=>c});import{resolve as p,dirname as b1}from"path";import{fileURLToPath as C7}from"url";import{existsSync as O1}from"fs";import{homedir as h7}from"os";function b7(){let K=Z0;for(let $=0;$<6;$++){if(O1(p(K,"VERSION"))&&O1(p(K,"autonomy/run.sh")))return K;let Q=b1(K);if(Q===K)break;K=Q}return p(Z0,"..","..","..")}function y1(K){let $=K;for(let Q=0;Q<6;Q++){if(O1(p($,"VERSION"))&&O1(p($,"autonomy/run.sh")))return $;let X=b1($);if(X===$)break;$=X}return p(K,"..","..","..")}function w(){return process.env.LOKI_DIR??p(process.cwd(),".loki")}function v1(){return p(h7(),".loki")}var Z0,c;var g=E(()=>{Z0=b1(C7(import.meta.url));c=b7()});import{readFileSync as y7}from"fs";import{resolve as v7,dirname as g7}from"path";import{fileURLToPath as m7}from"url";function T1(){if(r!==null)return r;let K="7.12.0";if(typeof K==="string"&&K.length>0)return r=K,r;try{let $=g7(m7(import.meta.url)),Q=y1($);r=y7(v7(Q,"VERSION"),"utf-8").trim()}catch{r="unknown"}return r}var r=null;var g1=E(()=>{g()});var V0={};v(V0,{runOrThrow:()=>f7,run:()=>N,commandVersion:()=>p7,commandExists:()=>y,ShellError:()=>m1});async function N(K,$={}){let Q=Bun.spawn({cmd:[...K],stdout:"pipe",stderr:"pipe",env:$.env?{...process.env,...$.env}:process.env,cwd:$.cwd}),X,Z;if($.timeoutMs&&$.timeoutMs>0)X=setTimeout(()=>{try{Q.kill("SIGTERM")}catch{}Z=setTimeout(()=>{try{Q.kill("SIGKILL")}catch{}},2000)},$.timeoutMs);try{let[z,H,U]=await Promise.all([new Response(Q.stdout).text(),new Response(Q.stderr).text(),Q.exited]);return{stdout:z,stderr:H,exitCode:U}}finally{if(X)clearTimeout(X);if(Z)clearTimeout(Z)}}async function f7(K,$={}){let Q=await N(K,$);if(Q.exitCode!==0)throw new m1(`command failed (${Q.exitCode}): ${K.join(" ")}`,Q.exitCode,Q.stdout,Q.stderr);return Q}async function y(K){let $=u7(K),Q=await N(["sh","-c",`command -v ${$}`],{timeoutMs:5000});if(Q.exitCode===0)return Q.stdout.trim()||null;return null}function u7(K){if(!/^[A-Za-z0-9._/-]+$/.test(K))throw Error(`refused to shell-escape suspect token: ${K}`);return K}async function p7(K,$="--version"){if(!await y(K))return null;let X=await N([K,$],{timeoutMs:5000});if(X.exitCode!==0)return null;return((X.stdout||X.stderr).split(/\r?\n/)[0]?.trim()??"")||null}var m1;var l=E(()=>{m1=class m1 extends Error{message;exitCode;stdout;stderr;constructor(K,$,Q,X){super(K);this.message=K;this.exitCode=$;this.stdout=Q;this.stderr=X;this.name="ShellError"}}});function d(K){return c7?"":K}var c7,A,h,x,u6,_,k,D,V;var o=E(()=>{c7=(process.env.NO_COLOR??"").length>0;A=d("\x1B[0;31m"),h=d("\x1B[0;32m"),x=d("\x1B[1;33m"),u6=d("\x1B[0;34m"),_=d("\x1B[0;36m"),k=d("\x1B[1m"),D=d("\x1B[2m"),V=d("\x1B[0m")});import{existsSync as e7}from"fs";async function Q1(){if(U1!==void 0)return U1;let K="/opt/homebrew/bin/python3.12";if(e7(K))return U1=K,K;let $=await y("python3.12");if($)return U1=$,$;let Q=await y("python3");return U1=Q,Q}async function t(K,$={}){let Q=await Q1();if(!Q)return{stdout:"",stderr:"python3 not found",exitCode:127};return N([Q,"-c",K],$)}var U1;var q1=E(()=>{l()});var A0={};v(A0,{runStatus:()=>B5});import{existsSync as C,readFileSync as Z1,readdirSync as G0,statSync as B0}from"fs";import{resolve as S,basename as Z5}from"path";import{homedir as z5}from"os";async function V5(){if(await y("jq"))return!0;return process.stdout.write(`${A}Error: jq is required but not installed.${V}
 `),process.stdout.write(`Install with:
 `),process.stdout.write(`  brew install jq    (macOS)
 `),process.stdout.write(`  apt install jq     (Debian/Ubuntu)
@@ -667,4 +667,4 @@ Set LOKI_LEGACY_BASH=1 to force the bash CLI for every command.
 `),2}default:return process.stderr.write(`Unknown command: ${$}
 `),process.stderr.write(S7),2}}process.on("SIGINT",()=>process.exit(130));process.on("SIGTERM",()=>process.exit(143));var R6=await x6(Bun.argv.slice(2));process.exit(R6);
 
-//# debugId=27611F09F626D9E564756E2164756E21
+//# debugId=255812AF20A1A7F564756E2164756E21

package/mcp/__init__.py

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "7.11.0",
+  "version": "7.12.0",
   "description": "Loki Mode by Autonomi. Autonomous spec-to-product system: takes a PRD, GitHub issue, OpenAPI/JSON/YAML, or one-line brief to a deployed app via the RARV-C closure loop with 11 quality gates. Provider-agnostic (Claude Code, OpenAI Codex, Cline, Aider).",
   "keywords": [
     "agent",