@openrig/cli 0.4.4 → 0.4.7

package/daemon/dist/domain/terminal/terminal-service.d.ts

@@ -0,0 +1,60 @@
+import type { LiveSeatRow, SavedView, TerminalViewsStore } from "./terminal-views-store.js";
+import type { HostEntry } from "../hosts/hosts-registry-reader.js";
+import type { OpenViewResult, ProviderLiveness, ProviderStatus, TerminalProvider } from "./terminal-provider.js";
+/** The v1 provider name set (herdr = proof-gated primary; cmux = best-effort). */
+export type TerminalProviderName = "herdr" | "cmux";
+export declare const DEFAULT_PROVIDER: TerminalProviderName;
+export interface OpenViewRequest {
+    /** Provider name; defaults to herdr when omitted. */
+    provider?: string;
+    /** The view argument: a rig name | `mission:<id>` | `slice:<id>` | a saved-view id. */
+    view: string;
+}
+/** The `rig terminal views` payload: saved views + the live rig names you can open. */
+export interface ListViewsResult {
+    saved: SavedView[];
+    /** Rig names openable as per-rig derived views (live from the inventory). */
+    rigs: string[];
+}
+/** One provider's doctor line for `rig terminal status`. */
+export interface ProviderStatusReport {
+    name: string;
+    status: ProviderStatus;
+    liveness: ProviderLiveness;
+}
+export interface TerminalStatusResult {
+    providers: ProviderStatusReport[];
+}
+export interface TerminalServiceDeps {
+    /** Resolve a provider name to its adapter, or null for an unknown name. */
+    resolveProvider(name: string): TerminalProvider | null;
+    /** The saved-views store (read paths only from this service). */
+    viewsStore: Pick<TerminalViewsStore, "get" | "list">;
+    /** Live seats of a rig BY NAME; null when no such rig is known (vs [] = a known-but-empty rig). */
+    listRigSeats(rigName: string): Promise<LiveSeatRow[] | null> | LiveSeatRow[] | null;
+    /** Live seats of a pod within a rig (by rig name-or-id + pod namespace); null when the rig/pod is unknown. */
+    listPodSeats(rigArg: string, podNamespace: string): Promise<LiveSeatRow[] | null> | LiveSeatRow[] | null;
+    /** Live seats for a derived scope (`mission:<id>` | `slice:<id>`); null when the scope is unknown/invalid. */
+    listScopeSeats(scope: string): Promise<LiveSeatRow[] | null> | LiveSeatRow[] | null;
+    /** Known rig names (for the `views` listing). */
+    listRigNames(): Promise<string[]> | string[];
+    /** Read-only host resolution for the composer (registry unavailable → null for every id). */
+    resolveHost(id: string): HostEntry | null;
+    /** Local liveness refine — has-session for a local tmux session; remote members are not probed here. */
+    hasSession(tmuxSession: string): Promise<boolean> | boolean;
+}
+export declare class TerminalService {
+    private readonly deps;
+    constructor(deps: TerminalServiceDeps);
+    /** Open a view in the chosen provider. Always returns the one shared result shape. */
+    openView(req: OpenViewRequest): Promise<OpenViewResult>;
+    /** List saved views + the rig names openable as derived views. */
+    listViews(): Promise<ListViewsResult>;
+    /** Provider availability + liveness (doctor). Unknown named provider → empty report for it. */
+    status(providerName?: string): Promise<TerminalStatusResult>;
+    /** Resolve a view argument into composer-ready members (precedence in the file header). */
+    private resolveView;
+    /** Refine local members' liveness with a real has-session probe (a dead seat → absent, honest-partial). */
+    private refineLiveness;
+}
+//# sourceMappingURL=terminal-service.d.ts.map

package/daemon/dist/domain/terminal/terminal-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-service.d.ts","sourceRoot":"","sources":["../../../src/domain/terminal/terminal-service.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EAET,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,CAAC;AACpD,eAAO,MAAM,gBAAgB,EAAE,oBAA8B,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACvD,iEAAiE;IACjE,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;IACrD,mGAAmG;IACnG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;IACpF,8GAA8G;IAC9G,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;IACzG,8GAA8G;IAC9G,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;IACpF,iDAAiD;IACjD,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;IAC7C,6FAA6F;IAC7F,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1C,wGAAwG;IACxG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC7D;AA0BD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,mBAAmB;IAEtD,sFAAsF;IAChF,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA4B7D,kEAAkE;IAC5D,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAO3C,+FAA+F;IACzF,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkBlE,2FAA2F;YAC7E,WAAW;IAyDzB,2GAA2G;YAC7F,cAAc;CAW7B"}

package/daemon/dist/domain/terminal/terminal-service.js

@@ -0,0 +1,174 @@
+// OPR.0.4.6.02 C3 — the TerminalService orchestrator.
+//
+// ONE daemon-side composer for EVERY view kind (arch R1 / guard b1): the
+// canonical route and the CLI both call this, so there is never a second
+// composition path. It resolves a view ARGUMENT into composer-ready members,
+// composes them into a provider-neutral `ComposedView` (the pure `composeView`
+// owns the local/ssh/http/read-only partition rules), and hands that to the
+// chosen `TerminalProvider`. It adds no pixel logic and no provider-specific
+// branching — the provider paints, the composer partitions, this service only
+// RESOLVES + ROUTES.
+//
+// View argument resolution (precedence):
+//   1. `mission:<id>` / `slice:<id>`  → derived, LIVE from the review agents
+//      band; READ-ONLY by construction (a cross-rig observational grouping —
+//      AC-3 "another rig's agents ... read-only"). Never persisted (A3).
+//   2. a rig NAME                      → per-rig derived, LIVE from the node
+//      inventory; INTERACTIVE (you asked for that rig, you drive it — AC-1c).
+//   3. a saved-view id                 → from `terminal-views.yaml`; per-member
+//      read-only as the operator saved it.
+//   Anything else → a named `view_not_found` (never a silent empty open).
+//
+// The read-only policy above is a v1 build decision grounded in AC-1c/AC-3
+// (interactive rig view vs read-only cross-rig/derived view); it is NAMED here
+// for the guard/QA gates, not silently absorbed. Saved views carry their own
+// per-member read-only, so an operator can save an interactive multi-rig view
+// deliberately.
+//
+// The one shared result shape is `OpenViewResult { opened, absent, degraded }`
+// (arch Q3): this service returns it for resolution failures too (view/provider
+// not found), so the route JSON and the CLI JSON carry ONE contract for every
+// outcome.
+import { composeView } from "./view-composer.js";
+// deriveViewMembers is a VALUE exported by the views store (not the composer).
+import { deriveViewMembers } from "./terminal-views-store.js";
+export const DEFAULT_PROVIDER = "herdr";
+/** Build the one shared result shape for a pre-provider failure (view/provider not found). */
+function errorResult(provider, code, error) {
+    return { provider, ok: false, opened: [], absent: [], degraded: [], pages: 0, error, code };
+}
+/** Map a persisted saved-view member to a composer input (defaults filled; alive refined later). */
+function savedMemberToInput(m) {
+    return {
+        seat: m.seat,
+        label: m.label ?? m.seat,
+        // A local saved member without an explicit tmuxSession falls back to the
+        // seat's canonical name (the common local seat == session case); a wrong
+        // guess simply lands the seat in absent[] at compose time (honest).
+        tmuxSession: m.tmuxSession ?? m.seat,
+        host: m.host ?? null,
+        readOnly: m.readOnly === true,
+        // Refined by refineLiveness for local members; remote members are routed by
+        // the composer regardless (ssh reachability is not a has-session concern).
+        alive: true,
+    };
+}
+export class TerminalService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Open a view in the chosen provider. Always returns the one shared result shape. */
+    async openView(req) {
+        const providerName = (req.provider ?? DEFAULT_PROVIDER).trim() || DEFAULT_PROVIDER;
+        const provider = this.deps.resolveProvider(providerName);
+        if (!provider) {
+            return errorResult(providerName, "unknown_provider", `unknown provider '${providerName}' — expected herdr or cmux`);
+        }
+        const view = (req.view ?? "").trim();
+        if (!view) {
+            return errorResult(providerName, "view_required", "a view argument is required (a rig name, mission:<id>, slice:<id>, or a saved-view id)");
+        }
+        const resolved = await this.resolveView(view);
+        if ("code" in resolved) {
+            return errorResult(providerName, resolved.code, resolved.error);
+        }
+        const refined = await this.refineLiveness(resolved.members);
+        const composed = composeView(resolved.id, refined, {
+            resolveHost: (id) => this.deps.resolveHost(id),
+        });
+        return provider.openView(composed);
+    }
+    /** List saved views + the rig names openable as derived views. */
+    async listViews() {
+        return {
+            saved: this.deps.viewsStore.list(),
+            rigs: await this.deps.listRigNames(),
+        };
+    }
+    /** Provider availability + liveness (doctor). Unknown named provider → empty report for it. */
+    async status(providerName) {
+        const names = providerName ? [providerName] : ["herdr", "cmux"];
+        const providers = [];
+        for (const name of names) {
+            const p = this.deps.resolveProvider(name);
+            if (!p) {
+                providers.push({
+                    name,
+                    status: { provider: name, available: false, capabilities: {} },
+                    liveness: { alive: false, detail: `unknown provider '${name}'` },
+                });
+                continue;
+            }
+            providers.push({ name, status: await p.status(), liveness: await p.liveness() });
+        }
+        return { providers };
+    }
+    /** Resolve a view argument into composer-ready members (precedence in the file header). */
+    async resolveView(view) {
+        // 1. derived scope prefixes → live, read-only, never persisted.
+        if (view.startsWith("mission:") || view.startsWith("slice:")) {
+            const rows = await this.deps.listScopeSeats(view);
+            if (rows == null) {
+                return { code: "view_not_found", error: `unknown or invalid scope '${view}'` };
+            }
+            return {
+                id: view,
+                members: deriveViewMembers(rows, { readOnly: true, labelSuffix: view }),
+            };
+        }
+        // 2. a pod within a rig — `pod:<rig-id-or-name>/<podNamespace>` (AC-5 launcher
+        //    target). Interactive (a subset of your own rig).
+        if (view.startsWith("pod:")) {
+            const rest = view.slice("pod:".length);
+            const slash = rest.lastIndexOf("/");
+            if (slash <= 0 || slash === rest.length - 1) {
+                return { code: "view_not_found", error: `malformed pod view '${view}' — expected pod:<rig>/<pod>` };
+            }
+            const rows = await this.deps.listPodSeats(rest.slice(0, slash), rest.slice(slash + 1));
+            if (rows == null) {
+                return { code: "view_not_found", error: `unknown pod '${rest.slice(slash + 1)}' in rig '${rest.slice(0, slash)}'` };
+            }
+            return { id: view, members: deriveViewMembers(rows, { readOnly: false }) };
+        }
+        // 3. a rig — either the bare name (the common case: `rig terminal open acme`)
+        //    or the explicit `rig:<id-or-name>` form the rig-scoped route alias
+        //    composes (arch R1: the alias just prefixes `rig:<rigId>` and delegates,
+        //    zero composition logic of its own). `listRigSeats` resolves the arg as
+        //    a rig name first, then as a rig id.
+        const explicitRig = view.startsWith("rig:");
+        const rigArg = explicitRig ? view.slice("rig:".length) : view;
+        const rigRows = await this.deps.listRigSeats(rigArg);
+        if (rigRows != null) {
+            return { id: `rig:${rigArg}`, members: deriveViewMembers(rigRows, { readOnly: false }) };
+        }
+        // An explicit `rig:<x>` that resolves to no rig is a named not-found — it must
+        // NOT fall through to the saved-view lookup (the caller asked for a rig).
+        if (explicitRig) {
+            return { code: "view_not_found", error: `unknown rig '${rigArg}'` };
+        }
+        // 4. a saved-view id.
+        const saved = this.deps.viewsStore.get(view);
+        if (saved) {
+            return { id: saved.id, members: saved.members.map(savedMemberToInput) };
+        }
+        return {
+            code: "view_not_found",
+            error: `unknown view '${view}' — not a known rig, a mission:/slice: scope, or a saved-view id`,
+        };
+    }
+    /** Refine local members' liveness with a real has-session probe (a dead seat → absent, honest-partial). */
+    async refineLiveness(members) {
+        const out = [];
+        for (const m of members) {
+            if (m.host === null && m.tmuxSession) {
+                out.push({ ...m, alive: await this.deps.hasSession(m.tmuxSession) });
+            }
+            else {
+                out.push(m);
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=terminal-service.js.map

package/daemon/dist/domain/terminal/terminal-service.js.map

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

package/daemon/dist/domain/terminal/terminal-views-store.d.ts

@@ -0,0 +1,77 @@
+import type { ViewMemberInput } from "./view-composer.js";
+/** One persisted member of a saved view. Optionals are omitted-when-absent on write. */
+export interface SavedViewMember {
+    /** Canonical session name of the seat. */
+    seat: string;
+    /** Pane label — `<agent> · <slice>`. */
+    label?: string;
+    /** Structured host id (never a `member@rig@host` string). Omitted for a local seat. */
+    host?: string;
+    /** The tmux session to attach to. */
+    tmuxSession?: string;
+    /** View-only / read-only attach. Omitted (defaults false) when not read-only. */
+    readOnly?: boolean;
+}
+export interface SavedView {
+    id: string;
+    name: string;
+    members: SavedViewMember[];
+}
+export interface TerminalViewsFile {
+    version: 1;
+    views: SavedView[];
+}
+export declare class TerminalViewsStore {
+    private readonly path;
+    constructor(path?: string);
+    /** The resolved on-disk path (useful for tests / diagnostics). */
+    getPath(): string;
+    /**
+     * Read-at-launch. An absent file yields the empty set. A malformed file
+     * throws (honest — never a silent reset that would discard operator layouts).
+     */
+    read(): TerminalViewsFile;
+    list(): SavedView[];
+    get(id: string): SavedView | null;
+    /**
+     * Persist a SAVED view (upsert by id). Atomic (tmp + rename) and byte-stable.
+     * Returns the resulting file. Only accepts `SavedView` — a derived view can
+     * never reach disk through this path (A3).
+     */
+    save(view: SavedView): TerminalViewsFile;
+    /** Remove a saved view by id (idempotent). Atomic. */
+    remove(id: string): TerminalViewsFile;
+    private writeAtomic;
+}
+/**
+ * The minimal structural shape of a live seat row the derived-view mapper
+ * needs. Deliberately a subset (not an import of `NodeInventoryEntry`) so this
+ * module stays free of the inventory's transitive deps and is trivially
+ * testable. Field names match `NodeInventoryEntry`.
+ */
+export interface LiveSeatRow {
+    canonicalSessionName: string | null;
+    /** "tmux" for tmux-backed seats; other kinds have no attachable pane. */
+    attachmentType: string | null;
+    /** The tmux session name (canonical session name for tmux-backed seats). */
+    tmuxSession?: string | null;
+    rigName?: string | null;
+    logicalId?: string | null;
+}
+/** Options controlling how a derived view labels/scopes its members. */
+export interface DeriveOptions {
+    /** Structured host id to stamp on every derived member (remote scope); omit for local. */
+    host?: string | null;
+    /** When true, members attach read-only (`-r`) — cross-rig / view-only derived scopes. */
+    readOnly?: boolean;
+    /** Slice/mission label suffix for the pane label (`<agent> · <slice>`); optional. */
+    labelSuffix?: string;
+}
+/**
+ * Map a live seat inventory into composer-ready members. PURE and IN-MEMORY —
+ * the result is handed straight to `composeView`; it is NEVER written to the
+ * saved-views file. Non-tmux / session-less rows are dropped from the derived
+ * set (a derived view only tiles attachable seats; saved views name absents).
+ */
+export declare function deriveViewMembers(rows: LiveSeatRow[], opts?: DeriveOptions): ViewMemberInput[];
+//# sourceMappingURL=terminal-views-store.d.ts.map

package/daemon/dist/domain/terminal/terminal-views-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-views-store.d.ts","sourceRoot":"","sources":["../../../src/domain/terminal/terminal-views-store.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AA2BD,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,MAAqD;IAExF,kEAAkE;IAClE,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,IAAI,IAAI,iBAAiB;IAgBzB,IAAI,IAAI,SAAS,EAAE;IAInB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIjC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB;IAWxC,sDAAsD;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB;IAUrC,OAAO,CAAC,WAAW;CAKpB;AAID;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,yEAAyE;IACzE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EAAE,EACnB,IAAI,GAAE,aAAkB,GACvB,eAAe,EAAE,CAsBnB"}

package/daemon/dist/domain/terminal/terminal-views-store.js

@@ -0,0 +1,146 @@
+// OPR.0.4.6.02 C2 — the terminal-views store.
+//
+// SAVED views persist to `terminal-views.yaml` at the OPENRIG_HOME root
+// (VM-isolatable via OPENRIG_HOME). They are write-once/read-at-launch: the
+// daemon reads them at launch and the operator's saved layouts survive
+// restarts. Each saved member carries a STRUCTURED `host` field (a host id,
+// never a `member@rig@host` string — MH BR-1).
+//
+// DERIVED views (per-rig / per-mission / per-slice) are computed LIVE from the
+// live seat inventory + the review agents band and are NEVER written to disk
+// (A3). That invariant is structural, not conventional: this module exposes
+// `deriveViewMembers` (a pure mapper) and a `save()` that only ever accepts a
+// `SavedView` — there is no code path that persists a derived view.
+//
+// Writes are atomic (tmp + rename on the same filesystem) and byte-stable:
+// serialization uses a fixed field order and OMITS absent optionals (never
+// null), so a read→save round-trip of the same logical content is idempotent.
+import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { getDefaultOpenRigPath } from "../../openrig-compat.js";
+const EMPTY_FILE = { version: 1, views: [] };
+/** Build a member object in fixed key order, omitting absent optionals (never null). */
+function normalizeMember(m) {
+    const out = { seat: m.seat };
+    if (m.label != null && m.label !== "")
+        out.label = m.label;
+    if (m.host != null && m.host !== "")
+        out.host = m.host;
+    if (m.tmuxSession != null && m.tmuxSession !== "")
+        out.tmuxSession = m.tmuxSession;
+    if (m.readOnly === true)
+        out.readOnly = true;
+    return out;
+}
+function normalizeView(v) {
+    return { id: v.id, name: v.name, members: v.members.map(normalizeMember) };
+}
+/** Canonical byte-stable serialization of the whole file (fixed order, omit-when-absent). */
+function serialize(file) {
+    const normalized = {
+        version: 1,
+        views: file.views.map(normalizeView),
+    };
+    return stringifyYaml(normalized);
+}
+export class TerminalViewsStore {
+    path;
+    constructor(path = getDefaultOpenRigPath("terminal-views.yaml")) {
+        this.path = path;
+    }
+    /** The resolved on-disk path (useful for tests / diagnostics). */
+    getPath() {
+        return this.path;
+    }
+    /**
+     * Read-at-launch. An absent file yields the empty set. A malformed file
+     * throws (honest — never a silent reset that would discard operator layouts).
+     */
+    read() {
+        if (!existsSync(this.path))
+            return { version: 1, views: [] };
+        const raw = readFileSync(this.path, "utf-8");
+        const parsed = parseYaml(raw);
+        if (parsed == null)
+            return { version: 1, views: [] };
+        if (typeof parsed !== "object") {
+            throw new Error(`terminal views file at ${this.path} must be a YAML object with a 'views' array`);
+        }
+        const obj = parsed;
+        const views = obj["views"];
+        if (!Array.isArray(views)) {
+            throw new Error(`terminal views file at ${this.path}: 'views' must be an array`);
+        }
+        return { version: 1, views: views };
+    }
+    list() {
+        return this.read().views;
+    }
+    get(id) {
+        return this.read().views.find((v) => v.id === id) ?? null;
+    }
+    /**
+     * Persist a SAVED view (upsert by id). Atomic (tmp + rename) and byte-stable.
+     * Returns the resulting file. Only accepts `SavedView` — a derived view can
+     * never reach disk through this path (A3).
+     */
+    save(view) {
+        const current = this.read();
+        const idx = current.views.findIndex((v) => v.id === view.id);
+        const next = [...current.views];
+        if (idx >= 0)
+            next[idx] = view;
+        else
+            next.push(view);
+        const file = { version: 1, views: next };
+        this.writeAtomic(file);
+        return { version: 1, views: file.views.map(normalizeView) };
+    }
+    /** Remove a saved view by id (idempotent). Atomic. */
+    remove(id) {
+        const current = this.read();
+        const file = {
+            version: 1,
+            views: current.views.filter((v) => v.id !== id),
+        };
+        this.writeAtomic(file);
+        return { version: 1, views: file.views.map(normalizeView) };
+    }
+    writeAtomic(file) {
+        const tmp = `${this.path}.tmp`;
+        writeFileSync(tmp, serialize(file), "utf-8");
+        renameSync(tmp, this.path);
+    }
+}
+/**
+ * Map a live seat inventory into composer-ready members. PURE and IN-MEMORY —
+ * the result is handed straight to `composeView`; it is NEVER written to the
+ * saved-views file. Non-tmux / session-less rows are dropped from the derived
+ * set (a derived view only tiles attachable seats; saved views name absents).
+ */
+export function deriveViewMembers(rows, opts = {}) {
+    const members = [];
+    for (const row of rows) {
+        if (row.attachmentType !== "tmux")
+            continue;
+        const seat = row.canonicalSessionName;
+        if (!seat)
+            continue;
+        const tmuxSession = row.tmuxSession ?? row.canonicalSessionName;
+        const agent = row.logicalId ?? seat;
+        const label = opts.labelSuffix ? `${agent} · ${opts.labelSuffix}` : agent;
+        members.push({
+            seat,
+            label,
+            tmuxSession,
+            host: opts.host ?? null,
+            readOnly: opts.readOnly === true,
+            // Derived views are live: presence in the inventory IS the liveness
+            // signal for the derived set; a stricter has-session probe layers on at
+            // compose time for local members if the caller supplies one.
+            alive: true,
+        });
+    }
+    return members;
+}
+//# sourceMappingURL=terminal-views-store.js.map

package/daemon/dist/domain/terminal/terminal-views-store.js.map

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

package/daemon/dist/domain/terminal/view-composer.d.ts

@@ -0,0 +1,42 @@
+import type { HostEntry } from "../hosts/hosts-registry-reader.js";
+import type { ComposedPane, ComposedView } from "./terminal-provider.js";
+/**
+ * Panes per grid page (3×3). Overflow spills to the next provider tab/page.
+ * A module constant in v1 — a future per-rig `terminal.tiles_per_page` config
+ * key is a natural extension, but no config key ships in this slice (the plan
+ * keeps the C1 config surface to the single `terminal.status_bar` key).
+ */
+export declare const PANES_PER_PAGE = 9;
+/**
+ * One resolved member of a view, ready to compose. `alive` and `readOnly` are
+ * decided upstream (liveness probe + cross-rig/saved-read-only policy); the
+ * composer only routes on them. `host` is a structured host id or null (local).
+ */
+export interface ViewMemberInput {
+    /** Canonical session name of the seat. */
+    seat: string;
+    /** Pane label — `<agent> · <slice>` (AC-7). */
+    label: string;
+    /** The tmux session to attach to (may be null if the seat has no tmux binding). */
+    tmuxSession: string | null;
+    /** Structured host id when remote; null for a local seat. */
+    host: string | null;
+    /** View-only / cross-rig membership → read-only (`-r`) attach. */
+    readOnly: boolean;
+    /** Local liveness (has-session). Ignored for remote members (reachability is an ssh concern). */
+    alive: boolean;
+}
+/** The composer's only side-channel: read-only host resolution from the registry. */
+export interface ComposeContext {
+    /** Resolve a host id to its registry entry, or null if the id is unknown. */
+    resolveHost(id: string): HostEntry | null;
+}
+/** Chunk panes into fixed-size grid pages (one provider tab per page). */
+export declare function chunkPanes(panes: ComposedPane[], perPage?: number): ComposedPane[][];
+/**
+ * Compose a resolved member list into a provider-neutral view. Pure: same
+ * inputs → byte-identical output. Member order is preserved into `opened`
+ * (and therefore into page assignment), so paging is deterministic.
+ */
+export declare function composeView(id: string, members: ViewMemberInput[], ctx: ComposeContext): ComposedView;
+//# sourceMappingURL=view-composer.d.ts.map

package/daemon/dist/domain/terminal/view-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-composer.d.ts","sourceRoot":"","sources":["../../../src/domain/terminal/view-composer.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EAEb,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,iGAAiG;IACjG,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CAC3C;AAYD,0EAA0E;AAC1E,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,MAAuB,GAC/B,YAAY,EAAE,EAAE,CAOlB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,eAAe,EAAE,EAC1B,GAAG,EAAE,cAAc,GAClB,YAAY,CA2Fd"}