@bluefields/cli 0.2.0

package/dist/bluefield.js

@@ -0,0 +1,382 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+/**
+ * The Bluefield local library — "git for web data".
+ *
+ * A thin orchestration layer over the reused engine packages:
+ *   - `@bluefields/fetcher`   → fetch + content-address + sign (fetchAndStore)
+ *   - `@bluefields/extractor` → optional structured extraction (BYO LLM key)
+ *   - `@bluefields/differ`    → line/structural diffs between snapshots
+ *   - `@bluefields/attest`    → offline signature verification
+ *
+ * It injects a LOCAL `DbClient` (PGlite) and a LOCAL filesystem
+ * `StorageAdapter` so the whole engine runs with no server, no Postgres, no
+ * KMS, and no network beyond the fetch itself. There is NO phone-home and NO
+ * telemetry anywhere in this package.
+ *
+ * Everything the CLI and the MCP server do goes through this class, so both
+ * surfaces stay thin.
+ */
+import { and, desc, eq, sql } from 'drizzle-orm';
+import { verifyBundle } from '@bluefields/attest';
+import { extractions as extractionsTable, snapshots as snapshotsTable, } from '@bluefields/db';
+import { lineDiff, structuralDiff } from '@bluefields/differ';
+import { extract } from '@bluefields/extractor';
+import { fetchAndStore, getDefaultFetcher, } from '@bluefields/fetcher';
+import { canonicalizeUrl } from '@bluefields/primitives';
+import { tryAnchor } from './anchor.js';
+import { isSigned, localTrustStore, readBundleSidecar, signedManifestFromRow, toBundle, writeBundleSidecar, } from './attestation.js';
+import { createFsStorageAdapter } from './fs-storage.js';
+import { loadOrCreateIdentity } from './keystore.js';
+import { resolveStoreRoot, storePaths } from './paths.js';
+import { LOCAL_CUSTOMER_ID, LOCAL_SUBSCRIPTION_ID, openStore } from './store.js';
+const HEX_PREFIX = /^[0-9a-f]{6,}$/i;
+/** Open (or create) a local Bluefield store. Call `close()` when done. */
+export async function openBluefield(opts = {}) {
+    const env = opts.env ?? process.env;
+    const root = opts.storeRoot ?? resolveStoreRoot({ env });
+    const paths = storePaths(root);
+    const identity = loadOrCreateIdentity(opts.keysDir);
+    const store = await openStore(paths.db);
+    const storage = createFsStorageAdapter(paths.objects);
+    const fetcher = opts.fetcher ?? getDefaultFetcher(env);
+    return new Bluefield(paths, identity, store, storage, fetcher, env, opts.respectRobotsTxt ?? true);
+}
+export class Bluefield {
+    paths;
+    identity;
+    store;
+    storage;
+    fetcher;
+    env;
+    respectRobotsTxt;
+    constructor(paths, identity, store, storage, fetcher, env, respectRobotsTxt) {
+        this.paths = paths;
+        this.identity = identity;
+        this.store = store;
+        this.storage = storage;
+        this.fetcher = fetcher;
+        this.env = env;
+        this.respectRobotsTxt = respectRobotsTxt;
+    }
+    get db() {
+        return this.store.db;
+    }
+    /** Capture a URL: fetch → content-address on disk → sign → record → sidecar. */
+    async scrape(url, opts = {}) {
+        const sign = opts.sign ?? true;
+        const canonical = canonicalizeUrl(url).url_canonical;
+        const prev = await this.latestForUrl(canonical);
+        const outcome = await fetchAndStore({
+            db: this.db,
+            fetcher: this.fetcher,
+            storage: this.storage,
+            url,
+            customerId: LOCAL_CUSTOMER_ID,
+            subscriptionId: LOCAL_SUBSCRIPTION_ID,
+            respectRobotsTxt: this.respectRobotsTxt,
+            signer: sign ? this.identity.signer : null,
+            ...(opts.fetchOptions ? { fetchOptions: opts.fetchOptions } : {}),
+        });
+        if (!outcome.ok)
+            return { ok: false, reason: 'robots_disallowed', url: canonical };
+        const row = await this.snapshotById(outcome.snapshotId);
+        if (!row)
+            throw new Error(`snapshot row vanished after insert: ${outcome.snapshotId}`);
+        // Freeze the portable bundle sidecar (manifest + signature + public key).
+        const bundle = toBundle(signedManifestFromRow(row), this.identity.publicJwk);
+        writeBundleSidecar(this.paths.manifests, row.id, bundle);
+        const result = {
+            ok: true,
+            snapshotId: row.id,
+            contentHash: row.contentHash,
+            url: canonical,
+            signed: isSigned(row),
+            changed: prev ? prev.contentHash !== row.contentHash : true,
+        };
+        if (opts.extract) {
+            result.extraction = await this.runExtract(row, outcome.fetchResult.html, opts);
+        }
+        if (opts.anchor) {
+            result.anchor = await tryAnchor(bundle);
+        }
+        return result;
+    }
+    /** Run the extractor over a snapshot's HTML (BYO LLM key via env). */
+    async runExtract(row, html, opts) {
+        const apiKey = this.env.ANTHROPIC_API_KEY;
+        const res = await extract(this.db, {
+            snapshotId: row.id,
+            subscriptionId: null,
+            customerId: LOCAL_CUSTOMER_ID,
+            html,
+            url: row.urlCanonical,
+            contentHash: row.contentHash,
+            schema: opts.schema ?? null,
+            intent: opts.intent ?? null,
+        }, apiKey ? { anthropicApiKey: apiKey } : {});
+        return res.extraction;
+    }
+    /** History: newest-first snapshots, optionally filtered to one URL. */
+    async log(url, opts = {}) {
+        const limit = opts.limit ?? 50;
+        const rows = url
+            ? await this.db
+                .select()
+                .from(snapshotsTable)
+                .where(eq(snapshotsTable.urlCanonical, canonicalizeUrl(url).url_canonical))
+                .orderBy(desc(snapshotsTable.fetchedAt))
+                .limit(limit)
+            : await this.db
+                .select()
+                .from(snapshotsTable)
+                .orderBy(desc(snapshotsTable.fetchedAt))
+                .limit(limit);
+        return rows.map(summarize);
+    }
+    /**
+     * Diff two snapshots. With one URL and no explicit `to`, diffs the two most
+     * recent snapshots of that URL. `content` mode line-diffs the raw bodies;
+     * `structured` mode JSON-patch-diffs their extractions' structured data.
+     */
+    async diff(fromRef, toRef, opts = {}) {
+        const mode = opts.mode ?? 'content';
+        let fromRow;
+        let toRow;
+        if (toRef) {
+            fromRow = await this.mustResolve(fromRef);
+            toRow = await this.mustResolve(toRef);
+        }
+        else {
+            // Single ref → treat as a URL and diff its last two snapshots.
+            const hist = await this.db
+                .select()
+                .from(snapshotsTable)
+                .where(eq(snapshotsTable.urlCanonical, canonicalizeUrl(fromRef).url_canonical))
+                .orderBy(desc(snapshotsTable.fetchedAt))
+                .limit(2);
+            if (hist.length < 2) {
+                throw new Error(`need at least two snapshots of ${fromRef} to diff (have ${hist.length})`);
+            }
+            toRow = hist[0];
+            fromRow = hist[1];
+        }
+        if (mode === 'structured') {
+            const [a, b] = await Promise.all([this.extractionFor(fromRow), this.extractionFor(toRow)]);
+            const ops = structuralDiff(a?.structuredData ?? null, b?.structuredData ?? null);
+            return {
+                from: summarize(fromRow),
+                to: summarize(toRow),
+                mode,
+                text: JSON.stringify(ops, null, 2),
+                added: ops.filter((o) => o.op === 'add').length,
+                removed: ops.filter((o) => o.op === 'remove').length,
+                ops,
+                identical: ops.length === 0,
+            };
+        }
+        const [prevContent, currContent] = await Promise.all([
+            this.storage.getSnapshot(fromRow.contentHash),
+            this.storage.getSnapshot(toRow.contentHash),
+        ]);
+        const d = lineDiff(prevContent, currContent);
+        return {
+            from: summarize(fromRow),
+            to: summarize(toRow),
+            mode,
+            text: d.text,
+            added: d.added,
+            removed: d.removed,
+            ops: [],
+            identical: prevContent === currContent,
+        };
+    }
+    /**
+     * Poll a URL on an interval, capturing each tick and reporting whether the
+     * content changed. Runs `times` iterations (default: forever) or until the
+     * `signal` aborts. `onTick` is invoked after every capture.
+     */
+    async watch(url, opts = {}) {
+        const intervalMs = opts.intervalMs ?? 300_000; // 5 min default
+        const times = opts.times ?? Number.POSITIVE_INFINITY;
+        const results = [];
+        for (let i = 0; i < times; i++) {
+            if (opts.signal?.aborted)
+                break;
+            const r = await this.scrape(url, opts.scrape ?? {});
+            results.push(r);
+            opts.onTick?.(r, i);
+            if (i + 1 >= times)
+                break;
+            const interrupted = await sleep(intervalMs, opts.signal);
+            if (interrupted)
+                break;
+        }
+        return results;
+    }
+    /**
+     * Verify a snapshot (by ref) or a previously-exported bundle. Recomputes the
+     * content hash from the stored object AND checks the signature against a
+     * trusted key (the local identity plus any keys under `<store>/trusted`, plus
+     * `extraKeys`). Fails closed on an unknown key unless `trustEmbedded` is set.
+     */
+    async verify(ref, opts = {}) {
+        const row = await this.resolve(ref);
+        if (!row) {
+            throw new Error(`no snapshot matches "${ref}"`);
+        }
+        // Prefer the frozen sidecar bundle; fall back to reconstruction.
+        const sidecar = readBundleSidecar(this.paths.manifests, row.id);
+        const bundle = sidecar ?? toBundle(signedManifestFromRow(row), this.identity.publicJwk);
+        // Re-hash the on-disk content — proves the bytes match what was signed.
+        let contentHashMatches = false;
+        try {
+            const content = await this.storage.getSnapshot(row.contentHash);
+            const { createHash } = await import('node:crypto');
+            contentHashMatches = createHash('sha256').update(content).digest('hex') === row.contentHash;
+        }
+        catch {
+            contentHashMatches = false;
+        }
+        // Build the trust store. Embedded key is only trusted with explicit opt-in.
+        const keys = [this.identity.publicJwk, ...this.loadTrustedKeys(), ...(opts.extraKeys ?? [])];
+        if (opts.trustEmbedded && bundle.jwk)
+            keys.push(bundle.jwk);
+        const trustStore = localTrustStore(keys);
+        const signatureValid = verifyBundle(bundle, { trustStore });
+        const ok = contentHashMatches && signatureValid;
+        return {
+            ok,
+            snapshotId: row.id,
+            keyId: bundle.signature.keyId,
+            contentHashMatches,
+            signatureValid,
+            detail: ok
+                ? 'content hash and signature verified'
+                : `${contentHashMatches ? '' : 'content hash mismatch; '}${signatureValid ? '' : 'signature not valid against a trusted key; '}`.trim(),
+        };
+    }
+    /** Write a snapshot's raw content + portable bundle into `destDir`. */
+    async export(ref, destDir) {
+        const row = await this.mustResolve(ref);
+        const content = await this.storage.getSnapshot(row.contentHash);
+        const bundle = readBundleSidecar(this.paths.manifests, row.id) ??
+            toBundle(signedManifestFromRow(row), this.identity.publicJwk);
+        const { mkdirSync, writeFileSync } = await import('node:fs');
+        const { join } = await import('node:path');
+        mkdirSync(destDir, { recursive: true });
+        const contentFile = join(destDir, `${row.id}.content`);
+        const bundleFile = join(destDir, `${row.id}.bundle.json`);
+        writeFileSync(contentFile, content, 'utf8');
+        writeFileSync(bundleFile, `${JSON.stringify(bundle, null, 2)}\n`, 'utf8');
+        return { snapshotId: row.id, dir: destDir, contentFile, bundleFile };
+    }
+    /** Retrieve the raw stored content for a snapshot ref. */
+    async getContent(ref) {
+        const row = await this.mustResolve(ref);
+        return this.storage.getSnapshot(row.contentHash);
+    }
+    /** The public identity (safe to share). */
+    publicIdentity() {
+        return { keyId: this.identity.keyId, publicJwk: this.identity.publicJwk };
+    }
+    async close() {
+        await this.store.close();
+    }
+    // ── internals ────────────────────────────────────────────────────────
+    loadTrustedKeys() {
+        try {
+            const { readdirSync, readFileSync } = require('node:fs');
+            const { join } = require('node:path');
+            return readdirSync(this.paths.trusted)
+                .filter((f) => f.endsWith('.jwk') || f.endsWith('.json'))
+                .map((f) => JSON.parse(readFileSync(join(this.paths.trusted, f), 'utf8')));
+        }
+        catch {
+            return []; // no trusted dir / unreadable → just the local identity
+        }
+    }
+    async snapshotById(id) {
+        const rows = await this.db
+            .select()
+            .from(snapshotsTable)
+            .where(eq(snapshotsTable.id, id))
+            .limit(1);
+        return rows[0];
+    }
+    async latestForUrl(urlCanonical) {
+        const rows = await this.db
+            .select()
+            .from(snapshotsTable)
+            .where(eq(snapshotsTable.urlCanonical, urlCanonical))
+            .orderBy(desc(snapshotsTable.fetchedAt))
+            .limit(1);
+        return rows[0];
+    }
+    /** Resolve a ref (snapshot-id prefix, or URL → latest) to a row, or null. */
+    async resolve(ref) {
+        // URL form first (contains '://') → latest snapshot of that URL.
+        if (ref.includes('://')) {
+            const row = await this.latestForUrl(canonicalizeUrl(ref).url_canonical);
+            return row ?? null;
+        }
+        // Otherwise treat as a snapshot-id prefix.
+        if (HEX_PREFIX.test(ref.replace(/-/g, ''))) {
+            const rows = await this.db
+                .select()
+                .from(snapshotsTable)
+                .where(sql `${snapshotsTable.id}::text LIKE ${`${ref}%`}`)
+                .orderBy(desc(snapshotsTable.fetchedAt))
+                .limit(2);
+            if (rows.length === 1)
+                return rows[0] ?? null;
+            if (rows.length > 1)
+                throw new Error(`ambiguous snapshot ref "${ref}" — provide more hex`);
+        }
+        return null;
+    }
+    async mustResolve(ref) {
+        const row = await this.resolve(ref);
+        if (!row)
+            throw new Error(`no snapshot matches "${ref}"`);
+        return row;
+    }
+    async extractionFor(row) {
+        const rows = await this.db
+            .select()
+            .from(extractionsTable)
+            .where(and(eq(extractionsTable.snapshotId, row.id), eq(extractionsTable.contentHash, row.contentHash)))
+            .orderBy(desc(extractionsTable.createdAt))
+            .limit(1);
+        return rows[0];
+    }
+}
+/** Sleep `ms`, resolving early (`true`) if the signal aborts. */
+function sleep(ms, signal) {
+    return new Promise((res) => {
+        if (signal?.aborted)
+            return res(true);
+        const t = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            res(false);
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            res(true);
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** Row → compact summary. */
+function summarize(row) {
+    return {
+        snapshotId: row.id,
+        url: row.urlCanonical,
+        contentHash: row.contentHash,
+        fetchedAt: row.fetchedAt,
+        responseStatus: row.responseStatus,
+        sizeBytes: row.rawHtmlSizeBytes,
+        signed: isSigned(row),
+        keyId: row.attestationKeyId,
+    };
+}
+//# sourceMappingURL=bluefield.js.map

package/dist/bluefield.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * `bf` — the Bluefield command line. A thin, dependency-free wrapper over the
+ * `@bluefields/cli` library. No arg-parsing dependency (a hand-rolled parser
+ * covers the small surface); no telemetry; no network beyond the fetch itself.
+ *
+ * Kept separate from `index.ts` so importing the library has no side effects
+ * and the binary runs reliably whether invoked as `node dist/cli.js` or via the
+ * `bf` bin symlink.
+ */
+import './quiet.js';
+interface Parsed {
+    positionals: string[];
+    flags: Map<string, string | true>;
+}
+/** Minimal argv parser: `--flag`, `--flag value`, `--flag=value`, positionals. */
+export declare function parse(argv: string[]): Parsed;
+export declare function main(argv: string[]): Promise<number>;
+export {};