@philogag/pi-tui-openspec-status 0.1.0

package/README.md

@@ -0,0 +1,112 @@
+# `@philogag/pi-tui-openspec-status`
+
+A [pi coding agent](https://github.com/mattoopie/pi) extension that
+shows the current locked **openspec** change as a single status-bar line:
+
+```
+add-pi-tui-openspec-status (superpowers-bridge-cn) [P● D● S○ T○] Tasks: ███░░░░░░░ 2/7
+```
+
+## Install
+
+```bash
+pnpm add -D @philogag/pi-tui-openspec-status
+```
+
+Then enable in your pi config (`~/.pi/settings.json` or
+`<repo>/.pi/settings.json`):
+
+```json
+{
+  "extensions": ["@philogag/pi-tui-openspec-status"]
+}
+```
+
+## Activation mode
+
+The extension is **TUI-only**. `ctx.mode` is unknown at factory time
+(it's only available once the first event fires), so the gate runs at
+`session_start` (the first event):
+
+| Mode       | Activates? | Notes                              |
+|------------|------------|------------------------------------|
+| `tui`      | ✅ yes     | Normal interactive operation        |
+| `rpc`      | ❌ no      | `ctx.hasUI === true` here too, but mode check excludes it |
+| `json`     | ❌ no      | No event-stream output             |
+| `print`    | ❌ no      | `-p` one-shot mode                 |
+
+Per `pi.dev/docs/latest/extensions#ctx-mode`, `ctx.mode` (not
+`ctx.hasUI`) is the correct TUI feature gate. The `/tui-openspec-select`
+command (which can run without a prior `session_start`) re-checks the
+mode before rendering.
+
+## Behavior
+
+- The status line appears when you (or the agent) invoke an
+  openspec command that **explicitly names a change** —
+  `new`, `status`, `apply`, `archive`, `verify`, `sync`,
+  `instructions`, `show`, `validate`, `context`, `view` — **or** when
+  you manually select a change with `/tui-openspec-select`.
+- Browsing commands like `openspec list` / `openspec doctor` clear the
+  status line.
+- The line refreshes 500ms after each matching `bash` tool call.
+
+## Manual tracking with `/tui-openspec-select`
+
+In TUI mode you can take manual control of the status bar with the
+`/tui-openspec-select` command:
+
+- Opens an interactive picker listing every **active** change
+  (`openspec/changes/*/` minus `archive/`) plus a `None` option.
+- Selecting a change manually **locks** the status bar to it: bash
+  `openspec` commands will NOT switch it away until you manually
+  re-select another change or pick `None` (manual overrides auto).
+- Picking `None` clears the manual lock and restores automatic
+  tracking from bash commands.
+- Cancelling the picker (Esc) changes nothing — the current tracking
+  state is left untouched.
+- Archiving the manually tracked change (e.g. `openspec archive <name>`)
+  still auto-clears the status bar, as usual.
+
+## Lock persistence across restarts
+
+The tracked spec, worktree, and lock type (manual vs auto) are
+persisted into the session file via `pi.appendEntry()` (custom entries
+— never sent to the LLM). On `session_start` — including `/resume`,
+where pi reloads the extension with a fresh instance — the last
+matching entry is read back and the status bar is rebuilt:
+
+- A **manual** lock (`/tui-openspec-select`) is restored pinned, so
+  bash openspec commands don't switch it away.
+- An **auto** lock (from a bash `openspec` command) is restored with
+  its auto semantics, so a later `openspec status --change X` still
+  updates the tracked spec.
+- Clearing (`None` / auto-unlock on archive) writes an explicit empty
+  snapshot, so a stale lock is never restored.
+
+This means the status bar survives `/resume` and extension reloads
+instead of going empty.
+
+## Worktree support
+
+When `openspec` is invoked inside a git worktree
+(e.g. `.worktrees/feat/openspec-status/`), the extension reads
+`tasks.md` from **both** the main repo and the worktree, then
+deduplicates by task ID:
+
+- A task is "done" if checked in either side.
+- Total count is the union of unique task IDs.
+
+This prevents the progress bar from regressing when the worktree is
+ahead of the main repo (the common SDD apply scenario).
+
+## Limitations
+
+- Only the schema's external artifacts (`proposal`, `design`, `specs`,
+  `tasks`) appear; planning-phase internal artifacts
+  (`brainstorm`, `verify`, `retrospective`) are hidden.
+- Requires the `openspec` CLI on `$PATH`. Missing CLI silently disables
+  the extension.
+- Does **not** render widgets, dialogs, or keyboard shortcuts — only
+  the bottom status bar (`ctx.ui.setStatus`).
+- **Does not activate in non-TUI modes** (rpc/json/print) — by design.

package/dist/discover.d.ts

@@ -0,0 +1,8 @@
+/**
+ * List active (non-archived) openspec change names under
+ * `<openspecRoot>/openspec/changes/`. Stable-sorted; excludes the
+ * `archive` directory. Returns [] when the directory is
+ * missing/unreadable.
+ */
+export declare function listActiveChanges(openspecRoot: string): Promise<string[]>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB"}

package/dist/discover.js

@@ -0,0 +1,24 @@
+// src/discover.ts
+import { readdir } from "node:fs/promises";
+import * as path from "node:path";
+/**
+ * List active (non-archived) openspec change names under
+ * `<openspecRoot>/openspec/changes/`. Stable-sorted; excludes the
+ * `archive` directory. Returns [] when the directory is
+ * missing/unreadable.
+ */
+export async function listActiveChanges(openspecRoot) {
+    const changesDir = path.join(openspecRoot, "openspec", "changes");
+    let entries;
+    try {
+        entries = await readdir(changesDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((e) => e.isDirectory() && e.name !== "archive")
+        .map((e) => e.name)
+        .sort();
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAAoB;IAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare const EXTENSION_ID = "pi-tui-openspec-status";
+export declare const SET_STATUS_DEBOUNCE_MS = 500;
+export interface PiTuiOpenspecStatusOptions {
+    /**
+     * Override the render debounce window (ms). Defaults to
+     * {@link SET_STATUS_DEBOUNCE_MS}. Tests typically pass a small value
+     * (e.g. 0) to skip debouncing entirely.
+     */
+    debounceMs?: number;
+}
+/**
+ * Wire the OpenSpec status bar into pi.
+ *
+ * Thin wiring layer: all tracking state and the render pipeline live
+ * in {@link OpenSpecStatusRender}; this module only connects pi events
+ * to it. A single render instance is created at session_start (or
+ * lazily by the select command, which may run without session_start in
+ * tests) and reused for the whole session.
+ *
+ * Lock persistence: every authoritative state change (lock / auto-lock
+ * / worktree / clear / auto-unlock) is mirrored into the session file
+ * via `pi.appendEntry(LOCK_CUSTOM_TYPE, snapshot)` — custom entries do
+ * NOT participate in LLM context. On session_start (including
+ * `/resume`, where pi reloads the extension with a fresh instance) the
+ * last matching entry is read back via `findLastPersistedLock()` and
+ * the render is rebuilt with the same lock type (manual vs auto), so
+ * the status bar survives restarts instead of going empty.
+ *
+ * The extension factory receives ONLY `ExtensionAPI` (see
+ * https://pi.dev/docs/latest/extensions) — there is no ctx at load
+ * time, so the mode is unknown until the first event fires. Handlers
+ * are therefore registered unconditionally, and the TUI gate
+ * (`ctx.mode === "tui"`) runs inside session_start — the first event
+ * that carries a real ExtensionContext. Until then every event is a
+ * no-op because no render exists yet.
+ */
+export default function (pi: ExtensionAPI, options?: PiTuiOpenspecStatusOptions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAEzC,eAAO,MAAM,YAAY,2BAA2B,CAAC;AACrD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,WACZ,EAAE,EAAE,YAAY,EAChB,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAsGN"}

package/dist/index.js

@@ -0,0 +1,136 @@
+// src/index.ts
+import { listActiveChanges } from "./discover.js";
+import { findSpec, findWorkTree } from "./parser.js";
+import { OpenSpecStatusRender } from "./render.js";
+import { findLastPersistedLock, LOCK_CUSTOM_TYPE, } from "./state.js";
+import { isToolCallEventType, } from "@earendil-works/pi-coding-agent";
+export const EXTENSION_ID = "pi-tui-openspec-status";
+export const SET_STATUS_DEBOUNCE_MS = 500;
+/**
+ * Wire the OpenSpec status bar into pi.
+ *
+ * Thin wiring layer: all tracking state and the render pipeline live
+ * in {@link OpenSpecStatusRender}; this module only connects pi events
+ * to it. A single render instance is created at session_start (or
+ * lazily by the select command, which may run without session_start in
+ * tests) and reused for the whole session.
+ *
+ * Lock persistence: every authoritative state change (lock / auto-lock
+ * / worktree / clear / auto-unlock) is mirrored into the session file
+ * via `pi.appendEntry(LOCK_CUSTOM_TYPE, snapshot)` — custom entries do
+ * NOT participate in LLM context. On session_start (including
+ * `/resume`, where pi reloads the extension with a fresh instance) the
+ * last matching entry is read back via `findLastPersistedLock()` and
+ * the render is rebuilt with the same lock type (manual vs auto), so
+ * the status bar survives restarts instead of going empty.
+ *
+ * The extension factory receives ONLY `ExtensionAPI` (see
+ * https://pi.dev/docs/latest/extensions) — there is no ctx at load
+ * time, so the mode is unknown until the first event fires. Handlers
+ * are therefore registered unconditionally, and the TUI gate
+ * (`ctx.mode === "tui"`) runs inside session_start — the first event
+ * that carries a real ExtensionContext. Until then every event is a
+ * no-op because no render exists yet.
+ */
+export default function (pi, options = {}) {
+    const debounceMs = options.debounceMs ?? SET_STATUS_DEBOUNCE_MS;
+    let render;
+    /**
+     * Persist a lock snapshot to the session file. `null` (or an
+     * all-cleared state) is stored as an explicit "no lock" entry so
+     * that a later resume restores the empty state instead of a stale
+     * lock. Persistence is best-effort: appendEntry failures must never
+     * propagate into the extension's render path (D12).
+     */
+    const persistLock = (state) => {
+        try {
+            pi.appendEntry(LOCK_CUSTOM_TYPE, state ?? {
+                spec: "",
+                manualLock: false,
+                version: 1,
+            });
+        }
+        catch {
+            // append-only session journal; a failure here is not fatal.
+        }
+    };
+    pi.on("session_start", (_event, ctx) => {
+        // D9: only activate under a real TUI. rpc/json/print never create
+        // a render, so the status bar is never touched.
+        if (ctx?.mode !== "tui")
+            return;
+        render = new OpenSpecStatusRender(EXTENSION_ID, ctx, debounceMs, persistLock);
+        // Resume/restart: rebuild the previous lock state from the session
+        // journal (D1/D2/D4). A manual lock is pinned via render.lock(); an
+        // auto lock keeps its auto semantics via setSpec + setWorkTree.
+        // Recovery is best-effort: any failure keeps the empty state and
+        // never throws into the session_start handler (D12).
+        try {
+            const restored = findLastPersistedLock(ctx.sessionManager.getEntries());
+            if (restored && restored.spec) {
+                if (restored.manualLock) {
+                    render.lock(restored.spec);
+                    if (restored.worktree)
+                        render.setWorkTree(restored.worktree);
+                }
+                else {
+                    render.setSpec(restored.spec);
+                    if (restored.worktree)
+                        render.setWorkTree(restored.worktree);
+                }
+            }
+        }
+        catch {
+            // dirty journal data → stay in the empty state.
+        }
+        // Explicit initial publish: status bar shows "no change" until the
+        // first lock. Kept out of the constructor so that creating a render
+        // lazily (select command) has no side effects. Published after the
+        // restore so a restored lock immediately supersedes it via refresh().
+        ctx.ui.setStatus(EXTENSION_ID, undefined);
+    });
+    pi.on("tool_call", (event) => {
+        if (!render)
+            return;
+        // Real event shape: { type, toolCallId, toolName: "bash", input: { command } }.
+        // The bash tool input has NO `type` field — use the official guard
+        // (checks event.toolName === "bash") instead of sniffing input.type.
+        if (!isToolCallEventType("bash", event))
+            return;
+        const cmd = event.input.command;
+        if (typeof cmd !== "string")
+            return;
+        const spec = findSpec(cmd);
+        if (spec)
+            render.setSpec(spec);
+        const worktree = findWorkTree(cmd);
+        if (worktree)
+            render.setWorkTree(worktree);
+    });
+    pi.on("tool_result", () => {
+        if (render)
+            render.refresh();
+    });
+    pi.registerCommand("tui-openspec-select", {
+        description: "Manually select which openspec change the status bar tracks (None to clear)",
+        handler: async (_args, cmdCtx) => {
+            // TUI-only, like the rest of the extension.
+            if (cmdCtx.mode !== "tui")
+                return;
+            const changes = await listActiveChanges(cmdCtx.cwd);
+            const choice = await cmdCtx.ui.select("Select spec to track:", [
+                ...changes,
+                "None",
+            ]);
+            if (choice === undefined)
+                return; // cancelled — no side effects
+            if (choice === "None") {
+                render?.clearLock();
+                return;
+            }
+            render ??= new OpenSpecStatusRender(EXTENSION_ID, cmdCtx, debounceMs, persistLock);
+            render.lock(choice);
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/merge.d.ts

@@ -0,0 +1,30 @@
+import type { ArtifactStatus, MergedTasks, StatusJson } from "./types.js";
+export declare function parseTasksFile(text: string): Map<string, boolean>;
+export declare function mergeTasks(main: Map<string, boolean>, worktree: Map<string, boolean>): MergedTasks;
+/**
+ * Read tasks.md from both main repo and (optional) worktree,
+ * parse & merge.
+ *
+ * Each source is read independently — a missing tasks.md in main does
+ * NOT suppress the worktree's tasks (and vice versa). The caller
+ * (`render`) decides whether missing change folders overall mean
+ * "unlock"; this function only merges whatever it can find.
+ */
+export declare function readMergedTasks(changeName: string, mainRepoRoot: string, worktreeCwd?: string): Promise<MergedTasks>;
+/**
+ * Union multiple artifact-status lists. Per id:
+ * - "done" wins over any other status (union of completed work)
+ * - otherwise keep the first non-empty status we see
+ * Output is de-duped by id and emitted in canonical order, with any
+ * unknown ids appended at the end.
+ */
+export declare function mergeArtifactStatuses(lists: ReadonlyArray<ReadonlyArray<ArtifactStatus> | undefined | null>): ArtifactStatus[];
+/**
+ * Merge multiple StatusJson results (e.g. from main + worktree scans).
+ * - schemaName: first non-empty wins
+ * - applied: true if any source says true
+ * - artifacts: union via mergeArtifactStatuses
+ * Returns null when ALL inputs are null.
+ */
+export declare function mergeStatusResults(results: ReadonlyArray<StatusJson | null>): StatusJson | null;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBjE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,WAAW,CAOb;AAgBD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAUtB;AAUD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GACrE,cAAc,EAAE,CA6BlB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,CAAC,UAAU,GAAG,IAAI,CAAC,GACxC,UAAU,GAAG,IAAI,CAWnB"}

package/dist/merge.js

@@ -0,0 +1,134 @@
+// src/merge.ts
+import { readFile } from "node:fs/promises";
+import * as path from "node:path";
+const CHECKED_RE = /^\s*-\s*\[(x|done)\]\s+(\S+)/i;
+const UNCHECKED_RE = /^\s*-\s*\[( |)\]\s+(\S+)/;
+const ANY_TASK_RE = /^\s*-\s*\[[ xX]\]?\s*(\S+)/;
+export function parseTasksFile(text) {
+    const out = new Map();
+    for (const line of text.split(/\r?\n/)) {
+        let m;
+        if ((m = CHECKED_RE.exec(line))) {
+            out.set(m[2], true);
+            continue;
+        }
+        if ((m = UNCHECKED_RE.exec(line))) {
+            out.set(m[2], false);
+            continue;
+        }
+        if ((m = ANY_TASK_RE.exec(line))) {
+            // Fallback: line that looks like a task but didn't match above;
+            // default to unchecked if not already present.
+            if (!out.has(m[1]))
+                out.set(m[1], false);
+        }
+    }
+    return out;
+}
+export function mergeTasks(main, worktree) {
+    const keys = new Set([...main.keys(), ...worktree.keys()]);
+    let done = 0;
+    for (const k of keys) {
+        if (main.get(k) === true || worktree.get(k) === true)
+            done++;
+    }
+    return { done, total: keys.size };
+}
+/**
+ * Read tasks.md from `p`, returning an empty Map on any failure.
+ * Use this so that a missing file is "no tasks here", not a fatal
+ * error that aborts the whole merge.
+ */
+async function readTasksMap(p) {
+    try {
+        const text = await readFile(p, "utf8");
+        return parseTasksFile(text);
+    }
+    catch {
+        return new Map();
+    }
+}
+/**
+ * Read tasks.md from both main repo and (optional) worktree,
+ * parse & merge.
+ *
+ * Each source is read independently — a missing tasks.md in main does
+ * NOT suppress the worktree's tasks (and vice versa). The caller
+ * (`render`) decides whether missing change folders overall mean
+ * "unlock"; this function only merges whatever it can find.
+ */
+export async function readMergedTasks(changeName, mainRepoRoot, worktreeCwd) {
+    const mainMap = await readTasksMap(path.join(mainRepoRoot, "openspec", "changes", changeName, "tasks.md"));
+    const wtMap = worktreeCwd
+        ? await readTasksMap(path.join(worktreeCwd, "openspec", "changes", changeName, "tasks.md"))
+        : new Map();
+    return mergeTasks(mainMap, wtMap);
+}
+// Canonical artifact order in the status line.
+const ARTIFACT_ORDER = [
+    "proposal",
+    "design",
+    "specs",
+    "tasks",
+];
+/**
+ * Union multiple artifact-status lists. Per id:
+ * - "done" wins over any other status (union of completed work)
+ * - otherwise keep the first non-empty status we see
+ * Output is de-duped by id and emitted in canonical order, with any
+ * unknown ids appended at the end.
+ */
+export function mergeArtifactStatuses(lists) {
+    const out = new Map();
+    const orderedIds = [...ARTIFACT_ORDER];
+    // Pass 1: canonical ids in canonical order
+    for (const id of ARTIFACT_ORDER) {
+        for (const list of lists) {
+            if (!list)
+                continue;
+            const hit = list.find((a) => a.id === id);
+            if (!hit)
+                continue;
+            const cur = out.get(id);
+            if (!cur || hit.status === "done")
+                out.set(id, hit.status);
+        }
+    }
+    // Pass 2: any non-canonical ids, in first-seen order
+    for (const list of lists) {
+        if (!list)
+            continue;
+        for (const a of list) {
+            if (orderedIds.includes(a.id))
+                continue;
+            orderedIds.push(a.id);
+            const cur = out.get(a.id);
+            if (!cur || a.status === "done")
+                out.set(a.id, a.status);
+        }
+    }
+    return orderedIds
+        .filter((id) => out.has(id))
+        .map((id) => ({ id, status: out.get(id) }));
+}
+/**
+ * Merge multiple StatusJson results (e.g. from main + worktree scans).
+ * - schemaName: first non-empty wins
+ * - applied: true if any source says true
+ * - artifacts: union via mergeArtifactStatuses
+ * Returns null when ALL inputs are null.
+ */
+export function mergeStatusResults(results) {
+    const valid = results.filter((r) => r !== null);
+    if (valid.length === 0)
+        return null;
+    const schemaName = valid.find((r) => typeof r.schemaName === "string")
+        ?.schemaName;
+    const applied = valid.some((r) => r.applied === true);
+    return {
+        schemaName,
+        applied,
+        artifacts: mergeArtifactStatuses(valid.map((r) => r.artifacts)),
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"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"}

package/dist/openspec.d.ts

@@ -0,0 +1,4 @@
+import type { StatusJson } from "./types.js";
+export declare const OPENSPEC_STATUS_TIMEOUT_MS = 10000;
+export declare function runOpenspecStatus(changeName: string, cwd: string): Promise<StatusJson | null>;
+//# sourceMappingURL=openspec.d.ts.map

package/dist/openspec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openspec.d.ts","sourceRoot":"","sources":["../src/openspec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAiD5B"}

package/dist/openspec.js

@@ -0,0 +1,53 @@
+// src/openspec.ts
+import { spawn } from "node:child_process";
+import { clearTimeout } from "node:timers";
+// The openspec CLI needs ~1.2–2s to produce the full status JSON on a
+// cold node/jiti start, and more under load. Keep generous headroom so
+// a slow CLI never collapses the status line to "spec-driven".
+export const OPENSPEC_STATUS_TIMEOUT_MS = 10000;
+export async function runOpenspecStatus(changeName, cwd) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(v);
+        };
+        let stdout = "";
+        let stderr = "";
+        let proc = null;
+        try {
+            proc = spawn("openspec", ["status", "--change", changeName, "--json"], { cwd: cwd || process.cwd(), stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch {
+            finish(null);
+            return;
+        }
+        const timer = setTimeout(() => {
+            proc?.kill();
+            finish(null);
+        }, OPENSPEC_STATUS_TIMEOUT_MS);
+        proc.stdout?.on("data", (b) => (stdout += b.toString("utf8")));
+        proc.stderr?.on("data", (b) => (stderr += b.toString("utf8")));
+        proc.on("error", () => {
+            clearTimeout(timer);
+            finish(null);
+        });
+        proc.on("close", (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                finish(null);
+                return;
+            }
+            try {
+                const parsed = JSON.parse(stdout);
+                finish(parsed);
+            }
+            catch {
+                finish(null);
+            }
+        });
+    });
+}
+//# sourceMappingURL=openspec.js.map

package/dist/openspec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openspec.js","sourceRoot":"","sources":["../src/openspec.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,sEAAsE;AACtE,uEAAuE;AACvE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,GAAW;IAEX,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,CAAoB,EAAE,EAAE;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC;QAEF,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,IAAI,GAAoC,IAAI,CAAC;QACjD,IAAI,CAAC;YACH,IAAI,GAAG,KAAK,CACV,UAAU,EACV,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,EAC5C,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACjE,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,EAAE,IAAI,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,EAAE,0BAA0B,CAAC,CAAC;QAE/B,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAE/D,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,CAAC;gBACb,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAe,CAAC;gBAChD,MAAM,CAAC,MAAM,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,39 @@
+import type { ParsedBashCommand } from "./types.js";
+export declare function isLockingSubcommand(sub: string): boolean;
+/**
+ * Split a bash command string into a flat token list.
+ * Supports quoted strings ("…" or '…') as single tokens.
+ * Honors && || | ; connectors by emitting them as separators (kept out).
+ */
+export declare function tokenize(cmd: string): string[];
+/**
+ * From a token list starting with the openspec subcommand
+ * (e.g. ["status", "--change", "add-foo", "--json"]),
+ * find the change name. Skips the leading subcommand token(s).
+ *
+ * Special-cases `new`: its sub-verb (`change` | `spec`) sits between the
+ * subcommand and the name, so we skip 2 tokens for `openspec new change foo`
+ * but only 1 for `openspec status --change foo` / `openspec archive foo`.
+ */
+export declare function extractChangeName(tokens: string[]): string | undefined;
+/**
+ * Parse a bash command line.
+ * Returns null when the command is not an `openspec` invocation.
+ * Recognizes `openspec` anywhere in the pipeline (after `cd X &&`, etc.)
+ * so that worktree prefixes are honored.
+ */
+export declare function parseBashCommand(cmd: string): ParsedBashCommand | null;
+/**
+ * Extract the change name from a bash command line, when the command
+ * is an openspec invocation that locks a change (e.g. `openspec status
+ * --change foo` / `openspec new change foo`). Returns null for
+ * non-locking commands (list, doctor, …) and non-openspec commands.
+ */
+export declare function findSpec(cmd: string): string | null;
+/**
+ * Extract the worktree cwd from a bash command line, when the command
+ * runs inside a worktree (`cd <wt> && openspec …`). Returns null
+ * otherwise.
+ */
+export declare function findWorkTree(cmd: string): string | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAWpD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAID;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAyC9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAqBtE;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAyBtE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvD"}

package/dist/parser.js

@@ -0,0 +1,162 @@
+const LOCKING_SUBCOMMANDS = new Set([
+    "new", "status", "apply", "archive", "verify",
+    "sync", "instructions", "show", "validate", "context", "view",
+]);
+// `openspec new` takes a depth-2 verb: `new change <name>` or `new spec <name>`.
+// `new` alone (e.g. `openspec new --help`) has no name token.
+const NEW_SUBVERBS = new Set(["change", "spec"]);
+export function isLockingSubcommand(sub) {
+    return LOCKING_SUBCOMMANDS.has(sub);
+}
+const CONNECTORS = new Set(["&&", "||", "|", ";"]);
+/**
+ * Split a bash command string into a flat token list.
+ * Supports quoted strings ("…" or '…') as single tokens.
+ * Honors && || | ; connectors by emitting them as separators (kept out).
+ */
+export function tokenize(cmd) {
+    const tokens = [];
+    let buf = "";
+    let quote = null;
+    for (let i = 0; i < cmd.length; i++) {
+        const c = cmd[i];
+        if (quote) {
+            if (c === quote) {
+                quote = null;
+            }
+            else {
+                buf += c;
+            }
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            quote = c;
+            continue;
+        }
+        if (/\s/.test(c)) {
+            if (buf) {
+                tokens.push(buf);
+                buf = "";
+            }
+            continue;
+        }
+        if (CONNECTORS.has(buf + c) || CONNECTORS.has(c)) {
+            if (buf) {
+                tokens.push(buf);
+                buf = "";
+            }
+            // Peek two-char connectors
+            const next = cmd[i + 1];
+            if ((c === "&" || c === "|") && next === c) {
+                i++; // skip second char
+            }
+            continue;
+        }
+        buf += c;
+    }
+    if (buf)
+        tokens.push(buf);
+    return tokens;
+}
+/**
+ * From a token list starting with the openspec subcommand
+ * (e.g. ["status", "--change", "add-foo", "--json"]),
+ * find the change name. Skips the leading subcommand token(s).
+ *
+ * Special-cases `new`: its sub-verb (`change` | `spec`) sits between the
+ * subcommand and the name, so we skip 2 tokens for `openspec new change foo`
+ * but only 1 for `openspec status --change foo` / `openspec archive foo`.
+ */
+export function extractChangeName(tokens) {
+    if (tokens.length === 0)
+        return undefined;
+    let start = 1;
+    if (tokens[0] === "new" &&
+        tokens.length >= 2 &&
+        NEW_SUBVERBS.has(tokens[1])) {
+        start = 2;
+    }
+    for (let i = start; i < tokens.length; i++) {
+        if (tokens[i] === "--change") {
+            const v = tokens[i + 1];
+            if (v && !v.startsWith("--"))
+                return v;
+            continue;
+        }
+        if (tokens[i]?.startsWith("--"))
+            continue; // other flag
+        // first positional
+        if (tokens[i])
+            return tokens[i];
+    }
+    return undefined;
+}
+/**
+ * Find the last `cd <path>` in a token sequence and return the path.
+ * Walks all tokens looking for "cd" followed by a non-flag arg.
+ */
+function lastCdTarget(tokens) {
+    let last;
+    for (let i = 0; i < tokens.length; i++) {
+        if (tokens[i] === "cd" && tokens[i + 1] && !tokens[i + 1].startsWith("--")) {
+            last = tokens[i + 1];
+            i++; // skip path
+        }
+    }
+    return last;
+}
+const WORKTREE_RE = /\.worktrees\/([^/\s]+)/;
+/**
+ * Parse a bash command line.
+ * Returns null when the command is not an `openspec` invocation.
+ * Recognizes `openspec` anywhere in the pipeline (after `cd X &&`, etc.)
+ * so that worktree prefixes are honored.
+ */
+export function parseBashCommand(cmd) {
+    const tokens = tokenize(cmd);
+    if (tokens.length === 0)
+        return null;
+    const openspecIdx = tokens.indexOf("openspec");
+    if (openspecIdx === -1)
+        return null;
+    const subcommand = tokens[openspecIdx + 1] ?? "";
+    // rest includes the subcommand itself; extractChangeName will skip it.
+    const rest = tokens.slice(openspecIdx + 1);
+    // Scan the prefix (everything before `openspec`) for the last `cd <path>`.
+    const cd = lastCdTarget(tokens.slice(0, openspecIdx));
+    const effectiveCwd = cd ?? "";
+    const isWorktree = !!effectiveCwd && WORKTREE_RE.test(effectiveCwd);
+    const isLocking = isLockingSubcommand(subcommand);
+    const changeName = isLocking ? extractChangeName(rest) : undefined;
+    return {
+        subcommand,
+        changeName,
+        effectiveCwd,
+        isWorktree,
+        isLocking,
+    };
+}
+/**
+ * Extract the change name from a bash command line, when the command
+ * is an openspec invocation that locks a change (e.g. `openspec status
+ * --change foo` / `openspec new change foo`). Returns null for
+ * non-locking commands (list, doctor, …) and non-openspec commands.
+ */
+export function findSpec(cmd) {
+    const parsed = parseBashCommand(cmd);
+    if (!parsed)
+        return null;
+    return parsed.isLocking && parsed.changeName ? parsed.changeName : null;
+}
+/**
+ * Extract the worktree cwd from a bash command line, when the command
+ * runs inside a worktree (`cd <wt> && openspec …`). Returns null
+ * otherwise.
+ */
+export function findWorkTree(cmd) {
+    const parsed = parseBashCommand(cmd);
+    if (!parsed)
+        return null;
+    return parsed.isWorktree ? parsed.effectiveCwd : null;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/dist/render.d.ts

@@ -0,0 +1,67 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { PersistedLock } from "./state.js";
+import type { ArtifactStatus, MergedTasks } from "./types.js";
+export declare const ARTIFACT_INITIALS: Record<ArtifactStatus["id"], string>;
+export declare function formatArtifactTokens(statuses: ArtifactStatus[]): string;
+export declare function formatProgressBar(done: number, total: number): string;
+export declare function renderLine(name: string, schemaName: string, statuses: ArtifactStatus[], tasks: MergedTasks): string;
+/**
+ * Base class for debounced status-bar renders.
+ *
+ * The constructor is intentionally side-effect free: creating a render
+ * instance must not publish anything to the status bar. Callers decide
+ * when the initial "no status" publish happens (see the session_start
+ * handler in index.ts). This matters for the lazy render path — a
+ * cancelled `/tui-openspec-select` must leave the status bar untouched.
+ */
+export declare class StatusRender {
+    id: string;
+    ctx: ExtensionContext;
+    timer: ReturnType<typeof setTimeout> | undefined;
+    debounce: number;
+    lastRendered: string;
+    constructor(id: string, ctx: ExtensionContext, debounce?: number);
+    render(): Promise<void>;
+    refresh(): void;
+    renderText(): Promise<string>;
+}
+/**
+ * Renders the openspec change status bar line.
+ *
+ * Owns all tracking state (spec, worktree, manual lock) and the full
+ * multi-source render pipeline: probe `openspec/changes/<name>` in each
+ * source, query `openspec status --json` for the alive ones, merge
+ * artifacts + tasks from main and worktree, then emit the line.
+ *
+ * The optional `onStateChange` callback receives a full
+ * {@link PersistedLock} snapshot (or `null` when all sources are
+ * gone) at every authoritative state transition. Fires occur after
+ * the dedupe early-returns (i.e. only when state actually changed)
+ * and from the auto-unlock branch of `renderText()`. Consumers
+ * (e.g. the session-persistence layer wired in index.ts) use this
+ * to publish the live lock state to pi's custom-message stream.
+ */
+export declare class OpenSpecStatusRender extends StatusRender {
+    spec?: string;
+    worktree?: string;
+    manualLock: boolean;
+    private readonly onStateChange;
+    constructor(id: string, ctx: ExtensionContext, debounce?: number, onStateChange?: (state: PersistedLock | null) => void);
+    /**
+     * Auto-lock from a bash `openspec` command. No-op while a manual
+     * lock (via /tui-openspec-select) is active.
+     */
+    setSpec(spec: string): void;
+    /**
+     * Adopt a worktree cwd (from `cd <worktree> && openspec ...`).
+     * Always applies — even under a manual lock the worktree is an
+     * additional scan source, not a change of the tracked spec.
+     */
+    setWorkTree(worktree: string): void;
+    /** Manual lock via /tui-openspec-select: pins the tracked change. */
+    lock(change: string): void;
+    /** Release the lock and clear the status bar (if a line is showing). */
+    clearLock(): void;
+    renderText(): Promise<string>;
+}
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAKlE,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAKvE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,EAAE,EAC1B,KAAK,EAAE,WAAW,GACjB,MAAM,CAQR;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,gBAAgB,CAAA;IACrB,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,SAAS,CAAA;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,SAAK;gBAEL,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,QAAQ,SAAM;IAMvD,MAAM;IAWZ,OAAO;IAMD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,UAAS;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAEhB;gBAGZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,gBAAgB,EACrB,QAAQ,SAAM,EACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI;IAMvD;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM;IAapB;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM;IAkB5B,qEAAqE;IACrE,IAAI,CAAC,MAAM,EAAE,MAAM;IAYnB,wEAAwE;IACxE,SAAS;IAWM,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CA8D7C"}

package/dist/render.js

@@ -0,0 +1,210 @@
+// src/render.ts
+import { access } from "node:fs/promises";
+import * as path from "node:path";
+import { runOpenspecStatus } from "./openspec.js";
+import { mergeStatusResults, readMergedTasks } from "./merge.js";
+export const ARTIFACT_INITIALS = {
+    proposal: "P",
+    design: "D",
+    specs: "S",
+    tasks: "T",
+};
+const BAR_WIDTH = 10;
+const FILLED = "█";
+const EMPTY = "░";
+export function formatArtifactTokens(statuses) {
+    return statuses
+        .filter((s) => s.id in ARTIFACT_INITIALS)
+        .map((s) => `${ARTIFACT_INITIALS[s.id]}${s.status === "done" ? "●" : "○"}`)
+        .join(" ");
+}
+export function formatProgressBar(done, total) {
+    const d = Math.max(0, Math.min(done, total));
+    const filledCells = total === 0 ? 0 : Math.round((d / total) * BAR_WIDTH);
+    return FILLED.repeat(filledCells) + EMPTY.repeat(BAR_WIDTH - filledCells);
+}
+export function renderLine(name, schemaName, statuses, tasks) {
+    return [
+        name,
+        `(${schemaName})`,
+        `[${formatArtifactTokens(statuses)}]`,
+        "Tasks:",
+        `${formatProgressBar(tasks.done, tasks.total)} ${tasks.done}/${tasks.total}`,
+    ].join(" ");
+}
+/**
+ * Base class for debounced status-bar renders.
+ *
+ * The constructor is intentionally side-effect free: creating a render
+ * instance must not publish anything to the status bar. Callers decide
+ * when the initial "no status" publish happens (see the session_start
+ * handler in index.ts). This matters for the lazy render path — a
+ * cancelled `/tui-openspec-select` must leave the status bar untouched.
+ */
+export class StatusRender {
+    id;
+    ctx;
+    timer;
+    debounce;
+    lastRendered = "";
+    constructor(id, ctx, debounce = 500) {
+        this.id = id;
+        this.ctx = ctx;
+        this.debounce = debounce;
+    }
+    async render() {
+        this.timer = undefined;
+        const text = (await this.renderText()).trim();
+        if (text === this.lastRendered)
+            return;
+        this.lastRendered = text;
+        if (text.length > 0)
+            this.ctx.ui.setStatus(this.id, text);
+        else
+            this.ctx.ui.setStatus(this.id, undefined);
+    }
+    refresh() {
+        if (!this.timer)
+            // Arrow keeps `this` bound when the timer fires.
+            this.timer = setTimeout(() => this.render(), this.debounce);
+    }
+    async renderText() { return ""; }
+}
+/**
+ * Renders the openspec change status bar line.
+ *
+ * Owns all tracking state (spec, worktree, manual lock) and the full
+ * multi-source render pipeline: probe `openspec/changes/<name>` in each
+ * source, query `openspec status --json` for the alive ones, merge
+ * artifacts + tasks from main and worktree, then emit the line.
+ *
+ * The optional `onStateChange` callback receives a full
+ * {@link PersistedLock} snapshot (or `null` when all sources are
+ * gone) at every authoritative state transition. Fires occur after
+ * the dedupe early-returns (i.e. only when state actually changed)
+ * and from the auto-unlock branch of `renderText()`. Consumers
+ * (e.g. the session-persistence layer wired in index.ts) use this
+ * to publish the live lock state to pi's custom-message stream.
+ */
+export class OpenSpecStatusRender extends StatusRender {
+    spec;
+    worktree;
+    manualLock = false;
+    onStateChange;
+    constructor(id, ctx, debounce = 500, onStateChange) {
+        super(id, ctx, debounce);
+        this.onStateChange = onStateChange;
+    }
+    /**
+     * Auto-lock from a bash `openspec` command. No-op while a manual
+     * lock (via /tui-openspec-select) is active.
+     */
+    setSpec(spec) {
+        if (this.manualLock)
+            return;
+        if (this.spec === spec)
+            return;
+        this.spec = spec;
+        this.onStateChange?.({
+            spec: this.spec,
+            worktree: this.worktree,
+            manualLock: false,
+            version: 1,
+        });
+        this.refresh();
+    }
+    /**
+     * Adopt a worktree cwd (from `cd <worktree> && openspec ...`).
+     * Always applies — even under a manual lock the worktree is an
+     * additional scan source, not a change of the tracked spec.
+     */
+    setWorkTree(worktree) {
+        if (this.worktree === worktree)
+            return;
+        this.worktree = worktree;
+        // A worktree change without a tracked spec has no persistable
+        // full lock snapshot (PersistedLock.spec is required); skip the
+        // fire. The restore path only calls setWorkTree when a spec is
+        // present, so no persisted state is lost.
+        if (this.spec) {
+            this.onStateChange?.({
+                spec: this.spec,
+                worktree: this.worktree,
+                manualLock: this.manualLock,
+                version: 1,
+            });
+        }
+        this.refresh();
+    }
+    /** Manual lock via /tui-openspec-select: pins the tracked change. */
+    lock(change) {
+        this.manualLock = true;
+        this.spec = change;
+        this.onStateChange?.({
+            spec: this.spec,
+            worktree: this.worktree,
+            manualLock: true,
+            version: 1,
+        });
+        this.refresh();
+    }
+    /** Release the lock and clear the status bar (if a line is showing). */
+    clearLock() {
+        this.manualLock = false;
+        this.spec = undefined;
+        this.worktree = "";
+        this.onStateChange?.(null);
+        if (this.lastRendered !== "") {
+            this.lastRendered = "";
+            this.ctx.ui.setStatus(this.id, undefined);
+        }
+    }
+    async renderText() {
+        const name = this.spec;
+        if (!name)
+            return "";
+        const mainCwd = this.ctx.cwd;
+        const wtCwd = this.worktree ?? "";
+        const sources = [{ cwd: mainCwd, kind: "main" }];
+        if (wtCwd)
+            sources.push({ cwd: wtCwd, kind: "worktree" });
+        // Probe each source's change folder in parallel. A missing folder
+        // is "skip this source", not "fail the render". Only when ALL
+        // sources are gone do we treat the change as fully archived and
+        // unlock.
+        const aliveFlags = await Promise.all(sources.map(async (s) => {
+            const dir = path.join(s.cwd, "openspec", "changes", name);
+            try {
+                await access(dir);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }));
+        const aliveSources = sources.filter((_, i) => aliveFlags[i]);
+        // Cleared or re-locked mid-render — never unlock or publish for a
+        // stale change.
+        if (this.spec !== name)
+            return "";
+        if (aliveSources.length === 0) {
+            // Fully archived (or all worktrees removed): release the lock.
+            this.spec = undefined;
+            this.worktree = "";
+            this.manualLock = false;
+            this.onStateChange?.(null);
+            return "";
+        }
+        // Query each alive source in parallel; merge artifacts/schema.
+        const [statusResults, tasks] = await Promise.all([
+            Promise.all(aliveSources.map((s) => runOpenspecStatus(name, s.cwd))),
+            readMergedTasks(name, mainCwd, wtCwd || undefined),
+        ]);
+        // Cleared or re-locked while the queries were in flight.
+        if (this.spec !== name)
+            return "";
+        const status = mergeStatusResults(statusResults);
+        return renderLine(name, status?.schemaName || "spec-driven", (status?.artifacts ?? []), tasks);
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}

package/dist/state.d.ts

@@ -0,0 +1,10 @@
+import type { SessionEntry } from "@earendil-works/pi-coding-agent";
+export interface PersistedLock {
+    spec: string;
+    worktree?: string;
+    manualLock: boolean;
+    version: 1;
+}
+export declare const LOCK_CUSTOM_TYPE = "pi-tui-openspec-status";
+export declare function findLastPersistedLock(entries: SessionEntry[]): PersistedLock | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAQzD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,aAAa,GAAG,IAAI,CAWnF"}

package/dist/state.js

@@ -0,0 +1,22 @@
+export const LOCK_CUSTOM_TYPE = "pi-tui-openspec-status";
+function isPersistedLock(data) {
+    if (typeof data !== "object" || data === null)
+        return false;
+    const d = data;
+    return d.version === 1 && typeof d.spec === "string" && typeof d.manualLock === "boolean";
+}
+export function findLastPersistedLock(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const e = entries[i];
+        if (!e)
+            continue;
+        if (e.type === "custom" && e.customType === LOCK_CUSTOM_TYPE) {
+            const data = e.data;
+            if (isPersistedLock(data))
+                return data;
+            return null; // latest matching entry is dirty — stop, fall back to empty
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAEzD,SAAS,eAAe,CAAC,IAAa;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,gBAAgB,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,IAAI,eAAe,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvC,OAAO,IAAI,CAAC,CAAC,4DAA4D;QAC3E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+export interface ArtifactStatus {
+    id: "proposal" | "design" | "specs" | "tasks";
+    status: "done" | "ready" | "blocked" | "skipped";
+}
+export interface StatusJson {
+    artifacts?: ArtifactStatus[];
+    applied?: boolean;
+    schemaName?: string;
+    [key: string]: unknown;
+}
+export interface ParsedBashCommand {
+    subcommand: string;
+    changeName?: string;
+    effectiveCwd: string;
+    isWorktree: boolean;
+    isLocking: boolean;
+}
+export interface MergedTasks {
+    done: number;
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9C,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@philogag/pi-tui-openspec-status",
+  "version": "0.1.0",
+  "description": "pi extension: single-line status bar tracking openspec status",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "pi",
+    "extension",
+    "tui",
+    "openspec"
+  ],
+  "dependencies": {},
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.84.3",
+    "@earendil-works/pi-tui": "latest",
+    "typebox": "latest"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.84.3",
+    "@earendil-works/pi-tui": "latest",
+    "typebox": "latest",
+    "typescript": "^5.6.3",
+    "vitest": "latest"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --noEmit",
+    "test": "vitest run",
+    "lint": "echo \"no linter configured\""
+  }
+}