fix(docs): update docs

Statistics: 5 files changed, 230 insertions, 140 deletions

Summary:
- Dirs: .=2, src=2, tests=1
- Exts: .py=3, .md=1, .lock=1
- A/M/D: 0/5/0
- Symbols: _find_blocking_tickets, _promote_blocking_to_critical, _build_ticket_args, _extract_error_from_stderr, _try_fallback_ticket_list

Modified files:
- README.md (+4/-4)
- src/koru/autonomous.py (+16/-1)
- src/koru/context.py (+207/-134)
- tests/test_autonomous.py (+2/-0)
- uv.lock (+1/-1)

Changes (notes):
- README.md (+4/-4): update documentation
- src/koru/autonomous.py (+16/-1): update
- src/koru/context.py (+207/-134): add functions: _auto_promote_blocking_tickets, _build_ticket_args, _extract_error_from_stderr, _find_blocking_tickets
- tests/test_autonomous.py (+2/-0): update
- uv.lock (+1/-1): update

Implementation notes (heuristics):
- Type inferred from file paths + diff keywords + add/delete ratio
- Scope prefers 'goal' when goal/* is touched; otherwise based on top-level dirs
- For <=6 files: generate short per-file notes from added lines (defs/classes/click options/headings)
- A/M/D derived from git name-status; per-file +X/-X from git numstat

Author: tom-sapletta-com

CHANGELOG.md

@@ -74,6 +74,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   `quality:regix` ↔ `gate:regix`, `quality:redup*` ↔ `gate:redup`,
   `quality:sumr:*` ↔ `gate:sumr`.
 
+## [0.1.62] - 2026-05-12
+
+### Docs
+- Update README.md
+
+### Test
+- Update tests/test_autonomous.py
+
+### Other
+- Update uv.lock
+
 ## [0.1.61] - 2026-05-12
 
 ### Docs

README.md

@@ -4,11 +4,11 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.61-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$3.34-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-27.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.62-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$3.35-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-28.4h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $3.3440 (85 commits)
-- 👤 **Human dev:** ~$2795 (27.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $3.3518 (86 commits)
+- 👤 **Human dev:** ~$2845 (28.4h @ $100/h, 30min dedup)
 
 Generated on 2026-05-12 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 

VERSION

@@ -1 +1 @@
-0.1.61
+0.1.62

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "koru"
-version = "0.1.61"
+version = "0.1.62"
 description = "Closed-loop automation across semcod/* repositories."
 readme = "README.md"
 requires-python = ">=3.12"

src/koru/autonomous.py

@@ -269,7 +269,22 @@ def _run_cycle(
     autopilot_status = "skipped"
     if enable_autopilot and client is not None:
         if queue_result.last_status in _AUTOPILOT_BLOCKED_QUEUE_STATUSES:
-            print(f"  autopilot: skipped (queue_status={queue_result.last_status})")
+            # Queue needs human/LLM attention — drive the actual ticket
+            # content instead of the generic drive_prompt so the IDE's LLM
+            # knows exactly what to work on.
+            ticket_prompt = queue_result.last_message.strip() if queue_result.last_message else ""
+            if ticket_prompt:
+                reply = client.drive(ticket_prompt, submit=submit, ide=autopilot_ide)
+                ok = bool(reply.get("ok", True))
+                autopilot_status = "ok" if ok else "failed"
+                if ok:
+                    backend = reply.get("backend", "?")
+                    print(f"  autopilot: ok (ticket={queue_result.ticket_id}, ide={autopilot_ide}, backend={backend})")
+                else:
+                    message = reply.get("message", "unknown error")
+                    print(f"  autopilot: failed ({message})")
+            else:
+                print(f"  autopilot: skipped (queue_status={queue_result.last_status}, empty message)")
         else:
             reply = client.drive(drive_prompt, submit=submit, ide=autopilot_ide)
             ok = bool(reply.get("ok", True))