opsx-ui 0.1.0

package/dist/server/project-resolver.js

@@ -0,0 +1,66 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { execFile } from "node:child_process";
+/**
+ * Resolves which OpenSpec project the viewer points at (design D6). Owns cwd
+ * detection, the `-g` global-mode decision, the init-fallback signal, and
+ * store discovery — isolated from rendering and from the source port so launch
+ * logic has a single home (SRP).
+ */
+export class ProjectResolver {
+    /** True when `openspec/` exists directly under `dir`. */
+    static hasOpenSpec(dir) {
+        return existsSync(path.join(dir, "openspec"));
+    }
+    /**
+     * Resolve the current directory as a project. Returns `null` when no
+     * `openspec/` is present so the caller can offer to initialize or pick
+     * another project (viewer-cli: init fallback).
+     */
+    static fromCwd(cwd) {
+        if (!ProjectResolver.hasOpenSpec(cwd))
+            return null;
+        return ProjectResolver.forDirectory(cwd, "cwd");
+    }
+    /** Build a ProjectView for an explicitly chosen directory. */
+    static forDirectory(dir, source) {
+        return {
+            root: path.resolve(dir),
+            name: path.basename(path.resolve(dir)) || dir,
+            source,
+            storeId: null,
+        };
+    }
+    /** Build a ProjectView for a registered store. */
+    static forStore(store) {
+        return {
+            root: store.root,
+            name: store.name || store.id,
+            source: "store",
+            storeId: store.id,
+        };
+    }
+    /** Discover registered stores via `openspec store list --json`. */
+    static async listStores(bin = "openspec") {
+        const stdout = await new Promise((resolve) => {
+            execFile(bin, ["store", "list", "--json", "--no-color"], { maxBuffer: 8 * 1024 * 1024 }, (error, out) => resolve(error ? "" : out));
+        });
+        if (!stdout.trim())
+            return [];
+        try {
+            const parsed = JSON.parse(stdout);
+            return (parsed.stores ?? []).map((raw) => {
+                const s = (raw ?? {});
+                return {
+                    id: String(s.id ?? ""),
+                    name: typeof s.name === "string" ? s.name : String(s.id ?? ""),
+                    root: typeof s.root === "string" ? s.root : String(s.path ?? ""),
+                };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=project-resolver.js.map

package/dist/server/project-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.js","sourceRoot":"","sources":["../../src/server/project-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAS9C;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAC1B,yDAAyD;IACzD,MAAM,CAAC,WAAW,CAAC,GAAW;QAC5B,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,GAAW;QACxB,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO,eAAe,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,8DAA8D;IAC9D,MAAM,CAAC,YAAY,CAAC,GAAW,EAAE,MAAqB;QACpD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;YACvB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG;YAC7C,MAAM;YACN,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,MAAM,CAAC,QAAQ,CAAC,KAAsB;QACpC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;YAC5B,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,KAAK,CAAC,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,UAAU;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACnD,QAAQ,CACN,GAAG,EACH,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,EACzC,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAC9B,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA2B,CAAC;YAC5D,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACvC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;gBACjD,OAAO;oBACL,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;oBACtB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;oBAC9D,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;iBACjE,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/server/session.js

@@ -0,0 +1,75 @@
+import { CliOpenSpecSource, ExecCliRunner, FilesystemSource, SnapshotService, } from "../core/index.js";
+import { OpenSpecWatcher } from "./watcher.js";
+/**
+ * A single opened project: wires the read-only source, the snapshot composer,
+ * and the filesystem watcher together, and keeps the latest snapshot cached so
+ * new clients render instantly. All mutation of state originates from disk
+ * events — the session never writes to the project.
+ */
+export class ViewerSession {
+    project;
+    events;
+    source;
+    archive;
+    snapshots;
+    watcher;
+    current = null;
+    cliVersion = "unknown";
+    constructor(project, events, options = {}) {
+        this.project = project;
+        this.events = events;
+        const runner = new ExecCliRunner({ cwd: project.root });
+        this.source = new CliOpenSpecSource(runner, { storeId: project.storeId });
+        this.archive = new FilesystemSource(project.root);
+        this.snapshots = new SnapshotService(this.source, this.archive);
+        this.watcher = new OpenSpecWatcher(project.root, {
+            usePolling: options.usePolling,
+        });
+    }
+    get version() {
+        return this.cliVersion;
+    }
+    /** Verify OpenSpec, build the first snapshot, and begin watching. */
+    async init() {
+        this.cliVersion = await this.source.version();
+        const snapshot = await this.rebuild();
+        this.watcher.onInvalidated(() => {
+            void this.rebuild();
+        });
+        this.watcher.onActivity((entry) => this.events.onActivity(entry));
+        this.watcher.start();
+        return snapshot;
+    }
+    /** Re-read state and broadcast. Also the manual-refresh path (task 4.5). */
+    async refresh() {
+        return this.rebuild();
+    }
+    async rebuild() {
+        const snapshot = await this.snapshots.build(this.project);
+        this.current = snapshot;
+        this.events.onSnapshot(snapshot);
+        return snapshot;
+    }
+    getSnapshot() {
+        return this.current;
+    }
+    getSpec(id) {
+        return this.source.getSpec(id);
+    }
+    getDeltas(changeId) {
+        return this.source.getDeltas(changeId);
+    }
+    getStatus(changeId) {
+        return this.source.getStatus(changeId);
+    }
+    getArchivedChange(id) {
+        return this.archive.getArchivedChange(id);
+    }
+    getRawDocument(relativePath) {
+        return this.archive.getRawDocument(relativePath);
+    }
+    async dispose() {
+        await this.watcher.stop();
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/server/session.js.map

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

package/dist/server/viewer-server.js

@@ -0,0 +1,207 @@
+import express from "express";
+import { createServer } from "node:http";
+import { WebSocketServer, WebSocket } from "ws";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { ViewerSession } from "./session.js";
+import { ProjectResolver } from "./project-resolver.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** dist/server/server → dist/web */
+const WEB_DIST = path.resolve(__dirname, "../web");
+/**
+ * The HTTP + WebSocket server. Owns the set of connected clients and the single
+ * active ViewerSession; brokers live snapshot/activity messages to browsers.
+ * Read-only end to end: no route writes to any project.
+ */
+export class ViewerServer {
+    options;
+    app;
+    http;
+    wss;
+    clients = new Set();
+    session = null;
+    constructor(options) {
+        this.options = options;
+        this.app = express();
+        this.app.use(express.json());
+        this.registerRoutes();
+        this.serveStatic();
+        this.http = createServer(this.app);
+        this.wss = new WebSocketServer({ server: this.http, path: "/ws" });
+        this.wss.on("connection", (socket) => this.onClient(socket));
+        // A WSS bound to `server` re-emits the HTTP server's listen errors. `listen()`
+        // already handles EADDRINUSE by retrying the next port, so swallow it here to
+        // avoid an unhandled 'error' event crashing the process; surface anything else.
+        this.wss.on("error", (err) => {
+            if (err.code !== "EADDRINUSE")
+                console.error("[opsx-ui] websocket server error:", err);
+        });
+    }
+    async start(port) {
+        if (this.options.initialProject) {
+            await this.openProject(this.options.initialProject).catch(() => {
+                /* surfaced to the UI via bootstrap; don't crash the server */
+            });
+        }
+        const actual = await this.listen(port);
+        return actual;
+    }
+    onClient(socket) {
+        this.clients.add(socket);
+        socket.on("close", () => this.clients.delete(socket));
+        const snapshot = this.session?.getSnapshot();
+        if (snapshot)
+            this.send(socket, { type: "snapshot", payload: snapshot });
+    }
+    broadcast(message) {
+        const data = JSON.stringify(message);
+        for (const client of this.clients) {
+            if (client.readyState === WebSocket.OPEN)
+                client.send(data);
+        }
+    }
+    send(socket, message) {
+        if (socket.readyState === WebSocket.OPEN) {
+            socket.send(JSON.stringify(message));
+        }
+    }
+    /** Open (or switch to) a project, replacing any current session. */
+    async openProject(project) {
+        await this.session?.dispose();
+        this.session = new ViewerSession(project, {
+            onSnapshot: (snapshot) => this.broadcast({ type: "snapshot", payload: snapshot }),
+            onActivity: (entry) => this.broadcast({ type: "activity", payload: entry }),
+        }, { usePolling: this.options.usePolling });
+        await this.session.init();
+    }
+    registerRoutes() {
+        const api = express.Router();
+        api.get("/bootstrap", async (_req, res) => {
+            const stores = await ProjectResolver.listStores().catch(() => []);
+            res.json({
+                project: this.session?.project ?? null,
+                version: this.session?.version ?? null,
+                cwd: this.options.cwd,
+                cwdHasOpenSpec: ProjectResolver.hasOpenSpec(this.options.cwd),
+                stores,
+            });
+        });
+        api.post("/open", async (req, res) => {
+            try {
+                const project = await this.resolveOpenRequest(req.body ?? {});
+                if (!project) {
+                    res
+                        .status(400)
+                        .json({ error: "No openspec/ found at that location." });
+                    return;
+                }
+                await this.openProject(project);
+                res.json({ project, version: this.session?.version });
+            }
+            catch (error) {
+                res.status(400).json({ error: error.message });
+            }
+        });
+        api.post("/refresh", async (_req, res) => {
+            if (!this.session) {
+                res.status(409).json({ error: "No project open." });
+                return;
+            }
+            const snapshot = await this.session.refresh();
+            res.json(snapshot);
+        });
+        api.get("/snapshot", (_req, res) => {
+            const snapshot = this.session?.getSnapshot();
+            if (!snapshot) {
+                res.status(409).json({ error: "No project open." });
+                return;
+            }
+            res.json(snapshot);
+        });
+        api.get("/specs/:id", this.guarded(async (req, res, session) => {
+            res.json(await session.getSpec(req.params.id));
+        }));
+        api.get("/changes/:id/deltas", this.guarded(async (req, res, session) => {
+            res.json(await session.getDeltas(req.params.id));
+        }));
+        api.get("/changes/:id/status", this.guarded(async (req, res, session) => {
+            res.json(await session.getStatus(req.params.id));
+        }));
+        api.get("/archive/:id", this.guarded(async (req, res, session) => {
+            res.json(await session.getArchivedChange(req.params.id));
+        }));
+        api.get("/document", this.guarded(async (req, res, session) => {
+            const rel = typeof req.query.path === "string" ? req.query.path : "";
+            res.json(await session.getRawDocument(rel));
+        }));
+        this.app.use("/api", api);
+    }
+    /** Wrap a handler that requires an open session, with error translation. */
+    guarded(handler) {
+        return async (req, res) => {
+            if (!this.session) {
+                res.status(409).json({ error: "No project open." });
+                return;
+            }
+            try {
+                await handler(req, res, this.session);
+            }
+            catch (error) {
+                res.status(500).json({ error: error.message });
+            }
+        };
+    }
+    async resolveOpenRequest(body) {
+        if (body.storeId) {
+            const stores = await ProjectResolver.listStores();
+            const store = stores.find((s) => s.id === body.storeId);
+            return store ? ProjectResolver.forStore(store) : null;
+        }
+        if (body.dir) {
+            return ProjectResolver.hasOpenSpec(body.dir)
+                ? ProjectResolver.forDirectory(body.dir, "picked")
+                : null;
+        }
+        return ProjectResolver.fromCwd(this.options.cwd);
+    }
+    serveStatic() {
+        if (!existsSync(WEB_DIST))
+            return;
+        this.app.use(express.static(WEB_DIST));
+        // SPA fallback for client-side routes.
+        this.app.get("*", (req, res, next) => {
+            if (req.path.startsWith("/api") || req.path.startsWith("/ws")) {
+                next();
+                return;
+            }
+            res.sendFile(path.join(WEB_DIST, "index.html"));
+        });
+    }
+    listen(port) {
+        return new Promise((resolve, reject) => {
+            const onError = (err) => {
+                if (err.code === "EADDRINUSE") {
+                    this.http.removeListener("error", onError);
+                    resolve(this.listen(port + 1));
+                }
+                else {
+                    reject(err);
+                }
+            };
+            this.http.once("error", onError);
+            this.http.listen(port, () => {
+                this.http.removeListener("error", onError);
+                resolve(port);
+            });
+        });
+    }
+    async stop() {
+        await this.session?.dispose();
+        for (const client of this.clients)
+            client.close();
+        await new Promise((resolve) => this.wss.close(() => resolve()));
+        await new Promise((resolve) => this.http.close(() => resolve()));
+    }
+}
+//# sourceMappingURL=viewer-server.js.map

package/dist/server/viewer-server.js.map

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

package/dist/server/watcher.js

@@ -0,0 +1,119 @@
+import path from "node:path";
+import chokidar from "chokidar";
+import { randomUUID } from "node:crypto";
+/**
+ * Watches a project's `openspec/` tree and signals two things (design D5):
+ *  - `onInvalidated`: debounced — "state changed, rebuild the snapshot".
+ *  - `onActivity`: per raw event — an entry for the live activity feed.
+ * Read-only: it only observes; it never writes.
+ */
+export class OpenSpecWatcher {
+    watcher = null;
+    openspecDir;
+    debounceMs;
+    usePolling;
+    debounceTimer = null;
+    invalidatedListeners = new Set();
+    activityListeners = new Set();
+    constructor(projectRoot, options = {}) {
+        this.openspecDir = path.join(projectRoot, "openspec");
+        this.debounceMs = options.debounceMs ?? 150;
+        this.usePolling = options.usePolling ?? false;
+    }
+    onInvalidated(listener) {
+        this.invalidatedListeners.add(listener);
+    }
+    onActivity(listener) {
+        this.activityListeners.add(listener);
+    }
+    start() {
+        if (this.watcher)
+            return;
+        this.watcher = chokidar.watch(this.openspecDir, {
+            ignoreInitial: true,
+            usePolling: this.usePolling,
+            awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 },
+        });
+        this.watcher
+            .on("add", (p) => this.handle(p, "created"))
+            .on("change", (p) => this.handle(p, "modified"))
+            .on("unlink", (p) => this.handle(p, "removed"));
+    }
+    async stop() {
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        await this.watcher?.close();
+        this.watcher = null;
+    }
+    handle(absPath, kind) {
+        const entry = this.deriveActivity(absPath, kind);
+        if (entry) {
+            for (const listener of this.activityListeners)
+                listener(entry);
+        }
+        this.scheduleInvalidation();
+    }
+    scheduleInvalidation() {
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            for (const listener of this.invalidatedListeners)
+                listener();
+        }, this.debounceMs);
+    }
+    /** Translate a changed path into a human-legible feed entry. */
+    deriveActivity(absPath, kind) {
+        const rel = path.relative(this.openspecDir, absPath).split(path.sep);
+        const base = {
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+            kind,
+        };
+        const verb = kind === "created" ? "added" : kind === "removed" ? "removed" : "updated";
+        if (rel[0] === "changes" && rel[1] === "archive" && rel[2]) {
+            return {
+                ...base,
+                targetType: "change",
+                targetId: rel[2],
+                detail: kind === "created" ? "Change archived" : `Archive ${verb}`,
+            };
+        }
+        if (rel[0] === "changes" && rel[1]) {
+            const change = rel[1];
+            const artifact = rel[rel.length - 1];
+            if (rel.length <= 2 || artifact === "README.md") {
+                return {
+                    ...base,
+                    targetType: "change",
+                    targetId: change,
+                    detail: `Change ${verb}`,
+                };
+            }
+            if (rel[2] === "specs") {
+                return {
+                    ...base,
+                    targetType: "artifact",
+                    targetId: change,
+                    detail: `Delta ${verb}: ${rel[3] ?? "spec"}`,
+                };
+            }
+            return {
+                ...base,
+                targetType: "artifact",
+                targetId: change,
+                detail: `${artifact.replace(/\.md$/, "")} ${verb}`,
+            };
+        }
+        if (rel[0] === "specs" && rel[1]) {
+            return {
+                ...base,
+                targetType: "spec",
+                targetId: rel[1],
+                detail: `Spec ${verb}`,
+            };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/server/watcher.js.map

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

package/dist/shared/contracts.js

@@ -0,0 +1,7 @@
+/**
+ * Wire contracts shared by the server (which produces them via the
+ * OpenSpecSource port) and the web app (which renders them). These are the
+ * ONLY shape the UI knows about — it never sees raw OpenSpec CLI output.
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/shared/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/shared/contracts.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}