@spinabot/brigade 0.1.2 → 1.0.1

package/dist/storage/local/index.js

@@ -0,0 +1,143 @@
+// src/storage/local/index.ts
+//
+// LocalBrigadeStore — adapter that targets the on-disk `~/.brigade/` layout.
+//
+// PR1 status: this is a STUB. Every sub-store throws `NotImplementedYet` until
+// its dedicated PR lands and wires it to the existing file code. The interface
+// shape is settled, so subsystems written against `ctx.store.X.Y(...)` can
+// already compile against `LocalBrigadeStore`; they just can't be CALLED yet
+// outside their wrapped subsystem's PR.
+//
+// Each later PR (one per domain) replaces one `throwingProxy<TStore>(...)`
+// below with a concrete `LocalXStore` class that calls the existing function
+// exports byte-for-byte. The on-disk semantics never change in filesystem
+// mode — all 2,154 existing tests must keep passing.
+import { NotImplementedYet } from "../store.js";
+import { LocalAuthStore } from "./auth-store.js";
+import { LocalBlobStore } from "./blob-store.js";
+import { LocalChannelStore } from "./channel-store.js";
+import { LocalConfigStore } from "./config-store.js";
+import { LocalCronStore } from "./cron-store.js";
+import { LocalExecApprovalStore } from "./exec-approval-store.js";
+import { LocalExtensionStore } from "./extension-store.js";
+import { LocalInstanceStore } from "./instance-store.js";
+import { LocalLogStore } from "./log-store.js";
+import { LocalMemoryStore } from "./memory-store.js";
+import { LocalMessageStore } from "./message-store.js";
+import { LocalOrgStore } from "./org-store.js";
+import { LocalSessionStore } from "./session-store.js";
+import { LocalSkillStore } from "./skill-store.js";
+import { LocalSubagentStore } from "./subagent-store.js";
+import { LocalWorkspaceStore } from "./workspace-store.js";
+// =============================================================================
+// Stub proxy — every method on this proxy throws `NotImplementedYet(name.method)`.
+// Replaced per-domain as each PR lands.
+// =============================================================================
+function throwingProxy(domain) {
+    return new Proxy({}, {
+        get(_target, prop) {
+            const method = String(prop);
+            // Allow the JS runtime's interrogation properties to return undefined
+            // quietly (then, Symbol.toPrimitive, util.inspect, etc.) so that
+            // debuggers, await chains, and console.log don't blow up.
+            if (typeof prop === "symbol")
+                return undefined;
+            if (method === "then" || method === "constructor")
+                return undefined;
+            return () => {
+                throw new NotImplementedYet(`${domain}.${method}`);
+            };
+        },
+    });
+}
+export class LocalBrigadeStore {
+    opts;
+    mode = "filesystem";
+    config;
+    auth;
+    execApprovals;
+    workspace;
+    org;
+    subagents;
+    memory;
+    skills;
+    instance;
+    logs;
+    cron;
+    channels;
+    extensions;
+    blobs;
+    sessions;
+    messages;
+    // (workspace is initialised in the constructor — see below)
+    // (memory is initialised in the constructor — see below)
+    // (sessions is initialised in the constructor — see below)
+    // (messages is initialised in the constructor — see below)
+    // (logs is initialised in the constructor — see below)
+    // (cron is initialised in the constructor — see below)
+    // (channels is initialised in the constructor — see below)
+    // (auth is initialised in the constructor — see below)
+    // (execApprovals is initialised in the constructor — see below)
+    // (skills is initialised in the constructor — see below)
+    // (extensions is initialised in the constructor — see below)
+    // (org is initialised in the constructor — see below)
+    // (subagents is initialised in the constructor — see below)
+    // (instance is initialised in the constructor — see below)
+    // (blobs is initialised in the constructor — see below)
+    constructor(opts) {
+        this.opts = opts;
+        // Real adapters — each wraps existing on-disk code byte-for-byte
+        // (filesystem mode behaviour unchanged; all 2,154 tests pass).
+        //   PR2  — config
+        //   PR3  — auth
+        //   PR5  — execApprovals
+        //   PR6  — workspace
+        //   PR8  — org (partial — chart cache + audit log)
+        //   PR10 — subagents (in-memory)
+        this.config = new LocalConfigStore(opts.stateDir);
+        this.auth = new LocalAuthStore(opts.stateDir);
+        this.execApprovals = new LocalExecApprovalStore(opts.stateDir);
+        this.workspace = new LocalWorkspaceStore(opts.stateDir);
+        this.org = new LocalOrgStore(opts.stateDir);
+        this.subagents = new LocalSubagentStore();
+        // PR7 — skills (6-source discovery + managed/workspace CRUD)
+        this.skills = new LocalSkillStore(opts.stateDir);
+        // PR11 — memory facts + notes + cursors + consolidate state
+        this.memory = new LocalMemoryStore(opts.stateDir);
+        // PR15 — gateway pid/heartbeat/lock + supervisor health
+        this.instance = new LocalInstanceStore(opts.stateDir);
+        // PR4 — event log + subsystem log + config-audit chain + config-health
+        this.logs = new LocalLogStore(opts.stateDir);
+        // PR9 — extensions discovery (read-only in filesystem mode)
+        this.extensions = new LocalExtensionStore(opts.stateDir);
+        // PR12 — cron jobs + per-job run-log (atomicity via withCronStoreLock)
+        this.cron = new LocalCronStore(opts.stateDir);
+        // PR13 — channels: allow-from + pairing + WhatsApp auth dir + media
+        this.channels = new LocalChannelStore(opts.stateDir);
+        // Cross-cut — content-addressed byte store under <stateDir>/blobs/
+        this.blobs = new LocalBlobStore(opts.stateDir);
+        // PR14 — sessions index + per-session transcript JSONL + inbox
+        this.sessions = new LocalSessionStore(opts.stateDir);
+        this.messages = new LocalMessageStore(opts.stateDir);
+    }
+    get stateDir() {
+        return this.opts.stateDir;
+    }
+    async init() {
+        // Per-sub-store `init` is called as each PR wires it; nothing to do yet.
+    }
+    async close() {
+        // Same as above.
+    }
+    async healthcheck() {
+        return {
+            ok: true,
+            details: {
+                mode: this.mode,
+                stateDir: this.stateDir,
+                note: "LocalBrigadeStore PR1 stub — sub-stores throw NotImplementedYet until their PR lands.",
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/storage/local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/local/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,6EAA6E;AAC7E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,wCAAwC;AACxC,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBhD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,gFAAgF;AAChF,mFAAmF;AACnF,wCAAwC;AACxC,gFAAgF;AAEhF,SAAS,aAAa,CAAmB,MAAc;IACtD,OAAO,IAAI,KAAK,CAAC,EAAO,EAAE;QACzB,GAAG,CAAC,OAAO,EAAE,IAAI;YAChB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,sEAAsE;YACtE,iEAAiE;YACjE,0DAA0D;YAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC/C,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,aAAa;gBAAE,OAAO,SAAS,CAAC;YACpE,OAAO,GAAG,EAAE;gBACX,MAAM,IAAI,iBAAiB,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;YACpD,CAAC,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAUD,MAAM,OAAO,iBAAiB;IAmCA;IAlCpB,IAAI,GAAG,YAAqB,CAAC;IAE7B,MAAM,CAAc;IACpB,IAAI,CAAY;IAChB,aAAa,CAAoB;IACjC,SAAS,CAAiB;IAC1B,GAAG,CAAW;IACd,SAAS,CAAgB;IACzB,MAAM,CAAc;IACpB,MAAM,CAAa;IACnB,QAAQ,CAAgB;IACxB,IAAI,CAAW;IACf,IAAI,CAAY;IAChB,QAAQ,CAAe;IACvB,UAAU,CAAiB;IAC3B,KAAK,CAAY;IACjB,QAAQ,CAAe;IACvB,QAAQ,CAAe;IAChC,4DAA4D;IAC5D,yDAAyD;IACzD,2DAA2D;IAC3D,2DAA2D;IAC3D,uDAAuD;IACvD,uDAAuD;IACvD,2DAA2D;IAC3D,uDAAuD;IACvD,gEAAgE;IAChE,yDAAyD;IACzD,6DAA6D;IAC7D,sDAAsD;IACtD,4DAA4D;IAC5D,2DAA2D;IAC3D,wDAAwD;IAExD,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;QACvD,iEAAiE;QACjE,+DAA+D;QAC/D,kBAAkB;QAClB,gBAAgB;QAChB,yBAAyB;QACzB,qBAAqB;QACrB,mDAAmD;QACnD,iCAAiC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC1C,6DAA6D;QAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,4DAA4D;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,wDAAwD;QACxD,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,uEAAuE;QACvE,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,4DAA4D;QAC5D,IAAI,CAAC,UAAU,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,uEAAuE;QACvE,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,oEAAoE;QACpE,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,mEAAmE;QACnE,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,+DAA+D;QAC/D,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI;QACT,yEAAyE;IAC1E,CAAC;IAED,KAAK,CAAC,KAAK;QACV,iBAAiB;IAClB,CAAC;IAED,KAAK,CAAC,WAAW;QAChB,OAAO;YACN,EAAE,EAAE,IAAI;YACR,OAAO,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,uFAAuF;aAC7F;SACD,CAAC;IACH,CAAC;CACD"}

package/dist/storage/local/instance-store.d.ts

@@ -0,0 +1,30 @@
+import type { GatewayLockHandle, InstanceStore, SuperviseDecision } from "../store.js";
+export declare class LocalInstanceStore implements InstanceStore {
+    private readonly _stateDir;
+    constructor(_stateDir: string);
+    writePid(_pid: number): Promise<void>;
+    readPid(): Promise<number | undefined>;
+    clearPid(): Promise<void>;
+    writeHeartbeat(_beat: {
+        ts: number;
+        pid: number;
+        uptimeMs: number;
+    }): Promise<void>;
+    readHeartbeat(): Promise<{
+        ts: number;
+        pid: number;
+        uptimeMs: number;
+    } | undefined>;
+    clearHeartbeat(): Promise<void>;
+    acquireLock(args: {
+        port: number;
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        staleMs?: number;
+    }): Promise<GatewayLockHandle>;
+    checkHealth(opts?: {
+        maxStaleMs?: number;
+        nowMs?: number;
+    }): Promise<SuperviseDecision>;
+}
+//# sourceMappingURL=instance-store.d.ts.map

package/dist/storage/local/instance-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-store.d.ts","sourceRoot":"","sources":["../../../src/storage/local/instance-store.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACX,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,MAAM,aAAa,CAAC;AAErB,qBAAa,kBAAmB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAItC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,cAAc,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnF,aAAa,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAKnF,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,WAAW,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBxB,WAAW,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgB7F"}

package/dist/storage/local/instance-store.js

@@ -0,0 +1,83 @@
+// src/storage/local/instance-store.ts
+//
+// LocalInstanceStore — filesystem-mode wrapper around the gateway-liveness
+// trio: `gateway.pid` / `gateway.heartbeat` / `gateway.lock` plus the
+// supervisor's `checkGatewayHealth`. Implements `InstanceStore`.
+//
+// Filesystem mode is the canonical home for these files — the `fs.open("wx")`
+// atomic-exclusive-create primitive used by `acquireGatewayLock` has no
+// Convex equivalent, so even in convex mode the lock stays local (per the
+// Phase 2 design's "5 carve-outs that always stay local").
+//
+// The public `writePid` / `writeHeartbeat` interfaces accept explicit args
+// but the underlying writers use `process.pid` / `process.uptime()` directly.
+// That matches today's behaviour — the lone production caller is the
+// gateway itself, which IS the current process. We accept the slight
+// contract relaxation as the price of byte-for-byte wrap discipline.
+import { clearHeartbeatFile, clearPidFile, readHeartbeatFile, readPidFile, writeHeartbeatFile, writePidFile, } from "../../core/gateway-probe.js";
+import { acquireGatewayLock, } from "../../core/gateway-lock.js";
+import { checkGatewayHealth } from "../../cli/commands/gateway-supervise.js";
+export class LocalInstanceStore {
+    _stateDir;
+    constructor(_stateDir) {
+        this._stateDir = _stateDir;
+    }
+    async writePid(_pid) {
+        // Underlying writer captures process.pid — matches today's behaviour;
+        // the lone production caller IS the gateway process. Tests that want
+        // a controlled PID write directly to the path the writer uses.
+        await writePidFile();
+    }
+    async readPid() {
+        return readPidFile();
+    }
+    async clearPid() {
+        await clearPidFile();
+    }
+    async writeHeartbeat(_beat) {
+        // Same shape as writePid — internal helper captures live process
+        // state. Caller's payload is ignored; today's gateway always writes
+        // from its own process.
+        await writeHeartbeatFile();
+    }
+    async readHeartbeat() {
+        const beat = readHeartbeatFile();
+        return beat ?? undefined;
+    }
+    async clearHeartbeat() {
+        await clearHeartbeatFile();
+    }
+    async acquireLock(args) {
+        const handle = await acquireGatewayLock({
+            port: args.port,
+            ...(args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}),
+            ...(args.pollIntervalMs !== undefined ? { pollIntervalMs: args.pollIntervalMs } : {}),
+            ...(args.staleMs !== undefined ? { staleMs: args.staleMs } : {}),
+        });
+        // Map internal handle to the public shape — the internal carries
+        // path/pid/release; port lives in the lock payload (not the handle).
+        // We surface the port the caller asked for, which by construction
+        // matches what landed in the file.
+        return {
+            port: args.port,
+            release: () => handle.release(),
+        };
+    }
+    async checkHealth(opts) {
+        // Internal `SuperviseOptions.nowMs` is a CLOCK FN (`() => number`),
+        // not a timestamp. The public interface takes a literal ms timestamp
+        // for ergonomics; wrap it in a constant clock when supplied.
+        const decision = await checkGatewayHealth({
+            ...(opts?.maxStaleMs !== undefined ? { maxStaleMs: opts.maxStaleMs } : {}),
+            ...(opts?.nowMs !== undefined ? { nowMs: () => opts.nowMs } : {}),
+        });
+        // `SuperviseDecision` internal type is a tagged union (healthy /
+        // dead-pid / no-heartbeat / stale / no-pid) — surface `.ok` plus
+        // the raw decision for callers that need to drill in.
+        return {
+            ok: decision.kind === "healthy",
+            ...decision,
+        };
+    }
+}
+//# sourceMappingURL=instance-store.js.map

package/dist/storage/local/instance-store.js.map

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

package/dist/storage/local/log-store.d.ts

@@ -0,0 +1,27 @@
+import type { ConfigAuditInput, ConfigAuditRecord, ConfigHealthRecord, LastErrorSnapshot, LogFilter, LogStore, SessionEventRecord, SubsystemLogFilter, SubsystemLogRecord, Unsub } from "../store.js";
+export declare class LocalLogStore implements LogStore {
+    private readonly _stateDir;
+    constructor(_stateDir: string);
+    appendSessionEvent(record: SessionEventRecord): Promise<void>;
+    readSessionEventTail(opts: {
+        day?: string;
+        maxBytes?: number;
+    }): Promise<SessionEventRecord[]>;
+    findLastSessionError(opts?: {
+        lookbackBytes?: number;
+    }): Promise<LastErrorSnapshot | undefined>;
+    appendSubsystemRecord(record: SubsystemLogRecord): Promise<void>;
+    readSubsystemRecords(filter: SubsystemLogFilter): Promise<SubsystemLogRecord[]>;
+    pruneSubsystemLogs(olderThanMs: number): Promise<{
+        removed: number;
+    }>;
+    appendConfigAudit(entry: ConfigAuditInput): Promise<ConfigAuditRecord>;
+    verifyConfigAuditChain(): Promise<{
+        ok: boolean;
+        brokenAt?: number;
+    }>;
+    writeConfigHealth(snapshot: ConfigHealthRecord): Promise<void>;
+    readConfigHealth(): Promise<ConfigHealthRecord | undefined>;
+    subscribe(filter: LogFilter, cb: (e: SubsystemLogRecord) => void): Unsub;
+}
+//# sourceMappingURL=log-store.d.ts.map

package/dist/storage/local/log-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-store.d.ts","sourceRoot":"","sources":["../../../src/storage/local/log-store.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EACX,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,EACL,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAc,YAAW,QAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAMxC,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,oBAAoB,CACzB,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQ1B,oBAAoB,CACzB,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IASnC,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhE,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgB/E,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQrE,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAatE,sBAAsB,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrE,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAKjE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,KAAK;CAmFxE"}

package/dist/storage/local/log-store.js

@@ -0,0 +1,185 @@
+// src/storage/local/log-store.ts
+//
+// LocalLogStore — filesystem-mode wrapper around the new public helpers
+// landed in PR4 across `core/event-logger.ts` + `logging/subsystem-logger.ts`
+// + `config/io.ts`. Implements `LogStore`.
+//
+// The existing in-process writers keep firing unchanged — the
+// `attachEventLogger` subscription still writes session events from Pi,
+// `createSubsystemLogger` still emits .info/.warn/.error records, and
+// `writeConfigSafe` still calls its internal `writeConfigHealth` +
+// `appendConfigAudit` helpers. This adapter is the typed seam through which
+// the storage layer reaches the same files.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { appendSessionEvent, getLastLoggedError, readSessionEventTail, } from "../../core/event-logger.js";
+import { appendSubsystemRecord, pruneSubsystemLogs, readSubsystemRecords, } from "../../logging/subsystem-logger.js";
+import { appendConfigAuditLine, readConfigHealthSnapshot, verifyConfigAuditChain, writeConfigHealthSnapshot, } from "../../config/io.js";
+import { resolveLogsDir } from "../../config/paths.js";
+import { watchFile } from "./file-watcher.js";
+export class LocalLogStore {
+    _stateDir;
+    constructor(_stateDir) {
+        this._stateDir = _stateDir;
+    }
+    // ---------------------------------------------------------------------
+    // Pi session events (today's `~/.brigade/logs/<YYYY-MM-DD>.jsonl`)
+    // ---------------------------------------------------------------------
+    async appendSessionEvent(record) {
+        appendSessionEvent(record);
+    }
+    async readSessionEventTail(opts) {
+        const rows = readSessionEventTail({
+            ...(opts.day !== undefined ? { day: opts.day } : {}),
+            ...(opts.maxBytes !== undefined ? { maxBytes: opts.maxBytes } : {}),
+        });
+        return rows;
+    }
+    async findLastSessionError(opts) {
+        const snapshot = getLastLoggedError(opts ?? {});
+        return snapshot;
+    }
+    // ---------------------------------------------------------------------
+    // Structured subsystem log (`~/.brigade/logs/brigade-<YYYY-MM-DD>.log`)
+    // ---------------------------------------------------------------------
+    async appendSubsystemRecord(record) {
+        const r = record;
+        if (!r.level || !r.subsystem || r.message === undefined) {
+            throw new Error("LocalLogStore.appendSubsystemRecord: record requires level + subsystem + message");
+        }
+        appendSubsystemRecord({
+            level: r.level,
+            subsystem: r.subsystem,
+            message: r.message,
+            ...(r.time !== undefined ? { time: r.time } : {}),
+            ...(r.fields !== undefined ? { fields: r.fields } : {}),
+        });
+    }
+    async readSubsystemRecords(filter) {
+        const f = filter;
+        const rows = readSubsystemRecords({
+            ...(f.level !== undefined ? { level: f.level } : {}),
+            ...(f.subsystem !== undefined ? { subsystem: f.subsystem } : {}),
+            ...(f.day !== undefined ? { day: f.day } : {}),
+            ...(f.tailBytes !== undefined ? { tailBytes: f.tailBytes } : {}),
+        });
+        return rows;
+    }
+    async pruneSubsystemLogs(olderThanMs) {
+        return pruneSubsystemLogs(olderThanMs);
+    }
+    // ---------------------------------------------------------------------
+    // Config-audit chain + config-health snapshot
+    // ---------------------------------------------------------------------
+    async appendConfigAudit(entry) {
+        const e = entry;
+        // The public ConfigAuditInput is loose (Record<string, unknown>) — we
+        // enforce the minimum (sha256 required) at the boundary.
+        if (typeof e.sha256 !== "string" || e.sha256.length === 0) {
+            throw new Error("LocalLogStore.appendConfigAudit: entry.sha256 is required (sha256 of the recorded payload)");
+        }
+        const record = appendConfigAuditLine(e);
+        return record;
+    }
+    async verifyConfigAuditChain() {
+        return verifyConfigAuditChain();
+    }
+    async writeConfigHealth(snapshot) {
+        writeConfigHealthSnapshot(snapshot);
+    }
+    async readConfigHealth() {
+        const record = readConfigHealthSnapshot();
+        return record;
+    }
+    subscribe(filter, cb) {
+        // Watch today's subsystem log file (rolls daily — for a multi-day
+        // subscribe we'd rewatch on rollover; filesystem mode is good enough
+        // with today-only tracking). On each change we read the tail bytes
+        // since our last-known size, parse new records, apply the caller's
+        // filter, and emit one callback per matching record.
+        const f = filter;
+        const dir = resolveLogsDir();
+        const today = new Date();
+        const yyyy = today.getFullYear().toString().padStart(4, "0");
+        const mm = (today.getMonth() + 1).toString().padStart(2, "0");
+        const dd = today.getDate().toString().padStart(2, "0");
+        const filePath = path.join(dir, `brigade-${yyyy}-${mm}-${dd}.log`);
+        // Seed lastSize at the current EOF so subscribers receive only NEW
+        // records, not the historical tail. (Reading the whole file backlog
+        // on every subscribe would surprise callers; if they want history
+        // they call `readSubsystemRecords` directly.)
+        let lastSize = 0;
+        try {
+            lastSize = fs.statSync(filePath).size;
+        }
+        catch {
+            lastSize = 0;
+        }
+        return watchFile(filePath, () => {
+            let stat;
+            try {
+                stat = fs.statSync(filePath);
+            }
+            catch {
+                return; // File gone — skip.
+            }
+            // Truncation / log rotation? Reset and emit nothing this tick;
+            // the next append starts a fresh window.
+            if (stat.size < lastSize) {
+                lastSize = stat.size;
+                return;
+            }
+            const sliceLen = stat.size - lastSize;
+            if (sliceLen <= 0)
+                return;
+            let chunk;
+            try {
+                const fd = fs.openSync(filePath, "r");
+                try {
+                    chunk = Buffer.alloc(sliceLen);
+                    fs.readSync(fd, chunk, 0, sliceLen, lastSize);
+                }
+                finally {
+                    fs.closeSync(fd);
+                }
+            }
+            catch {
+                return;
+            }
+            lastSize = stat.size;
+            const subFilter = f.subsystem;
+            const wantPrefix = subFilter !== undefined && subFilter.endsWith("/");
+            for (const line of chunk.toString("utf8").split("\n")) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                let row;
+                try {
+                    row = JSON.parse(trimmed);
+                }
+                catch {
+                    continue;
+                }
+                if (!row.level || !row.subsystem)
+                    continue;
+                if (f.level && row.level !== f.level)
+                    continue;
+                if (subFilter !== undefined) {
+                    if (wantPrefix) {
+                        if (!row.subsystem.startsWith(subFilter))
+                            continue;
+                    }
+                    else if (row.subsystem !== subFilter)
+                        continue;
+                }
+                try {
+                    cb(row);
+                }
+                catch {
+                    // One bad subscriber doesn't kill the rest of this batch.
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=log-store.js.map

package/dist/storage/local/log-store.js.map

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

package/dist/storage/local/memory-store.d.ts

@@ -0,0 +1,39 @@
+import type { ListFilter, MemoryDelta, MemoryLifecycle, MemoryRecord, MemoryStore, NewFact, RecordOriginFilter, Scope, Unsub } from "../store.js";
+export declare class LocalMemoryStore implements MemoryStore {
+    private readonly _stateDir;
+    constructor(_stateDir: string);
+    listFacts(filter: ListFilter): Promise<MemoryRecord[]>;
+    writeFact(fact: NewFact): Promise<MemoryRecord>;
+    searchFacts(query: string, opts: {
+        limit?: number;
+        markAccessed?: boolean;
+        origin?: RecordOriginFilter;
+    }): Promise<Array<MemoryRecord & {
+        score: number;
+    }>>;
+    markFactsAccessed(memoryIds: string[]): Promise<void>;
+    setFactsLifecycle(memoryIds: string[], lifecycle: MemoryLifecycle): Promise<void>;
+    countActiveFacts(): Promise<number>;
+    findSimilar(_text: string, _scope: Scope, _k?: number): Promise<Array<MemoryRecord & {
+        score: number;
+    }>>;
+    searchNotes(query: string, opts: unknown): Promise<unknown[]>;
+    readNote(relPath: string, opts: unknown): Promise<unknown>;
+    notesStatus(): Promise<unknown>;
+    getExtractCursor(sessionId: string): Promise<number>;
+    setExtractCursor(sessionId: string, processedCount: number): Promise<void>;
+    getConsolidateLastRunAt(): Promise<number | undefined>;
+    markConsolidateRunAt(at: number): Promise<void>;
+    decay(_now?: number): Promise<{
+        archived: number;
+        pruned: number;
+    }>;
+    subscribe(_scope: Scope, cb: (delta: MemoryDelta) => void): Unsub;
+    private factsFilePath;
+    private readFactsFromDisk;
+    private writeFactsToDisk;
+    listAllFactRecordsRaw(workspaceId: string): Promise<MemoryRecord[]>;
+    upsertFactRecordRaw(workspaceId: string, record: MemoryRecord): Promise<void>;
+    deleteFactRecordRaw(workspaceId: string, memoryId: string): Promise<void>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/storage/local/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/storage/local/memory-store.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,KAAK,EACL,KAAK,EACL,MAAM,aAAa,CAAC;AAiBrB,qBAAa,gBAAiB,YAAW,WAAW;IAKvC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAExC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKtD,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAK/C,WAAW,CAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;KAAE,GAC3E,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAS7C,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,WAAW,CAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,EACb,EAAE,CAAC,EAAE,MAAM,GACT,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAW7C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAK7D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B1E,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAetD,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IASzE,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,KAAK;IA+BjE,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,gBAAgB;IAUlB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAInE,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7E,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/E"}