pulseed 0.3.0 → 0.4.0

package/dist/platform/knowledge/transfer/knowledge-transfer.js

@@ -1,3 +1,6 @@
+import { z } from "zod";
+import { TransferCandidateSchema, TransferResultSchema, TransferEffectivenessSchema, } from "../../../base/types/cross-portfolio.js";
+import { LearnedPatternSchema } from "../../../base/types/learning.js";
 import { TransferTrustManager } from "./transfer-trust.js";
 import { detectTransferOpportunities } from "./knowledge-transfer-detect.js";
 import { applyTransfer, autoApplyHighConfidenceTransfers, detectCandidatesRealtime, } from "./knowledge-transfer-apply.js";
@@ -16,9 +19,11 @@ import { buildCrossGoalKnowledgeBase, updateMetaPatternsIncremental, storePatter
  * - knowledge-transfer-evaluate.ts — effectiveness evaluation + trust update
  * - knowledge-transfer-meta.ts    — meta-pattern aggregation (batch + incremental)
  *
- * Stored in-memory (Map/array). No file persistence for MVP.
+ * State is kept in-memory and mirrored to a persisted snapshot so other
+ * processes can read transfer history without sharing process-local memory.
  */
 export class KnowledgeTransfer {
+    static SNAPSHOT_PATH = "knowledge-transfer/snapshot.json";
     detectDeps;
     applyDeps;
     metaDeps;
@@ -37,6 +42,8 @@ export class KnowledgeTransfer {
     crossGoalPatterns = new Map();
     /** Timestamp of last incremental meta-pattern aggregation (ISO string) */
     lastAggregatedAt = null;
+    snapshotLoaded = false;
+    snapshotLoadPromise = null;
     constructor(deps) {
         this.transferTrust =
             deps.transferTrust ??
@@ -66,21 +73,36 @@ export class KnowledgeTransfer {
     }
     // ─── Detect ───
     async detectTransferOpportunities(goalId) {
-        return detectTransferOpportunities(goalId, this.detectDeps, this.candidates, this.patternTrackers);
+        await this.ensureSnapshotLoaded();
+        const result = await detectTransferOpportunities(goalId, this.detectDeps, this.candidates, this.patternTrackers);
+        await this.persistSnapshot();
+        return result;
     }
     // ─── Apply ───
     async applyTransfer(candidateId, targetGoalId) {
-        return applyTransfer(candidateId, targetGoalId, this.applyDeps, this.candidates, this.results, this.applyContexts);
+        await this.ensureSnapshotLoaded();
+        const result = await applyTransfer(candidateId, targetGoalId, this.applyDeps, this.candidates, this.results, this.applyContexts);
+        await this.persistSnapshot();
+        return result;
     }
     async autoApplyHighConfidenceTransfers(goalId) {
-        return autoApplyHighConfidenceTransfers(goalId, this.applyDeps, this.detectDeps, this.candidates, this.results, this.applyContexts, this.patternTrackers);
+        await this.ensureSnapshotLoaded();
+        const result = await autoApplyHighConfidenceTransfers(goalId, this.applyDeps, this.detectDeps, this.candidates, this.results, this.applyContexts, this.patternTrackers);
+        await this.persistSnapshot();
+        return result;
     }
     async detectCandidatesRealtime(goalId) {
-        return detectCandidatesRealtime(goalId, this.detectDeps, this.candidates, this.patternTrackers);
+        await this.ensureSnapshotLoaded();
+        const result = await detectCandidatesRealtime(goalId, this.detectDeps, this.candidates, this.patternTrackers);
+        await this.persistSnapshot();
+        return result;
     }
     // ─── Evaluate ───
     async evaluateTransferEffect(transferId) {
-        return evaluateTransferEffect(transferId, this.applyDeps.stateManager, this.transferTrust, this.results, this.applyContexts, this.effectivenessRecords, this.candidates, this.patternTrackers);
+        await this.ensureSnapshotLoaded();
+        const result = await evaluateTransferEffect(transferId, this.applyDeps.stateManager, this.transferTrust, this.results, this.applyContexts, this.effectivenessRecords, this.candidates, this.patternTrackers);
+        await this.persistSnapshot();
+        return result;
     }
     // ─── Meta ───
     async buildCrossGoalKnowledgeBase() {
@@ -106,6 +128,15 @@ export class KnowledgeTransfer {
     getEffectivenessRecords() {
         return getEffectivenessRecords(this.effectivenessRecords);
     }
+    async listTransferSnapshot(options) {
+        if (options?.forceRefresh) {
+            await this.loadSnapshot();
+        }
+        else {
+            await this.ensureSnapshotLoaded();
+        }
+        return this.buildTransferSnapshot();
+    }
     getAppliedTransferCount() {
         return getAppliedTransferCount(this.candidates);
     }
@@ -113,6 +144,90 @@ export class KnowledgeTransfer {
         return getTransferSuccessRate(this.effectivenessRecords);
     }
     // ─── Private Persistence Helpers ───
+    static SnapshotSchema = z.object({
+        transfers: z.array(TransferCandidateSchema).default([]),
+        results: z.array(TransferResultSchema).default([]),
+        effectiveness_records: z.array(TransferEffectivenessSchema).default([]),
+        apply_contexts: z.record(z.string(), z.object({
+            candidate: TransferCandidateSchema,
+            gap_at_apply: z.number(),
+            source_pattern: LearnedPatternSchema.nullable(),
+        })).default({}),
+        pattern_trackers: z.record(z.string(), z.object({
+            consecutive_non_positive: z.number().int().min(0),
+            invalidated: z.boolean(),
+        })).default({}),
+    });
+    buildTransferSnapshot() {
+        return {
+            transfers: Array.from(this.candidates.values()),
+            results: Array.from(this.results.values()),
+            effectiveness_records: getEffectivenessRecords(this.effectivenessRecords),
+        };
+    }
+    async ensureSnapshotLoaded() {
+        if (this.snapshotLoaded) {
+            return;
+        }
+        if (!this.snapshotLoadPromise) {
+            this.snapshotLoadPromise = this.loadSnapshot();
+        }
+        await this.snapshotLoadPromise;
+    }
+    async refreshSnapshot() {
+        await this.loadSnapshot();
+    }
+    async loadSnapshot() {
+        try {
+            const raw = await this.applyDeps.stateManager.readRaw(KnowledgeTransfer.SNAPSHOT_PATH);
+            if (raw && typeof raw === "object") {
+                const snapshot = KnowledgeTransfer.SnapshotSchema.parse(raw);
+                this.candidates.clear();
+                for (const candidate of snapshot.transfers) {
+                    this.candidates.set(candidate.candidate_id, candidate);
+                }
+                this.results.clear();
+                for (const result of snapshot.results) {
+                    this.results.set(result.transfer_id, result);
+                }
+                this.effectivenessRecords.clear();
+                for (const record of snapshot.effectiveness_records) {
+                    this.effectivenessRecords.set(record.transfer_id, record);
+                }
+                this.applyContexts.clear();
+                for (const [transferId, context] of Object.entries(snapshot.apply_contexts)) {
+                    this.applyContexts.set(transferId, context);
+                }
+                this.patternTrackers.clear();
+                for (const [patternId, tracker] of Object.entries(snapshot.pattern_trackers)) {
+                    this.patternTrackers.set(patternId, tracker);
+                }
+            }
+        }
+        catch {
+            // non-fatal: start from an empty snapshot
+        }
+        finally {
+            this.snapshotLoaded = true;
+            this.snapshotLoadPromise = null;
+        }
+    }
+    async persistSnapshot() {
+        if (!this.snapshotLoaded) {
+            return;
+        }
+        const snapshot = {
+            ...this.buildTransferSnapshot(),
+            apply_contexts: Object.fromEntries(this.applyContexts.entries()),
+            pattern_trackers: Object.fromEntries(this.patternTrackers.entries()),
+        };
+        try {
+            await this.applyDeps.stateManager.writeRaw(KnowledgeTransfer.SNAPSHOT_PATH, snapshot);
+        }
+        catch {
+            // non-fatal: in-memory state remains authoritative for this process
+        }
+    }
     async _loadLastAggregatedAt() {
         if (this.lastAggregatedAt !== null)
             return this.lastAggregatedAt;

package/dist/platform/knowledge/transfer/knowledge-transfer.js.map

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

package/dist/platform/observation/capability-detector.d.ts

@@ -7,6 +7,13 @@ import type { PluginMatchResult } from "../../base/types/plugin.js";
 import type { PluginLoader } from "../../runtime/plugin-loader.js";
 import type { Capability, CapabilityRegistry, CapabilityGap, CapabilityStatus, AcquisitionContext, CapabilityAcquisitionTask, CapabilityVerificationResult, CapabilityDependency } from "../../base/types/capability.js";
 import type { AgentResult } from "../../orchestrator/execution/adapter-layer.js";
+export interface CapabilityAcquisitionRecommendation {
+    pluginName: string;
+    installSource: string;
+    rationale: string;
+    verificationHint: string;
+    requiresApproval: boolean;
+}
 export declare class CapabilityDetector {
     private readonly stateManager;
     private readonly llmClient;
@@ -52,6 +59,7 @@ export declare class CapabilityDetector {
      * This confirms that repeated failures are due to a capability deficiency.
      */
     confirmDeficiency(_taskId: string, consecutiveFailures: number): boolean;
+    recommendAcquisition(gap: CapabilityGap): CapabilityAcquisitionRecommendation[];
     /**
      * Deterministically creates a CapabilityAcquisitionTask from a CapabilityGap.
      * Pure synchronous function — no LLM needed. Rules from design doc §5.3.

package/dist/platform/observation/capability-detector.d.ts.map

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

package/dist/platform/observation/capability-detector.js

@@ -4,6 +4,44 @@ import { loadRegistry, saveRegistry, registerCapability, removeCapability, findC
 import { addDependency, getDependencies, resolveDependencies, detectCircularDependency, getAcquisitionOrder, } from "./capability-dependencies.js";
 // ─── Constants ───
 const CONSECUTIVE_FAILURE_THRESHOLD = 3;
+const ACQUISITION_RECOMMENDATION_RULES = [
+    {
+        pluginName: "postgres-datasource",
+        installSource: "examples/plugins/postgres-datasource",
+        capabilityTypes: ["data_source", "service"],
+        patterns: [/\bpostgres\b/i, /\bpostgresql\b/i, /\banalytics_db\b/i, /\bdatabase\b/i, /\bsql\b/i],
+        rationale: "Use the first-party Postgres datasource plugin for structured SQL observation.",
+        verificationHint: "Load the plugin, configure a DSN, and confirm datasource health checks succeed.",
+        requiresApproval: false,
+    },
+    {
+        pluginName: "mysql-datasource",
+        installSource: "examples/plugins/mysql-datasource",
+        capabilityTypes: ["data_source", "service"],
+        patterns: [/\bmysql\b/i],
+        rationale: "Use the first-party MySQL datasource plugin when the gap targets MySQL-backed data.",
+        verificationHint: "Load the plugin, configure the database, and confirm datasource connectivity.",
+        requiresApproval: false,
+    },
+    {
+        pluginName: "jira-datasource",
+        installSource: "examples/plugins/jira-datasource",
+        capabilityTypes: ["service", "data_source"],
+        patterns: [/\bjira\b/i],
+        rationale: "Use the first-party Jira datasource plugin instead of bespoke API glue.",
+        verificationHint: "Load the plugin, configure Jira credentials, and verify plugin/API health.",
+        requiresApproval: false,
+    },
+    {
+        pluginName: "websocket-datasource",
+        installSource: "examples/plugins/websocket-datasource",
+        capabilityTypes: ["service", "data_source"],
+        patterns: [/\bwebsocket\b/i, /\bws\b/i],
+        rationale: "Use the first-party WebSocket datasource plugin for realtime observation.",
+        verificationHint: "Load the plugin, connect to the event stream, and confirm health checks pass.",
+        requiresApproval: false,
+    },
+];
 // ─── LLM response schema for deficiency detection ───
 const DeficiencyResponseSchema = z.union([
     z.object({
@@ -254,6 +292,24 @@ export class CapabilityDetector {
     confirmDeficiency(_taskId, consecutiveFailures) {
         return consecutiveFailures >= CONSECUTIVE_FAILURE_THRESHOLD;
     }
+    recommendAcquisition(gap) {
+        const haystack = [
+            gap.missing_capability.name,
+            gap.reason,
+            gap.impact_description,
+            ...gap.alternatives,
+        ].join(" ");
+        return ACQUISITION_RECOMMENDATION_RULES
+            .filter((rule) => rule.capabilityTypes.includes(gap.missing_capability.type) &&
+            rule.patterns.some((pattern) => pattern.test(haystack)))
+            .map((rule) => ({
+            pluginName: rule.pluginName,
+            installSource: rule.installSource,
+            rationale: rule.rationale,
+            verificationHint: rule.verificationHint,
+            requiresApproval: rule.requiresApproval,
+        }));
+    }
     // ─── planAcquisition ───
     /**
      * Deterministically creates a CapabilityAcquisitionTask from a CapabilityGap.
@@ -262,6 +318,7 @@ export class CapabilityDetector {
     planAcquisition(gap) {
         const capabilityName = gap.missing_capability.name;
         const capabilityType = gap.missing_capability.type;
+        const recommendation = this.recommendAcquisition(gap)[0];
         let method;
         let task_description;
         if (capabilityType === "tool") {
@@ -293,14 +350,24 @@ export class CapabilityDetector {
                     `Configure and verify the data source is accessible. ` +
                     `Impact if unavailable: ${gap.impact_description}`;
         }
+        if (recommendation) {
+            task_description +=
+                ` Recommended acquisition path: install plugin "${recommendation.pluginName}" from ` +
+                    `"${recommendation.installSource}". ${recommendation.rationale} ` +
+                    `Verification hint: ${recommendation.verificationHint}`;
+        }
+        const successCriteria = [
+            "capability registered in registry",
+            `${capabilityName} is operational and accessible`,
+        ];
+        if (recommendation) {
+            successCriteria.push(`recommended plugin "${recommendation.pluginName}" is installed or otherwise made available`, "follow-up replanning is triggered after the capability becomes available");
+        }
         return CapabilityAcquisitionTaskSchema.parse({
             gap,
             method,
             task_description,
-            success_criteria: [
-                "capability registered in registry",
-                `${capabilityName} is operational and accessible`,
-            ],
+            success_criteria: successCriteria,
             verification_attempts: 0,
             max_verification_attempts: 3,
         });

package/dist/platform/observation/capability-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability-detector.js","sourceRoot":"","sources":["../../../src/platform/observation/capability-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,EACL,+BAA+B,EAC/B,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAYxC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,oBAAoB;AAEpB,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAExC,uDAAuD;AAEvD,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC,CAAC,MAAM,CAAC;QACP,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KACjC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/B,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;SAChD,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;KAC/B,CAAC;CACH,CAAC,CAAC;AAEH,sEAAsE;AAEtE,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC;IAC9C,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACxB,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;SAC/D,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;KACxB,CAAC;CACH,CAAC,CAAC;AAEH,6BAA6B;AAE7B,MAAM,OAAO,kBAAkB;IACZ,YAAY,CAAe;IAC3B,SAAS,CAAa;IACtB,eAAe,CAAkB;IACjC,YAAY,CAAgB;IAC5B,OAAO,CAAkB;IAE1C,YACE,YAA0B,EAC1B,SAAqB,EACrB,eAAgC,EAChC,YAA2B,EAC3B,OAAwB;QAExB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,2BAA2B;IAE3B;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAU;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE3C,MAAM,qBAAqB,GAAG,QAAQ,CAAC,YAAY;aAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;aACvD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,YAAY,GAChB,gEAAgE;YAChE,iGAAiG;YACjG,8EAA8E,CAAC;QAEjF,MAAM,WAAW,GACf,wFAAwF;YACxF,qBAAqB,IAAI,CAAC,gBAAgB,IAAI;YAC9C,mBAAmB,IAAI,CAAC,SAAS,IAAI;YACrC,kBAAkB,IAAI,CAAC,QAAQ,MAAM;YACrC,4BAA4B,qBAAqB,IAAI,mBAAmB,MAAM;YAC9E,kDAAkD;YAClD,sCAAsC;YACtC,iCAAiC;YACjC,+BAA+B;YAC/B,KAAK;YACL,6BAA6B;YAC7B,oFAAoF;YACpF,kDAAkD;YAClD,+EAA+E;YAC/E,wEAAwE;YACxE,GAAG,CAAC;QAEN,IAAI,MAAgD,CAAC;QACrD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBAClC,OAAO,EAAE,mBAAmB;gBAC5B,iBAAiB,EAAE,EAAE,iBAAiB,EAAE,WAAW,EAAE;gBACrD,cAAc,EAAE,wBAAwB;aACzC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAC/C,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EACxC,EAAE,MAAM,EAAE,YAAY,EAAE,CACzB,CAAC;YACF,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC;YACpC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,eAAe,EAAE,IAAI,CAAC,EAAE;SACzB,CAAC,CAAC;QAEH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kCAAkC;IAElC;;;;;;;;OAQG;IACH,KAAK,CAAC,uBAAuB,CAC3B,eAAuB,EACvB,mBAA6B,EAC7B,cAAyB;QAEzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAE3C,MAAM,uBAAuB,GAAG,QAAQ,CAAC,YAAY;iBAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;iBACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAE3D,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,GAAG,CACpD,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,qBAAqB,CACvC,CAAC;YAEF,MAAM,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,EAAE,GAAG,sBAAsB,CAAC,CAAC;YAClF,MAAM,qBAAqB,GACzB,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;YAEpF,MAAM,YAAY,GAChB,gEAAgE;gBAChE,iGAAiG;gBACjG,8EAA8E,CAAC;YAEjF,MAAM,WAAW,GACf,wFAAwF;gBACxF,qBAAqB,eAAe,MAAM;gBAC1C,yFAAyF,qBAAqB,MAAM;gBACpH,kDAAkD;gBAClD,sCAAsC;gBACtC,0BAA0B;gBAC1B,+BAA+B;gBAC/B,KAAK;gBACL,sBAAsB;gBACtB,gGAAgG;gBAChG,kDAAkD;gBAClD,+EAA+E;gBAC/E,yEAAyE;gBACzE,8BAA8B;gBAC9B,GAAG,CAAC;YAEN,IAAI,MAAuD,CAAC;YAC5D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;oBAClC,OAAO,EAAE,qBAAqB;oBAC9B,iBAAiB,EAAE,EAAE,eAAe,EAAE,WAAW,EAAE;oBACnD,cAAc,EAAE,+BAA+B;iBAChD,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAC/C,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EACxC,EAAE,MAAM,EAAE,YAAY,EAAE,CACzB,CAAC;gBACF,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAC,CAAC;gBACvF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,mFAAmF,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAC/G,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC;gBACpC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;gBAC7C,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;gBAC7C,6EAA6E;aAC9E,CAAC,CAAC;YAEH,MAAM,MAAM,GAAwF;gBAClG,GAAG;gBACH,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;aACvC,CAAC;YAEF,IAAI,IAAI,CAAC,YAAY,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrE,MAAM,CAAC,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,8BAA8B;IAE9B;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,cAAwB;QAChD,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAEvD,MAAM,OAAO,GAAwB,EAAE,CAAC;QAExC,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YAExC,MAAM,gBAAgB,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;YACzD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE5C,MAAM,iBAAiB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACrF,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;YAEpE,IAAI,UAAU,GAAG,GAAG;gBAAE,SAAS;YAE/B,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,KAAK,CAAC,IAAI;gBACtB,UAAU;gBACV,iBAAiB;gBACjB,UAAU,EAAE,KAAK,CAAC,WAAW;gBAC7B,cAAc,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;aACxC,CAAC,CAAC;QACL,CAAC;QAED,4DAA4D;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU;gBAAE,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;YACtE,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4BAA4B;IAE5B,KAAK,CAAC,YAAY;QAChB,OAAO,YAAY,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAA4B;QAC7C,OAAO,YAAY,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,GAAe,EAAE,OAA4B;QACpE,OAAO,kBAAkB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,YAAoB;QACzC,OAAO,gBAAgB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,YAAY,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAAY;QACrC,OAAO,oBAAoB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,MAAc;QACxC,OAAO,qBAAqB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,cAAsB,EACtB,cAA2D,EAC3D,MAAwB;QAExB,OAAO,mBAAmB,CACxB,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EACnC,cAAc,EACd,cAAc,EACd,MAAM,CACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAAkB,EAAE,MAAc;QACrD,OAAO,cAAc,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;IAED,4BAA4B;IAE5B;;;OAGG;IACH,iBAAiB,CAAC,OAAe,EAAE,mBAA2B;QAC5D,OAAO,mBAAmB,IAAI,6BAA6B,CAAC;IAC9D,CAAC;IAED,0BAA0B;IAE1B;;;OAGG;IACH,eAAe,CAAC,GAAkB;QAChC,MAAM,cAAc,GAAG,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC;QACnD,MAAM,cAAc,GAAG,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAEnD,IAAI,MAA2C,CAAC;QAChD,IAAI,gBAAwB,CAAC;QAE7B,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;YAC9B,MAAM,GAAG,eAAe,CAAC;YACzB,gBAAgB;gBACd,wBAAwB,cAAc,uCAAuC,GAAG,CAAC,MAAM,IAAI;oBAC3F,6DAA6D;oBAC7D,0BAA0B,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvD,CAAC;aAAM,IAAI,cAAc,KAAK,YAAY,EAAE,CAAC;YAC3C,MAAM,GAAG,oBAAoB,CAAC;YAC9B,gBAAgB;gBACd,2BAA2B,cAAc,2CAA2C;oBACpF,oCAAoC,GAAG,CAAC,MAAM,IAAI;oBAClD,0BAA0B,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvD,CAAC;aAAM,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,GAAG,eAAe,CAAC;YACzB,gBAAgB;gBACd,uBAAuB,cAAc,wCAAwC,GAAG,CAAC,MAAM,IAAI;oBAC3F,mDAAmD;oBACnD,0BAA0B,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,mDAAmD;YACnD,MAAM,GAAG,eAAe,CAAC;YACzB,gBAAgB;gBACd,qCAAqC,cAAc,wCAAwC,GAAG,CAAC,MAAM,IAAI;oBACzG,sDAAsD;oBACtD,0BAA0B,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvD,CAAC;QAED,OAAO,+BAA+B,CAAC,KAAK,CAAC;YAC3C,GAAG;YACH,MAAM;YACN,gBAAgB;YAChB,gBAAgB,EAAE;gBAChB,mCAAmC;gBACnC,GAAG,cAAc,gCAAgC;aAClD;YACD,qBAAqB,EAAE,CAAC;YACxB,yBAAyB,EAAE,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IAEnC;;;;OAIG;IACH,KAAK,CAAC,wBAAwB,CAC5B,UAAsB,EACtB,eAA0C,EAC1C,WAAwB;QAExB,MAAM,YAAY,GAChB,gEAAgE;YAChE,8EAA8E;YAC9E,8EAA8E,CAAC;QAEjF,MAAM,WAAW,GACf,+CAA+C;YAC/C,oBAAoB,UAAU,CAAC,IAAI,IAAI;YACvC,oBAAoB,UAAU,CAAC,IAAI,IAAI;YACvC,2BAA2B,UAAU,CAAC,WAAW,MAAM;YACvD,qBAAqB,eAAe,CAAC,gBAAgB,IAAI;YACzD,qBAAqB,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;YACtE,yBAAyB,WAAW,CAAC,MAAM,MAAM;YACjD,0CAA0C;YAC1C,+DAA+D;YAC/D,6DAA6D;YAC7D,4EAA4E;YAC5E,qCAAqC;YACrC,2DAA2D,CAAC;QAE9D,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;YAC1C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,CAAC,CAAC;QAEH,IAAI,MAAkD,CAAC;QACvD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBAClC,OAAO,EAAE,mBAAmB;gBAC5B,iBAAiB,EAAE,EAAE,aAAa,EAAE,WAAW,EAAE;gBACjD,cAAc,EAAE,0BAA0B;aAC3C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAC/C,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EACxC,EAAE,MAAM,EAAE,YAAY,EAAE,CACzB,CAAC;YACF,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC9B,eAAe,CAAC,qBAAqB,IAAI,CAAC,CAAC;YAC3C,IAAI,eAAe,CAAC,qBAAqB,IAAI,eAAe,CAAC,yBAAyB,EAAE,CAAC;gBACvF,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8BAA8B;IAE9B,KAAK,CAAC,aAAa,CAAC,YAAoB,EAAE,SAAmB;QAC3D,OAAO,aAAa,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,YAAoB;QACxC,OAAO,eAAe,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,YAAY,CAAC,CAAC;IAC5E,CAAC;IAED,mBAAmB,CAAC,YAAoC;QACtD,OAAO,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED,wBAAwB,CAAC,YAAoC;QAC3D,OAAO,wBAAwB,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAqB;QAC7C,OAAO,mBAAmB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;CACF"}
+{"version":3,"file":"capability-detector.js","sourceRoot":"","sources":["../../../src/platform/observation/capability-detector.ts"],"names":[],"mappings":"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"}

package/dist/platform/observation/data-source-adapter.d.ts

@@ -30,6 +30,24 @@ export declare class HttpApiDataSourceAdapter implements IDataSourceAdapter {
     disconnect(): Promise<void>;
     healthCheck(): Promise<boolean>;
 }
+declare function runPsql(connectionString: string, sql: string, timeoutMs: number): Promise<{
+    stdout: string;
+    stderr: string;
+    code: number | null;
+}>;
+export declare class PostgresDataSourceAdapter implements IDataSourceAdapter {
+    readonly sourceId: string;
+    readonly sourceType: DataSourceType;
+    readonly config: DataSourceConfig;
+    private readonly runner;
+    constructor(config: DataSourceConfig, runner?: typeof runPsql);
+    private resolveConnectionString;
+    private resolveQueryExpression;
+    connect(): Promise<void>;
+    query(params: DataSourceQuery): Promise<DataSourceResult>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
 export declare class DataSourceRegistry {
     private readonly sources;
     register(adapter: IDataSourceAdapter): void;
@@ -39,4 +57,5 @@ export declare class DataSourceRegistry {
     has(id: string): boolean;
     upsert(adapter: IDataSourceAdapter): void;
 }
+export {};
 //# sourceMappingURL=data-source-adapter.d.ts.map

package/dist/platform/observation/data-source-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source-adapter.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/data-source-adapter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AAIzC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUlE;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,sBAAsB,CAAC,IAAI,MAAM,EAAE,CAAC;CACrC;AAID,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAU;IAC7C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAEtB,MAAM,EAAE,gBAAgB;IAK9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxB,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgCzD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAUtC;AAuBD,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAc;IACjD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAEtB,MAAM,EAAE,gBAAgB;IAK9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2DzD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAoBtC;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAEtE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAU3C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB;IAWzC,WAAW,IAAI,MAAM,EAAE;IAIvB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAUxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAM1C"}
+{"version":3,"file":"data-source-adapter.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/data-source-adapter.ts"],"names":[],"mappings":"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"}

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

@@ -4,6 +4,7 @@
 // file-based and HTTP API data sources, plus DataSourceRegistry for managing
 // multiple adapter instances.
 import * as fsp from "node:fs/promises";
+import { spawn } from "node:child_process";
 import { ValidationError } from "../../base/utils/errors.js";
 // ─── Helper ───
 export function getNestedValue(obj, path) {
@@ -186,6 +187,171 @@ export class HttpApiDataSourceAdapter {
         }
     }
 }
+// ─── PostgresDataSourceAdapter ───
+function parseScalarResult(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return null;
+    if (trimmed === "null")
+        return null;
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (/^[-+]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?$/.test(trimmed)) {
+        const num = Number(trimmed);
+        if (!Number.isNaN(num))
+            return num;
+    }
+    return trimmed;
+}
+function buildPsqlArgs(connectionString, sql) {
+    return [
+        "-X",
+        "-q",
+        "-t",
+        "-A",
+        "-v",
+        "ON_ERROR_STOP=1",
+        "-d",
+        connectionString,
+        "-c",
+        sql,
+    ];
+}
+function normalizeSqlExpression(expression) {
+    const trimmed = expression.trim();
+    if (/^(select|with)\b/i.test(trimmed)) {
+        return trimmed;
+    }
+    return `SELECT (${trimmed}) AS value`;
+}
+function runPsql(connectionString, sql, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("psql", buildPsqlArgs(connectionString, sql), {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error("PostgresDataSourceAdapter: query timed out"));
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf-8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf-8");
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                reject(new Error(stderr.trim() || `psql exited with code ${code ?? "unknown"}`));
+                return;
+            }
+            resolve({ stdout, stderr, code });
+        });
+    });
+}
+export class PostgresDataSourceAdapter {
+    sourceId;
+    sourceType = "database";
+    config;
+    runner;
+    constructor(config, runner = runPsql) {
+        this.config = config;
+        this.sourceId = config.id;
+        this.runner = runner;
+    }
+    resolveConnectionString() {
+        const direct = this.config.connection_string?.trim();
+        if (direct)
+            return direct;
+        const url = this.config.connection.url?.trim();
+        if (url)
+            return url;
+        return undefined;
+    }
+    resolveQueryExpression(params) {
+        const mapped = this.config.dimension_mapping?.[params.dimension_name];
+        const expression = params.expression ?? mapped;
+        if (!expression || !expression.trim()) {
+            return undefined;
+        }
+        return expression;
+    }
+    async connect() {
+        const healthy = await this.healthCheck();
+        if (!healthy) {
+            throw new Error(`PostgresDataSourceAdapter [${this.sourceId}]: health check failed`);
+        }
+    }
+    async query(params) {
+        const connectionString = this.resolveConnectionString();
+        if (!connectionString) {
+            throw new ValidationError(`PostgresDataSourceAdapter [${this.sourceId}]: connection_string is required`);
+        }
+        const expression = this.resolveQueryExpression(params);
+        if (!expression) {
+            return {
+                value: null,
+                raw: [],
+                timestamp: new Date().toISOString(),
+                source_id: this.sourceId,
+                metadata: {
+                    error: `No SQL expression configured for dimension "${params.dimension_name}"`,
+                },
+            };
+        }
+        const sql = normalizeSqlExpression(expression);
+        try {
+            const result = await this.runner(connectionString, sql, params.timeout_ms ?? 10_000);
+            const lines = result.stdout.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+            const firstRow = lines[0] ?? "";
+            const [firstCell = ""] = firstRow.split("\t");
+            return {
+                value: parseScalarResult(firstCell),
+                raw: lines,
+                timestamp: new Date().toISOString(),
+                source_id: this.sourceId,
+                metadata: {
+                    query: sql,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                value: null,
+                raw: [],
+                timestamp: new Date().toISOString(),
+                source_id: this.sourceId,
+                metadata: {
+                    query: sql,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            };
+        }
+    }
+    async disconnect() {
+        // no-op
+    }
+    async healthCheck() {
+        const connectionString = this.resolveConnectionString();
+        if (!connectionString)
+            return false;
+        try {
+            await this.runner(connectionString, "SELECT 1", 5_000);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
 // ─── DataSourceRegistry ───
 export class DataSourceRegistry {
     sources = new Map();