@trillboards/edge-core 0.2.1 → 0.2.3

package/dist/SignalBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SignalBuffer.d.ts","sourceRoot":"","sources":["../src/SignalBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,YAAY,QAAQ;IACpC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,MAAM;IACtC,MAAM,CAAC,QAAQ,CAAC,UAAU,SAAuB;IACjD,MAAM,CAAC,QAAQ,CAAC,WAAW,KAAK;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,OAAO;IAElC,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,kBAAkB,CAAsC;IAChE,OAAO,CAAC,oBAAoB,CAAsC;gBAEtD,MAAM,EAAE,MAAM;IAkD1B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYpD;;;OAGG;IACH,WAAW,CACT,aAAa,EAAE,aAAa,EAC5B,KAAK,GAAE,MAAsC,GAC5C,MAAM;IA8BT;;OAEG;IACH,eAAe,IAAI,MAAM;IAMzB;;OAEG;IACH,KAAK,IAAI,MAAM;IAKf;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB"}
+{"version":3,"file":"SignalBuffer.d.ts","sourceRoot":"","sources":["../src/SignalBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,YAAY,QAAQ;IACpC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,MAAM;IACtC,MAAM,CAAC,QAAQ,CAAC,UAAU,SAAuB;IACjD,MAAM,CAAC,QAAQ,CAAC,WAAW,KAAK;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,OAAO;IAElC,OAAO,CAAC,KAAK,CAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;gBAExB,MAAM,EAAE,MAAM;IAiC1B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYpD;;;;OAIG;IACH,WAAW,CACT,aAAa,EAAE,aAAa,EAC5B,KAAK,GAAE,MAAsC,GAC5C,MAAM;IA8BT;;OAEG;IACH,eAAe,IAAI,MAAM;IAKzB;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,KAAK,IAAI,gBAAgB;IAIzB;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/SignalBuffer.js

@@ -1,92 +1,73 @@
 "use strict";
 /**
- * SignalBuffer — Offline signal buffering using better-sqlite3.
- * Port of SignalBuffer.kt (Room database) to cross-platform SQLite.
+ * SignalBuffer — Offline signal buffering with auto-detecting backend.
+ * Port of SignalBuffer.kt (Room database) to cross-platform storage.
+ *
+ * Backends:
+ *   - SqliteStore   (better-sqlite3 installed → WAL mode, prepared stmts)
+ *   - JsonFileStore (fallback → zero deps, fs.renameSync atomic writes)
+ *
+ * Auto-detection: tries require('better-sqlite3') at construction time.
+ * If unavailable (native compilation failed, not installed), falls back
+ * to JsonFileStore — guaranteed to work on any Node.js >=18 platform.
  *
  * Capacity: 8,640 signals (24h at 6 signals/min)
  * Eviction: oldest 10% when at capacity
  * Flush: batch of 50, marks with _buffered and _bufferedAt
  * Pruning: signals older than 24h auto-deleted
+ * Priority: FACE_BACKED > PERSON_BACKED > SPEECH_ONLY > PROXY_ONLY > EMPTY
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SignalBuffer = void 0;
-const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
+const JsonFileStore_1 = require("./JsonFileStore");
 class SignalBuffer {
     constructor(dbPath) {
-        const dir = path.dirname(dbPath);
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
+        let store = null;
+        let backend = 'json';
+        // Try SQLite first (high-performance, optional)
+        try {
+            // Dynamic require — only resolves if better-sqlite3 is installed + compiled
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const Database = require('better-sqlite3');
+            const { SqliteStore } = require('./SqliteStore');
+            store = new SqliteStore(dbPath, Database);
+            backend = 'sqlite';
+        }
+        catch {
+            // better-sqlite3 not available — fall back to JSON file store
         }
-        this.db = new better_sqlite3_1.default(dbPath);
-        this.db.pragma('journal_mode = WAL');
-        this.db.pragma('synchronous = NORMAL');
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS buffered_signals (
-        id INTEGER PRIMARY KEY AUTOINCREMENT,
-        payload TEXT NOT NULL,
-        timestamp INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000),
-        retry_count INTEGER NOT NULL DEFAULT 0
-      )
-    `);
-        this.db.exec(`
-      CREATE INDEX IF NOT EXISTS idx_signals_timestamp ON buffered_signals(timestamp)
-    `);
-        // Prepared statements for performance
-        this.insertStmt = this.db.prepare('INSERT INTO buffered_signals (payload, timestamp, retry_count) VALUES (?, ?, 0)');
-        this.getOldestStmt = this.db.prepare('SELECT id, payload, timestamp, retry_count FROM buffered_signals ORDER BY timestamp ASC LIMIT ?');
-        this.deleteByIdStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id = ?');
-        this.countStmt = this.db.prepare('SELECT COUNT(*) as count FROM buffered_signals');
-        this.pruneStmt = this.db.prepare('DELETE FROM buffered_signals WHERE timestamp < ?');
-        this.deleteOldestNStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id IN (SELECT id FROM buffered_signals ORDER BY timestamp ASC LIMIT ?)');
-        this.incrementRetryStmt = this.db.prepare('UPDATE buffered_signals SET retry_count = retry_count + 1 WHERE id = ?');
-        this.deleteMaxRetriesStmt = this.db.prepare('DELETE FROM buffered_signals WHERE retry_count >= ?');
+        if (!store) {
+            // Use JSON file store — zero dependencies, universal
+            const jsonPath = dbPath.replace(/\.db$/, '.json');
+            store = new JsonFileStore_1.JsonFileStore(jsonPath);
+            backend = 'json';
+        }
+        this.store = store;
+        this.backend = backend;
+        const label = backend === 'sqlite'
+            ? 'SQLite (disk-persistent, WAL mode)'
+            : 'JSON file (disk-persistent, atomic writes)';
+        console.log(`[SignalBuffer] Initialized: ${label}`);
     }
     /**
      * Buffer a signal for later sending.
      * If at capacity, evicts oldest 10% first.
      */
     bufferSignal(payload) {
-        const count = this.count();
+        const count = this.store.count();
         if (count >= SignalBuffer.MAX_CAPACITY) {
             const evictCount = Math.ceil(SignalBuffer.MAX_CAPACITY * SignalBuffer.EVICT_RATIO);
-            this.deleteOldestNStmt.run(evictCount);
+            this.store.deleteOldestN(evictCount);
         }
-        this.insertStmt.run(JSON.stringify(payload), Date.now());
+        this.store.insert(JSON.stringify(payload), Date.now());
     }
     /**
      * Flush buffered signals via socket.
      * Returns number of successfully sent signals.
+     * Signals are flushed in priority order — highest evidence grade first.
      */
     flushBuffer(socketManager, limit = SignalBuffer.FLUSH_BATCH_SIZE) {
-        const signals = this.getOldestStmt.all(limit);
+        const signals = this.store.getOldest(limit);
         let sent = 0;
         for (const signal of signals) {
             try {
@@ -96,20 +77,20 @@ class SignalBuffer {
                 payload._bufferedAt = signal.timestamp;
                 const success = socketManager.emitAudienceSignal(payload);
                 if (success) {
-                    this.deleteByIdStmt.run(signal.id);
+                    this.store.deleteById(signal.id);
                     sent++;
                 }
                 else {
-                    this.incrementRetryStmt.run(signal.id);
+                    this.store.incrementRetry(signal.id);
                 }
             }
             catch {
                 // Corrupted payload — remove it
-                this.deleteByIdStmt.run(signal.id);
+                this.store.deleteById(signal.id);
             }
         }
         // Clean up signals that have exceeded max retries
-        this.deleteMaxRetriesStmt.run(SignalBuffer.MAX_RETRIES);
+        this.store.deleteExceedingRetries(SignalBuffer.MAX_RETRIES);
         return sent;
     }
     /**
@@ -117,21 +98,25 @@ class SignalBuffer {
      */
     pruneOldSignals() {
         const cutoff = Date.now() - SignalBuffer.MAX_AGE_MS;
-        const result = this.pruneStmt.run(cutoff);
-        return result.changes;
+        return this.store.deleteOlderThan(cutoff);
     }
     /**
      * Current number of buffered signals.
      */
     count() {
-        const row = this.countStmt.get();
-        return row.count;
+        return this.store.count();
+    }
+    /**
+     * Signal buffer statistics — count by evidence grade, oldest timestamp.
+     */
+    stats() {
+        return this.store.stats();
     }
     /**
-     * Close the database connection.
+     * Close the store connection.
      */
     shutdown() {
-        this.db.close();
+        this.store.close();
     }
 }
 exports.SignalBuffer = SignalBuffer;

package/dist/SignalBuffer.js.map

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

package/dist/SignalStore.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SignalStore — Internal interface for signal-aware persistence backends.
+ *
+ * The SignalBuffer delegates all storage operations to a SignalStore implementation.
+ * Two built-in implementations:
+ *   - JsonFileStore  (zero dependencies, universal default)
+ *   - SqliteStore    (optional, high-throughput upgrade via better-sqlite3)
+ *
+ * Advanced users can implement this interface for custom backends (Redis, IndexedDB, etc.)
+ */
+export interface StoredSignal {
+    id: number;
+    payload: string;
+    timestamp: number;
+    retryCount: number;
+    evidenceGrade?: string;
+}
+export interface SignalStoreStats {
+    total: number;
+    byEvidenceGrade: Record<string, number>;
+    oldestTimestampMs: number | null;
+}
+export interface SignalStore {
+    insert(payload: string, timestamp: number): void;
+    getOldest(limit: number): StoredSignal[];
+    deleteById(id: number): void;
+    deleteOlderThan(cutoffMs: number): number;
+    deleteOldestN(n: number): void;
+    deleteExceedingRetries(maxRetries: number): void;
+    incrementRetry(id: number): void;
+    count(): number;
+    stats(): SignalStoreStats;
+    close(): void;
+}
+//# sourceMappingURL=SignalStore.d.ts.map

package/dist/SignalStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalStore.d.ts","sourceRoot":"","sources":["../src/SignalStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACzC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,MAAM,CAAC;IAChB,KAAK,IAAI,gBAAgB,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/SignalStore.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * SignalStore — Internal interface for signal-aware persistence backends.
+ *
+ * The SignalBuffer delegates all storage operations to a SignalStore implementation.
+ * Two built-in implementations:
+ *   - JsonFileStore  (zero dependencies, universal default)
+ *   - SqliteStore    (optional, high-throughput upgrade via better-sqlite3)
+ *
+ * Advanced users can implement this interface for custom backends (Redis, IndexedDB, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SignalStore.js.map

package/dist/SignalStore.js.map

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

package/dist/SqliteStore.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SqliteStore — High-performance signal store using better-sqlite3.
+ * Extracted from the original SignalBuffer implementation.
+ *
+ * WAL journal mode, prepared statements, evidence_grade column + index
+ * for priority-aware flushing (FACE_BACKED sent first).
+ *
+ * Only loaded when better-sqlite3 is available (optional dependency).
+ */
+import type { SignalStore, StoredSignal, SignalStoreStats } from './SignalStore';
+import type { Database as DatabaseType } from 'better-sqlite3';
+export declare class SqliteStore implements SignalStore {
+    private db;
+    private insertStmt;
+    private getOldestStmt;
+    private deleteByIdStmt;
+    private countStmt;
+    private pruneStmt;
+    private deleteOldestNStmt;
+    private incrementRetryStmt;
+    private deleteMaxRetriesStmt;
+    private statsStmt;
+    private oldestStmt;
+    /**
+     * @param dbPath - Path to the SQLite database file
+     * @param DatabaseConstructor - The better-sqlite3 Database constructor (injected to avoid top-level require)
+     */
+    constructor(dbPath: string, DatabaseConstructor: new (filename: string) => DatabaseType);
+    private extractEvidenceGrade;
+    insert(payload: string, timestamp: number): void;
+    getOldest(limit: number): StoredSignal[];
+    deleteById(id: number): void;
+    deleteOlderThan(cutoffMs: number): number;
+    deleteOldestN(n: number): void;
+    deleteExceedingRetries(maxRetries: number): void;
+    incrementRetry(id: number): void;
+    count(): number;
+    stats(): SignalStoreStats;
+    close(): void;
+}
+//# sourceMappingURL=SqliteStore.d.ts.map

package/dist/SqliteStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStore.d.ts","sourceRoot":"","sources":["../src/SqliteStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,qBAAa,WAAY,YAAW,WAAW;IAC7C,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,kBAAkB,CAAsC;IAChE,OAAO,CAAC,oBAAoB,CAAsC;IAClE,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,UAAU,CAAsC;IAExD;;;OAGG;gBAED,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,YAAY;IA4F7D,OAAO,CAAC,oBAAoB;IAW5B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKhD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IAIxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKzC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9B,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIhC,KAAK,IAAI,MAAM;IAKf,KAAK,IAAI,gBAAgB;IAoBzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/SqliteStore.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * SqliteStore — High-performance signal store using better-sqlite3.
+ * Extracted from the original SignalBuffer implementation.
+ *
+ * WAL journal mode, prepared statements, evidence_grade column + index
+ * for priority-aware flushing (FACE_BACKED sent first).
+ *
+ * Only loaded when better-sqlite3 is available (optional dependency).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteStore = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+class SqliteStore {
+    /**
+     * @param dbPath - Path to the SQLite database file
+     * @param DatabaseConstructor - The better-sqlite3 Database constructor (injected to avoid top-level require)
+     */
+    constructor(dbPath, DatabaseConstructor) {
+        const dir = path.dirname(dbPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.db = new DatabaseConstructor(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS buffered_signals (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        payload TEXT NOT NULL,
+        timestamp INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000),
+        retry_count INTEGER NOT NULL DEFAULT 0,
+        evidence_grade TEXT NOT NULL DEFAULT 'EMPTY'
+      )
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_signals_timestamp ON buffered_signals(timestamp)
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_signals_evidence_grade ON buffered_signals(evidence_grade)
+    `);
+        // Migrate existing rows that lack evidence_grade (from pre-0.2.2 databases)
+        try {
+            // Check if evidence_grade column exists by querying pragma
+            const columns = this.db
+                .prepare("PRAGMA table_info('buffered_signals')")
+                .all();
+            const hasGradeCol = columns.some((c) => c.name === 'evidence_grade');
+            if (!hasGradeCol) {
+                this.db.exec("ALTER TABLE buffered_signals ADD COLUMN evidence_grade TEXT NOT NULL DEFAULT 'EMPTY'");
+                this.db.exec("CREATE INDEX IF NOT EXISTS idx_signals_evidence_grade ON buffered_signals(evidence_grade)");
+            }
+        }
+        catch {
+            // Column already exists or migration not needed
+        }
+        // Prepared statements
+        this.insertStmt = this.db.prepare('INSERT INTO buffered_signals (payload, timestamp, retry_count, evidence_grade) VALUES (?, ?, 0, ?)');
+        this.getOldestStmt = this.db.prepare(`
+      SELECT id, payload, timestamp, retry_count as retryCount, evidence_grade as evidenceGrade
+      FROM buffered_signals
+      ORDER BY
+        CASE evidence_grade
+          WHEN 'FACE_BACKED' THEN 1
+          WHEN 'PERSON_BACKED' THEN 2
+          WHEN 'SPEECH_ONLY' THEN 3
+          WHEN 'PROXY_ONLY' THEN 4
+          ELSE 5
+        END,
+        timestamp ASC
+      LIMIT ?
+    `);
+        this.deleteByIdStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id = ?');
+        this.countStmt = this.db.prepare('SELECT COUNT(*) as count FROM buffered_signals');
+        this.pruneStmt = this.db.prepare('DELETE FROM buffered_signals WHERE timestamp < ?');
+        this.deleteOldestNStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id IN (SELECT id FROM buffered_signals ORDER BY timestamp ASC LIMIT ?)');
+        this.incrementRetryStmt = this.db.prepare('UPDATE buffered_signals SET retry_count = retry_count + 1 WHERE id = ?');
+        this.deleteMaxRetriesStmt = this.db.prepare('DELETE FROM buffered_signals WHERE retry_count >= ?');
+        this.statsStmt = this.db.prepare('SELECT evidence_grade as grade, COUNT(*) as cnt FROM buffered_signals GROUP BY evidence_grade');
+        this.oldestStmt = this.db.prepare('SELECT MIN(timestamp) as oldest FROM buffered_signals');
+    }
+    extractEvidenceGrade(payload) {
+        try {
+            const parsed = JSON.parse(payload);
+            return typeof parsed.evidenceGrade === 'string'
+                ? parsed.evidenceGrade
+                : 'EMPTY';
+        }
+        catch {
+            return 'EMPTY';
+        }
+    }
+    insert(payload, timestamp) {
+        const grade = this.extractEvidenceGrade(payload);
+        this.insertStmt.run(payload, timestamp, grade);
+    }
+    getOldest(limit) {
+        return this.getOldestStmt.all(limit);
+    }
+    deleteById(id) {
+        this.deleteByIdStmt.run(id);
+    }
+    deleteOlderThan(cutoffMs) {
+        const result = this.pruneStmt.run(cutoffMs);
+        return result.changes;
+    }
+    deleteOldestN(n) {
+        this.deleteOldestNStmt.run(n);
+    }
+    deleteExceedingRetries(maxRetries) {
+        this.deleteMaxRetriesStmt.run(maxRetries);
+    }
+    incrementRetry(id) {
+        this.incrementRetryStmt.run(id);
+    }
+    count() {
+        const row = this.countStmt.get();
+        return row.count;
+    }
+    stats() {
+        const rows = this.statsStmt.all();
+        const byGrade = {};
+        for (const row of rows) {
+            byGrade[row.grade] = row.cnt;
+        }
+        const oldestRow = this.oldestStmt.get();
+        return {
+            total: this.count(),
+            byEvidenceGrade: byGrade,
+            oldestTimestampMs: oldestRow.oldest,
+        };
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.SqliteStore = SqliteStore;
+//# sourceMappingURL=SqliteStore.js.map

package/dist/SqliteStore.js.map

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

package/dist/StatusServer.d.ts

@@ -0,0 +1,99 @@
+/**
+ * StatusServer — HTTP server exposing device status, health, and Prometheus metrics.
+ *
+ * Runs inside the EdgeAgent process on a configurable port (default 9090).
+ * Uses ONLY Node.js built-in `http` module — zero external dependencies.
+ *
+ * Endpoints:
+ *   GET /status  — Full JSON status snapshot
+ *   GET /health  — Simple health probe (200 OK / 503 degraded)
+ *   GET /metrics — Prometheus-format text metrics
+ */
+export interface StatusServerOptions {
+    /** HTTP listen port. Default: 9090 */
+    port?: number;
+    /** HTTP listen host. Default: '0.0.0.0' */
+    host?: string;
+}
+export interface StatusData {
+    /** Device fingerprint */
+    fingerprint: string;
+    /** Assigned screen ID, or null if unassigned */
+    screenId: string | null;
+    /** Capability tier (1-4) */
+    tier: number;
+    /** Platform string, e.g. 'linux x64' */
+    platform: string;
+    /** Seconds since agent start (computed on read) */
+    uptime: number;
+    /** SDK version string */
+    sdkVersion: string;
+    /** Health snapshot from SubsystemHealthRegistry.toHeartbeatPayload() */
+    subsystemHealth: Record<string, unknown>;
+    /** Current sensing mode, e.g. 'edge_onnx', 'cloud', 'proxy_only' */
+    sensingMode: string;
+    /** Current detected face count */
+    currentFaceCount: number;
+    /** Average attention score (0-1) */
+    avgAttention: number;
+    /** Weighted VAS score (0-1) */
+    avgVAS: number;
+    /** Evidence grade, e.g. 'FACE_BACKED' */
+    evidenceGrade: string;
+    /** Number of signals currently buffered */
+    signalBufferCount: number;
+    /** Maximum buffer capacity */
+    signalBufferCapacity: number;
+    /** Whether the Socket.io connection is live */
+    socketConnected: boolean;
+    /** Epoch ms of last signal emit */
+    lastSignalTimestamp: number;
+    /** Total RSS memory usage in MB */
+    memoryUsageMb: number;
+    /** V8 heap used in MB */
+    heapUsedMb: number;
+    /** List of loaded model names, e.g. ['blazeFace', 'yamnet'] */
+    modelsLoaded: string[];
+    /** ONNX execution provider, e.g. 'cpu', 'openvino' */
+    executionProvider: string;
+    /** Whether federated learning is enabled */
+    federatedEnabled: boolean;
+    /** Epoch ms of last gradient upload */
+    lastGradientUpload: number;
+}
+export declare class StatusServer {
+    private server;
+    private statusData;
+    private startTime;
+    private port;
+    private host;
+    constructor(options?: StatusServerOptions);
+    /**
+     * Merge partial updates into the status snapshot.
+     * Call this from EdgeAgent whenever subsystem state changes.
+     */
+    updateStatus(partial: Partial<StatusData>): void;
+    /**
+     * Start the HTTP server. Resolves once the server is listening.
+     * If the port is already in use, logs a warning and resolves without starting.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the HTTP server gracefully. Resolves once all connections are closed.
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the current status snapshot with computed fields (uptime, memory).
+     * Also used by the status CLI command via the /status HTTP endpoint.
+     */
+    getStatus(): StatusData & {
+        uptime: number;
+        memoryUsageMb: number;
+        heapUsedMb: number;
+    };
+    private handleRequest;
+    private handleStatus;
+    private handleHealth;
+    private handleMetrics;
+}
+//# sourceMappingURL=StatusServer.d.ts.map

package/dist/StatusServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusServer.d.ts","sourceRoot":"","sources":["../src/StatusServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IAGzB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAInB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIzC,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAItB,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAI7B,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAI5B,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAInB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAI1B,4CAA4C;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uCAAuC;IACvC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AA2BD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,CAAC,EAAE,mBAAmB;IAOzC;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAIhD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;;OAGG;IACH,SAAS,IAAI,UAAU,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAcvF,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,aAAa;CAyDtB"}