pulseed 0.4.17 → 0.4.19

package/dist/platform/observation/engine/observe-context.js

@@ -0,0 +1,26 @@
+export function createWorkspaceContextFetcher(contextProvider, logger) {
+    const contextCache = new Map();
+    let warnedNoProvider = false;
+    return async (goalId, dimensionName) => {
+        const cacheKey = `${goalId}::${dimensionName}`;
+        if (contextCache.has(cacheKey))
+            return contextCache.get(cacheKey);
+        if (contextProvider) {
+            try {
+                const context = await contextProvider(goalId, dimensionName);
+                contextCache.set(cacheKey, context);
+                return context;
+            }
+            catch (err) {
+                logger?.warn(`[ObservationEngine] contextProvider failed: ${err instanceof Error ? err.message : String(err)}. LLM observation will proceed without workspace context.`);
+                return undefined;
+            }
+        }
+        if (!warnedNoProvider) {
+            warnedNoProvider = true;
+            logger?.warn(`[ObservationEngine] No contextProvider configured. LLM observation will proceed without workspace context (scores may be unreliable).`);
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=observe-context.js.map

package/dist/platform/observation/engine/observe-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-context.js","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-context.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,6BAA6B,CAC3C,eAAyF,EACzF,MAAe;IAEf,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,OAAO,KAAK,EAAE,MAAc,EAAE,aAAqB,EAA+B,EAAE;QAClF,MAAM,QAAQ,GAAG,GAAG,MAAM,KAAK,aAAa,EAAE,CAAC;QAC/C,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAElE,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;gBAC7D,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACpC,OAAO,OAAO,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,EAAE,IAAI,CACV,+CAA+C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,2DAA2D,CAC3J,CAAC;gBACF,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,gBAAgB,GAAG,IAAI,CAAC;YACxB,MAAM,EAAE,IAAI,CACV,uIAAuI,CACxI,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/dist/platform/observation/engine/observe-datasource-stage.d.ts

@@ -0,0 +1,33 @@
+import type { ObservationMethod } from "../../../base/types/core.js";
+import type { Goal } from "../../../base/types/goal.js";
+import type { StateManager } from "../../../base/state/state-manager.js";
+import type { Dimension } from "../../../orchestrator/goal/types/goal.js";
+import type { HookManager } from "../../../runtime/hook-manager.js";
+import type { Logger } from "../../../runtime/logger.js";
+import type { IDataSourceAdapter } from "../data-source-adapter.js";
+import type { ObservationLogEntry } from "../../../base/types/state.js";
+import type { WorkspaceContextFetcher } from "./observe-context.js";
+import type { CrossValidationResult } from "../observation-helpers.js";
+type ObserveFromDataSource = (goalId: string, dimensionName: string, sourceId: string) => Promise<ObservationLogEntry>;
+type ObserveWithLLM = (goalId: string, dimensionName: string, goalDescription: string, dimensionLabel: string, thresholdDescription: string, workspaceContext?: string, previousScore?: number | null, dryRun?: boolean, currentValue?: number | null, sourceAvailable?: boolean, workspacePath?: string) => Promise<ObservationLogEntry>;
+type CrossValidate = (goalId: string, dimensionName: string, mechanicalValue: number, llmValue: number) => CrossValidationResult;
+interface ObserveDataSourceStageParams {
+    goalId: string;
+    goal: Goal;
+    dimension: Dimension;
+    method: ObservationMethod;
+    dataSource: IDataSourceAdapter;
+    workspacePath?: string;
+    crossValidationEnabled: boolean;
+    llmAvailable: boolean;
+    stateManager: StateManager;
+    fetchWorkspaceContext: WorkspaceContextFetcher;
+    observeFromDataSource: ObserveFromDataSource;
+    observeWithLLM: ObserveWithLLM;
+    crossValidate: CrossValidate;
+    logger?: Logger;
+    hookManager?: HookManager;
+}
+export declare function runDataSourceObservationStage({ goalId, goal, dimension, dataSource, workspacePath, crossValidationEnabled, llmAvailable, stateManager, fetchWorkspaceContext, observeFromDataSource, observeWithLLM, crossValidate, logger, hookManager, }: ObserveDataSourceStageParams): Promise<boolean>;
+export {};
+//# sourceMappingURL=observe-datasource-stage.d.ts.map

package/dist/platform/observation/engine/observe-datasource-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-datasource-stage.d.ts","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-datasource-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AACvH,KAAK,cAAc,GAAG,CACpB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,MAAM,EAC5B,gBAAgB,CAAC,EAAE,MAAM,EACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,MAAM,CAAC,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,eAAe,CAAC,EAAE,OAAO,EACzB,aAAa,CAAC,EAAE,MAAM,KACnB,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAClC,KAAK,aAAa,GAAG,CACnB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,KACb,qBAAqB,CAAC;AAE3B,UAAU,4BAA4B;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,OAAO,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,qBAAqB,EAAE,uBAAuB,CAAC;IAC/C,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,6BAA6B,CAAC,EAClD,MAAM,EACN,IAAI,EACJ,SAAS,EACT,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,MAAM,EACN,WAAW,GACZ,EAAE,4BAA4B,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BjD"}

package/dist/platform/observation/engine/observe-datasource-stage.js

@@ -0,0 +1,66 @@
+export async function runDataSourceObservationStage({ goalId, goal, dimension, dataSource, workspacePath, crossValidationEnabled, llmAvailable, stateManager, fetchWorkspaceContext, observeFromDataSource, observeWithLLM, crossValidate, logger, hookManager, }) {
+    try {
+        await observeFromDataSource(goalId, dimension.name, dataSource.sourceId);
+        if (crossValidationEnabled && llmAvailable) {
+            await runCrossValidation({
+                goalId,
+                goal,
+                dimension,
+                workspacePath,
+                stateManager,
+                fetchWorkspaceContext,
+                observeWithLLM,
+                crossValidate,
+                logger,
+            });
+        }
+        void hookManager?.emit("PostObserve", {
+            goal_id: goalId,
+            dimension: dimension.name,
+            data: { value: null, confidence: null },
+        });
+        return true;
+    }
+    catch (err) {
+        logger?.warn(`[ObservationEngine] DataSource observation failed for dimension "${dimension.name}" (source: ${dataSource.sourceId}): ${err instanceof Error ? err.message : String(err)}. Falling through to LLM fallback.`);
+        return false;
+    }
+}
+async function runCrossValidation({ goalId, goal, dimension, workspacePath, stateManager, fetchWorkspaceContext, observeWithLLM, crossValidate, logger, }) {
+    try {
+        const updatedGoal = await stateManager.loadGoal(goalId);
+        const dimState = updatedGoal?.dimensions.find((candidate) => candidate.name === dimension.name);
+        const mechanicalValue = typeof dimState?.current_value === "number" ? dimState.current_value : 0;
+        const workspaceContext = await fetchWorkspaceContext(goalId, dimension.name);
+        const llmEntry = await observeWithLLM(goalId, dimension.name, goal.description, dimension.label ?? dimension.name, JSON.stringify(dimension.threshold), workspaceContext, null, true, undefined, undefined, workspacePath);
+        const llmValue = typeof llmEntry.extracted_value === "number" ? llmEntry.extracted_value : 0;
+        const result = crossValidate(goalId, dimension.name, mechanicalValue, llmValue);
+        if (result.diverged && result.confidencePenalty > 0) {
+            await applyConfidencePenalty(stateManager, goalId, dimension.name, result, logger);
+        }
+    }
+    catch (err) {
+        logger?.warn(`[CrossValidation] LLM comparison failed for "${dimension.name}": ${err}`);
+    }
+}
+async function applyConfidencePenalty(stateManager, goalId, dimensionName, result, logger) {
+    const currentGoal = await stateManager.loadGoal(goalId);
+    if (!currentGoal)
+        return;
+    const dimIdx = currentGoal.dimensions.findIndex((dimension) => dimension.name === dimensionName);
+    if (dimIdx === -1)
+        return;
+    const currentDim = currentGoal.dimensions[dimIdx];
+    const penalizedConfidence = Math.max(0.10, (currentDim.confidence ?? 0.5) - result.confidencePenalty);
+    const updatedDims = [...currentGoal.dimensions];
+    updatedDims[dimIdx] = { ...currentDim, confidence: penalizedConfidence };
+    await stateManager.saveGoal({
+        ...currentGoal,
+        dimensions: updatedDims,
+        updated_at: new Date().toISOString(),
+    });
+    logger?.warn(`[CrossValidation] Confidence penalized for "${dimensionName}": ` +
+        `${(currentDim.confidence ?? 0.5).toFixed(3)} → ${penalizedConfidence.toFixed(3)} ` +
+        `(penalty=${result.confidencePenalty.toFixed(3)}, LLM hallucination detected)`);
+}
+//# sourceMappingURL=observe-datasource-stage.js.map

package/dist/platform/observation/engine/observe-datasource-stage.js.map

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

package/dist/platform/observation/engine/observe-llm-stage.d.ts

@@ -0,0 +1,25 @@
+import type { ObservationLogEntry } from "../../../base/types/state.js";
+import type { ObservationMethod } from "../../../base/types/core.js";
+import type { Goal } from "../../../base/types/goal.js";
+import type { Dimension } from "../../../orchestrator/goal/types/goal.js";
+import type { HookManager } from "../../../runtime/hook-manager.js";
+import type { Logger } from "../../../runtime/logger.js";
+import type { WorkspaceContextFetcher } from "./observe-context.js";
+type ApplyObservation = (goalId: string, entry: ObservationLogEntry) => Promise<void>;
+type ObserveWithLLM = (goalId: string, dimensionName: string, goalDescription: string, dimensionLabel: string, thresholdDescription: string, workspaceContext?: string, previousScore?: number | null, dryRun?: boolean, currentValue?: number | null, sourceAvailable?: boolean, workspacePath?: string) => Promise<ObservationLogEntry>;
+interface ObserveLlmStageParams {
+    goalId: string;
+    goal: Goal;
+    dimension: Dimension;
+    method: ObservationMethod;
+    workspacePath?: string;
+    dataSourceAvailable: boolean;
+    fetchWorkspaceContext: WorkspaceContextFetcher;
+    observeWithLLM: ObserveWithLLM;
+    applyObservation: ApplyObservation;
+    logger?: Logger;
+    hookManager?: HookManager;
+}
+export declare function runLlmObservationStage({ goalId, goal, dimension, method, workspacePath, dataSourceAvailable, fetchWorkspaceContext, observeWithLLM, applyObservation, logger, hookManager, }: ObserveLlmStageParams): Promise<boolean>;
+export {};
+//# sourceMappingURL=observe-llm-stage.d.ts.map

package/dist/platform/observation/engine/observe-llm-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-llm-stage.d.ts","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-llm-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACtF,KAAK,cAAc,GAAG,CACpB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,MAAM,EAC5B,gBAAgB,CAAC,EAAE,MAAM,EACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,MAAM,CAAC,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,eAAe,CAAC,EAAE,OAAO,EACzB,aAAa,CAAC,EAAE,MAAM,KACnB,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,UAAU,qBAAqB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,uBAAuB,CAAC;IAC/C,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,IAAI,EACJ,SAAS,EACT,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,MAAM,EACN,WAAW,GACZ,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4D1C"}

package/dist/platform/observation/engine/observe-llm-stage.js

@@ -0,0 +1,79 @@
+import { createObservationEntry } from "../observation-helpers.js";
+import { ObservationPersistenceError } from "../observation-llm.js";
+export async function runLlmObservationStage({ goalId, goal, dimension, method, workspacePath, dataSourceAvailable, fetchWorkspaceContext, observeWithLLM, applyObservation, logger, hookManager, }) {
+    const workspaceContext = await fetchWorkspaceContext(goalId, dimension.name);
+    try {
+        await observeWithLLM(goalId, dimension.name, goal.description, dimension.label ?? dimension.name, JSON.stringify(dimension.threshold), workspaceContext, getPreviousScore(dimension), undefined, typeof dimension.current_value === "number" ? dimension.current_value : null, dataSourceAvailable, workspacePath);
+        void hookManager?.emit("PostObserve", {
+            goal_id: goalId,
+            dimension: dimension.name,
+            data: { value: null, confidence: null },
+        });
+        return true;
+    }
+    catch (err) {
+        logger?.warn(`[ObservationEngine] LLM observation failed for dimension "${dimension.name}": ${err instanceof Error ? err.message : String(err)}. Falling back to self_report.`);
+        if (err instanceof ObservationPersistenceError) {
+            const recoveredValue = err.entry.extracted_value;
+            logger?.warn(`[ObservationEngine] Recovering LLM-observed value=${recoveredValue} for dimension "${dimension.name}" via self_report fallback.`);
+            const recoveryEntry = createObservationEntry({
+                goalId,
+                dimensionName: dimension.name,
+                layer: "self_report",
+                method,
+                trigger: "periodic",
+                rawResult: recoveredValue,
+                extractedValue: typeof recoveredValue === "number" ||
+                    typeof recoveredValue === "string" ||
+                    typeof recoveredValue === "boolean" ||
+                    recoveredValue === null
+                    ? recoveredValue
+                    : null,
+                confidence: err.entry.confidence,
+            });
+            await applyObservation(goalId, recoveryEntry);
+            void hookManager?.emit("PostObserve", {
+                goal_id: goalId,
+                dimension: dimension.name,
+                data: { value: recoveryEntry.extracted_value, confidence: recoveryEntry.confidence },
+            });
+            return true;
+        }
+    }
+    return false;
+}
+function getPreviousScore(dimension) {
+    if (!Array.isArray(dimension.history) || dimension.history.length === 0) {
+        return null;
+    }
+    const lastObsEntry = dimension.history[dimension.history.length - 1];
+    if (!lastObsEntry || typeof lastObsEntry.value !== "number") {
+        return null;
+    }
+    const rawVal = lastObsEntry.value;
+    try {
+        const threshold = JSON.parse(JSON.stringify(dimension.threshold));
+        if (threshold.type === "min" &&
+            typeof threshold.value === "number" &&
+            threshold.value > 1) {
+            return Math.min(1, Math.max(0, rawVal / threshold.value));
+        }
+        if (threshold.type === "max" &&
+            typeof threshold.value === "number" &&
+            threshold.value > 1) {
+            return Math.min(1, Math.max(0, 2 - rawVal / threshold.value));
+        }
+        if (threshold.type === "range" &&
+            typeof threshold.low === "number" &&
+            typeof threshold.high === "number" &&
+            threshold.high > threshold.low) {
+            const span = threshold.high - threshold.low;
+            return Math.min(1, Math.max(0, (rawVal - threshold.low) / span));
+        }
+    }
+    catch {
+        return Math.min(1, Math.max(0, rawVal));
+    }
+    return Math.min(1, Math.max(0, rawVal));
+}
+//# sourceMappingURL=observe-llm-stage.js.map

package/dist/platform/observation/engine/observe-llm-stage.js.map

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

package/dist/platform/observation/engine/observe-precheck.d.ts

@@ -0,0 +1,21 @@
+import type { ObservationLogEntry } from "../../../base/types/state.js";
+import type { ObservationMethod } from "../../../base/types/core.js";
+import type { Dimension } from "../../../orchestrator/goal/types/goal.js";
+import type { IDimensionPreChecker } from "../dimension-pre-checker.js";
+import type { HookManager } from "../../../runtime/hook-manager.js";
+import type { Logger } from "../../../runtime/logger.js";
+type ApplyObservation = (goalId: string, entry: ObservationLogEntry) => Promise<void>;
+interface ObservePreCheckParams {
+    goalId: string;
+    dimension: Dimension;
+    method: ObservationMethod;
+    workspacePath?: string;
+    enabled: boolean;
+    preChecker?: IDimensionPreChecker;
+    applyObservation: ApplyObservation;
+    logger?: Logger;
+    hookManager?: HookManager;
+}
+export declare function runPreCheckStage({ goalId, dimension, method, workspacePath, enabled, preChecker, applyObservation, logger, hookManager, }: ObservePreCheckParams): Promise<boolean>;
+export {};
+//# sourceMappingURL=observe-precheck.d.ts.map

package/dist/platform/observation/engine/observe-precheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-precheck.d.ts","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-precheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF,UAAU,qBAAqB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,gBAAgB,CAAC,EACrC,MAAM,EACN,SAAS,EACT,MAAM,EACN,aAAa,EACb,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,WAAW,GACZ,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqD1C"}

package/dist/platform/observation/engine/observe-precheck.js

@@ -0,0 +1,51 @@
+import { createObservationEntry } from "../observation-helpers.js";
+export async function runPreCheckStage({ goalId, dimension, method, workspacePath, enabled, preChecker, applyObservation, logger, hookManager, }) {
+    if (!preChecker || !enabled)
+        return false;
+    const lastObs = Array.isArray(dimension.history) && dimension.history.length > 0
+        ? (() => {
+            const historyEntry = dimension.history[dimension.history.length - 1];
+            return {
+                observation_id: historyEntry.source_observation_id,
+                goal_id: goalId,
+                dimension_name: dimension.name,
+                layer: (dimension.last_observed_layer ?? "self_report"),
+                method,
+                trigger: "periodic",
+                raw_result: historyEntry.value,
+                extracted_value: historyEntry.value,
+                confidence: historyEntry.confidence,
+                timestamp: historyEntry.timestamp,
+                notes: null,
+            };
+        })()
+        : null;
+    try {
+        const preCheck = await preChecker.check(dimension, lastObs, { workspace_path: workspacePath });
+        if (!preCheck.changed && lastObs !== null) {
+            const cachedEntry = createObservationEntry({
+                goalId,
+                dimensionName: dimension.name,
+                layer: lastObs.layer ?? "self_report",
+                method,
+                trigger: "periodic",
+                rawResult: `cached: ${String(lastObs.extracted_value)}`,
+                extractedValue: lastObs.extracted_value,
+                confidence: Math.max(0.10, lastObs.confidence * 0.95),
+            });
+            await applyObservation(goalId, cachedEntry);
+            logger?.debug(`[ObservationEngine] Pre-check: skipping LLM for dimension "${dimension.name}" (no change detected, confidence decayed to ${cachedEntry.confidence.toFixed(3)})`);
+            void hookManager?.emit("PostObserve", {
+                goal_id: goalId,
+                dimension: dimension.name,
+                data: { value: cachedEntry.extracted_value, confidence: cachedEntry.confidence },
+            });
+            return true;
+        }
+    }
+    catch (err) {
+        logger?.warn(`[ObservationEngine] Pre-check failed for dimension "${dimension.name}": ${err instanceof Error ? err.message : String(err)}. Proceeding with normal observation.`);
+    }
+    return false;
+}
+//# sourceMappingURL=observe-precheck.js.map

package/dist/platform/observation/engine/observe-precheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-precheck.js","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-precheck.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAgBnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,MAAM,EACN,SAAS,EACT,MAAM,EACN,aAAa,EACb,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,WAAW,GACW;IACtB,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC9E,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;YACtE,OAAO;gBACL,cAAc,EAAE,YAAY,CAAC,qBAAqB;gBAClD,OAAO,EAAE,MAAM;gBACf,cAAc,EAAE,SAAS,CAAC,IAAI;gBAC9B,KAAK,EAAE,CAAC,SAAS,CAAC,mBAAmB,IAAI,aAAa,CAAqB;gBAC3E,MAAM;gBACN,OAAO,EAAE,UAAmB;gBAC5B,UAAU,EAAE,YAAY,CAAC,KAAK;gBAC9B,eAAe,EAAE,YAAY,CAAC,KAAyC;gBACvE,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,SAAS,EAAE,YAAY,CAAC,SAAS;gBACjC,KAAK,EAAE,IAAI;aACkB,CAAC;QAClC,CAAC,CAAC,EAAE;QACN,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;QAC/F,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,sBAAsB,CAAC;gBACzC,MAAM;gBACN,aAAa,EAAE,SAAS,CAAC,IAAI;gBAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa;gBACrC,MAAM;gBACN,OAAO,EAAE,UAAU;gBACnB,SAAS,EAAE,WAAW,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;gBACvD,cAAc,EAAE,OAAO,CAAC,eAAe;gBACvC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;aACtD,CAAC,CAAC;YACH,MAAM,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC5C,MAAM,EAAE,KAAK,CACX,8DAA8D,SAAS,CAAC,IAAI,gDAAgD,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACjK,CAAC;YACF,KAAK,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE;gBACpC,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,SAAS,CAAC,IAAI;gBACzB,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,eAAe,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE;aACjF,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,CACV,uDAAuD,SAAS,CAAC,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,uCAAuC,CACnK,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/platform/observation/engine/observe-self-report.d.ts

@@ -0,0 +1,18 @@
+import type { ObservationLogEntry } from "../../../base/types/state.js";
+import type { ObservationMethod } from "../../../base/types/core.js";
+import type { Dimension } from "../../../orchestrator/goal/types/goal.js";
+import type { HookManager } from "../../../runtime/hook-manager.js";
+import type { Logger } from "../../../runtime/logger.js";
+type ApplyObservation = (goalId: string, entry: ObservationLogEntry) => Promise<void>;
+interface ObserveSelfReportParams {
+    goalId: string;
+    dimension: Dimension;
+    method: ObservationMethod;
+    dataSourceAvailable: boolean;
+    applyObservation: ApplyObservation;
+    logger?: Logger;
+    hookManager?: HookManager;
+}
+export declare function runSelfReportStage({ goalId, dimension, method, dataSourceAvailable, applyObservation, logger, hookManager, }: ObserveSelfReportParams): Promise<void>;
+export {};
+//# sourceMappingURL=observe-self-report.d.ts.map

package/dist/platform/observation/engine/observe-self-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-self-report.d.ts","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-self-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF,UAAU,uBAAuB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EACN,SAAS,EACT,MAAM,EACN,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,EACN,WAAW,GACZ,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBzC"}

package/dist/platform/observation/engine/observe-self-report.js

@@ -0,0 +1,26 @@
+import { createObservationEntry } from "../observation-helpers.js";
+export async function runSelfReportStage({ goalId, dimension, method, dataSourceAvailable, applyObservation, logger, hookManager, }) {
+    const entry = createObservationEntry({
+        goalId,
+        dimensionName: dimension.name,
+        layer: "self_report",
+        method,
+        trigger: "periodic",
+        rawResult: dimension.current_value,
+        extractedValue: typeof dimension.current_value === "number" ||
+            typeof dimension.current_value === "string" ||
+            typeof dimension.current_value === "boolean" ||
+            dimension.current_value === null
+            ? dimension.current_value
+            : null,
+        confidence: dataSourceAvailable ? dimension.confidence : Math.min(dimension.confidence, 0.30),
+    });
+    await applyObservation(goalId, entry);
+    logger?.info(`[observe] ${dimension.name}=${entry.extracted_value} (confidence=${entry.confidence})`);
+    void hookManager?.emit("PostObserve", {
+        goal_id: goalId,
+        dimension: dimension.name,
+        data: { value: entry.extracted_value, confidence: entry.confidence },
+    });
+}
+//# sourceMappingURL=observe-self-report.js.map

package/dist/platform/observation/engine/observe-self-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-self-report.js","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-self-report.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAcnE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,MAAM,EACN,SAAS,EACT,MAAM,EACN,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,EACN,WAAW,GACa;IACxB,MAAM,KAAK,GAAG,sBAAsB,CAAC;QACnC,MAAM;QACN,aAAa,EAAE,SAAS,CAAC,IAAI;QAC7B,KAAK,EAAE,aAAa;QACpB,MAAM;QACN,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,SAAS,CAAC,aAAa;QAClC,cAAc,EACZ,OAAO,SAAS,CAAC,aAAa,KAAK,QAAQ;YAC3C,OAAO,SAAS,CAAC,aAAa,KAAK,QAAQ;YAC3C,OAAO,SAAS,CAAC,aAAa,KAAK,SAAS;YAC5C,SAAS,CAAC,aAAa,KAAK,IAAI;YAC9B,CAAC,CAAE,SAAS,CAAC,aAAkD;YAC/D,CAAC,CAAC,IAAI;QACV,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC;KAC9F,CAAC,CAAC;IAEH,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,EAAE,IAAI,CAAC,aAAa,SAAS,CAAC,IAAI,IAAI,KAAK,CAAC,eAAe,gBAAgB,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;IACtG,KAAK,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE;QACpC,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,SAAS,CAAC,IAAI;QACzB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,eAAe,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;KACrE,CAAC,CAAC;AACL,CAAC"}

package/dist/platform/observation/engine/observe-tool-stage.d.ts

@@ -0,0 +1,21 @@
+import type { ObservationLogEntry } from "../../../base/types/state.js";
+import type { ObservationMethod } from "../../../base/types/core.js";
+import type { Dimension } from "../../../orchestrator/goal/types/goal.js";
+import type { HookManager } from "../../../runtime/hook-manager.js";
+import type { Logger } from "../../../runtime/logger.js";
+import type { ToolObservationResult } from "../observation-tools.js";
+import type { ToolCallContext } from "../../../tools/types.js";
+type ApplyObservation = (goalId: string, entry: ObservationLogEntry) => Promise<void>;
+type ObserveWithTools = (dimension: Dimension, context: ToolCallContext) => Promise<ToolObservationResult | null>;
+interface ObserveToolStageParams {
+    goalId: string;
+    dimension: Dimension;
+    method: ObservationMethod;
+    applyObservation: ApplyObservation;
+    observeWithTools: ObserveWithTools;
+    logger?: Logger;
+    hookManager?: HookManager;
+}
+export declare function runToolObservationStage({ goalId, dimension, method, applyObservation, observeWithTools, logger, hookManager, }: ObserveToolStageParams): Promise<boolean>;
+export {};
+//# sourceMappingURL=observe-tool-stage.d.ts.map

package/dist/platform/observation/engine/observe-tool-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-tool-stage.d.ts","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-tool-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACtF,KAAK,gBAAgB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;AAElH,UAAU,sBAAsB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAWD,wBAAsB,uBAAuB,CAAC,EAC5C,MAAM,EACN,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,EACN,WAAW,GACZ,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwC3C"}

package/dist/platform/observation/engine/observe-tool-stage.js

@@ -0,0 +1,49 @@
+import { createObservationEntry } from "../observation-helpers.js";
+const TOOL_OBSERVATION_TYPES = new Set([
+    "file_check",
+    "mechanical",
+    "api_query",
+    "git_diff",
+    "grep_check",
+    "test_run",
+]);
+export async function runToolObservationStage({ goalId, dimension, method, applyObservation, observeWithTools, logger, hookManager, }) {
+    const methodType = dimension.observation_method?.type;
+    if (!methodType || !TOOL_OBSERVATION_TYPES.has(methodType))
+        return false;
+    try {
+        const toolContext = {
+            cwd: process.cwd(),
+            goalId,
+            trustBalance: 0,
+            preApproved: false,
+            approvalFn: async () => false,
+        };
+        const toolResult = await observeWithTools(dimension, toolContext);
+        if (toolResult !== null && toolResult.parsedValue !== null && toolResult.parsedValue !== undefined) {
+            const toolEntry = createObservationEntry({
+                goalId,
+                dimensionName: dimension.name,
+                layer: "mechanical",
+                method: { ...method, source: toolResult.toolName },
+                trigger: "periodic",
+                rawResult: toolResult.rawData,
+                extractedValue: toolResult.parsedValue,
+                confidence: toolResult.confidence,
+            });
+            await applyObservation(goalId, toolEntry);
+            logger?.debug(`[ObservationEngine] Tool observation succeeded for ${dimension.name}: confidence=${toolResult.confidence}`);
+            void hookManager?.emit("PostObserve", {
+                goal_id: goalId,
+                dimension: dimension.name,
+                data: { value: toolEntry.extracted_value, confidence: toolEntry.confidence },
+            });
+            return true;
+        }
+    }
+    catch (err) {
+        logger?.warn(`[ObservationEngine] Tool observation failed for ${dimension.name}, falling through: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return false;
+}
+//# sourceMappingURL=observe-tool-stage.js.map

package/dist/platform/observation/engine/observe-tool-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-tool-stage.js","sourceRoot":"","sources":["../../../../src/platform/observation/engine/observe-tool-stage.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAgBnE,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,UAAU;IACV,YAAY;IACZ,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,EAC5C,MAAM,EACN,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,EACN,WAAW,GACY;IACvB,MAAM,UAAU,GAAG,SAAS,CAAC,kBAAkB,EAAE,IAAI,CAAC;IACtD,IAAI,CAAC,UAAU,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,WAAW,GAAoB;YACnC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,MAAM;YACN,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;SAC9B,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClE,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,WAAW,KAAK,IAAI,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnG,MAAM,SAAS,GAAG,sBAAsB,CAAC;gBACvC,MAAM;gBACN,aAAa,EAAE,SAAS,CAAC,IAAI;gBAC7B,KAAK,EAAE,YAAY;gBACnB,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE;gBAClD,OAAO,EAAE,UAAU;gBACnB,SAAS,EAAE,UAAU,CAAC,OAAO;gBAC7B,cAAc,EAAE,UAAU,CAAC,WAAW;gBACtC,UAAU,EAAE,UAAU,CAAC,UAAU;aAClC,CAAC,CAAC;YACH,MAAM,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC1C,MAAM,EAAE,KAAK,CAAC,sDAAsD,SAAS,CAAC,IAAI,gBAAgB,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3H,KAAK,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE;gBACpC,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,SAAS,CAAC,IAAI;gBACzB,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,eAAe,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE;aAC7E,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,CACV,mDAAmD,SAAS,CAAC,IAAI,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC1I,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { ObservationLogEntry } from "../../base/types/state.js";
+import type { StateManager } from "../../base/state/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/platform/observation/observation-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-apply.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/observation-apply.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,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,CAuHf;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"}