okstra 0.141.3 → 0.143.0

package/src/cli-registry.mjs

@@ -101,6 +101,16 @@ export const COMMAND_REGISTRY = [
     category: "admin",
     summary: ["stage 들을 task 브랜치에 통합 머지하고 stage worktree 를 정리"],
   },
+  {
+    name: "phase-cleanup",
+    module: "./commands/execute/phase-cleanup.mjs",
+    export: "run",
+    category: "admin",
+    summary: [
+      "Reclaim the prior phase/batch's completed panes and list dismissible",
+      "teammates for the lead to shut down (tmux-aware)",
+    ],
+  },
   {
     name: "paths",
     module: "./commands/lifecycle/paths.mjs",

package/src/commands/execute/phase-cleanup.mjs

@@ -0,0 +1,38 @@
+import { runPythonModule } from "../../lib/python-helper.mjs";
+
+const USAGE = `okstra phase-cleanup — reclaim the prior phase/batch's completed panes and teammates
+
+Usage:
+  okstra phase-cleanup --project-root <dir> [--task-key <k>] [--run-dir <dir>]
+                       [--fallback-team <label>] [--json]
+
+--task-key   project-id:task-group:task-id — finds the newest completed run
+             across phases, including staged (implementation / final-
+             verification) stage-N runs.
+--run-dir    explicit prior run dir (wins over --task-key).
+--fallback-team
+             the live team label (session-<lead-session-prefix>) so teammate
+             reconcile still finds the roster after a session-id re-issue
+             (resume/compaction); omit and it resolves the current live
+             session only.
+
+Reclaims only completed tmux panes (lead pane and in-flight workers are preserved),
+and prints the dismissible-teammate names for the lead to shut down. In a non-tmux
+session no panes exist, so it skips pane reclaim and only reconciles teammates.
+A cleanup failure never blocks the next phase (the worker returns 0); a malformed
+invocation still exits non-zero.
+`;
+
+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.phase_cleanup",
+    args,
+    stdio: "inherit-stdout",
+  });
+  return result.code;
+}