@miadi/chronicle-tui 0.2.0 → 0.4.0

package/dist/api.d.ts

@@ -0,0 +1,132 @@
+/**
+ * The browser as a known reader of the Miadi app (jgwill/Miadi#706).
+ *
+ * Reads that need no one (the catalog, files, search) stay on the local
+ * checkout. Anything that depends on who is reading, and every write, goes
+ * through the app's own routes, so the app keeps the one gate it already has
+ * (`lib/api-access.ts`, `lib/identity.ts`, `lib/ceremony-access.ts`).
+ *
+ * Two tokens, each for what it is:
+ * - `MIADI_PERSON_TOKEN` is a person. It is the bearer of every read, so a
+ *   ceremony or circle shows what that person's seat allows and nothing more.
+ * - `MIADI_API_TOKEN_WRITER` passes the write gate. It is the bearer of writes,
+ *   with the person named beside it in `x-miadi-person-token`, the way the app
+ *   expects an agent acting for someone (`lib/review-ceremony.ts`).
+ * Either alone works for what it can do. A token is only ever sent to the app
+ * chosen at start, and never over plain http to a host that is not this one.
+ */
+export declare const TOKEN_ENV = "MIADI_API_TOKEN_WRITER";
+export declare const PERSON_TOKEN_ENV = "MIADI_PERSON_TOKEN";
+export declare const PERSON_TOKEN_HEADER = "x-miadi-person-token";
+/** What `--env` may set. Anything else in the file (PATH included) is left alone. */
+export declare const ENV_FILE_KEYS: readonly ["MIADI_API_TOKEN_WRITER", "MIADI_PERSON_TOKEN", "MIADI_CHRONICLE_ROOT", "MIADI_WEB_URL", "MIADI_URL_BASE_INTERNAL", "MIADI_URL_BASE", "MIADI_CHRONICLE_MW_URL"];
+/**
+ * Load the allowed `KEY=value` lines of a file into the environment: `export`
+ * prefixes, quotes and `#` comments are understood, nothing is expanded. A key
+ * the file sets wins over one already set, since the file was named on purpose.
+ * Returns the keys it set.
+ */
+export declare function loadEnvFile(path: string, env?: NodeJS.ProcessEnv): string[];
+export interface Reader {
+    id: string;
+    name: string;
+    role?: string;
+    tier?: string;
+    /** Circles the reader sits in. */
+    circles: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+/** A token may travel to https, or to plain http on this machine only. */
+export declare function mayCarryToken(base: string): boolean;
+export interface Tokens {
+    writer?: string;
+    person?: string;
+}
+export declare class MiadiApi {
+    readonly base: string;
+    private readonly tokens;
+    /** Set once the app has answered who is reading; false when it refused the token. */
+    accepted: boolean | undefined;
+    constructor(base: string, tokens?: Tokens);
+    /** A token is set (whether or not the app accepted it yet). */
+    get signed(): boolean;
+    /** A person is named, so seats apply. */
+    get asPerson(): boolean;
+    /** Writes are offered: a token is set and the app did not refuse it. */
+    get mayWrite(): boolean;
+    private headers;
+    private call;
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    /** Who the app says is reading. Marks the client refused on 401 or 403. */
+    me(): Promise<Reader | null>;
+    /** Would the app record a write from this client? The web room asks the attention door the same. */
+    mayAnswer(): Promise<boolean>;
+}
+export interface Connection {
+    api: MiadiApi | null;
+    /** Why a token was not attached, when one was set. */
+    warning?: string;
+}
+/**
+ * The app this browser talks to. `--url` wins; otherwise the local app, then
+ * the tailnet one (`MIADI_URL_BASE_INTERNAL`). The public front is used only
+ * when named with `--url`, so a token never goes there by accident. Probes
+ * carry no token.
+ */
+export declare function connectApi(url?: string, env?: NodeJS.ProcessEnv): Promise<Connection>;
+export declare function answerAttention(api: MiadiApi, episode: string, id: string, answer: string): Promise<{
+    ok: boolean;
+    result?: {
+        synchronized?: boolean;
+    };
+}>;
+export interface CeremonyCard {
+    kind: "ceremony";
+    id: string;
+    type?: string;
+    direction?: string;
+    intentions: string[];
+    episode?: string;
+    circle?: string;
+    closed: boolean;
+    /** What this reader may do here, as the app says (`can`). */
+    can: string[];
+}
+export interface CircleCard {
+    kind: "circle";
+    id: string;
+    name: string;
+    intention?: string;
+    direction?: string;
+    type?: string;
+    active: boolean;
+    facilitator?: string;
+    ceremonies: number;
+    can: string[];
+}
+/**
+ * What a ceremony shows a seated reader: its kind, direction, intention,
+ * episode, circle and whether it is closed. Never its turns: those are
+ * people's words, read in the circle (jgwill/Miadi#680, D3).
+ */
+export declare function ceremonyCard(api: MiadiApi, id: string): Promise<CeremonyCard>;
+export declare function circleCard(api: MiadiApi, id: string): Promise<CircleCard>;
+export declare function addReview(api: MiadiApi, episode: string, review: string): Promise<{
+    ok?: boolean;
+    review?: {
+        title?: string;
+        id?: string;
+    };
+    ceremony?: {
+        state?: string;
+    };
+}>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,eAAO,MAAM,SAAS,2BAA2B,CAAA;AACjD,eAAO,MAAM,gBAAgB,uBAAuB,CAAA;AACpD,eAAO,MAAM,mBAAmB,yBAAyB,CAAA;AAEzD,qFAAqF;AACrF,eAAO,MAAM,aAAa,2KAQhB,CAAA;AAEV;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAgBxF;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7C;AAED,qBAAa,QAAS,SAAQ,KAAK;IAG/B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;gBAFtB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAIzB;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,QAAQ;IAKjB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,qFAAqF;IACrF,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;gBAGlB,IAAI,EAAE,MAAM,EACJ,MAAM,GAAE,MAAW;IAGtC,+DAA+D;IAC/D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,yCAAyC;IACzC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,wEAAwE;IACxE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,CAAC,OAAO;YASD,IAAI;IA+BlB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,2EAA2E;IACrE,EAAE,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuBlC,oGAAoG;IAC9F,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CASpC;AAeD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAA;IACpB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBxG;AAMD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC,CAE/D;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,6DAA6D;IAC7D,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAKD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBnF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB/E;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAEpG"}

package/dist/api.js

@@ -0,0 +1,272 @@
+/**
+ * The browser as a known reader of the Miadi app (jgwill/Miadi#706).
+ *
+ * Reads that need no one (the catalog, files, search) stay on the local
+ * checkout. Anything that depends on who is reading, and every write, goes
+ * through the app's own routes, so the app keeps the one gate it already has
+ * (`lib/api-access.ts`, `lib/identity.ts`, `lib/ceremony-access.ts`).
+ *
+ * Two tokens, each for what it is:
+ * - `MIADI_PERSON_TOKEN` is a person. It is the bearer of every read, so a
+ *   ceremony or circle shows what that person's seat allows and nothing more.
+ * - `MIADI_API_TOKEN_WRITER` passes the write gate. It is the bearer of writes,
+ *   with the person named beside it in `x-miadi-person-token`, the way the app
+ *   expects an agent acting for someone (`lib/review-ceremony.ts`).
+ * Either alone works for what it can do. A token is only ever sent to the app
+ * chosen at start, and never over plain http to a host that is not this one.
+ */
+import fs from "node:fs";
+import { readWebBases } from "@miadi/inquiry-weave";
+export const TOKEN_ENV = "MIADI_API_TOKEN_WRITER";
+export const PERSON_TOKEN_ENV = "MIADI_PERSON_TOKEN";
+export const PERSON_TOKEN_HEADER = "x-miadi-person-token";
+/** What `--env` may set. Anything else in the file (PATH included) is left alone. */
+export const ENV_FILE_KEYS = [
+    TOKEN_ENV,
+    PERSON_TOKEN_ENV,
+    "MIADI_CHRONICLE_ROOT",
+    "MIADI_WEB_URL",
+    "MIADI_URL_BASE_INTERNAL",
+    "MIADI_URL_BASE",
+    "MIADI_CHRONICLE_MW_URL",
+];
+/**
+ * Load the allowed `KEY=value` lines of a file into the environment: `export`
+ * prefixes, quotes and `#` comments are understood, nothing is expanded. A key
+ * the file sets wins over one already set, since the file was named on purpose.
+ * Returns the keys it set.
+ */
+export function loadEnvFile(path, env = process.env) {
+    const allowed = new Set(ENV_FILE_KEYS);
+    const loaded = [];
+    for (const raw of fs.readFileSync(path, "utf8").split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const m = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
+        if (!m || !allowed.has(m[1]))
+            continue;
+        let value = m[2];
+        const quoted = /^(["'])(.*?)\1(?:\s+#.*)?$/.exec(value);
+        if (quoted)
+            value = quoted[2];
+        else
+            value = value.replace(/\s+#.*$/, "").trim();
+        env[m[1]] = value;
+        loaded.push(m[1]);
+    }
+    return loaded;
+}
+export class ApiError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+/** A token may travel to https, or to plain http on this machine only. */
+export function mayCarryToken(base) {
+    try {
+        const url = new URL(base);
+        if (url.protocol === "https:")
+            return true;
+        return url.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+export class MiadiApi {
+    base;
+    tokens;
+    /** Set once the app has answered who is reading; false when it refused the token. */
+    accepted;
+    constructor(base, tokens = {}) {
+        this.base = base;
+        this.tokens = tokens;
+    }
+    /** A token is set (whether or not the app accepted it yet). */
+    get signed() {
+        return Boolean(this.tokens.writer || this.tokens.person);
+    }
+    /** A person is named, so seats apply. */
+    get asPerson() {
+        return Boolean(this.tokens.person);
+    }
+    /** Writes are offered: a token is set and the app did not refuse it. */
+    get mayWrite() {
+        return this.signed && this.accepted !== false;
+    }
+    headers(write) {
+        const { writer, person } = this.tokens;
+        const bearer = write ? (writer ?? person) : (person ?? writer);
+        const headers = {};
+        if (bearer)
+            headers.authorization = `Bearer ${bearer}`;
+        if (write && writer && person)
+            headers[PERSON_TOKEN_HEADER] = person;
+        return headers;
+    }
+    async call(method, path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 20_000);
+        try {
+            const response = await fetch(`${this.base}${path}`, {
+                method,
+                signal: controller.signal,
+                headers: {
+                    accept: "application/json",
+                    ...(body === undefined ? {} : { "content-type": "application/json" }),
+                    ...this.headers(method === "POST"),
+                },
+                body: body === undefined ? undefined : JSON.stringify(body),
+            });
+            const text = await response.text();
+            let json = null;
+            try {
+                json = text ? JSON.parse(text) : null;
+            }
+            catch {
+                json = null;
+            }
+            if (!response.ok) {
+                const detail = json;
+                throw new ApiError(detail?.message ?? detail?.error ?? `${method} ${path}: HTTP ${response.status}`, response.status, detail?.error);
+            }
+            return json;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    get(path) {
+        return this.call("GET", path);
+    }
+    post(path, body) {
+        return this.call("POST", path, body);
+    }
+    /** Who the app says is reading. Marks the client refused on 401 or 403. */
+    async me() {
+        if (!this.signed)
+            return null;
+        try {
+            const me = await this.get("/api/identity/me");
+            this.accepted = Boolean(me.person);
+            if (!me.person)
+                return null;
+            return {
+                id: me.person.id,
+                name: me.person.name,
+                role: me.person.role,
+                tier: me.api_tier,
+                circles: (me.circles ?? []).map((circle) => ({ id: circle.id, name: circle.name })),
+            };
+        }
+        catch (error) {
+            if (error instanceof ApiError && (error.status === 401 || error.status === 403))
+                this.accepted = false;
+            throw error;
+        }
+    }
+    /** Would the app record a write from this client? The web room asks the attention door the same. */
+    async mayAnswer() {
+        if (!this.mayWrite)
+            return false;
+        try {
+            const body = await this.call("GET", "/api/chronicle/attention?capabilities=1");
+            return body?.capabilities?.answer === true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+async function answers(base) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 2500);
+    try {
+        const response = await fetch(`${base}/api/health`, { signal: controller.signal });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * The app this browser talks to. `--url` wins; otherwise the local app, then
+ * the tailnet one (`MIADI_URL_BASE_INTERNAL`). The public front is used only
+ * when named with `--url`, so a token never goes there by accident. Probes
+ * carry no token.
+ */
+export async function connectApi(url, env = process.env) {
+    const tokens = {
+        writer: env[TOKEN_ENV]?.trim() || undefined,
+        person: env[PERSON_TOKEN_ENV]?.trim() || undefined,
+    };
+    const make = (base) => {
+        const clean = base.replace(/\/+$/, "");
+        if ((tokens.writer || tokens.person) && !mayCarryToken(clean)) {
+            return { api: new MiadiApi(clean), warning: `${clean} is plain http on another host: the token stays home and the app is read-only.` };
+        }
+        return { api: new MiadiApi(clean, tokens) };
+    };
+    if (url)
+        return make(url);
+    const bases = readWebBases(env);
+    for (const base of [bases.local, bases.internal]) {
+        if (base && (await answers(base.replace(/\/+$/, ""))))
+            return make(base);
+    }
+    return { api: null };
+}
+// ---------------------------------------------------------------------------
+// The routes the browser uses, typed as the app answers them (checked 2026-10-01)
+// ---------------------------------------------------------------------------
+export function answerAttention(api, episode, id, answer) {
+    return api.post("/api/chronicle/attention", { episode, id, answer, expectedState: "open" });
+}
+const trueKeys = (can) => can && typeof can === "object" ? Object.entries(can).filter(([, v]) => v === true).map(([k]) => k) : [];
+/**
+ * What a ceremony shows a seated reader: its kind, direction, intention,
+ * episode, circle and whether it is closed. Never its turns: those are
+ * people's words, read in the circle (jgwill/Miadi#680, D3).
+ */
+export async function ceremonyCard(api, id) {
+    const view = await api.get(`/api/ceremony/${encodeURIComponent(id)}`);
+    const intentions = view.ceremony.intentions;
+    return {
+        kind: "ceremony",
+        id: view.ceremony.id,
+        type: view.ceremony.type,
+        direction: view.ceremony.direction,
+        intentions: (Array.isArray(intentions) ? intentions : intentions ? [intentions] : []).map((line) => line.replace(/\s+/g, " ").trim()),
+        episode: view.episode?.episode_path,
+        circle: view.circle?.name,
+        closed: Boolean(view.closed),
+        can: trueKeys(view.can),
+    };
+}
+export async function circleCard(api, id) {
+    const view = await api.get(`/api/circles/${encodeURIComponent(id)}`);
+    return {
+        kind: "circle",
+        id: view.circle.id,
+        name: view.circle.name,
+        intention: view.circle.intention?.replace(/\s+/g, " ").trim(),
+        direction: view.circle.direction,
+        type: view.circle.circle_type,
+        active: view.circle.active !== false,
+        facilitator: view.circle.facilitator_name,
+        ceremonies: Array.isArray(view.ceremonies) ? view.ceremonies.length : 0,
+        can: trueKeys(view.can),
+    };
+}
+export function addReview(api, episode, review) {
+    return api.post(`/api/chronicle/episodes/${encodeURIComponent(episode)}/reviews`, { review });
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/attention.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Chronicle ATTENTION in the terminal, as the web room has it (jgwill/Miadi#706).
+ *
+ * The room shows attention twice: a chronicle-wide board of every open item,
+ * newest-asked first, filtered by the same search box as the episodes
+ * (`app/chronicle/components/ChronicleAttention.tsx`), and each episode's own
+ * panel with Open and History and the cited context of each question
+ * (`EpisodeAttention.tsx`). Both are hosts of `@miadi/attention-core`, whose
+ * plain functions decide which list shows, what each heading says and whether
+ * an answer may be recorded. This module is the terminal's host of the same
+ * core: it reads through `@miadi/inquiry-weave` exactly as the app does, and
+ * answers through the app's `POST /api/chronicle/attention`.
+ */
+import { type AttentionPanelLabels, type AttentionView } from "@miadi/attention-core";
+import { type ChronicleAttentionItem } from "@miadi/inquiry-weave";
+export type { AttentionView };
+export type BoardItem = ChronicleAttentionItem;
+/** The board's words, as the web room's board says them. */
+export declare const BOARD_LABELS: Required<AttentionPanelLabels>;
+/** One episode's panel keeps the core's own words. */
+export declare const ROOM_LABELS: Required<AttentionPanelLabels>;
+export declare function readOnlyLabel(tokenEnv: string): string;
+/** Every open item across the chronicle, newest-asked first: what the board lists. */
+export declare function loadBoard(root: string): Promise<BoardItem[]>;
+export interface EpisodePanel {
+    episode: string;
+    items: BoardItem[];
+    parseError?: string;
+}
+/** One episode's items with the cited context of each, as the room reads them. */
+export declare function loadEpisodePanel(root: string, episode: string): Promise<EpisodePanel>;
+/** The board answers the episode search box: question, episode and what it unlocks. */
+export declare function filterBoard(items: readonly BoardItem[], query: string): BoardItem[];
+/** The list a panel shows, and its heading, decided by the core. */
+export declare function panelView(items: readonly BoardItem[], selected: AttentionView, labels: Required<AttentionPanelLabels>, parseError?: string): {
+    view: AttentionView;
+    shown: BoardItem[];
+    heading: string;
+    meta: string;
+};
+/** Check an answer the way every host checks it, before anything is sent. */
+export declare function checkAnswer(draft: string, maxLength?: number): import("@miadi/attention-core").AnswerValidation;
+/** What the room says once an answer is recorded: the wheel is reported, never assumed. */
+export declare function answeredMessage(result: {
+    synchronized?: boolean;
+} | undefined): {
+    tone: "ok" | "warn";
+    message: string;
+};
+//# sourceMappingURL=attention.d.ts.map

package/dist/attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../src/attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAQL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,aAAa,EAAE,CAAA;AAC7B,MAAM,MAAM,SAAS,GAAG,sBAAsB,CAAA;AAE9C,4DAA4D;AAC5D,eAAO,MAAM,YAAY,gCAKvB,CAAA;AAEF,sDAAsD;AACtD,eAAO,MAAM,WAAW,gCAAkB,CAAA;AAE1C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,sFAAsF;AACtF,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAGlE;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,kFAAkF;AAClF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAG3F;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAOnF;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAS5E;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAA4B,oDAE/E;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAIxH"}

package/dist/attention.js

@@ -0,0 +1,69 @@
+/**
+ * Chronicle ATTENTION in the terminal, as the web room has it (jgwill/Miadi#706).
+ *
+ * The room shows attention twice: a chronicle-wide board of every open item,
+ * newest-asked first, filtered by the same search box as the episodes
+ * (`app/chronicle/components/ChronicleAttention.tsx`), and each episode's own
+ * panel with Open and History and the cited context of each question
+ * (`EpisodeAttention.tsx`). Both are hosts of `@miadi/attention-core`, whose
+ * plain functions decide which list shows, what each heading says and whether
+ * an answer may be recorded. This module is the terminal's host of the same
+ * core: it reads through `@miadi/inquiry-weave` exactly as the app does, and
+ * answers through the app's `POST /api/chronicle/attention`.
+ */
+import { DEFAULT_ANSWER_MAX_LENGTH, headingMeta, headingText, partitionItems, resolveLabels, resolveView, validateAnswer, } from "@miadi/attention-core";
+import { listChronicleAttention, readEpisodeAttention, } from "@miadi/inquiry-weave";
+/** The board's words, as the web room's board says them. */
+export const BOARD_LABELS = resolveLabels({
+    title: "Needs your attention",
+    completeTitle: "Nothing waits on you",
+    openSuffix: "newest first — answer one here, or open its room",
+    completeSuffix: "decisions recorded across the chronicle",
+});
+/** One episode's panel keeps the core's own words. */
+export const ROOM_LABELS = resolveLabels();
+export function readOnlyLabel(tokenEnv) {
+    return `View only — answering needs the Miadi app and ${tokenEnv} or MIADI_PERSON_TOKEN (or --env <file>).`;
+}
+/** Every open item across the chronicle, newest-asked first: what the board lists. */
+export async function loadBoard(root) {
+    const items = await listChronicleAttention(root, { state: "open" });
+    return items.filter((item) => item.state === "open");
+}
+/** One episode's items with the cited context of each, as the room reads them. */
+export async function loadEpisodePanel(root, episode) {
+    const attention = await readEpisodeAttention(root, episode, { includeContext: true });
+    return { episode, items: attention?.items ?? [], parseError: attention?.parseError };
+}
+/** The board answers the episode search box: question, episode and what it unlocks. */
+export function filterBoard(items, query) {
+    const words = query.toLowerCase().split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return [...items];
+    return items.filter((item) => {
+        const haystack = [item.question, item.episode, item.unlocks, item.id].filter(Boolean).join(" ").toLowerCase();
+        return words.every((word) => haystack.includes(word));
+    });
+}
+/** The list a panel shows, and its heading, decided by the core. */
+export function panelView(items, selected, labels, parseError) {
+    const { open, answered } = partitionItems(items);
+    const view = resolveView(selected, open.length, answered.length);
+    return {
+        view,
+        shown: view === "history" ? answered : view === "open" ? open : [],
+        heading: headingText(open.length > 0, labels),
+        meta: headingMeta({ parseError, openCount: open.length, answeredCount: answered.length, labels }),
+    };
+}
+/** Check an answer the way every host checks it, before anything is sent. */
+export function checkAnswer(draft, maxLength = DEFAULT_ANSWER_MAX_LENGTH) {
+    return validateAnswer(draft, ROOM_LABELS, maxLength);
+}
+/** What the room says once an answer is recorded: the wheel is reported, never assumed. */
+export function answeredMessage(result) {
+    return result?.synchronized === true
+        ? { tone: "ok", message: "Answer recorded in the episode and verified on the wheel." }
+        : { tone: "warn", message: "Answer recorded in the episode; the wheel projection is pending." };
+}
+//# sourceMappingURL=attention.js.map

package/dist/attention.js.map

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

package/dist/bin.d.ts

@@ -7,6 +7,9 @@
  *   miadi-chronicle 352                     open on one episode (number, ep352 or folder name)
  *   miadi-chronicle --search "talking circle"   open in full-text mode
  *   miadi-chronicle --filter review         open with a title filter
+ *   miadi-chronicle --env ~/.env.miadi      load the tokens, the root and the app's address first
+ *   miadi-chronicle --attention             open on the chronicle's attention board
+ *   miadi-chronicle --url https://miadi.tail3b11eb.ts.net   act through this app
  *
  * Exit codes: 0 ok, 2 usage (no root, no terminal).
  */

package/dist/bin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.tsx"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.tsx"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}

package/dist/bin.js

@@ -3,7 +3,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { readFileSync } from "node:fs";
 import { render } from "ink";
 import { App } from "./App.js";
-const USAGE = `miadi-chronicle [episode] [--root <dir>] [--search <text>] [--filter <text>]
+import { ENV_FILE_KEYS, PERSON_TOKEN_ENV, TOKEN_ENV, loadEnvFile } from "./api.js";
+const USAGE = `miadi-chronicle [episode] [--root <dir>] [--search <text>] [--filter <text>] [--attention] [--env <file>] [--url <url>]
 
 Browse the Miadi Chronicle: list and filter episodes, search their text, read a
 vessel's files, and open the room, the wheel or the vessel.
@@ -12,15 +13,46 @@ vessel's files, and open the room, the wheel or the vessel.
   --root <dir>     the chronicle (default: $MIADI_CHRONICLE_ROOT)
   --search <text>  start in full-text mode
   --filter <text>  start with a title filter
+  --attention      open on the chronicle's attention board
+  --env <file>     load these keys from a KEY=value file, nothing else:
+                   ${ENV_FILE_KEYS.join(", ")}
+  --url <url>      the Miadi app to act through (default: MIADI_WEB_URL or 127.0.0.1:3335,
+                   then MIADI_URL_BASE_INTERNAL; the public front only when named here)
   --version, --help
 
 Keys: / filter · Tab title|full text · ↑↓ j k · Enter open · Esc back
-      o doors · r QR · p five-stage proof · ? all keys · q quit
+      o doors · r QR · p five-stage proof · a attention · ! attention board
+      v hold a review · ? all keys · q quit
+
+${PERSON_TOKEN_ENV} names you: the header says who is reading, and a ceremony
+or circle shows what your seat allows. ${TOKEN_ENV} passes the write gate:
+answering attention and holding a review. Without either, the browser shows
+what a visitor of the web room sees.
 `;
 function main(argv) {
+    // --env comes first, wherever it is written: everything below may read what it sets.
+    const withheld = [];
+    for (let index = 0; index < argv.length; index++) {
+        if (argv[index] !== "--env")
+            continue;
+        const file = argv[index + 1];
+        if (!file) {
+            process.stderr.write("--env needs a file.\n");
+            return 2;
+        }
+        try {
+            withheld.push(...loadEnvFile(file));
+        }
+        catch (error) {
+            process.stderr.write(`Cannot read ${file}: ${error.message}\n`);
+            return 2;
+        }
+    }
     let root = process.env.MIADI_CHRONICLE_ROOT?.trim() || "";
+    let url;
     let search;
     let filter;
+    let attention = false;
     let episode;
     for (let index = 0; index < argv.length; index++) {
         const arg = argv[index];
@@ -33,12 +65,18 @@ function main(argv) {
             process.stdout.write(`${pkg.version}\n`);
             return 0;
         }
-        if (arg === "--root")
+        if (arg === "--env")
+            index++;
+        else if (arg === "--url")
+            url = argv[++index];
+        else if (arg === "--root")
             root = argv[++index] ?? "";
         else if (arg === "--search")
             search = argv[++index];
         else if (arg === "--filter")
             filter = argv[++index];
+        else if (arg === "--attention")
+            attention = true;
         else if (arg.startsWith("--")) {
             process.stderr.write(`Unknown option ${arg}\n\n${USAGE}`);
             return 2;
@@ -54,7 +92,7 @@ function main(argv) {
         process.stderr.write("miadi-chronicle needs a terminal. For a plain list, run: inquiry-weave catalog\n");
         return 2;
     }
-    render(_jsx(App, { root: root, search: search, query: filter, episode: episode }), { alternateScreen: true });
+    render(_jsx(App, { root: root, search: search, query: filter, episode: episode, attention: attention, url: url, withheld: withheld }), { alternateScreen: true });
     return 0;
 }
 const code = main(process.argv.slice(2));