@chipschat/conformance 0.0.0-stage → 1.0.1

package/dist/project.js

@@ -0,0 +1,254 @@
+/**
+ * A room's project in the fake (ADR 0220): one bare git repository per room, in a folder of the
+ * fake's own, served by git's `http-backend` as the server serves it, behind the harness's token
+ * and the agent it names in `chips-actor`. A push that moves `main` is recorded as
+ * `project.changed`, before git's answer ends, as the server records it.
+ *
+ * It keeps git's own refusals, no rewriting or deleting `main`, and pushes to a room are taken one
+ * at a time. It does not check each push for secrets, sizes or other branches, as the server's
+ * hook does: the SDK makes the same check before it commits (ADR 0221), and that is what a bridge
+ * is tested on. A machine with no git answers 503, in words, as the server does.
+ */
+import { execFile, spawn } from "node:child_process";
+import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { PROJECT_ACTOR_HEADER, PROJECT_BRANCH, PROJECT_CHANGED_FILES } from "@chipschat/protocol";
+/** git told what a room's project may take, through its environment, as the server tells it. */
+const POLICY = [
+    ["receive.denyNonFastForwards", "true"],
+    ["receive.denyDeletes", "true"],
+    ["receive.fsckObjects", "true"],
+    ["http.receivepack", "true"],
+];
+function environment() {
+    const env = {
+        PATH: "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
+        GIT_CONFIG_NOSYSTEM: "1",
+        GIT_CONFIG_GLOBAL: "/dev/null",
+        GIT_CONFIG_COUNT: String(POLICY.length),
+    };
+    POLICY.forEach(([key, value], at) => {
+        env[`GIT_CONFIG_KEY_${at}`] = key;
+        env[`GIT_CONFIG_VALUE_${at}`] = value;
+    });
+    return env;
+}
+function git(args, cwd) {
+    return new Promise((resolve, reject) => {
+        execFile("git", [...args], { cwd, env: environment(), encoding: "utf8" }, (error, stdout) => error === null ? resolve(stdout) : reject(error));
+    });
+}
+function words(response, status, message) {
+    response.writeHead(status, {
+        "content-type": "text/plain; charset=utf-8",
+        ...(status === 401 ? { "www-authenticate": 'Basic realm="Chips"' } : {}),
+    });
+    response.end(`${message}\n`);
+}
+/** A CGI answer's head, `Status:` and its headers to the empty line; nothing until that has come. */
+function cgiHead(bytes) {
+    const end = bytes.indexOf("\r\n\r\n");
+    if (end < 0)
+        return undefined;
+    let status = 200;
+    const headers = {};
+    for (const line of bytes.subarray(0, end).toString("latin1").split("\r\n")) {
+        const colon = line.indexOf(":");
+        if (colon < 0)
+            continue;
+        const name = line.slice(0, colon).trim();
+        const value = line.slice(colon + 1).trim();
+        if (name.toLowerCase() === "status")
+            status = Number.parseInt(value, 10) || 500;
+        else
+            headers[name] = value;
+    }
+    return { status, headers, rest: bytes.subarray(end + 4) };
+}
+export class FakeProjects {
+    workspace;
+    root = mkdtempSync(join(tmpdir(), "chips-fake-projects-"));
+    /** The push going on in each room, which the next one waits for. */
+    pushing = new Map();
+    constructor(workspace) {
+        this.workspace = workspace;
+    }
+    /** One of git's requests to a room's project, from a harness whose token has been checked. */
+    async serve(request, response, asked) {
+        const admitted = this.admit(request, asked);
+        if (typeof admitted !== "string")
+            return words(response, admitted.status, admitted.message);
+        try {
+            await this.ensure(asked.spaceId);
+        }
+        catch {
+            return words(response, 503, "Projects are off on this server: git was not found on this machine.");
+        }
+        if (request.method === "POST" && asked.rest === "/git-receive-pack") {
+            return this.push(request, response, asked, admitted);
+        }
+        return this.backend(request, response, asked, admitted);
+    }
+    /** The agent a request is for, or the words it is refused with. */
+    admit(request, asked) {
+        const method = request.method ?? "GET";
+        const reads = method === "GET" && asked.rest === "/info/refs";
+        const posts = method === "POST" &&
+            (asked.rest === "/git-upload-pack" || asked.rest === "/git-receive-pack");
+        if (!reads && !posts) {
+            return {
+                status: 404,
+                message: "A space's project answers git's smart HTTP, and nothing else.",
+            };
+        }
+        const actor = request.headers[PROJECT_ACTOR_HEADER];
+        const agentId = typeof actor === "string" ? actor : undefined;
+        const refused = this.workspace.refuseOnProject(agentId, asked.spaceId);
+        if (refused !== undefined) {
+            return { status: refused.endsWith("with that id.") ? 404 : 403, message: refused };
+        }
+        return agentId ?? "";
+    }
+    /** A push, in the room's turn, recorded before git's answer ends when it moved `main`. */
+    async push(request, response, asked, agentId) {
+        const release = await this.turnIn(asked.spaceId);
+        try {
+            const before = await this.head(asked.spaceId);
+            await this.backend(request, response, asked, agentId, async () => {
+                const after = await this.head(asked.spaceId);
+                if (after === null || after === before)
+                    return;
+                const change = await this.changes(asked.spaceId, before, after);
+                this.workspace.recordProjectChange(asked.spaceId, agentId, change);
+            });
+        }
+        finally {
+            release();
+        }
+    }
+    close() {
+        rmSync(this.root, { recursive: true, force: true });
+    }
+    directoryOf(spaceId) {
+        if (!/^spc_[0-9A-Z]{26}$/.test(spaceId))
+            throw new Error(`not a space: ${spaceId}`);
+        return join(this.root, `${spaceId}.git`);
+    }
+    async ensure(spaceId) {
+        const directory = this.directoryOf(spaceId);
+        if (existsSync(join(directory, "HEAD")))
+            return;
+        await git([
+            "init",
+            "--quiet",
+            "--bare",
+            "--template=",
+            `--initial-branch=${PROJECT_BRANCH}`,
+            directory,
+        ]);
+    }
+    async head(spaceId) {
+        try {
+            return ((await git(["rev-parse", "--verify", "--quiet", `refs/heads/${PROJECT_BRANCH}`], this.directoryOf(spaceId))).trim() || null);
+        }
+        catch {
+            return null;
+        }
+    }
+    async changes(spaceId, before, after) {
+        const directory = this.directoryOf(spaceId);
+        const from = before ?? (await git(["hash-object", "-t", "tree", "/dev/null"], directory)).trim();
+        const range = before === null ? [after] : [after, `^${before}`];
+        const count = await git(["rev-list", "--count", ...range], directory);
+        const subject = await git(["log", "-1", "--format=%s", after], directory);
+        const files = (await git(["diff", "--numstat", "-z", "--no-renames", from, after], directory))
+            .split("\0")
+            .filter((entry) => entry !== "")
+            .map((entry) => {
+            const [added = "-", removed = "-", ...path] = entry.split("\t");
+            return {
+                path: path.join("\t"),
+                added: added === "-" ? null : Number(added),
+                removed: removed === "-" ? null : Number(removed),
+            };
+        })
+            .sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+        return {
+            before,
+            after,
+            commits: Number(count.trim()),
+            message: subject.trim().slice(0, 300),
+            files: files.slice(0, PROJECT_CHANGED_FILES),
+            ...(files.length > PROJECT_CHANGED_FILES
+                ? { more_files: files.length - PROJECT_CHANGED_FILES }
+                : {}),
+        };
+    }
+    async turnIn(spaceId) {
+        const before = this.pushing.get(spaceId) ?? Promise.resolve();
+        let release = () => { };
+        const mine = new Promise((resolve) => {
+            release = resolve;
+        });
+        const chained = before.then(() => mine);
+        this.pushing.set(spaceId, chained);
+        await before;
+        return () => {
+            release();
+            if (this.pushing.get(spaceId) === chained)
+                this.pushing.delete(spaceId);
+        };
+    }
+    /** git's answer, streamed back; `after` runs once git is done, before the answer ends. */
+    backend(request, response, asked, who, after) {
+        return new Promise((resolve) => {
+            const child = spawn("git", ["http-backend"], {
+                env: {
+                    ...environment(),
+                    GIT_PROJECT_ROOT: this.root,
+                    GIT_HTTP_EXPORT_ALL: "1",
+                    REMOTE_USER: who,
+                    REQUEST_METHOD: request.method ?? "GET",
+                    PATH_INFO: `/${asked.spaceId}.git${asked.rest}`,
+                    QUERY_STRING: asked.query,
+                    CONTENT_TYPE: request.headers["content-type"] ?? "",
+                    HTTP_CONTENT_ENCODING: request.headers["content-encoding"] ?? "",
+                    GIT_PROTOCOL: String(request.headers["git-protocol"] ?? ""),
+                },
+            });
+            request.pipe(child.stdin);
+            child.stdin.on("error", () => child.kill());
+            let head = Buffer.alloc(0);
+            let answered = false;
+            const held = [];
+            child.stdout.on("data", (chunk) => {
+                if (answered) {
+                    held.push(chunk);
+                    return;
+                }
+                head = Buffer.concat([head, chunk]);
+                const parsed = cgiHead(head);
+                if (parsed === undefined)
+                    return;
+                answered = true;
+                response.writeHead(parsed.status, parsed.headers);
+                held.push(parsed.rest);
+            });
+            child.on("close", () => {
+                void (async () => {
+                    if (!answered) {
+                        words(response, 500, "git could not answer for this project.");
+                        resolve();
+                        return;
+                    }
+                    // Written once git is done, the record first: what the answer says has been recorded.
+                    await after?.().catch(() => undefined);
+                    response.end(Buffer.concat(held));
+                    resolve();
+                })();
+            });
+        });
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGlG,gGAAgG;AAChG,MAAM,MAAM,GAA2C;IACrD,CAAC,6BAA6B,EAAE,MAAM,CAAC;IACvC,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAC/B,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAC/B,CAAC,kBAAkB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,SAAS,WAAW;IAClB,MAAM,GAAG,GAA2B;QAClC,IAAI,EAAE,gDAAgD;QACtD,mBAAmB,EAAE,GAAG;QACxB,iBAAiB,EAAE,WAAW;QAC9B,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;KACxC,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE;QAClC,GAAG,CAAC,kBAAkB,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;QAClC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,GAAG,CAAC,IAAuB,EAAE,GAAY;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAC1F,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACjD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,QAAwB,EAAE,MAAc,EAAE,OAAe;IACtE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;QACzB,cAAc,EAAE,2BAA2B;QAC3C,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,qGAAqG;AACrG,SAAS,OAAO,CACd,KAAa;IAEb,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ;YAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;;YAC3E,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,OAAO,YAAY;IAKM;IAJZ,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAC5E,oEAAoE;IACnD,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE5D,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,8FAA8F;IAC9F,KAAK,CAAC,KAAK,CACT,OAAwB,EACxB,QAAwB,EACxB,KAAkF;QAElF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5F,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CACV,QAAQ,EACR,GAAG,EACH,qEAAqE,CACtE,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,mEAAmE;IAC3D,KAAK,CACX,OAAwB,EACxB,KAA0D;QAE1D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;QAC9D,MAAM,KAAK,GACT,MAAM,KAAK,MAAM;YACjB,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;gBACL,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,+DAA+D;aACzE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACrF,CAAC;QACD,OAAO,OAAO,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,0FAA0F;IAClF,KAAK,CAAC,IAAI,CAChB,OAAwB,EACxB,QAAwB,EACxB,KAAkF,EAClF,OAAe;QAEf,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;gBAC/D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM;oBAAE,OAAO;gBAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;gBAChE,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACrE,CAAC,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK;QACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAEO,WAAW,CAAC,OAAe;QACjC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,MAAM,CAAC,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAe;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO;QAChD,MAAM,GAAG,CAAC;YACR,MAAM;YACN,SAAS;YACT,QAAQ;YACR,aAAa;YACb,oBAAoB,cAAc,EAAE;YACpC,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,OAAe;QAChC,IAAI,CAAC;YACH,OAAO,CACL,CACE,MAAM,GAAG,CACP,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,cAAc,EAAE,CAAC,EACpE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAC1B,CACF,CAAC,IAAI,EAAE,IAAI,IAAI,CACjB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,OAAe,EACf,MAAqB,EACrB,KAAa;QAEb,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,IAAI,GACR,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtF,MAAM,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;aAC3F,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;aAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChE,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrB,KAAK,EAAE,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC3C,OAAO,EAAE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;aAClD,CAAC;QACJ,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO;YACL,MAAM;YACN,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YACrC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC;YAC5C,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,qBAAqB;gBACtC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,qBAAqB,EAAE;gBACtD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAe;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACzC,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,MAAM,CAAC;QACb,OAAO,GAAG,EAAE;YACV,OAAO,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1E,CAAC,CAAC;IACJ,CAAC;IAED,0FAA0F;IAClF,OAAO,CACb,OAAwB,EACxB,QAAwB,EACxB,KAAkF,EAClF,GAAW,EACX,KAA2B;QAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,cAAc,CAAC,EAAE;gBAC3C,GAAG,EAAE;oBACH,GAAG,WAAW,EAAE;oBAChB,gBAAgB,EAAE,IAAI,CAAC,IAAI;oBAC3B,mBAAmB,EAAE,GAAG;oBACxB,WAAW,EAAE,GAAG;oBAChB,cAAc,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;oBACvC,SAAS,EAAE,IAAI,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,IAAI,EAAE;oBAC/C,YAAY,EAAE,KAAK,CAAC,KAAK;oBACzB,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE;oBACnD,qBAAqB,EAAE,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE;oBAChE,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;iBAC5D;aACF,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5C,IAAI,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACjB,OAAO;gBACT,CAAC;gBACD,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBACpC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC7B,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO;gBACjC,QAAQ,GAAG,IAAI,CAAC;gBAChB,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAClD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACrB,KAAK,CAAC,KAAK,IAAI,EAAE;oBACf,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACd,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,wCAAwC,CAAC,CAAC;wBAC/D,OAAO,EAAE,CAAC;wBACV,OAAO;oBACT,CAAC;oBACD,sFAAsF;oBACtF,MAAM,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBACvC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;oBAClC,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/report.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The report: the connection checklist the app shows, lit by what the harness sent, and the
+ * notes underneath it. The rows are the protocol's own list, so `chips conformance` and the
+ * Harnesses tab cannot disagree about what an adapter has earned.
+ *
+ * Passing means the rows the plan's M2.5 names — and the two a run cannot do without. Messages,
+ * Runs, Steps, Approvals, Cost and Finished must be lit, and nothing the harness sent may have
+ * been refused. Questions and Context are reported and not required: a harness with no
+ * questions to ask and no window size to report is complete without them.
+ */
+export interface RowResult {
+    readonly label: string;
+    readonly types: readonly string[];
+    readonly gives: string;
+    readonly lit: boolean;
+    /** How many events of the row's types the harness sent. */
+    readonly count: number;
+    readonly required: boolean;
+}
+export type Severity = "error" | "warn" | "note";
+export interface Finding {
+    readonly severity: Severity;
+    readonly message: string;
+}
+/** What became of a capability the harness declared: its check passed or failed, or none sees it. */
+export type Outcome = "passed" | "failed" | "declared";
+export interface CapabilityResult {
+    readonly capability: string;
+    readonly outcome: Outcome;
+}
+/**
+ * How far the harness got, by the plan's four levels (open-source harnesses plan, §2): it talks,
+ * it is supervised, it lives in Chips, it is managed from Chips. The first two are rows of the
+ * checklist; the last two count the capabilities whose checks passed, or that no check can see.
+ */
+export interface LevelResult {
+    readonly label: string;
+    readonly has: number;
+    readonly of: number;
+    /** For the two levels made of capabilities: each one the harness declared, and how it did. */
+    readonly capabilities?: readonly CapabilityResult[];
+}
+export interface Report {
+    readonly adapter: string;
+    readonly rows: readonly RowResult[];
+    readonly levels: readonly LevelResult[];
+    readonly findings: readonly Finding[];
+    /** How many events the harness sent that the log took. */
+    readonly events: number;
+    readonly durationMs: number;
+    readonly passed: boolean;
+}
+export declare const REQUIRED_ROWS: ReadonlySet<string>;
+/** The rows, lit by the types the harness sent. */
+export declare function rowsOf(sent: readonly string[]): RowResult[];
+/** The capabilities each of the upper two levels is made of, in the order the report says them. */
+export declare const LEVEL_CAPABILITIES: Readonly<Record<string, readonly string[]>>;
+/** The four levels, from the rows lit and what became of each capability declared. */
+export declare function levelsOf(rows: readonly RowResult[], outcomes: ReadonlyMap<string, Outcome>): LevelResult[];
+export declare function passes(rows: readonly RowResult[], findings: readonly Finding[]): boolean;
+/** The reference page for an event type: the one an unlit row in the app links to. */
+export declare function docsFor(type: string): string;
+/** The report as lines, ready for a console. */
+export declare function formatReport(report: Report): string[];
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qGAAqG;AACrG,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAO5C,CAAC;AAEH,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,CAY3D;AAED,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAiB1E,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,SAAS,EAAE,EAC1B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,WAAW,EAAE,CAcf;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAKxF;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AA+CD,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBrD"}

package/dist/report.js

@@ -0,0 +1,142 @@
+/**
+ * The report: the connection checklist the app shows, lit by what the harness sent, and the
+ * notes underneath it. The rows are the protocol's own list, so `chips conformance` and the
+ * Harnesses tab cannot disagree about what an adapter has earned.
+ *
+ * Passing means the rows the plan's M2.5 names — and the two a run cannot do without. Messages,
+ * Runs, Steps, Approvals, Cost and Finished must be lit, and nothing the harness sent may have
+ * been refused. Questions and Context are reported and not required: a harness with no
+ * questions to ask and no window size to report is complete without them.
+ */
+import { CONNECTION_CHECKLIST, HARNESS_CAPABILITIES } from "@chipschat/protocol";
+export const REQUIRED_ROWS = new Set([
+    "Messages",
+    "Runs",
+    "Steps",
+    "Approvals",
+    "Cost",
+    "Finished",
+]);
+/** The rows, lit by the types the harness sent. */
+export function rowsOf(sent) {
+    return CONNECTION_CHECKLIST.map((row) => {
+        const count = sent.filter((type) => row.types.includes(type)).length;
+        return {
+            label: row.label,
+            types: row.types,
+            gives: row.gives,
+            lit: count > 0,
+            count,
+            required: REQUIRED_ROWS.has(row.label),
+        };
+    });
+}
+/** The capabilities each of the upper two levels is made of, in the order the report says them. */
+export const LEVEL_CAPABILITIES = {
+    "Lives in Chips": [
+        HARNESS_CAPABILITIES.agents,
+        HARNESS_CAPABILITIES.newSpaces,
+        HARNESS_CAPABILITIES.forks,
+        HARNESS_CAPABILITIES.newAgents,
+        HARNESS_CAPABILITIES.followsRooms,
+        HARNESS_CAPABILITIES.restarts,
+    ],
+    "Managed from Chips": [
+        HARNESS_CAPABILITIES.contextFiles,
+        HARNESS_CAPABILITIES.models,
+        HARNESS_CAPABILITIES.heartbeats,
+        HARNESS_CAPABILITIES.contextWindows,
+        HARNESS_CAPABILITIES.jobs,
+        HARNESS_CAPABILITIES.autonomy,
+    ],
+};
+/** The four levels, from the rows lit and what became of each capability declared. */
+export function levelsOf(rows, outcomes) {
+    const lit = (label) => rows.some((row) => row.label === label && row.lit);
+    const supervised = rows.every((row) => row.lit || !row.required);
+    return [
+        { label: "Talks", has: lit("Messages") ? 1 : 0, of: 1 },
+        { label: "Supervised", has: supervised ? 1 : 0, of: 1 },
+        ...Object.entries(LEVEL_CAPABILITIES).map(([label, all]) => {
+            const capabilities = all
+                .filter((capability) => outcomes.has(capability))
+                .map((capability) => ({ capability, outcome: outcomes.get(capability) ?? "failed" }));
+            const has = capabilities.filter((each) => each.outcome !== "failed").length;
+            return { label, has, of: all.length, capabilities };
+        }),
+    ];
+}
+export function passes(rows, findings) {
+    return (rows.every((row) => row.lit || !row.required) &&
+        findings.every((finding) => finding.severity !== "error"));
+}
+/** The reference page for an event type: the one an unlit row in the app links to. */
+export function docsFor(type) {
+    return `https://chipschat.ai/reference/events/${type.replace(/\./g, "-")}/`;
+}
+const MARK = { error: "x", warn: "!", note: "·" };
+/** One row, as the app draws it: a mark, the label, and what was sent or what to send. */
+function rowLine(row, width) {
+    const mark = row.lit ? "●" : "○";
+    const first = row.types[0] ?? "";
+    const times = row.count > 1 ? ` ×${row.count}` : "";
+    const detail = row.lit ? `sent ${first}${times}` : `send ${first} for ${row.gives}`;
+    return `    ${mark} ${row.label.padEnd(width)}   ${detail}`;
+}
+/** What is missing, in a sentence. */
+function verdict(report) {
+    if (report.passed)
+        return "  Passed. Every required row is lit and nothing was refused.";
+    const dark = report.rows.filter((row) => row.required && !row.lit).map((row) => row.label);
+    const errors = report.findings.filter((finding) => finding.severity === "error").length;
+    const parts = [
+        ...(dark.length === 0 ? [] : [`${listOf(dark)} ${dark.length === 1 ? "is" : "are"} not lit`]),
+        ...(errors === 0 ? [] : [`${errors} thing${errors === 1 ? "" : "s"} to fix below`]),
+    ];
+    return `  Not passed: ${parts.join("; ")}.`;
+}
+function listOf(words) {
+    if (words.length <= 1)
+        return words.join("");
+    return `${words.slice(0, -1).join(", ")} and ${words.at(-1)}`;
+}
+const MARKS = {
+    passed: "✓",
+    failed: "✗",
+    declared: "· not checked",
+};
+/** A level as one line: lit or not for the first two, a count and each capability for the rest. */
+function levelLine(level, width) {
+    if (level.capabilities === undefined)
+        return `    ${level.has === 1 ? "●" : "○"} ${level.label}`;
+    const label = level.label.padEnd(width);
+    const each = level.capabilities
+        .map(({ capability, outcome }) => `${capability.replace(/_/g, " ")} ${MARKS[outcome]}`)
+        .join(", ");
+    const mark = level.has === level.of ? "●" : level.has > 0 ? "◐" : "○";
+    return `    ${mark} ${label}   ${level.has} of ${level.of}${each === "" ? "" : `: ${each}`}`;
+}
+/** The report as lines, ready for a console. */
+export function formatReport(report) {
+    const width = Math.max(...report.rows.map((row) => row.label.length));
+    const lines = report.rows.map((row) => rowLine(row, width));
+    const levelWidth = Math.max(...report.levels.map((level) => level.label.length));
+    lines.push("", ...report.levels.map((level) => levelLine(level, levelWidth)));
+    lines.push("");
+    lines.push(`    ${report.events} event${report.events === 1 ? "" : "s"} in ${(report.durationMs / 1000).toFixed(1)} s`);
+    if (report.findings.length > 0) {
+        lines.push("", "  Notes");
+        for (const finding of report.findings) {
+            lines.push(`    ${MARK[finding.severity]} ${finding.message}`);
+        }
+    }
+    const unlit = report.rows.filter((row) => !row.lit);
+    if (unlit.length > 0) {
+        lines.push("", "  Each unlit row links to the page that lights it:");
+        for (const row of unlit)
+            lines.push(`    ${row.label.padEnd(width)}   ${docsFor(row.types[0] ?? "")}`);
+    }
+    lines.push("", verdict(report));
+    return lines;
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/room-files.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The room's files (ADR 0099), as the fake plays them: the real server's reads and door over the
+ * fake's log rather than its projections. The files posted in a room, in order, none from a message
+ * taken back; what each file of a post was made from, copied onto it from the post's `replaces`;
+ * and the refusal of one made from a version no longer current. Which file is which version, and
+ * the refusal's words, are the protocol's, so the two cannot differ.
+ */
+import { type PostedFile, type RoomFile, type StaleRefusal } from "@chipschat/protocol";
+/** An event as the fake's log holds it, as far as these reads need it (the workspace's own). */
+interface StoredEvent {
+    readonly seq: number;
+    readonly id: string;
+    readonly type: string;
+    readonly ts: string;
+    readonly space_id: string | null;
+    readonly actor: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    readonly payload: Readonly<Record<string, unknown>>;
+}
+/** The files posted in a room, oldest first, up to the event at `upto` and with it. */
+export declare function postedFilesInLog(log: readonly StoredEvent[], spaceId: string, upto?: number): PostedFile[];
+/** How a room's files are read out: for whom, how many, and who each was posted by now. */
+interface Reading {
+    readonly spaceId: string;
+    readonly most: number;
+    /** Who a participant is now, as a line's `from` says it. */
+    readonly by: (participantId: string) => RoomFile["by"];
+    readonly sign?: ((attachmentId: string) => {
+        url: string;
+        url_expires_at: string;
+    }) | undefined;
+}
+/** A room's files at their current version, newest first, as the real server hands them over. */
+export declare function roomFilesInLog(log: readonly StoredEvent[], room: Reading & {
+    readonly upto?: number | undefined;
+}): RoomFile[];
+/** One name's versions, newest first, each with what it was made from (ADR 0100). */
+export declare function fileVersionsInLog(log: readonly StoredEvent[], room: Reading & {
+    readonly name: string;
+}): RoomFile[];
+/**
+ * The real door's `fillMadeFrom` and the store's `fileGate`, at once, since the fake has one writer
+ * and nothing between them: each file's `replaces` copied onto it when it names a version of that
+ * file in this room, the map not kept; a key that is none of the post's files refused; a file made
+ * from a version no longer current refused `stale_file`.
+ */
+export declare function madeFromInLog(log: readonly StoredEvent[], event: Record<string, unknown>, nameOf: (participantId: string) => string): {
+    kind: "invalid";
+    message: string;
+} | StaleRefusal | undefined;
+export {};
+//# sourceMappingURL=room-files.d.ts.map

package/dist/room-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-files.d.ts","sourceRoot":"","sources":["../src/room-files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EAKlB,MAAM,qBAAqB,CAAC;AAE7B,gGAAgG;AAChG,UAAU,WAAW;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAYD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,WAAW,EAAE,EAC3B,OAAO,EAAE,MAAM,EACf,IAAI,SAA2B,GAC9B,UAAU,EAAE,CAuBd;AAcD,2FAA2F;AAC3F,UAAU,OAAO;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CACjG;AAsBD,iGAAiG;AACjG,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,WAAW,EAAE,EAC3B,IAAI,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrD,QAAQ,EAAE,CAGZ;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,WAAW,EAAE,EAC3B,IAAI,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC,QAAQ,EAAE,CAaZ;AAkBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,WAAW,EAAE,EAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,GACxC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,GAAG,SAAS,CAkCjE"}