@senpi/runtime 1.0.95-dev.20260408174401

package/dist/scanners/store/fs-utils.js

@@ -0,0 +1,47 @@
+import { access, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+/** Returns true when a filesystem path exists and is accessible. */
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Serializes JSON with stable formatting and writes atomically. */
+export async function writeJsonAtomic(path, data) {
+    const content = `${JSON.stringify(data, null, 2)}\n`;
+    await writeTextAtomic(path, content);
+}
+/**
+ * Writes text atomically by writing to a temporary file then renaming in-place.
+ * Ensures readers never observe partial content.
+ */
+export async function writeTextAtomic(path, content) {
+    const dir = dirname(path);
+    const tmpPath = `${path}.tmp-${process.pid}-${Date.now()}-${Math.random()
+        .toString(16)
+        .slice(2)}`;
+    await mkdir(dir, { recursive: true });
+    try {
+        await writeFile(tmpPath, content, "utf8");
+        await rename(tmpPath, path);
+    }
+    catch (error) {
+        await rm(tmpPath, { force: true });
+        throw error;
+    }
+}
+/** Reads and parses JSON; returns null when file does not exist or is invalid. */
+export async function readJsonFile(path) {
+    try {
+        const raw = await readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/scanners/store/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../../src/scanners/store/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAa;IAC/D,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACrD,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE;SACtE,QAAQ,CAAC,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACd,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,IAAY;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/scanners/store/index.d.ts

@@ -0,0 +1,5 @@
+export { SignalStore } from "./signal-store.js";
+export { RuntimeStore, type ScannerRuntimeState, type RuntimeSeed } from "./runtime-store.js";
+export { SharedArtifactStore } from "./shared-artifact-store.js";
+export { writeJsonAtomic, writeTextAtomic, readJsonFile, pathExists } from "./fs-utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scanners/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scanners/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/scanners/store/index.js

@@ -0,0 +1,5 @@
+export { SignalStore } from "./signal-store.js";
+export { RuntimeStore } from "./runtime-store.js";
+export { SharedArtifactStore } from "./shared-artifact-store.js";
+export { writeJsonAtomic, writeTextAtomic, readJsonFile, pathExists } from "./fs-utils.js";
+//# sourceMappingURL=index.js.map

package/dist/scanners/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scanners/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAA8C,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/scanners/store/runtime-store.d.ts

@@ -0,0 +1,50 @@
+import type { ScannerId } from "../types.js";
+/** Persisted mutable state for one scanner instance under one strategy. */
+export interface ScannerRuntimeState<Cfg = unknown, St = unknown> {
+    address: string;
+    scannerId: ScannerId;
+    config: Cfg;
+    state: St;
+    configVersion: number;
+    updatedAt: number;
+}
+/** Seed payload used when first creating runtime state via ensure(). */
+export interface RuntimeSeed<Cfg = unknown, St = unknown> {
+    config: Cfg;
+    state?: St;
+}
+/**
+ * Persists scanner runtime lifecycle state (config + state + version).
+ * Keyed by (address, scannerId), with one scanner instance per strategy.
+ */
+export declare class RuntimeStore {
+    private readonly stateDir;
+    private readonly now;
+    /**
+     * @param stateDir Root runtime state directory.
+     * @param now Injectable clock for deterministic tests.
+     */
+    constructor(stateDir: string, now?: () => number);
+    /** Reads persisted runtime state for a scanner instance. */
+    read<Cfg = unknown, St = unknown>(address: string, scannerId: ScannerId): Promise<ScannerRuntimeState<Cfg, St> | null>;
+    /** Writes full runtime state snapshot atomically. */
+    write<Cfg = unknown, St = unknown>(data: ScannerRuntimeState<Cfg, St>): Promise<void>;
+    /**
+     * Ensures runtime exists and returns it.
+     * Creates a new runtime with version=1 when missing.
+     */
+    ensure<Cfg = unknown, St = unknown>(address: string, scannerId: ScannerId, seed: RuntimeSeed<Cfg, St>): Promise<ScannerRuntimeState<Cfg, St>>;
+    /**
+     * Updates runtime config and increments configVersion.
+     * Throws when runtime does not exist to keep lifecycle explicit.
+     */
+    setConfig<Cfg = unknown, St = unknown>(address: string, scannerId: ScannerId, config: Cfg): Promise<ScannerRuntimeState<Cfg, St>>;
+    /**
+     * Updates runtime scanner-local state while preserving current config/version.
+     * Throws when runtime does not exist to avoid implicit bootstrap.
+     */
+    setState<Cfg = unknown, St = unknown>(address: string, scannerId: ScannerId, state: St): Promise<ScannerRuntimeState<Cfg, St>>;
+    /** Resolves runtime state file path for a scanner instance. */
+    private runtimePath;
+}
+//# sourceMappingURL=runtime-store.d.ts.map

package/dist/scanners/store/runtime-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-store.d.ts","sourceRoot":"","sources":["../../../src/scanners/store/runtime-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,EAAE,EAAE,CAAC;IACV,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO;IACtD,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,EAAE,CAAC;CACZ;AAED;;;GAGG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB;;;OAGG;gBAEgB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,MAAiB;IAG/C,4DAA4D;IACtD,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EACpC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IAM/C,qDAAqD;IAC/C,KAAK,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EACrC,IAAI,EAAE,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;OAGG;IACG,MAAM,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,GACzB,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAmBxC;;;OAGG;IACG,SAAS,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EACzC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAmBxC;;;OAGG;IACG,QAAQ,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EACxC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,EAAE,GACR,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAmBxC,+DAA+D;IAC/D,OAAO,CAAC,WAAW;CAUpB"}

package/dist/scanners/store/runtime-store.js

@@ -0,0 +1,91 @@
+import { join } from "node:path";
+import { readJsonFile, writeJsonAtomic } from "./fs-utils.js";
+/**
+ * Persists scanner runtime lifecycle state (config + state + version).
+ * Keyed by (address, scannerId), with one scanner instance per strategy.
+ */
+export class RuntimeStore {
+    stateDir;
+    now;
+    /**
+     * @param stateDir Root runtime state directory.
+     * @param now Injectable clock for deterministic tests.
+     */
+    constructor(stateDir, now = Date.now) {
+        this.stateDir = stateDir;
+        this.now = now;
+    }
+    /** Reads persisted runtime state for a scanner instance. */
+    async read(address, scannerId) {
+        return readJsonFile(this.runtimePath(address, scannerId));
+    }
+    /** Writes full runtime state snapshot atomically. */
+    async write(data) {
+        await writeJsonAtomic(this.runtimePath(data.address, data.scannerId), data);
+    }
+    /**
+     * Ensures runtime exists and returns it.
+     * Creates a new runtime with version=1 when missing.
+     */
+    async ensure(address, scannerId, seed) {
+        const existing = await this.read(address, scannerId);
+        if (existing) {
+            return existing;
+        }
+        const next = {
+            address,
+            scannerId,
+            config: seed.config,
+            state: (seed.state ?? {}),
+            configVersion: 1,
+            updatedAt: this.now(),
+        };
+        await this.write(next);
+        return next;
+    }
+    /**
+     * Updates runtime config and increments configVersion.
+     * Throws when runtime does not exist to keep lifecycle explicit.
+     */
+    async setConfig(address, scannerId, config) {
+        const existing = await this.read(address, scannerId);
+        if (!existing) {
+            throw new Error(`Runtime state not found for strategy '${address}' and scanner '${scannerId}'.`);
+        }
+        const next = {
+            address,
+            scannerId,
+            config,
+            state: existing.state,
+            configVersion: existing.configVersion + 1,
+            updatedAt: this.now(),
+        };
+        await this.write(next);
+        return next;
+    }
+    /**
+     * Updates runtime scanner-local state while preserving current config/version.
+     * Throws when runtime does not exist to avoid implicit bootstrap.
+     */
+    async setState(address, scannerId, state) {
+        const existing = await this.read(address, scannerId);
+        if (!existing) {
+            throw new Error(`Runtime state not found for strategy '${address}' and scanner '${scannerId}'.`);
+        }
+        const next = {
+            address,
+            scannerId,
+            config: existing.config,
+            state,
+            configVersion: existing.configVersion,
+            updatedAt: this.now(),
+        };
+        await this.write(next);
+        return next;
+    }
+    /** Resolves runtime state file path for a scanner instance. */
+    runtimePath(address, scannerId) {
+        return join(this.stateDir, "strategies", address, "scanners", scannerId, "runtime.json");
+    }
+}
+//# sourceMappingURL=runtime-store.js.map

package/dist/scanners/store/runtime-store.js.map

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

package/dist/scanners/store/shared-artifact-store.d.ts

@@ -0,0 +1,35 @@
+import type { SharedArtifactContract } from "../artifacts.js";
+import type { ArtifactEnvelope, ScannerId } from "../types.js";
+export interface ScannerContextStoreOptions {
+    contract?: SharedArtifactContract;
+}
+export interface LoadScannerContextOptions extends ScannerContextStoreOptions {
+    maxAgeMs?: number;
+}
+/**
+ * Stores strategy-scoped retained scanner context addressed by source scanner id.
+ * Each context-producing scanner owns one committed context envelope per strategy.
+ */
+export declare class SharedArtifactStore {
+    private readonly stateDir;
+    private readonly now;
+    /**
+     * @param stateDir Root runtime state directory.
+     * @param now Injectable clock for deterministic freshness checks in tests.
+     */
+    constructor(stateDir: string, now?: () => number);
+    /** Reads the full retained-context envelope for one strategy/scanner pair. */
+    loadEnvelopeByScanner<T>(address: string, scannerId: ScannerId, options?: ScannerContextStoreOptions): Promise<ArtifactEnvelope<T> | null>;
+    /** Writes the full retained-context envelope for one strategy/scanner pair. */
+    saveEnvelopeByScanner<T>(address: string, scannerId: ScannerId, envelope: ArtifactEnvelope<T>, options?: ScannerContextStoreOptions): Promise<void>;
+    /**
+     * Reads only the retained-context payload.
+     * Returns null when missing, invalid, or stale according to `maxAgeMs`.
+     */
+    loadByScanner<T>(address: string, scannerId: ScannerId, options?: LoadScannerContextOptions): Promise<T | null>;
+    /** Saves one retained-context payload by wrapping it in a timestamped envelope. */
+    saveByScanner<T>(address: string, scannerId: ScannerId, value: T, options?: ScannerContextStoreOptions): Promise<void>;
+    /** Resolves retained context path for one strategy and source scanner. */
+    private artifactPath;
+}
+//# sourceMappingURL=shared-artifact-store.d.ts.map

package/dist/scanners/store/shared-artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-artifact-store.d.ts","sourceRoot":"","sources":["../../../src/scanners/store/shared-artifact-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS/D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB;;;OAGG;gBAEgB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,MAAiB;IAG/C,8EAA8E;IACxE,qBAAqB,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiBtC,+EAA+E;IACzE,qBAAqB,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC7B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;OAGG;IACG,aAAa,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBpB,mFAAmF;IAC7E,aAAa,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC;IA0BhB,0EAA0E;IAC1E,OAAO,CAAC,YAAY;CASrB"}

package/dist/scanners/store/shared-artifact-store.js

@@ -0,0 +1,89 @@
+import { join } from "node:path";
+import { describeSchemaValidationError, isSchemaValueValid, } from "../schema-utils.js";
+import { readJsonFile, writeJsonAtomic } from "./fs-utils.js";
+/**
+ * Stores strategy-scoped retained scanner context addressed by source scanner id.
+ * Each context-producing scanner owns one committed context envelope per strategy.
+ */
+export class SharedArtifactStore {
+    stateDir;
+    now;
+    /**
+     * @param stateDir Root runtime state directory.
+     * @param now Injectable clock for deterministic freshness checks in tests.
+     */
+    constructor(stateDir, now = Date.now) {
+        this.stateDir = stateDir;
+        this.now = now;
+    }
+    /** Reads the full retained-context envelope for one strategy/scanner pair. */
+    async loadEnvelopeByScanner(address, scannerId, options = {}) {
+        const envelope = await readJsonFile(this.artifactPath(address, scannerId));
+        if (!isArtifactEnvelope(envelope)) {
+            return null;
+        }
+        if (options.contract?.schema &&
+            !isSchemaValueValid(options.contract.schema, envelope.data)) {
+            return null;
+        }
+        return envelope;
+    }
+    /** Writes the full retained-context envelope for one strategy/scanner pair. */
+    async saveEnvelopeByScanner(address, scannerId, envelope, options = {}) {
+        if (!isArtifactEnvelope(envelope)) {
+            throw new Error(`Invalid retained context envelope for scanner '${scannerId}'.`);
+        }
+        if (options.contract?.schema &&
+            !isSchemaValueValid(options.contract.schema, envelope.data)) {
+            throw new Error(`Invalid artifact value for scanner '${scannerId}': ${describeSchemaValidationError(options.contract.schema, envelope.data)}`);
+        }
+        await writeJsonAtomic(this.artifactPath(address, scannerId), envelope);
+    }
+    /**
+     * Reads only the retained-context payload.
+     * Returns null when missing, invalid, or stale according to `maxAgeMs`.
+     */
+    async loadByScanner(address, scannerId, options = {}) {
+        const envelope = await this.loadEnvelopeByScanner(address, scannerId, {
+            contract: options.contract,
+        });
+        if (!envelope) {
+            return null;
+        }
+        if (typeof options.maxAgeMs === "number" &&
+            this.now() - envelope.updatedAt > options.maxAgeMs) {
+            return null;
+        }
+        return envelope.data;
+    }
+    /** Saves one retained-context payload by wrapping it in a timestamped envelope. */
+    async saveByScanner(address, scannerId, value, options = {}) {
+        if (value === undefined) {
+            throw new Error(`Missing retained context payload for scanner '${scannerId}'.`);
+        }
+        if (options.contract?.schema &&
+            !isSchemaValueValid(options.contract.schema, value)) {
+            throw new Error(`Invalid artifact value for scanner '${scannerId}': ${describeSchemaValidationError(options.contract.schema, value)}`);
+        }
+        await this.saveEnvelopeByScanner(address, scannerId, {
+            updatedAt: this.now(),
+            data: value,
+        }, options);
+    }
+    /** Resolves retained context path for one strategy and source scanner. */
+    artifactPath(address, scannerId) {
+        return join(this.stateDir, "strategies", address, "shared", `${scannerId}.json`);
+    }
+}
+/** Runtime check for the lightweight artifact envelope shape. */
+function isArtifactEnvelope(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return typeof value.updatedAt === "number" && "data" in value;
+}
+/** Runtime check for plain object values. */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=shared-artifact-store.js.map

package/dist/scanners/store/shared-artifact-store.js.map

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

package/dist/scanners/store/signal-store.d.ts

@@ -0,0 +1,36 @@
+import type { ScannerDefinition } from "../scanner-definition.js";
+import type { ReadHistoryOptions, ReadSignalsFilter, ScanResult, Signal } from "../types.js";
+/**
+ * Persists scanner execution outputs per (address, scannerId).
+ * Stores one latest result plus optional bounded history depending on retention policy.
+ */
+export declare class SignalStore {
+    private readonly stateDir;
+    /** @param stateDir Root runtime state directory. */
+    constructor(stateDir: string);
+    /**
+     * Persists one scan result and applies retention behavior immediately.
+     * Use this as the single write path from engine execution.
+     */
+    write(result: ScanResult, definition: Pick<ScannerDefinition, "retention" | "retentionMaxRuns">): Promise<void>;
+    /** Reads the most recent persisted result for a scanner instance. */
+    readLatest(address: string, scannerId: string): Promise<ScanResult | null>;
+    /** Reads persisted history for a scanner instance, optionally limited to recent entries. */
+    readHistory(address: string, scannerId: string, opts?: ReadHistoryOptions): Promise<ScanResult[]>;
+    /**
+     * Queries latest signals across strategy/scanner folders.
+     * This is intended for user/tool queries and dashboard views.
+     */
+    readSignals(filter?: ReadSignalsFilter): Promise<Signal[]>;
+    /** Loads all latest results that match filter boundaries. */
+    private readAllLatestResults;
+    /** Reads line-delimited history JSON and returns empty list on file/parse errors. */
+    private readHistoryInternal;
+    /** Writes the full history snapshot as JSONL atomically. */
+    private writeHistory;
+    /** Resolves latest result path for a scanner instance. */
+    private latestPath;
+    /** Resolves history file path for a scanner instance. */
+    private historyPath;
+}
+//# sourceMappingURL=signal-store.d.ts.map

package/dist/scanners/store/signal-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-store.d.ts","sourceRoot":"","sources":["../../../src/scanners/store/signal-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,MAAM,EACP,MAAM,aAAa,CAAC;AAGrB;;;GAGG;AACH,qBAAa,WAAW;IAEV,OAAO,CAAC,QAAQ,CAAC,QAAQ;IADrC,oDAAoD;gBACvB,QAAQ,EAAE,MAAM;IAE7C;;;OAGG;IACG,KAAK,CACT,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,kBAAkB,CAAC,GACpE,OAAO,CAAC,IAAI,CAAC;IAoBhB,qEAAqE;IAC/D,UAAU,CACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI7B,4FAA4F;IACtF,WAAW,CACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC;IAUxB;;;OAGG;IACG,WAAW,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BpE,6DAA6D;YAC/C,oBAAoB;IA2ClC,qFAAqF;YACvE,mBAAmB;IAiBjC,4DAA4D;YAC9C,YAAY;IAO1B,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IAWlB,yDAAyD;IACzD,OAAO,CAAC,WAAW;CAUpB"}

package/dist/scanners/store/signal-store.js

@@ -0,0 +1,135 @@
+import { readdir, readFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { RetentionPolicy } from "../scanner-definition.js";
+import { pathExists, readJsonFile, writeJsonAtomic, writeTextAtomic } from "./fs-utils.js";
+/**
+ * Persists scanner execution outputs per (address, scannerId).
+ * Stores one latest result plus optional bounded history depending on retention policy.
+ */
+export class SignalStore {
+    stateDir;
+    /** @param stateDir Root runtime state directory. */
+    constructor(stateDir) {
+        this.stateDir = stateDir;
+    }
+    /**
+     * Persists one scan result and applies retention behavior immediately.
+     * Use this as the single write path from engine execution.
+     */
+    async write(result, definition) {
+        const latestPath = this.latestPath(result.address, result.scannerId);
+        const historyPath = this.historyPath(result.address, result.scannerId);
+        await writeJsonAtomic(latestPath, result);
+        if (definition.retention === RetentionPolicy.LAST_ONLY) {
+            await rm(historyPath, { force: true });
+            return;
+        }
+        const history = await this.readHistoryInternal(historyPath);
+        history.push(result);
+        if (definition.retention === RetentionPolicy.ROLLING_WINDOW) {
+            const maxRuns = definition.retentionMaxRuns ?? 100;
+            const trimmed = history.slice(-maxRuns);
+            await this.writeHistory(historyPath, trimmed);
+        }
+    }
+    /** Reads the most recent persisted result for a scanner instance. */
+    async readLatest(address, scannerId) {
+        return readJsonFile(this.latestPath(address, scannerId));
+    }
+    /** Reads persisted history for a scanner instance, optionally limited to recent entries. */
+    async readHistory(address, scannerId, opts) {
+        const history = await this.readHistoryInternal(this.historyPath(address, scannerId));
+        if (!opts?.limit || opts.limit <= 0) {
+            return history;
+        }
+        return history.slice(-opts.limit);
+    }
+    /**
+     * Queries latest signals across strategy/scanner folders.
+     * This is intended for user/tool queries and dashboard views.
+     */
+    async readSignals(filter = {}) {
+        const latestResults = await this.readAllLatestResults(filter);
+        const signals = latestResults.flatMap((result) => result.signals);
+        const filtered = signals
+            .filter((signal) => filter.address ? signal.address === filter.address : true)
+            .filter((signal) => filter.scannerId ? signal.scannerId === filter.scannerId : true)
+            .filter((signal) => typeof filter.minScore === "number"
+            ? signal.score >= filter.minScore
+            : true)
+            .filter((signal) => (filter.asset ? signal.asset === filter.asset : true))
+            .sort((a, b) => b.timestamp - a.timestamp);
+        const limit = filter.limit ?? 0;
+        if (limit > 0) {
+            return filtered.slice(0, limit);
+        }
+        return filtered;
+    }
+    /** Loads all latest results that match filter boundaries. */
+    async readAllLatestResults(filter) {
+        const root = join(this.stateDir, "strategies");
+        if (!(await pathExists(root))) {
+            return [];
+        }
+        const results = [];
+        const strategies = await readdir(root, { withFileTypes: true });
+        for (const strategyEntry of strategies) {
+            if (!strategyEntry.isDirectory()) {
+                continue;
+            }
+            if (filter.address && strategyEntry.name !== filter.address) {
+                continue;
+            }
+            const scannersRoot = join(root, strategyEntry.name, "scanners");
+            if (!(await pathExists(scannersRoot))) {
+                continue;
+            }
+            const scanners = await readdir(scannersRoot, { withFileTypes: true });
+            for (const scannerEntry of scanners) {
+                if (!scannerEntry.isDirectory()) {
+                    continue;
+                }
+                if (filter.scannerId && scannerEntry.name !== filter.scannerId) {
+                    continue;
+                }
+                const latest = await this.readLatest(strategyEntry.name, scannerEntry.name);
+                if (latest) {
+                    results.push(latest);
+                }
+            }
+        }
+        return results;
+    }
+    /** Reads line-delimited history JSON and returns empty list on file/parse errors. */
+    async readHistoryInternal(path) {
+        if (!(await pathExists(path))) {
+            return [];
+        }
+        try {
+            const raw = await readFile(path, "utf8");
+            return raw
+                .split("\n")
+                .map((line) => line.trim())
+                .filter(Boolean)
+                .map((line) => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Writes the full history snapshot as JSONL atomically. */
+    async writeHistory(path, entries) {
+        const content = entries.map((entry) => JSON.stringify(entry)).join("\n") +
+            (entries.length > 0 ? "\n" : "");
+        await writeTextAtomic(path, content);
+    }
+    /** Resolves latest result path for a scanner instance. */
+    latestPath(address, scannerId) {
+        return join(this.stateDir, "strategies", address, "scanners", scannerId, "latest.json");
+    }
+    /** Resolves history file path for a scanner instance. */
+    historyPath(address, scannerId) {
+        return join(this.stateDir, "strategies", address, "scanners", scannerId, "history.jsonl");
+    }
+}
+//# sourceMappingURL=signal-store.js.map

package/dist/scanners/store/signal-store.js.map

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