pulseed 0.4.3 → 0.4.6

package/dist/observation/observation-helpers.js

@@ -1,173 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { z } from "zod";
-import { ObservationLogEntrySchema, ObservationLogSchema } from "../types/state.js";
-import { KnowledgeGapSignalSchema } from "../types/knowledge.js";
-export const LAYER_CONFIG = {
-    mechanical: {
-        ceiling: 1.0,
-        tier: "mechanical",
-        range: [0.85, 1.0],
-    },
-    independent_review: {
-        ceiling: 0.90,
-        tier: "independent_review",
-        range: [0.50, 0.84],
-    },
-    self_report: {
-        ceiling: 0.70,
-        tier: "self_report",
-        range: [0.10, 0.49],
-    },
-};
-// ─── Layer Priority ───
-export const LAYER_PRIORITY = {
-    mechanical: 3,
-    independent_review: 2,
-    self_report: 1,
-};
-// Zod schema for LLM observation response
-export const LLMObservationResponseSchema = z.object({
-    score: z.number().min(0).max(1),
-    reason: z.string(),
-});
-// ─── Pure Helper Functions ───
-/**
- * Apply progress ceiling based on observation layer.
- * Returns min(progress, ceiling).
- */
-export function applyProgressCeiling(progress, layer) {
-    const config = LAYER_CONFIG[layer];
-    return Math.min(progress, config.ceiling);
-}
-/**
- * Return the ConfidenceTier and valid confidence range for a given layer.
- */
-export function getConfidenceTier(layer) {
-    const config = LAYER_CONFIG[layer];
-    return { tier: config.tier, range: config.range };
-}
-/**
- * Construct a new ObservationLogEntry.
- * Confidence is clamped to the layer's valid range.
- */
-export function createObservationEntry(params) {
-    const config = LAYER_CONFIG[params.layer];
-    const [minConf, maxConf] = config.range;
-    const clampedConfidence = Math.min(maxConf, Math.max(minConf, params.confidence));
-    const entry = ObservationLogEntrySchema.parse({
-        observation_id: randomUUID(),
-        timestamp: new Date().toISOString(),
-        trigger: params.trigger,
-        goal_id: params.goalId,
-        dimension_name: params.dimensionName,
-        layer: params.layer,
-        method: params.method,
-        raw_result: params.rawResult,
-        extracted_value: params.extractedValue,
-        confidence: clampedConfidence,
-        notes: params.notes ?? null,
-    });
-    return entry;
-}
-/**
- * Returns true when effective progress meets the threshold but confidence
- * is below 0.85, meaning a mechanical verification task should be generated.
- */
-export function needsVerificationTask(effectiveProgress, confidence, threshold) {
-    return effectiveProgress >= threshold && confidence < 0.85;
-}
-/**
- * Resolve contradictions among multiple observation entries.
- *
- * Resolution rules:
- *   1. Higher-priority layer wins (mechanical > independent_review > self_report).
- *   2. Within the same layer, take the pessimistic (lower) numeric value.
- *   3. For non-numeric values, take the first entry in the winning layer.
- *
- * Returns the single "winning" entry.
- * Throws if entries array is empty.
- */
-export function resolveContradiction(entries) {
-    if (entries.length === 0) {
-        throw new Error("resolveContradiction: entries array must not be empty");
-    }
-    if (entries.length === 1) {
-        return entries[0];
-    }
-    // Find highest priority layer present
-    let maxPriority = -1;
-    for (const entry of entries) {
-        const priority = LAYER_PRIORITY[entry.layer];
-        if (priority > maxPriority) {
-            maxPriority = priority;
-        }
-    }
-    // Collect all entries at the winning layer
-    const winningLayer = entries.filter((e) => LAYER_PRIORITY[e.layer] === maxPriority);
-    if (winningLayer.length === 1) {
-        return winningLayer[0];
-    }
-    // Within same layer: pessimistic (lowest numeric value)
-    let best = winningLayer[0];
-    for (let i = 1; i < winningLayer.length; i++) {
-        const candidate = winningLayer[i];
-        const bestVal = best.extracted_value;
-        const candidateVal = candidate.extracted_value;
-        if (typeof bestVal === "number" && typeof candidateVal === "number") {
-            if (candidateVal < bestVal) {
-                best = candidate;
-            }
-        }
-    }
-    return best;
-}
-/**
- * Strip trailing _2, _3, ... _N suffixes that LLMs sometimes append to
- * deduplicate JSON keys.  Only applied to names from external (LLM) input.
- *
- * Examples:
- *   "todo_count_2"  → "todo_count"
- *   "quality_3"     → "quality"
- *   "step_count"    → "step_count"  (trailing token is not a digit-only suffix)
- *   "coverage"      → "coverage"
- */
-export function normalizeDimensionName(name, logger) {
-    const stripped = name.replace(/_\d+$/, "");
-    if (stripped !== name) {
-        logger?.warn(`[ObservationEngine] normalizeDimensionName: stripped "${name}" → "${stripped}"`);
-    }
-    return stripped;
-}
-/**
- * Detect whether a set of observation entries indicates a knowledge gap.
- *
- * Rule: if ALL entries have confidence < 0.3, interpretation is too
- * uncertain — emit an `interpretation_difficulty` signal.
- *
- * Returns null when confidence is sufficient (no gap detected).
- */
-export function detectKnowledgeGap(entries, dimensionName) {
-    if (entries.length === 0)
-        return null;
-    const allLowConfidence = entries.every((e) => e.confidence < 0.3);
-    if (!allLowConfidence)
-        return null;
-    return KnowledgeGapSignalSchema.parse({
-        signal_type: "interpretation_difficulty",
-        missing_knowledge: "Observation confidence is too low to interpret results reliably",
-        source_step: "gap_recognition",
-        related_dimension: dimensionName ?? null,
-    });
-}
-/**
- * Load the observation log for a goal, returning an empty log if none exists.
- * Pure function — requires stateManager passed in.
- */
-export async function loadOrEmptyObservationLog(stateManager, goalId) {
-    const existing = await stateManager.loadObservationLog(goalId);
-    if (existing !== null) {
-        return existing;
-    }
-    return ObservationLogSchema.parse({ goal_id: goalId, entries: [] });
-}
-//# sourceMappingURL=observation-helpers.js.map

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

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

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

@@ -1,63 +0,0 @@
-import type { ObservationLogEntry } from "../types/state.js";
-import type { ILLMClient } from "../base/llm/llm-client.js";
-import type { ObservationEngineOptions } from "./observation-helpers.js";
-import type { Logger } from "../runtime/logger.js";
-import type { IPromptGateway } from "../prompt/gateway.js";
-/**
- * Fetch a concise workspace context via git diff when no contextProvider is available.
- * Returns an empty string if git commands fail (e.g., not a git repo).
- *
- * Uses execFile (not exec/execSync) to avoid shell-injection risks and event-loop blocking.
- *
- * @param options   Engine options (may contain gitContextFetcher override).
- * @param maxChars  Maximum characters to return (default: 3000).
- * @param cwd       Working directory for git commands (defaults to process.cwd()).
- */
-export declare function fetchGitDiffContext(options: ObservationEngineOptions, maxChars?: number, cwd?: string): Promise<string>;
-/**
- * Read up to 10 files from workspacePath (top-level only) and return their
- * contents formatted as === File: <name> ===\n<content>\n blocks.
- * Filters to common code/config extensions. Caps total output at maxChars.
- */
-export declare function readWorkspaceFiles(workspacePath: string, maxChars?: number): Promise<string>;
-/**
- * Observe a goal dimension using the LLM client.
- *
- * The LLM is asked to score the dimension from 0.0 to 1.0.
- * The score is used as extractedValue, and confidence is fixed at 0.70
- * (middle of the independent_review range [0.50, 0.84]).
- *
- * If workspaceContext is not provided, a git diff fallback is attempted
- * so the LLM has actual evidence to evaluate. If that also fails,
- * the prompt includes an explicit warning and the LLM must score 0.0.
- *
- * @param goalId             The goal being observed.
- * @param dimensionName      The dimension name (snake_case).
- * @param goalDescription    Human-readable goal description.
- * @param dimensionLabel     Human-readable dimension label.
- * @param thresholdDescription  JSON-stringified threshold for context.
- * @param llmClient          The LLM client to use.
- * @param options            Engine options (for git diff fallback).
- * @param applyObservation   Callback to persist the entry (skipped if dryRun).
- * @param workspaceContext   Optional pre-fetched workspace context.
- * @param previousScore      Previous observed score for trend context.
- * @param dryRun             If true, do not write to state.
- * @param logger             Optional logger.
- * @param dimensionHistory   Optional history of prior observations for this dimension.
- * @param workspacePath      Optional workspace directory for git diff fallback.
- */
-export declare function observeWithLLM(goalId: string, dimensionName: string, goalDescription: string, dimensionLabel: string, thresholdDescription: string, llmClient: ILLMClient, options: ObservationEngineOptions, applyObservation: (goalId: string, entry: ObservationLogEntry) => void, workspaceContext?: string, previousScore?: number | null, dryRun?: boolean, logger?: Logger, dimensionHistory?: Array<{
-    value: number;
-    timestamp?: string;
-    date?: string;
-}>, gateway?: IPromptGateway, currentValue?: number | null, sourceAvailable?: boolean, workspacePath?: string): Promise<ObservationLogEntry>;
-/**
- * Thrown when the LLM observation succeeded but persistence (applyObservation) failed.
- * Carries the successfully-observed entry so callers can recover the value.
- */
-export declare class ObservationPersistenceError extends Error {
-    readonly entry: ObservationLogEntry;
-    readonly cause: Error;
-    constructor(message: string, entry: ObservationLogEntry, cause: Error);
-}
-//# sourceMappingURL=observation-llm.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"observation-llm.d.ts","sourceRoot":"","sources":["../../src/observation/observation-llm.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,wBAAwB,EAAE,QAAQ,SAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC3H;AAMD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAiChG;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,MAAM,EAC5B,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,IAAI,EACtE,gBAAgB,CAAC,EAAE,MAAM,EACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,MAAM,CAAC,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9E,OAAO,CAAC,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,eAAe,CAAC,EAAE,OAAO,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAqT9B;AAED;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;aAGlC,KAAK,EAAE,mBAAmB;aAC1B,KAAK,EAAE,KAAK;gBAF5B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,KAAK;CAK/B"}

package/dist/observation/observation-llm.js

@@ -1,407 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { execFile as execFileCb } from "child_process";
-import { promisify } from "util";
-import * as fsPromises from "node:fs/promises";
-import * as nodePath from "node:path";
-import { ObservationLogEntrySchema } from "../types/state.js";
-const execFile = promisify(execFileCb);
-import { LLMObservationResponseSchema } from "./observation-helpers.js";
-import { wrapXmlTag, formatObservationHistory } from "../prompt/formatters.js";
-import { OBSERVATION_SYSTEM_PROMPT } from "../prompt/purposes/observation.js";
-/**
- * Fetch a concise workspace context via git diff when no contextProvider is available.
- * Returns an empty string if git commands fail (e.g., not a git repo).
- *
- * Uses execFile (not exec/execSync) to avoid shell-injection risks and event-loop blocking.
- *
- * @param options   Engine options (may contain gitContextFetcher override).
- * @param maxChars  Maximum characters to return (default: 3000).
- * @param cwd       Working directory for git commands (defaults to process.cwd()).
- */
-export async function fetchGitDiffContext(options, maxChars = 3000, cwd) {
-    // Allow test injection via options
-    if (options.gitContextFetcher) {
-        return options.gitContextFetcher(maxChars);
-    }
-    const execOptions = { timeout: 10000, encoding: "utf8", ...(cwd ? { cwd } : {}) };
-    const parts = [];
-    try {
-        const { stdout: stat } = await execFile("git", ["diff", "--stat"], execOptions);
-        if (stat.trim()) {
-            parts.push("[git diff --stat]");
-            parts.push(stat.trim());
-        }
-    }
-    catch {
-        // not a git repo or git unavailable
-    }
-    try {
-        const { stdout: diff } = await execFile("git", ["diff"], execOptions);
-        if (diff.trim()) {
-            parts.push("[git diff]");
-            // Reserve space: subtract what we've already accumulated
-            const alreadyUsed = parts.join("\n\n").length;
-            const remaining = Math.max(0, maxChars - alreadyUsed - 20); // 20 for separator
-            const truncated = diff.length > remaining ? diff.slice(0, remaining) + "\n...(truncated)" : diff;
-            parts.push(truncated.trim());
-        }
-    }
-    catch {
-        // ignore
-    }
-    return parts.join("\n\n");
-}
-const READABLE_EXTENSIONS = new Set([
-    ".ts", ".js", ".tsx", ".jsx", ".py", ".json", ".yaml", ".yml", ".toml", ".md", ".txt",
-]);
-/**
- * Read up to 10 files from workspacePath (top-level only) and return their
- * contents formatted as === File: <name> ===\n<content>\n blocks.
- * Filters to common code/config extensions. Caps total output at maxChars.
- */
-export async function readWorkspaceFiles(workspacePath, maxChars = 3000) {
-    let entries;
-    try {
-        entries = await fsPromises.readdir(workspacePath, { withFileTypes: true });
-    }
-    catch {
-        return "";
-    }
-    const files = entries
-        .filter((e) => e.isFile() && READABLE_EXTENSIONS.has(nodePath.extname(e.name).toLowerCase()))
-        .map((e) => e.name);
-    const parts = [];
-    let totalChars = 0;
-    for (const file of files.slice(0, 10)) {
-        if (totalChars >= maxChars)
-            break;
-        const filePath = nodePath.join(workspacePath, file);
-        let content;
-        try {
-            content = await fsPromises.readFile(filePath, "utf8");
-        }
-        catch {
-            continue;
-        }
-        const header = `=== File: ${file} ===\n`;
-        const remaining = maxChars - totalChars - header.length - 1; // -1 for trailing \n
-        if (remaining <= 0)
-            break;
-        const truncated = content.length > remaining ? content.slice(0, remaining) + "\n...(truncated)" : content;
-        const block = `${header}${truncated}\n`;
-        parts.push(block);
-        totalChars += block.length;
-    }
-    return parts.join("\n");
-}
-/**
- * Infer the direction of change from a history of score values.
- */
-function inferDirection(history) {
-    if (history.length < 2)
-        return "insufficient_data";
-    const last = history[history.length - 1].value;
-    const prev = history[history.length - 2].value;
-    if (last > prev)
-        return "improving";
-    if (last < prev)
-        return "declining";
-    return "stable";
-}
-/**
- * Observe a goal dimension using the LLM client.
- *
- * The LLM is asked to score the dimension from 0.0 to 1.0.
- * The score is used as extractedValue, and confidence is fixed at 0.70
- * (middle of the independent_review range [0.50, 0.84]).
- *
- * If workspaceContext is not provided, a git diff fallback is attempted
- * so the LLM has actual evidence to evaluate. If that also fails,
- * the prompt includes an explicit warning and the LLM must score 0.0.
- *
- * @param goalId             The goal being observed.
- * @param dimensionName      The dimension name (snake_case).
- * @param goalDescription    Human-readable goal description.
- * @param dimensionLabel     Human-readable dimension label.
- * @param thresholdDescription  JSON-stringified threshold for context.
- * @param llmClient          The LLM client to use.
- * @param options            Engine options (for git diff fallback).
- * @param applyObservation   Callback to persist the entry (skipped if dryRun).
- * @param workspaceContext   Optional pre-fetched workspace context.
- * @param previousScore      Previous observed score for trend context.
- * @param dryRun             If true, do not write to state.
- * @param logger             Optional logger.
- * @param dimensionHistory   Optional history of prior observations for this dimension.
- * @param workspacePath      Optional workspace directory for git diff fallback.
- */
-export async function observeWithLLM(goalId, dimensionName, goalDescription, dimensionLabel, thresholdDescription, llmClient, options, applyObservation, workspaceContext, previousScore, dryRun, logger, dimensionHistory, gateway, currentValue, sourceAvailable, workspacePath) {
-    logger?.info(`[ObservationEngine] LLM observation for dimension "${dimensionLabel}" (goal: ${goalId})`);
-    // Resolve workspace context: use provided context, fall back to git diff, or warn.
-    let resolvedContext = workspaceContext;
-    if (!resolvedContext || resolvedContext.trim().length === 0) {
-        const gitCtx = await fetchGitDiffContext(options, 3000, workspacePath);
-        if (gitCtx.trim().length > 0) {
-            resolvedContext = gitCtx;
-            logger?.info(`[ObservationEngine] No contextProvider output — using git diff fallback for "${dimensionLabel}"`);
-        }
-    }
-    // Second fallback: if both contextProvider and git diff returned empty,
-    // read workspace files directly so the LLM has actual evidence to evaluate.
-    if ((!resolvedContext || resolvedContext.trim().length === 0) && workspacePath) {
-        const filesCtx = await readWorkspaceFiles(workspacePath, 3000);
-        if (filesCtx.trim().length > 0) {
-            resolvedContext = filesCtx;
-            logger?.info(`[ObservationEngine] No git diff context — using workspace file fallback for "${dimensionLabel}"`);
-        }
-    }
-    // Truncate to 4000 chars max to avoid token waste
-    const MAX_CONTEXT_CHARS = 16000;
-    if (resolvedContext && resolvedContext.length > MAX_CONTEXT_CHARS) {
-        resolvedContext = resolvedContext.slice(0, MAX_CONTEXT_CHARS) + "\n...(truncated)";
-    }
-    const hasContext = !!resolvedContext && resolvedContext.trim().length > 0;
-    // When no context is available and the dimension already has a valid
-    // current_value, skip the LLM observation rather than overwriting with a
-    // worst-case guess.  For max thresholds, score=0.0 produces
-    // extractedValue = 2×threshold, which is maximally pessimistic and corrupts
-    // mechanically-observed progress (bug #282 Issue B).
-    // Exception: when previousScore is provided, the dimension has real observation
-    // history — call the LLM so jump-suppression (§3.3) can preserve the prior
-    // score and include it in the prompt for trend context.
-    if (!hasContext && currentValue !== null && currentValue !== undefined && !dryRun && (previousScore === null || previousScore === undefined)) {
-        logger?.info(`[ObservationEngine] Skipping LLM observation for "${dimensionLabel}": no context and existing value=${currentValue} is preserved (no_context_existing_value).`);
-        const skipEntry = ObservationLogEntrySchema.parse({
-            observation_id: randomUUID(),
-            timestamp: new Date().toISOString(),
-            trigger: "periodic",
-            goal_id: goalId,
-            dimension_name: dimensionName,
-            layer: sourceAvailable === false ? "self_report" : "independent_review",
-            method: {
-                type: "llm_review",
-                source: "llm",
-                schedule: null,
-                endpoint: null,
-                confidence_tier: sourceAvailable === false ? "self_report" : "independent_review",
-            },
-            raw_result: { score: null, reason: "no_context_existing_value" },
-            extracted_value: currentValue,
-            confidence: 0.1,
-            notes: "Skipped: no context available, existing value preserved.",
-        });
-        // RC-2: Apply the skip entry so state reflects the preserved value.
-        try {
-            await applyObservation(goalId, skipEntry);
-        }
-        catch (persistErr) {
-            throw new ObservationPersistenceError(`Failed to persist skip observation for dimension "${dimensionName}": ${persistErr instanceof Error ? persistErr.message : String(persistErr)}`, skipEntry, persistErr instanceof Error ? persistErr : new Error(String(persistErr)));
-        }
-        return skipEntry;
-    }
-    const previousScoreText = previousScore !== undefined && previousScore !== null
-        ? previousScore.toFixed(2)
-        : "none";
-    const contextContent = hasContext
-        ? resolvedContext
-        : "WARNING: No workspace content was provided. Score MUST be 0.0 per Rule 2.";
-    // Build optional observation history block
-    let historyBlock = "";
-    if (dimensionHistory && dimensionHistory.length > 0) {
-        const direction = inferDirection(dimensionHistory);
-        historyBlock = wrapXmlTag("observation_history", formatObservationHistory(dimensionHistory.map((h) => ({
-            timestamp: h.timestamp ?? h.date ?? "",
-            score: h.value,
-        })), direction));
-    }
-    const prompt = `Score a goal dimension 0.0 (not achieved) to 1.0 (fully achieved).\n\n` +
-        `CRITICAL RULES:\n` +
-        `1. Use ONLY the evidence below. Do not invent or assume.\n` +
-        `2. If no workspace content is provided, score MUST be 0.0.\n` +
-        `3. Return ONLY valid JSON: {"score": <0.0-1.0>, "reason": "<one sentence>"}\n\n` +
-        `Goal: ${goalDescription}\n` +
-        `Dimension: ${dimensionLabel}\n` +
-        `Target: ${thresholdDescription}\n` +
-        `Previous score: ${previousScoreText}\n\n` +
-        (historyBlock ? `${historyBlock}\n\n` : "") +
-        `FEW-SHOT CALIBRATION:\n` +
-        `- Context: grep shows 0 unfinished item matches → {"score": 1.0, "reason": "No unfinished items; target achieved"}\n` +
-        `- Context: grep shows 3 matches: src/foo.ts:42: unfinished item fix this → {"score": 0.0, "reason": "3 unfinished items remain"}\n\n` +
-        `WORKSPACE CONTENT:\n` +
-        `${contextContent}\n\n` +
-        `Score now based strictly on the above content.`;
-    let parsed;
-    if (gateway) {
-        try {
-            parsed = await gateway.execute({
-                purpose: "observation",
-                goalId,
-                dimensionName,
-                additionalContext: { observation_prompt: prompt },
-                responseSchema: LLMObservationResponseSchema,
-                maxTokens: 512,
-                temperature: 0,
-            });
-        }
-        catch (err) {
-            // Fallback to direct LLM call if gateway fails
-            logger?.warn(`[ObservationEngine] PromptGateway failed for "${dimensionLabel}", falling back to direct LLM: ${String(err)}`);
-            console.log(`  [LLM] Calling LLM for observation (fallback) "${dimensionLabel}"...`);
-            const response = await llmClient.sendMessage([{ role: "user", content: prompt }], { system: OBSERVATION_SYSTEM_PROMPT, max_tokens: 512, temperature: 0, model_tier: 'light' });
-            console.log(`  [LLM] Observation (fallback) complete for "${dimensionLabel}".`);
-            parsed = llmClient.parseJSON(response.content, LLMObservationResponseSchema);
-        }
-    }
-    else {
-        console.log(`  [LLM] Calling LLM for observation "${dimensionLabel}"...`);
-        const response = await llmClient.sendMessage([{ role: "user", content: prompt }], { system: OBSERVATION_SYSTEM_PROMPT, max_tokens: 512, temperature: 0, model_tier: 'light' });
-        console.log(`  [LLM] Observation complete for "${dimensionLabel}".`);
-        parsed = llmClient.parseJSON(response.content, LLMObservationResponseSchema);
-    }
-    // P0: Score-evidence consistency check (§4.3)
-    // If no evidence (no context, no git diff), LLM score > 0.0 is unreliable.
-    // Skip this check in dryRun (cross-validation) mode — the caller needs the
-    // raw LLM score to compare against the mechanical value.
-    // RC-1: When no context but a previousScore is known from observation history,
-    // preserve the previous score with degraded confidence rather than forcing 0.0.
-    // "No context" means "can't verify", not "definitely zero".
-    // Fix Root Cause A: When no context and no previousScore, keep the LLM score
-    // but cap confidence at self_report level (0.10) rather than zeroing the score.
-    // A non-zero LLM score with reasoning is more informative than a forced 0.0.
-    let score = parsed.score;
-    let scorePreservedFromPrevious = false;
-    if (!hasContext && score > 0.0 && !dryRun) {
-        if (typeof previousScore === "number" && Number.isFinite(previousScore)) {
-            score = previousScore;
-            scorePreservedFromPrevious = true;
-            logger?.warn(`score preserved from previous observation (no context): ${previousScore.toFixed(3)}`);
-        }
-        else {
-            // Keep LLM score but log a warning — confidence will be capped at self_report level
-            logger?.warn(`score kept from LLM (no evidence available, confidence capped at self_report): ${score}`);
-        }
-    }
-    // §3.3: Observation score jump suppression (±0.4/cycle)
-    // When no mechanical source is available and the LLM score jumps more than 0.4
-    // from the previous score, suppress the change and lower confidence.
-    // Exception: present/match threshold types have binary 0→1 transitions that are
-    // legitimate and must not be suppressed.
-    const MAX_SCORE_DELTA = 0.4;
-    let isBinaryThreshold = false;
-    try {
-        const th = JSON.parse(thresholdDescription);
-        isBinaryThreshold = th.type === "present" || th.type === "match";
-    }
-    catch (err) {
-        logger?.warn(`[ObservationEngine] Failed to parse thresholdDescription for binary check goal=${goalId} dimension=${dimensionName}: ${String(err)}`);
-    }
-    let resolvedLayer;
-    let resolvedConfidence;
-    // Fix Root Cause B: When sourceAvailable=false but context IS available,
-    // use independent_review tier (workspace context provides real evidence).
-    // self_report tier only applies when BOTH sourceAvailable=false AND no context.
-    if (sourceAvailable === false && !hasContext) {
-        resolvedLayer = "self_report";
-        resolvedConfidence = scorePreservedFromPrevious ? 0.30 : 0.10;
-    }
-    else if (sourceAvailable === false && hasContext) {
-        // No dataSource but workspace context provides real evidence → independent_review
-        resolvedLayer = "independent_review";
-        resolvedConfidence = 0.70;
-    }
-    else {
-        resolvedLayer = "independent_review";
-        resolvedConfidence = hasContext ? 0.70 : (scorePreservedFromPrevious ? 0.30 : 0.10);
-    }
-    if (!(isBinaryThreshold && hasContext) &&
-        typeof previousScore === "number" &&
-        previousScore !== null &&
-        Math.abs(score - previousScore) > MAX_SCORE_DELTA) {
-        const delta = Math.abs(score - previousScore);
-        logger?.warn(`WARN: observation score jump suppressed: prev=${previousScore.toFixed(3)}, proposed=${score.toFixed(3)}, delta=${delta.toFixed(3)}`);
-        score = previousScore;
-        resolvedConfidence = 0.50;
-    }
-    logger?.info(`[ObservationEngine] LLM observation result for "${dimensionLabel}": score=${score.toFixed(3)}`);
-    // Scale LLM 0-1 score to threshold's native scale for min/max types.
-    // LLM returns 0.0-1.0 (normalized), but gap-calculator expects the raw
-    // value in the threshold's scale (e.g., min:5 expects value >= 5).
-    let extractedValue = score;
-    try {
-        const threshold = JSON.parse(thresholdDescription);
-        if (threshold.type === "min" && typeof threshold.value === "number" && threshold.value > 1) {
-            extractedValue = score * threshold.value;
-            const clampMax = threshold.value * 2;
-            if (extractedValue > clampMax) {
-                logger?.warn(`WARN: extractedValue clamped for min threshold: raw=${extractedValue.toFixed(3)}, clampMax=${clampMax}, threshold=${threshold.value}`);
-                extractedValue = clampMax;
-            }
-            else if (extractedValue > threshold.value * 1.5) {
-                logger?.warn(`WARN: extractedValue suspiciously high for min threshold: value=${extractedValue.toFixed(3)}, threshold=${threshold.value}`);
-            }
-        }
-        else if (threshold.type === "max" && typeof threshold.value === "number" && threshold.value > 1) {
-            // Invert: score=1.0 means current is AT the max (gap=0); score=0.0 means far above max.
-            // formula: value = threshold * (2 - score)
-            // score=1.0 → threshold (exactly at max, gap=0)
-            // score=0.0 → 2*threshold (double the max, clearly not met)
-            extractedValue = threshold.value * (2 - score);
-            const clampMax = threshold.value * 2;
-            if (extractedValue > clampMax) {
-                logger?.warn(`WARN: extractedValue clamped for max threshold: raw=${extractedValue.toFixed(3)}, clampMax=${clampMax}, threshold=${threshold.value}`);
-                extractedValue = clampMax;
-            }
-            else if (extractedValue > threshold.value * 1.5) {
-                logger?.warn(`WARN: extractedValue suspiciously high for max threshold: value=${extractedValue.toFixed(3)}, threshold=${threshold.value}`);
-            }
-        }
-    }
-    catch (err) {
-        logger?.warn(`[ObservationEngine] Failed to parse thresholdDescription JSON goal=${goalId} dimension=${dimensionName}, using raw score: ${String(err)}`);
-    }
-    const entry = ObservationLogEntrySchema.parse({
-        observation_id: randomUUID(),
-        timestamp: new Date().toISOString(),
-        trigger: "periodic",
-        goal_id: goalId,
-        dimension_name: dimensionName,
-        layer: resolvedLayer,
-        method: {
-            type: "llm_review",
-            source: "llm",
-            schedule: null,
-            endpoint: null,
-            confidence_tier: resolvedLayer,
-        },
-        raw_result: { score, reason: parsed.reason },
-        extracted_value: extractedValue,
-        confidence: resolvedConfidence,
-        notes: `LLM evaluation: ${parsed.reason}`,
-    });
-    if (!dryRun) {
-        try {
-            await applyObservation(goalId, entry);
-        }
-        catch (persistErr) {
-            // Persistence failed (e.g., dimension name mismatch in applyObservation).
-            // Wrap the error with the successfully-observed entry so callers can
-            // recover the LLM score rather than silently falling back to null.
-            throw new ObservationPersistenceError(`Failed to persist LLM observation for dimension "${dimensionName}": ${persistErr instanceof Error ? persistErr.message : String(persistErr)}`, entry, persistErr instanceof Error ? persistErr : new Error(String(persistErr)));
-        }
-    }
-    return entry;
-}
-/**
- * Thrown when the LLM observation succeeded but persistence (applyObservation) failed.
- * Carries the successfully-observed entry so callers can recover the value.
- */
-export class ObservationPersistenceError extends Error {
-    entry;
-    cause;
-    constructor(message, entry, cause) {
-        super(message);
-        this.entry = entry;
-        this.cause = cause;
-        this.name = "ObservationPersistenceError";
-    }
-}
-//# sourceMappingURL=observation-llm.js.map