@spinabot/brigade 0.1.2 → 1.0.1

package/dist/core/server-methods/cron.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Cron-related gateway method handlers.
+ *
+ * Brand-scrubbed analogue of the reference cron handler module. Eight methods
+ * covering the full operator surface:
+ *
+ *   - `wake`        — inject a system event into a session
+ *   - `cron.list`   — paginated job list
+ *   - `cron.status` — service-level snapshot
+ *   - `cron.add`    — create job (flat-param recovery handled by tool layer)
+ *   - `cron.update` — patch one job by id (accepts `id` or `jobId`)
+ *   - `cron.remove` — delete one job by id
+ *   - `cron.run`    — fire a job NOW (force or due-only; enqueued)
+ *   - `cron.runs`   — read run-log history (scope: per-job or all jobs)
+ *
+ * All handlers are PURE — they take params + a service-context bundle and
+ * return a result. The WebSocket framing + the in-process registry wire-up
+ * live one level up in `server.ts` / `gateway-caller-impl.ts`.
+ *
+ * Error shaping matches the rest of the gateway: throw `Error(message)` on
+ * validation / not-found / invalid-id; the response framer converts to a
+ * typed `ProtocolErrorShape`. The single non-throw degrade path is
+ * `cron.run` — when the persisted sessionTarget id is malformed, the
+ * handler returns `{ok:true, ran:false, reason:"invalid-spec"}` instead of
+ * throwing, mirroring the reference's soft-OK degrade.
+ */
+import { type CronServiceStatus, type ListPageResult } from "../../cron/service/ops.js";
+import type { CronServiceState } from "../../cron/service/state.js";
+import type { CronJob, CronJobCreate, CronJobPatch, CronRunLogEntry, CronWakeMode } from "../../cron/types.js";
+/** Service context bundle every handler receives. */
+export interface CronHandlerContext {
+    /** Live cron service state — null when the service hasn't started. */
+    state: CronServiceState | null;
+}
+export interface CronWakeParams {
+    text: string;
+    mode?: CronWakeMode;
+    agentId?: string;
+    sessionKey?: string;
+}
+export interface CronListParamsV2 {
+    includeDisabled?: boolean;
+    limit?: number;
+    offset?: number;
+    query?: string;
+    enabled?: "all" | "enabled" | "disabled";
+    sortBy?: "nextRunAtMs" | "updatedAtMs" | "name";
+    sortDir?: "asc" | "desc";
+}
+export type CronStatusParamsV2 = Record<string, never>;
+export type CronAddParamsV2 = CronJobCreate & {
+    sessionKey?: string;
+};
+export interface CronUpdateParamsV2 {
+    id?: string;
+    jobId?: string;
+    patch: CronJobPatch;
+}
+export interface CronRemoveParamsV2 {
+    id?: string;
+    jobId?: string;
+}
+export interface CronRunParamsV2 {
+    id?: string;
+    jobId?: string;
+    mode?: "due" | "force";
+}
+export interface CronRunsParamsV2 {
+    scope?: "job" | "all";
+    id?: string;
+    jobId?: string;
+    limit?: number;
+    offset?: number;
+    status?: "ok" | "error" | "skipped";
+}
+export type CronAddResultV2 = CronJob;
+export type CronListResultV2 = ListPageResult;
+export type CronStatusResultV2 = CronServiceStatus;
+export type CronUpdateResultV2 = CronJob;
+export interface CronRemoveResultV2 {
+    removed: boolean;
+}
+export type CronRunResultV2 = {
+    ok: true;
+    enqueued: true;
+    jobId: string;
+    mode: "due" | "force";
+} | {
+    ok: true;
+    ran: false;
+    reason: "invalid-spec";
+};
+export interface CronRunsResultV2 {
+    entries: ReadonlyArray<CronRunLogEntry>;
+}
+export declare function handleWake(params: CronWakeParams, ctx: CronHandlerContext): void;
+export declare function handleCronList(params: CronListParamsV2 | undefined, ctx: CronHandlerContext): Promise<CronListResultV2>;
+export declare function handleCronStatus(_params: CronStatusParamsV2 | undefined, ctx: CronHandlerContext): Promise<CronStatusResultV2>;
+export declare function handleCronAdd(params: CronAddParamsV2, ctx: CronHandlerContext): Promise<CronAddResultV2>;
+export declare function handleCronUpdate(params: CronUpdateParamsV2, ctx: CronHandlerContext): Promise<CronUpdateResultV2>;
+export declare function handleCronRemove(params: CronRemoveParamsV2, ctx: CronHandlerContext): Promise<CronRemoveResultV2>;
+export declare function handleCronRun(params: CronRunParamsV2, ctx: CronHandlerContext): Promise<CronRunResultV2>;
+export declare function handleCronRuns(params: CronRunsParamsV2, ctx: CronHandlerContext): Promise<CronRunsResultV2>;
+//# sourceMappingURL=cron.d.ts.map

package/dist/core/server-methods/cron.d.ts.map

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

package/dist/core/server-methods/cron.js

@@ -0,0 +1,183 @@
+/**
+ * Cron-related gateway method handlers.
+ *
+ * Brand-scrubbed analogue of the reference cron handler module. Eight methods
+ * covering the full operator surface:
+ *
+ *   - `wake`        — inject a system event into a session
+ *   - `cron.list`   — paginated job list
+ *   - `cron.status` — service-level snapshot
+ *   - `cron.add`    — create job (flat-param recovery handled by tool layer)
+ *   - `cron.update` — patch one job by id (accepts `id` or `jobId`)
+ *   - `cron.remove` — delete one job by id
+ *   - `cron.run`    — fire a job NOW (force or due-only; enqueued)
+ *   - `cron.runs`   — read run-log history (scope: per-job or all jobs)
+ *
+ * All handlers are PURE — they take params + a service-context bundle and
+ * return a result. The WebSocket framing + the in-process registry wire-up
+ * live one level up in `server.ts` / `gateway-caller-impl.ts`.
+ *
+ * Error shaping matches the rest of the gateway: throw `Error(message)` on
+ * validation / not-found / invalid-id; the response framer converts to a
+ * typed `ProtocolErrorShape`. The single non-throw degrade path is
+ * `cron.run` — when the persisted sessionTarget id is malformed, the
+ * handler returns `{ok:true, ran:false, reason:"invalid-spec"}` instead of
+ * throwing, mirroring the reference's soft-OK degrade.
+ */
+import { add as cronAdd, enqueueRun as cronEnqueueRun, list as cronList, listPage as cronListPage, remove as cronRemove, runs as cronRunsRead, status as cronStatus, update as cronUpdate, wake as cronWake, } from "../../cron/service/ops.js";
+import { isInvalidCronSessionTargetIdError } from "../../cron/session-target.js";
+/* ─── helpers ──────────────────────────────────────────────────── */
+function requireState(ctx) {
+    if (!ctx.state) {
+        throw new Error("cron service not running — start the gateway daemon first");
+    }
+    return ctx.state;
+}
+function resolveJobId(params, method) {
+    const idRaw = typeof params.id === "string"
+        ? params.id
+        : typeof params.jobId === "string"
+            ? params.jobId
+            : undefined;
+    const id = idRaw?.trim();
+    if (!id) {
+        throw new Error(`invalid ${method} params: id or jobId required`);
+    }
+    return id;
+}
+/* ─── wake ─────────────────────────────────────────────────────── */
+export function handleWake(params, ctx) {
+    const state = requireState(ctx);
+    const text = typeof params?.text === "string" ? params.text.trim() : "";
+    if (!text) {
+        throw new Error("invalid wake params: text required");
+    }
+    const mode = params.mode === "now" ? "now" : "next-heartbeat";
+    cronWake(state, text, mode, {
+        ...(params.agentId !== undefined ? { agentId: params.agentId } : {}),
+        ...(params.sessionKey !== undefined ? { sessionKey: params.sessionKey } : {}),
+    });
+}
+/* ─── cron.list ────────────────────────────────────────────────── */
+export async function handleCronList(params, ctx) {
+    const state = requireState(ctx);
+    const p = params ?? {};
+    // `includeDisabled` and `enabled` are two views on the same dimension —
+    // caller may use either. `enabled` wins when both are supplied.
+    const enabled = p.enabled !== undefined ? p.enabled : p.includeDisabled === true ? "all" : "enabled";
+    return cronListPage(state, {
+        enabled,
+        ...(typeof p.limit === "number" ? { limit: p.limit } : {}),
+        ...(typeof p.offset === "number" ? { offset: p.offset } : {}),
+        ...(typeof p.query === "string" ? { query: p.query } : {}),
+        ...(p.sortBy !== undefined ? { sortBy: p.sortBy } : {}),
+        ...(p.sortDir !== undefined ? { sortDir: p.sortDir } : {}),
+    });
+}
+/* ─── cron.status ──────────────────────────────────────────────── */
+export async function handleCronStatus(_params, ctx) {
+    const state = requireState(ctx);
+    return cronStatus(state);
+}
+/* ─── cron.add ─────────────────────────────────────────────────── */
+export async function handleCronAdd(params, ctx) {
+    const state = requireState(ctx);
+    if (!params || typeof params !== "object") {
+        throw new Error("invalid cron.add params: object required");
+    }
+    const sessionKey = typeof params.sessionKey === "string"
+        ? params.sessionKey
+        : undefined;
+    // `sessionKey` doubles as the create-time session context so the
+    // normalizer can resolve `sessionTarget: "current"` to
+    // `session:<sessionKey>`. The same field is also persisted on the job
+    // as the announce-fallback session key (Brigade-side; existing
+    // behaviour). When the caller hasn't supplied a session context, the
+    // normalizer falls back to `"isolated"` per the reference policy.
+    return cronAdd(state, params, sessionKey !== undefined ? { sessionContext: { sessionKey } } : undefined);
+}
+/* ─── cron.update ──────────────────────────────────────────────── */
+export async function handleCronUpdate(params, ctx) {
+    const state = requireState(ctx);
+    if (!params || typeof params !== "object") {
+        throw new Error("invalid cron.update params: object required");
+    }
+    const jobId = resolveJobId(params, "cron.update");
+    const patch = params.patch;
+    if (!patch || typeof patch !== "object") {
+        throw new Error("invalid cron.update params: patch required");
+    }
+    return cronUpdate(state, jobId, patch);
+}
+/* ─── cron.remove ──────────────────────────────────────────────── */
+export async function handleCronRemove(params, ctx) {
+    const state = requireState(ctx);
+    const jobId = resolveJobId(params, "cron.remove");
+    const removed = await cronRemove(state, jobId);
+    return { removed };
+}
+/* ─── cron.run ─────────────────────────────────────────────────── */
+export async function handleCronRun(params, ctx) {
+    const state = requireState(ctx);
+    const jobId = resolveJobId(params, "cron.run");
+    const mode = params.mode === "due" ? "due" : "force";
+    try {
+        // Reference RPC path uses `enqueueRun` (non-blocking) — the operator
+        // sees `{enqueued: true}` and can read back the latest run via
+        // `cron.runs` once the tick fires. The in-process cron-tool keeps
+        // its inline-run behaviour for the operator-facing surface (see
+        // `cron-tool.ts` case "run").
+        await cronEnqueueRun(state, jobId, mode);
+        return { ok: true, enqueued: true, jobId, mode };
+    }
+    catch (err) {
+        // Soft-OK degrade: when the persisted sessionTarget id is malformed
+        // (e.g. a hand-edited cron.json with a control character), refuse
+        // gracefully so the operator can still cron-remove the broken job
+        // rather than being unable to interact with it at all.
+        if (isInvalidCronSessionTargetIdError(err)) {
+            return { ok: true, ran: false, reason: "invalid-spec" };
+        }
+        throw err;
+    }
+}
+/* ─── cron.runs ────────────────────────────────────────────────── */
+export async function handleCronRuns(params, ctx) {
+    const state = requireState(ctx);
+    const p = params ?? {};
+    const jobIdRaw = typeof p.id === "string" ? p.id : typeof p.jobId === "string" ? p.jobId : undefined;
+    const jobId = jobIdRaw?.trim() || undefined;
+    const scope = p.scope ?? (jobId ? "job" : "all");
+    const limit = typeof p.limit === "number" ? p.limit : 50;
+    const offset = typeof p.offset === "number" ? p.offset : 0;
+    if (scope === "job") {
+        if (!jobId) {
+            throw new Error("invalid cron.runs params: id or jobId required for scope=job");
+        }
+        const entries = await cronRunsRead(state, jobId, {
+            limit,
+            offset,
+            ...(p.status !== undefined ? { status: p.status } : {}),
+        });
+        return { entries };
+    }
+    // scope === "all" — aggregate across every job by reading each job's
+    // run-log and merging newest-first up to limit/offset. Brigade's
+    // run-log helper is per-job; we list jobs (including disabled) and
+    // concatenate. Cap heavy enumeration at a reasonable per-job slice so
+    // a very-active store doesn't blow up memory.
+    const jobs = await cronList(state, { includeDisabled: true });
+    const perJobSlice = Math.min(200, Math.max(limit + offset, 50));
+    const collected = [];
+    for (const job of jobs) {
+        const rows = await cronRunsRead(state, job.id, {
+            limit: perJobSlice,
+            offset: 0,
+            ...(p.status !== undefined ? { status: p.status } : {}),
+        });
+        collected.push(...rows);
+    }
+    collected.sort((a, b) => b.ts - a.ts);
+    return { entries: collected.slice(offset, offset + limit) };
+}
+//# sourceMappingURL=cron.js.map

package/dist/core/server-methods/cron.js.map

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

package/dist/core/server-methods/health.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `health` gateway method handler (Step 25).
+ *
+ * Brand-scrubbed analogue of upstream's `src/gateway/server-methods/health.ts`.
+ * Returns a compact runtime snapshot — the same payload that powers
+ * `brigade doctor` + `brigade status` + the live-status WebSocket event.
+ *
+ * Snapshot composition (lazy + cheap on the hot path):
+ *
+ *   - Brigade build version + protocol version (from `protocol/handshake.ts`)
+ *   - Active session count (from Step 11's live-session registry)
+ *   - Active sub-agent run count (from Step 10's subagent-registry)
+ *   - Channel manager runtime snapshot (Step 16, if mounted)
+ *
+ * The handler accepts `{ probe?: boolean }` — when true, it forces a
+ * channel-status probe; when false (default), it returns the cached
+ * snapshot. Brigade's manager-side cache TTL is not yet wired; the field
+ * is accepted for forward-parity and ignored today.
+ */
+import type { HealthResult } from "../../protocol/methods.js";
+export interface HealthHandlerDeps {
+    /**
+     * Optional channel-runtime snapshot supplier. Brigade's gateway hands
+     * in the manager's `getRuntimeSnapshot` here; tests can pass a stub
+     * or omit it entirely.
+     */
+    getChannelRuntime?: () => Record<string, {
+        state?: string;
+    }> | undefined;
+    /** Brigade build version. Defaults to "dev" if not supplied. */
+    getBrigadeVersion?: () => string;
+}
+export declare function handleHealthMethod(params: {
+    probe?: boolean;
+} | undefined, deps?: HealthHandlerDeps): Promise<HealthResult>;
+//# sourceMappingURL=health.d.ts.map

package/dist/core/server-methods/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/core/server-methods/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,MAAM,WAAW,iBAAiB;IACjC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MACjB,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAClC,SAAS,CAAC;IACb,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CACvC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EACvC,IAAI,GAAE,iBAAsB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAqBvB"}

package/dist/core/server-methods/health.js

@@ -0,0 +1,51 @@
+/**
+ * `health` gateway method handler (Step 25).
+ *
+ * Brand-scrubbed analogue of upstream's `src/gateway/server-methods/health.ts`.
+ * Returns a compact runtime snapshot — the same payload that powers
+ * `brigade doctor` + `brigade status` + the live-status WebSocket event.
+ *
+ * Snapshot composition (lazy + cheap on the hot path):
+ *
+ *   - Brigade build version + protocol version (from `protocol/handshake.ts`)
+ *   - Active session count (from Step 11's live-session registry)
+ *   - Active sub-agent run count (from Step 10's subagent-registry)
+ *   - Channel manager runtime snapshot (Step 16, if mounted)
+ *
+ * The handler accepts `{ probe?: boolean }` — when true, it forces a
+ * channel-status probe; when false (default), it returns the cached
+ * snapshot. Brigade's manager-side cache TTL is not yet wired; the field
+ * is accepted for forward-parity and ignored today.
+ */
+import { countActiveLiveSessions, listLiveSessions, } from "../../agents/session-registry.js";
+import { snapshotSubagentRunsForTests } from "../../agents/subagent-registry.js";
+import { PROTOCOL_VERSION } from "../../protocol/handshake.js";
+const BOOT_TIME_MS = Date.now();
+export async function handleHealthMethod(params, deps = {}) {
+    void params?.probe; // accepted for forward-parity; not used yet
+    const channels = deps.getChannelRuntime?.();
+    const activeSessions = countActiveLiveSessions();
+    const liveSessions = listLiveSessions();
+    const runs = snapshotSubagentRunsForTests();
+    const activeRuns = runs.filter((r) => r.endedAt == null).length;
+    return {
+        status: deriveStatus(activeSessions, activeRuns),
+        uptimeMs: Date.now() - BOOT_TIME_MS,
+        versions: {
+            brigade: deps.getBrigadeVersion?.() ?? "dev",
+            protocol: PROTOCOL_VERSION,
+        },
+        ...(channels ? { channels } : {}),
+        ...{
+            liveSessions: liveSessions.length,
+            activeSessions,
+            activeSubagentRuns: activeRuns,
+        },
+    };
+}
+function deriveStatus(activeSessions, activeRuns) {
+    if (activeSessions < 0 || activeRuns < 0)
+        return "unavailable";
+    return "ok";
+}
+//# sourceMappingURL=health.js.map

package/dist/core/server-methods/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/core/server-methods/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,uBAAuB,EACvB,gBAAgB,GAChB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAehC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,MAAuC,EACvC,OAA0B,EAAE;IAE5B,KAAK,MAAM,EAAE,KAAK,CAAC,CAAC,4CAA4C;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;IAC5C,MAAM,cAAc,GAAG,uBAAuB,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,4BAA4B,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC;IAChE,OAAO;QACN,MAAM,EAAE,YAAY,CAAC,cAAc,EAAE,UAAU,CAAC;QAChD,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY;QACnC,QAAQ,EAAE;YACT,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,KAAK;YAC5C,QAAQ,EAAE,gBAAgB;SAC1B;QACD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAI;YACH,YAAY,EAAE,YAAY,CAAC,MAAM;YACjC,cAAc;YACd,kBAAkB,EAAE,UAAU;SACF;KAC7B,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,cAAsB,EAAE,UAAkB;IAC/D,IAAI,cAAc,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IAC/D,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/core/server-methods/org.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Gateway RPC handler — `org.snapshot`.
+ *
+ * Returns the derived org graph plus every rendered chart format so an
+ * operator-side caller (CLI, TUI, channel, web UI) can pick whichever
+ * surface it needs without re-rendering. The Pride chart shape is owned
+ * by `pride-template.ts` — this handler is a thin adapter that snapshots
+ * the current config + asks the template for each surface variant.
+ *
+ * Three render variants live in the response:
+ *
+ *   - `tui`     — ANSI + emoji (terminals that render colour and unicode).
+ *   - `channel` — emoji + plain text, wrapped in a triple-backtick code
+ *                 block so WhatsApp / Slack / Discord render monospace.
+ *   - `ascii`  — plain ASCII (no emoji, no ANSI) for legacy SMS gateways
+ *                 and `TERM=dumb` consoles.
+ *   - `json`   — the raw `OrgGraph` for callers that want to re-render
+ *                 client-side (web UI, custom dashboards).
+ *
+ * When `cfg.org` is absent the handler returns the friendly flat-crew
+ * redirect note — never a crash, never a pretend-flat-list fallback.
+ *
+ * INVARIANT: this handler is OPERATOR-ONLY. The gateway boot path scopes
+ * the registration as `operator.read` so only callers carrying that
+ * scope reach the body. Today every WebSocket connection inherits the
+ * full operator scope set (localhost-only); Phase 2 multi-user will
+ * narrow this without any code change here.
+ *
+ * Brand-scrub: no external agent-codebase
+ * identifiers referenced in this file.
+ */
+import type { OrgGraph } from "../../agents/org/types.js";
+/** Shape of the loaded config slice the handler reads. */
+interface OrgSnapshotConfig {
+    org?: {
+        departmentHeads?: Record<string, string>;
+    };
+}
+/** Dependencies — injected so tests don't need to stub the global cfg loader. */
+export interface OrgSnapshotDeps {
+    /** Returns the current Brigade config (sync — `loadConfig` is sync today). */
+    loadConfig: () => OrgSnapshotConfig;
+}
+/** Per-format chart bundle returned when cfg.org is present. */
+export interface OrgSnapshotCharts {
+    /**
+     * ANSI + emoji — for the TUI. NEW default since the "fancy" body
+     * shipped: a horizontal columnar org-chart with box-drawing
+     * connectors (┌─┐│└─┘├┬┴), one Higher Office box at top, lead
+     * boxes in a row with a branching spine, team bullets per
+     * column. The `/org` slash command renders this verbatim.
+     */
+    tui: string;
+    /**
+     * Legacy compact list (Higher Office / Departments tier headings,
+     * leads + team bullets). Kept available so the few internal sites
+     * that depend on the old shape can opt in.
+     */
+    list: string;
+    /**
+     * Vertical indent tree (├── / └── connectors) — good for narrow
+     * terminals (<60 cols) where the columnar variant wraps.
+     */
+    tree: string;
+    /** Emoji + plain text wrapped in a triple-backtick code block. */
+    channel: string;
+    /** Plain ASCII (no emoji, no ANSI). */
+    ascii: string;
+    /** Raw OrgGraph for downstream re-rendering. */
+    json: OrgGraph;
+}
+/** OK response — cfg.org is present, every chart format is rendered. */
+export interface OrgSnapshotOkResult {
+    ok: true;
+    graph: OrgGraph;
+    charts: OrgSnapshotCharts;
+}
+/** Refusal — cfg.org is absent. The caller renders the redirect note. */
+export interface OrgSnapshotFlatCrewResult {
+    ok: false;
+    reason: "flat-crew";
+    redirect: string;
+}
+export type OrgSnapshotResult = OrgSnapshotOkResult | OrgSnapshotFlatCrewResult;
+/** Params type (current shape: no params; reserved for future filtering). */
+export type OrgSnapshotParams = Record<string, never> | undefined;
+/**
+ * Handle the `org.snapshot` RPC. Pure: reads cfg through the injected
+ * loader, derives the graph, asks the Pride template for each format.
+ */
+export declare function handleOrgSnapshot(_params: OrgSnapshotParams, deps: OrgSnapshotDeps): OrgSnapshotResult;
+export {};
+//# sourceMappingURL=org.d.ts.map

package/dist/core/server-methods/org.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org.d.ts","sourceRoot":"","sources":["../../../src/core/server-methods/org.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AASH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,0DAA0D;AAC1D,UAAU,iBAAiB;IACzB,GAAG,CAAC,EAAE;QACJ,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,iBAAiB,CAAC;CACrC;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,yBAAyB,CAAC;AAE9B,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC;AAElE;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAwDnB"}

package/dist/core/server-methods/org.js

@@ -0,0 +1,95 @@
+/**
+ * Gateway RPC handler — `org.snapshot`.
+ *
+ * Returns the derived org graph plus every rendered chart format so an
+ * operator-side caller (CLI, TUI, channel, web UI) can pick whichever
+ * surface it needs without re-rendering. The Pride chart shape is owned
+ * by `pride-template.ts` — this handler is a thin adapter that snapshots
+ * the current config + asks the template for each surface variant.
+ *
+ * Three render variants live in the response:
+ *
+ *   - `tui`     — ANSI + emoji (terminals that render colour and unicode).
+ *   - `channel` — emoji + plain text, wrapped in a triple-backtick code
+ *                 block so WhatsApp / Slack / Discord render monospace.
+ *   - `ascii`  — plain ASCII (no emoji, no ANSI) for legacy SMS gateways
+ *                 and `TERM=dumb` consoles.
+ *   - `json`   — the raw `OrgGraph` for callers that want to re-render
+ *                 client-side (web UI, custom dashboards).
+ *
+ * When `cfg.org` is absent the handler returns the friendly flat-crew
+ * redirect note — never a crash, never a pretend-flat-list fallback.
+ *
+ * INVARIANT: this handler is OPERATOR-ONLY. The gateway boot path scopes
+ * the registration as `operator.read` so only callers carrying that
+ * scope reach the body. Today every WebSocket connection inherits the
+ * full operator scope set (localhost-only); Phase 2 multi-user will
+ * narrow this without any code change here.
+ *
+ * Brand-scrub: no external agent-codebase
+ * identifiers referenced in this file.
+ */
+import { deriveOrgDisplayGraph } from "../../agents/org/derive-graph.js";
+import { PRIDE_CHART_FLAT_CREW_NOTE, renderPrideChartWithPins, renderPrideColumnsWithPins, renderPrideTreeWithPins, } from "../../agents/org/pride-template.js";
+/**
+ * Handle the `org.snapshot` RPC. Pure: reads cfg through the injected
+ * loader, derives the graph, asks the Pride template for each format.
+ */
+export function handleOrgSnapshot(_params, deps) {
+    const cfg = deps.loadConfig();
+    const graph = deriveOrgDisplayGraph(cfg);
+    if (!graph) {
+        return {
+            ok: false,
+            reason: "flat-crew",
+            redirect: PRIDE_CHART_FLAT_CREW_NOTE,
+        };
+    }
+    const pins = cfg.org?.departmentHeads;
+    // TUI form: fancy columnar org-chart with box-drawing connectors +
+    // emoji + ANSI colour. This is what `/org` shows in the connect
+    // TUI — the "Higher Office box on top, lead boxes in a horizontal
+    // row with branching spine, team bullets under each column" look
+    // the operator asked for after seeing the legacy compact list.
+    const tui = renderPrideColumnsWithPins(graph, pins, {
+        emoji: true,
+        ansi: true,
+    });
+    // Vertical indent tree alternative for narrow terminals.
+    const tree = renderPrideTreeWithPins(graph, pins, {
+        emoji: true,
+        ansi: true,
+    });
+    // Legacy compact list — kept for back-compat (a handful of internal
+    // sites still pin the original section-bar layout).
+    const list = renderPrideChartWithPins(graph, pins, {
+        emoji: true,
+        ansi: true,
+    });
+    const ascii = renderPrideChartWithPins(graph, pins, {
+        emoji: false,
+        ansi: false,
+    });
+    // Channel form: emoji on, ANSI off, wrapped in a triple-backtick
+    // block so WhatsApp / Slack / Discord render it as monospace. Uses
+    // the LIST shape (not columnar) because chat clients on mobile are
+    // often <40 cols wide and the columnar variant wraps badly.
+    const channelInner = renderPrideChartWithPins(graph, pins, {
+        emoji: true,
+        ansi: false,
+    });
+    const channel = ["```", channelInner, "```"].join("\n");
+    return {
+        ok: true,
+        graph,
+        charts: {
+            tui,
+            list,
+            tree,
+            channel,
+            ascii,
+            json: graph,
+        },
+    };
+}
+//# sourceMappingURL=org.js.map

package/dist/core/server-methods/org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org.js","sourceRoot":"","sources":["../../../src/core/server-methods/org.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAkE5C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA0B,EAC1B,IAAqB;IAErB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAY,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,0BAA0B;SACrC,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC;IACtC,mEAAmE;IACnE,gEAAgE;IAChE,kEAAkE;IAClE,iEAAiE;IACjE,+DAA+D;IAC/D,MAAM,GAAG,GAAG,0BAA0B,CAAC,KAAK,EAAE,IAAI,EAAE;QAClD,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,yDAAyD;IACzD,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE;QAChD,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,oEAAoE;IACpE,oDAAoD;IACpD,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE;QACjD,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE;QAClD,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,iEAAiE;IACjE,mEAAmE;IACnE,mEAAmE;IACnE,4DAA4D;IAC5D,MAAM,YAAY,GAAG,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE;QACzD,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK;QACL,MAAM,EAAE;YACN,GAAG;YACH,IAAI;YACJ,IAAI;YACJ,OAAO;YACP,KAAK;YACL,IAAI,EAAE,KAAK;SACZ;KACF,CAAC;AACJ,CAAC"}