@massa-ai/core 1.2.1

package/dist/services/scheduler/scheduler.js

@@ -0,0 +1,453 @@
+/**
+ * Scheduler — OS-level in-process cron-like scheduler (Phase 3, C2).
+ *
+ * Runs periodic jobs on a CLOCK, alongside the existing event-debounce
+ * triggers. The existing job implementations (consolidation, decay-sweep,
+ * auto-improve, observation-bridge) are unchanged — the scheduler just invokes
+ * their existing entrypoints at scheduled times.
+ *
+ * Design:
+ *  - Durable job table (PostgreSQL + PG parity): persists job definitions +
+ *    nextRunAt/lastRunAt so a restart resumes the schedule.
+ *  - Job registry: handlers keyed by jobKind. The scheduler invokes the
+ *    registered handler; never the job implementation directly.
+ *  - Scheduler loop: a single setInterval tick (default 60s, env-overridable).
+ *    On each tick, loads enabled jobs whose nextRunAt <= now and fires them.
+ *  - Missed-run policy: SKIP with a logged warning (avoid stampede). If a job's
+ *    nextRunAt is far in the past (more than one tick), we skip the missed
+ *    runs and reschedule from now.
+ *  - Concurrency guard: never run the same jobKind twice concurrently.
+ *  - Concurrency cap: at most MAX_CONCURRENT jobs firing at once.
+ *  - Singleton: module-level cached instance + getScheduler()/resetScheduler().
+ *  - Lifecycle: start() loads enabled jobs + begins the tick; stop() clears the
+ *    interval. The interval is .unref()'d so it never keeps the event loop
+ *    alive solely for scheduling (parity with the job-reaper pattern).
+ *
+ * Config (env-overridable, default OFF or conservative):
+ *   MASSA_AI_SCHEDULER_ENABLED        (default false) master switch
+ *   MASSA_AI_SCHEDULER_TICK_MS        (default 60000) tick interval
+ *   MASSA_AI_SCHEDULER_MAX_CONCURRENT (default 2)     concurrent fire cap
+ *
+ * Default job intervals (conservative, env-overridable per kind):
+ *   memory-consolidation: 30 min
+ *   decay-sweep:           60 min
+ *   auto-improve:          30 min
+ *   observation-bridge:    30 min
+ * All default to disabled=false unless MASSA_AI_SCHEDULER_ENABLED=true AND
+ * the job's own enable flag is set. The boot wiring registers them as
+ * default-disabled; a deployment opts in by setting enabled=true on the row or
+ * MASSA_AI_SCHEDULER_<KIND>_ENABLED=true before boot.
+ */
+import { logger } from "@massa-ai/shared";
+import { parsePositiveIntEnv } from "@massa-ai/shared/config";
+import { parseCron, nextCronRun, } from "./scheduler-cron.js";
+import { getScheduledJobStore, resetScheduledJobStore, } from "./scheduler-store-factory.js";
+const DEFAULTS = {
+    tickMs: 60_000,
+    maxConcurrent: 2,
+};
+function readEnabled() {
+    const raw = process.env.MASSA_AI_SCHEDULER_ENABLED;
+    return raw === "true" || raw === "1";
+}
+export class Scheduler {
+    store;
+    tickIntervalMs;
+    maxConcurrent;
+    enabled;
+    /** Registry: jobKind → handler. */
+    handlers = new Map();
+    /** Parsed cron cache (avoids re-parsing on every tick). */
+    cronCache = new Map();
+    /** Currently-running jobKinds (concurrency guard). */
+    running = new Set();
+    timer = null;
+    started = false;
+    constructor(opts = {}) {
+        this.store = opts.store ?? getScheduledJobStore();
+        this.tickIntervalMs =
+            opts.tickIntervalMs ??
+                parsePositiveIntEnv(process.env.MASSA_AI_SCHEDULER_TICK_MS, DEFAULTS.tickMs);
+        this.maxConcurrent =
+            opts.maxConcurrent ??
+                parsePositiveIntEnv(process.env.MASSA_AI_SCHEDULER_MAX_CONCURRENT, DEFAULTS.maxConcurrent);
+        this.enabled = opts.enabled ?? readEnabled();
+    }
+    // ── Registry ──────────────────────────────────────────────────────────────
+    /**
+     * Register a handler for a jobKind. The scheduler will invoke this handler
+     * when a scheduled job of that kind fires. Overwrites any prior registration.
+     */
+    registerHandler(jobKind, handler) {
+        this.handlers.set(jobKind, handler);
+    }
+    /** Unregister a handler (tests / shutdown). */
+    unregisterHandler(jobKind) {
+        this.handlers.delete(jobKind);
+    }
+    /** List registered jobKinds. */
+    registeredKinds() {
+        return Array.from(this.handlers.keys());
+    }
+    // ── Job definition management ─────────────────────────────────────────────
+    /**
+     * Register or upsert a scheduled job definition. Persists it to the store.
+     * If the job already exists (by id), its definition is updated; nextRunAt is
+     * preserved unless the schedule changed.
+     */
+    registerJob(job) {
+        const existing = this.store.get(job.id);
+        const full = {
+            ...job,
+            lastRunAt: job.lastRunAt ?? existing?.lastRunAt ?? 0,
+        };
+        // If nextRunAt is 0 or the schedule changed, recompute it.
+        if (full.nextRunAt === 0 || this.scheduleChanged(existing, full)) {
+            full.nextRunAt = this.computeNextRun(full.schedule, Date.now());
+        }
+        this.store.save(full);
+        return full;
+    }
+    /**
+     * Register or RESUME a scheduled job definition across a restart. Like
+     * registerJob, but when the schedule is unchanged and the job already exists,
+     * it preserves the existing nextRunAt (resume on restart) rather than
+     * recomputing. If the preserved nextRunAt is in the past and the job is
+     * enabled, reschedule from now (avoids a noisy missed-run log on boot).
+     *
+     * This is the boot-time registration used by registerDefaultJobs().
+     */
+    registerOrResumeJob(job) {
+        const existing = this.store.get(job.id);
+        const full = {
+            ...job,
+            lastRunAt: job.lastRunAt ?? existing?.lastRunAt ?? 0,
+        };
+        if (!existing) {
+            // New job: compute nextRunAt from now.
+            full.nextRunAt = this.computeNextRun(full.schedule, Date.now());
+        }
+        else if (this.scheduleChanged(existing, full)) {
+            // Schedule changed: recompute from now.
+            full.nextRunAt = this.computeNextRun(full.schedule, Date.now());
+        }
+        else {
+            // Schedule unchanged: preserve the EXISTING persisted nextRunAt (resume on
+            // restart). The contract is "don't reschedule an unchanged job." We check
+            // the PERSISTED nextRunAt (not the passed-in one, which callers set to 0)
+            // against now — a future persisted nextRunAt is kept as-is.
+            const now = Date.now();
+            full.nextRunAt = existing.nextRunAt;
+            // Wave 5 FR-13: do NOT reschedule past-due jobs here — catchUpMissedJobs()
+            // fires one tick per missed job at boot. Preserving the past-due nextRunAt
+            // lets catch-up identify which jobs were missed.
+            // If disabled, keep the existing nextRunAt as-is (it'll be recomputed
+            // when the job is re-enabled via setEnabled).
+            void now; // now referenced in catchUpMissedJobs
+        }
+        this.store.save(full);
+        return full;
+    }
+    scheduleChanged(a, b) {
+        if (!a)
+            return true;
+        return (a.schedule.type !== b.schedule.type ||
+            a.schedule.intervalMs !== b.schedule.intervalMs ||
+            a.schedule.cron !== b.schedule.cron);
+    }
+    /** Enable/disable a job by id. Persists. */
+    setEnabled(id, enabled) {
+        const job = this.store.get(id);
+        if (!job) {
+            logger.warn("Scheduler.setEnabled: job not found", { id });
+            return;
+        }
+        job.enabled = enabled;
+        // If re-enabling and nextRunAt is in the past, reschedule from now.
+        if (enabled && job.nextRunAt <= Date.now()) {
+            job.nextRunAt = this.computeNextRun(job.schedule, Date.now());
+        }
+        this.store.save(job);
+    }
+    /** Delete a job definition. */
+    removeJob(id) {
+        this.store.delete(id);
+    }
+    // ── Next-run computation ──────────────────────────────────────────────────
+    /**
+     * Compute the next run time for a schedule, anchored at `fromMs`.
+     * For intervals: fromMs + intervalMs.
+     * For cron: the next cron match strictly after fromMs.
+     */
+    computeNextRun(schedule, fromMs) {
+        if (schedule.type === "interval") {
+            // Fall back to the scheduler's tick interval if intervalMs is missing —
+            // a missing intervalMs is a malformed definition, and using the tick is
+            // a sane conservative default (fires once per tick).
+            const ms = schedule.intervalMs ?? this.tickIntervalMs;
+            return fromMs + ms;
+        }
+        // cron
+        const expr = schedule.cron ?? "* * * * *";
+        let parsed = this.cronCache.get(expr);
+        if (!parsed) {
+            parsed = parseCron(expr);
+            this.cronCache.set(expr, parsed);
+        }
+        return nextCronRun(parsed, fromMs);
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────────────────
+    /**
+     * Start the scheduler. Loads enabled jobs from the store and begins the tick.
+     * Safe to call when already started (no-op). Safe to call when the master
+     * switch is off (logs once, no tick).
+     */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        if (!this.enabled) {
+            logger.info("Scheduler disabled (MASSA_AI_SCHEDULER_ENABLED != true)");
+            return;
+        }
+        // Seed default jobs that have no row yet (registerDefaultJobs is called by
+        // the boot wiring before start(); this is a safety net).
+        const jobs = this.store.listEnabled();
+        logger.info("Scheduler starting", {
+            tickMs: this.tickIntervalMs,
+            maxConcurrent: this.maxConcurrent,
+            enabledJobs: jobs.length,
+        });
+        this.timer = setInterval(() => {
+            void this.tick().catch((e) => {
+                logger.warn("Scheduler tick failed (swallowed)", {
+                    error: e.message,
+                });
+            });
+        }, this.tickIntervalMs);
+        // Never keep the event loop alive solely for the scheduler.
+        this.timer.unref?.();
+        // Fire one immediate tick so jobs due now run without waiting for the first
+        // interval. This also handles catch-up-on-boot: jobs whose nextRunAt is in
+        // the past will be skipped-with-warning and rescheduled (missed-run policy).
+        void this.tick().catch(() => { });
+    }
+    /**
+     * Wave 5 FR-13: catch-up missed jobs at boot. Fires ONE tick per missed job
+     * (jobs with next_run_at < now() AND enabled=true), non-overlapping per kind
+     * (the `running` set prevents concurrent execution of the same jobKind). Not
+     * a full backfill — exactly one tick per missed job. Called by the boot
+     * wiring after registerDefaultJobs() and before start().
+     *
+     * Each fired job's nextRunAt is advanced to the next scheduled run (via
+     * fireJob). Jobs that are already due-but-not-missed (overdue < tick) are
+     * left for the normal tick to pick up.
+     */
+    catchUpMissedJobs(now = Date.now()) {
+        if (!this.enabled)
+            return { caughtUp: 0, skipped: 0 };
+        const jobs = this.store.listEnabled();
+        let caughtUp = 0;
+        let skipped = 0;
+        for (const job of jobs) {
+            // Non-overlapping per kind: skip if this jobKind is already running.
+            if (this.running.has(job.jobKind)) {
+                skipped++;
+                continue;
+            }
+            // Missed = nextRunAt is in the past (overdue by more than one tick).
+            // The normal tick handles jobs due within the current tick window.
+            const overdueMs = now - job.nextRunAt;
+            if (overdueMs <= this.tickIntervalMs) {
+                // Not missed — the normal tick will fire it.
+                continue;
+            }
+            // Fire one catch-up tick for this missed job.
+            logger.info("Scheduler: catch-up tick for missed job", {
+                id: job.id,
+                name: job.name,
+                jobKind: job.jobKind,
+                overdueMs,
+            });
+            this.fireJob(job, now);
+            caughtUp++;
+        }
+        return { caughtUp, skipped };
+    }
+    /**
+     * Stop the scheduler. Clears the interval. Does NOT delete job definitions.
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.started = false;
+        logger.info("Scheduler stopped");
+    }
+    isRunning() {
+        return this.started && this.timer !== null;
+    }
+    // ── Tick ──────────────────────────────────────────────────────────────────
+    /**
+     * Run one scheduler tick. Evaluates all enabled jobs, fires those due, skips
+     * missed runs with a warning, and reschedules. Returns a summary for logging.
+     */
+    async tick(now = Date.now()) {
+        const result = { evaluated: 0, fired: 0, skipped: 0, errors: 0 };
+        if (!this.enabled)
+            return result;
+        const jobs = this.store.listEnabled();
+        result.evaluated = jobs.length;
+        for (const job of jobs) {
+            // Concurrency guard: skip if this jobKind is already running.
+            if (this.running.has(job.jobKind)) {
+                result.skipped++;
+                continue;
+            }
+            if (job.nextRunAt > now) {
+                // Not due yet.
+                continue;
+            }
+            // Missed-run policy: if the job is overdue by more than one tick, we
+            // SKIP (don't stampede) and reschedule from now. We log the skip.
+            const overdueMs = now - job.nextRunAt;
+            const isMissed = overdueMs > this.tickIntervalMs;
+            if (isMissed) {
+                logger.warn("Scheduler: missed run (skipping, rescheduling)", {
+                    id: job.id,
+                    name: job.name,
+                    jobKind: job.jobKind,
+                    overdueMs,
+                });
+                job.nextRunAt = this.computeNextRun(job.schedule, now);
+                this.store.save(job);
+                result.skipped++;
+                continue;
+            }
+            // Concurrency cap: don't exceed maxConcurrent simultaneous fires.
+            if (this.running.size >= this.maxConcurrent) {
+                result.skipped++;
+                continue;
+            }
+            // Fire the job.
+            this.fireJob(job, now);
+            result.fired++;
+        }
+        return result;
+    }
+    /**
+     * Fire a single job: invoke its handler, update lastRunAt + nextRunAt,
+     * persist. Never throws — all errors are caught and logged.
+     */
+    fireJob(job, firedAt) {
+        const handler = this.handlers.get(job.jobKind);
+        if (!handler) {
+            logger.warn("Scheduler: no handler registered for jobKind", {
+                id: job.id,
+                jobKind: job.jobKind,
+            });
+            // Still advance nextRunAt so we don't spin on an unhandled job.
+            job.lastRunAt = firedAt;
+            job.nextRunAt = this.computeNextRun(job.schedule, firedAt);
+            this.store.save(job);
+            return;
+        }
+        this.running.add(job.jobKind);
+        logger.info("Scheduler: firing job", {
+            id: job.id,
+            name: job.name,
+            jobKind: job.jobKind,
+        });
+        void (async () => {
+            let succeeded = false;
+            let errMsg = null;
+            try {
+                await Promise.resolve(handler(job));
+                succeeded = true;
+                logger.info("Scheduler: job completed", {
+                    id: job.id,
+                    jobKind: job.jobKind,
+                    durationMs: Date.now() - firedAt,
+                });
+            }
+            catch (e) {
+                errMsg = e.message;
+                logger.warn("Scheduler: job handler threw (caught)", {
+                    id: job.id,
+                    jobKind: job.jobKind,
+                    error: errMsg,
+                });
+            }
+            finally {
+                // Wave 5 FR-13: success/failure split. last_success_at updates ONLY
+                // on success; consecutive_failures resets to 0 on success and
+                // increments on failure. last_error captures the truncated message.
+                if (succeeded) {
+                    job.lastSuccessAt = firedAt;
+                    job.consecutiveFailures = 0;
+                    job.lastError = null;
+                }
+                else {
+                    job.lastFailureAt = firedAt;
+                    job.consecutiveFailures = (job.consecutiveFailures ?? 0) + 1;
+                    // Truncate last_error to 2000 chars (avoid unbounded TEXT growth).
+                    job.lastError = errMsg
+                        ? (errMsg.length > 2000 ? errMsg.substring(0, 1997) + "..." : errMsg)
+                        : "unknown error";
+                }
+                // Update lastRunAt + nextRunAt and persist.
+                job.lastRunAt = firedAt;
+                job.nextRunAt = this.computeNextRun(job.schedule, firedAt);
+                try {
+                    this.store.save(job);
+                }
+                catch (e) {
+                    logger.warn("Scheduler: persist after fire failed", {
+                        id: job.id,
+                        error: e.message,
+                    });
+                }
+                this.running.delete(job.jobKind);
+            }
+        })();
+    }
+    // ── Status (optional debug endpoint) ──────────────────────────────────────
+    status(now = Date.now()) {
+        const jobs = this.store.listAll();
+        return {
+            running: this.isRunning(),
+            tickIntervalMs: this.tickIntervalMs,
+            registeredHandlers: this.registeredKinds(),
+            jobs: jobs.map((j) => ({
+                id: j.id,
+                name: j.name,
+                jobKind: j.jobKind,
+                enabled: j.enabled,
+                nextRunAt: j.nextRunAt,
+                lastRunAt: j.lastRunAt,
+                due: j.enabled && j.nextRunAt <= now,
+                currentlyRunning: this.running.has(j.jobKind),
+            })),
+        };
+    }
+    /** Test/debug: is a jobKind currently executing? */
+    isJobRunning(jobKind) {
+        return this.running.has(jobKind);
+    }
+}
+// ── Singleton ─────────────────────────────────────────────────────────────────
+let cachedScheduler = null;
+export function getScheduler() {
+    if (!cachedScheduler)
+        cachedScheduler = new Scheduler();
+    return cachedScheduler;
+}
+export function resetScheduler() {
+    if (cachedScheduler) {
+        cachedScheduler.stop();
+        cachedScheduler = null;
+    }
+    resetScheduledJobStore();
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/services/scheduler/scheduler.js.map

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

package/dist/services/search/analytics-factory.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Search Analytics Factory
+ *
+ * Provides unified analytics implementation based on database configuration.
+ */
+import { SearchAnalyticsPg } from "./search-analytics-pg.js";
+export declare function getSearchAnalytics(): SearchAnalyticsPg;
+export declare function resetSearchAnalytics(): Promise<void>;
+//# sourceMappingURL=analytics-factory.d.ts.map

package/dist/services/search/analytics-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-factory.d.ts","sourceRoot":"","sources":["../../../src/services/search/analytics-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAK7D,wBAAgB,kBAAkB,IAAI,iBAAiB,CAOtD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO1D"}

package/dist/services/search/analytics-factory.js

@@ -0,0 +1,24 @@
+/**
+ * Search Analytics Factory
+ *
+ * Provides unified analytics implementation based on database configuration.
+ */
+import { SearchAnalyticsPg } from "./search-analytics-pg.js";
+import { logger } from "@massa-ai/shared";
+let cachedAnalytics = null;
+export function getSearchAnalytics() {
+    if (cachedAnalytics)
+        return cachedAnalytics;
+    cachedAnalytics = new SearchAnalyticsPg();
+    logger.info('Using PostgreSQL search analytics');
+    return cachedAnalytics;
+}
+export async function resetSearchAnalytics() {
+    if (cachedAnalytics) {
+        if ('close' in cachedAnalytics) {
+            await cachedAnalytics.close();
+        }
+        cachedAnalytics = null;
+    }
+}
+//# sourceMappingURL=analytics-factory.js.map

package/dist/services/search/analytics-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-factory.js","sourceRoot":"","sources":["../../../src/services/search/analytics-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,IAAI,eAAe,GAA6B,IAAI,CAAC;AAErD,MAAM,UAAU,kBAAkB;IAChC,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAE5C,eAAe,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAEjD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,eAAe,EAAE,CAAC;QACpB,IAAI,OAAO,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;QACD,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/services/search/cache-factory.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cache Factory
+ *
+ * Provides unified cache implementation based on database configuration.
+ */
+import { SearchCachePg } from './search-cache-pg.js';
+export declare function getSearchCache(): SearchCachePg;
+export declare function resetSearchCache(): Promise<void>;
+//# sourceMappingURL=cache-factory.d.ts.map

package/dist/services/search/cache-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-factory.d.ts","sourceRoot":"","sources":["../../../src/services/search/cache-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAKrD,wBAAgB,cAAc,IAAI,aAAa,CAO9C;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKtD"}

package/dist/services/search/cache-factory.js

@@ -0,0 +1,22 @@
+/**
+ * Cache Factory
+ *
+ * Provides unified cache implementation based on database configuration.
+ */
+import { SearchCachePg } from './search-cache-pg.js';
+import { logger } from '@massa-ai/shared';
+let cachedCache = null;
+export function getSearchCache() {
+    if (cachedCache)
+        return cachedCache;
+    cachedCache = new SearchCachePg();
+    logger.info('Using PostgreSQL search cache');
+    return cachedCache;
+}
+export async function resetSearchCache() {
+    if (cachedCache) {
+        await cachedCache.clear();
+        cachedCache = null;
+    }
+}
+//# sourceMappingURL=cache-factory.js.map

package/dist/services/search/cache-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-factory.js","sourceRoot":"","sources":["../../../src/services/search/cache-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,IAAI,WAAW,GAAyB,IAAI,CAAC;AAE7C,MAAM,UAAU,cAAc;IAC5B,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,WAAW,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAE7C,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;QAC1B,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/services/search/capture-policy-interfaces.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Capture Policy Interfaces — Wave 5 FR-11 / FR-26 / AD-W5-005 / AD-W5-020.
+ *
+ * Public TypeScript contract for the capture-policy pure module. B3 imports
+ * these interfaces verbatim — no re-implementation. Interface drift fails the
+ * batch per FR-26 / AC-28.
+ *
+ * The policy module is pure (no I/O): it takes a file path + a policy and
+ * returns a Disposition. The `.gitignore` merge (AD-W5-015) happens BEFORE
+ * `applyPolicy` in the `ignore-patterns.ts` wrapper; `applyPolicy` consumes
+ * the merged rule list, not the raw policy. This keeps gitignore semantics
+ * (including negation rules like `!keep/me.js`) intact.
+ */
+/**
+ * Disposition returned by {@link ApplyPolicyFn}.
+ * - `Keep`: index the file's content + metadata.
+ * - `Drop`: do not index the file at all (skip).
+ * - `MetadataOnly`: index the file's path/metadata but not its content
+ *   (future use; currently treated as `Keep` by the ETL).
+ */
+export type Disposition = "Keep" | "Drop" | "MetadataOnly";
+/**
+ * A capture policy rule. Patterns are gitignore-style globs (the `Ignore`
+ * library syntax); negation rules (`!path`) un-ignore. The `disposition`
+ * field is the result when a path matches this rule.
+ */
+export interface CapturePolicyRule {
+    /** gitignore-style glob pattern (supports `**`, `*`, `!` negation). */
+    pattern: string;
+    /** Disposition when a path matches this rule. */
+    disposition: Disposition;
+}
+/**
+ * Bounded capture policy. Bounds are enforced at config-load time; the pure
+ * `applyPolicy` function trusts its input (it does not re-validate bounds).
+ */
+export interface Policy {
+    /**
+     * Ordered list of rules. The first matching rule wins. If no rule matches,
+     * the default disposition is `Keep`.
+     */
+    rules: CapturePolicyRule[];
+    /**
+     * Maximum files to scan before refusing (FR-11 `MAX_MATCH_WORK`).
+     * Default 100_000. Enforced at config load, not in applyPolicy.
+     */
+    maxMatchWork?: number;
+    /**
+     * Maximum number of ignore (Drop) patterns allowed (FR-11
+     * `MAX_IGNORE_PATTERNS`). Default 1024. Enforced at config load.
+     */
+    maxIgnorePatterns?: number;
+}
+/**
+ * Function signature for the pure `applyPolicy` entrypoint. Exported so B3
+ * can depend on the contract, not the concrete implementation.
+ */
+export type ApplyPolicyFn = (filePath: string, policy: Policy) => Disposition;
+//# sourceMappingURL=capture-policy-interfaces.d.ts.map

package/dist/services/search/capture-policy-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-policy-interfaces.d.ts","sourceRoot":"","sources":["../../../src/services/search/capture-policy-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC"}

package/dist/services/search/capture-policy-interfaces.js

@@ -0,0 +1,15 @@
+/**
+ * Capture Policy Interfaces — Wave 5 FR-11 / FR-26 / AD-W5-005 / AD-W5-020.
+ *
+ * Public TypeScript contract for the capture-policy pure module. B3 imports
+ * these interfaces verbatim — no re-implementation. Interface drift fails the
+ * batch per FR-26 / AC-28.
+ *
+ * The policy module is pure (no I/O): it takes a file path + a policy and
+ * returns a Disposition. The `.gitignore` merge (AD-W5-015) happens BEFORE
+ * `applyPolicy` in the `ignore-patterns.ts` wrapper; `applyPolicy` consumes
+ * the merged rule list, not the raw policy. This keeps gitignore semantics
+ * (including negation rules like `!keep/me.js`) intact.
+ */
+export {};
+//# sourceMappingURL=capture-policy-interfaces.js.map

package/dist/services/search/capture-policy-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-policy-interfaces.js","sourceRoot":"","sources":["../../../src/services/search/capture-policy-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}