mdmaid-desk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleksandr Besan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,215 @@
+# mdmaid.desk
+
+`mdmaid.desk` is a persistent local document inbox and reading workspace for
+Markdown artifacts produced by harnesses, editors, and scripts.
+
+The repository name is `mdmaid.desk`; its initial executable is
+`mdmaid-desk`.
+
+## Status
+
+The repository contains the first usable shared-service vertical slice:
+
+- persistent workspace metadata;
+- Markdown document registration;
+- idempotent updates by canonical path;
+- workspace and artifact-root containment;
+- symlink-escape protection;
+- document size limits;
+- revision-aware Unread, Reading, and Done state;
+- tags, archive, and missing-document state;
+- transactional SQLite migrations and one-time JSON catalog import;
+- user-only catalog permissions;
+- authenticated loopback HTTP API and stable document/workspace routes;
+- sanitized `mdmaid` HTML and terminal rendering;
+- responsive browser queue, project/status filters, search, reader, and actions;
+- terminal-native queue, filters, search, reader, and lifecycle actions;
+- Server-Sent Event refreshes for both clients;
+- atomic, user-only daemon discovery state so the TUI reuses a running service;
+- memorable `http://mdmaid.desk.localhost:43127/` browser origin;
+- `workspace`, `register`, `list`, `web`, and `tui` commands.
+
+Background `daemon ensure/status/stop`, directory watching, stdin-managed
+enqueue, comments, and editing remain planned milestones. `web` currently runs
+the persistent service in the foreground; `tui` attaches to it when present and
+uses an embedded loopback service otherwise.
+
+## Responsibility
+
+`mdmaid.desk` owns:
+
+- the persistent local daemon;
+- workspace and document catalogs;
+- artifact-directory discovery;
+- stable document URLs;
+- the browser document library;
+- local CLI and API access;
+- attention metadata;
+- presentation security boundaries.
+
+It does not own:
+
+- agent workflow state;
+- task approvals;
+- model or provider routing;
+- Markdown rendering internals;
+- editor-specific keymaps.
+
+`mdmaid` remains the rendering engine. `agentctl` is a configurator only.
+Harnesses and tools register documents directly through generic CLI/API
+interfaces. `mdmaid.nvim` may become an optional client.
+
+## Development
+
+mdmaid.desk requires Node.js 22 or newer.
+
+```bash
+npm install
+npm test
+```
+
+Build:
+
+```bash
+npm run build
+```
+
+Run the CLI from the build:
+
+```bash
+node dist/cli.js --help
+```
+
+## Installation
+
+After the first public release, install the canonical npm package globally:
+
+```bash
+npm install --global mdmaid-desk
+mdmaid-desk --version
+mdmaid-desk web
+```
+
+In another terminal, open the same catalog through the terminal client:
+
+```bash
+mdmaid-desk tui
+```
+
+Homebrew is the planned first-class macOS installation and service path. Its
+formula will consume this same npm release so the two installers share one
+version and artifact lineage. See [Releasing and distribution](docs/RELEASING.md)
+for the rollout and one-time npm bootstrap.
+
+## Current CLI
+
+Register a workspace:
+
+```bash
+node dist/cli.js workspace add /path/to/repository \
+  --id example \
+  --name "Example"
+```
+
+Register a document:
+
+```bash
+node dist/cli.js register /path/to/repository/docs/plan.md \
+  --workspace example \
+  --task PROJECT-123 \
+  --kind plan \
+  --attention approval
+```
+
+List documents:
+
+```bash
+node dist/cli.js list --workspace example
+node dist/cli.js list --task PROJECT-123
+```
+
+Run the browser workspace as a foreground local service:
+
+```bash
+node dist/cli.js web
+```
+
+The command binds only to loopback on the stable port `43127` and prints an
+authenticated URL such as:
+
+```text
+http://mdmaid.desk.localhost:43127/?token=...
+```
+
+No proxy, certificate, DNS, or `/etc/hosts` setup is required. After the first
+authenticated open, the browser redirects to the clean URL, which can be
+bookmarked. The service publishes a user-only `daemon.json` for local clients
+and keeps its persistent random authentication token in a user-only
+`auth-token` file, so browser sessions survive service restarts. Stop the
+foreground service with `Ctrl-C`.
+
+Use `--port` to select another loopback port. An advanced `--public-url` option
+accepts HTTP or HTTPS `.localhost` origins; a direct HTTP origin must use the
+same port as the service.
+
+See [Local browser URL](docs/LOCAL_WEB.md) for details.
+
+Run the terminal workspace:
+
+```bash
+node dist/cli.js tui
+```
+
+The TUI reuses the running web daemon when available, so both clients share
+catalog events and reading state. Keys are shown in its footer; the main flow
+uses `j`/`k`, `Enter`, `/`, `m`, `u`, `a`, `b`, and `q`.
+
+The default state directory is:
+
+```text
+${XDG_STATE_HOME:-~/.local/state}/mdmaid.desk/
+  auth-token
+  catalog.sqlite3
+  daemon.json  # present while the web service is running
+```
+
+## Target Interaction
+
+```mermaid
+flowchart LR
+    A[Harnesses and tools] -->|register document| S[mdmaid.desk]
+    CFG[agentctl] -.->|optional configuration| A
+    N[mdmaid.nvim] -->|register or open| S
+    X[Scripts] -->|register| S
+    S --> CAT[(Catalog)]
+    S --> M[mdmaid renderer]
+    S --> W[Web workspace]
+    S --> T[TUI workspace]
+    W --> H[Human]
+    T --> H
+    H -->|reading status and tags| S
+```
+
+Document registration and presentation never imply workflow approval.
+
+## Documentation
+
+- [Architecture and roadmap](docs/ARCHITECTURE.md)
+- [Releasing and distribution](docs/RELEASING.md)
+- [Security policy](SECURITY.md)
+- [Contributing](CONTRIBUTING.md)
+- [MIT license](LICENSE)
+
+## Naming
+
+Current naming:
+
+```text
+Product/UI:  mdmaid.desk
+Repository:  mdmaid.desk
+Package:     mdmaid-desk
+CLI:         mdmaid-desk
+```
+
+A future `mdmaid desk ...` umbrella command may delegate to this package, but
+the repositories and release cycles remain separate.

package/dist/api-client.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentAction, HealthData, PublicDocument, PublicWorkspace, TerminalRenderPreferences, TerminalRender, WebRender } from "./api-types.js";
+export interface CatalogEvent {
+    action: string;
+    documentId: string;
+}
+export interface CatalogSubscriptionOptions {
+    signal?: AbortSignal;
+    onReady?: () => void;
+}
+export declare class DeskApiClient {
+    #private;
+    constructor(baseUrl: string, token: string);
+    health(signal?: AbortSignal): Promise<HealthData>;
+    listDocuments(): Promise<PublicDocument[]>;
+    listWorkspaces(): Promise<PublicWorkspace[]>;
+    renderDocument(id: string, target: "terminal", width?: number, preferences?: TerminalRenderPreferences): Promise<TerminalRender>;
+    renderDocument(id: string, target: "web", width?: number): Promise<WebRender>;
+    act(id: string, action: DocumentAction): Promise<PublicDocument>;
+    subscribeCatalog(listener: (event: CatalogEvent) => void, options?: CatalogSubscriptionOptions): Promise<void>;
+}

package/dist/api-client.js

@@ -0,0 +1,264 @@
+import { ATTENTION_STATES, DOCUMENT_KINDS, } from "./domain.js";
+export class DeskApiClient {
+    #baseUrl;
+    #token;
+    constructor(baseUrl, token) {
+        const parsed = new URL(baseUrl);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            throw new Error("daemon URL must use HTTP or HTTPS");
+        }
+        if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+            throw new Error("daemon URL must not contain credentials, query, or fragment");
+        }
+        if (typeof token !== "string" || token.length < 8) {
+            throw new Error("daemon token must contain at least 8 characters");
+        }
+        this.#baseUrl = parsed.href.replace(/\/$/, "");
+        this.#token = token;
+    }
+    async health(signal) {
+        const value = await this.#request("/api/v1/health", {
+            authenticated: false,
+            ...(signal === undefined ? {} : { signal }),
+        });
+        if (!isHealth(value)) {
+            throw new Error("Daemon returned an invalid health response");
+        }
+        return value;
+    }
+    async listDocuments() {
+        const value = await this.#request("/api/v1/documents");
+        if (!Array.isArray(value) || !value.every(isPublicDocument)) {
+            throw new Error("Daemon returned an invalid document list");
+        }
+        return value;
+    }
+    async listWorkspaces() {
+        const value = await this.#request("/api/v1/workspaces");
+        if (!Array.isArray(value) || !value.every(isPublicWorkspace)) {
+            throw new Error("Daemon returned an invalid workspace list");
+        }
+        return value;
+    }
+    async renderDocument(id, target, width = 100, preferences = {}) {
+        assertDocumentId(id);
+        if (!Number.isSafeInteger(width) || width < 20 || width > 1_000) {
+            throw new Error("render width must be an integer between 20 and 1000");
+        }
+        const query = new URLSearchParams({ target });
+        if (target === "terminal") {
+            query.set("width", String(width));
+            if (preferences.color !== undefined) {
+                query.set("color", String(preferences.color));
+            }
+            if (preferences.unicode !== undefined) {
+                query.set("unicode", String(preferences.unicode));
+            }
+        }
+        const value = await this.#request(`/api/v1/documents/${encodeURIComponent(id)}/render?${query.toString()}`);
+        if (target === "terminal" && isTerminalRender(value)) {
+            return value;
+        }
+        if (target === "web" && isWebRender(value)) {
+            return value;
+        }
+        throw new Error("Daemon returned an invalid render response");
+    }
+    async act(id, action) {
+        assertDocumentId(id);
+        const value = await this.#request(`/api/v1/documents/${encodeURIComponent(id)}/${action}`, { method: "POST" });
+        if (!isPublicDocument(value)) {
+            throw new Error("Daemon returned an invalid document response");
+        }
+        return value;
+    }
+    async subscribeCatalog(listener, options = {}) {
+        try {
+            const response = await fetch(`${this.#baseUrl}/api/v1/events`, {
+                headers: { authorization: `Bearer ${this.#token}` },
+                ...(options.signal === undefined ? {} : { signal: options.signal }),
+            });
+            if (!response.ok) {
+                let body;
+                try {
+                    body = await response.json();
+                }
+                catch {
+                    throw new Error(`Daemon event stream failed (${response.status})`);
+                }
+                if (isErrorEnvelope(body)) {
+                    throw new Error(body.error.message);
+                }
+                throw new Error(`Daemon event stream failed (${response.status})`);
+            }
+            if (!response.body) {
+                throw new Error("Daemon returned an empty event stream");
+            }
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            while (true) {
+                const chunk = await reader.read();
+                if (chunk.done) {
+                    break;
+                }
+                buffer += decoder.decode(chunk.value, { stream: true }).replaceAll("\r\n", "\n");
+                let boundary = buffer.indexOf("\n\n");
+                while (boundary >= 0) {
+                    const block = buffer.slice(0, boundary);
+                    buffer = buffer.slice(boundary + 2);
+                    dispatchEventBlock(block, listener, options.onReady);
+                    boundary = buffer.indexOf("\n\n");
+                }
+            }
+        }
+        catch (error) {
+            if (options.signal?.aborted) {
+                return;
+            }
+            throw error;
+        }
+    }
+    async #request(path, options = {}) {
+        const authenticated = options.authenticated ?? true;
+        const response = await fetch(`${this.#baseUrl}${path}`, {
+            method: options.method ?? "GET",
+            ...(authenticated
+                ? { headers: { authorization: `Bearer ${this.#token}` } }
+                : {}),
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        });
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch {
+            throw new Error(`Daemon returned a non-JSON response (${response.status})`);
+        }
+        if (!response.ok) {
+            if (isErrorEnvelope(body)) {
+                throw new Error(body.error.message);
+            }
+            throw new Error(`Daemon request failed (${response.status})`);
+        }
+        if (!isRecord(body) || !("data" in body)) {
+            throw new Error("Daemon returned an invalid response envelope");
+        }
+        return body.data;
+    }
+}
+function isHealth(value) {
+    return (isRecord(value) &&
+        value.service === "mdmaid.desk" &&
+        value.status === "ok" &&
+        typeof value.version === "number");
+}
+function isPublicWorkspace(value) {
+    return (isRecord(value) &&
+        typeof value.id === "string" &&
+        typeof value.name === "string" &&
+        typeof value.documentCount === "number" &&
+        typeof value.route === "string");
+}
+function isPublicDocument(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return (typeof value.id === "string" &&
+        typeof value.workspaceId === "string" &&
+        optionalString(value.taskId) &&
+        optionalString(value.producer) &&
+        typeof value.kind === "string" &&
+        DOCUMENT_KINDS.includes(value.kind) &&
+        typeof value.title === "string" &&
+        typeof value.attention === "string" &&
+        ATTENTION_STATES.includes(value.attention) &&
+        Array.isArray(value.tags) &&
+        value.tags.every((tag) => typeof tag === "string") &&
+        isInteger(value.revision) &&
+        nullableInteger(value.openedRevision) &&
+        nullableInteger(value.completedRevision) &&
+        (value.status === "unread" ||
+            value.status === "reading" ||
+            value.status === "done") &&
+        nullableString(value.archivedAt) &&
+        nullableString(value.missingAt) &&
+        typeof value.createdAt === "string" &&
+        typeof value.updatedAt === "string" &&
+        typeof value.route === "string");
+}
+function isWebRender(value) {
+    return (isRecord(value) &&
+        value.target === "web" &&
+        typeof value.content === "string" &&
+        isPublicDocument(value.document));
+}
+function isTerminalRender(value) {
+    return (isRecord(value) &&
+        value.target === "terminal" &&
+        typeof value.content === "string" &&
+        typeof value.backend === "string" &&
+        Array.isArray(value.warnings) &&
+        value.warnings.every((warning) => typeof warning === "string") &&
+        isPublicDocument(value.document));
+}
+function isErrorEnvelope(value) {
+    return (isRecord(value) &&
+        isRecord(value.error) &&
+        typeof value.error.code === "string" &&
+        typeof value.error.message === "string");
+}
+function dispatchEventBlock(block, listener, onReady) {
+    let type = "message";
+    const data = [];
+    for (const line of block.split("\n")) {
+        if (line.startsWith("event:")) {
+            type = line.slice("event:".length).trim();
+        }
+        else if (line.startsWith("data:")) {
+            data.push(line.slice("data:".length).trimStart());
+        }
+    }
+    if (type === "ready") {
+        onReady?.();
+        return;
+    }
+    if (type !== "catalog") {
+        return;
+    }
+    let value;
+    try {
+        value = JSON.parse(data.join("\n"));
+    }
+    catch {
+        throw new Error("Daemon returned an invalid catalog event");
+    }
+    if (!isRecord(value) ||
+        typeof value.action !== "string" ||
+        typeof value.documentId !== "string" ||
+        !/^doc-[a-f0-9]{20}$/.test(value.documentId)) {
+        throw new Error("Daemon returned an invalid catalog event");
+    }
+    listener({ action: value.action, documentId: value.documentId });
+}
+function optionalString(value) {
+    return value === undefined || typeof value === "string";
+}
+function nullableString(value) {
+    return value === null || typeof value === "string";
+}
+function isInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value);
+}
+function nullableInteger(value) {
+    return value === null || isInteger(value);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function assertDocumentId(id) {
+    if (!/^doc-[a-f0-9]{20}$/.test(id)) {
+        throw new Error("invalid document id");
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AA6BrB,MAAM,OAAO,aAAa;IACf,QAAQ,CAAS;IACjB,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,KAAa;QACxC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAoB;QAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE;YAClD,aAAa,EAAE,KAAK;YACpB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAaD,KAAK,CAAC,cAAc,CAClB,EAAU,EACV,MAAoB,EACpB,KAAK,GAAG,GAAG,EACX,cAAyC,EAAE;QAE3C,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClC,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,WAAW,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACtC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC/B,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,WAAW,KAAK,CAAC,QAAQ,EAAE,EAAE,CACzE,CAAC;QACF,IAAI,MAAM,KAAK,UAAU,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,KAAK,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,MAAsB;QAC1C,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC/B,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,EACvD,EAAE,MAAM,EAAE,MAAM,EAAE,CACnB,CAAC;QACF,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,QAAuC,EACvC,UAAsC,EAAE;QAExC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,gBAAgB,EAAE;gBAC7D,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;gBACnD,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;aACpE,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,IAAa,CAAC;gBAClB,IAAI,CAAC;oBACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;gBACrE,CAAC;gBACD,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtC,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM;gBACR,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACjF,IAAI,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACtC,OAAO,QAAQ,IAAI,CAAC,EAAE,CAAC;oBACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;oBACxC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;oBACpC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;oBACrD,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,UAII,EAAE;QAEN,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,EAAE;YACtD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,GAAG,CAAC,aAAa;gBACf,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE;gBACzD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACpE,CAAC,CAAC;QACH,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,OAAO,KAAK,aAAa;QAC/B,KAAK,CAAC,MAAM,KAAK,IAAI;QACrB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;QACvC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CACL,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC7B,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAC1D,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QAClC,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;QACjE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC;QAClD,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC;QACzB,eAAe,CAAC,KAAK,CAAC,cAAc,CAAC;QACrC,eAAe,CAAC,KAAK,CAAC,iBAAiB,CAAC;QACxC,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ;YACxB,KAAK,CAAC,MAAM,KAAK,SAAS;YAC1B,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC;QAC1B,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC;QAChC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,MAAM,KAAK,KAAK;QACtB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CACjC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,MAAM,KAAK,UAAU;QAC3B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC7B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC;QAC9D,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CACjC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QACpC,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAa,EACb,QAAuC,EACvC,OAAiC;IAEjC,IAAI,IAAI,GAAG,SAAS,CAAC;IACrB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAC5C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU;IAClC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/api-types.d.ts

@@ -0,0 +1,51 @@
+import type { Attention, DocumentKind, ReadingStatus } from "./domain.js";
+export type { Attention, DocumentKind, ReadingStatus };
+export interface PublicDocument {
+    id: string;
+    workspaceId: string;
+    taskId?: string;
+    producer?: string;
+    kind: DocumentKind;
+    title: string;
+    attention: Attention;
+    tags: string[];
+    revision: number;
+    openedRevision: number | null;
+    completedRevision: number | null;
+    status: ReadingStatus;
+    archivedAt: string | null;
+    missingAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    route: string;
+}
+export interface PublicWorkspace {
+    id: string;
+    name: string;
+    documentCount: number;
+    route: string;
+}
+export interface HealthData {
+    service: "mdmaid.desk";
+    status: "ok";
+    version: number;
+}
+export type RenderTarget = "web" | "terminal";
+export interface TerminalRenderPreferences {
+    color?: boolean;
+    unicode?: boolean;
+}
+export interface WebRender {
+    document: PublicDocument;
+    target: "web";
+    content: string;
+}
+export interface TerminalRender {
+    document: PublicDocument;
+    target: "terminal";
+    content: string;
+    backend: string;
+    warnings: string[];
+}
+export type DocumentRender = WebRender | TerminalRender;
+export type DocumentAction = "opened" | "read" | "unread" | "archive" | "restore" | "missing" | "present";

package/dist/api-types.js

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

package/dist/api-types.js.map

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

package/dist/auth-state.d.ts

@@ -0,0 +1,2 @@
+export declare function authTokenPath(statePath: string): string;
+export declare function readOrCreateAuthToken(statePath: string): Promise<string>;