loki-mode 7.5.15 → 7.5.17

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes a spec (PRD, GitHub issue, OpenAPI doc, etc.) to deployed product with minimal human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v7.5.15
+# Loki Mode v7.5.17
 
 **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.5.15 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v7.5.17 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-7.5.15
+7.5.17

package/autonomy/completion-council.sh

@@ -470,12 +470,174 @@ with open(state_file, 'w') as f:
         "threshold=$effective_threshold" \
         "result=$([ $approve_count -ge $effective_threshold ] && echo 'APPROVED' || echo 'REJECTED')" 2>/dev/null || true
 
+    # Write transcript for this council round (Path A: council_vote path)
+    local _ct_outcome
+    _ct_outcome=$([ $approve_count -ge $effective_threshold ] && echo "APPROVED" || echo "REJECTED")
+    local _ct_triggered="false"
+    local _ct_flipped="false"
+    if [ $approve_count -eq $COUNCIL_SIZE ] && [ $COUNCIL_SIZE -ge 2 ]; then
+        _ct_triggered="true"
+    fi
+    # contrarian_flipped: DA voted REJECT/CANNOT_VALIDATE causing approve_count drop
+    # Detect by checking if approve dropped from unanimous (COUNCIL_SIZE) to less
+    # We infer flip if triggered AND final approve < COUNCIL_SIZE
+    if [ "$_ct_triggered" = "true" ] && [ $approve_count -lt $COUNCIL_SIZE ]; then
+        _ct_flipped="true"
+    fi
+    council_write_transcript "${ITERATION_COUNT:-0}" "$_ct_outcome" "$_ct_triggered" "$_ct_flipped" "$effective_threshold"
+
     if [ $approve_count -ge $effective_threshold ]; then
         return 0  # Council says DONE
     fi
     return 1  # Council says CONTINUE
 }
 
+#===============================================================================
+# Council Transcript Writer - persists per-iteration council round as JSON
+#
+# Arguments:
+#   $1 - iteration number
+#   $2 - outcome: APPROVED | REJECTED | BLOCKED_BY_GATE
+#   $3 - contrarian_triggered: true | false
+#   $4 - contrarian_flipped: true | false
+#   $5 - effective_threshold: votes needed for approval (0 = unknown/sentinel)
+#
+# Output: .loki/council/transcripts/iter-<N>-<TIMESTAMP>.json
+#===============================================================================
+
+council_write_transcript() {
+    local iteration="${1:-${ITERATION_COUNT:-0}}"
+    local outcome="${2:-REJECTED}"
+    local contrarian_triggered="${3:-false}"
+    local contrarian_flipped="${4:-false}"
+    local effective_threshold="${5:-0}"
+    local timestamp
+    timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    # Remove colons and hyphens from timestamp for filename safety
+    local ts_safe="${timestamp//[:\-]/}"
+    local iteration_id="iter-${iteration}-${ts_safe}"
+    local transcript_dir="$COUNCIL_STATE_DIR/transcripts"
+    mkdir -p "$transcript_dir"
+    local transcript_file="$transcript_dir/${iteration_id}.json"
+
+    # Read prd preview from state or prd file
+    local task_or_prd=""
+    if [ -n "$COUNCIL_PRD_PATH" ] && [ -f "$COUNCIL_PRD_PATH" ]; then
+        task_or_prd=$(head -5 "$COUNCIL_PRD_PATH" | tr '\n' ' ' | cut -c1-200)
+    fi
+
+    local round_file="$COUNCIL_STATE_DIR/votes/round-${iteration}.json"
+    local da_file="$COUNCIL_STATE_DIR/votes/devils-advocate-round-${iteration}.json"
+
+    _IT="$iteration" _TS="$timestamp" _IID="$iteration_id" \
+    _OUTCOME="$outcome" _CT="$contrarian_triggered" _CF="$contrarian_flipped" \
+    _TASK="$task_or_prd" _PRD="${COUNCIL_PRD_PATH:-}" \
+    _ROUND_FILE="${round_file}" _DA_FILE="${da_file}" \
+    _MEMBERS_DIR="$COUNCIL_STATE_DIR/votes/iteration-${iteration}" \
+    _THRESHOLD="$effective_threshold" \
+    _OUT="$transcript_file" \
+    python3 -c "
+import json, os, pathlib, re
+
+iteration_id = os.environ['_IID']
+voters = []
+
+# Priority 1: structured round file (Path B -- council_aggregate_votes)
+rfile = pathlib.Path(os.environ['_ROUND_FILE'])
+if rfile.exists():
+    try:
+        rd = json.loads(rfile.read_text())
+        for v in rd.get('votes', []):
+            voters.append({
+                'name': v.get('role', 'unknown'),
+                'role_index': v.get('member', 0),
+                'verdict': 'APPROVE' if v.get('vote') == 'COMPLETE' else 'REJECT',
+                'reasoning': v.get('reason', ''),
+                'issues': [],
+                'is_contrarian': False,
+            })
+    except Exception:
+        pass
+
+# Priority 2: member txt files (Path A -- council_vote)
+if not voters:
+    mdir = pathlib.Path(os.environ['_MEMBERS_DIR'])
+    roles = ['requirements_verifier', 'test_auditor', 'devils_advocate']
+    if mdir.exists():
+        for mf in sorted(mdir.glob('member-*.txt')):
+            content = mf.read_text(errors='replace').strip()
+            vote_match = re.search(r'VOTE\s*:\s*(APPROVE|REJECT|CANNOT_VALIDATE)', content)
+            reason_match = re.search(r'REASON\s*:\s*(.+?)(?:\n|\$)', content)
+            issues = []
+            for im in re.finditer(r'ISSUES\s*:\s*(CRITICAL|HIGH|MEDIUM|LOW)\s*:\s*(.+?)(?:\n|\$)', content):
+                issues.append({'severity': im.group(1), 'description': im.group(2).strip()})
+            idx = int(re.sub(r'\D', '', mf.stem) or '0') - 1
+            role = roles[idx % len(roles)] if idx >= 0 else 'unknown'
+            voters.append({
+                'name': role,
+                'role_index': idx + 1,
+                'verdict': vote_match.group(1) if vote_match else 'REJECT',
+                'reasoning': reason_match.group(1).strip() if reason_match else '',
+                'issues': issues,
+                'is_contrarian': False,
+            })
+
+# Add DA voter if triggered
+ct = os.environ['_CT'] == 'true'
+cf = os.environ['_CF'] == 'true'
+if ct:
+    da_challenges = []
+    dafile = pathlib.Path(os.environ['_DA_FILE'])
+    if dafile.exists():
+        try:
+            da = json.loads(dafile.read_text())
+            details = da.get('details', '')
+            if details and details != 'none':
+                da_challenges = [d.strip() for d in details.split(';') if d.strip()]
+        except Exception:
+            pass
+    # Also check contrarian.txt for reasoning
+    cfile = pathlib.Path(os.environ['_MEMBERS_DIR']) / 'contrarian.txt'
+    da_reasoning = ''
+    da_verdict = 'REJECT' if cf else 'APPROVE'
+    if cfile.exists():
+        content = cfile.read_text(errors='replace').strip()
+        reason_match = re.search(r'REASON\s*:\s*(.+?)(?:\n|\$)', content)
+        if reason_match:
+            da_reasoning = reason_match.group(1).strip()
+    voters.append({
+        'name': 'devils_advocate',
+        'role_index': len(voters) + 1,
+        'verdict': da_verdict,
+        'reasoning': da_reasoning,
+        'issues': [],
+        'challenges': da_challenges,
+        'is_contrarian': True,
+        'triggered': True,
+    })
+
+task_or_prd = os.environ.get('_TASK', '')[:200]
+non_contrarian = [v for v in voters if not v.get('is_contrarian')]
+transcript = {
+    'iteration_id': iteration_id,
+    'iteration': int(os.environ['_IT']),
+    'timestamp': os.environ['_TS'],
+    'task_or_prd': task_or_prd,
+    'prd_path': os.environ.get('_PRD', ''),
+    'voters': voters,
+    'outcome': os.environ['_OUTCOME'],
+    'contrarian_triggered': ct,
+    'contrarian_flipped': cf,
+    'approve_count': sum(1 for v in non_contrarian if v.get('verdict') == 'APPROVE'),
+    'reject_count': sum(1 for v in non_contrarian if v.get('verdict') in ('REJECT', 'CANNOT_VALIDATE')),
+    'threshold': int(os.environ.get('_THRESHOLD', '0')),
+    'total_members': len(non_contrarian),
+}
+with open(os.environ['_OUT'], 'w') as f:
+    json.dump(transcript, f, indent=2)
+" || log_warn "Failed to write council transcript"
+}
+
 #===============================================================================
 # Evidence Gathering - Collect data for council review
 #===============================================================================
@@ -1353,6 +1515,9 @@ council_evaluate() {
         return 1  # CONTINUE - can't complete with critical failures
     fi
 
+    # Compute threshold using the same ceiling(2/3) formula as council_vote and council_aggregate_votes
+    local _eval_threshold=$(( (COUNCIL_SIZE * 2 + 2) / 3 ))
+
     # Step 1: Aggregate votes from all members
     local aggregate_result
     aggregate_result=$(council_aggregate_votes)
@@ -1372,14 +1537,23 @@ council_evaluate() {
             da_result=$(council_devils_advocate_review "$ITERATION_COUNT")
             if [ "$da_result" = "OVERRIDE_CONTINUE" ]; then
                 log_warn "Council evaluate: devil's advocate overrode unanimous COMPLETE"
+                # Write transcript: DA triggered and flipped the outcome (Path B)
+                council_write_transcript "${ITERATION_COUNT:-0}" "REJECTED" "true" "true" "$_eval_threshold"
                 return 1  # CONTINUE
             fi
+            # Write transcript: DA triggered but did NOT flip (Path B, unanimous COMPLETE confirmed)
+            council_write_transcript "${ITERATION_COUNT:-0}" "APPROVED" "true" "false" "$_eval_threshold"
+        else
+            # Write transcript: not unanimous, DA not triggered (Path B)
+            council_write_transcript "${ITERATION_COUNT:-0}" "APPROVED" "false" "false" "$_eval_threshold"
         fi
 
         log_info "Council evaluate: verdict is COMPLETE"
         return 0  # COMPLETE (should stop)
     fi
 
+    # Write transcript: aggregate voted CONTINUE (Path B)
+    council_write_transcript "${ITERATION_COUNT:-0}" "REJECTED" "false" "false" "$_eval_threshold"
     log_info "Council evaluate: verdict is CONTINUE"
     return 1  # CONTINUE
 }

package/autonomy/loki

@@ -7052,9 +7052,10 @@ cmd_sentrux() {
     case "$sub" in
         baseline)
             if ! sentrux_available; then
-                echo -e "${YELLOW}sentrux not installed.${NC} Install via:" >&2
+                echo -e "${YELLOW}sentrux not installed.${NC} Install with one of:" >&2
                 echo "  brew install sentrux/tap/sentrux" >&2
-                echo "  or download from https://github.com/sentrux/sentrux/releases" >&2
+                echo "  curl -fsSL https://raw.githubusercontent.com/sentrux/sentrux/main/install.sh | sh" >&2
+                echo "  See also: https://github.com/sentrux/sentrux" >&2
                 return 2
             fi
             if sentrux_baseline_save "$target"; then
@@ -7068,7 +7069,10 @@ cmd_sentrux() {
             ;;
         gate)
             if ! sentrux_available; then
-                echo -e "${YELLOW}sentrux not installed.${NC} Run 'loki sentrux baseline' for setup hints." >&2
+                echo -e "${YELLOW}sentrux not installed.${NC} Install with one of:" >&2
+                echo "  brew install sentrux/tap/sentrux" >&2
+                echo "  curl -fsSL https://raw.githubusercontent.com/sentrux/sentrux/main/install.sh | sh" >&2
+                echo "  See also: https://github.com/sentrux/sentrux" >&2
                 return 2
             fi
             local diff verdict before after
@@ -7097,7 +7101,10 @@ cmd_sentrux() {
         status)
             if ! sentrux_available; then
                 echo "sentrux: not installed (optional)"
-                echo "install: brew install sentrux/tap/sentrux"
+                echo "install with one of:"
+                echo "  brew install sentrux/tap/sentrux"
+                echo "  curl -fsSL https://raw.githubusercontent.com/sentrux/sentrux/main/install.sh | sh"
+                echo "  See also: https://github.com/sentrux/sentrux"
                 return 0
             fi
             local v

package/dashboard/__init__.py

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

package/dashboard/server.py

@@ -3782,6 +3782,93 @@ async def force_council_review():
     return {"success": True, "message": "Council review requested"}
 
 
+@app.get("/api/council/transcripts")
+async def get_council_transcripts(
+    limit: int = Query(default=20, ge=1, le=200),
+    since: Optional[str] = Query(default=None),
+    iter_min: Optional[int] = Query(default=None, ge=0),
+):
+    """List council transcript records, sorted descending by iteration number.
+
+    Query params:
+      limit    int, default=20, max=200
+      since    ISO8601 string (optional), filter to transcripts after this time
+      iter_min int (optional), filter to iteration >= N
+    """
+    # Validate query params before any early-return so invalid inputs always get 400.
+    since_dt = None
+    if since:
+        try:
+            since_dt = datetime.fromisoformat(since.replace("Z", "+00:00"))
+        except ValueError:
+            raise HTTPException(status_code=400, detail="Invalid 'since' timestamp format; expected ISO8601")
+
+    transcripts_dir = _get_loki_dir() / "council" / "transcripts"
+    if not transcripts_dir.exists():
+        return {"transcripts": [], "total": 0, "latest_id": None}
+
+    records = []
+    for f in sorted(transcripts_dir.glob("iter-*.json"), reverse=True):
+        try:
+            rec = json.loads(f.read_text())
+        except Exception:
+            logger.warning("Skipping corrupt council transcript file: %s", f.name)
+            continue
+        if not isinstance(rec, dict):
+            logger.warning("Skipping non-object council transcript file: %s", f.name)
+            continue
+        if not isinstance(rec.get("iteration_id"), str):
+            logger.warning("Skipping transcript missing iteration_id field: %s", f.name)
+            continue
+        if since_dt is not None:
+            ts_str = rec.get("timestamp", "")
+            try:
+                ts = datetime.fromisoformat(ts_str.replace("Z", "+00:00"))
+            except (ValueError, AttributeError):
+                continue
+            if ts <= since_dt:
+                continue
+        if iter_min is not None and rec.get("iteration", 0) < iter_min:
+            continue
+        records.append(rec)
+        if len(records) >= limit:
+            break
+
+    return {
+        "transcripts": records,
+        "total": len(records),
+        "latest_id": records[0].get("iteration_id") if records else None,
+    }
+
+
+@app.get("/api/council/transcripts/{iteration_id}")
+async def get_council_transcript(iteration_id: str):
+    """Fetch a single council transcript by iteration_id.
+
+    Returns the record body or 404 if not found.
+    Path traversal attempts (containing '/' or '..') are rejected with 404.
+    """
+    # Reject path traversal: iteration_id must be a plain filename component.
+    if "/" in iteration_id or "\\" in iteration_id or ".." in iteration_id:
+        raise HTTPException(status_code=404, detail="Transcript not found")
+    transcript_file = _get_loki_dir() / "council" / "transcripts" / f"{iteration_id}.json"
+    if not transcript_file.exists():
+        raise HTTPException(status_code=404, detail="Transcript not found")
+    try:
+        rec = json.loads(transcript_file.read_text())
+    except Exception:
+        raise HTTPException(
+            status_code=410,
+            detail=f"Transcript file for {iteration_id} is corrupt; admin should inspect or remove it",
+        )
+    if not isinstance(rec, dict):
+        raise HTTPException(
+            status_code=410,
+            detail=f"Transcript file for {iteration_id} is corrupt; admin should inspect or remove it",
+        )
+    return rec
+
+
 # =============================================================================
 # Context Window Tracking API (v5.40.0)
 # =============================================================================