@lepid-labs/weft 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wil Asche
+
+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/bin/weft.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/api-middleware.js

@@ -0,0 +1,52 @@
+/**
+ * The data API for the Weft UI, served by the CLI's Vite server and closing
+ * over the single WeftService instance. The UI never constructs a service —
+ * it consumes these JSON endpoints (and the manifest file during SSR).
+ */
+export function weftApiPlugin(service) {
+    return {
+        name: "weft-api",
+        configureServer(server) {
+            server.middlewares.use("/api", (req, res, next) => {
+                handleApiRequest(service, req, res).catch((err) => next(err));
+            });
+        },
+    };
+}
+/** Handle one /api request. The url is relative to the /api mount point. */
+export async function handleApiRequest(service, req, res) {
+    const url = new URL(req.url ?? "/", "http://weft.local");
+    const path = url.pathname;
+    if (path === "/manifest") {
+        return json(res, 200, await service.getManifest());
+    }
+    if (path.startsWith("/doc/")) {
+        const nodeId = decodeURIComponent(path.slice("/doc/".length));
+        try {
+            return json(res, 200, { content: service.read(nodeId) });
+        }
+        catch {
+            return json(res, 404, { error: `Document not found: ${nodeId}` });
+        }
+    }
+    if (path === "/search") {
+        const query = url.searchParams.get("q");
+        if (!query)
+            return json(res, 400, { error: 'Missing query parameter "q"' });
+        return json(res, 200, await service.search(query));
+    }
+    if (path === "/traverse") {
+        const nodeId = url.searchParams.get("node");
+        if (!nodeId)
+            return json(res, 400, { error: 'Missing query parameter "node"' });
+        const direction = (url.searchParams.get("direction") ?? "both");
+        return json(res, 200, await service.traverse(nodeId, direction));
+    }
+    return json(res, 404, { error: `Unknown API route: ${path}` });
+}
+function json(res, status, body) {
+    res.statusCode = status;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(body));
+}
+//# sourceMappingURL=api-middleware.js.map

package/dist/api-middleware.js.map

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

package/dist/api-middleware.test.js

@@ -0,0 +1,86 @@
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { WeftService } from "@lepid-labs/weft-core";
+import { beforeAll, describe, expect, it } from "vitest";
+import { handleApiRequest } from "./api-middleware.js";
+const __dirname = resolve(fileURLToPath(import.meta.url), "..");
+const FIXTURES_DIR = resolve(__dirname, "__fixtures__");
+let service;
+beforeAll(async () => {
+    service = new WeftService({
+        rootDir: FIXTURES_DIR,
+        docsDir: "docs",
+        entryPoint: "docs/README.md",
+        ignore: [],
+    });
+    await service.rebuild();
+});
+/** Run one request through the handler and capture the JSON response. */
+// biome-ignore lint/suspicious/noExplicitAny: test helper — each assertion narrows the shape it uses
+async function request(url) {
+    let status = 0;
+    let payload = "";
+    const res = {
+        set statusCode(code) {
+            status = code;
+        },
+        setHeader() { },
+        end(chunk) {
+            payload = chunk;
+        },
+    };
+    await handleApiRequest(service, { url }, res);
+    return { status, body: JSON.parse(payload) };
+}
+describe("handleApiRequest", () => {
+    it("serves the manifest", async () => {
+        const { status, body } = await request("/manifest");
+        expect(status).toBe(200);
+        expect(body.nodes.map((n) => n.id).sort()).toEqual([
+            "README.md",
+            "architecture.md",
+        ]);
+        expect(body.edges.length).toBeGreaterThan(0);
+    });
+    it("serves document content", async () => {
+        const { status, body } = await request("/doc/architecture.md");
+        expect(status).toBe(200);
+        expect(body.content).toContain("# Architecture");
+    });
+    it("404s for a missing document", async () => {
+        const { status, body } = await request("/doc/nope.md");
+        expect(status).toBe(404);
+        expect(body.error).toContain("nope.md");
+    });
+    it("404s for a document path escaping the docs root", async () => {
+        const { status } = await request("/doc/..%2F..%2Fpackage.json");
+        expect(status).toBe(404);
+    });
+    it("serves search results", async () => {
+        const { status, body } = await request("/search?q=weaving");
+        expect(status).toBe(200);
+        expect(body.some((r) => r.id === "architecture.md")).toBe(true);
+    });
+    it("400s on a missing search query", async () => {
+        const { status, body } = await request("/search");
+        expect(status).toBe(400);
+        expect(body.error).toContain('"q"');
+    });
+    it("serves traverse edges in both directions", async () => {
+        const outgoing = await request("/traverse?node=README.md&direction=outgoing");
+        expect(outgoing.status).toBe(200);
+        expect(outgoing.body.some((e) => e.to.node === "architecture.md")).toBe(true);
+        const incoming = await request("/traverse?node=architecture.md&direction=incoming");
+        expect(incoming.body.some((e) => e.from.node === "README.md")).toBe(true);
+    });
+    it("400s on a missing traverse node", async () => {
+        const { status } = await request("/traverse");
+        expect(status).toBe(400);
+    });
+    it("404s on unknown routes", async () => {
+        const { status, body } = await request("/openapi/api.yaml");
+        expect(status).toBe(404);
+        expect(body.error).toContain("Unknown API route");
+    });
+});
+//# sourceMappingURL=api-middleware.test.js.map

package/dist/api-middleware.test.js.map

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

package/dist/commands/analyze.js

@@ -0,0 +1,31 @@
+import { defaultRegistry } from "@lepid-labs/weft-core";
+import { command } from "cleye";
+import { formatReport, formatRules, runValidation } from "../validation.js";
+export const analyzeCommand = command({
+    name: "analyze",
+    help: {
+        description: "Run every validation rule over the graph and report the results",
+    },
+    parameters: ["[root-dir]"],
+    flags: {
+        json: {
+            type: Boolean,
+            description: "Emit the result as JSON",
+            default: false,
+        },
+        listRules: {
+            type: Boolean,
+            description: "List the registered rules and their default severities, then exit",
+            default: false,
+        },
+    },
+}, async (argv) => {
+    if (argv.flags.listRules) {
+        console.log(formatRules(defaultRegistry()));
+        return;
+    }
+    const result = await runValidation(argv._.rootDir ?? process.cwd());
+    console.log(formatReport(result, { json: argv.flags.json }));
+    // Reporting only — `weft check` is the command that fails a build.
+});
+//# sourceMappingURL=analyze.js.map

package/dist/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE5E,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CACpC;IACC,IAAI,EAAE,SAAS;IACf,IAAI,EAAE;QACL,WAAW,EAAE,iEAAiE;KAC9E;IACD,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,KAAK,EAAE;QACN,IAAI,EAAE;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,yBAAyB;YACtC,OAAO,EAAE,KAAK;SACd;QACD,SAAS,EAAE;YACV,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,mEAAmE;YAChF,OAAO,EAAE,KAAK;SACd;KACD;CACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACd,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QAC5C,OAAO;IACR,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,mEAAmE;AACpE,CAAC,CACD,CAAC"}

package/dist/commands/check.js

@@ -0,0 +1,21 @@
+import { command } from "cleye";
+import { exitCodeFor, formatReport, runValidation } from "../validation.js";
+export const checkCommand = command({
+    name: "check",
+    help: {
+        description: "Validate the graph and exit non-zero if any rule reports an error",
+    },
+    parameters: ["[root-dir]"],
+    flags: {
+        json: {
+            type: Boolean,
+            description: "Emit the result as JSON",
+            default: false,
+        },
+    },
+}, async (argv) => {
+    const result = await runValidation(argv._.rootDir ?? process.cwd());
+    console.log(formatReport(result, { json: argv.flags.json }));
+    process.exitCode = exitCodeFor(result);
+});
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE5E,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAClC;IACC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE;QACL,WAAW,EAAE,mEAAmE;KAChF;IACD,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,KAAK,EAAE;QACN,IAAI,EAAE;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,yBAAyB;YACtC,OAAO,EAAE,KAAK;SACd;KACD;CACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC,CACD,CAAC"}

package/dist/commands/index-cmd.js

@@ -0,0 +1,29 @@
+import { WeftService, loadConfig } from "@lepid-labs/weft-core";
+import { command } from "cleye";
+export const indexCommand = command({
+    name: "index",
+    help: {
+        description: "Rebuild the graph manifest from embedded links",
+    },
+    parameters: ["[root-dir]"],
+    flags: {
+        quiet: {
+            type: Boolean,
+            description: "Suppress output",
+            default: false,
+        },
+    },
+}, async (argv) => {
+    const rootDir = argv._.rootDir ?? process.cwd();
+    const config = await loadConfig(rootDir);
+    const service = new WeftService(config);
+    const manifest = await service.rebuild();
+    const outPaths = await service.writeManifest();
+    if (!argv.flags.quiet) {
+        console.log(`Indexed ${manifest.nodes.length} documents, ${manifest.edges.length} edges`);
+        for (const outPath of outPaths) {
+            console.log(`Manifest written to ${outPath}`);
+        }
+    }
+});
+//# sourceMappingURL=index-cmd.js.map

package/dist/commands/index-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAClC;IACC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE;QACL,WAAW,EAAE,gDAAgD;KAC7D;IACD,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,KAAK,EAAE;QACN,KAAK,EAAE;YACN,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,iBAAiB;YAC9B,OAAO,EAAE,KAAK;SACd;KACD;CACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACd,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;IAE/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,KAAK,CAAC,MAAM,eAAe,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC1F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;IACF,CAAC;AACF,CAAC,CACD,CAAC"}

package/dist/commands/serve.js

@@ -0,0 +1,121 @@
+import { WeftService, fetchRepo, loadConfig, resolveFetchedRepos } from "@lepid-labs/weft-core";
+import { command } from "cleye";
+import { openBrowser } from "../open-browser.js";
+import { chooseUiMode, startBuiltServer, startDevServer } from "../ui-server.js";
+export const serveCommand = command({
+    name: "serve",
+    help: {
+        description: "Start the Weft UI server",
+    },
+    parameters: ["[root-dir]"],
+    flags: {
+        port: {
+            type: Number,
+            description: "Port to serve on",
+            default: 7777,
+        },
+        open: {
+            type: Boolean,
+            description: "Open the browser once the server is up",
+            default: false,
+        },
+        dev: {
+            type: Boolean,
+            description: "Serve the UI from source through Vite with hot reload (needs a checkout of the weft repo)",
+            default: false,
+        },
+        repo: {
+            type: String,
+            description: "Serve a GitHub repo (org/repo) without a checkout, fetching into a cache",
+        },
+        gh: {
+            type: String,
+            description: "Alias of --repo",
+        },
+        ref: {
+            type: String,
+            description: "Branch, tag or commit sha to fetch (with --repo; default: remote HEAD)",
+        },
+        refresh: {
+            type: Boolean,
+            description: "Re-resolve fetched refs even when the cached resolution is fresh",
+            default: false,
+        },
+    },
+}, async (argv) => {
+    const port = argv.flags.port;
+    const { createRequire } = await import("node:module");
+    const { dirname, resolve } = await import("node:path");
+    // Resolve @lepid-labs/weft-ui through node resolution rather than a path relative to
+    // this file: the relative depth differs between src/ and dist/, and
+    // `new URL(import.meta.url).pathname` keeps a leading slash before the
+    // drive letter on Windows (`/C:/...`), which resolve() then mangles.
+    const require = createRequire(import.meta.url);
+    const uiRoot = dirname(require.resolve("@lepid-labs/weft-ui/package.json"));
+    if (argv.flags.repo && argv.flags.gh && argv.flags.repo !== argv.flags.gh) {
+        console.error("serve: --repo and --gh name different repos; pass one of them");
+        process.exit(1);
+    }
+    const repo = argv.flags.repo ?? argv.flags.gh;
+    if (repo && argv._.rootDir) {
+        console.error("serve: pass either a root directory or --repo, not both");
+        process.exit(1);
+    }
+    try {
+        // Decide how the UI is served before fetching anything, so a missing
+        // build fails fast rather than after a clone.
+        const mode = chooseUiMode(uiRoot, argv.flags.dev);
+        // With --repo the root is a fetched, cache-resident checkout; otherwise
+        // resolve the root dir before the dev-mode chdir, since it defaults to the cwd.
+        let rootDir;
+        if (repo) {
+            console.log(`Fetching ${repo}${argv.flags.ref ? `@${argv.flags.ref}` : ""}…`);
+            rootDir = await fetchRepo(repo, {
+                ref: argv.flags.ref,
+                refresh: argv.flags.refresh,
+            });
+        }
+        else {
+            rootDir = resolve(argv._.rootDir ?? process.cwd());
+        }
+        // The CLI owns the single WeftService. The UI never constructs one — it
+        // consumes /api JSON (client) and the manifest file (SSR).
+        let config = await loadConfig(rootDir);
+        if (repo) {
+            // Repos the fetched config references resolve the same way: a real
+            // local checkout wins, everything else is fetched at its HEAD.
+            config = await resolveFetchedRepos(config, { refresh: argv.flags.refresh });
+        }
+        const service = new WeftService(config);
+        await service.rebuild();
+        await service.writeManifest();
+        // SvelteKit's server loads read the manifest file from this path — SSR
+        // cannot reach the /api handler through SvelteKit's internal fetch.
+        process.env.WEFT_MANIFEST_PATH = service.manifestPath;
+        const server = mode === "built"
+            ? await startBuiltServer(service, uiRoot, port)
+            : await startDevServer(service, uiRoot, port);
+        const url = `http://localhost:${port}`;
+        console.log(`Weft server running at ${url}${mode === "dev" ? " (vite dev)" : ""}`);
+        if (argv.flags.open)
+            openBrowser(url);
+        // Watch for doc changes
+        const unwatch = service.watch(async (manifest) => {
+            console.log(`Rebuilt: ${manifest.nodes.length} docs, ${manifest.edges.length} edges`);
+            await service.writeManifest();
+        });
+        // Graceful shutdown
+        const shutdown = () => {
+            unwatch();
+            server.close();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+    catch (err) {
+        console.error("Failed to start server:", err);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAClC;IACC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE;QACL,WAAW,EAAE,0BAA0B;KACvC;IACD,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,KAAK,EAAE;QACN,IAAI,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,kBAAkB;YAC/B,OAAO,EAAE,IAAI;SACb;QACD,IAAI,EAAE;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,wCAAwC;YACrD,OAAO,EAAE,KAAK;SACd;QACD,GAAG,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,WAAW,EACV,2FAA2F;YAC5F,OAAO,EAAE,KAAK;SACd;QACD,IAAI,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,0EAA0E;SACvF;QACD,EAAE,EAAE;YACH,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,iBAAiB;SAC9B;QACD,GAAG,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,wEAAwE;SACrF;QACD,OAAO,EAAE;YACR,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,kEAAkE;YAC/E,OAAO,EAAE,KAAK;SACd;KACD;CACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAE7B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvD,qFAAqF;IACrF,oEAAoE;IACpE,uEAAuE;IACvE,qEAAqE;IACrE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAE5E,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAC3E,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9C,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACJ,qEAAqE;QACrE,8CAA8C;QAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAElD,wEAAwE;QACxE,gFAAgF;QAChF,IAAI,OAAe,CAAC;QACpB,IAAI,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC9E,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE;gBAC/B,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;gBACnB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;aAC3B,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,wEAAwE;QACxE,2DAA2D;QAC3D,IAAI,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACV,mEAAmE;YACnE,+DAA+D;YAC/D,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QAExC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE9B,uEAAuE;QACvE,oEAAoE;QACpE,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;QAEtD,MAAM,MAAM,GACX,IAAI,KAAK,OAAO;YACf,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC;YAC/C,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,WAAW,CAAC,GAAG,CAAC,CAAC;QAEtC,wBAAwB;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAChD,OAAO,CAAC,GAAG,CAAC,YAAY,QAAQ,CAAC,KAAK,CAAC,MAAM,UAAU,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;YACtF,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;YACrB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC,CACD,CAAC"}

package/dist/core-resolution.test.js

@@ -0,0 +1,20 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+// The CLI runs under plain Node (no Vite), so @lepid-labs/weft-core must resolve to
+// built JavaScript, not TypeScript source. See issue #10.
+describe("@lepid-labs/weft-core resolution for plain Node", () => {
+    const require = createRequire(import.meta.url);
+    it("resolves to built output, not TypeScript source", () => {
+        const resolved = require.resolve("@lepid-labs/weft-core");
+        expect(resolved).toMatch(/dist[\\/]index\.js$/);
+        expect(existsSync(resolved)).toBe(true);
+    });
+    it("imports successfully under plain Node", () => {
+        const stdout = execFileSync(process.execPath, ["--input-type=module", "-e", "await import('@lepid-labs/weft-core'); console.log('ok');"], { cwd: fileURLToPath(new URL("..", import.meta.url)), encoding: "utf8" });
+        expect(stdout.trim()).toBe("ok");
+    });
+});
+//# sourceMappingURL=core-resolution.test.js.map

package/dist/core-resolution.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-resolution.test.js","sourceRoot":"","sources":["../src/core-resolution.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,oFAAoF;AACpF,0DAA0D;AAC1D,QAAQ,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAChE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/C,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAChD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,YAAY,CAC1B,OAAO,CAAC,QAAQ,EAChB,CAAC,qBAAqB,EAAE,IAAI,EAAE,2DAA2D,CAAC,EAC1F,EAAE,GAAG,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CACxE,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { cli } from "cleye";
+import { analyzeCommand } from "./commands/analyze.js";
+import { checkCommand } from "./commands/check.js";
+import { indexCommand } from "./commands/index-cmd.js";
+import { serveCommand } from "./commands/serve.js";
+const { version } = createRequire(import.meta.url)("../package.json");
+const argv = cli({
+    name: "weft",
+    version,
+    commands: [analyzeCommand, checkCommand, indexCommand, serveCommand],
+});
+// Show help if no command given
+if (!argv.command) {
+    argv.showHelp();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAE7F,MAAM,IAAI,GAAG,GAAG,CAAC;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO;IACP,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC;CACpE,CAAC,CAAC;AAEH,gCAAgC;AAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IACnB,IAAI,CAAC,QAAQ,EAAE,CAAC;AACjB,CAAC"}

package/dist/open-browser.js

@@ -0,0 +1,30 @@
+import { spawn } from "node:child_process";
+/**
+ * The platform's own "open this in the default browser" command. Each OS
+ * ships one, so no dependency is needed to find a browser.
+ */
+export function openCommand(url, platform = process.platform) {
+    switch (platform) {
+        case "darwin":
+            return { command: "open", args: [url] };
+        case "win32":
+            // `start` is a cmd builtin; the empty string is the window title it
+            // would otherwise take the (quoted) url for.
+            return { command: "cmd", args: ["/c", "start", "", url] };
+        default:
+            return { command: "xdg-open", args: [url] };
+    }
+}
+/**
+ * Open a url in the default browser without waiting on it. Failing to open is
+ * reported, never fatal: the server is up and the url is already printed.
+ */
+export function openBrowser(url, platform) {
+    const { command, args } = openCommand(url, platform);
+    const child = spawn(command, args, { detached: true, stdio: "ignore", windowsHide: true });
+    child.on("error", (err) => {
+        console.error(`Could not open a browser (${command}: ${err.message}) — open ${url} yourself.`);
+    });
+    child.unref();
+}
+//# sourceMappingURL=open-browser.js.map

package/dist/open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../src/open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAC1B,GAAW,EACX,WAA4B,OAAO,CAAC,QAAQ;IAE5C,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,QAAQ;YACZ,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,OAAO;YACX,oEAAoE;YACpE,6CAA6C;YAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;QAC3D;YACC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,QAA0B;IAClE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,6BAA6B,OAAO,KAAK,GAAG,CAAC,OAAO,YAAY,GAAG,YAAY,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;AACf,CAAC"}

package/dist/open-browser.test.js

@@ -0,0 +1,16 @@
+import { describe, expect, it } from "vitest";
+import { openCommand } from "./open-browser.js";
+const URL = "http://localhost:7777";
+describe("openCommand", () => {
+    it("uses `open` on macOS", () => {
+        expect(openCommand(URL, "darwin")).toEqual({ command: "open", args: [URL] });
+    });
+    it("uses cmd's `start` on Windows, with an explicit empty title", () => {
+        expect(openCommand(URL, "win32")).toEqual({ command: "cmd", args: ["/c", "start", "", URL] });
+    });
+    it("uses xdg-open everywhere else", () => {
+        expect(openCommand(URL, "linux")).toEqual({ command: "xdg-open", args: [URL] });
+        expect(openCommand(URL, "freebsd")).toEqual({ command: "xdg-open", args: [URL] });
+    });
+});
+//# sourceMappingURL=open-browser.test.js.map

package/dist/open-browser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.test.js","sourceRoot":"","sources":["../src/open-browser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,GAAG,GAAG,uBAAuB,CAAC;AAEpC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/ui-server.js

@@ -0,0 +1,91 @@
+import { existsSync } from "node:fs";
+import { createServer } from "node:http";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { handleApiRequest, weftApiPlugin } from "./api-middleware.js";
+/** The adapter-node entry point, relative to the `@lepid-labs/weft-ui` package root. */
+export const BUILT_HANDLER = join("build", "handler.js");
+/**
+ * Pick how to serve the UI. The build wins when it exists — it is what a
+ * published package ships and what `npx` runs — and the source tree is the
+ * fallback for a checkout of this repo that has not built it. `forceDev`
+ * (`--dev`) is for working on the UI itself: hot reload, at Vite's startup cost.
+ */
+export function chooseUiMode(uiRoot, forceDev) {
+    const hasBuild = existsSync(join(uiRoot, BUILT_HANDLER));
+    const hasSource = existsSync(join(uiRoot, "svelte.config.js"));
+    if (forceDev) {
+        if (!hasSource) {
+            throw new Error(`serve: --dev needs the @lepid-labs/weft-ui source tree, and ${uiRoot} has none`);
+        }
+        return "dev";
+    }
+    if (hasBuild)
+        return "built";
+    if (hasSource)
+        return "dev";
+    throw new Error(`serve: no UI found in ${uiRoot} — expected ${BUILT_HANDLER} (run \`pnpm --filter @lepid-labs/weft-ui build\`)`);
+}
+/**
+ * Route one request: `/api…` to the data API with the mount point stripped —
+ * exactly as Vite's `use("/api", …)` strips it, so both modes share one
+ * handler — and everything else to the UI.
+ */
+export function routeRequest(service, ui) {
+    return (req, res) => {
+        const url = req.url ?? "/";
+        if (url === "/api" || url.startsWith("/api/") || url.startsWith("/api?")) {
+            const rest = url.slice("/api".length);
+            req.url = rest === "" || rest.startsWith("?") ? `/${rest}` : rest;
+            handleApiRequest(service, req, res).catch((err) => {
+                console.error("API error:", err);
+                if (!res.headersSent) {
+                    res.statusCode = 500;
+                    res.setHeader("Content-Type", "application/json");
+                }
+                res.end(JSON.stringify({ error: "Internal server error" }));
+            });
+            return;
+        }
+        ui(req, res, () => {
+            res.statusCode = 404;
+            res.end("Not found");
+        });
+    };
+}
+/** Serve the adapter-node build over plain `node:http`, the API in front of it. */
+export async function startBuiltServer(service, uiRoot, port) {
+    const entry = pathToFileURL(join(uiRoot, BUILT_HANDLER)).href;
+    const { handler } = (await import(entry));
+    const server = createServer(routeRequest(service, handler));
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    return { close: () => void server.close() };
+}
+/** Serve the UI source through Vite's dev server, with the API as a plugin. */
+export async function startDevServer(service, uiRoot, port) {
+    let createViteServer;
+    try {
+        ({ createServer: createViteServer } = await import("vite"));
+    }
+    catch {
+        throw new Error("serve: --dev needs vite, which the published package does not install — run from a checkout of the weft repo");
+    }
+    // SvelteKit's Vite plugin overrides Vite's `root` option with process.cwd()
+    // and looks up svelte.config.js and src/app.html there, so passing `root`
+    // alone is not enough — the process has to run from the UI package.
+    process.chdir(uiRoot);
+    const server = await createViteServer({
+        root: uiRoot,
+        server: { port },
+        plugins: [weftApiPlugin(service)],
+    });
+    await server.listen();
+    return { close: () => void server.close() };
+}
+//# sourceMappingURL=ui-server.js.map

package/dist/ui-server.js.map

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

package/dist/ui-server.test.js

@@ -0,0 +1,105 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { createServer } from "node:http";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { WeftService } from "@lepid-labs/weft-core";
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { BUILT_HANDLER, chooseUiMode, routeRequest } from "./ui-server.js";
+const __dirname = resolve(fileURLToPath(import.meta.url), "..");
+const FIXTURES_DIR = resolve(__dirname, "__fixtures__");
+describe("chooseUiMode", () => {
+    const dirs = [];
+    function uiRoot(opts) {
+        const dir = mkdtempSync(join(tmpdir(), "weft-ui-"));
+        dirs.push(dir);
+        if (opts.build) {
+            mkdirSync(join(dir, "build"));
+            writeFileSync(join(dir, BUILT_HANDLER), "");
+        }
+        if (opts.source)
+            writeFileSync(join(dir, "svelte.config.js"), "");
+        return dir;
+    }
+    afterEach(() => {
+        for (const dir of dirs.splice(0))
+            rmSync(dir, { recursive: true, force: true });
+    });
+    it("prefers the build when both build and source exist", () => {
+        expect(chooseUiMode(uiRoot({ build: true, source: true }), false)).toBe("built");
+    });
+    it("serves the build when only the build exists (a published package)", () => {
+        expect(chooseUiMode(uiRoot({ build: true }), false)).toBe("built");
+    });
+    it("falls back to the source tree when nothing is built", () => {
+        expect(chooseUiMode(uiRoot({ source: true }), false)).toBe("dev");
+    });
+    it("--dev forces the source tree over an existing build", () => {
+        expect(chooseUiMode(uiRoot({ build: true, source: true }), true)).toBe("dev");
+    });
+    it("--dev without a source tree is an error, not a silent fallback", () => {
+        expect(() => chooseUiMode(uiRoot({ build: true }), true)).toThrow(/--dev needs/);
+    });
+    it("names the missing build when there is no UI at all", () => {
+        expect(() => chooseUiMode(uiRoot({}), false)).toThrow(/build\/handler\.js/);
+    });
+});
+describe("routeRequest", () => {
+    let server;
+    let base;
+    const uiSeen = [];
+    beforeAll(async () => {
+        const service = new WeftService({
+            rootDir: FIXTURES_DIR,
+            docsDir: "docs",
+            entryPoint: "docs/README.md",
+            ignore: [],
+        });
+        await service.rebuild();
+        // A stand-in for adapter-node's handler: records the url it was given and
+        // echoes it, so the tests can see exactly what reached the UI.
+        const ui = (req, res) => {
+            uiSeen.push(req.url ?? "");
+            res.setHeader("Content-Type", "text/plain");
+            res.end(`ui:${req.url}`);
+        };
+        server = createServer(routeRequest(service, ui));
+        await new Promise((done) => server.listen(0, done));
+        const address = server.address();
+        if (!address || typeof address === "string")
+            throw new Error("no port");
+        base = `http://127.0.0.1:${address.port}`;
+    });
+    afterAll(() => server.close());
+    afterEach(() => uiSeen.splice(0));
+    it("serves the API with the /api mount point stripped", async () => {
+        const res = await fetch(`${base}/api/doc/architecture.md`);
+        expect(res.status).toBe(200);
+        expect(res.headers.get("content-type")).toBe("application/json");
+        const body = (await res.json());
+        expect(body.content).toContain("# Architecture");
+        expect(uiSeen).toEqual([]);
+    });
+    it("passes the query string through to the API", async () => {
+        const res = await fetch(`${base}/api/search?q=architecture`);
+        expect(res.status).toBe(200);
+        expect(await res.json()).not.toEqual([]);
+    });
+    it("treats a bare /api as the API root, as Vite's mount does", async () => {
+        const res = await fetch(`${base}/api`);
+        expect(res.status).toBe(404);
+        expect((await res.json()).error).toMatch(/Unknown API route: \//);
+        expect(uiSeen).toEqual([]);
+    });
+    it("hands every other path to the UI untouched", async () => {
+        const res = await fetch(`${base}/docs/architecture?x=1`);
+        expect(res.status).toBe(200);
+        expect(await res.text()).toBe("ui:/docs/architecture?x=1");
+        expect(uiSeen).toEqual(["/docs/architecture?x=1"]);
+    });
+    it("does not mistake a path that merely starts with 'api' for the API", async () => {
+        const res = await fetch(`${base}/apiary`);
+        expect(await res.text()).toBe("ui:/apiary");
+    });
+});
+//# sourceMappingURL=ui-server.test.js.map

package/dist/ui-server.test.js.map

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

package/dist/validation.js

@@ -0,0 +1,80 @@
+import { WeftService, defaultRegistry, loadConfig, } from "@lepid-labs/weft-core";
+/** Severity order for reporting — worst first. */
+const SEVERITY_ORDER = ["error", "warn", "info"];
+/** Build the graph for a project and run every registered check over it. */
+export async function runValidation(rootDir, registry = defaultRegistry()) {
+    const config = await loadConfig(rootDir);
+    return new WeftService(config).validate(registry);
+}
+/** Render what a diagnostic concerns as a single location string. */
+export function formatTarget(target) {
+    switch (target.kind) {
+        case "node":
+            return `${target.node}${target.anchor ?? ""}`;
+        case "edge": {
+            const { from, to } = target.edge;
+            return `${from.node}${from.anchor ?? ""} -> ${to.node}${to.anchor ?? ""}`;
+        }
+        default:
+            return "(graph)";
+    }
+}
+/** Pluralize a count for the summary line. */
+function plural(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function formatDiagnostic(diagnostic, ruleWidth) {
+    const head = `  ${diagnostic.severity.padEnd(5)}  ${diagnostic.rule.padEnd(ruleWidth)}  ${formatTarget(diagnostic.target)}`;
+    const message = `          ${diagnostic.message}`;
+    const hint = diagnostic.hint ? `\n          hint: ${diagnostic.hint}` : "";
+    return `${head}\n${message}${hint}`;
+}
+/**
+ * Render a validation result for the terminal.
+ *
+ * Output is deliberately ASCII-only: the Windows console is cp1252, where a
+ * decorative glyph raises an encoding error on write and crashes the command on
+ * its own output.
+ */
+export function formatReport(result, options = {}) {
+    if (options.json)
+        return JSON.stringify(result, null, 2);
+    const lines = [];
+    // Size the rule column to what is actually being reported, so one long rule
+    // id does not knock every other row out of alignment.
+    const ruleWidth = Math.max(0, ...result.diagnostics.map((d) => d.rule.length));
+    for (const severity of SEVERITY_ORDER) {
+        for (const diagnostic of result.diagnostics.filter((d) => d.severity === severity)) {
+            lines.push(formatDiagnostic(diagnostic, ruleWidth));
+        }
+    }
+    if (lines.length)
+        lines.push("");
+    const { error, warn, info } = result.counts;
+    const total = error + warn + info;
+    lines.push(total === 0
+        ? "No problems found."
+        : `${plural(total, "problem")} (${plural(error, "error")}, ${plural(warn, "warning")}, ${plural(info, "note")})`);
+    const ran = plural(result.rulesRun.length, "rule");
+    const off = result.rulesSkipped.length ? `, ${result.rulesSkipped.length} off` : "";
+    lines.push(`Ran ${ran}${off}.`);
+    if (result.unknownRules.length) {
+        lines.push(`! config sets a severity for unknown rules: ${result.unknownRules.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+/** List every registered rule and its default severity, for discovering config ids. */
+export function formatRules(registry) {
+    const rules = registry.rules;
+    if (!rules.length)
+        return "No rules are registered.";
+    const width = Math.max(...rules.map((rule) => rule.id.length));
+    return rules
+        .map((rule) => `${rule.id.padEnd(width)}  ${rule.defaultSeverity.padEnd(5)}  ${rule.description}`)
+        .join("\n");
+}
+/** `weft check` fails the build on error severity only. Warnings and notes report but pass. */
+export function exitCodeFor(result) {
+    return result.counts.error > 0 ? 1 : 0;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/dist/validation.test.js

@@ -0,0 +1,141 @@
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ValidatorRegistry } from "@lepid-labs/weft-core";
+import { describe, expect, it } from "vitest";
+import { exitCodeFor, formatReport, formatRules, formatTarget, runValidation, } from "./validation.js";
+const __dirname = resolve(fileURLToPath(import.meta.url), "..");
+const FIXTURES_DIR = resolve(__dirname, "__fixtures__");
+function result(diagnostics = [], overrides = {}) {
+    return {
+        diagnostics,
+        counts: {
+            error: diagnostics.filter((d) => d.severity === "error").length,
+            warn: diagnostics.filter((d) => d.severity === "warn").length,
+            info: diagnostics.filter((d) => d.severity === "info").length,
+        },
+        rulesRun: ["validator-error"],
+        rulesSkipped: [],
+        unknownRules: [],
+        ...overrides,
+    };
+}
+const ERROR_DIAGNOSTIC = {
+    rule: "edge-target-missing",
+    severity: "error",
+    message: "Target document does not exist",
+    target: {
+        kind: "edge",
+        edge: { from: { node: "README.md" }, to: { node: "gone.md" }, type: "references" },
+    },
+};
+const WARN_DIAGNOSTIC = {
+    rule: "doc-orphaned",
+    severity: "warn",
+    message: "Nothing links to this document",
+    target: { kind: "node", node: "stray.md" },
+    hint: "link it from README.md",
+};
+describe("formatTarget", () => {
+    it("renders a node, with its anchor when present", () => {
+        expect(formatTarget({ kind: "node", node: "api.md" })).toBe("api.md");
+        expect(formatTarget({ kind: "node", node: "api.md", anchor: "#users" })).toBe("api.md#users");
+    });
+    it("renders an edge as source to target, keeping both anchors", () => {
+        expect(formatTarget({
+            kind: "edge",
+            edge: {
+                from: { node: "a.md", anchor: "#sync" },
+                to: { node: "b.yaml", anchor: "#listUsers" },
+                type: "implements",
+            },
+        })).toBe("a.md#sync -> b.yaml#listUsers");
+    });
+    it("renders a graph-wide target", () => {
+        expect(formatTarget({ kind: "graph" })).toBe("(graph)");
+    });
+});
+describe("formatReport", () => {
+    it("reports a clean run", () => {
+        const text = formatReport(result());
+        expect(text).toContain("No problems found.");
+        expect(text).toContain("Ran 1 rule.");
+    });
+    it("lists each diagnostic with its severity, rule id, location and message", () => {
+        const text = formatReport(result([ERROR_DIAGNOSTIC]));
+        expect(text).toContain("error");
+        expect(text).toContain("edge-target-missing");
+        expect(text).toContain("README.md -> gone.md");
+        expect(text).toContain("Target document does not exist");
+    });
+    it("includes a hint when the diagnostic carries one", () => {
+        expect(formatReport(result([WARN_DIAGNOSTIC]))).toContain("hint: link it from README.md");
+    });
+    it("orders errors before warnings", () => {
+        const text = formatReport(result([WARN_DIAGNOSTIC, ERROR_DIAGNOSTIC]));
+        expect(text.indexOf("edge-target-missing")).toBeLessThan(text.indexOf("doc-orphaned"));
+    });
+    it("summarizes the counts, pluralized", () => {
+        expect(formatReport(result([ERROR_DIAGNOSTIC, WARN_DIAGNOSTIC]))).toContain("2 problems (1 error, 1 warning, 0 notes)");
+    });
+    it("notes how many rules were turned off", () => {
+        const text = formatReport(result([], { rulesRun: ["a"], rulesSkipped: ["b", "c"] }));
+        expect(text).toContain("Ran 1 rule, 2 off.");
+    });
+    it("flags config rule ids that no validator declares", () => {
+        const text = formatReport(result([], { unknownRules: ["typo-rule"] }));
+        expect(text).toContain("unknown rules: typo-rule");
+    });
+    it("stays ASCII so the cp1252 Windows console can print it", () => {
+        const text = formatReport(result([ERROR_DIAGNOSTIC, WARN_DIAGNOSTIC], { unknownRules: ["x"] }));
+        // biome-ignore lint/suspicious/noControlCharactersInRegex: asserting the whole ASCII range
+        expect(text).toMatch(/^[\x00-\x7F]*$/);
+    });
+    it("emits the full result as JSON when asked", () => {
+        const validation = result([ERROR_DIAGNOSTIC]);
+        const parsed = JSON.parse(formatReport(validation, { json: true }));
+        expect(parsed).toEqual(validation);
+    });
+});
+describe("formatRules", () => {
+    it("lists each rule with its default severity and description", () => {
+        const registry = new ValidatorRegistry().register({
+            rules: [{ id: "some-check", description: "Checks something", defaultSeverity: "warn" }],
+            run: () => [],
+        });
+        const text = formatRules(registry);
+        expect(text).toContain("some-check");
+        expect(text).toContain("warn");
+        expect(text).toContain("Checks something");
+        expect(text).toContain("validator-error");
+    });
+});
+describe("exitCodeFor", () => {
+    it("fails on an error diagnostic", () => {
+        expect(exitCodeFor(result([ERROR_DIAGNOSTIC]))).toBe(1);
+    });
+    it("passes on warnings and notes alone", () => {
+        expect(exitCodeFor(result([WARN_DIAGNOSTIC]))).toBe(0);
+    });
+    it("passes on a clean run", () => {
+        expect(exitCodeFor(result())).toBe(0);
+    });
+});
+describe("runValidation", () => {
+    it("builds the project's graph and runs the given checks over it", async () => {
+        const registry = new ValidatorRegistry().register({
+            rules: [{ id: "node-count", description: "Counts nodes", defaultSeverity: "info" }],
+            run: (context) => [
+                { rule: "node-count", message: `${context.nodes.size} nodes`, target: { kind: "graph" } },
+            ],
+        });
+        const validation = await runValidation(FIXTURES_DIR, registry);
+        expect(validation.diagnostics.map((d) => d.message)).toEqual(["2 nodes"]);
+        expect(validation.counts).toEqual({ error: 0, warn: 0, info: 1 });
+    });
+    it("finds nothing with the built-in checks, which are not written yet", async () => {
+        const validation = await runValidation(FIXTURES_DIR);
+        expect(validation.diagnostics).toEqual([]);
+        expect(exitCodeFor(validation)).toBe(0);
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/validation.test.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@lepid-labs/weft",
+  "version": "0.1.0",
+  "description": "Weft CLI: serve, index and check a documentation graph, from a checkout or straight from GitHub",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lepid-Labs/weft.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/Lepid-Labs/weft#readme",
+  "type": "module",
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "bin": {
+    "weft": "bin/weft.js"
+  },
+  "dependencies": {
+    "cleye": "^1.3.0",
+    "@lepid-labs/weft-core": "0.1.0",
+    "@lepid-labs/weft-ui": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.4.3",
+    "vitest": "^3.2.6"
+  },
+  "peerDependencies": {
+    "vite": "^6.4.3"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm --filter @lepid-labs/weft-core build && vitest run",
+    "test:watch": "vitest"
+  }
+}