@nickmeriano/task 0.11.0 → 0.12.0

package/dist/board/source.js

@@ -0,0 +1,333 @@
+/**
+ * A repository, read as boards.
+ *
+ * This is `findBoards` + `FileStore`, re-expressed against a git tree instead
+ * of a filesystem, and producing byte-identical API payloads. That
+ * equivalence is the whole point: the hosted board and an exported board's
+ * live proxy run the *same* SPA as `task serve`, so anything that differs
+ * here shows up as a broken screen rather than a type error. The shapes below
+ * are pinned to `server.ts` — change one and change both — and the ticket
+ * format itself is not restated: parsing comes from `ticket-doc.ts`, the one
+ * definition every server shares, in its lenient mode (a hand-edited file
+ * that no longer parses becomes a degraded ticket or a skipped comment, never
+ * a broken board).
+ *
+ * Read-only by construction. There is no code here that could write, which is
+ * how "the board can't edit your repo" stays true no matter what the routing
+ * layer does.
+ *
+ * Cache-free on purpose. A snapshot is immutable per commit, so *where* to
+ * keep one is a deployment question — the hosted worker layers isolate memory
+ * and KV over `snapshotAt`, the live proxy keeps a bounded `SnapshotMemory` —
+ * and this module answers only "what is at this commit".
+ */
+import { parseAskLenient, parseCommentLenient, parseGoalLenient, parseTicketLenient, } from "../ticket-doc.js";
+import { isTicketKey } from "../id.js";
+import { fetchRepoArchive, headCommit } from "./github.js";
+export { STATUSES } from "../types.js";
+const TASK_DIR = ".task";
+const CONFIG_FILE = "config.json";
+const TICKETS_DIR = "tickets";
+const TICKET_FILE = "ticket.md";
+const COMMENTS_DIR = "comments";
+const ASKS_DIR = "asks";
+const GOALS_DIR = "goals";
+/** Same ceiling as the CLI's `findBoards`, for the same reason. */
+const MAX_DEPTH = 6;
+export class BoardSourceError extends Error {
+    status;
+    /**
+     * Machine-readable cause, sent beside the message so the SPA can choose a
+     * screen rather than infer one from a status code. Optional: most of these
+     * are one of a kind and the message is the whole story.
+     */
+    reason;
+    constructor(status, message, reason = null) {
+        super(message);
+        this.name = "BoardSourceError";
+        this.status = status;
+        this.reason = reason;
+    }
+}
+function str(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function num(value, fallback = 0) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+/** `.task/config.json`, defensively — it's a file anyone can hand-edit. */
+function parseConfig(bytes, fallbackName) {
+    try {
+        const parsed = JSON.parse(new TextDecoder().decode(bytes));
+        if (parsed && typeof parsed === "object") {
+            const config = parsed;
+            return {
+                name: str(config.name, fallbackName),
+                prefix: str(config.prefix, "TASK").toUpperCase(),
+                version: num(config.version, 1),
+            };
+        }
+    }
+    catch {
+        // fall through
+    }
+    return { name: fallbackName, prefix: "TASK", version: 1 };
+}
+/**
+ * Board directories, from a flat list of repo paths.
+ *
+ * The CLI finds a board by the presence of `.task/config.json`; so does this.
+ * Depth is capped the same way, and the ordering — "." first, then
+ * lexicographic — is copied so the default board is the same one you'd get
+ * locally.
+ */
+export function findBoardDirs(paths) {
+    const marker = `${TASK_DIR}/${CONFIG_FILE}`;
+    const dirs = [];
+    for (const path of paths) {
+        // The directory has to be `.task` itself, not merely end in it — a bare
+        // suffix match would read `x.task/config.json` as a board at `x`.
+        if (path !== marker && !path.endsWith(`/${marker}`))
+            continue;
+        const dir = path.slice(0, -(TASK_DIR.length + CONFIG_FILE.length + 2));
+        const id = dir === "" ? "." : dir.replace(/\/$/, "");
+        if (id !== "." && id.split("/").length > MAX_DEPTH)
+            continue;
+        dirs.push(id);
+    }
+    dirs.sort((a, b) => (a === "." ? -1 : b === "." ? 1 : a < b ? -1 : 1));
+    return dirs;
+}
+/** `projects/phone/web` → "phone web"-ish fallback name, matching `task init`. */
+function nameFromDir(id) {
+    if (id === ".")
+        return "tasks";
+    return id.split("/").pop() ?? "tasks";
+}
+/**
+ * One board from its ticket files. `files` is keyed by path relative to the
+ * board's `.task/` — `tickets/12/ticket.md`, `tickets/12/comments/<stem>.md` —
+ * which is how `snapshotAt` fetches them and how the test feeds them from
+ * disk.
+ */
+export function readTicketsBoard(id, configBytes, files) {
+    const config = parseConfig(configBytes, nameFromDir(id));
+    const decoder = new TextDecoder();
+    const docs = new Map();
+    const comments = new Map();
+    const asks = new Map();
+    const goals = [];
+    for (const [path, bytes] of files) {
+        // Goals: one file per goal, archived ones one level down. Old branches
+        // simply have no goals/ — the list stays empty and every reader tolerates
+        // a ticket's goal ref not resolving.
+        const goalMatch = new RegExp(`^${GOALS_DIR}/(archive/)?([^/]+)\\.md$`).exec(path);
+        if (goalMatch) {
+            if (goalMatch[2].startsWith("."))
+                continue;
+            const doc = parseGoalLenient(decoder.decode(bytes));
+            if (doc) {
+                goals.push({
+                    slug: goalMatch[2],
+                    title: doc.title,
+                    description: doc.description,
+                    createdAt: doc.createdAt,
+                    updatedAt: doc.updatedAt,
+                    ...(goalMatch[1] ? { archived: true } : {}),
+                });
+            }
+            continue;
+        }
+        const ticketMatch = new RegExp(`^${TICKETS_DIR}/([^/]+)/${TICKET_FILE}$`).exec(path);
+        if (ticketMatch && isTicketKey(ticketMatch[1])) {
+            const doc = parseTicketLenient(decoder.decode(bytes));
+            if (doc)
+                docs.set(ticketMatch[1], doc);
+            continue;
+        }
+        const commentMatch = new RegExp(`^${TICKETS_DIR}/([^/]+)/${COMMENTS_DIR}/([^/]+)\\.md$`).exec(path);
+        if (commentMatch && isTicketKey(commentMatch[1]) && !commentMatch[2].startsWith(".")) {
+            const doc = parseCommentLenient(decoder.decode(bytes));
+            if (!doc)
+                continue;
+            const taskKey = commentMatch[1];
+            const list = comments.get(taskKey) ?? [];
+            list.push({
+                id: commentMatch[2],
+                taskId: `${config.prefix}-${taskKey}`,
+                author: doc.author,
+                body: doc.body,
+                createdAt: doc.createdAt,
+            });
+            comments.set(taskKey, list);
+            continue;
+        }
+        const askMatch = new RegExp(`^${TICKETS_DIR}/([^/]+)/${ASKS_DIR}/([^/]+)\\.md$`).exec(path);
+        if (askMatch && isTicketKey(askMatch[1]) && !askMatch[2].startsWith(".")) {
+            const doc = parseAskLenient(decoder.decode(bytes));
+            if (!doc)
+                continue;
+            const taskKey = askMatch[1];
+            const list = asks.get(taskKey) ?? [];
+            // Ordinal assigned after the sort below — 0 is a placeholder.
+            list.push({
+                id: askMatch[2],
+                taskId: `${config.prefix}-${taskKey}`,
+                ordinal: 0,
+                text: doc.body,
+                author: doc.author,
+                createdAt: doc.createdAt,
+                resolvedAt: doc.resolvedAt,
+                resolvedBy: doc.resolvedBy,
+            });
+            asks.set(taskKey, list);
+        }
+    }
+    // Comments whose ticket file is missing or unreadable would count against a
+    // ticket that isn't drawn — drop them, and order the rest the CLI's way.
+    for (const taskKey of comments.keys()) {
+        if (!docs.has(taskKey))
+            comments.delete(taskKey);
+    }
+    for (const list of comments.values()) {
+        list.sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+    }
+    // Asks: same orphan rule, and ordinals are creation-order positions — the
+    // exact numbering the CLI's `asks()` derives.
+    for (const taskKey of asks.keys()) {
+        if (!docs.has(taskKey))
+            asks.delete(taskKey);
+    }
+    for (const list of asks.values()) {
+        list.sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+        list.forEach((ask, index) => (ask.ordinal = index + 1));
+    }
+    // `blocks` is derived from the other tickets' stored `blocked_by` — the
+    // relation lives on one side only, so the two views can't disagree.
+    const blocks = new Map();
+    for (const [key, doc] of docs) {
+        for (const blocker of doc.blockedBy) {
+            blocks.set(blocker, [...(blocks.get(blocker) ?? []), key]);
+        }
+    }
+    for (const list of blocks.values())
+        list.sort((a, b) => a.localeCompare(b));
+    const tasks = [...docs.entries()]
+        .map(([key, doc]) => ({
+        id: `${config.prefix}-${key}`,
+        key,
+        title: doc.title,
+        description: doc.description,
+        status: doc.status,
+        tags: doc.tags,
+        goal: doc.goal,
+        needsHuman: (asks.get(key) ?? []).some((a) => !a.resolvedAt),
+        asks: asks.get(key) ?? [],
+        blocks: blocks.get(key) ?? [],
+        blockedBy: doc.blockedBy,
+        prs: doc.prs,
+        position: doc.position,
+        createdAt: doc.createdAt,
+        updatedAt: doc.updatedAt,
+        commentCount: comments.get(key)?.length ?? 0,
+    }))
+        .sort((a, b) => a.position - b.position ||
+        a.createdAt.localeCompare(b.createdAt) ||
+        a.key.localeCompare(b.key));
+    goals.sort((a, b) => Number(a.archived === true) - Number(b.archived === true) || a.slug.localeCompare(b.slug));
+    return { info: { id, name: config.name, prefix: config.prefix }, tasks, comments, goals };
+}
+/**
+ * Every board in a repository at a known commit, ready to serve.
+ *
+ * One request for the whole repository: every path, plus bytes for anything
+ * under a .task/ directory. (Earlier shapes — a tree listing plus per-file or
+ * batched blob reads — scaled subrequests with board size and tripped
+ * Workers' 50-subrequest ceiling; a tarball is one request regardless.)
+ *
+ * `ref` is only for the error message: told a branch, "this repository has
+ * no .task directory" is both wrong and confusing — the repository plainly
+ * has one, you were just looking at it — and `task init` is not the fix for
+ * previewing a branch that forked before the boards existed.
+ */
+export async function snapshotAt(token, owner, repo, commit, ref = "HEAD") {
+    const { paths, files } = await fetchRepoArchive(token, owner, repo, commit.sha, (path) => path.startsWith(`${TASK_DIR}/`) || path.includes(`/${TASK_DIR}/`));
+    const dirs = findBoardDirs(paths);
+    if (dirs.length === 0) {
+        throw new BoardSourceError(404, ref === "HEAD"
+            ? "no .task directory in this repository — run `task init` and commit it"
+            : `no .task directory on ${ref}`, "no-boards");
+    }
+    const data = new Map();
+    for (const id of dirs) {
+        const base = id === "." ? TASK_DIR : `${id}/${TASK_DIR}`;
+        const configBytes = files.get(`${base}/${CONFIG_FILE}`);
+        if (!configBytes)
+            continue;
+        const prefix = `${base}/`;
+        const ticketPaths = paths.filter((path) => (path.startsWith(`${prefix}${TICKETS_DIR}/`) || path.startsWith(`${prefix}${GOALS_DIR}/`)) &&
+            path.endsWith(".md"));
+        // A config with no committed tickets can be two very different things: a
+        // real (empty) text board, or a pre-0.6 board whose state is a SQLite
+        // database this app no longer reads. The config's version says which —
+        // skip the legacy one rather than render an empty board that lies.
+        if (ticketPaths.length === 0 && parseConfig(configBytes, "").version < 2)
+            continue;
+        const tickets = new Map();
+        for (const path of ticketPaths) {
+            const bytes = files.get(path);
+            if (bytes)
+                tickets.set(path.slice(prefix.length), bytes);
+        }
+        const board = readTicketsBoard(id, configBytes, tickets);
+        data.set(board.info.id, board);
+    }
+    if (data.size === 0) {
+        throw new BoardSourceError(404, "found .task/config.json but no committed tickets — are .task/tickets/ gitignored, or is this a pre-0.6 SQLite board that still needs `task migrate` (@nickmeriano/task@0.6)?");
+    }
+    return {
+        commit,
+        boards: [...data.values()].map((board) => board.info),
+        data,
+        truncated: false,
+    };
+}
+/**
+ * Every board at `ref`, cache-free: "what is HEAD" plus one tarball. Callers
+ * that serve more than one view put a cache between the two — see
+ * `SnapshotMemory` — because the second request is the expensive one and a
+ * commit never changes.
+ */
+export async function loadSnapshot(token, owner, repo, ref) {
+    const commit = await headCommit(token, owner, repo, ref);
+    return snapshotAt(token, owner, repo, commit, ref);
+}
+/**
+ * Parsed snapshots, keyed by `owner/repo@sha`, bounded.
+ *
+ * A commit is immutable, so this never serves anything stale: the only lookup
+ * that goes to GitHub on a warm instance is "what is HEAD right now", and a
+ * new commit is a new key. Bounded because an isolate's memory is not ours to
+ * fill; `Map` iterates in insertion order, so the first key is the oldest.
+ */
+export class SnapshotMemory {
+    snapshots = new Map();
+    max;
+    constructor(max = 24) {
+        this.max = max;
+    }
+    get(key) {
+        return this.snapshots.get(key);
+    }
+    remember(key, snapshot) {
+        this.snapshots.set(key, snapshot);
+        while (this.snapshots.size > this.max) {
+            const oldest = this.snapshots.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.snapshots.delete(oldest);
+        }
+        return snapshot;
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/board/source.js.map

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

package/dist/board/source.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The hosted board and an exported board's live proxy serve the same SPA as
+ * `task serve`, so their payloads have to be the same payloads — not
+ * "compatible", the same. This diffs them against the CLI's own `FileStore`.
+ *
+ * That is the test that actually protects the design: if someone adds a field
+ * to the CLI's `toTask` and not here, the hosted board silently loses it, and
+ * the only symptom is a piece of the UI that renders blank for one deployment
+ * and not the other.
+ */
+export {};
+//# sourceMappingURL=source.test.d.ts.map

package/dist/board/source.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.test.d.ts","sourceRoot":"","sources":["../../src/board/source.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/board/source.test.js

@@ -0,0 +1,165 @@
+/**
+ * The hosted board and an exported board's live proxy serve the same SPA as
+ * `task serve`, so their payloads have to be the same payloads — not
+ * "compatible", the same. This diffs them against the CLI's own `FileStore`.
+ *
+ * That is the test that actually protects the design: if someone adds a field
+ * to the CLI's `toTask` and not here, the hosted board silently loses it, and
+ * the only symptom is a piece of the UI that renders blank for one deployment
+ * and not the other.
+ */
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { join } from "node:path";
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { FileStore, initProject } from "../file-store.js";
+import { findBoardDirs, readTicketsBoard } from "./source.js";
+const REPO_ROOT = fileURLToPath(new URL("../../../../..", import.meta.url));
+/** Every board this repo actually commits, as `findBoards` would order them. */
+const BOARDS = [".", "projects/inspo", "projects/phone/web", "projects/portal", "projects/task/cli"];
+function tempRoot() {
+    const dir = mkdtempSync(join(tmpdir(), "board-source-test-"));
+    process.on("exit", () => rmSync(dir, { recursive: true, force: true }));
+    return dir;
+}
+/** A board's `.task/` read off disk into the path→bytes map the worker sees. */
+function ticketFiles(taskDir) {
+    const files = new Map();
+    for (const dir of ["goals", "goals/archive"]) {
+        const goalsDir = join(taskDir, dir);
+        if (!existsSync(goalsDir))
+            continue;
+        for (const entry of readdirSync(goalsDir, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
+                continue;
+            files.set(`${dir}/${entry.name}`, new Uint8Array(readFileSync(join(goalsDir, entry.name))));
+        }
+    }
+    const ticketsDir = join(taskDir, "tickets");
+    if (!existsSync(ticketsDir))
+        return files;
+    for (const number of readdirSync(ticketsDir)) {
+        const ticket = join(ticketsDir, number, "ticket.md");
+        if (existsSync(ticket)) {
+            files.set(`tickets/${number}/ticket.md`, new Uint8Array(readFileSync(ticket)));
+        }
+        for (const kind of ["comments", "asks"]) {
+            const dir = join(ticketsDir, number, kind);
+            if (!existsSync(dir))
+                continue;
+            for (const entry of readdirSync(dir)) {
+                files.set(`tickets/${number}/${kind}/${entry}`, new Uint8Array(readFileSync(join(dir, entry))));
+            }
+        }
+    }
+    return files;
+}
+function loadTicketsBoard(id, root) {
+    const taskDir = join(root, ".task");
+    return readTicketsBoard(id, new Uint8Array(readFileSync(join(taskDir, "config.json"))), ticketFiles(taskDir));
+}
+/** `GET /api/tasks` + per-task comments, straight from the CLI store. */
+function expectedPayloads(store) {
+    const counts = store.commentCounts();
+    const tasks = store.list().map((task) => ({
+        ...task,
+        commentCount: counts.get(task.key) ?? 0,
+    }));
+    return { tasks, comments: new Map(tasks.map((t) => [t.key, store.comments(t.key)])) };
+}
+function assertSamePayloads(id, hosted, store) {
+    assert.equal(hosted.info.name, store.config.name, `${id}: project name`);
+    assert.equal(hosted.info.prefix, store.config.prefix, `${id}: prefix`);
+    const expected = expectedPayloads(store);
+    assert.equal(hosted.tasks.length, expected.tasks.length, `${id}: task count`);
+    for (let i = 0; i < expected.tasks.length; i++) {
+        assert.deepEqual(hosted.tasks[i], expected.tasks[i], `${id}: task ${expected.tasks[i].id}`);
+    }
+    for (const task of expected.tasks) {
+        assert.deepEqual(hosted.comments.get(task.key) ?? [], expected.comments.get(task.key), `${id}: comments on ${task.id}`);
+    }
+    assert.deepEqual(hosted.goals, [...store.goals(), ...store.goals(true)], `${id}: goals`);
+}
+test("finds the same boards the CLI would, in the same order", () => {
+    // The shape a recursive git-tree listing arrives in, plus the noise it
+    // really contains: nested boards, unrelated files, and a `.task` path that
+    // is a file rather than a board.
+    const paths = [
+        "README.md",
+        ".task/config.json",
+        ".task/tickets/1/ticket.md",
+        "projects/phone/web/.task/config.json",
+        "projects/task/cli/.task/config.json",
+        "docs/.taskrc",
+        "vendor/thing/.task/config.json.bak",
+        // A directory that merely *ends* in `.task` is not a board directory.
+        "lib/x.task/config.json",
+    ];
+    assert.deepEqual(findBoardDirs(paths), [".", "projects/phone/web", "projects/task/cli"]);
+});
+test("ignores boards nested deeper than the CLI would walk", () => {
+    const deep = "a/b/c/d/e/f/g/.task/config.json";
+    assert.deepEqual(findBoardDirs([deep]), []);
+    assert.deepEqual(findBoardDirs(["a/b/c/.task/config.json"]), ["a/b/c"]);
+});
+test("text boards produce the same payloads the CLI's FileStore does", () => {
+    const root = tempRoot();
+    const store = initProject(root, { name: "fixture board", prefix: "FIX" });
+    store.createGoal({ title: "Launch", description: "the shared why" });
+    const one = store.create({
+        title: "Every field exercised",
+        description: "A *body* with\n\n# an inner heading\n\nand `code`.",
+        tags: ["api", "infra"],
+        goal: "launch",
+        prs: ["https://github.com/x/y/pull/3"],
+    });
+    store.addAsk(one.key, "Approve the launch window", "claude");
+    const two = store.create({ title: "Mover", status: "backlog" });
+    store.create({ title: "Plain" });
+    store.update(two.key, { status: "in_progress" }); // lands on top → negative position
+    store.link(two.key, "blocked_by", one.key);
+    store.addComment(one.key, "first, with **markdown**", "nick");
+    store.addComment(one.key, "second", "claude");
+    assertSamePayloads("fixture", loadTicketsBoard("fixture", root), store);
+});
+test("this repo's committed boards read as text, same as the CLI reads them", () => {
+    for (const id of BOARDS) {
+        const root = id === "." ? REPO_ROOT : join(REPO_ROOT, id);
+        assertSamePayloads(id, loadTicketsBoard(id, root), new FileStore(root));
+    }
+});
+test("every committed board is non-empty and self-consistent", () => {
+    // A smoke check that the fixtures above are actually exercising something —
+    // boards that all happened to be empty would make the diff vacuous.
+    const loaded = BOARDS.map((id) => loadTicketsBoard(id, id === "." ? REPO_ROOT : join(REPO_ROOT, id)));
+    const total = loaded.reduce((sum, board) => sum + board.tasks.length, 0);
+    assert.ok(total > 10, `expected the repo's boards to hold real tasks, found ${total}`);
+    for (const board of loaded) {
+        for (const task of board.tasks) {
+            assert.match(task.id, /^[A-Z0-9]+-[a-z0-9]+$/, `${board.info.id}: display id`);
+            assert.ok(Array.isArray(task.tags), `${board.info.id}: tags parsed`);
+            assert.equal(typeof task.needsHuman, "boolean", `${board.info.id}: needsHuman`);
+        }
+    }
+});
+test("a broken ticket degrades instead of breaking the board", () => {
+    const config = new TextEncoder().encode(JSON.stringify({ name: "rough", prefix: "RGH", version: 2 }));
+    const encode = (s) => new TextEncoder().encode(s);
+    const board = readTicketsBoard("rough", config, new Map([
+        ["tickets/bad2c/ticket.md", encode("---\nstatus: todoo\nposition: not-a-number\n---\n\nno heading")],
+        ["tickets/gone3/ticket.md", encode("not even frontmatter")],
+        ["tickets/fine4/ticket.md", encode("---\nstatus: todo\nposition: 1\ncreated: c\nupdated: u\n---\n\n# Fine\n")],
+        // A comment on a ticket that didn't parse must not surface anywhere.
+        ["tickets/gone3/comments/2026-08-15T120000-x.md", encode("---\nauthor: \"x\"\ncreated: c\n---\n\nhi")],
+        // A pre-TAS-42 numeric directory is not a ticket to this reader at all.
+        ["tickets/42/ticket.md", encode("---\nstatus: todo\nposition: 1\ncreated: c\nupdated: u\n---\n\n# Old format\n")],
+    ]));
+    assert.deepEqual(board.tasks.map((t) => [t.key, t.status, t.title]), [
+        ["bad2c", "backlog", ""],
+        ["fine4", "todo", "Fine"],
+    ]);
+    assert.equal(board.comments.size, 0);
+});
+//# sourceMappingURL=source.test.js.map

package/dist/board/source.test.js.map

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

package/dist/board/tar.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A minimal streaming tar reader — just enough to walk a GitHub repository
+ * tarball. One pass, bounded memory: every entry's *path* is recorded, but
+ * bytes are kept only for the paths the caller's `keep` predicate selects;
+ * everything else is discarded chunk by chunk as it streams through, so a big
+ * repository costs no more memory than its boards.
+ *
+ * Understands what GitHub's tarballs actually contain: ustar headers with the
+ * split `prefix` field, a leading `pax_global_header`, and pax extended
+ * headers (`x`) or GNU longname entries (`L`) for paths longer than the
+ * header's 100 bytes. Checksums are not verified — the bytes come off a TLS
+ * connection from GitHub, not a tape from 1988.
+ */
+export declare class TarError extends Error {
+}
+export interface TarContents {
+    /** Every regular file's path, root directory stripped. */
+    paths: string[];
+    /** Bytes of the paths `keep` selected. */
+    files: Map<string, Uint8Array>;
+}
+/**
+ * Walk a (decompressed) tar stream. Paths are reported with the archive's
+ * root directory stripped — GitHub tarballs wrap everything in
+ * `<owner>-<repo>-<sha>/` — matching what a git tree listing would say.
+ */
+export declare function readTar(stream: ReadableStream<Uint8Array>, keep: (path: string) => boolean): Promise<TarContents>;
+//# sourceMappingURL=tar.d.ts.map

package/dist/board/tar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar.d.ts","sourceRoot":"","sources":["../../src/board/tar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qBAAa,QAAS,SAAQ,KAAK;CAAG;AAoGtC,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,0CAA0C;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAC9B,OAAO,CAAC,WAAW,CAAC,CAqEtB"}