craftar 0.28.2 → 0.30.0

package/dist/core/report.js

@@ -0,0 +1,164 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { EXAMPLE_SETTINGS } from "../emitters/shared.js";
+import { listTargets } from "./capabilities.js";
+import { diffOps } from "./diff.js";
+import { mcpTagged } from "./drift.js";
+import { FULL_SHA } from "./remote.js";
+import { resolve } from "./resolve.js";
+import { errorText } from "./schema-fault.js";
+import { loadForgeFor, unsetDeclared } from "./sync.js";
+import { hashNormalized, stripBom, toLf } from "./text.js";
+/*
+ * What the reading commands answer, as data (spec 35 §5.1): one builder per shape, called by the CLI, by
+ * `craftar mcp` and by anything else that shows the same thing. Nothing here prints, and none of them selects,
+ * normalizes or refuses a path — each caller keeps its own rule.
+ */
+/** The one test of which states `diff` shows — the states `sync --check` refuses. */
+export function diffShows(state) {
+    return state !== "unchanged" && state !== "adopt";
+}
+/** Spec 27 Ruling 4: the on-disk content of the example file is never shown. No indentation: the caller's. */
+export const EXAMPLE_CONTENT_HIDDEN = "content not shown: an example file may hold a value typed by hand";
+/** Spec 35 §4.5: what `craftar mcp` says in place of the disk side of a hand-touched MCP file. */
+export const MCP_CONTENT_HIDDEN = "content not shown: an MCP configuration file may hold a value typed by hand";
+/** A path as the user may type it, to the spelling `status` prints: forward slashes, no leading `./`. */
+export const statusPath = (p) => p.replace(/\\/g, "/").replace(/^\.\//, "");
+/** `explain`'s refusal: the Forge does not produce this path for the profile. */
+export const notProduced = (p, profile) => `${p} is not produced by the Forge for profile ${profile}`;
+/** Why sync leaves a file alone, for the three states it skips. */
+export function explainSkip(s) {
+    switch (s.state) {
+        case "drift":
+            return "hand-edited since last sync — `craftar drift show <path>`, then `craftar drift discard` or `craftar drift promote`";
+        case "collision":
+            return "exists but was never generated by craftar and differs from the Forge — rename it or import it";
+        case "orphan-drift":
+            return "no longer produced by the Forge but hand-edited — kept; `craftar drift discard <path>` removes it, or delete it yourself";
+        default:
+            return "";
+    }
+}
+/** A file's text as a diff compares it: LF, no BOM; null when it cannot be read. */
+export async function readText(p) {
+    try {
+        return toLf(stripBom(await fs.readFile(p, "utf8")));
+    }
+    catch {
+        return null;
+    }
+}
+export function statusReport(ws, p, lock, statuses) {
+    const o = ws.origin;
+    return {
+        forge: {
+            kind: o.kind,
+            source: o.source,
+            ref: o.ref,
+            defaultBranch: o.defaultBranch,
+            commit: ws.forge.commit,
+            lockCommit: lock?.forge.commit ?? null,
+            fetched: o.fetched,
+        },
+        // The planned buffer never leaves the process: dropped here, once, for every reader of the document.
+        statuses: statuses.map(({ planned, ...s }) => s),
+        warnings: p.warnings,
+        unsetParams: unsetDeclared(p),
+    };
+}
+/**
+ * What `diff` shows for each row in a state `sync --check` refuses (spec 19 §3.2: `unchanged` and `adopt` are
+ * skipped). It never renders: the caller owns the header lines and the paint. `withholdMcp` widens the one
+ * withholding of spec 27 Ruling 4 — the example file — to every file tagged `mcp/*`, for a reader that is a model
+ * (spec 35 §4.5). The disk is read at the row's path, never at one a caller typed.
+ */
+export async function diffReport(ws, rows, opts) {
+    const out = [];
+    for (const s of rows) {
+        if (!diffShows(s.state))
+            continue;
+        const noted = (note) => ({ path: s.path, state: s.state, added: null, removed: null, note, disk: null, forge: null });
+        if (s.state === "orphan-drift") {
+            // No body: sync keeps this file
+            out.push(noted(explainSkip(s)));
+            continue;
+        }
+        // Only where a hand has touched the file: in `update` and `orphan` the disk side is what craftar wrote.
+        if (s.state === "drift" || s.state === "collision") {
+            if (opts.withholdMcp && mcpTagged(s)) {
+                out.push(noted(MCP_CONTENT_HIDDEN));
+                continue;
+            }
+            if (s.path === EXAMPLE_SETTINGS) {
+                out.push(noted(EXAMPLE_CONTENT_HIDDEN));
+                continue;
+            }
+        }
+        const disk = (await readText(path.join(ws.root, s.path))) ?? "";
+        // An orphan is the removal of the whole file
+        const forge = s.state === "orphan" || !s.planned ? "" : toLf(stripBom(s.planned.content.toString("utf8")));
+        const ops = diffOps(disk, forge);
+        out.push({
+            path: s.path,
+            state: s.state,
+            added: ops.filter((o) => o.kind === "add").length,
+            removed: ops.filter((o) => o.kind === "del").length,
+            note: null,
+            disk,
+            forge,
+        });
+    }
+    return out;
+}
+/** The planned file at `file`, compared as given (the caller normalizes); null when the Forge does not produce it. */
+export function explainFile(ws, p, file) {
+    const f = p.files.find((x) => x.path === file);
+    if (!f)
+        return null;
+    // AGENTS.md (rule/*) and the MCP files (mcp/*) are not one ingredient: nothing resolved has their ref.
+    const ing = p.resolution.ingredients.find((i) => i.ref === f.ingredient);
+    return {
+        path: f.path,
+        target: f.target,
+        ingredient: f.ingredient,
+        origin: ing?.meta.origin ? { workspace: ing.meta.origin.workspace, path: ing.meta.origin.path } : null,
+        via: ing ? [...ing.via] : null,
+        sections: (p.sections.get(f.ingredient) ?? []).map((x) => ({ name: x.name, layer: x.layer })),
+        params: (p.params.get(f.ingredient) ?? []).map((x) => ({ key: x.key, layer: x.layer })),
+        profile: ws.config.profile,
+        recipes: [...p.resolution.recipes],
+        hash: hashNormalized(f.content),
+    };
+}
+/**
+ * The capability matrix with the targets a workspace uses marked. `input` is the configuration to load from
+ * (never fetched: `no-fetch`), a reason not to load — worded as a failed load is — or null for no workspace at
+ * all: the matrix unmarked, no warning. It never throws for a workspace that does not load or resolve.
+ */
+export async function targetsReport(root, opts, input) {
+    if (input === null)
+        return { ...listTargets(null), warnings: [] };
+    const notShown = (why) => ({ ...listTargets(null), warnings: [`targets in use not shown: ${why}`] });
+    if ("reason" in input)
+        return notShown(input.reason);
+    try {
+        const ws = await loadForgeFor(root, input.merged, { ...opts, mode: "no-fetch" });
+        return { ...listTargets(resolve(ws.forge, ws.config).targets), warnings: [] };
+    }
+    catch (e) {
+        // Load or resolve failed — a warning, not an error
+        return notShown(errorText(e));
+    }
+}
+/**
+ * For a reader started without `--fetch` (`craftar mcp`, spec 35 §4.4): the line that says a remote Forge was read
+ * from its cached copy, so an answer for a Forge that has moved is never silent. Null when the caller fetches (the
+ * fallback warning is then the signal), for a path Forge, and for a full-SHA `ref`, which cannot go stale.
+ */
+export function cachedCopyLine(ws, fetch) {
+    const o = ws.origin;
+    if (fetch || o.kind !== "remote" || (o.ref !== null && FULL_SHA.test(o.ref)))
+        return null;
+    return `Forge ${o.source} read from the copy cached ${o.fetchedAt ?? "(time unknown)"} (commit ${ws.forge.commit?.slice(0, 8) ?? "no git"}) — craftar mcp was started without --fetch`;
+}
+//# sourceMappingURL=report.js.map

package/dist/core/report.js.map

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

package/dist/mcp.js

@@ -0,0 +1,87 @@
+import { handleLine } from "./core/mcp-protocol.js";
+/*
+ * The stdio transport of `craftar mcp` (spec 35 §4.3): one JSON-RPC message per line in, one per line out. The
+ * only place that knows the wire — the protocol itself is `src/core/mcp-protocol.ts`. It splits lines itself
+ * (the cap needs it, and `node:readline` stays `src/prompt.ts`'s alone), touches neither `process` nor `console`,
+ * and writes nothing but answers.
+ */
+/** A line longer than this is discarded whole: one line cannot hold the server's memory. */
+export const MAX_LINE_BYTES = 1024 * 1024;
+/**
+ * Lines in, lines out, one call at a time: a line is not handled before the previous one was answered.
+ * Resolves when `input` has ended and the last answer was written.
+ */
+export function serve(input, output, ctx) {
+    const state = { initialized: false };
+    let queue = Promise.resolve();
+    // The bytes of the line being read: decoded only once it is whole, so a character split across chunks survives.
+    let parts = [];
+    let size = 0;
+    // Inside a line that already passed the cap: its bytes are dropped up to the newline, never buffered.
+    let skipping = false;
+    const line = (bytes) => {
+        const end = bytes.length > 0 && bytes[bytes.length - 1] === 0x0d ? bytes.length - 1 : bytes.length;
+        // The cap is on the line itself: a CR before the newline is not counted against it
+        if (end === 0 || end > MAX_LINE_BYTES)
+            return;
+        const text = bytes.toString("utf8", 0, end);
+        queue = queue.then(async () => {
+            // A tool that fails is an answer. Anything else that throws — the handling itself, or a write to a reader
+            // that went away — drops this line only: the queue goes on, and nothing is said on any stream.
+            try {
+                const answer = await handleLine(text, ctx, state);
+                if (answer !== null)
+                    output.write(answer + "\n");
+            }
+            catch {
+                /* dropped */
+            }
+        });
+    };
+    const feed = (chunk) => {
+        let from = 0;
+        for (;;) {
+            const newline = chunk.indexOf(0x0a, from);
+            const piece = chunk.subarray(from, newline === -1 ? chunk.length : newline);
+            if (!skipping) {
+                // One byte of slack while buffering, for that CR; `line()` holds the cap itself
+                if (size + piece.length > MAX_LINE_BYTES + 1) {
+                    skipping = true;
+                    parts = [];
+                    size = 0;
+                }
+                else {
+                    parts.push(piece);
+                    size += piece.length;
+                }
+            }
+            if (newline === -1)
+                return;
+            if (!skipping)
+                line(Buffer.concat(parts));
+            skipping = false;
+            parts = [];
+            size = 0;
+            from = newline + 1;
+        }
+    };
+    return new Promise((resolve) => {
+        let over = false;
+        // The input is over once: at its end, or when it fails or closes without one (a pipe that resets). What was
+        // already read is still answered; a stream error never reaches the process as an uncaught exception.
+        const finish = (ended) => {
+            if (over)
+                return;
+            over = true;
+            // A last line with no newline is still a line — only when the input really ended
+            if (ended && !skipping && size > 0)
+                line(Buffer.concat(parts));
+            void queue.then(resolve);
+        };
+        input.on("data", (chunk) => feed(typeof chunk === "string" ? Buffer.from(chunk, "utf8") : chunk));
+        input.on("end", () => finish(true));
+        input.on("error", () => finish(false));
+        input.on("close", () => finish(false));
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/ui/page.js

@@ -0,0 +1,393 @@
+/**
+ * The page of `craftar ui` (spec 36 §4.7, §7.4): one document, one script, one stylesheet, hand-written, as three
+ * string constants — `dist/` holds only what `tsc` emits. The server sends the document with a CSP that allows
+ * no inline script and no inline style, and the script puts every value it receives into the document as text
+ * (`textContent`), never as markup. `test/ui-page.test.ts` reads these sources; what the page does in a browser
+ * is a by-hand run.
+ */
+import { diffShows } from "../core/report.js";
+export const PAGE_HTML = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>craftar</title>
+<link rel="stylesheet" href="/app.css">
+</head>
+<body>
+<main id="app"></main>
+<script src="/app.js"></script>
+</body>
+</html>
+`;
+export const PAGE_CSS = `:root { color-scheme: light dark; --fg: #1b1f24; --bg: #ffffff; --dim: #5c6670; --line: #d5dae0; --soft: #f3f5f7; --ok: #1a7f37; --warn: #9a6700; --bad: #b42318; --add: #1a7f37; --del: #b42318; }
+@media (prefers-color-scheme: dark) { :root { --fg: #e6e9ec; --bg: #0f1317; --dim: #9aa5b1; --line: #2b333b; --soft: #171c21; --ok: #4ac26b; --warn: #d4a72c; --bad: #ff7b72; --add: #4ac26b; --del: #ff7b72; } }
+* { box-sizing: border-box; }
+body { margin: 0; font: 14px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif; color: var(--fg); background: var(--bg); }
+main { max-width: 1200px; margin: 0 auto; padding: 16px 20px 48px; }
+h1 { font-size: 18px; margin: 0 0 4px; }
+h2 { font-size: 15px; margin: 24px 0 8px; }
+h3 { font-size: 13px; margin: 16px 0 6px; text-transform: uppercase; letter-spacing: 0.04em; color: var(--dim); }
+p { margin: 4px 0; }
+.dim { color: var(--dim); }
+.mono, code, pre, td.path { font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace; font-size: 12.5px; }
+.bar { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; margin: 8px 0 12px; }
+button { font: inherit; color: inherit; background: var(--soft); border: 1px solid var(--line); border-radius: 6px; padding: 3px 10px; cursor: pointer; }
+button:hover { border-color: var(--dim); }
+button.link { background: none; border: 0; padding: 0; color: inherit; text-decoration: underline; font-weight: 600; }
+button.on { border-color: var(--fg); }
+.scroll { overflow-x: auto; }
+table { border-collapse: collapse; width: 100%; }
+th, td { text-align: left; vertical-align: top; padding: 5px 10px 5px 0; border-bottom: 1px solid var(--line); }
+th { font-weight: 600; color: var(--dim); white-space: nowrap; }
+td.path { overflow-wrap: anywhere; }
+.state { font-weight: 600; white-space: nowrap; }
+.s-up-to-date, .s-unchanged { color: var(--ok); }
+.s-outdated, .s-update, .s-new, .s-adopt, .s-orphan, .s-no-lock { color: var(--warn); }
+.s-drift, .s-collision, .s-orphan-drift, .s-error, .s-missing { color: var(--bad); }
+.note { border-left: 3px solid var(--line); padding: 2px 10px; margin: 8px 0; }
+.note.warn { border-color: var(--warn); }
+.note.bad { border-color: var(--bad); }
+.detail { background: var(--soft); border: 1px solid var(--line); border-radius: 6px; padding: 8px 12px; margin: 6px 0 10px; }
+pre { margin: 6px 0 0; overflow-x: auto; white-space: pre; }
+pre .add { color: var(--add); }
+pre .del { color: var(--del); }
+dl { display: grid; grid-template-columns: max-content 1fr; gap: 2px 14px; margin: 0; }
+dt { color: var(--dim); }
+dd { margin: 0; overflow-wrap: anywhere; }
+ul { margin: 4px 0; padding-left: 18px; }
+code.cmd { background: var(--soft); border: 1px solid var(--line); border-radius: 4px; padding: 1px 6px; user-select: all; }
+`;
+/**
+ * How the page lists each file state — a `Record` over every `FileState`, so a new state does not compile until it is placed here,
+ * as `FILE_STATE_ORDER_MAP` does for the CLI: `order` on the page, `syncActs` (sync writes or removes it without a flag, so the page
+ * offers the command), and `diff` (the core's `diffShows`).
+ */
+export const PAGE_STATES = {
+    new: { order: 0, syncActs: true, diff: diffShows("new") },
+    update: { order: 1, syncActs: true, diff: diffShows("update") },
+    adopt: { order: 2, syncActs: true, diff: diffShows("adopt") },
+    drift: { order: 3, syncActs: false, diff: diffShows("drift") },
+    collision: { order: 4, syncActs: false, diff: diffShows("collision") },
+    orphan: { order: 5, syncActs: true, diff: diffShows("orphan") },
+    "orphan-drift": { order: 6, syncActs: false, diff: diffShows("orphan-drift") },
+    unchanged: { order: 7, syncActs: false, diff: diffShows("unchanged") },
+};
+export const PAGE_JS = String.raw `"use strict";
+(function () {
+  var NO_TOKEN = "open the address printed by craftar ui — this tab has no token";
+  var KEY = "craftar-ui-token";
+  var MAX_DIFF_LINES = 2000;
+  var _PS = ${JSON.stringify(PAGE_STATES)};
+  var STATES = Object.keys(_PS).sort(function(a, b) { return _PS[a].order - _PS[b].order; });
+  /* The states sync acts on without a flag. */
+  var SYNC_ACTS = ${JSON.stringify(Object.fromEntries(Object.entries(PAGE_STATES).filter(([, v]) => v.syncActs).map(([k]) => [k, true])))};
+  var HAS_DIFF = ${JSON.stringify(Object.fromEntries(Object.entries(PAGE_STATES).map(([k, v]) => [k, v.diff])))};
+  var app = document.getElementById("app");
+  var table = null;
+
+  var fromHash = location.hash.slice(1);
+  var token = fromHash;
+  try {
+    if (fromHash) sessionStorage.setItem(KEY, fromHash);
+    else token = sessionStorage.getItem(KEY) || "";
+  } catch (e) {
+    /* storage refused: the token lives for this page load only */
+  }
+  if (fromHash) history.replaceState(null, "", location.pathname);
+
+  function el(tag, className, text) {
+    var node = document.createElement(tag);
+    if (className) node.className = className;
+    if (text !== undefined && text !== null) node.textContent = String(text);
+    return node;
+  }
+  function add(parent) {
+    for (var i = 1; i < arguments.length; i++) if (arguments[i]) parent.appendChild(arguments[i]);
+    return parent;
+  }
+  function clear(node) {
+    while (node.firstChild) node.removeChild(node.firstChild);
+    return node;
+  }
+  function button(label, onClick, className) {
+    var b = el("button", className || "", label);
+    b.type = "button";
+    b.addEventListener("click", onClick);
+    return b;
+  }
+  function list(items, className) {
+    var ul = el("ul", className || "");
+    items.forEach(function (item) { add(ul, el("li", "", item)); });
+    return ul;
+  }
+  function row(tag, cells) {
+    var tr = el("tr");
+    cells.forEach(function (cell) {
+      var td = el(tag);
+      if (cell && cell.nodeType) add(td, cell);
+      else td.textContent = cell === null || cell === undefined ? "" : String(cell);
+      add(tr, td);
+    });
+    return tr;
+  }
+  function grid(head, rows) {
+    var t = el("table");
+    add(t, add(el("thead"), row("th", head)));
+    var body = el("tbody");
+    rows.forEach(function (cells) { add(body, row("td", cells)); });
+    return add(el("div", "scroll"), add(t, body));
+  }
+  function note(text, kind) {
+    return el("p", "note" + (kind ? " " + kind : ""), text);
+  }
+  function short(commit) {
+    return commit ? commit.slice(0, 7) : "no git";
+  }
+  /* A path as one word of a command line: as it is when plain; single-quoted for a POSIX path (nothing expands
+     inside single quotes); double-quoted, only the quote escaped, otherwise. */
+  function shellWord(text) {
+    if (text.charAt(0) === "/") return /^[A-Za-z0-9_.,:=@%+\/-]+$/.test(text) ? text : "'" + text.replace(/'/g, "'\\''") + "'";
+    if (/^[A-Za-z0-9_.,:=@%+\/\\-]+$/.test(text)) return text;
+    return '"' + text.replace(/"/g, '\\"') + '"';
+  }
+  function forgeLine(forge) {
+    return forge.source + (forge.ref ? " (ref " + forge.ref + ")" : "") + " @ " + short(forge.commit);
+  }
+
+  function api(path) {
+    return fetch(path, { headers: { Authorization: "Bearer " + token }, cache: "no-store" }).then(function (res) {
+      return res.json().then(
+        function (body) { return { status: res.status, body: body }; },
+        function () { return { status: res.status, body: null }; }
+      );
+    });
+  }
+
+  /* What the page says for an answer that is not 200. asked: the file's path when the request named one. */
+  function problem(into, answer, asked) {
+    clear(into);
+    if (answer.status === 403) return add(into, note(NO_TOKEN, "bad"));
+    if (answer.status === 404) {
+      if (asked !== undefined) return add(into, note("craftar does not manage " + asked, "warn"));
+      return add(into, note("this workspace is no longer registered", "warn"), button("Refresh", showWorkspaces));
+    }
+    if (answer.status === 409 && answer.body) {
+      add(into, note(String(answer.body.error), "bad"));
+      if (answer.body.warnings && answer.body.warnings.length) add(into, list(answer.body.warnings, "dim"));
+      return into;
+    }
+    if (answer.status === 400 && answer.body) return add(into, note(String(answer.body.error), "bad"));
+    if (answer.status === 500) return add(into, note("craftar ui failed — see its terminal", "bad"));
+    return add(into, note("unexpected answer: " + answer.status, "bad"));
+  }
+  function unreachable(into) {
+    clear(into);
+    return add(into, note("craftar ui is not answering — it may have been stopped in its terminal", "bad"));
+  }
+  function load(path, into, asked, render) {
+    add(clear(into), el("p", "dim", "loading…"));
+    api(path).then(
+      function (answer) {
+        if (answer.status !== 200 || answer.body === null) return problem(into, answer, asked);
+        clear(into);
+        render(answer.body);
+      },
+      function () { unreachable(into); }
+    );
+  }
+
+  /* View 1: the table of craftar workspaces. */
+  function showWorkspaces() {
+    clear(app);
+    var head = add(el("div"), el("h1", "", "craftar — workspaces"));
+    var body = el("div");
+    add(app, head, add(el("div", "bar"), button("Refresh", showWorkspaces)), body);
+    if (!token) return add(clear(body), note(NO_TOKEN, "bad"));
+    load("/api/workspaces", body, undefined, function (doc) {
+      table = doc;
+      add(head, el("p", "dim", "craftar " + doc.version + " · registry " + doc.registry));
+      if (!doc.workspaces.length) {
+        add(body, note("no workspace is registered on this machine yet — run craftar sync in one"));
+      } else {
+        add(body, grid(
+          ["workspace", "path", "profile", "stack", "targets", "forge", "last sync", "status"],
+          doc.workspaces.map(function (w) {
+            var stack = Object.keys(w.stack || {}).map(function (k) { return k + " " + w.stack[k]; }).join(", ");
+            var state = el("span", "state s-" + w.status, w.status.replace(/-/g, " ") + (w.forgeMoved ? " · forge moved" : ""));
+            var path = el("span", "mono", w.path);
+            return [button(w.name, function () { showWorkspace(w, "files"); }, "link"), path, w.profile, stack, w.targets.join(", "), forgeLine(w.forge), w.lastSync, state];
+          })
+        ));
+        if (doc.workspaces.some(function (w) { return w.forge.kind === "remote"; })) add(body, el("p", "dim", "status read offline from the Forge cache"));
+      }
+      if (doc.warnings.length) add(body, el("h3", "", "warnings"), list(doc.warnings));
+    });
+  }
+
+  function wordLayer(layer, profile) {
+    if (layer === "profile") return "profile " + profile;
+    if (typeof layer === "string") return layer;
+    if (layer && layer.recipe !== undefined) return "recipe " + layer.recipe;
+    if (layer && layer.profile !== undefined) return "profile " + layer.profile;
+    return "";
+  }
+
+  function frame(w, tab) {
+    clear(app);
+    var body = el("div");
+    add(
+      app,
+      add(el("div", "bar"), button("← Workspaces", showWorkspaces)),
+      el("h1", "", w.name),
+      el("p", "mono dim", w.path),
+      add(
+        el("div", "bar"),
+        button("Files", function () { showWorkspace(w, "files"); }, tab === "files" ? "on" : ""),
+        button("Its Forge", function () { showWorkspace(w, "forge"); }, tab === "forge" ? "on" : ""),
+        button("Refresh", function () { showWorkspace(w, tab); })
+      ),
+      body
+    );
+    return body;
+  }
+  function cachedLine(into, kind) {
+    if (kind === "remote") add(into, el("p", "dim", "read from the cached copy of the Forge — not fetched"));
+  }
+
+  function showWorkspace(w, tab) {
+    var body = frame(w, tab);
+    if (!token) return add(body, note(NO_TOKEN, "bad"));
+    if (tab === "forge") return showForge(w, body);
+    load("/api/workspaces/" + w.id, body, undefined, function (doc) {
+      cachedLine(body, doc.forge.kind);
+      var facts = el("dl");
+      [
+        ["profile", doc.profile],
+        ["recipes", doc.recipes.join(", ")],
+        ["targets", doc.targets.join(", ")],
+        ["forge", forgeLine(doc.forge)],
+        ["lock", doc.forge.lockCommit ? "generated from " + short(doc.forge.lockCommit) : "records no commit"]
+      ].forEach(function (pair) { add(facts, el("dt", "", pair[0]), el("dd", "", pair[1])); });
+      add(body, facts);
+      if (doc.unsetParams.length) {
+        add(body, note(doc.refused, "bad"));
+        add(body, list(doc.unsetParams.map(function (u) {
+          return u.key + " — declared by " + u.declaredBy.join(", ") + "; cited by " + u.citedBy.join(", ");
+        })));
+      }
+      if (doc.warnings.length) add(body, el("h3", "", "warnings"), list(doc.warnings));
+      if (!doc.statuses.length) add(body, note("the Forge produces no file for this workspace"));
+      STATES.concat(doc.statuses.map(function (s) { return s.state; }).filter(function (s, i, all) { return STATES.indexOf(s) === -1 && all.indexOf(s) === i; })).forEach(function (state) {
+        var files = doc.statuses.filter(function (s) { return s.state === state; });
+        if (!files.length) return;
+        var title = el("h2", "", "");
+        add(title, el("span", "state s-" + state, state), document.createTextNode(" · " + files.length));
+        add(body, title);
+        if (SYNC_ACTS[state] && !doc.unsetParams.length) {
+          add(body, add(el("p", "dim", "to apply, run in a terminal: "), el("code", "cmd", "craftar sync --workspace " + shellWord(doc.path))));
+        }
+        files.forEach(function (f) { add(body, fileRow(w, doc, f)); });
+      });
+    });
+  }
+
+  function fileRow(w, doc, f) {
+    var box = el("div");
+    var detail = el("div", "detail");
+    detail.hidden = true;
+    var bar = add(el("div", "bar"), el("span", "mono", f.path), el("span", "dim", [f.target, f.ingredient].filter(Boolean).join(" · ")));
+    var query = "?path=" + encodeURIComponent(f.path);
+    if (HAS_DIFF[f.state] !== false) {
+      add(bar, button("diff", function () {
+        detail.hidden = false;
+        load("/api/workspaces/" + w.id + "/diff" + query, detail, f.path, function (d) { showDiff(detail, d); });
+      }));
+    }
+    if (f.state !== "orphan" && f.state !== "orphan-drift") {
+      add(bar, button("explain", function () {
+        detail.hidden = false;
+        load("/api/workspaces/" + w.id + "/explain" + query, detail, f.path, function (x) { showExplain(detail, x); });
+      }));
+    }
+    add(bar, button("close", function () { detail.hidden = true; clear(detail); }));
+    return add(box, bar, detail);
+  }
+
+  function showDiff(into, d) {
+    if (d.from) add(into, el("p", "mono dim", "--- " + d.from));
+    if (d.to) add(into, el("p", "mono dim", "+++ " + d.to));
+    if (d.note) add(into, note(d.note, d.hidden ? "warn" : ""));
+    if (d.diff === null) {
+      if (!d.note) add(into, el("p", "dim", "nothing to show: sync leaves this file as it is"));
+      return;
+    }
+    var lines = d.diff.split("\n");
+    if (lines.length && lines[lines.length - 1] === "") lines.pop();
+    var pre = el("pre");
+    lines.slice(0, MAX_DIFF_LINES).forEach(function (line) {
+      var kind = line.charAt(0) === "+" ? "add" : line.charAt(0) === "-" ? "del" : "";
+      add(pre, el("span", kind, line), document.createTextNode("\n"));
+    });
+    add(into, pre);
+    if (lines.length > MAX_DIFF_LINES) add(into, el("p", "dim", "… " + (lines.length - MAX_DIFF_LINES) + " more lines"));
+  }
+
+  function showExplain(into, x) {
+    var dl = el("dl");
+    var pairs = [
+      ["ingredient", x.ingredient],
+      ["target", x.target],
+      ["brought by", x.via === null ? "no single recipe" : x.via.join(", ")],
+      ["imported from", x.origin ? x.origin.workspace + " · " + x.origin.path : "not imported"],
+      ["profile", x.profile],
+      ["recipes", x.recipes.join(", ")],
+      ["hash", x.hash]
+    ];
+    x.sections.forEach(function (s) { pairs.push(["section " + s.name, wordLayer(s.layer, x.profile)]); });
+    x.params.forEach(function (p) { pairs.push(["param " + p.key, wordLayer(p.layer, x.profile)]); });
+    pairs.forEach(function (pair) { add(dl, el("dt", "", pair[0]), el("dd", "mono", pair[1])); });
+    add(into, dl);
+  }
+
+  /* View 3: the Forge of one workspace — its recipes, then its ingredients. */
+  function showForge(w, body) {
+    cachedLine(body, w.forge.kind);
+    var recipes = el("div");
+    var ingredients = el("div");
+    add(body, el("h2", "", "Recipes"), recipes, el("h2", "", "Ingredients"), ingredients);
+    load("/api/workspaces/" + w.id + "/recipes", recipes, undefined, function (doc) {
+      add(recipes, el("p", "dim", "forge " + doc.forge.name + " @ " + short(doc.forge.commit)));
+      add(recipes, grid(
+        ["recipe", "slot", "parents", "profiles", "registered workspaces", "here"],
+        doc.recipes.map(function (r) {
+          var users = !table || w.forge.key === null ? [] : table.workspaces.filter(function (o) {
+            return o.forge.key !== null && o.forge.key === w.forge.key && o.recipes.indexOf(r.name) !== -1;
+          }).map(function (o) { return o.name; });
+          var here = r.removedByWorkspace ? "removed by this workspace" : r.inUse ? "in use (" + r.inUse.by.join(", ") + ")" : "";
+          return [r.name, r.slot, r.extends.join(", "), r.profiles.join(", "), users.join(", "), here];
+        })
+      ));
+      if (doc.warnings.length) add(recipes, el("h3", "", "warnings"), list(doc.warnings));
+      var said = doc.warnings;
+      load("/api/workspaces/" + w.id + "/ingredients", ingredients, undefined, function (ing) {
+        add(ingredients, grid(
+          ["ingredient", "type", "written as", "recipes", "targets", "here"],
+          ing.ingredients.map(function (i) {
+            var here = i.disabled ? "disabled by this workspace" : i.inUse ? "in use" : "";
+            return [i.ref, i.type, i.outputName, i.recipes.join(", "), i.targets === "*" ? "every target" : i.targets.join(", "), here];
+          })
+        ));
+        var more = ing.warnings.filter(function (w) { return said.indexOf(w) === -1; });
+        if (more.length) add(ingredients, el("h3", "", "warnings"), list(more));
+        if (ing.missing.length) {
+          add(ingredients, el("h3", "", "named by a recipe, not in the Forge"), list(ing.missing.map(function (m) { return m.ref + " — " + m.recipes.join(", "); })));
+        }
+      });
+    });
+  }
+
+  showWorkspaces();
+})();
+`;
+//# sourceMappingURL=page.js.map