craftar 0.28.2 → 0.29.0

package/dist/core/report.js

@@ -0,0 +1,160 @@
+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.
+ */
+/** 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 (s.state === "unchanged" || s.state === "adopt")
+            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":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAA0B,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAmB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAuH,MAAM,WAAW,CAAC;AAC7K,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE3D;;;;GAIG;AAEH,8GAA8G;AAC9G,MAAM,CAAC,MAAM,sBAAsB,GAAG,mEAAmE,CAAC;AAC1G,kGAAkG;AAClG,MAAM,CAAC,MAAM,kBAAkB,GAAG,6EAA6E,CAAC;AAEhH,yGAAyG;AACzG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAEpF,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,6CAA6C,OAAO,EAAE,CAAC;AAEtH,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAC,CAA4B;IACtD,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,oHAAoH,CAAC;QAC9H,KAAK,WAAW;YACd,OAAO,+FAA+F,CAAC;QACzG,KAAK,cAAc;YACjB,OAAO,0HAA0H,CAAC;QACpI;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,CAAS;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAkBD,MAAM,UAAU,YAAY,CAAC,EAAa,EAAE,CAAO,EAAE,IAAiB,EAAE,QAAsB;IAC5F,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpB,OAAO;QACL,KAAK,EAAE;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM;YACvB,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YACtC,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB;QACD,qGAAqG;QACrG,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAChD,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;KAC9B,CAAC;AACJ,CAAC;AAeD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAA2B,EAAE,IAAkB,EAAE,IAA8B;IAC9G,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO;YAAE,SAAS;QAC7D,MAAM,KAAK,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvI,IAAI,CAAC,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YAC/B,gCAAgC;YAChC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QACD,wGAAwG;QACxG,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACnD,IAAI,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBACpC,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAChC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;gBACxC,SAAS;YACX,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,6CAA6C;QAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3G,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM;YACjD,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM;YACnD,IAAI,EAAE,IAAI;YACV,IAAI;YACJ,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAkBD,sHAAsH;AACtH,MAAM,UAAU,WAAW,CAAC,EAAa,EAAE,CAAO,EAAE,IAAY;IAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,uGAAuG;IACvG,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IACzE,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;QACtG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9B,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7F,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACvF,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;QAC1B,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC;KAChC,CAAC;AACJ,CAAC;AAKD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,IAAuC,EACvC,KAA2D;IAE3D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,6BAA6B,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7G,IAAI,QAAQ,IAAI,KAAK;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAChF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,mDAAmD;QACnD,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAuC,EAAE,KAAc;IACpF,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpB,IAAI,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1F,OAAO,SAAS,CAAC,CAAC,MAAM,8BAA8B,CAAC,CAAC,SAAS,IAAI,gBAAgB,YAAY,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,QAAQ,6CAA6C,CAAC;AACzL,CAAC"}

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":"AAAA,OAAO,EAAE,UAAU,EAAkC,MAAM,wBAAwB,CAAC;AAEpF;;;;;GAKG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAA4B,EAAE,MAA6B,EAAE,GAAe;IAChG,MAAM,KAAK,GAAa,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC/C,IAAI,KAAK,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7C,gHAAgH;IAChH,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,sGAAsG;IACtG,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QACnG,mFAAmF;QACnF,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,GAAG,cAAc;YAAE,OAAO;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5C,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC5B,0GAA0G;YAC1G,+FAA+F;YAC/F,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBAClD,IAAI,MAAM,KAAK,IAAI;oBAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,SAAS,CAAC;YACR,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5E,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,gFAAgF;gBAChF,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,CAAC,EAAE,CAAC;oBAC7C,QAAQ,GAAG,IAAI,CAAC;oBAChB,KAAK,GAAG,EAAE,CAAC;oBACX,IAAI,GAAG,CAAC,CAAC;gBACX,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAClB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;gBACvB,CAAC;YACH,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,CAAC;gBAAE,OAAO;YAC3B,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,QAAQ,GAAG,KAAK,CAAC;YACjB,KAAK,GAAG,EAAE,CAAC;YACX,IAAI,GAAG,CAAC,CAAC;YACT,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,4GAA4G;QAC5G,qGAAqG;QACrG,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;YAChC,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,iFAAiF;YACjF,IAAI,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/D,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "craftar",
-  "version": "0.28.2",
+  "version": "0.29.0",
   "description": "Craft, sync and convert AI-coding workspace harnesses across clients and tools.",
   "license": "MIT",
   "type": "module",