craftar 0.29.0 → 0.30.1

package/dist/importers/kiro-report.js

@@ -5,7 +5,10 @@ import { parseFrontmatter } from "../core/frontmatter.js";
 import { loadWorkspaceConfig, plan, status, unsetDeclared, unsetSummary } from "../core/sync.js";
 import { stripBom, toLf } from "../core/text.js";
 import { workspaceParams, workspaceSections } from "./decide.js";
-/** The note of a steering mirror that grew past its rule — the hint that `--prefer-kiro` may apply. */
+/**
+ * The note of a steering mirror that grew past its rule — the hint that `--prefer-kiro` may apply (not given to a rule
+ * `--prefer-kiro` just took from its steering file: that mirror is the source now, so the hint does not apply).
+ */
 export const STEERING_BIGGER = "steering bigger than the rule";
 /** The banner the kiro emitter puts on a generated steering file. */
 export const GENERATED_BANNER = /<!--\s*GENERATED from /;
@@ -32,10 +35,13 @@ function steeringBody(text) {
  * `STEERING_BIGGER` for a rule's steering mirror that holds more lines than the rule's source in `.claude/rules/` —
  * the documented symptom of a mirror kept by hand. The file's name is the rule's output name.
  */
-async function noteFor(workspaceRoot, rel, from, steering) {
+async function noteFor(workspaceRoot, rel, from, steering, preferred) {
     const m = /^\.kiro\/steering\/([^/]+)\.md$/.exec(rel);
     if (!m || !from.startsWith("rule/"))
         return "";
+    // A rule --prefer-kiro took from its steering file: that mirror is the source now, so the note does not apply.
+    if (preferred.includes(m[1]))
+        return "";
     const rule = path.join(workspaceRoot, ".claude", "rules", `${m[1]}.md`);
     if (!(await exists(rule)))
         return "";
@@ -55,6 +61,8 @@ export async function kiroReport(o, deps = { plan }) {
     const root = path.resolve(o.workspaceRoot);
     if (!(await exists(path.join(root, ".kiro"))))
         return { kind: "none" };
+    // The rules this run took from their steering file (`report.preferKiro`).
+    const preferred = o.preferred ?? [];
     try {
         const read = (abs) => fs.readFile(abs, "utf8");
         const overrides = { params: await workspaceParams(root, read), sections: await workspaceSections(root, read) };
@@ -75,7 +83,7 @@ export async function kiroReport(o, deps = { plan }) {
                 from,
                 workspaceLines: textLines(disk),
                 generatedLines: textLines(s.planned.content.toString("utf8")),
-                note: await noteFor(root, s.path, from, disk),
+                note: await noteFor(root, s.path, from, disk, preferred),
             });
         }
         const planned = new Set(p.files.map((f) => f.path));

package/dist/importers/kiro-report.js.map

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

package/dist/ui/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/ui/page.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;CAaxB,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAA2E;IACjG,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE;IACzD,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE;IAC/D,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE;IAC7D,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE;IAC9D,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,EAAE;IACtE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE;IAC/D,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,cAAc,CAAC,EAAE;IAC9E,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,EAAE;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;cAKnB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;;oBAGrB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;mBACtH,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmT9G,CAAC"}

package/dist/ui/routes.js

@@ -0,0 +1,132 @@
+import { catalogueContext, listIngredients, listRecipes, withLoadWarnings } from "../core/catalogue.js";
+import { renderDiff } from "../core/diff.js";
+import { oneLine } from "../core/doctor.js";
+import { isMissing, listWorkspaces, readRegistry } from "../core/registry.js";
+import { credentialFault, CREDENTIAL_HIDDEN, refHoldsCredentials } from "../core/remote.js";
+import { EXAMPLE_CONTENT_HIDDEN, diffReport, explainFile, statusReport } from "../core/report.js";
+import { loadWorkspace, plan, readLock, status, unsetSummary } from "../core/sync.js";
+import { hashNormalized } from "../core/text.js";
+export const NOT_FOUND = { error: "not found" };
+export const PATH_REQUIRED = { error: "path is required, once" };
+export const MISSING = "the directory or its craftar.yaml is gone — craftar workspaces prune";
+/** A workspace's id in a URL: 16 hex characters of the hash of its registered path — the path itself never travels. */
+export const workspaceId = (registeredPath) => hashNormalized(registeredPath).slice("sha256:".length, "sha256:".length + 16);
+/** Why a workspace cannot be shown, in one line — the wording `doctor` uses, so the table and a 409 agree. */
+export function routeReason(e) {
+    return e instanceof Error ? oneLine(e) : String(e).split("\n")[0];
+}
+/** The route a path names, as its pattern — what the one stderr line of a 500 prints, never the request's text. */
+export function routePattern(path) {
+    if (path === "/api/workspaces")
+        return path;
+    const m = /^\/api\/workspaces\/[0-9a-f]{16}(\/(diff|explain|recipes|ingredients))?$/.exec(path);
+    return m ? `/api/workspaces/<id>${m[1] ?? ""}` : null;
+}
+/** The query's `path`, given exactly once and decoded once (`+` is not a space) — or null. */
+function onePath(query) {
+    const given = query.split("&").filter((kv) => kv === "path" || kv.startsWith("path="));
+    if (given.length !== 1)
+        return null;
+    try {
+        return decodeURIComponent(given[0].slice("path=".length));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * A row of the table as the page is given it: its id, and — whatever the core answered — never a Forge URL that
+ * `credentialFault` flags. Since 0.28.1 the core gives the label itself for a `missing` or an `error` row; this
+ * is the page's own check, a second line: the label is the core's (`CREDENTIAL_HIDDEN`), and the key goes with it.
+ * A recorded `ref` that `refHoldsCredentials` flags is given the same label (`CREDENTIAL_HIDDEN`).
+ */
+export function servedRow(r) {
+    const row = { id: workspaceId(r.path), ...r };
+    if (credentialFault(r.forge.source))
+        row.forge = { ...r.forge, source: CREDENTIAL_HIDDEN, key: null };
+    if (r.forge.ref !== null && refHoldsCredentials(r.forge.ref))
+        row.forge = { ...row.forge, ref: CREDENTIAL_HIDDEN };
+    return row;
+}
+export async function route(req, deps) {
+    const pattern = routePattern(req.path);
+    if (pattern === null)
+        return { status: 404, body: NOT_FOUND };
+    if (pattern === "/api/workspaces") {
+        const t = await listWorkspaces(deps.home, { fetch: false, reason: routeReason });
+        const rows = t.rows.map(servedRow);
+        return {
+            status: 200,
+            body: { version: deps.version, registry: t.registry, fetch: false, workspaces: rows, warnings: t.warnings },
+        };
+    }
+    const [, , , id, what] = req.path.split("/");
+    // Decided from the request alone, before the registry is read.
+    let wanted = "";
+    if (what === "diff" || what === "explain") {
+        const given = onePath(req.query);
+        if (given === null)
+            return { status: 400, body: PATH_REQUIRED };
+        wanted = given;
+    }
+    // A registry that does not read is not this workspace's fault: it propagates, and the server answers 500.
+    const entry = (await readRegistry(deps.home)).workspaces.find((e) => workspaceId(e.path) === id);
+    if (!entry)
+        return { status: 404, body: NOT_FOUND };
+    if (await isMissing(entry))
+        return { status: 409, body: { error: MISSING, warnings: [] } };
+    // What cannot be loaded, planned or read is this workspace's state: 409, in one line. A failure past that point is ours: 500.
+    let ws;
+    let p;
+    let lock;
+    let st;
+    try {
+        ws = await loadWorkspace(entry.path, { mode: "no-fetch", home: deps.home });
+        if (what === "recipes" || what === "ingredients") {
+            // The catalogue resolves and never plans; it does not read the lock either.
+            const context = catalogueContext(ws.forge, { kind: "workspace", config: ws.config });
+            const listing = what === "recipes" ? listRecipes(ws.forge, context) : listIngredients(ws.forge, context);
+            return { status: 200, body: withLoadWarnings(listing, ws.warnings) };
+        }
+        p = await plan(ws);
+        lock = await readLock(ws.root);
+        st = await status(ws, p, lock);
+    }
+    catch (e) {
+        return { status: 409, body: { error: routeReason(e), warnings: ws?.warnings ?? [] } };
+    }
+    if (what === undefined) {
+        const report = statusReport(ws, p, lock, st);
+        return {
+            status: 200,
+            body: { id, path: entry.path, profile: ws.config.profile, recipes: p.resolution.recipes, targets: p.resolution.targets, ...report, refused: report.unsetParams.length ? unsetSummary(report.unsetParams) : null },
+        };
+    }
+    if (what === "explain") {
+        // Never `notProduced`'s message: it quotes the path asked.
+        const explained = explainFile(ws, p, wanted);
+        return explained ? { status: 200, body: explained } : { status: 404, body: NOT_FOUND };
+    }
+    // The row whose path is the string asked, character for character: nothing is opened that status() did not name.
+    const row = st.find((s) => s.path === wanted);
+    if (!row)
+        return { status: 404, body: NOT_FOUND };
+    const [d] = await diffReport(ws, [row], { withholdMcp: false });
+    if (!d)
+        return { status: 200, body: { path: row.path, state: row.state, from: null, to: null, hidden: false, note: null, diff: null } };
+    const from = `${row.path} (disk, ${row.state})`;
+    const to = row.state === "orphan-drift" ? null : row.state === "orphan" ? `${row.path} (forge: no longer produced — sync removes it)` : `${row.path} (forge)`;
+    return {
+        status: 200,
+        body: {
+            path: row.path,
+            state: row.state,
+            from,
+            to,
+            hidden: d.note === EXAMPLE_CONTENT_HIDDEN,
+            note: d.note,
+            diff: d.note === null ? renderDiff(d.disk ?? "", d.forge ?? "") : null,
+        },
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/ui/routes.js.map

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