pulseed 0.4.18 → 0.4.19

package/dist/platform/observation/observation-llm.js

@@ -0,0 +1,430 @@
+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 "../../base/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, toolExecutor) {
+    // Allow test injection via options
+    if (options.gitContextFetcher) {
+        return options.gitContextFetcher(maxChars);
+    }
+    // Use ToolExecutor + GitDiffTool when available (preferred path, falls through to execFile on failure)
+    if (toolExecutor) {
+        const ctx = {
+            cwd: cwd ?? process.cwd(),
+            goalId: "observation",
+            trustBalance: 0,
+            preApproved: true,
+            approvalFn: async () => true,
+            sessionId: "observation",
+            callId: "obs-git-context",
+        };
+        try {
+            const result = await toolExecutor.execute("git_diff", { target: "unstaged", maxLines: 200 }, ctx);
+            if (result.success && result.data && typeof result.data === "string" && result.data.trim()) {
+                const diff = result.data;
+                const truncated = diff.length > maxChars ? diff.slice(0, maxChars) + "\n...(truncated)" : diff;
+                return "[git diff]\n\n" + truncated.trim();
+            }
+        }
+        catch {
+            // fall through to execFile fallback below
+        }
+    }
+    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, toolExecutor) {
+    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, toolExecutor);
+        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

package/dist/platform/observation/observation-llm.js.map

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

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

@@ -0,0 +1,29 @@
+import type { TaskDomain } from "../../base/types/pipeline.js";
+import type { AgentTask } from "../../orchestrator/execution/adapter-layer.js";
+import type { Logger } from "../../runtime/logger.js";
+export interface TaskObservationContext {
+    context: string;
+    sources: string[];
+    domain: TaskDomain;
+}
+export interface ObserveForTaskDeps {
+    contextProvider?: (goalId: string, dimensionName: string) => Promise<string | null>;
+    logger?: Logger;
+}
+/**
+ * Collect domain-specific pre-execution context for a task.
+ *
+ * Phase 1 MVP: all domains use a unified strategy — concatenate the task
+ * description with any workspace context from `contextProvider`.
+ * Domain-specific collection strategies (file graphs, schema discovery,
+ * metric snapshots, etc.) will be expanded in later phases.
+ *
+ * The assembled context is intended for `implementor` and `researcher`
+ * roles only. Do NOT pass it to `verifier` or `reviewer` (bias prevention).
+ *
+ * @param deps   Injected dependencies (contextProvider, logger).
+ * @param task   The agent task requiring pre-execution context.
+ * @param domain The task domain that governs the collection strategy.
+ */
+export declare function observeForTask(deps: ObserveForTaskDeps, task: AgentTask, domain: TaskDomain): Promise<TaskObservationContext>;
+//# sourceMappingURL=observation-task.d.ts.map

package/dist/platform/observation/observation-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-task.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/observation-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAItD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB;AAeD,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,sBAAsB,CAAC,CA4BjC"}

package/dist/platform/observation/observation-task.js

@@ -0,0 +1,51 @@
+// ─── Domain labels ───
+const DOMAIN_LABEL = {
+    code: "Target files, related tests, and module dependencies",
+    data: "Data sources, schemas, and previous observation values",
+    api_action: "API endpoints, rate limits, and authentication state",
+    research: "Known knowledge and unresolved questions",
+    monitoring: "Current metric values, alert thresholds, and recent trends",
+    communication: "Recipient context and message history",
+};
+// ─── observeForTask ───
+/**
+ * Collect domain-specific pre-execution context for a task.
+ *
+ * Phase 1 MVP: all domains use a unified strategy — concatenate the task
+ * description with any workspace context from `contextProvider`.
+ * Domain-specific collection strategies (file graphs, schema discovery,
+ * metric snapshots, etc.) will be expanded in later phases.
+ *
+ * The assembled context is intended for `implementor` and `researcher`
+ * roles only. Do NOT pass it to `verifier` or `reviewer` (bias prevention).
+ *
+ * @param deps   Injected dependencies (contextProvider, logger).
+ * @param task   The agent task requiring pre-execution context.
+ * @param domain The task domain that governs the collection strategy.
+ */
+export async function observeForTask(deps, task, domain) {
+    const sources = ["task_description"];
+    const parts = [`Task: ${task.prompt}`];
+    // Attempt to pull workspace context via contextProvider.
+    // Use the domain as the dimension key since AgentTask has no goal_id field.
+    if (deps.contextProvider) {
+        try {
+            const workspaceCtx = await deps.contextProvider("", domain);
+            if (workspaceCtx) {
+                parts.push(`Workspace context (${domain}):\n${workspaceCtx}`);
+                sources.push("context_provider");
+            }
+        }
+        catch (err) {
+            deps.logger?.warn(`[ObservationEngine] observeForTask: contextProvider failed for domain "${domain}": ` +
+                `${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    parts.push(`Domain focus (${domain}): ${DOMAIN_LABEL[domain]}`);
+    return {
+        context: parts.join("\n\n"),
+        sources,
+        domain,
+    };
+}
+//# sourceMappingURL=observation-task.js.map

package/dist/platform/observation/observation-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-task.js","sourceRoot":"","sources":["../../../src/platform/observation/observation-task.ts"],"names":[],"mappings":"AAYA,wBAAwB;AAExB,MAAM,YAAY,GAA+B;IAC/C,IAAI,EAAE,sDAAsD;IAC5D,IAAI,EAAE,wDAAwD;IAC9D,UAAU,EAAE,sDAAsD;IAClE,QAAQ,EAAE,0CAA0C;IACpD,UAAU,EAAE,4DAA4D;IACxE,aAAa,EAAE,uCAAuC;CACvD,CAAC;AASF,yBAAyB;AAEzB;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAwB,EACxB,IAAe,EACf,MAAkB;IAElB,MAAM,OAAO,GAAa,CAAC,kBAAkB,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAa,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjD,yDAAyD;IACzD,4EAA4E;IAC5E,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC5D,IAAI,YAAY,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,OAAO,YAAY,EAAE,CAAC,CAAC;gBAC9D,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,EAAE,IAAI,CACf,0EAA0E,MAAM,KAAK;gBACrF,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,MAAM,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEhE,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3B,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { ToolExecutor } from "../../tools/executor.js";
+import type { ToolCallContext } from "../../tools/types.js";
+import type { ToolPermissionManager } from "../../tools/permission.js";
+import type { Dimension } from "../../orchestrator/goal/types/goal.js";
+export interface ToolObservationResult {
+    rawData: unknown;
+    parsedValue: number | string | boolean | null;
+    confidence: number;
+    toolName: string;
+    durationMs: number;
+}
+/**
+ * Observe a dimension using the tool executor.
+ * Routes to the appropriate tool based on observation_method.type.
+ * Returns null if the method is unsupported or the tool call fails.
+ */
+export declare function observeWithTools(toolExecutor: ToolExecutor, dimension: Dimension, context: ToolCallContext): Promise<ToolObservationResult | null>;
+/**
+ * Register shell allow rules in the permission manager for all mechanical dimensions.
+ */
+export declare function registerObservationAllowRules(permissionManager: ToolPermissionManager, dimensions: Dimension[]): void;
+//# sourceMappingURL=observation-tools.d.ts.map

package/dist/platform/observation/observation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-tools.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/observation-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAGvE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsDvC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,iBAAiB,EAAE,qBAAqB,EACxC,UAAU,EAAE,SAAS,EAAE,GACtB,IAAI,CAeN"}