okstra 0.95.0 → 0.96.1

package/runtime/skills/okstra-run/SKILL.md

@@ -50,7 +50,7 @@ The wizard tells you *which UI to use* via `kind` (and the optional `multi` flag
 - `kind: "done"` → input collection finished; move to Step 5.
 - `kind: "aborted"` → the user picked 중단; the wizard is terminally cancelled. Tell the user on one short line that the run setup was aborted, delete the state file (`rm` with the literal path), and stop this skill — do NOT call `render-args` or `render-bundle` (the wizard rejects `render-args` on an aborted state).
 
-The `branch_confirm` step (shown just before `confirm`) is a normal `pick` step and is rendered the same way — no special handling needed. Its options always include `중단` (abort); `base-ref 다시 고르기` (edit) appears only when a new branch would be created from the user-chosen base-ref. For `implementation` runs the wizard previews the **stage worktree** this run will actually use (not the task-key directory); render its label verbatim.
+The final `confirm` step is a normal `pick` step with three options — `Proceed` / `Edit` / `중단`(abort) — and is rendered the same way (no special handling). `Edit` rewinds to any earlier step (including `base-ref`); `중단` terminally cancels the wizard. The branch/worktree decision the run will actually use (for `implementation`, the **stage worktree** — not the task-key directory) is folded into the Step 4 confirmation summary block as a `worktree` line, so there is no separate branch-confirm prompt.
 
 Never invent additional questions. Never reorder. **Never drop, hide, or merge a `pick` / `pick_group` option** — render every `options[]` entry as its own selectable `AskUserQuestion` choice, including entries that carry a `(default)` / `(recommended)` suffix. Do NOT collapse a multi-option pick into a "recommended + 직접 입력 / Other" shortlist: the wizard's `options[]` array IS the complete, authoritative choice set. Example: the `executor` step always emits `claude` / `codex` / `antigravity` — show all three, never just `claude`. The run-prompt recommendation rule (1–2 추천 + 직접 입력) applies ONLY to prompts this skill authors itself (e.g. the conformance-waiver picker), never to wizard-provided `options[]`. Never use `AskUserQuestion` for `text` prompts — the wizard explicitly chose `text` to avoid the picker-Other re-render lag.
 

package/src/cli-registry.mjs

@@ -110,6 +110,13 @@ export const COMMAND_REGISTRY = [
     category: "introspection",
     summary: ["Aggregate okstra-run error logs into a task-level report"],
   },
+  {
+    name: "recap",
+    module: "./recap.mjs",
+    export: "run",
+    category: "introspection",
+    summary: ["Assemble a task's run-to-run phase recap or append a recap log entry"],
+  },
   {
     name: "worktree-lookup",
     module: "./worktree-lookup.mjs",

package/src/recap.mjs

@@ -0,0 +1,27 @@
+import { runPythonModule } from "./_python-helper.mjs";
+
+const USAGE = `okstra recap — assemble a task's run-to-run phase recap, or append a recap log entry
+
+Usage:
+  okstra recap assemble <task-root|task-key> [--project-root <dir>] [--cwd <dir>]
+  okstra recap record <task-root|task-key> --kind <summary|qa> --mode <artifact|code> \\
+    [--question <text>] --answer <text> [--citation <path:line> ...]
+
+\`assemble\` is read-only and prints a JSON summary of phase transitions across runs.
+\`record\` appends one line to <task-root>/recap/recap-log.jsonl; it never mutates
+other task artifacts.
+`;
+
+export async function run(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    process.stdout.write(USAGE);
+    return 0;
+  }
+
+  const result = await runPythonModule({
+    module: "okstra_ctl.recap",
+    args,
+    stdio: "inherit-stdout",
+  });
+  return result.code ?? 0;
+}