okstra 0.186.7 → 0.187.0

package/dist/commands/report/inject-report-index.mjs

@@ -1,21 +0,0 @@
-import { runInstalledScript } from "../../lib/python-helper.mjs";
-const USAGE = `okstra inject-report-index — add the top-of-report Index + scroll anchors to a report
-
-Wraps the python helper (\`okstra-inject-report-index.py\`) installed under
-\`~/.okstra/bin/\` so skills call \`okstra inject-report-index\` instead of
-emitting a \`python3 "$HOME/..."\` invocation (which breaks \`Bash(okstra:*)\`
-permission matching and prompts on every call).
-
-Usage:
-  okstra inject-report-index <markdown-path> [--report-language <en|ko>]
-
-All arguments are forwarded verbatim to the python helper.
-`;
-export async function run(args) {
-    return runInstalledScript({
-        scriptName: "okstra-inject-report-index.py",
-        args,
-        usage: USAGE,
-    });
-}
-//# sourceMappingURL=inject-report-index.mjs.map

package/dist/commands/report/inject-report-index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"inject-report-index.mjs","sourceRoot":"","sources":["../../../src/commands/report/inject-report-index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,KAAK,GAAG;;;;;;;;;;;CAWb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,OAAO,kBAAkB,CAAC;QACxB,UAAU,EAAE,+BAA+B;QAC3C,IAAI;QACJ,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/report/render-final-report.d.mts

@@ -1 +0,0 @@
-export declare function run(args: readonly string[]): Promise<number>;

package/dist/commands/report/render-final-report.mjs

@@ -1,23 +0,0 @@
-import { runInstalledScript } from "../../lib/python-helper.mjs";
-const USAGE = `okstra render-final-report — render the full reading copy sibling of final-report data.json
-
-Wraps the python helper (\`okstra-render-final-report.py\`) installed under
-\`~/.okstra/bin/\` so skills call \`okstra render-final-report\` instead of
-emitting a \`python3 "$HOME/..."\` invocation (which breaks \`Bash(okstra:*)\`
-permission matching and prompts on every call).
-
-Usage:
-  okstra render-final-report <path-to-final-report.data.json>
-
-The argument is forwarded verbatim to the Python helper. schemaVersion 1.0
-keeps the legacy Markdown template; schemaVersion 2.0 selects the full reading
-copy template. Human HTML is rendered separately from the same data.json.
-`;
-export async function run(args) {
-    return runInstalledScript({
-        scriptName: "okstra-render-final-report.py",
-        args,
-        usage: USAGE,
-    });
-}
-//# sourceMappingURL=render-final-report.mjs.map

package/dist/commands/report/render-final-report.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"render-final-report.mjs","sourceRoot":"","sources":["../../../src/commands/report/render-final-report.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,KAAK,GAAG;;;;;;;;;;;;;CAab,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,OAAO,kBAAkB,CAAC;QACxB,UAAU,EAAE,+BAA+B;QAC3C,IAAI;QACJ,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/report/render-views.d.mts

@@ -1 +0,0 @@
-export declare function run(args: readonly string[]): Promise<number>;

package/dist/commands/report/render-views.mjs

@@ -1,27 +0,0 @@
-import { runInstalledScript } from "../../lib/python-helper.mjs";
-const USAGE = `okstra render-views — render the self-contained HTML view of a final-report
-
-A thin spawn shim over \`scripts/okstra-render-report-views.py\` (installed
-at \`$HOME/.okstra/bin/okstra-render-report-views.py\`). Resolves the final-
-report data and Markdown pair, then writes a single sibling:
-
-  <stem>.html       — single-file self-contained human view; schema v2 is
-                       always generated, while v1/quick remains conditional
-
-Usage:
-  okstra render-views <path-to-final-report.data.json|path-to-final-report.md>
-      [--task-key <key>] [--task-type <type>] [--seq <NNN>]
-      [--source-report <project-relative-path>]
-
-Schema v2 data is rendered directly into its task-specific HTML view and is
-always generated. Schema v1 and quick reports keep the legacy conditional
-Markdown view. Optional flags override inferred report metadata.
-`;
-export async function run(args) {
-    return runInstalledScript({
-        scriptName: "okstra-render-report-views.py",
-        args,
-        usage: USAGE,
-    });
-}
-//# sourceMappingURL=render-views.mjs.map

package/dist/commands/report/render-views.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"render-views.mjs","sourceRoot":"","sources":["../../../src/commands/report/render-views.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;CAiBb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,OAAO,kBAAkB,CAAC;QACxB,UAAU,EAAE,+BAA+B;QAC3C,IAAI;QACJ,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/report/translate.d.mts

@@ -1 +0,0 @@
-export declare function run(args: readonly string[]): Promise<number>;

package/dist/commands/report/translate.mjs

@@ -1,33 +0,0 @@
-import { runInstalledScript } from "../../lib/python-helper.mjs";
-const USAGE = `okstra report-translate — build and verify a final-report translation sidecar
-
-A thin spawn shim over \`scripts/okstra-report-translate.py\` (installed at
-\`$HOME/.okstra/bin/okstra-report-translate.py\`).
-
-The final-report data.json is authored in English and stays the SSOT. When the
-resolved report language is not English, Phase 7 dispatches a translator that
-writes a sidecar beside the report; \`render-views\` overlays it so only the
-human HTML is localized.
-
-Usage:
-  okstra report-translate extract <path-to-final-report.data.json>
-  okstra report-translate source --run-manifest <path>
-  okstra report-translate write --run-manifest <path> --source-digest <sha256> --translations <markdown>
-  okstra report-translate check-data --run-manifest <path>
-      Write <stem>.translation-source.json — every pointer the report holds a
-      translatable string at, paired with its English text. The translator
-      fills in the values, so a sidecar cannot cite a path the report lacks.
-
-  okstra report-translate check <path-to-final-report.i18n.<lang>.json>
-      Resolve every pointer in a filled sidecar against the report it names
-      and report what is still English. Exits non-zero on a pointer that
-      resolves nowhere — the translator's own gate before it returns.
-`;
-export async function run(args) {
-    return runInstalledScript({
-        scriptName: "okstra-report-translate.py",
-        args,
-        usage: USAGE,
-    });
-}
-//# sourceMappingURL=translate.mjs.map

package/dist/commands/report/translate.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"translate.mjs","sourceRoot":"","sources":["../../../src/commands/report/translate.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,OAAO,kBAAkB,CAAC;QACxB,UAAU,EAAE,4BAA4B;QACxC,IAAI;QACJ,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}

package/runtime/bin/lib/okstra/tmux-pane.sh

@@ -1,40 +0,0 @@
-#!/usr/bin/env bash
-# Resolve the tmux pane that the CURRENT process actually runs in.
-#
-# Why this exists: Claude Code's Bash tool strips $TMUX and $TMUX_PANE, so a
-# bare `tmux display-message -p '#{pane_id}'` does NOT return the caller's pane
-# — it returns the pane of the most-recently-active tmux *client*, which (when
-# the user has several attached sessions) is frequently a DIFFERENT session
-# than the one the okstra run lives in. Earlier trace-pane fixes all trusted
-# `display-message` and therefore mis-placed (or dropped) the tail pane.
-#
-# This resolver instead walks the process's own ancestor PIDs and matches them
-# against the tmux server's pane_pids. That is deterministic and correct
-# regardless of $TMUX/$TMUX_PANE or which client is active: when the process is
-# a descendant of a tmux pane's shell it finds exactly that pane; when it is not
-# inside any tmux pane (e.g. Claude launched from the macOS GUI app) no ancestor
-# matches and the function prints nothing.
-#
-# Usage: pane="$(okstra_resolve_caller_pane)"   # empty => not in a tmux pane
-# Optional arg: a starting PID (defaults to $$) — used by the regression test.
-# bash 3.2 safe (no associative arrays).
-okstra_resolve_caller_pane() {
-  command -v tmux >/dev/null 2>&1 || return 0
-  local panes
-  panes="$(tmux list-panes -a -F '#{pane_pid} #{pane_id}' 2>/dev/null)" || return 0
-  [ -n "$panes" ] || return 0
-
-  local pid="${1:-$$}"
-  local depth=0
-  local hit
-  while [ -n "$pid" ] && [ "$pid" != "0" ] && [ "$depth" -lt 16 ]; do
-    hit="$(printf '%s\n' "$panes" | awk -v p="$pid" '$1==p {print $2; exit}')"
-    if [ -n "$hit" ]; then
-      printf '%s\n' "$hit"
-      return 0
-    fi
-    pid="$(ps -o ppid= -p "$pid" 2>/dev/null | tr -d ' ')"
-    depth=$((depth + 1))
-  done
-  return 0
-}

package/runtime/bin/lib/okstra-ctl/cmd-batch.sh

@@ -1,59 +0,0 @@
-# shellcheck shell=bash
-
-_okstra_ctl_batch() {
-  if [[ $# -lt 1 ]]; then
-    printf 'batch: missing subcommand (list|status)\n' >&2; exit 2
-  fi
-  local sub="$1"; shift
-  case "$sub" in
-    list)
-      OKSTRA_HOME_RESOLVED="$(okstra_central_home)" python3 - <<'PY'
-import json, os
-from pathlib import Path
-home = Path(os.environ["OKSTRA_HOME_RESOLVED"])
-batches = sorted((home / "batches").glob("*.json"))
-print(f"{'BATCH-ID':<24}  {'CREATED':<22}  {'SPAWNED':>7}  {'SKIPPED':>7}")
-for b in batches:
-    m = json.loads(b.read_text())
-    s = m.get("summary", {})
-    print(f"{m['batchId']:<24}  {m['createdAt']:<22}  "
-          f"{s.get('spawned', 0):>7}  {s.get('skipped', 0):>7}")
-PY
-      ;;
-    status)
-      if [[ $# -lt 1 ]]; then
-        printf 'batch status: missing <batch-id>\n' >&2; exit 2
-      fi
-      OKSTRA_HOME_RESOLVED="$(okstra_central_home)" \
-      OKSTRA_CTL_LIB_DIR="$SCRIPT_DIR" \
-      OK_BID="$1" python3 - <<'PY'
-import json, os, sys
-sys.path.insert(0, os.environ["OKSTRA_CTL_LIB_DIR"])
-from pathlib import Path
-from okstra_ctl import find_row_by_run_id
-home = Path(os.environ["OKSTRA_HOME_RESOLVED"])
-target = home / "batches" / f"{os.environ['OK_BID']}.json"
-if not target.is_file():
-    print(f"batch: not found: {os.environ['OK_BID']}", file=sys.stderr); sys.exit(2)
-m = json.loads(target.read_text())
-print(f"batchId   : {m['batchId']}")
-print(f"createdAt : {m['createdAt']}")
-print(f"summary   : {m['summary']}")
-print()
-print(f"{'SPAWN':<10}  {'LIVE':<11}  {'NEW-RUN-ID':<55}  {'SESSION-NAME'}")
-for it in m["items"]:
-    spawn_status = it["status"]
-    new_run_id = it.get("newRunId") or "-"
-    # 현재 인덱스(active+recent+archive)에서 live 상태를 조회한다.
-    live = "-"
-    if it.get("newRunId"):
-        live_row = find_row_by_run_id(home, it["newRunId"])
-        if live_row is not None:
-            live = live_row.get("status", "-")
-    print(f"{spawn_status:<10}  {live:<11}  "
-          f"{new_run_id:<55}  {it.get('sessionName') or '-'}")
-PY
-      ;;
-    *) printf 'batch: unknown subcommand: %s\n' "$sub" >&2; exit 2 ;;
-  esac
-}

package/runtime/bin/lib/okstra-ctl/cmd-list.sh

@@ -1,35 +0,0 @@
-# shellcheck shell=bash
-
-_okstra_ctl_list() {
-  local project="all" task_group="all" status="all" since="" limit="0"
-  local include_archive="false"
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --project) project="$2"; shift 2 ;;
-      --task-group) task_group="$2"; shift 2 ;;
-      --status) status="$2"; shift 2 ;;
-      --since) since="$2"; shift 2 ;;
-      --limit) limit="$2"; shift 2 ;;
-      --include-archive) include_archive="true"; shift ;;
-      *) printf 'list: unknown option: %s\n' "$1" >&2; exit 2 ;;
-    esac
-  done
-  OKSTRA_HOME_RESOLVED="$(okstra_central_home)" \
-  OKSTRA_CTL_LIB_DIR="$SCRIPT_DIR" \
-  OK_PROJECT="$project" OK_TG="$task_group" OK_STATUS="$status" \
-  OK_SINCE="$since" OK_LIMIT="$limit" OK_ARC="$include_archive" \
-  python3 - <<'PY'
-import os, sys
-sys.path.insert(0, os.environ["OKSTRA_CTL_LIB_DIR"])
-from pathlib import Path
-from okstra_ctl import list_runs, format_runs_table
-rows = list_runs(
-    Path(os.environ["OKSTRA_HOME_RESOLVED"]),
-    project=os.environ["OK_PROJECT"], task_group=os.environ["OK_TG"],
-    status=os.environ["OK_STATUS"], since=os.environ["OK_SINCE"],
-    limit=int(os.environ["OK_LIMIT"]),
-    include_archive=os.environ["OK_ARC"] == "true",
-)
-print(format_runs_table(rows), end="")
-PY
-}

package/runtime/bin/lib/okstra-ctl/cmd-open.sh

@@ -1,36 +0,0 @@
-# shellcheck shell=bash
-
-_okstra_ctl_open() {
-  if [[ $# -lt 1 ]]; then
-    printf 'open: missing <runId-or-prefix>\n' >&2; exit 2
-  fi
-  local resolved
-  resolved="$(OKSTRA_HOME_RESOLVED="$(okstra_central_home)" \
-              OKSTRA_CTL_LIB_DIR="$SCRIPT_DIR" \
-              OK_QUERY="$1" python3 - <<'PY'
-import os, sys
-sys.path.insert(0, os.environ["OKSTRA_CTL_LIB_DIR"])
-from pathlib import Path
-from okstra_ctl import resolve_run_id, find_row_by_run_id, absolute_final_report_path, ResolveError
-home = Path(os.environ["OKSTRA_HOME_RESOLVED"])
-try:
-    rid = resolve_run_id(home, os.environ["OK_QUERY"])
-except ResolveError as e:
-    print(f"open: {e}", file=sys.stderr); sys.exit(2)
-row = find_row_by_run_id(home, rid)
-abs_path = absolute_final_report_path(row) if row else None
-if abs_path is None or not abs_path.is_file():
-    print(f"open: final report not found", file=sys.stderr); sys.exit(2)
-print(str(abs_path))
-PY
-)"
-  if [[ -z "$resolved" ]]; then exit 2; fi
-  # $EDITOR 가 설정되어 있으면 그것으로 열고, 없으면 경로만 출력한다.
-  # EDITOR 는 보통 'code -w' 처럼 인자를 포함할 수 있어 단어 분리해
-  # exec 해야 한다(따옴표 안에 두면 단일 명령어로 잘못 해석됨).
-  if [[ -n "${EDITOR:-}" ]]; then
-    # shellcheck disable=SC2086
-    exec ${EDITOR} "$resolved"
-  fi
-  printf '%s\n' "$resolved"
-}

package/runtime/bin/lib/okstra-ctl/cmd-projects.sh

@@ -1,26 +0,0 @@
-# shellcheck shell=bash
-
-_okstra_ctl_projects() {
-  local sort_by="recent" only_active="false"
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --sort) sort_by="$2"; shift 2 ;;
-      --active) only_active="true"; shift ;;
-      *) printf 'projects: unknown option: %s\n' "$1" >&2; exit 2 ;;
-    esac
-  done
-  OKSTRA_HOME_RESOLVED="$(okstra_central_home)" \
-  OKSTRA_CTL_LIB_DIR="$SCRIPT_DIR" \
-  OKSTRA_SORT_BY="$sort_by" \
-  OKSTRA_ONLY_ACTIVE="$only_active" \
-  python3 - <<'PY'
-import os, sys
-sys.path.insert(0, os.environ["OKSTRA_CTL_LIB_DIR"])
-from pathlib import Path
-from okstra_ctl import list_projects, format_projects_table
-items = list_projects(Path(os.environ["OKSTRA_HOME_RESOLVED"]),
-                      only_active=os.environ["OKSTRA_ONLY_ACTIVE"] == "true",
-                      sort_by=os.environ["OKSTRA_SORT_BY"])
-print(format_projects_table(items), end="")
-PY
-}

package/runtime/bin/lib/okstra-ctl/cmd-reconcile.sh

@@ -1,29 +0,0 @@
-# shellcheck shell=bash
-
-_okstra_ctl_reconcile() {
-  # `okstra-ctl reconcile [--project <id|all>]`. dispatcher 가 이미 호출한
-  # _okstra_ctl_prepare 의 reconcile 은 unscoped 이므로, 여기서는 사용자
-  # --project 필터를 적용해 한 번 더 호출한다.
-  local project="all"
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --project) project="$2"; shift 2 ;;
-      *) printf 'reconcile: unknown option: %s\n' "$1" >&2; exit 2 ;;
-    esac
-  done
-  OKSTRA_HOME_RESOLVED="$(okstra_central_home)" \
-  OKSTRA_CTL_LIB_DIR="$SCRIPT_DIR" \
-  OK_PROJECT="$project" \
-  python3 - <<'PY'
-import os, sys
-sys.path.insert(0, os.environ["OKSTRA_CTL_LIB_DIR"])
-from pathlib import Path
-from okstra_ctl import reconcile_active, reconcile_recent
-target = os.environ["OK_PROJECT"]
-home = Path(os.environ["OKSTRA_HOME_RESOLVED"])
-scope = None if target == "all" else target
-reconcile_active(home, project=scope)
-reconcile_recent(home, project=scope)
-PY
-  printf 'reconcile complete\n'
-}

package/runtime/bin/lib/okstra-ctl/cmd-reindex.sh

@@ -1,38 +0,0 @@
-# shellcheck shell=bash
-
-_okstra_ctl_reindex() {
-  local project="all"
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --project) project="$2"; shift 2 ;;
-      *) printf 'reindex: unknown option: %s\n' "$1" >&2; exit 2 ;;
-    esac
-  done
-  OKSTRA_HOME_RESOLVED="$(okstra_central_home)" \
-  OKSTRA_CTL_LIB_DIR="$SCRIPT_DIR" \
-  OK_PROJECT="$project" \
-  python3 - <<'PY'
-import os, sys
-sys.path.insert(0, os.environ["OKSTRA_CTL_LIB_DIR"])
-from pathlib import Path
-from okstra_ctl import (discover_project_roots, backfill_project,
-                            mark_backfilled, central_lock)
-home = Path(os.environ["OKSTRA_HOME_RESOLVED"])
-target = os.environ["OK_PROJECT"]
-total = 0
-# 중앙 락으로 보호 — record_start/reconcile 와 같은 lock 위에서 직렬화하여
-# projects/<id>/meta.json 의 read-modify-write 가 손실되지 않게 한다.
-with central_lock(home):
-    # 신규 모델: discover_project_roots 는 ~/.okstra/projects/*/meta.json 을
-    # 스캔한다(과거 examples/projects/*.conf.sh 모델 폐기).
-    for pid, root in discover_project_roots(home):
-        if target != "all" and pid != target:
-            continue
-        n = backfill_project(home, pid, Path(root))
-        print(f"{pid}: {n} new run(s) backfilled")
-        total += n
-    if target == "all":
-        mark_backfilled(home)
-print(f"total: {total}")
-PY
-}