@ryanstark24/sfgraph-core 1.1.0

package/dist/storage/sqlite/snapshot-store.js

@@ -0,0 +1,255 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+import { StorageError, asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import Database from "better-sqlite3";
+import { wrapAbiError } from "./load-better-sqlite3.js";
+import { MIGRATIONS, MigrationRunner } from "./migrations.js";
+function snapshotFromRow(row) {
+    return {
+        id: row.id,
+        orgId: asOrgId(row.org_id),
+        label: row.label,
+        createdAt: row.created_at,
+        isAuto: row.is_auto === 1,
+    };
+}
+function nodeFromSnapshotRow(row) {
+    return {
+        orgId: asOrgId(row.org_id),
+        qualifiedName: asQualifiedName(row.qualified_name),
+        label: row.label,
+        attributes: JSON.parse(row.attributes),
+        sourceHash: asSha256(row.source_hash),
+        firstSeenAt: row.first_seen_at,
+        lastSeenAt: row.last_seen_at,
+        lastModifiedAt: row.last_modified_at,
+    };
+}
+function edgeFromSnapshotRow(row) {
+    return {
+        orgId: asOrgId(row.org_id),
+        srcQualifiedName: asQualifiedName(row.src_qname),
+        dstQualifiedName: asQualifiedName(row.dst_qname),
+        relType: row.rel_type,
+        attributes: JSON.parse(row.attributes),
+        firstSeenAt: row.first_seen_at,
+        lastSeenAt: row.last_seen_at,
+    };
+}
+export class SqliteSnapshotStore {
+    db;
+    ownsDb;
+    opts;
+    initialized = false;
+    constructor(opts) {
+        this.opts = opts;
+        if (opts.db) {
+            this.db = opts.db;
+            this.ownsDb = false;
+        }
+        else {
+            if (opts.dbPath !== ":memory:") {
+                const dir = path.dirname(opts.dbPath);
+                if (dir && dir !== ".")
+                    mkdirSync(dir, { recursive: true });
+            }
+            try {
+                this.db = new Database(opts.dbPath);
+            }
+            catch (e) {
+                const wrapped = wrapAbiError(e);
+                if (wrapped)
+                    throw wrapped;
+                throw e;
+            }
+            this.ownsDb = true;
+        }
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        if (!this.opts.skipMigrations) {
+            const backupDir = this.opts.backupDir ??
+                (this.opts.dbPath === ":memory:"
+                    ? path.join(process.cwd(), ".sfgraph-backups")
+                    : path.join(path.dirname(this.opts.dbPath), ".sfgraph-backups"));
+            const runner = new MigrationRunner(this.db, MIGRATIONS, {
+                backupDir,
+                retainBackups: this.opts.retainBackups ?? 5,
+            });
+            runner.applyPending();
+        }
+        this.initialized = true;
+    }
+    getNodeLabelTables() {
+        const out = new Map();
+        const rows = this.db
+            .prepare("SELECT label, table_name FROM _sfgraph_node_labels")
+            .all();
+        for (const r of rows)
+            out.set(r.label, r.table_name);
+        return out;
+    }
+    getEdgeRelTables() {
+        const out = new Map();
+        const rows = this.db
+            .prepare("SELECT rel_type, table_name FROM _sfgraph_edge_types")
+            .all();
+        for (const r of rows)
+            out.set(r.rel_type, r.table_name);
+        return out;
+    }
+    createSnapshot(orgId, label, isAuto) {
+        const id = `snap_${randomUUID()}`;
+        const createdAt = Date.now();
+        const apply = this.db.transaction(() => {
+            this.db
+                .prepare("INSERT INTO _sfgraph_snapshots(id, org_id, label, created_at, is_auto) VALUES (?, ?, ?, ?, ?)")
+                .run(id, orgId, label, createdAt, isAuto ? 1 : 0);
+            for (const [lbl, tbl] of this.getNodeLabelTables()) {
+                this.db
+                    .prepare(`INSERT INTO _sfgraph_node_snapshots(snapshot_id, org_id, qualified_name, label, attributes, source_hash, first_seen_at, last_seen_at, last_modified_at)
+             SELECT ?, org_id, qualified_name, ?, attributes, source_hash, first_seen_at, last_seen_at, last_modified_at FROM ${tbl} WHERE org_id = ?`)
+                    .run(id, lbl, orgId);
+            }
+            for (const [rt, tbl] of this.getEdgeRelTables()) {
+                this.db
+                    .prepare(`INSERT INTO _sfgraph_edge_snapshots(snapshot_id, org_id, src_qname, dst_qname, rel_type, attributes, first_seen_at, last_seen_at)
+             SELECT ?, org_id, src_qname, dst_qname, ?, attributes, first_seen_at, last_seen_at FROM ${tbl} WHERE org_id = ?`)
+                    .run(id, rt, orgId);
+            }
+        });
+        apply();
+        return {
+            id,
+            orgId,
+            label,
+            createdAt,
+            isAuto,
+        };
+    }
+    listSnapshots(orgId) {
+        const rows = this.db
+            .prepare("SELECT id, org_id, label, created_at, is_auto FROM _sfgraph_snapshots WHERE org_id = ? ORDER BY created_at DESC")
+            .all(orgId);
+        return rows.map(snapshotFromRow);
+    }
+    getSnapshot(id) {
+        const row = this.db
+            .prepare("SELECT id, org_id, label, created_at, is_auto FROM _sfgraph_snapshots WHERE id = ?")
+            .get(id);
+        return row ? snapshotFromRow(row) : null;
+    }
+    deleteSnapshot(id) {
+        const apply = this.db.transaction(() => {
+            this.db.prepare("DELETE FROM _sfgraph_node_snapshots WHERE snapshot_id = ?").run(id);
+            this.db.prepare("DELETE FROM _sfgraph_edge_snapshots WHERE snapshot_id = ?").run(id);
+            this.db.prepare("DELETE FROM _sfgraph_snapshots WHERE id = ?").run(id);
+        });
+        apply();
+    }
+    readNodes(orgId, src) {
+        const out = new Map();
+        if (src === "current") {
+            for (const [lbl, tbl] of this.getNodeLabelTables()) {
+                const rows = this.db
+                    .prepare(`SELECT org_id, qualified_name, attributes, source_hash, first_seen_at, last_seen_at, last_modified_at FROM ${tbl} WHERE org_id = ?`)
+                    .all(orgId);
+                for (const r of rows) {
+                    const nf = nodeFromSnapshotRow({ ...r, label: lbl });
+                    out.set(nf.qualifiedName, nf);
+                }
+            }
+        }
+        else {
+            const rows = this.db
+                .prepare("SELECT org_id, qualified_name, label, attributes, source_hash, first_seen_at, last_seen_at, last_modified_at FROM _sfgraph_node_snapshots WHERE snapshot_id = ? AND org_id = ?")
+                .all(src, orgId);
+            for (const r of rows) {
+                const nf = nodeFromSnapshotRow(r);
+                out.set(nf.qualifiedName, nf);
+            }
+        }
+        return out;
+    }
+    readEdges(orgId, src) {
+        const out = new Map();
+        const keyOf = (e) => `${e.srcQualifiedName}|${e.dstQualifiedName}|${e.relType}`;
+        if (src === "current") {
+            for (const [rt, tbl] of this.getEdgeRelTables()) {
+                const rows = this.db
+                    .prepare(`SELECT org_id, src_qname, dst_qname, attributes, first_seen_at, last_seen_at FROM ${tbl} WHERE org_id = ?`)
+                    .all(orgId);
+                for (const r of rows) {
+                    const e = edgeFromSnapshotRow({ ...r, rel_type: rt });
+                    out.set(keyOf(e), e);
+                }
+            }
+        }
+        else {
+            const rows = this.db
+                .prepare("SELECT org_id, src_qname, dst_qname, rel_type, attributes, first_seen_at, last_seen_at FROM _sfgraph_edge_snapshots WHERE snapshot_id = ? AND org_id = ?")
+                .all(src, orgId);
+            for (const r of rows) {
+                const e = edgeFromSnapshotRow(r);
+                out.set(keyOf(e), e);
+            }
+        }
+        return out;
+    }
+    diffNodes(orgId, fromId, toId) {
+        if (fromId !== "current" && !this.getSnapshot(fromId)) {
+            throw new StorageError(`snapshot ${fromId} not found`);
+        }
+        if (toId !== "current" && !this.getSnapshot(toId)) {
+            throw new StorageError(`snapshot ${toId} not found`);
+        }
+        const from = this.readNodes(orgId, fromId);
+        const to = this.readNodes(orgId, toId);
+        const added = [];
+        const removed = [];
+        const changed = [];
+        for (const [qn, t] of to) {
+            const f = from.get(qn);
+            if (!f)
+                added.push(t);
+            else if (f.sourceHash !== t.sourceHash)
+                changed.push({ before: f, after: t });
+        }
+        for (const [qn, f] of from) {
+            if (!to.has(qn))
+                removed.push(f);
+        }
+        return { added, removed, changed };
+    }
+    diffEdges(orgId, fromId, toId) {
+        if (fromId !== "current" && !this.getSnapshot(fromId)) {
+            throw new StorageError(`snapshot ${fromId} not found`);
+        }
+        if (toId !== "current" && !this.getSnapshot(toId)) {
+            throw new StorageError(`snapshot ${toId} not found`);
+        }
+        const from = this.readEdges(orgId, fromId);
+        const to = this.readEdges(orgId, toId);
+        const added = [];
+        const removed = [];
+        for (const [k, t] of to)
+            if (!from.has(k))
+                added.push(t);
+        for (const [k, f] of from)
+            if (!to.has(k))
+                removed.push(f);
+        return { added, removed };
+    }
+    prune(orgId, retainDays) {
+        const cutoff = Date.now() - retainDays * 86_400_000;
+        const ids = this.db
+            .prepare("SELECT id FROM _sfgraph_snapshots WHERE org_id = ? AND is_auto = 1 AND created_at < ?")
+            .all(orgId, cutoff);
+        for (const { id } of ids)
+            this.deleteSnapshot(id);
+        return ids.length;
+    }
+}
+//# sourceMappingURL=snapshot-store.js.map

package/dist/storage/sqlite/snapshot-store.js.map

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

package/dist/storage/sqlite/vector-store.d.ts

@@ -0,0 +1,28 @@
+import type { OrgId, QualifiedName, Sha256 } from "@ryanstark24/sfgraph-shared";
+import type { BetterSqlite3Database, BundleSearchHit, NodeSearchHit, VectorStore, VectorUpsertResult } from "../interfaces.js";
+export interface SqliteVectorStoreOptions {
+    dbPath: string;
+    dim?: number;
+    backupDir?: string;
+    retainBackups?: number;
+    db?: BetterSqlite3Database;
+    skipMigrations?: boolean;
+}
+export declare class SqliteVectorStore implements VectorStore {
+    readonly db: BetterSqlite3Database;
+    private readonly ownsDb;
+    private readonly opts;
+    private initialized;
+    constructor(opts: SqliteVectorStoreOptions);
+    init(): Promise<void>;
+    close(): Promise<void>;
+    private toBlob;
+    upsertNodeVector(orgId: OrgId, qname: QualifiedName, label: string, vector: Float32Array, contentHash: Sha256): VectorUpsertResult;
+    upsertBundleVector(orgId: OrgId, bundleId: string, vector: Float32Array, contentHash: Sha256): VectorUpsertResult;
+    searchNodes(orgId: OrgId, query: Float32Array, k: number, opts?: {
+        label?: string;
+    }): NodeSearchHit[];
+    searchBundles(orgId: OrgId, query: Float32Array, k: number): BundleSearchHit[];
+    countNodeVectors(orgId: OrgId): number;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/storage/sqlite/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/vector-store.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAIhF,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,WAAW,EACX,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,WAAW,CAAS;gBAEhB,IAAI,EAAE,wBAAwB;IAqBpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,MAAM;IAId,gBAAgB,CACd,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,GAClB,kBAAkB;IA+BrB,kBAAkB,CAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,GAClB,kBAAkB;IA8BrB,WAAW,CACT,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,YAAY,EACnB,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxB,aAAa,EAAE;IA0BlB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAe9E,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;CAOvC"}

package/dist/storage/sqlite/vector-store.js

@@ -0,0 +1,174 @@
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+import { ErrorCode, SfgraphError, StorageError, asQualifiedName, } from "@ryanstark24/sfgraph-shared";
+import Database from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import { validateLabel } from "../identifier.js";
+import { wrapAbiError } from "./load-better-sqlite3.js";
+import { MIGRATIONS, MigrationRunner } from "./migrations.js";
+export class SqliteVectorStore {
+    db;
+    ownsDb;
+    opts;
+    initialized = false;
+    constructor(opts) {
+        this.opts = opts;
+        if (opts.db) {
+            this.db = opts.db;
+            this.ownsDb = false;
+        }
+        else {
+            if (opts.dbPath !== ":memory:") {
+                const dir = path.dirname(opts.dbPath);
+                if (dir && dir !== ".")
+                    mkdirSync(dir, { recursive: true });
+            }
+            try {
+                this.db = new Database(opts.dbPath);
+            }
+            catch (e) {
+                const wrapped = wrapAbiError(e);
+                if (wrapped)
+                    throw wrapped;
+                throw e;
+            }
+            this.ownsDb = true;
+        }
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        if (this.ownsDb) {
+            this.db.pragma("journal_mode = WAL");
+            this.db.pragma("synchronous = NORMAL");
+            this.db.pragma("wal_autocheckpoint = 256");
+        }
+        if (!this.opts.skipMigrations) {
+            const backupDir = this.opts.backupDir ??
+                (this.opts.dbPath === ":memory:"
+                    ? path.join(process.cwd(), ".sfgraph-backups")
+                    : path.join(path.dirname(this.opts.dbPath), ".sfgraph-backups"));
+            const runner = new MigrationRunner(this.db, MIGRATIONS, {
+                backupDir,
+                retainBackups: this.opts.retainBackups ?? 5,
+            });
+            runner.applyPending();
+        }
+        // Make sure extension is loaded for query phase too (vec0 needs it on every connection).
+        try {
+            sqliteVec.load(this.db);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // Only swallow the benign "already loaded" case. Anything else means
+            // vec0 virtual tables won't work and the store would lie about being
+            // initialized — surface that as E_VECTOR_EXTENSION so callers know.
+            if (!/already/i.test(msg)) {
+                throw new SfgraphError(ErrorCode.E_VECTOR_EXTENSION, `failed to load sqlite-vec extension: ${msg}`, { cause: err instanceof Error ? err : undefined });
+            }
+        }
+        this.initialized = true;
+    }
+    async close() {
+        if (this.ownsDb)
+            this.db.close();
+    }
+    toBlob(vec) {
+        return Buffer.from(vec.buffer, vec.byteOffset, vec.byteLength);
+    }
+    upsertNodeVector(orgId, qname, label, vector, contentHash) {
+        validateLabel(label);
+        const meta = this.db
+            .prepare("SELECT content_hash, vec_rowid FROM _sfgraph_node_vector_meta WHERE org_id = ? AND qualified_name = ?")
+            .get(orgId, qname);
+        if (meta && meta.content_hash === contentHash) {
+            return { inserted: false, deduped: true };
+        }
+        const blob = this.toBlob(vector);
+        const apply = this.db.transaction(() => {
+            if (meta) {
+                this.db.prepare("DELETE FROM _sfgraph_node_vectors WHERE rowid = ?").run(meta.vec_rowid);
+            }
+            const info = this.db
+                .prepare("INSERT INTO _sfgraph_node_vectors(org_id, embedding) VALUES (?, ?)")
+                .run(orgId, blob);
+            const newRowid = Number(info.lastInsertRowid);
+            this.db
+                .prepare(`INSERT INTO _sfgraph_node_vector_meta(org_id, qualified_name, content_hash, label, vec_rowid)
+           VALUES (?, ?, ?, ?, ?)
+           ON CONFLICT(org_id, qualified_name) DO UPDATE SET content_hash=excluded.content_hash, label=excluded.label, vec_rowid=excluded.vec_rowid`)
+                .run(orgId, qname, contentHash, label, newRowid);
+        });
+        apply();
+        return { inserted: true, deduped: false };
+    }
+    upsertBundleVector(orgId, bundleId, vector, contentHash) {
+        const meta = this.db
+            .prepare("SELECT content_hash, vec_rowid FROM _sfgraph_bundle_vector_meta WHERE org_id = ? AND bundle_id = ?")
+            .get(orgId, bundleId);
+        if (meta && meta.content_hash === contentHash) {
+            return { inserted: false, deduped: true };
+        }
+        const blob = this.toBlob(vector);
+        const apply = this.db.transaction(() => {
+            if (meta) {
+                this.db.prepare("DELETE FROM _sfgraph_bundle_vectors WHERE rowid = ?").run(meta.vec_rowid);
+            }
+            const info = this.db
+                .prepare("INSERT INTO _sfgraph_bundle_vectors(org_id, embedding) VALUES (?, ?)")
+                .run(orgId, blob);
+            const newRowid = Number(info.lastInsertRowid);
+            this.db
+                .prepare(`INSERT INTO _sfgraph_bundle_vector_meta(org_id, bundle_id, content_hash, vec_rowid)
+           VALUES (?, ?, ?, ?)
+           ON CONFLICT(org_id, bundle_id) DO UPDATE SET content_hash=excluded.content_hash, vec_rowid=excluded.vec_rowid`)
+                .run(orgId, bundleId, contentHash, newRowid);
+        });
+        apply();
+        return { inserted: true, deduped: false };
+    }
+    searchNodes(orgId, query, k, opts) {
+        if (k <= 0)
+            return [];
+        const blob = this.toBlob(query);
+        let sql = `SELECT meta.qualified_name AS qname, meta.label AS label, vec.distance AS distance
+               FROM _sfgraph_node_vectors AS vec
+               JOIN _sfgraph_node_vector_meta AS meta ON meta.vec_rowid = vec.rowid
+               WHERE vec.org_id = ? AND vec.embedding MATCH ? AND k = ?`;
+        const params = [orgId, blob, k];
+        if (opts?.label) {
+            validateLabel(opts.label);
+            sql += " AND meta.label = ?";
+            params.push(opts.label);
+        }
+        sql += " ORDER BY vec.distance";
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((r) => ({
+            qname: asQualifiedName(r.qname),
+            label: r.label,
+            distance: r.distance,
+        }));
+    }
+    searchBundles(orgId, query, k) {
+        if (k <= 0)
+            return [];
+        const blob = this.toBlob(query);
+        const rows = this.db
+            .prepare(`SELECT meta.bundle_id AS bundle_id, vec.distance AS distance
+         FROM _sfgraph_bundle_vectors AS vec
+         JOIN _sfgraph_bundle_vector_meta AS meta ON meta.vec_rowid = vec.rowid
+         WHERE vec.org_id = ? AND vec.embedding MATCH ? AND k = ?
+         ORDER BY vec.distance`)
+            .all(orgId, blob, k);
+        return rows.map((r) => ({ bundleId: r.bundle_id, distance: r.distance }));
+    }
+    countNodeVectors(orgId) {
+        const row = this.db
+            .prepare("SELECT COUNT(*) AS c FROM _sfgraph_node_vector_meta WHERE org_id = ?")
+            .get(orgId);
+        if (!row)
+            throw new StorageError("count query failed");
+        return row.c;
+    }
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/storage/sqlite/vector-store.js.map

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

package/dist/telemetry/__tests__/event-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-schema.test.d.ts.map

package/dist/telemetry/__tests__/event-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-schema.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/__tests__/event-schema.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/__tests__/event-schema.test.js

@@ -0,0 +1,56 @@
+import { describe, expect, it } from "vitest";
+import { validateEvent } from "../event-schema.js";
+describe("validateEvent", () => {
+    it("accepts a valid cli_command event", () => {
+        expect(validateEvent({
+            kind: "cli_command",
+            ts: 1,
+            command: "ingest",
+            durationMs: 10,
+            exitCode: 0,
+        })).toEqual({ ok: true });
+    });
+    it("accepts a valid tool_invoked event", () => {
+        expect(validateEvent({
+            kind: "tool_invoked",
+            ts: 1,
+            tool: "ping",
+            durationMs: 1,
+            ok: true,
+        })).toEqual({ ok: true });
+    });
+    it("rejects unknown kind", () => {
+        const r = validateEvent({ kind: "bogus", ts: 1 });
+        expect(r.ok).toBe(false);
+    });
+    it("rejects unknown field", () => {
+        const r = validateEvent({
+            kind: "cli_command",
+            ts: 1,
+            command: "x",
+            durationMs: 1,
+            exitCode: 0,
+            hacker: "bad",
+        });
+        expect(r.ok).toBe(false);
+    });
+    it("rejects wrong type", () => {
+        const r = validateEvent({
+            kind: "cli_command",
+            ts: "not a number",
+            command: "x",
+            durationMs: 1,
+            exitCode: 0,
+        });
+        expect(r.ok).toBe(false);
+    });
+    it("rejects missing required field", () => {
+        const r = validateEvent({ kind: "cli_command", ts: 1, command: "x", durationMs: 1 });
+        expect(r.ok).toBe(false);
+    });
+    it("rejects non-object event", () => {
+        expect(validateEvent(null).ok).toBe(false);
+        expect(validateEvent("x").ok).toBe(false);
+    });
+});
+//# sourceMappingURL=event-schema.test.js.map

package/dist/telemetry/__tests__/event-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-schema.test.js","sourceRoot":"","sources":["../../../src/telemetry/__tests__/event-schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CACJ,aAAa,CAAC;YACZ,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE,CAAC;YACL,OAAO,EAAE,QAAQ;YACjB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,CAAC;SACZ,CAAC,CACH,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CACJ,aAAa,CAAC;YACZ,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,CAAC;YACL,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,CAAC;YACb,EAAE,EAAE,IAAI;SACT,CAAC,CACH,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,aAAa,CAAC;YACtB,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE,CAAC;YACL,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,GAAG,aAAa,CAAC;YACtB,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE,cAAc;YAClB,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/telemetry/__tests__/machine-id.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=machine-id.test.d.ts.map

package/dist/telemetry/__tests__/machine-id.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-id.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/__tests__/machine-id.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/__tests__/machine-id.test.js

@@ -0,0 +1,33 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { getOrCreateMachineId, resetMachineId } from "../machine-id.js";
+let dir;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), "sfgraph-test-"));
+});
+afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+});
+describe("machine-id", () => {
+    it("returns null when telemetry is disabled", () => {
+        expect(getOrCreateMachineId({ telemetryEnabled: false, configDir: dir })).toBeNull();
+    });
+    it("creates and persists when enabled", () => {
+        const id1 = getOrCreateMachineId({ telemetryEnabled: true, configDir: dir });
+        const id2 = getOrCreateMachineId({ telemetryEnabled: true, configDir: dir });
+        expect(id1).toBeTruthy();
+        expect(id1).toBe(id2);
+    });
+    it("reset generates a new id", () => {
+        const id1 = getOrCreateMachineId({ telemetryEnabled: true, configDir: dir });
+        const id2 = resetMachineId({ telemetryEnabled: true, configDir: dir });
+        expect(id2).toBeTruthy();
+        expect(id1).not.toBe(id2);
+    });
+    it("reset returns null when disabled", () => {
+        expect(resetMachineId({ telemetryEnabled: false, configDir: dir })).toBeNull();
+    });
+});
+//# sourceMappingURL=machine-id.test.js.map

package/dist/telemetry/__tests__/machine-id.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-id.test.js","sourceRoot":"","sources":["../../../src/telemetry/__tests__/machine-id.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE,IAAI,GAAW,CAAC;AAChB,UAAU,CAAC,GAAG,EAAE;IACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AACH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvF,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,cAAc,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/telemetry/__tests__/pipeline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline.test.d.ts.map

package/dist/telemetry/__tests__/pipeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/__tests__/pipeline.test.ts"],"names":[],"mappings":""}