pulseed 0.4.17 → 0.4.19

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

@@ -0,0 +1,180 @@
+import { randomUUID } from "node:crypto";
+import { extractJSON } from "../../../base/llm/llm-client.js";
+import { CrossGoalPatternSchema } from "../../../base/types/learning.js";
+import { MetaPatternsResponseSchema, buildMetaPatternPrompt, buildIncrementalMetaPatternPrompt, } from "./knowledge-transfer-prompts.js";
+// ─── buildCrossGoalKnowledgeBase ───
+/**
+ * Aggregate all LearnedPatterns across all goals and extract
+ * cross-domain meta-patterns via LLM.
+ *
+ * Stores meta-patterns in VectorIndex.
+ */
+export async function buildCrossGoalKnowledgeBase(deps) {
+    const allGoalIds = await deps.stateManager.listGoalIds();
+    // Collect all high-confidence patterns
+    const highConfidencePatterns = [];
+    for (const goalId of allGoalIds) {
+        const patterns = await deps.learningPipeline.getPatterns(goalId);
+        for (const pattern of patterns) {
+            if (pattern.confidence >= 0.6) {
+                highConfidencePatterns.push(pattern);
+            }
+        }
+    }
+    if (highConfidencePatterns.length === 0) {
+        return;
+    }
+    // Use LLM to extract cross-domain meta-patterns
+    try {
+        const metaPrompt = buildMetaPatternPrompt(highConfidencePatterns);
+        let metaParsed;
+        if (deps.gateway) {
+            metaParsed = await deps.gateway.execute({
+                purpose: "knowledge_transfer_meta_patterns",
+                additionalContext: { meta_pattern_prompt: metaPrompt },
+                responseSchema: MetaPatternsResponseSchema,
+                maxTokens: 2048,
+            });
+        }
+        else {
+            const metaResponse = await deps.llmClient.sendMessage([{ role: "user", content: metaPrompt }], { max_tokens: 2048 });
+            const metaJson = extractJSON(metaResponse.content);
+            const metaRaw = JSON.parse(metaJson);
+            metaParsed = MetaPatternsResponseSchema.parse(metaRaw);
+        }
+        // Store meta-patterns in VectorIndex for future retrieval
+        if (deps.vectorIndex === null)
+            return;
+        for (const meta of metaParsed.meta_patterns) {
+            const metaId = `meta_${randomUUID()}`;
+            try {
+                await deps.vectorIndex.add(metaId, meta.description, {
+                    type: "meta_pattern",
+                    applicable_domains: meta.applicable_domains,
+                    source_pattern_ids: meta.source_pattern_ids,
+                    created_at: new Date().toISOString(),
+                });
+            }
+            catch {
+                // non-fatal: embedding failure should not block
+            }
+        }
+    }
+    catch {
+        // non-fatal: LLM failure or parse failure
+    }
+}
+// ─── updateMetaPatternsIncremental ───
+/**
+ * Incremental meta-pattern update — processes only patterns created since last aggregation.
+ * Called by LearningPipeline after analyzeLogs() produces new patterns.
+ */
+export async function updateMetaPatternsIncremental(deps, getLastAggregatedAt, saveLastAggregatedAt) {
+    const lastTs = await getLastAggregatedAt();
+    const now = new Date().toISOString();
+    // Collect all patterns across all goals
+    const allGoalIds = await deps.stateManager.listGoalIds();
+    const allPatterns = [];
+    for (const goalId of allGoalIds) {
+        const patterns = await deps.learningPipeline.getPatterns(goalId);
+        for (const pattern of patterns) {
+            allPatterns.push(pattern);
+        }
+    }
+    // Filter to new ones since last aggregation
+    const newPatterns = lastTs
+        ? allPatterns.filter((p) => p.created_at > lastTs)
+        : allPatterns;
+    // Only high-confidence patterns
+    const highConfidence = newPatterns.filter((p) => p.confidence >= 0.6);
+    if (highConfidence.length === 0) {
+        await saveLastAggregatedAt(now);
+        return 0;
+    }
+    // Build prompt from new patterns
+    const patternDescriptions = highConfidence
+        .map((p) => `[${p.type}] ${p.description} (confidence: ${p.confidence}, domains: ${p.applicable_domains.join(",")})`)
+        .join("\n");
+    const prompt = buildIncrementalMetaPatternPrompt(patternDescriptions);
+    try {
+        let metaParsed;
+        if (deps.gateway) {
+            metaParsed = await deps.gateway.execute({
+                purpose: "knowledge_transfer_incremental",
+                additionalContext: { incremental_prompt: prompt },
+                responseSchema: MetaPatternsResponseSchema,
+                maxTokens: 1024,
+            });
+        }
+        else {
+            const response = await deps.llmClient.sendMessage([{ role: "user", content: prompt }], { max_tokens: 1024 });
+            const metaJson = extractJSON(response.content);
+            const metaRaw = JSON.parse(metaJson);
+            metaParsed = MetaPatternsResponseSchema.parse(metaRaw);
+        }
+        // Register in VectorIndex (if available)
+        let registered = 0;
+        if (deps.vectorIndex !== null) {
+            for (const mp of metaParsed.meta_patterns) {
+                if (!mp.description)
+                    continue;
+                const metaId = `meta_${randomUUID()}`;
+                try {
+                    await deps.vectorIndex.add(metaId, mp.description, {
+                        type: "meta_pattern",
+                        applicable_domains: mp.applicable_domains ?? [],
+                        source_pattern_ids: mp.source_pattern_ids ?? [],
+                        created_at: now,
+                    });
+                }
+                catch {
+                    // non-fatal: embedding failure should not block
+                }
+                registered++;
+            }
+        }
+        await saveLastAggregatedAt(now);
+        return registered;
+    }
+    catch {
+        // non-fatal: LLM failure or parse failure
+        await saveLastAggregatedAt(now);
+        return 0;
+    }
+}
+// ─── Cross-Goal Pattern Storage ───
+/**
+ * Store a CrossGoalPattern for later retrieval.
+ * Uses VectorIndex if available.
+ */
+export function storePattern(pattern, crossGoalPatterns, vectorIndex) {
+    const validated = CrossGoalPatternSchema.parse(pattern);
+    crossGoalPatterns.set(validated.id, validated);
+    // Optionally store in VectorIndex for semantic retrieval
+    if (vectorIndex !== null) {
+        vectorIndex
+            .add(validated.id, validated.description, {
+            type: "cross_goal_pattern",
+            patternType: validated.patternType,
+            feedbackType: validated.feedbackType,
+            confidence: validated.confidence,
+        })
+            .catch(() => {
+            // non-fatal: embedding failure should not block storage
+        });
+    }
+}
+/**
+ * Retrieve stored CrossGoalPatterns, optionally filtered by feedbackType or patternType.
+ */
+export function retrievePatterns(crossGoalPatterns, filter) {
+    let results = Array.from(crossGoalPatterns.values());
+    if (filter?.feedbackType !== undefined) {
+        results = results.filter((p) => p.feedbackType === filter.feedbackType);
+    }
+    if (filter?.patternType !== undefined) {
+        results = results.filter((p) => p.patternType === filter.patternType);
+    }
+    return results;
+}
+//# sourceMappingURL=knowledge-transfer-meta.js.map

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

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

package/dist/platform/knowledge/transfer/knowledge-transfer-prompts.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import type { LearnedPattern } from "../../../base/types/learning.js";
+export declare const AdaptationResponseSchema: z.ZodObject<{
+    adaptation_description: z.ZodString;
+    adapted_content: z.ZodString;
+    success: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    adapted_content: string;
+    adaptation_description: string;
+}, {
+    success: boolean;
+    adapted_content: string;
+    adaptation_description: string;
+}>;
+export declare const MetaPatternsResponseSchema: z.ZodObject<{
+    meta_patterns: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        applicable_domains: z.ZodArray<z.ZodString, "many">;
+        source_pattern_ids: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        applicable_domains: string[];
+        source_pattern_ids: string[];
+    }, {
+        description: string;
+        applicable_domains: string[];
+        source_pattern_ids: string[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    meta_patterns: {
+        description: string;
+        applicable_domains: string[];
+        source_pattern_ids: string[];
+    }[];
+}, {
+    meta_patterns: {
+        description: string;
+        applicable_domains: string[];
+        source_pattern_ids: string[];
+    }[];
+}>;
+export declare function buildAdaptationPrompt(sourcePattern: LearnedPattern, sourceGoalId: string, targetGoalId: string): string;
+export declare function buildIncrementalMetaPatternPrompt(patternDescriptions: string): string;
+export declare function buildMetaPatternPrompt(patterns: LearnedPattern[]): string;
+//# sourceMappingURL=knowledge-transfer-prompts.d.ts.map

package/dist/platform/knowledge/transfer/knowledge-transfer-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-transfer-prompts.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/transfer/knowledge-transfer-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAItE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;EAQrC,CAAC;AAIH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CA0BR;AAED,wBAAgB,iCAAiC,CAC/C,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAER;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAgCzE"}

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

@@ -0,0 +1,75 @@
+import { z } from "zod";
+// ─── LLM Response Schemas ───
+export const AdaptationResponseSchema = z.object({
+    adaptation_description: z.string(),
+    adapted_content: z.string(),
+    success: z.boolean(),
+});
+export const MetaPatternsResponseSchema = z.object({
+    meta_patterns: z.array(z.object({
+        description: z.string(),
+        applicable_domains: z.array(z.string()),
+        source_pattern_ids: z.array(z.string()),
+    })),
+});
+// ─── Prompt Builders ───
+export function buildAdaptationPrompt(sourcePattern, sourceGoalId, targetGoalId) {
+    return `You are adapting a learned pattern from one goal context to another.
+
+Source Goal ID: ${sourceGoalId}
+Target Goal ID: ${targetGoalId}
+
+Source Pattern:
+  ID: ${sourcePattern.pattern_id}
+  Type: ${sourcePattern.type}
+  Description: ${sourcePattern.description}
+  Confidence: ${sourcePattern.confidence}
+  Applicable Domains: ${sourcePattern.applicable_domains.join(", ") || "none"}
+
+Task: Adapt this pattern so it is relevant and applicable for the target goal context.
+- Remove goal-specific details from the source
+- Generalize where needed
+- Identify if direct application is possible
+
+Respond with JSON:
+{
+  "adaptation_description": "<concise description of how the pattern was adapted for the target goal>",
+  "adapted_content": "<the adapted pattern description ready for injection into target goal context>",
+  "success": <boolean — true if adaptation is meaningful and applicable>
+}
+
+Return ONLY the JSON object, no other text.`;
+}
+export function buildIncrementalMetaPatternPrompt(patternDescriptions) {
+    return `Given these newly learned patterns, extract 1-3 cross-domain meta-patterns that could apply to other goals:\n\n${patternDescriptions}\n\nReturn JSON object: { "meta_patterns": [{ "description": string, "applicable_domains": string[], "source_pattern_ids": string[] }] }`;
+}
+export function buildMetaPatternPrompt(patterns) {
+    const patternSummaries = patterns
+        .slice(0, 50) // limit to avoid token overflow
+        .map((p) => `- [${p.type}] ${p.description} (confidence: ${p.confidence.toFixed(2)}, domains: ${p.applicable_domains.join(", ") || "general"})`)
+        .join("\n");
+    return `You are extracting cross-domain meta-patterns from a collection of learned patterns across multiple goals.
+
+Learned Patterns (${patterns.length} total, showing up to 50):
+${patternSummaries}
+
+Identify 3-7 meta-patterns that generalize across multiple learned patterns and domains.
+Each meta-pattern should:
+- Be applicable across different domains and goals
+- Abstract away goal-specific details
+- Capture universal principles about effective execution
+
+Output JSON:
+{
+  "meta_patterns": [
+    {
+      "description": "<concrete, actionable meta-pattern description>",
+      "applicable_domains": ["<domain1>", "<domain2>"],
+      "source_pattern_ids": ["<pattern_id_1>", "<pattern_id_2>"]
+    }
+  ]
+}
+
+Return ONLY the JSON object, no other text.`;
+}
+//# sourceMappingURL=knowledge-transfer-prompts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-transfer-prompts.js","sourceRoot":"","sources":["../../../../src/platform/knowledge/transfer/knowledge-transfer-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,+BAA+B;AAE/B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE;IAClC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,aAAa,EAAE,CAAC,CAAC,KAAK,CACpB,CAAC,CAAC,MAAM,CAAC;QACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACvC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACxC,CAAC,CACH;CACF,CAAC,CAAC;AAEH,0BAA0B;AAE1B,MAAM,UAAU,qBAAqB,CACnC,aAA6B,EAC7B,YAAoB,EACpB,YAAoB;IAEpB,OAAO;;kBAES,YAAY;kBACZ,YAAY;;;QAGtB,aAAa,CAAC,UAAU;UACtB,aAAa,CAAC,IAAI;iBACX,aAAa,CAAC,WAAW;gBAC1B,aAAa,CAAC,UAAU;wBAChB,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM;;;;;;;;;;;;;;4CAcjC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,mBAA2B;IAE3B,OAAO,kHAAkH,mBAAmB,0IAA0I,CAAC;AACzR,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA0B;IAC/D,MAAM,gBAAgB,GAAG,QAAQ;SAC9B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gCAAgC;SAC7C,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,iBAAiB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,CACtI;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;oBAEW,QAAQ,CAAC,MAAM;EACjC,gBAAgB;;;;;;;;;;;;;;;;;;;4CAmB0B,CAAC;AAC7C,CAAC"}

package/dist/platform/knowledge/transfer/knowledge-transfer-types.d.ts

@@ -0,0 +1,20 @@
+import type { TransferCandidate } from "../../../base/types/cross-portfolio.js";
+import type { LearnedPattern } from "../../../base/types/learning.js";
+import type { StateManager } from "../../../base/state/state-manager.js";
+export interface TransferContext {
+    candidate: TransferCandidate;
+    /** gap score at apply time (lower is better) */
+    gap_at_apply: number;
+    source_pattern: LearnedPattern | null;
+}
+/** Track consecutive neutral/negative outcomes per source pattern */
+export interface PatternEffectivenessTracker {
+    consecutive_non_positive: number;
+    invalidated: boolean;
+}
+/**
+ * Estimate the current gap for a goal.
+ * Returns 0.5 as a neutral default if goal state is unavailable.
+ */
+export declare function estimateCurrentGap(goalId: string, stateManager: StateManager): Promise<number>;
+//# sourceMappingURL=knowledge-transfer-types.d.ts.map

package/dist/platform/knowledge/transfer/knowledge-transfer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-transfer-types.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/transfer/knowledge-transfer-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC;AAED,qEAAqE;AACrE,MAAM,WAAW,2BAA2B;IAC1C,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;CACtB;AAID;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

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

@@ -0,0 +1,25 @@
+// ─── Shared Helper ───
+/**
+ * Estimate the current gap for a goal.
+ * Returns 0.5 as a neutral default if goal state is unavailable.
+ */
+export async function estimateCurrentGap(goalId, stateManager) {
+    try {
+        const raw = await stateManager.readRaw(`goals/${goalId}/state.json`);
+        if (raw && typeof raw === "object" && raw !== null) {
+            const state = raw;
+            if (typeof state["gap"] === "number") {
+                return state["gap"];
+            }
+            // Try gap_score from loop state
+            if (typeof state["gap_score"] === "number") {
+                return state["gap_score"];
+            }
+        }
+    }
+    catch {
+        // non-fatal
+    }
+    return 0.5;
+}
+//# sourceMappingURL=knowledge-transfer-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-transfer-types.js","sourceRoot":"","sources":["../../../../src/platform/knowledge/transfer/knowledge-transfer-types.ts"],"names":[],"mappings":"AAmBA,wBAAwB;AAExB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,YAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,MAAM,aAAa,CAAC,CAAC;QACrE,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,GAA8B,CAAC;YAC7C,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACrC,OAAO,KAAK,CAAC,KAAK,CAAW,CAAC;YAChC,CAAC;YACD,gCAAgC;YAChC,IAAI,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC3C,OAAO,KAAK,CAAC,WAAW,CAAW,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/platform/knowledge/transfer/knowledge-transfer.d.ts

@@ -0,0 +1,100 @@
+import type { ILLMClient } from "../../../base/llm/llm-client.js";
+import type { IPromptGateway } from "../../../prompt/gateway.js";
+import type { KnowledgeManager } from "../knowledge-manager.js";
+import type { VectorIndex } from "../vector-index.js";
+import type { LearningPipeline } from "../learning/learning-pipeline.js";
+import type { EthicsGate } from "../../traits/ethics-gate.js";
+import type { StateManager } from "../../../base/state/state-manager.js";
+import type { TransferCandidate, TransferResult, TransferEffectivenessRecord } from "../../../base/types/cross-portfolio.js";
+import type { CrossGoalPattern, StructuralFeedbackType } from "../../../base/types/learning.js";
+import { TransferTrustManager } from "./transfer-trust.js";
+/**
+ * KnowledgeTransfer implements cross-goal knowledge and strategy transfer.
+ *
+ * Phase 1 (MVP): Transfer is always suggestion-only.
+ * applyTransfer() exists but should only be called after explicit user approval.
+ *
+ * Delegates to sub-modules:
+ * - knowledge-transfer-detect.ts  — candidate detection + scoring
+ * - knowledge-transfer-apply.ts   — application + ethics gating
+ * - knowledge-transfer-evaluate.ts — effectiveness evaluation + trust update
+ * - knowledge-transfer-meta.ts    — meta-pattern aggregation (batch + incremental)
+ *
+ * State is kept in-memory and mirrored to a persisted snapshot so other
+ * processes can read transfer history without sharing process-local memory.
+ */
+export declare class KnowledgeTransfer {
+    private static readonly SNAPSHOT_PATH;
+    private readonly detectDeps;
+    private readonly applyDeps;
+    private readonly metaDeps;
+    private readonly transferTrust;
+    /** In-memory candidate store: candidate_id → TransferCandidate */
+    private readonly candidates;
+    /** In-memory result store: transfer_id → TransferResult */
+    private readonly results;
+    /** Context stored at apply time: transfer_id → TransferContext */
+    private readonly applyContexts;
+    /** Effectiveness records: transfer_id → TransferEffectivenessRecord */
+    private readonly effectivenessRecords;
+    /** Per-pattern consecutive non-positive outcome tracker */
+    private readonly patternTrackers;
+    /** Cross-goal pattern store: pattern id → CrossGoalPattern */
+    private readonly crossGoalPatterns;
+    /** Timestamp of last incremental meta-pattern aggregation (ISO string) */
+    private lastAggregatedAt;
+    private snapshotLoaded;
+    private snapshotLoadPromise;
+    constructor(deps: {
+        llmClient: ILLMClient;
+        knowledgeManager: KnowledgeManager;
+        vectorIndex: VectorIndex | null;
+        learningPipeline: LearningPipeline;
+        ethicsGate: EthicsGate;
+        stateManager: StateManager;
+        transferTrust?: TransferTrustManager;
+        gateway?: IPromptGateway;
+    });
+    detectTransferOpportunities(goalId: string): Promise<TransferCandidate[]>;
+    applyTransfer(candidateId: string, targetGoalId: string): Promise<TransferResult>;
+    autoApplyHighConfidenceTransfers(goalId: string): Promise<TransferCandidate[]>;
+    detectCandidatesRealtime(goalId: string): Promise<{
+        candidates: TransferCandidate[];
+        contextSnippets: string[];
+    }>;
+    evaluateTransferEffect(transferId: string): Promise<TransferEffectivenessRecord>;
+    buildCrossGoalKnowledgeBase(): Promise<void>;
+    updateMetaPatternsIncremental(): Promise<number>;
+    storePattern(pattern: CrossGoalPattern): Promise<void>;
+    retrievePatterns(filter?: {
+        feedbackType?: StructuralFeedbackType;
+        patternType?: CrossGoalPattern["patternType"];
+    }): CrossGoalPattern[];
+    getTransferCandidates(): TransferCandidate[];
+    getTransferResults(): TransferResult[];
+    getEffectivenessRecords(): TransferEffectivenessRecord[];
+    listTransferSnapshot(options?: {
+        forceRefresh?: boolean;
+    }): Promise<{
+        transfers: TransferCandidate[];
+        results: TransferResult[];
+        effectiveness_records: TransferEffectivenessRecord[];
+    }>;
+    getAppliedTransferCount(): number;
+    getTransferSuccessRate(): {
+        total: number;
+        positive: number;
+        negative: number;
+        neutral: number;
+        rate: number;
+    };
+    private static readonly SnapshotSchema;
+    private buildTransferSnapshot;
+    private ensureSnapshotLoaded;
+    refreshSnapshot(): Promise<void>;
+    private loadSnapshot;
+    private persistSnapshot;
+    private _loadLastAggregatedAt;
+    private _saveLastAggregatedAt;
+}
+//# sourceMappingURL=knowledge-transfer.d.ts.map

package/dist/platform/knowledge/transfer/knowledge-transfer.d.ts.map

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