okstra 0.103.0 → 0.104.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.103.0",
+  "version": "0.104.0",
   "description": "Multi-agent cross-verification orchestrator runtime + Claude Code skills.",
   "license": "MIT",
   "author": "devonshin",

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.103.0",
-  "builtAt": "2026-06-27T12:06:27.647Z",
+  "package": "0.104.0",
+  "builtAt": "2026-06-27T12:43:11.068Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/runtime/python/okstra_ctl/manager_launch.py

@@ -4,17 +4,22 @@ from __future__ import annotations
 from pathlib import Path
 from typing import Mapping
 
-from okstra_ctl.jsonl import read_jsonl
+from okstra_ctl.jsonl import append_jsonl, read_jsonl
 
 from .manager_paths import (
     child_context_path,
     children_json_path,
     directives_jsonl_path,
+    events_jsonl_path,
     projects_json_path,
     snapshots_json_path,
     task_manifest_path,
 )
-from .manager_store import ManagerError, _now_iso, _read_json, _read_json_default
+from .manager_store import ManagerError, _now_iso, _read_json, _read_json_default, _write_json
+
+
+WORKER_DISPATCH_BACKEND = "subagent"
+LAUNCH_STATUS_PREPARED = "prepared"
 
 
 def select_child_lead_backend(env: Mapping[str, str]) -> str:
@@ -135,6 +140,47 @@ def _render_context(
     return "\n".join(lines)
 
 
+def _record_launch_prepared(
+    *,
+    home: Path,
+    manager_id: str,
+    task_group: str,
+    task_id: str,
+    children: dict,
+    child: dict,
+    packet: dict,
+    created_at: str,
+) -> None:
+    launch = child.get("launch")
+    if not isinstance(launch, dict):
+        launch = {}
+    launch.update(
+        {
+            "status": LAUNCH_STATUS_PREPARED,
+            "childLeadBackend": packet["backend"],
+            "workerDispatchBackend": WORKER_DISPATCH_BACKEND,
+            "taskKey": packet["taskKey"],
+            "contextPath": packet["contextPath"],
+            "preparedAt": created_at,
+        }
+    )
+    child["launch"] = launch
+    _write_json(children_json_path(home, manager_id, task_group, task_id), children)
+    append_jsonl(
+        events_jsonl_path(home, manager_id, task_group, task_id),
+        {
+            "event": "child-launch-prepared",
+            "createdAt": created_at,
+            "projectId": packet["projectId"],
+            "taskKey": packet["taskKey"],
+            "backend": packet["backend"],
+            "workerDispatchBackend": WORKER_DISPATCH_BACKEND,
+            "contextPath": packet["contextPath"],
+            "runArgs": packet["runArgs"],
+        },
+    )
+
+
 def build_launch_packet(
     home: Path,
     manager_id: str,
@@ -159,6 +205,7 @@ def build_launch_packet(
     _validate_child_task_key(child, target_task_key)
     project_root = _validated_project_root(project)
     backend = select_child_lead_backend(env or {})
+    created_at = now or _now_iso()
     context_path = child_context_path(home, manager_id, task_group, task_id, project_id, child_task_id_value)
     context_path.parent.mkdir(parents=True, exist_ok=True)
     context_path.write_text(
@@ -171,14 +218,14 @@ def build_launch_packet(
         ),
         encoding="utf-8",
     )
-    return {
+    packet = {
         "managerId": manager_id,
         "taskGroup": task_group,
         "taskId": task_id,
         "projectId": project_id,
         "taskKey": target_task_key,
         "backend": backend,
-        "workerDispatchBackend": "subagent",
+        "workerDispatchBackend": WORKER_DISPATCH_BACKEND,
         "projectRoot": project_root,
         "contextPath": str(context_path),
         "runArgs": [
@@ -194,5 +241,16 @@ def build_launch_packet(
             "--directive",
             f"Read manager child context: {context_path}",
         ],
-        "createdAt": now or _now_iso(),
+        "createdAt": created_at,
     }
+    _record_launch_prepared(
+        home=home,
+        manager_id=manager_id,
+        task_group=task_group,
+        task_id=task_id,
+        children=children,
+        child=child,
+        packet=packet,
+        created_at=created_at,
+    )
+    return packet

package/runtime/python/okstra_ctl/manager_paths.py

@@ -1,6 +1,7 @@
 """Pure path computation for okstra manager state."""
 from __future__ import annotations
 
+import hashlib
 from pathlib import Path
 import os
 
@@ -21,9 +22,11 @@ def _require_id(value: str, label: str) -> str:
 
 
 def _slug_segment(value: str, label: str) -> str:
-    segment = slugify(_require_id(value, label))
+    cleaned = _require_id(value, label)
+    segment = slugify(cleaned)
     if not segment:
-        raise ManagerPathError(f"{label} must contain at least one ASCII alphanumeric character")
+        digest = hashlib.sha1(cleaned.encode("utf-8")).hexdigest()[:12]
+        return f"u-{digest}"
     return segment
 
 
@@ -93,6 +96,6 @@ def child_context_path(
     project_id: str,
     child_task_id: str,
 ) -> Path:
-    safe_project = slugify(_require_id(project_id, "project-id"))
-    safe_task = slugify(_require_id(child_task_id, "task-id"))
+    safe_project = _slug_segment(project_id, "project-id")
+    safe_task = _slug_segment(child_task_id, "task-id")
     return task_root(home, manager_id, task_group, task_id) / "child-context" / f"{safe_project}-{safe_task}.md"

package/runtime/python/okstra_ctl/manager_store.py

@@ -126,9 +126,11 @@ def link_project(
     role: str,
     tags: list[str],
     now: str | None = None,
-) -> dict:
+    ) -> dict:
     load_manager(home, manager_id)
     root = Path(project_root).resolve()
+    if not root.is_dir():
+        raise ManagerError(f"projectRoot is not a directory: {root}")
     project_json = project_json_path(root)
     if project_json.is_file():
         try:

package/runtime/python/okstra_ctl/manager_sync.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 
 from pathlib import Path
 
-from okstra_project import TASKS_RELATIVE, parse_task_key, read_task_catalog, read_task_manifest, slugify
+from okstra_project import TASKS_RELATIVE, StateError, parse_task_key, read_task_catalog, read_task_manifest, slugify
 
 from .manager_paths import children_json_path, projects_json_path, snapshots_json_path, task_manifest_path
 from .manager_store import _now_iso, _read_json, _read_json_default, _write_json
@@ -52,9 +52,9 @@ def _resolve_task_root_read_only(project_root: Path, task_key: str) -> Path | No
     return None
 
 
-def _snapshot_child(project_root: Path, child: dict) -> dict:
+def _base_child_snapshot(child: dict) -> dict:
     task_key = str(child.get("taskKey") or "")
-    base = {
+    return {
         "projectId": str(child.get("projectId") or ""),
         "taskGroup": str(child.get("taskGroup") or ""),
         "taskId": str(child.get("taskId") or ""),
@@ -62,10 +62,18 @@ def _snapshot_child(project_root: Path, child: dict) -> dict:
         "exists": False,
         "taskRoot": "",
     }
-    task_dir = _resolve_task_root_read_only(project_root, task_key)
-    if task_dir is None:
-        return base
-    manifest = read_task_manifest(task_dir) or {}
+
+
+def _snapshot_child(project_root: Path, child: dict) -> dict:
+    base = _base_child_snapshot(child)
+    task_key = base["taskKey"]
+    try:
+        task_dir = _resolve_task_root_read_only(project_root, task_key)
+        if task_dir is None:
+            return base
+        manifest = read_task_manifest(task_dir) or {}
+    except StateError as exc:
+        return {**base, "error": str(exc)}
     workflow = _workflow(manifest)
     outcome = _phase_outcome(manifest)
     return {