@massa-ai/core 1.2.1

package/dist/services/jobs/index-job-store-pg.js

@@ -0,0 +1,403 @@
+/**
+ * PgJobStore — PostgreSQL durability for indexing jobs (Phase 1, T9).
+ *
+ * Mirrors PgJobStore's semantics so the job store follows the same
+ * one-backend rule as the rest of the data plane: getJobStore() selects this
+ * variant when DATABASE_URL is postgres, else PgJobStore.
+ *
+ * Interface contract: JobStore is SYNCHRONOUS (the tracker calls
+ * `store?.save(job)` and `store.get(id)` with no await, mirroring the sync
+ * legacy local database API). PG is inherently async, so this store:
+ *   - Writes fire-and-forget (best-effort, logged on failure — matching the
+ *     PostgreSQL store's try/catch best-effort semantics).
+ *   - Reads are served from an in-memory mirror that is hydrated from PG on
+ *     first use (async) and kept in sync by every save. The mirror is the hot
+ *     read path within a process; PG is the durability + cross-process recovery
+ *     layer (crash recovery flips stale `running` → `failed` on init, and a new
+ *     process hydrates its mirror from the recovered rows).
+ *
+ * Uses raw SQL ($executeRaw / $queryRaw) via the shared prisma client — the
+ * same pattern as MemoryRepositoryPg — to avoid the Prisma 7.7.0 + adapter-pg
+ * isObjectEnumValue incompatibility. Reuses getPrismaClient() (no second pool).
+ */
+import { logger } from "@massa-ai/shared";
+import { parsePositiveIntEnv } from "@massa-ai/shared/config";
+import { getPrismaClient } from "../../services/query/prisma-client.js";
+import { getProjectIdentityAliasResolver } from "../../services/project-identity/alias-resolver.js";
+function toNum(v) {
+    if (v == null)
+        return null;
+    return typeof v === "bigint" ? Number(v) : v;
+}
+function rowToJob(r) {
+    const filesIndexed = toNum(r.files_indexed);
+    return {
+        jobId: r.job_id,
+        projectId: r.project_id,
+        projectPath: r.project_path,
+        status: r.status,
+        progress: {
+            current: Number(r.current),
+            total: Number(r.total),
+            percentage: Number(r.percentage),
+        },
+        result: filesIndexed != null
+            ? {
+                filesIndexed,
+                chunksIndexed: toNum(r.chunks_indexed) ?? 0,
+                errors: toNum(r.errors) ?? 0,
+                duration: toNum(r.duration) ?? 0,
+                activatedGraphGenerationId: r.activated_graph_generation_id ?? undefined,
+                parserDiagnostics: r.parser_diagnostics_count == null ? undefined : {
+                    diagnosticsCount: toNum(r.parser_diagnostics_count) ?? 0,
+                    recoveredFiles: toNum(r.parser_recovered_files) ?? 0,
+                    hardFailureFiles: toNum(r.parser_hard_failure_files) ?? 0,
+                    staleFiles: toNum(r.parser_stale_files) ?? 0,
+                    languages: r.parser_language_counts ?? {},
+                },
+            }
+            : undefined,
+        error: r.error ?? undefined,
+        createdAt: new Date(toNum(r.created_at)),
+        startedAt: r.started_at != null ? new Date(toNum(r.started_at)) : undefined,
+        completedAt: r.completed_at != null
+            ? new Date(toNum(r.completed_at))
+            : undefined,
+        heartbeatAt: r.heartbeat_at != null
+            ? new Date(toNum(r.heartbeat_at))
+            : undefined,
+    };
+}
+export class PgJobStore {
+    prisma;
+    /** In-memory mirror: the sync read path. Hydrated from PG on first use. */
+    mirror = new Map();
+    hydrated = false;
+    hydrating = null;
+    /** Crash recovery guard: runs once per process on first use. */
+    recovered = false;
+    /**
+     * Per-jobId serialized write chain. The tracker lifecycle calls save() many
+     * times rapidly for one job (pending → running → progress → ... → completed).
+     * Without ordering, these become concurrent in-flight upserts on the same
+     * row with NO commit-order guarantee — an earlier write (e.g. `running`) can
+     * commit AFTER the terminal write (`completed`) and leave the PG row stuck at
+     * a non-terminal state. Chaining each persist onto the previous in-flight
+     * write for that jobId guarantees persists commit in call order. Different
+     * jobIds remain concurrent (independent rows). Settled entries are dropped so
+     * the map does not grow.
+     */
+    inflight = new Map();
+    persistFailures = new Map();
+    getClient() {
+        if (!this.prisma)
+            this.prisma = getPrismaClient();
+        return this.prisma;
+    }
+    /**
+     * Stale-heartbeat cutoff (ms-epoch): running jobs whose
+     * `COALESCE(heartbeat_at, started_at)` is older than this are considered
+     * stale (crashed / orphaned) and may be flipped to `failed`. Sourced from
+     * the same env knob the live reaper uses (MASSA_AI_JOB_STALE_MS, default
+     * 300000), so a live process with a fresh heartbeat is never touched.
+     */
+    staleHeartbeatCutoffMs(now = Date.now()) {
+        const staleMs = parsePositiveIntEnv(process.env.MASSA_AI_JOB_STALE_MS, 300_000);
+        return now - staleMs;
+    }
+    /**
+     * Best-effort hydrate the mirror from PG + run crash recovery once. Resolves
+     * (never rejects) — failures log a warn and leave the mirror empty; the
+     * tracker's own in-memory Map remains the authoritative hot cache.
+     */
+    ensureHydrated() {
+        if (this.hydrated)
+            return Promise.resolve();
+        if (this.hydrating)
+            return this.hydrating;
+        this.hydrating = (async () => {
+            try {
+                const prisma = this.getClient();
+                // Crash recovery FIRST: flip stale `running` → `failed` before we read,
+                // so the mirror reflects recovered state (parity with PgJobStore's
+                // recovery-on-open). Runs once per process.
+                if (!this.recovered) {
+                    try {
+                        const now = Date.now();
+                        // Only flip running jobs whose heartbeat (or started_at fallback)
+                        // is older than the stale threshold. A live process with a fresh
+                        // heartbeat is never flipped — closes the multi-process hazard
+                        // where one process's startup would flip another's in-flight jobs.
+                        const cutoff = this.staleHeartbeatCutoffMs(now);
+                        const result = await prisma.$executeRaw `
+              UPDATE index_jobs
+              SET status = 'failed', error = 'process restart', completed_at = ${now}::bigint
+              WHERE status = 'running'
+                AND COALESCE(heartbeat_at, started_at) IS NOT NULL
+                AND COALESCE(heartbeat_at, started_at) < ${cutoff}::bigint
+            `;
+                        this.recovered = true;
+                        if (typeof result === "number" && result > 0) {
+                            logger.info("PgJobStore crash recovery", {
+                                staleRunningFailed: result,
+                            });
+                        }
+                    }
+                    catch (e) {
+                        this.recovered = true; // don't retry loop; surface once
+                        logger.warn("PgJobStore markStaleRunningFailed failed (best-effort)", {
+                            error: e.message,
+                        });
+                    }
+                }
+                // Hydrate: pull all rows into the mirror. MERGE instead of clear+rebuild
+                // so a save() whose fire-and-forget persist() has not yet committed to PG
+                // at the instant this SELECT runs is not erased from the mirror. Without
+                // this, get() (mirror-only, no DB fallback) would return null for that
+                // job until its write lands — a transient hole in the sync read path.
+                const rows = await prisma.$queryRaw `
+          SELECT * FROM index_jobs
+        `;
+                // Snapshot the in-flight jobIds (persists not yet committed) BEFORE
+                // rebuilding. These are the jobs whose save() updated the mirror but
+                // whose DB row may be absent from `rows`.
+                const inflightJobIds = new Set(this.inflight.keys());
+                const dbJobIds = new Set();
+                for (const row of rows)
+                    dbJobIds.add(row.job_id);
+                // Build the new mirror from DB rows (committed state is source of truth
+                // → overwrites any older in-memory copy).
+                const next = new Map();
+                for (const row of rows)
+                    next.set(row.job_id, rowToJob(row));
+                // Re-apply any in-flight save whose row is NOT in the DB snapshot: the
+                // persist hasn't landed yet, so the in-memory copy is strictly newer and
+                // must survive. A jobId that is both in DB AND in-flight already has its
+                // committed row in `next` — the DB row wins (source of truth).
+                for (const jobId of inflightJobIds) {
+                    if (!dbJobIds.has(jobId)) {
+                        const existing = this.mirror.get(jobId);
+                        if (existing)
+                            next.set(jobId, existing);
+                    }
+                }
+                // Swap the rebuilt mirror in atomically (one assignment, no clear gap).
+                this.mirror = next;
+                this.hydrated = true;
+                logger.info("PgJobStore hydrated", { rows: this.mirror.size });
+            }
+            catch (e) {
+                // Hydration failed: leave hydrated=false so the next call retries. The
+                // tracker's own Map still serves reads; PG writes still land.
+                logger.warn("PgJobStore hydrate failed (best-effort)", {
+                    error: e.message,
+                });
+            }
+            finally {
+                this.hydrating = null;
+            }
+        })();
+        return this.hydrating;
+    }
+    save(job) {
+        // Mirror update is synchronous so a subsequent sync get() sees the value.
+        this.mirror.set(job.jobId, job);
+        // Kick off hydration so the mirror catches up if it hasn't yet.
+        void this.ensureHydrated();
+        // Chain the PG persist onto the previous in-flight write for this jobId so
+        // persists commit in call order (prevents out-of-order upserts clobbering
+        // the terminal state). The mirror read contract is unaffected (already
+        // updated above). Different jobIds remain concurrent.
+        const prev = this.inflight.get(job.jobId) ?? Promise.resolve();
+        const next = prev.catch(() => { }).then(() => this.persist(job));
+        this.inflight.set(job.jobId, next);
+        // Drop the chain entry once settled so the map doesn't grow.
+        void next.finally(() => {
+            if (this.inflight.get(job.jobId) === next) {
+                this.inflight.delete(job.jobId);
+            }
+        }).catch(() => { });
+        next.then(() => this.persistFailures.delete(job.jobId), (error) => this.persistFailures.set(job.jobId, error));
+        next.catch((e) => {
+            logger.warn("PgJobStore.save failed (best-effort)", {
+                jobId: job.jobId,
+                error: e.message,
+            });
+        });
+    }
+    /**
+     * Test-infrastructure helper (double-underscore): await the current in-flight
+     * write(s) for a job (or all jobs if omitted). Lets tests assert the FINAL
+     * on-disk PG state deterministically without polling. Not for production use.
+     */
+    async __drain(jobId) {
+        if (jobId) {
+            const p = this.inflight.get(jobId);
+            if (p)
+                await p.catch(() => { });
+            return;
+        }
+        const all = Array.from(this.inflight.values());
+        if (all.length)
+            await Promise.all(all.map((p) => p.catch(() => { })));
+    }
+    async flush(jobId) {
+        if (jobId) {
+            const pending = this.inflight.get(jobId);
+            if (pending)
+                await pending;
+            const failure = this.persistFailures.get(jobId);
+            if (failure !== undefined)
+                throw failure;
+            return;
+        }
+        const pending = Array.from(this.inflight.values());
+        if (pending.length)
+            await Promise.all(pending);
+        const failure = this.persistFailures.values().next().value;
+        if (failure !== undefined)
+            throw failure;
+    }
+    async persist(job) {
+        const prisma = this.getClient();
+        // Resolve canonical project id at the write seam (spec req 3).
+        const canonicalProjectId = await getProjectIdentityAliasResolver().resolve(job.projectId);
+        const filesIndexed = job.result?.filesIndexed ?? null;
+        const chunksIndexed = job.result?.chunksIndexed ?? null;
+        const errors = job.result?.errors ?? null;
+        const duration = job.result?.duration ?? null;
+        const activatedGraphGenerationId = job.result?.activatedGraphGenerationId ?? null;
+        const parserDiagnostics = job.result?.parserDiagnostics;
+        const error = job.error ?? null;
+        const createdAt = job.createdAt.getTime();
+        const startedAt = job.startedAt?.getTime() ?? null;
+        const completedAt = job.completedAt?.getTime() ?? null;
+        const heartbeatAt = job.heartbeatAt?.getTime() ?? null;
+        await prisma.$executeRaw `
+      INSERT INTO index_jobs (
+        job_id, project_id, project_path, status, current, total, percentage,
+        files_indexed, chunks_indexed, errors, duration, activated_graph_generation_id,
+        parser_diagnostics_count, parser_recovered_files, parser_hard_failure_files, parser_stale_files, parser_language_counts, error,
+        created_at, started_at, completed_at, heartbeat_at
+      ) VALUES (
+        ${job.jobId},
+        ${canonicalProjectId},
+        ${job.projectPath},
+        ${job.status},
+        ${job.progress.current},
+        ${job.progress.total},
+        ${job.progress.percentage},
+        ${filesIndexed}::int,
+        ${chunksIndexed}::int,
+        ${errors}::int,
+        ${duration}::int,
+        ${activatedGraphGenerationId},
+        ${parserDiagnostics?.diagnosticsCount ?? null}::int,
+        ${parserDiagnostics?.recoveredFiles ?? null}::int,
+        ${parserDiagnostics?.hardFailureFiles ?? null}::int,
+        ${parserDiagnostics?.staleFiles ?? null}::int,
+        ${JSON.stringify(parserDiagnostics?.languages ?? null)}::jsonb,
+        ${error},
+        ${createdAt}::bigint,
+        ${startedAt !== null ? startedAt : null}::bigint,
+        ${completedAt !== null ? completedAt : null}::bigint,
+        ${heartbeatAt !== null ? heartbeatAt : null}::bigint
+      )
+      ON CONFLICT (job_id) DO UPDATE SET
+        status = EXCLUDED.status,
+        current = EXCLUDED.current,
+        total = EXCLUDED.total,
+        percentage = EXCLUDED.percentage,
+        files_indexed = EXCLUDED.files_indexed,
+        chunks_indexed = EXCLUDED.chunks_indexed,
+        errors = EXCLUDED.errors,
+        duration = EXCLUDED.duration,
+        activated_graph_generation_id = EXCLUDED.activated_graph_generation_id,
+        parser_diagnostics_count = EXCLUDED.parser_diagnostics_count,
+        parser_recovered_files = EXCLUDED.parser_recovered_files,
+        parser_hard_failure_files = EXCLUDED.parser_hard_failure_files,
+        parser_stale_files = EXCLUDED.parser_stale_files,
+        parser_language_counts = EXCLUDED.parser_language_counts,
+        error = EXCLUDED.error,
+        started_at = EXCLUDED.started_at,
+        completed_at = EXCLUDED.completed_at,
+        heartbeat_at = EXCLUDED.heartbeat_at
+    `;
+    }
+    get(jobId) {
+        void this.ensureHydrated();
+        // Sync read from the mirror. If hydration hasn't completed yet, the tracker's
+        // own in-memory Map is the authoritative hot cache; we return the mirror
+        // value (may be undefined on a cold new process until hydration lands).
+        return this.mirror.get(jobId) ?? null;
+    }
+    listByProject(projectId) {
+        void this.ensureHydrated();
+        return Array.from(this.mirror.values())
+            .filter((j) => j.projectId === projectId)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    listAll() {
+        void this.ensureHydrated();
+        return Array.from(this.mirror.values()).sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    listRunning() {
+        void this.ensureHydrated();
+        return Array.from(this.mirror.values()).filter((j) => j.status === "running");
+    }
+    markStaleRunningFailed() {
+        // Parity with the PostgreSQL store's markStaleRunningFailed. Fire-and-forget:
+        // returns the count from the CURRENT mirror snapshot (the actual PG update
+        // runs async). This matches the PostgreSQL store's "best-effort, never crash
+        // the API" contract; the reaper itself calls setResult → save which lands
+        // the `failed` row synchronously in the mirror and async in PG.
+        const stale = this.listRunning();
+        void (async () => {
+            try {
+                const prisma = this.getClient();
+                const now = Date.now();
+                // Heartbeat-age predicate: only flip running jobs whose heartbeat (or
+                // started_at fallback) is older than the stale threshold. A live process
+                // with a fresh heartbeat is never flipped — closes the multi-process
+                // hazard. The `status='running'` filter also means a job that already
+                // reached a terminal state via save() (whose terminal persist is ordered
+                // by the per-jobId inflight chain) cannot be matched here.
+                const cutoff = this.staleHeartbeatCutoffMs(now);
+                // Capture the true affected-row count from PG ($executeRaw returns the
+                // rowCount). The returned `stale.length` is an in-memory mirror snapshot
+                // that over-counts in mixed fresh/stale scenarios (a fresh-heartbeat
+                // running job appears in listRunning() but is NOT flipped by the UPDATE's
+                // heartbeat predicate). Only the logged count is authoritative.
+                const result = await prisma.$executeRaw `
+          UPDATE index_jobs
+          SET status = 'failed', error = 'process restart', completed_at = ${now}::bigint
+          WHERE status = 'running'
+            AND COALESCE(heartbeat_at, started_at) IS NOT NULL
+            AND COALESCE(heartbeat_at, started_at) < ${cutoff}::bigint
+        `;
+                if (typeof result === "number" && result > 0) {
+                    logger.info("PgJobStore markStaleRunningFailed", { flipped: result });
+                }
+            }
+            catch (e) {
+                logger.warn("PgJobStore markStaleRunningFailed failed (best-effort)", {
+                    error: e.message,
+                });
+            }
+        })();
+        return stale.length;
+    }
+    delete(jobId) {
+        this.mirror.delete(jobId);
+        void (async () => {
+            try {
+                const prisma = this.getClient();
+                await prisma.$executeRaw `DELETE FROM index_jobs WHERE job_id = ${jobId}`;
+            }
+            catch {
+                /* best-effort */
+            }
+        })();
+    }
+}
+//# sourceMappingURL=index-job-store-pg.js.map

package/dist/services/jobs/index-job-store-pg.js.map

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

package/dist/services/jobs/index-job-store.d.ts

@@ -0,0 +1,5 @@
+import { PgJobStore } from "./index-job-store-pg.js";
+export * from "./index-job-store-contract.js";
+export declare function getJobStore(): PgJobStore;
+export declare function resetJobStore(): void;
+//# sourceMappingURL=index-job-store.d.ts.map

package/dist/services/jobs/index-job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-job-store.d.ts","sourceRoot":"","sources":["../../../src/services/jobs/index-job-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAE9C,wBAAgB,WAAW,IAAI,UAAU,CAAqE;AAC9G,wBAAgB,aAAa,IAAI,IAAI,CAAkB"}

package/dist/services/jobs/index-job-store.js

@@ -0,0 +1,7 @@
+import { requirePostgresDatabaseUrl } from "@massa-ai/shared/config";
+import { PgJobStore } from "./index-job-store-pg.js";
+export * from "./index-job-store-contract.js";
+let store = null;
+export function getJobStore() { requirePostgresDatabaseUrl(); return store ??= new PgJobStore(); }
+export function resetJobStore() { store = null; }
+//# sourceMappingURL=index-job-store.js.map

package/dist/services/jobs/index-job-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-job-store.js","sourceRoot":"","sources":["../../../src/services/jobs/index-job-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,IAAI,KAAK,GAAsB,IAAI,CAAC;AACpC,MAAM,UAAU,WAAW,KAAiB,0BAA0B,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC;AAC9G,MAAM,UAAU,aAAa,KAAW,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC"}

package/dist/services/jobs/index-job-tracker.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Job Tracker for Async Indexing Operations
+ *
+ * Tracks long-running indexing jobs with progress updates
+ * and status polling support.
+ */
+import { type ActiveGraphDiagnostics } from "@massa-ai/shared";
+import type { JobStore } from "./index-job-store.js";
+export interface IndexJob {
+    jobId: string;
+    projectId: string;
+    projectPath: string;
+    status: "pending" | "running" | "completed" | "failed";
+    progress: {
+        current: number;
+        total: number;
+        percentage: number;
+    };
+    result?: {
+        filesIndexed: number;
+        chunksIndexed: number;
+        errors: number;
+        duration: number;
+    } & Partial<ActiveGraphDiagnostics<string>>;
+    error?: string;
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    /**
+     * Heartbeat timestamp: refreshed on every progress emit and when the job
+     * enters `running`. Used by `reapStaleJobs` to detect a job that has hung
+     * (e.g. an Ollama stall or a mid-flight crash) while the server is still
+     * alive — flipping it to `failed` within the server's lifetime, instead of
+     * waiting for the next process restart to recover it.
+     */
+    heartbeatAt?: Date;
+}
+/**
+ * In-memory job tracker singleton
+ */
+export declare class IndexJobTracker {
+    private static instance;
+    private jobs;
+    private readonly MAX_JOBS;
+    private readonly store?;
+    constructor(store?: JobStore);
+    static getInstance(): IndexJobTracker;
+    /**
+     * Create a new indexing job
+     */
+    createJob(projectId: string, projectPath: string): IndexJob;
+    /**
+     * Get job by ID. Phase 1: lazy-loads from the durable store on a hot miss.
+     */
+    getJob(jobId: string): IndexJob | undefined;
+    /**
+     * Update job status
+     */
+    updateStatus(jobId: string, status: IndexJob["status"]): void;
+    /**
+     * Update job progress. Piggybacks the heartbeat: every progress emit refreshes
+     * `heartbeatAt`, which is what `reapStaleJobs` checks. This keeps a healthy
+     * (actively-progressing) job from ever being reaped while catching jobs whose
+     * progress has gone silent.
+     */
+    updateProgress(jobId: string, current: number, total: number): void;
+    /**
+     * Tick ONLY the heartbeat (no progress change). Use when you want to signal
+     * "still alive" between progress emits (e.g. a long single-file parse that
+     * doesn't increment the file counter).
+     */
+    heartbeat(jobId: string): void;
+    /**
+     * Reap stale `running` jobs: flip any job whose heartbeat is older than
+     * `staleMs` (or, as a fallback for jobs with no heartbeat, whose `startedAt`
+     * is older than `staleMs`) to `failed`. Covers the case where a job hangs or
+     * crashes mid-flight while the server keeps running — the existing
+     * restart-time `markStaleRunningFailed` only fires on the NEXT process start,
+     * which never happens during a long-lived test suite.
+     *
+     * Returns the count of reaped jobs.
+     */
+    reapStaleJobs(staleMs: number): number;
+    /**
+     * Set job result on completion
+     */
+    setResult(jobId: string, result: IndexJob["result"], error?: string): void;
+    setResultAndFlush(jobId: string, result: IndexJob["result"], error?: string): Promise<void>;
+    /**
+     * List all jobs (for debugging/monitoring)
+     */
+    listJobs(): IndexJob[];
+    /**
+     * List jobs by project
+     */
+    listJobsByProject(projectId: string): IndexJob[];
+    /**
+     * Clean up old jobs (keep last MAX_JOBS).
+     *
+     * Never evict a non-terminal (pending/running) job: a long-running
+     * full-repo index can be dropped before the caller polls, making the job
+     * appear to never reach a terminal state. Only terminal (completed/failed)
+     * jobs are evictable; the oldest terminal job is dropped first. If the cap
+     * can only be met by dropping a non-terminal job (pathological case: more
+     * than MAX_JOBS in-flight jobs at once), the OLDEST non-terminal job is
+     * dropped as an absolute last resort with a warning.
+     */
+    private cleanupOldJobs;
+    /**
+     * Clear all jobs (for testing)
+     */
+    clear(): void;
+    /**
+     * Publish a state-CHANGE transition to the global eventBus (FR-16).
+     *
+     * Called ONLY from {@link setResult} (early-exit: pending→terminal) and
+     * {@link reapStaleJobs} (reaper: running→failed) — the two state-change
+     * paths the ETL pipeline does NOT own. The main indexing path
+     * (pending→running→completed|failed) is owned by the pipeline, which
+     * already emits `indexing:started` + `indexing:completed`/`indexing:failed`
+     * (pipeline.ts:286/390/509/576); the tracker never double-publishes it.
+     *
+     * Never called from {@link updateProgress} — progress ticks are
+     * high-frequency and the pipeline already publishes `indexing:progress`.
+     * The hard constraint is "state CHANGE only, not every progress tick".
+     *
+     * Event mapping (tracker-owned transitions only):
+     *   pending → completed  → `indexing:completed` (early-exit success path
+     *                          is theoretical; today early exits are failures)
+     *   pending → failed     → `indexing:failed` (lease-busy, managed-run fail)
+     *   running → failed     → `indexing:failed` (reaper: hung job)
+     *
+     * The `indexing:completed` payload carries the job result fields the
+     * tracker actually has; `symbolsIndexed` is 0 (only the pipeline knows
+     * symbol counts) and `activatedGraphGenerationId` is "" when absent.
+     */
+    private publishStateChange;
+}
+export declare const indexJobTracker: IndexJobTracker;
+//# sourceMappingURL=index-job-tracker.d.ts.map

package/dist/services/jobs/index-job-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-job-tracker.d.ts","sourceRoot":"","sources":["../../../src/services/jobs/index-job-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAO;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAW;gBAEtB,KAAK,CAAC,EAAE,QAAQ;IAI5B,MAAM,CAAC,WAAW,IAAI,eAAe;IAkBrC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ;IAsB3D;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAe3C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI;IAuB7D;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAanE;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO9B;;;;;;;;;OASG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IA0CtC;;OAEG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC1B,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IAsCD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjG;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAMtB;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIhD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,kBAAkB;CA0B3B;AAGD,eAAO,MAAM,eAAe,iBAAgC,CAAC"}