primitive-admin 1.1.0-alpha.9 → 1.1.0

package/dist/src/lib/skill-installer.js

@@ -0,0 +1,441 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "fs";
+import { readFile } from "fs/promises";
+import { createHash } from "crypto";
+import { homedir } from "os";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import chalk from "chalk";
+/**
+ * `~/.claude`, or `PRIMITIVE_CLAUDE_DIR` when set. The override exists for the
+ * unit tests: `os.homedir()` reads the real process environment, which a
+ * vitest worker's `process.env` does not reach, so a test cannot stage a
+ * home directory by moving HOME.
+ */
+function claudeDir() {
+    return process.env.PRIMITIVE_CLAUDE_DIR || join(homedir(), ".claude");
+}
+function skillsDir() {
+    return join(claudeDir(), "skills");
+}
+// The public skill, bundled with the CLI.
+const PUBLIC_SKILL_NAME = "primitive-platform";
+function publicSkillDir() {
+    return join(skillsDir(), PUBLIC_SKILL_NAME);
+}
+function publicSkillFile() {
+    return join(publicSkillDir(), "SKILL.md");
+}
+function publicHashFile() {
+    return join(publicSkillDir(), ".version");
+}
+const INTERNAL_SKILL_NAME = "primitive-platform-internal";
+const FILE_ISSUE_SKILL_NAME = "file-issue";
+// file-issue runs `_shared` scripts and reads `_shared` templates. In the
+// repo `_shared` is a sibling of the skill (.claude/skills/_shared); in user
+// space it is installed inside the skill directory, which the skill's own
+// `$SHARED` resolution expects. check-filing.sh carries its section lists
+// inline (it does not read the templates), but the skill drafts from the
+// templates, so they ship too. linked-issue.sh sources closing-refs.sh.
+const SHARED = ".claude/skills/_shared";
+const FILE_ISSUE_SHARED_FILES = [
+    "check-filing.sh",
+    "resolve-sponsor.sh",
+    "linked-issue.sh",
+    "closing-refs.sh",
+    "filing-conventions.md",
+    "templates/bug-filing.md",
+    "templates/feature-filing.md",
+    "templates/docs-filing.md",
+];
+export const FETCHED_SKILLS = [
+    {
+        name: INTERNAL_SKILL_NAME,
+        files: [
+            {
+                repoPath: `internal-skills/${INTERNAL_SKILL_NAME}/SKILL.md`,
+                localPath: "SKILL.md",
+            },
+        ],
+    },
+    {
+        name: FILE_ISSUE_SKILL_NAME,
+        files: [
+            { repoPath: `.claude/skills/${FILE_ISSUE_SKILL_NAME}/SKILL.md`, localPath: "SKILL.md" },
+            ...FILE_ISSUE_SHARED_FILES.map((f) => ({
+                repoPath: `${SHARED}/${f}`,
+                localPath: `_shared/${f}`,
+            })),
+        ],
+    },
+];
+function fetchedSkillDir(skill) {
+    return join(skillsDir(), skill.name);
+}
+/**
+ * One stamp for all fetched skills, kept where the first fetched skill's
+ * stamp has always lived (`primitive-platform-internal/.version`) so installs
+ * made before file-issue was added upgrade in place: an old-format stamp has
+ * no `skills` map, and the next per-version refresh fills it in.
+ */
+function membersStampFile() {
+    return join(skillsDir(), INTERNAL_SKILL_NAME, ".version");
+}
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function getBundledSkillPath() {
+    // In dist: dist/src/lib/skill-installer.js -> ../../../assets/...
+    // In source (tsx): src/lib/skill-installer.ts -> ../../assets/...
+    const distPath = fileURLToPath(new URL("../../../assets/skill/skills/primitive-platform/SKILL.md", import.meta.url));
+    if (existsSync(distPath))
+        return distPath;
+    return fileURLToPath(new URL("../../assets/skill/skills/primitive-platform/SKILL.md", import.meta.url));
+}
+export function getCliVersion() {
+    // Same dual-path layout as getBundledSkillPath: dist/src/lib -> package root
+    // is three levels up; src/lib (tsx) -> two levels up.
+    // Both candidates can exist (from source, ../../../ is the repo root), so
+    // require the CLI's package name to pick the right one.
+    for (const rel of ["../../../package.json", "../../package.json"]) {
+        try {
+            const path = fileURLToPath(new URL(rel, import.meta.url));
+            if (!existsSync(path))
+                continue;
+            const pkg = JSON.parse(readFileSync(path, "utf-8"));
+            if (pkg.name === "primitive-admin" && typeof pkg.version === "string") {
+                return pkg.version;
+            }
+        }
+        catch {
+            // try next path
+        }
+    }
+    return null;
+}
+function computeHash(content) {
+    return createHash("sha256").update(content).digest("hex").slice(0, 12);
+}
+function getInstalledHash() {
+    try {
+        if (!existsSync(publicHashFile()))
+            return null;
+        return readFileSync(publicHashFile(), "utf-8").trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Returns true if the skill is currently installed.
+ */
+export function isSkillInstalled() {
+    return getInstalledHash() !== null;
+}
+function getMembersStamp() {
+    try {
+        const file = membersStampFile();
+        if (!existsSync(file))
+            return null;
+        const stamp = JSON.parse(readFileSync(file, "utf-8"));
+        if (typeof stamp.cliVersion === "string" && typeof stamp.hash === "string") {
+            return stamp;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeMembersStamp(stamp) {
+    mkdirSync(dirname(membersStampFile()), { recursive: true });
+    writeFileSync(membersStampFile(), JSON.stringify(stamp, null, 2));
+}
+/** The installed hash of a fetched skill, from the stamp; null when absent. */
+function installedFetchedHash(skill, stamp) {
+    if (!stamp)
+        return null;
+    if (!existsSync(join(fetchedSkillDir(skill), "SKILL.md")))
+        return null;
+    if (skill.name === INTERNAL_SKILL_NAME && !stamp.skills)
+        return stamp.hash;
+    return stamp.skills?.[skill.name] ?? null;
+}
+/**
+ * Read one file of the private js-bao-wss repo (main branch) via the GitHub
+ * contents API through `gh`. Returns null if gh is missing, unauthenticated,
+ * or the caller lacks access to the repo — access failure is how non-members
+ * are gated.
+ *
+ * `PRIMITIVE_SKILL_SOURCE_DIR` reads the same repo paths from a local
+ * checkout instead, to try a skill edit before it is merged (and for the
+ * unit tests, which install from this repo's own files).
+ */
+export async function fetchRepoFile(repoPath) {
+    const sourceDir = process.env.PRIMITIVE_SKILL_SOURCE_DIR;
+    if (sourceDir) {
+        try {
+            return await readFile(join(sourceDir, repoPath), "utf-8");
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        const { execFile } = await import("child_process");
+        const { promisify } = await import("util");
+        const { stdout } = await promisify(execFile)("gh", ["api", "-H", "Accept: application/vnd.github.raw", `repos/Primitive-Labs/js-bao-wss/contents/${repoPath}`], { timeout: 15000, maxBuffer: 4 * 1024 * 1024 });
+        return stdout;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch every file of a members' skill. Null if any file is unavailable, so
+ * a partial skill is never written over a complete one.
+ */
+async function fetchSkill(skill) {
+    const files = new Map();
+    for (const file of skill.files) {
+        const content = await fetchRepoFile(file.repoPath);
+        if (content === null || content.length === 0)
+            return null;
+        // Sanity check the skill file itself: must be a skill, not an error payload.
+        if (file.localPath === "SKILL.md" && (!content.startsWith("---") || !content.includes(`name: ${skill.name}`))) {
+            return null;
+        }
+        files.set(file.localPath, content);
+    }
+    return files;
+}
+/** Hash of a fetched skill: every file's path and content, in manifest order. */
+function hashSkillFiles(skill, files) {
+    const h = createHash("sha256");
+    for (const file of skill.files) {
+        h.update(file.localPath).update("\0").update(files.get(file.localPath) ?? "").update("\0");
+    }
+    return h.digest("hex").slice(0, 12);
+}
+function writeFetchedSkill(skill, files) {
+    const dir = fetchedSkillDir(skill);
+    for (const [localPath, content] of files) {
+        const target = join(dir, localPath);
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, content);
+    }
+    return hashSkillFiles(skill, files);
+}
+/**
+ * Fetch and write every members' skill. Returns the per-skill hash of what
+ * is now installed (a skill whose fetch failed keeps its previous hash, or
+ * is absent from the result when it was never installed).
+ */
+async function installFetchedSkills(previous) {
+    const installed = {};
+    const fetched = [];
+    const failed = [];
+    for (const skill of FETCHED_SKILLS) {
+        const files = await fetchSkill(skill);
+        if (files) {
+            installed[skill.name] = writeFetchedSkill(skill, files);
+            fetched.push(skill.name);
+        }
+        else {
+            const kept = installedFetchedHash(skill, previous);
+            if (kept)
+                installed[skill.name] = kept;
+            failed.push(skill.name);
+        }
+    }
+    return { installed, fetched, failed };
+}
+function stampFrom(cliVersion, installed) {
+    return {
+        cliVersion,
+        hash: installed[INTERNAL_SKILL_NAME] ?? "",
+        skills: installed,
+    };
+}
+/**
+ * Refresh the members' skills if the CLI version changed since the last
+ * attempt. One fetch per CLI release: the stamp is advanced even when the
+ * fetch fails, so an offline or revoked user isn't retried on every command
+ * (an explicit `primitive skill install` always refetches). Only runs when
+ * a members' skill is already installed — a first install is explicit only.
+ */
+async function refreshFetchedSkills() {
+    const stamp = getMembersStamp();
+    if (!stamp)
+        return; // not installed — explicit install only
+    const cliVersion = getCliVersion();
+    if (!cliVersion || stamp.cliVersion === cliVersion)
+        return;
+    const { installed, fetched } = await installFetchedSkills(stamp);
+    if (fetched.length === 0) {
+        writeMembersStamp({ ...stamp, cliVersion });
+        return;
+    }
+    const changed = fetched.filter((name) => installed[name] !== installedFetchedHash(FETCHED_SKILLS.find((s) => s.name === name), stamp));
+    writeMembersStamp(stampFrom(cliVersion, installed));
+    if (changed.length > 0) {
+        // Diagnostic, not payload: post-command notices must stay off stdout so
+        // `primitive <verb> --json | jq .` parses (#2357). Same stream choice as
+        // the update banner in version-check.ts.
+        console.error(chalk.dim(`Updated Primitive members' skills for Claude Code (${changed.join(", ")})`));
+    }
+}
+/**
+ * Auto-update an already-installed skill if a newer version is bundled.
+ * Called after command execution for non-init, non-skill commands.
+ * If the skill is not installed, shows a non-blocking hint instead.
+ * Never throws — fails silently like version-check.
+ */
+export async function checkSkillStatus() {
+    try {
+        const bundledPath = getBundledSkillPath();
+        if (!existsSync(bundledPath))
+            return;
+        if (!existsSync(claudeDir()))
+            return;
+        const bundledContent = await readFile(bundledPath, "utf-8");
+        const bundledHash = computeHash(bundledContent);
+        const installedHash = getInstalledHash();
+        if (installedHash) {
+            // Already installed — silently auto-update if needed
+            if (installedHash !== bundledHash) {
+                mkdirSync(publicSkillDir(), { recursive: true });
+                writeFileSync(publicSkillFile(), bundledContent);
+                writeFileSync(publicHashFile(), bundledHash);
+                console.error(chalk.dim("Updated Primitive platform skill for Claude Code"));
+            }
+            // Members' skills (if installed) refresh from the private repo, at
+            // most once per CLI release.
+            await refreshFetchedSkills();
+        }
+        else {
+            // Not installed — show a non-blocking hint
+            console.error(chalk.dim(`Claude Code skill available — run ${chalk.cyan("primitive skill install")} to set up`));
+        }
+    }
+    catch {
+        // Never let skill check affect CLI operation
+    }
+}
+/**
+ * Explicitly install or reinstall the skill. Shows output.
+ * Also installs the members' skills (primitive-platform-internal and
+ * file-issue) when the caller has access to the private repo
+ * (Primitive-Labs members); silently skipped otherwise.
+ */
+export async function installSkillExplicit() {
+    const bundledPath = getBundledSkillPath();
+    if (!existsSync(bundledPath)) {
+        console.error(chalk.red("Skill assets not found. Reinstall the CLI."));
+        return false;
+    }
+    if (!existsSync(claudeDir())) {
+        console.error(chalk.red("Claude Code not found (~/.claude does not exist)."));
+        console.error(chalk.dim("Install Claude Code first: https://claude.ai/code"));
+        return false;
+    }
+    const bundledContent = readFileSync(bundledPath, "utf-8");
+    const bundledHash = computeHash(bundledContent);
+    mkdirSync(publicSkillDir(), { recursive: true });
+    writeFileSync(publicSkillFile(), bundledContent);
+    writeFileSync(publicHashFile(), bundledHash);
+    console.log(chalk.green("Primitive platform skill installed for Claude Code."));
+    console.log(chalk.dim(`Location: ${publicSkillFile()}`));
+    console.log(chalk.dim(`Version: ${bundledHash}`));
+    const previous = getMembersStamp();
+    const { installed, fetched, failed } = await installFetchedSkills(previous);
+    if (Object.keys(installed).length > 0) {
+        writeMembersStamp(stampFrom(getCliVersion() ?? "unknown", installed));
+    }
+    for (const skill of FETCHED_SKILLS) {
+        if (fetched.includes(skill.name)) {
+            console.log(chalk.green(`Primitive ${skill.name} skill installed (Primitive-Labs members).`));
+            console.log(chalk.dim(`Location: ${fetchedSkillDir(skill)}`));
+            console.log(chalk.dim(`Version: ${installed[skill.name]}`));
+        }
+        else if (installed[skill.name]) {
+            // Keep the existing copy; just tell the user the refresh didn't happen.
+            console.log(chalk.yellow(`Could not refresh the ${skill.name} skill (gh unavailable or no repo access); keeping the installed copy.`));
+        }
+    }
+    // A member with one skill installed and another that failed to fetch
+    // (a transient error) is told; a non-member (nothing fetched, nothing
+    // installed) is told nothing.
+    if (fetched.length > 0 && failed.length > 0) {
+        console.log(chalk.yellow(`Could not fetch: ${failed.join(", ")}. Run primitive skill install again to retry.`));
+    }
+    return true;
+}
+/**
+ * Uninstall the skill (and the members' skills, if present).
+ */
+export function uninstallSkill() {
+    const fetchedDirs = FETCHED_SKILLS.map((skill) => ({ skill, dir: fetchedSkillDir(skill) }));
+    if (!existsSync(publicSkillDir()) && !fetchedDirs.some(({ dir }) => existsSync(dir))) {
+        console.log(chalk.dim("Skill is not installed."));
+        return true;
+    }
+    if (existsSync(publicSkillDir())) {
+        rmSync(publicSkillDir(), { recursive: true });
+        console.log(chalk.green("Primitive platform skill uninstalled."));
+    }
+    for (const { skill, dir } of fetchedDirs) {
+        if (existsSync(dir)) {
+            rmSync(dir, { recursive: true });
+            console.log(chalk.green(`Primitive ${skill.name} skill uninstalled.`));
+        }
+    }
+    return true;
+}
+/** The data `skillStatus()` prints; exported so tests can read it directly. */
+export function getSkillStatus() {
+    const bundledPath = getBundledSkillPath();
+    const stamp = getMembersStamp();
+    const fetched = {};
+    for (const skill of FETCHED_SKILLS) {
+        const hash = installedFetchedHash(skill, stamp);
+        fetched[skill.name] = hash && stamp
+            ? { hash, cliVersion: stamp.cliVersion, location: fetchedSkillDir(skill) }
+            : null;
+    }
+    return {
+        installedHash: getInstalledHash(),
+        bundledHash: existsSync(bundledPath) ? computeHash(readFileSync(bundledPath, "utf-8")) : null,
+        location: publicSkillFile(),
+        fetched,
+    };
+}
+/**
+ * Show current skill installation status.
+ */
+export function skillStatus() {
+    const status = getSkillStatus();
+    if (!status.installedHash) {
+        console.log(chalk.yellow("Skill is not installed."));
+    }
+    else {
+        console.log(chalk.green("Skill is installed."));
+        console.log(chalk.dim(`  Location: ${status.location}`));
+        console.log(chalk.dim(`  Version:  ${status.installedHash}`));
+    }
+    if (status.bundledHash) {
+        console.log(chalk.dim(`  Bundled:  ${status.bundledHash}`));
+        if (status.installedHash && status.installedHash !== status.bundledHash) {
+            console.log(chalk.yellow("  Update available — run: primitive skill install"));
+        }
+    }
+    for (const skill of FETCHED_SKILLS) {
+        const entry = status.fetched[skill.name];
+        if (entry) {
+            console.log(chalk.green(`${skill.name} skill is installed (Primitive-Labs members).`));
+            console.log(chalk.dim(`  Location: ${entry.location}`));
+            console.log(chalk.dim(`  Version:  ${entry.hash} (fetched for CLI ${entry.cliVersion})`));
+        }
+        else {
+            console.log(chalk.dim(`${skill.name} skill is not installed (Primitive-Labs members: primitive skill install).`));
+        }
+    }
+}
+//# sourceMappingURL=skill-installer.js.map

package/dist/src/lib/skill-installer.js.map

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

package/dist/src/lib/snapshot-audit-source.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The audit's source, wired to the app API (#3433, criterion 10).
+ *
+ * `auditSnapshotChain` takes its reads as a port so its decision — the fence,
+ * the model union, the comparison — is gradeable against a source a test can
+ * move between calls. This is the one the command runs: four routes, and one
+ * rule about how often each is asked.
+ *
+ * ## Why nothing is remembered between attempts (3433-C09)
+ *
+ * The schema answers two of the audit's questions — which models the table
+ * holds, and which of their fields are stringsets — and remembering its answer
+ * for the whole run made both of them statements about the FIRST attempt. A
+ * field declared while an attempt was running is exactly what moves the fence
+ * and discards it, so the remembered answer would be read on the one attempt
+ * that needed a fresh one: both sides hold the same members, the declaration
+ * that says they are a set is on the server, and the audit reports corruption.
+ * Each attempt asks again. Two extra reads of a bounded route are nothing
+ * beside the chain the same attempt downloads.
+ *
+ * The declarations are read AFTER the chain is captured, so they cover the
+ * state being compared; the table's model list is read BEFORE it, because that
+ * read is also the permission check that refuses a caller who could not finish
+ * (3433-C08). A model that appears between the two is in the captured overlay
+ * and therefore in the reconstruction, which the union takes the other half
+ * from; one that appears after it moves the fence and the attempt is retried.
+ */
+import { type AuditSource } from "./snapshot-audit.js";
+/** The four reads the audit makes of the server, as `ApiClient` answers them. */
+export interface AuditApiClient {
+    exportDocumentChain(appId: string, documentId: string): Promise<any>;
+    downloadDocumentArtifact(appId: string, path: string): Promise<Uint8Array>;
+    getDocumentSchema(appId: string, documentId: string): Promise<any>;
+    queryDocumentRecords(appId: string, documentId: string, model: string, options: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<any>;
+}
+export interface AuditApiSourceOptions {
+    appId: string;
+    documentId: string;
+    /** Records per page. One page is the audit's whole server-side working set. */
+    pageSize: number;
+}
+export declare function createAuditApiSource(client: AuditApiClient, options: AuditApiSourceOptions): AuditSource;

package/dist/src/lib/snapshot-audit-source.js

@@ -0,0 +1,58 @@
+/**
+ * The audit's source, wired to the app API (#3433, criterion 10).
+ *
+ * `auditSnapshotChain` takes its reads as a port so its decision — the fence,
+ * the model union, the comparison — is gradeable against a source a test can
+ * move between calls. This is the one the command runs: four routes, and one
+ * rule about how often each is asked.
+ *
+ * ## Why nothing is remembered between attempts (3433-C09)
+ *
+ * The schema answers two of the audit's questions — which models the table
+ * holds, and which of their fields are stringsets — and remembering its answer
+ * for the whole run made both of them statements about the FIRST attempt. A
+ * field declared while an attempt was running is exactly what moves the fence
+ * and discards it, so the remembered answer would be read on the one attempt
+ * that needed a fresh one: both sides hold the same members, the declaration
+ * that says they are a set is on the server, and the audit reports corruption.
+ * Each attempt asks again. Two extra reads of a bounded route are nothing
+ * beside the chain the same attempt downloads.
+ *
+ * The declarations are read AFTER the chain is captured, so they cover the
+ * state being compared; the table's model list is read BEFORE it, because that
+ * read is also the permission check that refuses a caller who could not finish
+ * (3433-C08). A model that appears between the two is in the captured overlay
+ * and therefore in the reconstruction, which the union takes the other half
+ * from; one that appears after it moves the fence and the attempt is retried.
+ */
+import { stringSetFieldsFromSchema, } from "./snapshot-audit.js";
+export function createAuditApiSource(client, options) {
+    const { appId, documentId, pageSize } = options;
+    return {
+        async chain() {
+            return await client.exportDocumentChain(appId, documentId);
+        },
+        async download(grantedPath) {
+            const body = await client.downloadDocumentArtifact(appId, grantedPath);
+            return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
+        },
+        async tableModels() {
+            const answer = await client.getDocumentSchema(appId, documentId);
+            return Array.isArray(answer?.tableModels) ? answer.tableModels : [];
+        },
+        async stringSetFields() {
+            return stringSetFieldsFromSchema(await client.getDocumentSchema(appId, documentId));
+        },
+        async readPage(model, cursor) {
+            const page = await client.queryDocumentRecords(appId, documentId, model, {
+                limit: pageSize,
+                ...(cursor ? { cursor } : {}),
+            });
+            return {
+                items: (page?.items ?? []),
+                nextCursor: page?.nextCursor ?? null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=snapshot-audit-source.js.map

package/dist/src/lib/snapshot-audit-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-audit-source.js","sourceRoot":"","sources":["../../../src/lib/snapshot-audit-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACL,yBAAyB,GAG1B,MAAM,qBAAqB,CAAC;AAsB7B,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,OAA8B;IAE9B,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAChD,OAAO;QACL,KAAK,CAAC,KAAK;YACT,OAAO,MAAM,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,WAAmB;YAChC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YACvE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACvE,CAAC;QAED,KAAK,CAAC,WAAW;YACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACjE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,CAAC;QAED,KAAK,CAAC,eAAe;YACnB,OAAO,yBAAyB,CAC9B,MAAM,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAClD,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,MAAe;YAC3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;gBACvE,KAAK,EAAE,QAAQ;gBACf,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAmC;gBAC5D,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,IAAI;aACrC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/lib/snapshot-audit-store.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The audit's local reconstruction, over js-bao's own Node SQLite store
+ * (#3433, criterion 10).
+ *
+ * This is the half of the audit that must NOT be a reimplementation: the base
+ * is materialised by the checked-in loader and the overlays are folded by the
+ * client's own fold, so what the audit compares with the table is what a
+ * browser would have computed from the same artifacts. A hand-rolled fold here
+ * would make the audit agree with itself rather than with a client.
+ *
+ * Everything lives in one throwaway SQLite file, removed when the audit ends —
+ * including the `audit_seen` table, which is what keeps memory to one page
+ * plus the store: the ids the table has already shown are marked rather than
+ * held.
+ */
+import type { AuditLocalStore } from "./snapshot-audit.js";
+import type { ManifestLike } from "./snapshot-manifest-layout.js";
+/**
+ * The fence's reader: how far one overlay update has got, deletions included.
+ *
+ * A state vector alone is NOT that. It carries one clock per client and a Yjs
+ * deletion creates no struct, so removing a key leaves it exactly where it
+ * was — and a legacy nested-map record deleted between the audit's capture and
+ * its comparison would then pass the fence and be reported as a record only
+ * the recomputed chain holds, which is corruption's own signature (finding
+ * 3433-C05; the deletion shape is pinned by `large-document-snapshot-verify`'s
+ * E4 case). So the fingerprint is the state vector AND a digest of the
+ * update's delete set: every client's deleted ranges, in a fixed order.
+ *
+ * Yjs is loaded once and handed back as a synchronous function, so the audit's
+ * fence stays a plain comparison rather than an awaited one — and so the
+ * library itself never has to import Yjs.
+ */
+export declare function createChainFingerprintReader(): Promise<(update: Uint8Array) => string>;
+/**
+ * The stringset fields a base manifest records, per model.
+ *
+ * A Map rather than an object because a model's name is data: an undeclared
+ * model is whatever `_type` the records route was handed, so `constructor` and
+ * `toString` are names this can be asked for, and on a plain object either
+ * answers a function off the prototype rather than nothing at all (3433-C11).
+ * The manifest is the only record of what a model declares for a model no
+ * later overlay touched, which is exactly where these have to come from.
+ */
+export declare function stringSetFieldsFromManifest(manifest: ManifestLike): Map<string, Set<string>>;
+/**
+ * Build a local store for one audit attempt.
+ *
+ * A fresh database per attempt by design: an attempt the fence discards must
+ * leave nothing behind for the next one to read.
+ */
+export declare function createAuditLocalStore(documentId: string): Promise<AuditLocalStore>;