pulseed 0.0.1 → 0.1.0

package/dist/observation/data-source-adapter.js

@@ -0,0 +1,227 @@
+// ─── DataSourceAdapter ───
+//
+// Defines the IDataSourceAdapter interface and concrete implementations for
+// file-based and HTTP API data sources, plus DataSourceRegistry for managing
+// multiple adapter instances.
+import * as fsp from "node:fs/promises";
+import { ValidationError } from "../utils/errors.js";
+// ─── Helper ───
+export function getNestedValue(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+// ─── FileDataSourceAdapter ───
+export class FileDataSourceAdapter {
+    sourceId;
+    sourceType = "file";
+    config;
+    constructor(config) {
+        this.config = config;
+        this.sourceId = config.id;
+    }
+    async connect() {
+        const path = this.config.connection.path;
+        if (!path) {
+            throw new ValidationError(`FileDataSourceAdapter [${this.sourceId}]: connection.path is required`);
+        }
+        try {
+            await fsp.access(path);
+        }
+        catch {
+            throw new Error(`FileDataSourceAdapter [${this.sourceId}]: file not found: ${path}`);
+        }
+    }
+    async query(params) {
+        const path = this.config.connection.path;
+        if (!path) {
+            throw new ValidationError(`FileDataSourceAdapter [${this.sourceId}]: connection.path is required`);
+        }
+        let raw;
+        let value;
+        const content = await fsp.readFile(path, "utf-8");
+        if (path.endsWith(".json")) {
+            raw = JSON.parse(content);
+            if (params.expression) {
+                const extracted = getNestedValue(raw, params.expression);
+                value = extracted !== undefined ? extracted : null;
+            }
+            else {
+                value = null;
+            }
+        }
+        else {
+            raw = content;
+            value = content;
+        }
+        return {
+            value,
+            raw,
+            timestamp: new Date().toISOString(),
+            source_id: this.sourceId,
+        };
+    }
+    async disconnect() {
+        // no-op
+    }
+    async healthCheck() {
+        const path = this.config.connection.path;
+        if (!path)
+            return false;
+        try {
+            await fsp.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ─── HttpApiDataSourceAdapter ───
+function buildAuthHeaders(config) {
+    const auth = config.auth;
+    if (!auth || auth.type === "none")
+        return {};
+    const secret = auth.secret_ref ?? "";
+    if (auth.type === "api_key") {
+        return { "X-API-Key": secret };
+    }
+    if (auth.type === "bearer") {
+        return { Authorization: `Bearer ${secret}` };
+    }
+    if (auth.type === "basic") {
+        const encoded = Buffer.from(secret).toString("base64");
+        return { Authorization: `Basic ${encoded}` };
+    }
+    return {};
+}
+export class HttpApiDataSourceAdapter {
+    sourceId;
+    sourceType = "http_api";
+    config;
+    constructor(config) {
+        this.config = config;
+        this.sourceId = config.id;
+    }
+    async connect() {
+        const healthy = await this.healthCheck();
+        if (!healthy) {
+            throw new Error(`HttpApiDataSourceAdapter [${this.sourceId}]: health check failed for ${this.config.connection.url}`);
+        }
+    }
+    async query(params) {
+        const url = this.config.connection.url;
+        if (!url) {
+            throw new ValidationError(`HttpApiDataSourceAdapter [${this.sourceId}]: connection.url is required`);
+        }
+        const timeoutMs = params.timeout_ms ?? 10000;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const method = this.config.connection.method ?? "GET";
+        const headers = {
+            "Content-Type": "application/json",
+            ...this.config.connection.headers,
+            ...buildAuthHeaders(this.config),
+        };
+        let body;
+        if (method === "POST" && this.config.connection.body_template) {
+            body = this.config.connection.body_template.replace("{{dimension_name}}", params.dimension_name);
+        }
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers,
+                body,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok) {
+            throw new Error(`HttpApiDataSourceAdapter [${this.sourceId}]: HTTP ${response.status} from ${url}`);
+        }
+        const raw = await response.json();
+        let value = null;
+        if (params.expression) {
+            const extracted = getNestedValue(raw, params.expression);
+            value = extracted !== undefined ? extracted : null;
+        }
+        return {
+            value,
+            raw,
+            timestamp: new Date().toISOString(),
+            source_id: this.sourceId,
+        };
+    }
+    async disconnect() {
+        // no-op
+    }
+    async healthCheck() {
+        const url = this.config.connection.url;
+        if (!url)
+            return false;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 5000);
+        try {
+            const response = await fetch(url, {
+                method: "HEAD",
+                headers: buildAuthHeaders(this.config),
+                signal: controller.signal,
+            });
+            return response.status >= 200 && response.status < 300;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+// ─── DataSourceRegistry ───
+export class DataSourceRegistry {
+    sources = new Map();
+    register(adapter) {
+        if (this.sources.has(adapter.sourceId)) {
+            throw new Error(`DataSourceRegistry: source "${adapter.sourceId}" is already registered. ` +
+                `Remove it first before re-registering.`);
+        }
+        this.sources.set(adapter.sourceId, adapter);
+    }
+    getSource(id) {
+        const source = this.sources.get(id);
+        if (!source) {
+            throw new Error(`DataSourceRegistry: no source registered with id "${id}". ` +
+                `Available sources: [${this.listSources().join(", ")}]`);
+        }
+        return source;
+    }
+    listSources() {
+        return Array.from(this.sources.keys()).sort();
+    }
+    remove(id) {
+        if (!this.sources.has(id)) {
+            throw new Error(`DataSourceRegistry: cannot remove "${id}" — not registered. ` +
+                `Available sources: [${this.listSources().join(", ")}]`);
+        }
+        this.sources.delete(id);
+    }
+    has(id) {
+        return this.sources.has(id);
+    }
+    upsert(adapter) {
+        if (this.has(adapter.sourceId)) {
+            this.remove(adapter.sourceId);
+        }
+        this.register(adapter);
+    }
+}
+//# sourceMappingURL=data-source-adapter.js.map

package/dist/observation/data-source-adapter.js.map

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

package/dist/observation/dimension-pre-checker.d.ts

@@ -0,0 +1,24 @@
+import type { Dimension } from "../types/goal.js";
+import type { ObservationLogEntry } from "../types/state.js";
+export interface PreCheckResult {
+    changed: boolean;
+    hint?: string;
+    raw_value?: unknown;
+}
+export interface IDimensionPreChecker {
+    check(dimension: Dimension, lastObservation: ObservationLogEntry | null, goalContext: {
+        workspace_path?: string;
+    }): Promise<PreCheckResult>;
+}
+export interface DimensionPreCheckerConfig {
+    min_observation_interval_sec: number;
+    strategies: Array<"age" | "git_diff" | "file_stat">;
+}
+export declare class DimensionPreChecker implements IDimensionPreChecker {
+    private readonly config;
+    constructor(config?: Partial<DimensionPreCheckerConfig>);
+    check(dimension: Dimension, lastObservation: ObservationLogEntry | null, goalContext: {
+        workspace_path?: string;
+    }): Promise<PreCheckResult>;
+}
+//# sourceMappingURL=dimension-pre-checker.d.ts.map

package/dist/observation/dimension-pre-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-pre-checker.d.ts","sourceRoot":"","sources":["../../src/observation/dimension-pre-checker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,CACH,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,mBAAmB,GAAG,IAAI,EAC3C,WAAW,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAID,MAAM,WAAW,yBAAyB;IACxC,4BAA4B,EAAE,MAAM,CAAC;IACrC,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;CACrD;AAsED,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,MAAM,GAAE,OAAO,CAAC,yBAAyB,CAAM;IAIrD,KAAK,CACT,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,mBAAmB,GAAG,IAAI,EAC3C,WAAW,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,cAAc,CAAC;CA8C3B"}

package/dist/observation/dimension-pre-checker.js

@@ -0,0 +1,104 @@
+import { execFile as execFileCb } from "child_process";
+import { stat } from "fs/promises";
+import { promisify } from "util";
+const execFile = promisify(execFileCb);
+const DEFAULT_CONFIG = {
+    min_observation_interval_sec: 60,
+    strategies: ["age", "git_diff"],
+};
+// Age strategy: skip if last observation is younger than min_observation_interval.
+function checkAge(lastObservation, minIntervalSec) {
+    if (!lastObservation)
+        return null; // no previous obs → must run
+    const lastTs = new Date(lastObservation.timestamp).getTime();
+    const ageMs = Date.now() - lastTs;
+    if (ageMs < minIntervalSec * 1000) {
+        return { changed: false };
+    }
+    return null; // age check passes; defer to other strategies
+}
+// Git diff strategy: run `git status --short`. Empty → no change.
+async function checkGitDiff(workspacePath, lastObservation) {
+    if (!workspacePath)
+        return null;
+    if (!lastObservation)
+        return null;
+    try {
+        const { stdout } = await execFile("git", ["status", "--short"], { cwd: workspacePath, timeout: 8000, encoding: "utf8" });
+        if (stdout.trim().length === 0) {
+            return { changed: false };
+        }
+        return { changed: true, hint: stdout.trim().slice(0, 200) };
+    }
+    catch {
+        // Not a git repo or git unavailable — skip this strategy
+        return null;
+    }
+}
+// File stat strategy: if workspace mtime <= last observation timestamp, no change.
+async function checkFileStat(workspacePath, lastObservation) {
+    if (!workspacePath)
+        return null;
+    if (!lastObservation)
+        return null;
+    try {
+        const s = await stat(workspacePath);
+        const lastObsTime = new Date(lastObservation.timestamp).getTime();
+        const mtimeMs = s.mtimeMs;
+        if (mtimeMs <= lastObsTime) {
+            return { changed: false };
+        }
+        return { changed: true, hint: `Workspace mtime changed since last observation` };
+    }
+    catch {
+        // stat failed (path doesn't exist, permissions) — skip
+        return null;
+    }
+}
+// --- Default implementation ---
+export class DimensionPreChecker {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    async check(dimension, lastObservation, goalContext) {
+        // No previous observation → always run full observation
+        if (!lastObservation) {
+            return { changed: true };
+        }
+        const results = [];
+        for (const strategy of this.config.strategies) {
+            switch (strategy) {
+                case "age":
+                    results.push(checkAge(lastObservation, this.config.min_observation_interval_sec));
+                    break;
+                case "git_diff":
+                    results.push(await checkGitDiff(goalContext.workspace_path, lastObservation));
+                    break;
+                case "file_stat":
+                    results.push(await checkFileStat(goalContext.workspace_path, lastObservation));
+                    break;
+            }
+        }
+        // Filter out null results (strategy not applicable)
+        const applicable = results.filter((r) => r !== null);
+        // No applicable strategy produced a result → default to changed=true (run LLM)
+        if (applicable.length === 0) {
+            return { changed: true };
+        }
+        // If ANY strategy reports changed=true → proceed to LLM
+        const changedResult = applicable.find((r) => r.changed);
+        if (changedResult) {
+            return changedResult;
+        }
+        // ALL applicable strategies report changed=false → skip
+        const hints = applicable.map((r) => r.hint).filter(Boolean);
+        const rawValue = applicable.find((r) => r.raw_value !== undefined)?.raw_value;
+        return {
+            changed: false,
+            hint: hints.length > 0 ? hints.join("; ") : undefined,
+            raw_value: rawValue,
+        };
+    }
+}
+//# sourceMappingURL=dimension-pre-checker.js.map

package/dist/observation/dimension-pre-checker.js.map

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

package/dist/observation/observation-apply.d.ts

@@ -0,0 +1,18 @@
+import type { ObservationLogEntry } from "../types/state.js";
+import type { StateManager } from "../state-manager.js";
+import type { IDataSourceAdapter } from "./data-source-adapter.js";
+import type { ObservationEngineOptions } from "./observation-helpers.js";
+/**
+ * Apply a completed observation entry to the persisted goal state.
+ *
+ * - Enforces monotonic floor for "min" thresholds (prevents noise from hiding progress).
+ * - Only updates confidence when the incoming layer has >= priority than existing.
+ * - Appends to dimension history.
+ * - Optionally indexes the dimension name in the vector index (fire-and-forget).
+ */
+export declare function applyObservation(goalId: string, entry: ObservationLogEntry, stateManager: StateManager, options: ObservationEngineOptions): Promise<void>;
+/**
+ * Observe a goal dimension by querying a registered data source.
+ */
+export declare function observeFromDataSource(goalId: string, dimensionName: string, sourceId: string, dataSources: IDataSourceAdapter[], applyFn: (goalId: string, entry: ObservationLogEntry) => Promise<void>): Promise<ObservationLogEntry>;
+//# sourceMappingURL=observation-apply.d.ts.map

package/dist/observation/observation-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-apply.d.ts","sourceRoot":"","sources":["../../src/observation/observation-apply.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGzE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,mBAAmB,EAC1B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CA4Hf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,kBAAkB,EAAE,EACjC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GACrE,OAAO,CAAC,mBAAmB,CAAC,CA8D9B"}

package/dist/observation/observation-apply.js

@@ -0,0 +1,180 @@
+import { randomUUID } from "node:crypto";
+import { ObservationLogEntrySchema } from "../types/state.js";
+import { LAYER_PRIORITY, normalizeDimensionName } from "./observation-helpers.js";
+/**
+ * Apply a completed observation entry to the persisted goal state.
+ *
+ * - Enforces monotonic floor for "min" thresholds (prevents noise from hiding progress).
+ * - Only updates confidence when the incoming layer has >= priority than existing.
+ * - Appends to dimension history.
+ * - Optionally indexes the dimension name in the vector index (fire-and-forget).
+ */
+export async function applyObservation(goalId, entry, stateManager, options) {
+    const goal = await stateManager.loadGoal(goalId);
+    if (goal === null) {
+        throw new Error(`applyObservation: goal "${goalId}" not found`);
+    }
+    const safeName = normalizeDimensionName(entry.dimension_name);
+    const dimIndex = goal.dimensions.findIndex((d) => d.name === safeName);
+    if (dimIndex === -1) {
+        throw new Error(`applyObservation: dimension "${entry.dimension_name}" not found in goal "${goalId}"`);
+    }
+    const dim = goal.dimensions[dimIndex];
+    // ─── Value bounds validation ───
+    // Clamp numeric observation values to reasonable bounds based on threshold type.
+    // This prevents LLM hallucinations (e.g., reporting 1.0 for a normalized dimension
+    // when the actual value is 0) from persisting unchecked.
+    let effectiveValue = entry.extracted_value;
+    if (typeof effectiveValue === "number") {
+        const thresholdType = dim.threshold.type;
+        if (thresholdType === "present" || thresholdType === "match") {
+            // present/match dimensions use 0-1 normalized values
+            if (effectiveValue < 0 || effectiveValue > 1) {
+                const clamped = Math.max(0, Math.min(1, effectiveValue));
+                // Log is intentionally omitted here — callers handle warnings
+                effectiveValue = clamped;
+            }
+        }
+        else if (thresholdType === "min" && "value" in dim.threshold) {
+            // min thresholds: value should not exceed 2x the target (sanity bound)
+            const maxBound = dim.threshold.value * 2;
+            if (maxBound > 0 && effectiveValue > maxBound) {
+                effectiveValue = maxBound;
+            }
+            if (effectiveValue < 0) {
+                effectiveValue = 0;
+            }
+        }
+        else if (thresholdType === "max" && "value" in dim.threshold) {
+            // max thresholds: value should not be negative
+            if (effectiveValue < 0) {
+                effectiveValue = 0;
+            }
+        }
+    }
+    // Monotonic floor for min thresholds: never decrease an observed value below the
+    // current floor. This prevents noise from hiding real progress on "higher is better"
+    // dimensions. Max thresholds are NOT clamped — regressions (e.g. bug count going up)
+    // must remain visible.
+    if (typeof effectiveValue === 'number' && typeof dim.current_value === 'number') {
+        // NOTE: range thresholds intentionally not clamped — progress direction is ambiguous.
+        // Assumes earlier observations are reliable; no mechanism to override a false-high floor.
+        if (dim.threshold.type === 'min' &&
+            effectiveValue < dim.current_value &&
+            entry.confidence < (dim.confidence ?? 1)) {
+            effectiveValue = dim.current_value;
+        }
+    }
+    // Determine if the incoming observation should update the dimension's confidence.
+    // Only allow confidence updates from an equal or higher-priority layer.
+    // This prevents a low-layer self_report from downgrading confidence that was
+    // established by a mechanical or independent_review observation.
+    const existingTier = (dim.last_observed_layer ?? "self_report");
+    const existingPriority = LAYER_PRIORITY[existingTier] ?? 0;
+    const incomingPriority = LAYER_PRIORITY[entry.layer] ?? 0;
+    // Allow update when the incoming layer has equal or higher priority.
+    // Same-layer updates are accepted regardless of confidence direction
+    // ONLY when there has been a prior real observation (last_observed_layer is set),
+    // so that repeated LLM observations can reflect new (lower) confidence values
+    // rather than freezing at the first observation (#315).
+    // When last_observed_layer is null (initial seed confidence, never observed),
+    // the same-priority guard still applies so the seed is not prematurely overwritten
+    // by a low-confidence incoming entry.
+    const hasBeenObserved = dim.last_observed_layer !== null && dim.last_observed_layer !== undefined;
+    const shouldUpdateConfidence = incomingPriority > existingPriority ||
+        (incomingPriority === existingPriority && (hasBeenObserved || entry.confidence >= (dim.confidence ?? 0)));
+    // Update dimension values
+    const updatedDim = {
+        ...dim,
+        current_value: effectiveValue,
+        confidence: shouldUpdateConfidence ? entry.confidence : dim.confidence,
+        last_observed_layer: shouldUpdateConfidence ? entry.layer : dim.last_observed_layer,
+        last_updated: entry.timestamp,
+        history: [
+            ...dim.history,
+            {
+                value: entry.extracted_value,
+                timestamp: entry.timestamp,
+                confidence: entry.confidence,
+                source_observation_id: entry.observation_id,
+            },
+        ],
+    };
+    const updatedDimensions = [...goal.dimensions];
+    updatedDimensions[dimIndex] = updatedDim;
+    const updatedGoal = {
+        ...goal,
+        dimensions: updatedDimensions,
+        updated_at: new Date().toISOString(),
+    };
+    // Persist observation entry
+    await stateManager.appendObservation(goalId, entry);
+    // Persist updated goal
+    await stateManager.saveGoal(updatedGoal);
+    // Index dimension name for semantic search (fire-and-forget, non-blocking)
+    if (options.vectorIndex) {
+        const vi = options.vectorIndex;
+        vi.add(`dim:${goalId}:${entry.dimension_name}`, entry.dimension_name, {
+            goal_id: goalId,
+            type: "dimension",
+        }).catch(() => { });
+    }
+}
+/**
+ * Observe a goal dimension by querying a registered data source.
+ */
+export async function observeFromDataSource(goalId, dimensionName, sourceId, dataSources, applyFn) {
+    const source = dataSources.find((s) => s.sourceId === sourceId);
+    if (!source) {
+        throw new Error(`observeFromDataSource: data source "${sourceId}" not found. ` +
+            `Available: [${dataSources.map((s) => s.sourceId).join(", ")}]`);
+    }
+    const query = {
+        dimension_name: dimensionName,
+        timeout_ms: 10000,
+    };
+    const expression = source.config.dimension_mapping?.[dimensionName];
+    if (expression !== undefined) {
+        query.expression = expression;
+    }
+    const result = await source.query(query);
+    let extractedValue;
+    if (typeof result.value === "number") {
+        extractedValue = result.value;
+    }
+    else if (typeof result.value === "string") {
+        const parsed = parseFloat(result.value);
+        extractedValue = isNaN(parsed) ? result.value : parsed;
+    }
+    else if (typeof result.value === "boolean" || result.value === null) {
+        extractedValue = result.value;
+    }
+    else {
+        extractedValue = 0;
+    }
+    if (extractedValue === null || extractedValue === undefined) {
+        throw new Error(`Data source "${sourceId}" returned null for dimension "${dimensionName}"`);
+    }
+    const entry = ObservationLogEntrySchema.parse({
+        observation_id: randomUUID(),
+        timestamp: result.timestamp,
+        trigger: "periodic",
+        goal_id: goalId,
+        dimension_name: dimensionName,
+        layer: "mechanical",
+        method: {
+            type: "mechanical",
+            source: "data_source",
+            schedule: null,
+            endpoint: sourceId,
+            confidence_tier: "mechanical",
+        },
+        raw_result: result.raw,
+        extracted_value: extractedValue,
+        confidence: 0.90,
+        notes: `Data source: ${sourceId}`,
+    });
+    await applyFn(goalId, entry);
+    return entry;
+}
+//# sourceMappingURL=observation-apply.js.map

package/dist/observation/observation-apply.js.map

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

package/dist/observation/observation-datasource.d.ts

@@ -0,0 +1,21 @@
+import type { ObservationLogEntry } from "../types/state.js";
+import type { IDataSourceAdapter } from "./data-source-adapter.js";
+/**
+ * Find the first DataSource adapter that can serve the given dimension name.
+ * Checks both getSupportedDimensions() and dimension_mapping config keys.
+ * Returns null if no adapter matches.
+ */
+export declare function findDataSourceForDimension(dataSources: IDataSourceAdapter[], dimensionName: string, goalId?: string): IDataSourceAdapter | null;
+/**
+ * Observe a goal dimension by querying a registered data source.
+ *
+ * Steps:
+ *   1. Find the data source by sourceId.
+ *   2. Build a DataSourceQuery, using dimension_mapping if configured.
+ *   3. Call source.query().
+ *   4. Convert result value to numeric if possible.
+ *   5. Create and persist an ObservationLogEntry via applyObservation callback.
+ *   6. Return the entry.
+ */
+export declare function observeFromDataSource(dataSources: IDataSourceAdapter[], goalId: string, dimensionName: string, sourceId: string, applyObservation: (goalId: string, entry: ObservationLogEntry) => void): Promise<ObservationLogEntry>;
+//# sourceMappingURL=observation-datasource.d.ts.map

package/dist/observation/observation-datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-datasource.d.ts","sourceRoot":"","sources":["../../src/observation/observation-datasource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,kBAAkB,EAAE,EACjC,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,kBAAkB,GAAG,IAAI,CA4B3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,kBAAkB,EAAE,EACjC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,IAAI,GACrE,OAAO,CAAC,mBAAmB,CAAC,CA8D9B"}