mdmaid-desk 0.1.0

package/dist/daemon-state.js

@@ -0,0 +1,204 @@
+import { randomBytes } from "node:crypto";
+import { constants } from "node:fs";
+import { chmod, lstat, mkdir, open, rename, unlink, } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { DeskApiClient } from "./api-client.js";
+import { syncDirectory } from "./fs-durability.js";
+export const DESK_PROTOCOL_VERSION = 1;
+const MAX_DESCRIPTOR_BYTES = 8 * 1024;
+const LOOPBACK_HOSTS = new Set(["127.0.0.1", "::1", "localhost"]);
+export function daemonDescriptorPath(statePath) {
+    return join(dirname(resolve(statePath)), "daemon.json");
+}
+export function descriptorForServer(server) {
+    return {
+        protocolVersion: DESK_PROTOCOL_VERSION,
+        pid: process.pid,
+        host: server.host,
+        port: server.port,
+        token: server.token,
+        startedAt: new Date().toISOString(),
+    };
+}
+export async function writeDaemonDescriptor(path, descriptor) {
+    validateDaemonDescriptor(descriptor);
+    const destination = resolve(path);
+    const directory = dirname(destination);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    await chmod(directory, 0o700);
+    await assertReplaceable(destination);
+    const temporary = join(directory, `.${basename(destination)}.${process.pid}.${randomBytes(8).toString("hex")}.tmp`);
+    let created = false;
+    try {
+        const handle = await open(temporary, constants.O_CREAT |
+            constants.O_EXCL |
+            constants.O_WRONLY |
+            constants.O_NOFOLLOW, 0o600);
+        created = true;
+        try {
+            await handle.writeFile(`${JSON.stringify(descriptor)}\n`, "utf8");
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await chmod(temporary, 0o600);
+        await rename(temporary, destination);
+        created = false;
+        await syncDirectory(directory);
+    }
+    finally {
+        if (created) {
+            await unlinkIfPresent(temporary);
+        }
+    }
+}
+export async function readDaemonDescriptor(path) {
+    const destination = resolve(path);
+    let info;
+    try {
+        info = await lstat(destination);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+    if (info.isSymbolicLink() || !info.isFile()) {
+        throw new Error("Daemon descriptor must be a regular, non-symlink file");
+    }
+    if ((info.mode & 0o077) !== 0) {
+        throw new Error("Daemon descriptor must have user-only permissions");
+    }
+    if (typeof process.getuid === "function" && info.uid !== process.getuid()) {
+        throw new Error("Daemon descriptor must be owned by the current user");
+    }
+    if (info.size > MAX_DESCRIPTOR_BYTES) {
+        throw new Error("Invalid daemon descriptor");
+    }
+    const handle = await open(destination, constants.O_RDONLY | constants.O_NOFOLLOW);
+    let raw;
+    try {
+        const opened = await handle.stat();
+        if (opened.dev !== info.dev || opened.ino !== info.ino) {
+            throw new Error("Daemon descriptor changed while opening");
+        }
+        raw = await handle.readFile("utf8");
+    }
+    finally {
+        await handle.close();
+    }
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        throw new Error("Invalid daemon descriptor");
+    }
+    if (!isDaemonDescriptor(value)) {
+        throw new Error("Invalid daemon descriptor");
+    }
+    return value;
+}
+export async function removeDaemonDescriptor(path, expected) {
+    const current = await readDaemonDescriptor(path);
+    if (!current || !sameDescriptor(current, expected)) {
+        return false;
+    }
+    try {
+        await unlink(resolve(path));
+        return true;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function connectToDaemon(statePath) {
+    const path = daemonDescriptorPath(statePath);
+    const descriptor = await readDaemonDescriptor(path);
+    if (!descriptor) {
+        return undefined;
+    }
+    const host = descriptor.host.includes(":")
+        ? `[${descriptor.host}]`
+        : descriptor.host;
+    const client = new DeskApiClient(`http://${host}:${descriptor.port}`, descriptor.token);
+    try {
+        const health = await client.health(AbortSignal.timeout(1_000));
+        if (health.version !== descriptor.protocolVersion) {
+            throw new Error("Daemon protocol version does not match its descriptor");
+        }
+        return client;
+    }
+    catch {
+        await removeDaemonDescriptor(path, descriptor);
+        return undefined;
+    }
+}
+function validateDaemonDescriptor(value) {
+    if (!isDaemonDescriptor(value)) {
+        throw new Error("Invalid daemon descriptor");
+    }
+}
+function isDaemonDescriptor(value) {
+    if (!isRecord(value) || Object.keys(value).length !== 6) {
+        return false;
+    }
+    return (value.protocolVersion === DESK_PROTOCOL_VERSION &&
+        typeof value.pid === "number" &&
+        Number.isSafeInteger(value.pid) &&
+        value.pid > 0 &&
+        typeof value.host === "string" &&
+        LOOPBACK_HOSTS.has(value.host) &&
+        typeof value.port === "number" &&
+        Number.isSafeInteger(value.port) &&
+        value.port > 0 &&
+        value.port <= 65_535 &&
+        typeof value.token === "string" &&
+        value.token.length >= 8 &&
+        typeof value.startedAt === "string" &&
+        !Number.isNaN(Date.parse(value.startedAt)));
+}
+async function assertReplaceable(path) {
+    try {
+        const info = await lstat(path);
+        if (info.isSymbolicLink() || !info.isFile()) {
+            throw new Error("Daemon descriptor must be a regular, non-symlink file");
+        }
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+}
+function sameDescriptor(left, right) {
+    return (left.protocolVersion === right.protocolVersion &&
+        left.pid === right.pid &&
+        left.host === right.host &&
+        left.port === right.port &&
+        left.token === right.token &&
+        left.startedAt === right.startedAt);
+}
+async function unlinkIfPresent(path) {
+    try {
+        await unlink(path);
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=daemon-state.js.map

package/dist/daemon-state.js.map

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

package/dist/domain.d.ts

@@ -0,0 +1,49 @@
+export declare const DOCUMENT_KINDS: readonly ["definition", "brief", "research", "decision", "plan", "contract", "handoff", "progress", "verification", "review", "pr", "showcase", "other"];
+export type DocumentKind = (typeof DOCUMENT_KINDS)[number];
+export declare const ATTENTION_STATES: readonly ["none", "review", "approval", "failure", "changes_requested"];
+export type Attention = (typeof ATTENTION_STATES)[number];
+export type ReadingStatus = "unread" | "reading" | "done";
+export interface ReadingProgress {
+    revision: number;
+    openedRevision: number | null;
+    completedRevision: number | null;
+}
+export interface Workspace {
+    id: string;
+    name: string;
+    root: string;
+    artifactRoots: string[];
+}
+export interface StoredDocument extends ReadingProgress {
+    id: string;
+    workspaceId: string;
+    taskId?: string;
+    producer?: string;
+    kind: DocumentKind;
+    title: string;
+    path: string;
+    attention: Attention;
+    tags: string[];
+    contentHash: string;
+    archivedAt: string | null;
+    missingAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Document extends StoredDocument {
+    status: ReadingStatus;
+}
+export interface DocumentFilters {
+    workspaceId?: string;
+    taskId?: string;
+    tag?: string;
+    status?: ReadingStatus;
+    kind?: DocumentKind;
+    attention?: Attention;
+    archived?: boolean;
+    missing?: boolean;
+}
+export declare function deriveReadingStatus(progress: ReadingProgress): ReadingStatus;
+export declare function presentDocument(document: StoredDocument): Document;
+export declare function isDocumentKind(value: string): value is DocumentKind;
+export declare function isAttention(value: string): value is Attention;

package/dist/domain.js

@@ -0,0 +1,44 @@
+export const DOCUMENT_KINDS = [
+    "definition",
+    "brief",
+    "research",
+    "decision",
+    "plan",
+    "contract",
+    "handoff",
+    "progress",
+    "verification",
+    "review",
+    "pr",
+    "showcase",
+    "other",
+];
+export const ATTENTION_STATES = [
+    "none",
+    "review",
+    "approval",
+    "failure",
+    "changes_requested",
+];
+export function deriveReadingStatus(progress) {
+    if (progress.completedRevision === progress.revision) {
+        return "done";
+    }
+    if (progress.openedRevision === progress.revision) {
+        return "reading";
+    }
+    return "unread";
+}
+export function presentDocument(document) {
+    return {
+        ...structuredClone(document),
+        status: deriveReadingStatus(document),
+    };
+}
+export function isDocumentKind(value) {
+    return DOCUMENT_KINDS.includes(value);
+}
+export function isAttention(value) {
+    return ATTENTION_STATES.includes(value);
+}
+//# sourceMappingURL=domain.js.map

package/dist/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY;IACZ,OAAO;IACP,UAAU;IACV,UAAU;IACV,MAAM;IACN,UAAU;IACV,SAAS;IACT,UAAU;IACV,cAAc;IACd,QAAQ;IACR,IAAI;IACJ,UAAU;IACV,OAAO;CACC,CAAC;AAIX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,QAAQ;IACR,UAAU;IACV,SAAS;IACT,mBAAmB;CACX,CAAC;AAkDX,MAAM,UAAU,mBAAmB,CAAC,QAAyB;IAC3D,IAAI,QAAQ,CAAC,iBAAiB,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,QAAQ,CAAC,cAAc,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,OAAO;QACL,GAAG,eAAe,CAAC,QAAQ,CAAC;QAC5B,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC"}

package/dist/fs-durability.d.ts

@@ -0,0 +1,2 @@
+export declare function syncDirectory(path: string): Promise<void>;
+export declare function isUnsupportedDirectorySyncError(error: unknown, platform: NodeJS.Platform): boolean;

package/dist/fs-durability.js

@@ -0,0 +1,35 @@
+import { constants } from "node:fs";
+import { open } from "node:fs/promises";
+const UNSUPPORTED_DIRECTORY_SYNC_CODES = new Set([
+    "EINVAL",
+    "ENOTSUP",
+    "EOPNOTSUPP",
+]);
+export async function syncDirectory(path) {
+    let handle;
+    try {
+        handle = await open(path, constants.O_RDONLY);
+        await handle.sync();
+    }
+    catch (error) {
+        if (!isUnsupportedDirectorySyncError(error, process.platform)) {
+            throw error;
+        }
+    }
+    finally {
+        await handle?.close();
+    }
+}
+export function isUnsupportedDirectorySyncError(error, platform) {
+    if (!isNodeError(error) || typeof error.code !== "string") {
+        return false;
+    }
+    if (UNSUPPORTED_DIRECTORY_SYNC_CODES.has(error.code)) {
+        return true;
+    }
+    return (platform === "win32" && (error.code === "EPERM" || error.code === "EISDIR"));
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=fs-durability.js.map

package/dist/fs-durability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-durability.js","sourceRoot":"","sources":["../src/fs-durability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,gCAAgC,GAAG,IAAI,GAAG,CAAC;IAC/C,QAAQ;IACR,SAAS;IACT,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,+BAA+B,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAc,EACd,QAAyB;IAEzB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,gCAAgC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC"}

package/dist/package-info.d.ts

@@ -0,0 +1 @@
+export declare function readPackageVersion(): string;

package/dist/package-info.js

@@ -0,0 +1,17 @@
+import { readFileSync } from "node:fs";
+function isPackageMetadata(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const version = value.version;
+    return typeof version === "string" && /^\d+\.\d+\.\d+(?:[-+].+)?$/.test(version);
+}
+export function readPackageVersion() {
+    const packageUrl = new URL("../package.json", import.meta.url);
+    const parsed = JSON.parse(readFileSync(packageUrl, "utf8"));
+    if (!isPackageMetadata(parsed)) {
+        throw new Error("package.json contains an invalid version");
+    }
+    return parsed.version;
+}
+//# sourceMappingURL=package-info.js.map

package/dist/package-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-info.js","sourceRoot":"","sources":["../src/package-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMvC,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAI,KAAiC,CAAC,OAAO,CAAC;IAC3D,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+import { type Catalog } from "./catalog.js";
+export interface DeskServerOptions {
+    catalog: Catalog;
+    host?: string;
+    port?: number;
+    publicUrl?: string;
+    token?: string;
+}
+export interface RunningDeskServer {
+    close(): Promise<void>;
+    host: string;
+    port: number;
+    token: string;
+    url: string;
+    webUrl: string;
+}
+export declare function startDeskServer(options: DeskServerOptions): Promise<RunningDeskServer>;
+export declare function normalizePublicUrl(value: string): string;