opsx-ui 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# opsx-ui
+
+A read-only, live-updating **web viewer for everything OpenSpec touches** — a
+browser home for your specs, changes, and proposed deltas that replaces the
+`openspec view` TUI and updates _as agents work_.
+
+> opsx-ui only **reads** OpenSpec state. It never writes to, or mutates, any
+> project's `openspec/` directory. Driving agents (propose / apply / archive) is
+> intentionally out of scope for now.
+
+## Install
+
+```bash
+npm install -g opsx-ui
+```
+
+Requires the [`openspec`](https://github.com/Fission-AI/OpenSpec) CLI **>= 1.5.0**
+on your PATH.
+
+## Usage
+
+```bash
+opsx-ui                 # open the OpenSpec project in the current directory
+opsx-ui ./some/project  # open a specific project
+opsx-ui -g              # global mode: skip cwd, show the project picker
+```
+
+Options:
+
+| Flag             | Meaning                                                  |
+| ---------------- | -------------------------------------------------------- |
+| `-g, --global`   | Skip the current directory and open the project picker.  |
+| `-p, --port <n>` | Preferred port (auto-increments if taken). Default 4573. |
+| `--poll`         | Use filesystem polling (WSL / network mounts).           |
+| `--no-open`      | Don't open a browser automatically.                      |
+
+If the current directory has no `openspec/`, opsx-ui offers to point you at
+another project or a registered store. Running it in a project with `openspec/`
+opens straight to the **change board**.
+
+## What you get
+
+- **Change board** — every active change as a card with task progress and
+  validation health, updating live.
+- **Activity feed** — a reverse-chronological rail of what just changed on disk,
+  so you can watch an agent's edits land in real time.
+- **Spec browser** — drill into capabilities, requirements, and scenarios.
+- **Spec diff** — a change's proposed deltas beside the current spec, grouped and
+  colored by operation (ADDED / MODIFIED / REMOVED).
+
+## Architecture
+
+A global CLI boots a local Node server (Express + WebSocket) that reads OpenSpec
+state and streams it to a React/Vite UI.
+
+```
+  Browser (React/Vite)  ◀── WebSocket (live snapshot + activity) ──▶  Node server
+                                                                          │
+                                              chokidar watch(openspec/)   │
+                                                                          ▼
+                                                      OpenSpecSource (port)
+                                                      └ CliOpenSpecSource → `openspec … --json`
+```
+
+All OpenSpec reads go through a single `OpenSpecSource` interface that returns
+typed view-models — the UI never sees raw CLI output. The CLI adapter is the one
+swappable seam, so a future OpenSpec library or HTTP API drops in without
+touching the server or UI.
+
+## Develop
+
+```bash
+npm install
+npm run dev:server   # local API + watcher (port 4573)
+npm run dev:web      # Vite dev server (port 5273, proxies /api and /ws)
+npm test             # unit tests (mappers, source port, read-only guarantee)
+npm run build        # bundle web + compile server into dist/
+```
+
+## Scope
+
+v1 renders the diff as operation-grouped delta cards beside the current spec
+(no token-level inline highlighting) because OpenSpec's delta JSON does not
+expose the `### Requirement:` header used as identity. Paired, highlighted
+before→after diffing is a planned follow-up and slots in behind the same
+`OpenSpecSource` seam.

package/dist/cli/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import open from "open";
+import path from "node:path";
+import { ViewerServer } from "../server/viewer-server.js";
+import { ProjectResolver } from "../server/project-resolver.js";
+const DEFAULT_PORT = 4573;
+async function main() {
+    const program = new Command();
+    program
+        .name("opsx-ui")
+        .description("A read-only, live web viewer for everything OpenSpec touches.")
+        .argument("[dir]", "project directory to open (defaults to current)")
+        .option("-g, --global", "skip current directory; open the project picker")
+        .option("-p, --port <port>", "preferred port", String(DEFAULT_PORT))
+        .option("--poll", "use filesystem polling (WSL/network mounts)")
+        .option("--no-open", "do not open a browser automatically")
+        .action(async (dir, options) => {
+        const cwd = process.cwd();
+        const initialProject = resolveInitialProject(cwd, dir, options.global);
+        const server = new ViewerServer({
+            cwd,
+            initialProject,
+            usePolling: options.poll,
+        });
+        const port = await server.start(Number(options.port) || DEFAULT_PORT);
+        const url = `http://localhost:${port}`;
+        printBanner(url, initialProject, cwd, Boolean(options.global));
+        if (options.open)
+            await open(url).catch(() => undefined);
+        const shutdown = async () => {
+            await server.stop();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    });
+    await program.parseAsync(process.argv);
+}
+/** Decide what (if anything) to open at launch (viewer-cli spec). */
+function resolveInitialProject(cwd, dir, global) {
+    if (global)
+        return null; // `-g`: never auto-open; show the picker.
+    if (dir) {
+        const target = path.resolve(cwd, dir);
+        return ProjectResolver.hasOpenSpec(target)
+            ? ProjectResolver.forDirectory(target, "picked")
+            : null;
+    }
+    return ProjectResolver.fromCwd(cwd); // null → UI offers init / pick.
+}
+function printBanner(url, project, cwd, global) {
+    console.log(`\n  opsx-ui  →  ${url}`);
+    if (project) {
+        console.log(`  project  →  ${project.name} (${project.root})`);
+    }
+    else if (global) {
+        console.log(`  global mode: choose a project in the browser`);
+    }
+    else {
+        console.log(`  no openspec/ in ${cwd} — initialize or pick one in the browser`);
+    }
+    console.log("");
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/archive-source.js

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

package/dist/core/archive-source.js.map

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

package/dist/core/cli-openspec-source.js

@@ -0,0 +1,75 @@
+import { mapChangeList, mapDeltas, mapSpec, mapSpecList, mapStatus, mapValidation, } from "./mappers.js";
+import { OpenSpecCliError, UnsupportedCliError } from "./errors.js";
+const MIN_CLI_VERSION = "1.5.0";
+/**
+ * Read-only OpenSpecSource backed by the `openspec` CLI (design D2/D3).
+ * Composes an injected CliRunner with the pure mappers; contains no rendering
+ * or filesystem-mutating logic.
+ */
+export class CliOpenSpecSource {
+    runner;
+    options;
+    constructor(runner, options = {}) {
+        this.runner = runner;
+        this.options = options;
+    }
+    /** Append `--store <id>` to store-scoped commands when a store is active. */
+    scoped(args) {
+        return this.options.storeId
+            ? [...args, "--store", this.options.storeId]
+            : args;
+    }
+    async json(args, map) {
+        const stdout = await this.runner.run(args);
+        try {
+            return map(JSON.parse(stdout));
+        }
+        catch (error) {
+            throw new OpenSpecCliError(`Could not parse JSON from openspec ${args.join(" ")}: ${error.message}`, args);
+        }
+    }
+    async version() {
+        const out = (await this.runner.run(["--version"])).trim();
+        const found = out.split(/\s+/).pop() ?? out;
+        if (compareSemver(found, MIN_CLI_VERSION) < 0) {
+            throw new UnsupportedCliError(found, MIN_CLI_VERSION);
+        }
+        return found;
+    }
+    listChanges() {
+        return this.json(this.scoped(["list", "--json"]), mapChangeList);
+    }
+    listSpecs() {
+        return this.json(this.scoped(["list", "--specs", "--json"]), mapSpecList);
+    }
+    getSpec(specId) {
+        return this.json(this.scoped(["show", specId, "--json", "--type", "spec"]), mapSpec);
+    }
+    getDeltas(changeId) {
+        return this.json(this.scoped(["show", changeId, "--json", "--deltas-only"]), mapDeltas);
+    }
+    getStatus(changeId) {
+        return this.json(this.scoped(["status", "--change", changeId, "--json"]), mapStatus);
+    }
+    validateChanges() {
+        return this.json(this.scoped(["validate", "--changes", "--json"]), mapValidation);
+    }
+}
+/** Minimal semver compare (major.minor.patch). Returns -1 / 0 / 1. */
+export function compareSemver(a, b) {
+    const pa = a
+        .replace(/^v/, "")
+        .split(".")
+        .map((n) => parseInt(n, 10) || 0);
+    const pb = b
+        .replace(/^v/, "")
+        .split(".")
+        .map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i += 1) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return Math.sign(diff);
+    }
+    return 0;
+}
+//# sourceMappingURL=cli-openspec-source.js.map

package/dist/core/cli-openspec-source.js.map

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

package/dist/core/cli-runner.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { OpenSpecCliError, OpenSpecNotFoundError } from "./errors.js";
+/** Production runner: spawns the real `openspec` binary. */
+export class ExecCliRunner {
+    cwd;
+    bin;
+    maxBuffer;
+    constructor(options) {
+        this.cwd = options.cwd;
+        this.bin = options.bin ?? "openspec";
+        this.maxBuffer = options.maxBuffer ?? 32 * 1024 * 1024;
+    }
+    run(args) {
+        return new Promise((resolve, reject) => {
+            execFile(this.bin, [...args, "--no-color"], { cwd: this.cwd, maxBuffer: this.maxBuffer }, (error, stdout, stderr) => {
+                if (error) {
+                    if (error.code === "ENOENT") {
+                        reject(new OpenSpecNotFoundError());
+                        return;
+                    }
+                    reject(new OpenSpecCliError(`openspec ${args.join(" ")} failed: ${error.message}`, args, stderr));
+                    return;
+                }
+                resolve(stdout);
+            });
+        });
+    }
+}
+//# sourceMappingURL=cli-runner.js.map

package/dist/core/cli-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../../src/core/cli-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAoBtE,4DAA4D;AAC5D,MAAM,OAAO,aAAa;IACP,GAAG,CAAS;IACZ,GAAG,CAAS;IACZ,SAAS,CAAS;IAEnC,YAAY,OAA6B;QACvC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IACzD,CAAC;IAED,GAAG,CAAC,IAAc;QAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,QAAQ,CACN,IAAI,CAAC,GAAG,EACR,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,EACvB,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAC5C,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACxB,IAAI,KAAK,EAAE,CAAC;oBACV,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACvD,MAAM,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;wBACpC,OAAO;oBACT,CAAC;oBACD,MAAM,CACJ,IAAI,gBAAgB,CAClB,YAAY,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,EACrD,IAAI,EACJ,MAAM,CACP,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/errors.js

@@ -0,0 +1,30 @@
+/** Raised when the `openspec` executable cannot be found on the machine. */
+export class OpenSpecNotFoundError extends Error {
+    constructor(message = "The `openspec` CLI was not found on PATH.") {
+        super(message);
+        this.name = "OpenSpecNotFoundError";
+    }
+}
+/** Raised when the installed `openspec` CLI is too old to be supported. */
+export class UnsupportedCliError extends Error {
+    found;
+    required;
+    constructor(found, required) {
+        super(`Unsupported openspec CLI ${found}; opsx-ui requires >= ${required}.`);
+        this.found = found;
+        this.required = required;
+        this.name = "UnsupportedCliError";
+    }
+}
+/** Raised when an `openspec` invocation exits non-zero or emits bad JSON. */
+export class OpenSpecCliError extends Error {
+    args;
+    stderr;
+    constructor(message, args, stderr) {
+        super(message);
+        this.args = args;
+        this.stderr = stderr;
+        this.name = "OpenSpecCliError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,GAAG,2CAA2C;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,2EAA2E;AAC3E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAE1B;IACA;IAFlB,YACkB,KAAa,EACb,QAAgB;QAEhC,KAAK,CACH,4BAA4B,KAAK,yBAAyB,QAAQ,GAAG,CACtE,CAAC;QALc,UAAK,GAAL,KAAK,CAAQ;QACb,aAAQ,GAAR,QAAQ,CAAQ;QAKhC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,IAAc,EACd,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAU;QACd,WAAM,GAAN,MAAM,CAAS;QAG/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/core/filesystem-source.js

@@ -0,0 +1,107 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { OpenSpecCliError } from "./errors.js";
+const ARTIFACT_FILES = ["proposal", "design", "tasks"];
+const DATE_PREFIX = /^(\d{4}-\d{2}-\d{2})-(.+)$/;
+/**
+ * Reads OpenSpec state directly from disk for the things the CLI can't provide:
+ * raw markdown and the archive tree (design D1/D6). Strictly read-only, and it
+ * refuses paths that escape the project's `openspec/` directory.
+ */
+export class FilesystemSource {
+    openspecDir;
+    archiveDir;
+    constructor(projectRoot) {
+        this.openspecDir = path.join(projectRoot, "openspec");
+        this.archiveDir = path.join(this.openspecDir, "changes", "archive");
+    }
+    async listArchived() {
+        const dirs = await this.safeReaddir(this.archiveDir);
+        const summaries = [];
+        for (const entry of dirs) {
+            const full = path.join(this.archiveDir, entry);
+            const info = await stat(full).catch(() => null);
+            if (!info?.isDirectory())
+                continue;
+            const tasks = await this.readTaskProgress(path.join(full, "tasks.md"));
+            const match = DATE_PREFIX.exec(entry);
+            summaries.push({
+                id: entry,
+                name: match ? match[2] : entry,
+                archivedDate: match ? match[1] : null,
+                tasks,
+                mtime: info.mtimeMs,
+            });
+        }
+        return summaries
+            .sort((a, b) => (a.id < b.id ? 1 : a.id > b.id ? -1 : b.mtime - a.mtime))
+            .map(({ mtime: _mtime, ...summary }) => summary);
+    }
+    async getArchivedChange(id) {
+        const dir = this.resolveArchiveEntry(id);
+        const [summary] = (await this.listArchived()).filter((s) => s.id === id);
+        if (!summary) {
+            throw new OpenSpecCliError(`Archived change not found: ${id}`, [
+                "archive",
+                id,
+            ]);
+        }
+        const artifacts = [];
+        for (const artifact of ARTIFACT_FILES) {
+            const content = await this.readIfExists(path.join(dir, `${artifact}.md`));
+            if (content !== null)
+                artifacts.push({ id: artifact, content });
+        }
+        const deltas = await this.readArchivedDeltas(path.join(dir, "specs"));
+        return { ...summary, artifacts, deltas };
+    }
+    async getRawDocument(relativePath) {
+        const resolved = this.resolveWithin(this.openspecDir, relativePath);
+        const content = await readFile(resolved, "utf8");
+        return { path: relativePath, content };
+    }
+    // --- helpers ---
+    async readArchivedDeltas(specsDir) {
+        const capabilities = await this.safeReaddir(specsDir);
+        const deltas = [];
+        for (const cap of capabilities) {
+            const content = await this.readIfExists(path.join(specsDir, cap, "spec.md"));
+            if (content !== null)
+                deltas.push({ spec: cap, content });
+        }
+        return deltas;
+    }
+    async readTaskProgress(tasksPath) {
+        const content = await this.readIfExists(tasksPath);
+        if (content === null)
+            return { completed: 0, total: 0 };
+        const done = (content.match(/^\s*- \[x\]/gim) ?? []).length;
+        const todo = (content.match(/^\s*- \[ \]/gim) ?? []).length;
+        return { completed: done, total: done + todo };
+    }
+    async safeReaddir(dir) {
+        return readdir(dir).catch(() => []);
+    }
+    async readIfExists(file) {
+        return readFile(file, "utf8").catch(() => null);
+    }
+    /** Resolve an archive entry id, guarding against traversal. */
+    resolveArchiveEntry(id) {
+        if (id.includes("/") || id.includes("\\") || id.includes("..")) {
+            throw new OpenSpecCliError(`Invalid archive id: ${id}`, ["archive", id]);
+        }
+        return path.join(this.archiveDir, id);
+    }
+    /** Resolve `relativePath` and ensure it stays under `base`. */
+    resolveWithin(base, relativePath) {
+        const resolved = path.resolve(base, relativePath);
+        const rel = path.relative(base, resolved);
+        if (rel.startsWith("..") || path.isAbsolute(rel)) {
+            throw new OpenSpecCliError(`Path escapes openspec/: ${relativePath}`, [
+                relativePath,
+            ]);
+        }
+        return resolved;
+    }
+}
+//# sourceMappingURL=filesystem-source.js.map

package/dist/core/filesystem-source.js.map

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

package/dist/core/index.js

@@ -0,0 +1,9 @@
+export * from "./errors.js";
+export * from "./cli-runner.js";
+export * from "./openspec-source.js";
+export * from "./cli-openspec-source.js";
+export * from "./archive-source.js";
+export * from "./filesystem-source.js";
+export * from "./snapshot-service.js";
+export * as mappers from "./mappers.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC"}

package/dist/core/mappers.js

@@ -0,0 +1,129 @@
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function asString(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function asNumber(value, fallback = 0) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function mapScenario(raw) {
+    const obj = (raw ?? {});
+    return { rawText: asString(obj.rawText) };
+}
+function mapRequirement(raw) {
+    const obj = (raw ?? {});
+    return {
+        name: typeof obj.name === "string" ? obj.name : null,
+        text: asString(obj.text),
+        scenarios: asArray(obj.scenarios).map(mapScenario),
+    };
+}
+export function mapChangeList(raw) {
+    const obj = (raw ?? {});
+    return asArray(obj.changes).map((entry) => {
+        const c = (entry ?? {});
+        const completed = asNumber(c.completedTasks);
+        const total = asNumber(c.totalTasks);
+        return {
+            name: asString(c.name),
+            status: asString(c.status, "in-progress"),
+            tasks: { completed, total },
+            validation: "unknown",
+            lastModified: typeof c.lastModified === "string" ? c.lastModified : null,
+        };
+    });
+}
+export function mapSpecList(raw) {
+    const obj = (raw ?? {});
+    return asArray(obj.specs).map((entry) => {
+        const s = (entry ?? {});
+        const id = asString(s.id);
+        return {
+            id,
+            title: asString(s.title, id),
+            requirementCount: asNumber(s.requirementCount),
+        };
+    });
+}
+export function mapSpec(raw) {
+    const obj = (raw ?? {});
+    const id = asString(obj.id);
+    return {
+        id,
+        title: asString(obj.title, id),
+        overview: typeof obj.overview === "string" ? obj.overview : null,
+        requirements: asArray(obj.requirements).map(mapRequirement),
+    };
+}
+const KNOWN_OPERATIONS = [
+    "ADDED",
+    "MODIFIED",
+    "REMOVED",
+    "RENAMED",
+];
+function mapOperation(value) {
+    const upper = asString(value).toUpperCase();
+    return (KNOWN_OPERATIONS.find((op) => op === upper) ??
+        "MODIFIED");
+}
+export function mapDeltas(raw) {
+    const obj = (raw ?? {});
+    const deltas = asArray(obj.deltas).map((entry) => {
+        const d = (entry ?? {});
+        return {
+            spec: asString(d.spec),
+            operation: mapOperation(d.operation),
+            description: asString(d.description),
+            requirement: d.requirement && typeof d.requirement === "object"
+                ? mapRequirement(d.requirement)
+                : null,
+        };
+    });
+    return {
+        changeId: asString(obj.id),
+        title: asString(obj.title, asString(obj.id)),
+        deltaCount: asNumber(obj.deltaCount, deltas.length),
+        deltas,
+    };
+}
+export function mapStatus(raw) {
+    const obj = (raw ?? {});
+    return {
+        changeName: asString(obj.changeName),
+        schema: asString(obj.schemaName),
+        isComplete: obj.isComplete === true,
+        applyRequires: asArray(obj.applyRequires).map((x) => asString(x)),
+        artifacts: asArray(obj.artifacts).map((entry) => {
+            const a = (entry ?? {});
+            return { id: asString(a.id), status: asString(a.status) };
+        }),
+    };
+}
+function mapIssue(raw) {
+    if (typeof raw === "string")
+        return { level: "error", message: raw };
+    const obj = (raw ?? {});
+    return {
+        level: asString(obj.level ?? obj.severity, "error"),
+        message: asString(obj.message ?? obj.text, "Validation issue"),
+    };
+}
+export function mapValidation(raw) {
+    const obj = (raw ?? {});
+    return asArray(obj.items).map((entry) => {
+        const i = (entry ?? {});
+        return {
+            id: asString(i.id),
+            valid: i.valid === true,
+            issues: asArray(i.issues).map(mapIssue),
+        };
+    });
+}
+/** Fold a validation result into the board status a card renders. */
+export function toValidationStatus(view) {
+    if (!view)
+        return "unknown";
+    return view.valid ? "valid" : "invalid";
+}
+//# sourceMappingURL=mappers.js.map

package/dist/core/mappers.js.map

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

package/dist/core/openspec-source.js

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

package/dist/core/openspec-source.js.map

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

package/dist/core/snapshot-service.js

@@ -0,0 +1,36 @@
+import { toValidationStatus } from "./mappers.js";
+/**
+ * Composes the board-level snapshot from independent source calls (design
+ * D3/D1). Merges per-change validation health into each card and includes the
+ * archived-change list from the filesystem source. Pure orchestration — no CLI
+ * or filesystem knowledge of its own, so it is unit-testable against mocks.
+ */
+export class SnapshotService {
+    source;
+    archive;
+    constructor(source, archive) {
+        this.source = source;
+        this.archive = archive;
+    }
+    async build(project) {
+        const [changes, specs, validations, archived] = await Promise.all([
+            this.source.listChanges(),
+            this.source.listSpecs(),
+            this.source.validateChanges().catch(() => []),
+            this.archive.listArchived().catch(() => []),
+        ]);
+        const validationById = new Map(validations.map((v) => [v.id, v]));
+        const withHealth = changes.map((change) => ({
+            ...change,
+            validation: toValidationStatus(validationById.get(change.name)),
+        }));
+        return {
+            project,
+            changes: withHealth,
+            specs,
+            archived,
+            generatedAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=snapshot-service.js.map

package/dist/core/snapshot-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-service.js","sourceRoot":"","sources":["../../src/core/snapshot-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,MAAsB,EACtB,OAAsB;QADtB,WAAM,GAAN,MAAM,CAAgB;QACtB,YAAO,GAAP,OAAO,CAAe;IACtC,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YACzB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;YACvB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC1C,GAAG,MAAM;YACT,UAAU,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SAChE,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO;YACP,OAAO,EAAE,UAAU;YACnB,KAAK;YACL,QAAQ;YACR,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;IACJ,CAAC;CACF"}