@massa-ai/core 1.2.1

package/dist/services/hooks/hook-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-service.d.ts","sourceRoot":"","sources":["../../../src/services/hooks/hook-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAIL,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACtB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAuB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAInC,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,eAAe,EAAE,MAAM,GACtB,gBAAgB,CA0DlB;AAID,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACpC;AAQD,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,GAAE,kBAAuB;IAWzC,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB;IAI9C;;;;;;OAMG;IACG,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAMpD;;;;;OAKG;IACG,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAmB7C,mBAAmB;CA+ClC;AAED,qBAAa,eAAgB,SAAQ,KAAK;aACZ,IAAI,EAAE,GAAG,GAAG,GAAG;gBAAf,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM;CAI7D;AA6DD,wBAAgB,cAAc,IAAI,WAAW,CAI5C;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/services/hooks/hook-service.js

@@ -0,0 +1,272 @@
+/**
+ * HookService — passive lifecycle-event ingestion (Phase 3, G1).
+ *
+ * Accepts six lifecycle event kinds, validates/normalizes them, persists each
+ * as an Observation via the single-writer WriterQueue, emits
+ * `observation:ingested`, and (debounce) triggers the consolidation bridge.
+ *
+ * Contract (spec.md):
+ *  - Fire-and-forget: a validated+admitted event returns 202 with its id; the
+ *    actual persist runs on the writer turn.
+ *  - 429 on saturation: when `WriterQueue.saturated`, `ingestOne`/`ingestBatch`
+ *    throw QueueSaturatedError and the route maps to HTTP 429 (no admission).
+ *  - 400/413 on validation failure (before admission).
+ *  - LLM-free: ingestion has no LLM dependency; the bridge is the only
+ *    LLM-touching stage and it silent-degrades.
+ */
+import { config, logger } from "@massa-ai/shared";
+import { eventBus } from "../events/event-bus.js";
+import { getObservationStore, LIFECYCLE_EVENTS, newObservationId, } from "../../data/memory/observation-repository.js";
+import { WriterQueue } from "./writer-queue.js";
+import { extractCategory } from "./observation-extractor.js";
+import { observationConsolidationJob } from "../jobs/observation-consolidation-job.js";
+import { getAttributionResolver, } from "./attribution-resolver.js";
+/** No-op bridge default (used before the real job is wired / in tests). */
+class NoopBridge {
+    maybeRun() { }
+}
+// ── Validation ──────────────────────────────────────────────────────────────
+function clamp(n, lo, hi) {
+    if (Number.isNaN(n))
+        return lo;
+    return Math.min(hi, Math.max(lo, n));
+}
+/**
+ * Validate + normalize a single incoming event. Pure (no IO). Returns a
+ * discriminated union; `{ok:false}` carries the HTTP-ish code.
+ */
+export function validateEvent(raw, maxPayloadBytes) {
+    if (!raw || typeof raw !== "object") {
+        return { ok: false, code: 400, error: "event body must be an object" };
+    }
+    // event kind — case-insensitive normalize to canonical.
+    const rawEvent = typeof raw.event === "string" ? raw.event.toLowerCase().trim() : "";
+    const kind = LIFECYCLE_EVENTS.find((k) => k === rawEvent);
+    if (!kind) {
+        return {
+            ok: false,
+            code: 400,
+            error: `unknown event kind: ${String(raw.event)}`,
+        };
+    }
+    // projectId — non-empty string.
+    const projectId = typeof raw.projectId === "string" ? raw.projectId.trim() : "";
+    if (!projectId) {
+        return { ok: false, code: 400, error: "projectId must be a non-empty string" };
+    }
+    // payload — non-empty object.
+    if (!raw.payload || typeof raw.payload !== "object" || Array.isArray(raw.payload)) {
+        return { ok: false, code: 400, error: "payload must be a non-empty object" };
+    }
+    if (Object.keys(raw.payload).length === 0) {
+        return { ok: false, code: 400, error: "payload must be a non-empty object" };
+    }
+    // size cap.
+    let serialized;
+    try {
+        serialized = JSON.stringify(raw.payload);
+    }
+    catch {
+        return { ok: false, code: 400, error: "payload is not serializable" };
+    }
+    if (serialized.length > maxPayloadBytes) {
+        return {
+            ok: false,
+            code: 413,
+            error: `payload exceeds maxPayloadBytes (${maxPayloadBytes})`,
+        };
+    }
+    const importance = raw.importance !== undefined ? clamp(Number(raw.importance), 0, 1) : 0.5;
+    const sessionId = typeof raw.sessionId === "string" && raw.sessionId.trim() ? raw.sessionId : null;
+    const agentId = typeof raw.agentId === "string" && raw.agentId.trim() ? raw.agentId : null;
+    const ts = typeof raw.ts === "number" && raw.ts > 0 ? raw.ts : Date.now();
+    return {
+        ok: true,
+        event: { event: kind, projectId, sessionId, payload: raw.payload, importance, agentId, ts },
+    };
+}
+/** Attribution cwd: `payload.cwd` wins, `payload.workingDirectory` fallback. */
+function extractAttributionCwd(payload) {
+    const cwd = payload.cwd ?? payload.workingDirectory;
+    return typeof cwd === "string" && cwd.trim() ? cwd : undefined;
+}
+export class HookService {
+    store;
+    queue;
+    bridge;
+    resolver;
+    maxPayloadBytes;
+    idFactory;
+    constructor(opts = {}) {
+        this.store = opts.store ?? getObservationStore();
+        const configuredMax = readHooksConfig().queue.maxPending;
+        this.queue = new WriterQueue(opts.maxPending ?? configuredMax);
+        this.maxPayloadBytes =
+            opts.maxPayloadBytes ?? readHooksConfig().maxPayloadBytes;
+        this.bridge = opts.bridge ?? new NoopBridge();
+        this.idFactory = opts.idFactory ?? (() => newObservationId());
+        this.resolver = opts.resolver ?? getAttributionResolver();
+    }
+    validate(raw) {
+        return validateEvent(raw, this.maxPayloadBytes);
+    }
+    /**
+     * Validate, admit, and enqueue a single event. Resolves with the observation
+     * id (the persist itself runs on the writer turn — fire-and-forget from the
+     * caller's perspective, but the id is returned synchronously on admission).
+     *
+     * Throws QueueSaturatedError → route maps to 429.
+     */
+    async ingestOne(raw) {
+        const v = this.validate(raw);
+        if (!v.ok)
+            throw new ValidationError(v.code, v.error);
+        return this.ingestOneNormalized(v.event);
+    }
+    /**
+     * Validate the whole batch atomically, then admit all. Returns the array of
+     * ids in input order. Throws ValidationError (400/413) if ANY event is bad,
+     * before persisting anything; throws QueueSaturatedError if the queue cannot
+     * admit the full batch.
+     */
+    async ingestBatch(raws) {
+        if (!Array.isArray(raws) || raws.length === 0) {
+            throw new ValidationError(400, "events must be a non-empty array");
+        }
+        // Atomic validation first.
+        const validated = [];
+        for (const raw of raws) {
+            const v = this.validate(raw);
+            if (!v.ok)
+                throw new ValidationError(v.code, v.error);
+            validated.push(v.event);
+        }
+        // Then admit (may throw QueueSaturatedError).
+        const ids = [];
+        for (const ev of validated) {
+            ids.push(await this.ingestOneNormalized(ev));
+        }
+        return ids;
+    }
+    async ingestOneNormalized(ev) {
+        // Attribution resolution runs pre-enqueue (M45/HAR-01): one seam for
+        // single + batch. The resolver never throws (fail-open verbatim).
+        const attribution = await this.resolver.resolve({
+            callerProjectId: ev.projectId,
+            sessionId: ev.sessionId,
+            cwd: extractAttributionCwd(ev.payload),
+        });
+        const id = this.idFactory();
+        // Enqueue may throw QueueSaturatedError BEFORE any side effect; pinning
+        // happens only after admission survives (HAR-04, no pin on rejection).
+        void this.queue.enqueue(async () => {
+            const obs = {
+                id,
+                projectId: attribution.projectId,
+                sessionId: ev.sessionId,
+                source: ev.event,
+                category: extractCategory(ev.event, ev.payload),
+                payloadJson: JSON.stringify(ev.payload),
+                importance: ev.importance,
+                createdAt: ev.ts,
+                agentId: ev.agentId,
+                attributionSource: attribution.source,
+            };
+            try {
+                this.store.insert(obs);
+                eventBus.publish("observation:ingested", {
+                    observationId: obs.id,
+                    projectId: obs.projectId,
+                    sessionId: obs.sessionId ?? undefined,
+                    source: obs.source,
+                    importance: obs.importance,
+                });
+                this.bridge.maybeRun(obs.projectId);
+            }
+            catch (e) {
+                // Fire-and-forget: a persist failure after admission is logged, not
+                // retried, and does NOT poison the queue (spec §11 / design §5).
+                logger.warn("observation persist failed", {
+                    id: obs.id,
+                    error: e.message,
+                });
+            }
+        });
+        // Admission survived: record sticky pin (no-op for verbatim / no session).
+        this.resolver.pinSession(ev.sessionId, attribution.projectId, attribution.source);
+        return id;
+    }
+}
+export class ValidationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ValidationError";
+    }
+}
+// ── Defensive config reader ─────────────────────────────────────────────────
+// Real config always has the hooks block (added in Phase 3). Some test files
+// mock @massa-ai/shared process-wide and omit it; fall back to spec defaults
+// (mirrors the Phase-2 QueryUnderstandingService defensive reader pattern).
+const FALLBACK_HOOKS = {
+    enabled: true,
+    maxPayloadBytes: 65_536,
+    queue: { maxPending: 256 },
+    bridge: {
+        enabled: true,
+        minObservations: 8,
+        minIntervalMs: 5 * 60 * 1000,
+        maxWindow: 8,
+    },
+};
+function readHooksConfig() {
+    try {
+        const c = config.get("hooks");
+        if (c && typeof c === "object")
+            return c;
+    }
+    catch {
+        /* fall through */
+    }
+    return FALLBACK_HOOKS;
+}
+// ── Singleton ───────────────────────────────────────────────────────────────
+/**
+ * Resolve the default bridge for the production singleton. Returns the real
+ * ObservationConsolidationJob (which implements BridgeTrigger with its own
+ * debounce + silent-degrade); falls back to NoopBridge if the job is somehow
+ * unavailable so hook ingestion never crashes.
+ *
+ * Note: this is ONLY the default for getHookService() (the production path).
+ * Tests construct HookService directly with an injected bridge; the NoopBridge
+ * default in the ctor preserves the isolation contract (no LLM/store touch).
+ */
+function resolveDefaultBridge() {
+    try {
+        // observationConsolidationJob.maybeRun is the debounced, fire-and-forget,
+        // never-throwing entrypoint (see observation-consolidation-job.ts). It also
+        // honors `hooks.bridge.enabled` internally, so disabling the feature flag
+        // makes it a safe no-op without unwiring here.
+        if (observationConsolidationJob &&
+            typeof observationConsolidationJob.maybeRun === "function") {
+            return observationConsolidationJob;
+        }
+    }
+    catch {
+        /* fall through to NoopBridge */
+    }
+    return new NoopBridge();
+}
+let cachedService = null;
+export function getHookService() {
+    if (cachedService)
+        return cachedService;
+    cachedService = new HookService({ bridge: resolveDefaultBridge() });
+    return cachedService;
+}
+/** Test hook: reset the cached service (and the underlying observation store). */
+export function resetHookService() {
+    cachedService = null;
+}
+//# sourceMappingURL=hook-service.js.map

package/dist/services/hooks/hook-service.js.map

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

package/dist/services/hooks/observation-extractor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ObservationExtractor — derives a semantic `category` from (source, payload).
+ *
+ * Ported fresh (NOT copied) from context-mode's extract.ts approach: a set of
+ * pure, side-effect-free classifier functions dispatched off the lifecycle
+ * `source` + the payload shape. Each classifier inspects the payload for
+ * tool-name / field-shape signals and returns an `ObservationCategory`.
+ *
+ * Design:
+ *  - Pure: (source, payload) → category. No IO, no state, never throws.
+ *  - Graceful: unknown payloads fall back to "lifecycle-raw".
+ *  - Backward-compatible: the 6 lifecycle `source` kinds are unchanged; the
+ *    category is an additive derived field.
+ *  - The category drives the compaction snapshot's table-of-contents sections.
+ */
+import type { LifecycleEventKind } from "../../data/memory/observation-repository.js";
+import type { ObservationCategory } from "../../data/memory/observation-repository.js";
+/**
+ * Derive an `ObservationCategory` from (source, payload).
+ *
+ * Pure, never throws. Returns "lifecycle-raw" when no classifier matches
+ * (backward-compatible fallback for legacy/unknown payloads).
+ */
+export declare function extractCategory(source: LifecycleEventKind, payload: Record<string, unknown>): ObservationCategory;
+/**
+ * Human-readable label for a category (ported from context-mode analytics.ts).
+ * Used by the compaction snapshot's section headers.
+ */
+export declare const CATEGORY_LABELS: Record<ObservationCategory, string>;
+//# sourceMappingURL=observation-extractor.d.ts.map

package/dist/services/hooks/observation-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-extractor.d.ts","sourceRoot":"","sources":["../../../src/services/hooks/observation-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AA2TvF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,mBAAmB,CAwBrB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAkC/D,CAAC"}