loki-mode 11.10.1 → 11.15.0

package/autonomy/quickstart.sh

@@ -181,6 +181,9 @@ _qs_score_templates() {
     # can tell a genuine match from simple-todo-app winning by default.
     local best_mode=false
     [ "${2:-}" = "--best" ] && best_mode=true
+    # --scores: print "name<TAB>score" for the top 3 (used by --explain-match).
+    local scores_mode=false
+    [ "${2:-}" = "--scores" ] && scores_mode=true
     local tdir; tdir="$(_qs_templates_dir)"
     local brief_lc; brief_lc=$(printf '%s' "$brief" | tr '[:upper:]' '[:lower:]')
 
@@ -263,6 +266,8 @@ _qs_score_templates() {
     ' | sort -t"$(printf '\t')" -k1,1nr -k2,2n -k3,3 | {
         if [ "$best_mode" = true ]; then
             head -1 | cut -f1 | awk '{ print ($1 == "" ? 0 : $1) }'
+        elif [ "$scores_mode" = true ]; then
+            head -3 | awk -F'\t' '{ printf "%s\t%s\n", $3, $1 }'
         else
             head -3 | cut -f3
         fi
@@ -276,6 +281,27 @@ _qs_match_strength() {
     _qs_score_templates "$1" --best
 }
 
+# _qs_explain_match <brief>: print the top 3 template scores and a confidence
+# label. Reuses the scorer; offline and read-only.
+_qs_explain_match() {
+    local brief="$1" strength rank=1 name score
+    strength="$(_qs_match_strength "$brief")"
+    case "$strength" in ''|*[!0-9]*) strength=0;; esac
+    printf '\n  Template match scores:\n'
+    while IFS=$'\t' read -r name score; do
+        [ -n "$name" ] || continue
+        printf '  %d. %s score %s\n' "$rank" "$name" "$score"
+        rank=$((rank + 1))
+    done < <(_qs_score_templates "$brief" --scores)
+    if [ "$strength" -ge 4 ]; then
+        printf '  Match confidence: high (strength %s)\n' "$strength"
+    elif [ "$strength" -ge 2 ]; then
+        printf '  Match confidence: medium (strength %s)\n' "$strength"
+    else
+        printf '  Match confidence: low (strength %s): no strong match, using a plain spec\n' "$strength"
+    fi
+}
+
 # _qs_template_summary <name>: a short one-line description for the picker.
 # Read from the template's first prose line would be fragile; use a small
 # curated table so the picker copy is stable and honest.
@@ -919,6 +945,7 @@ _qs_help() {
     printf '  --yes, -y     Auto-confirm the final build prompt (still shows the plan)\n'
     printf '  --dry-run     Preview the selected template and plan; write/start nothing\n'
     printf '  --json        Emit machine-readable output for a read-only command\n'
+    printf '  --explain-match  With --dry-run, show the top 3 template scores and match confidence\n'
     printf '  --from-preview F  Continue saved JSON from file F (or - for piped stdin); requires --yes\n'
     printf '  --verify-preview F  Verify saved JSON from file F (or - for piped stdin); executes nothing\n'
     printf '  --template N  Use the exact shipped template N for an IDEA\n'
@@ -986,6 +1013,7 @@ cmd_quickstart() {
     local template_flag_seen=false
     local list_templates=false
     local list_templates_flag_seen=false
+    local explain_match=false
     local from_preview=""
     local from_preview_flag_seen=false
     local verify_preview=""
@@ -1023,6 +1051,10 @@ cmd_quickstart() {
                 json_output=true
                 shift
                 ;;
+            --explain-match)
+                explain_match=true
+                shift
+                ;;
             --template)
                 if [ "$template_flag_seen" = true ]; then
                     printf '%s--template may be specified only once.%s\n' "$_QS_RED" "$_QS_NC" >&2
@@ -1168,6 +1200,11 @@ cmd_quickstart() {
         exit 2
     fi
 
+    if [ "$explain_match" = true ] && { [ "$dry_run" != true ] || [ "$json_output" = true ]; }; then
+        printf '%s--explain-match requires --dry-run and cannot be combined with --json.%s\n' "$_QS_RED" "$_QS_NC" >&2
+        exit 2
+    fi
+
     if [ "$json_output" = true ] && [ "$dry_run" != true ]; then
         printf '%s--json requires --dry-run.%s\n' "$_QS_RED" "$_QS_NC" >&2
         exit 2
@@ -1257,6 +1294,9 @@ cmd_quickstart() {
     printf '\n'
     if [ "$dry_run" = true ]; then
         printf '%sLoki Mode quickstart preview -- template and plan only.%s\n' "$_QS_BOLD" "$_QS_NC"
+        if [ "$explain_match" = true ]; then
+            _qs_explain_match "$positional"
+        fi
     else
         printf '%sLoki Mode quickstart -- four quick questions, then your build starts.%s\n' "$_QS_BOLD" "$_QS_NC"
     fi

package/autonomy/run.sh

@@ -28292,6 +28292,41 @@ check_human_intervention() {
 }
 
 # Handle pause state - wait for resume
+# Writes .loki/state/interventions.json. Mirrors loki-ts/src/runner/intervention.ts
+# (count, basis, by_type enum counts, waited_s). Modes: "count" bumps count and
+# the by_type bucket inferred from the signal files; "waited <secs>" adds
+# wall-clock blocked seconds (an upper bound on human attention, not active
+# minutes). Best-effort: never fails a run.
+_loki_iv_record() {
+    local loki_dir="$1" mode="$2" secs="${3:-0}" iv_type="authorization"
+    [ -n "$loki_dir" ] || return 0
+    if [ -e "$loki_dir/HUMAN_INPUT.md" ]; then iv_type="input"
+    elif [ -e "$loki_dir/signals/GATE_ESCALATION" ] || [ -e "$loki_dir/signals/COUNCIL_REVIEW_REQUESTED" ]; then iv_type="repair"
+    elif [ -e "$loki_dir/signals/BUDGET_EXCEEDED" ]; then iv_type="steer"
+    fi
+    mkdir -p "$loki_dir/state" 2>/dev/null || true
+    python3 -I -c 'import json,sys
+p,mode,secs,t=sys.argv[1:5]
+def n(v):
+    return v if isinstance(v,int) and not isinstance(v,bool) and v>=0 else 0
+try:
+    d=json.load(open(p))
+    if not isinstance(d,dict): d={}
+except Exception:
+    d={}
+if mode=="waited" and not d:
+    sys.exit(0)
+bt=d.get("by_type") if isinstance(d.get("by_type"),dict) else {}
+out={k:n(bt.get(k)) for k in ("steer","input","authorization","repair")}
+if mode=="count":
+    out[t]+=1
+    d["count"]=n(d.get("count"))+1
+d["basis"]="blocking pauses that waited on a human"
+d["by_type"]=out
+d["waited_s"]=n(d.get("waited_s"))+(int(secs) if mode=="waited" else 0)
+open(p,"w").write(json.dumps(d)+"\n")' "$loki_dir/state/interventions.json" "$mode" "$secs" "$iv_type" 2>/dev/null || true
+}
+
 handle_pause() {
     # BUG-ST-007: Guard against concurrent pause handler execution
     if [ "${_PAUSE_IN_PROGRESS:-0}" -eq 1 ]; then
@@ -28312,21 +28347,8 @@ handle_pause() {
     #
     # proof-generator reads this; when the file is absent the receipt renders NO
     # interventions row rather than claiming zero. Best-effort: never fail a run.
-    if [ -n "${loki_dir}" ]; then
-        mkdir -p "$loki_dir/state" 2>/dev/null || true
-        local _iv_file="$loki_dir/state/interventions.json"
-        local _iv_prev=0
-        if [ -f "$_iv_file" ]; then
-            _iv_prev=$(python3 -c "import json,sys
-try:
-    v=json.load(open(sys.argv[1])).get('count')
-    print(int(v) if isinstance(v,int) and v>=0 else 0)
-except Exception:
-    print(0)" "$_iv_file" 2>/dev/null || echo 0)
-        fi
-        printf '{"count":%s,"basis":"blocking pauses that waited on a human"}\n' \
-            "$(( _iv_prev + 1 ))" > "$_iv_file" 2>/dev/null || true
-    fi
+    local _iv_t0=$SECONDS
+    _loki_iv_record "$loki_dir" count
 
     # Save state before pausing so it persists across potential crashes
     save_state ${RETRY_COUNT:-0} "paused" 0
@@ -28426,6 +28448,7 @@ except Exception:
         # Check for stop signal
         if [ -f "$loki_dir/STOP" ]; then
             rm -f "$loki_dir/STOP" "$loki_dir/PAUSED.md"
+            _loki_iv_record "$loki_dir" waited "$(( SECONDS - ${_iv_t0:-$SECONDS} ))" 2>/dev/null || true
             PAUSED=false
             _PAUSE_IN_PROGRESS=0
             return 1
@@ -28471,6 +28494,7 @@ except Exception:
     done
 
     rm -f "$loki_dir/PAUSED.md"
+    _loki_iv_record "$loki_dir" waited "$(( SECONDS - ${_iv_t0:-$SECONDS} ))" 2>/dev/null || true
     log_info "Resuming execution..."
     PAUSED=false
     _PAUSE_IN_PROGRESS=0