pulseed 0.0.1 → 0.1.1

package/dist/knowledge/learning-feedback.js

@@ -0,0 +1,183 @@
+import { randomUUID } from "node:crypto";
+import { StructuralFeedbackSchema, StructuralFeedbackTypeEnum, } from "../types/learning.js";
+// ─── Persistence helpers ───
+export async function getStructuralFeedback(deps, goalId) {
+    const raw = await deps.stateManager.readRaw(`learning/${goalId}_structural_feedback.json`);
+    if (!raw || !Array.isArray(raw))
+        return [];
+    try {
+        return raw.map((item) => StructuralFeedbackSchema.parse(item));
+    }
+    catch {
+        return [];
+    }
+}
+// ─── recordStructuralFeedback ───
+/**
+ * Record a structural feedback entry for a goal/iteration.
+ * Validates with Zod and persists via StateManager.
+ */
+export async function recordStructuralFeedback(deps, feedback) {
+    const validated = StructuralFeedbackSchema.parse(feedback);
+    const existing = await getStructuralFeedback(deps, validated.goalId);
+    existing.push(validated);
+    await deps.stateManager.writeRaw(`learning/${validated.goalId}_structural_feedback.json`, existing);
+}
+// ─── aggregateFeedback ───
+/**
+ * Aggregate structural feedback for a goal, optionally filtered by type.
+ * Calculates averageDelta, recent trend (last 10 vs previous 10), and worst area.
+ */
+export async function aggregateFeedback(deps, goalId, feedbackType) {
+    const all = await getStructuralFeedback(deps, goalId);
+    const types = feedbackType
+        ? [feedbackType]
+        : StructuralFeedbackTypeEnum.options;
+    const results = [];
+    for (const type of types) {
+        const entries = all.filter((f) => f.feedbackType === type);
+        if (entries.length === 0)
+            continue;
+        const totalCount = entries.length;
+        const averageDelta = entries.reduce((sum, e) => sum + e.delta, 0) / totalCount;
+        // Sort by timestamp for trend calculation
+        const sorted = [...entries].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        // Compare last 10 vs previous 10
+        const recent = sorted.slice(-10);
+        const previous = sorted.slice(-20, -10);
+        let recentTrend = "stable";
+        if (previous.length > 0 && recent.length > 0) {
+            const recentAvg = recent.reduce((sum, e) => sum + e.delta, 0) / recent.length;
+            const prevAvg = previous.reduce((sum, e) => sum + e.delta, 0) / previous.length;
+            const diff = recentAvg - prevAvg;
+            if (diff > 0.05) {
+                recentTrend = "improving";
+            }
+            else if (diff < -0.05) {
+                recentTrend = "degrading";
+            }
+        }
+        // Worst area: find the context key or dimension with lowest average delta
+        const areaDeltas = new Map();
+        for (const entry of entries) {
+            const areaKeys = Object.keys(entry.context);
+            if (areaKeys.length > 0) {
+                for (const key of areaKeys) {
+                    const existing = areaDeltas.get(key) ?? [];
+                    existing.push(entry.delta);
+                    areaDeltas.set(key, existing);
+                }
+            }
+            else {
+                const existing = areaDeltas.get(entry.iterationId) ?? [];
+                existing.push(entry.delta);
+                areaDeltas.set(entry.iterationId, existing);
+            }
+        }
+        let worstArea = "unknown";
+        let worstAvg = Infinity;
+        for (const [area, deltas] of areaDeltas) {
+            const avg = deltas.reduce((s, d) => s + d, 0) / deltas.length;
+            if (avg < worstAvg) {
+                worstAvg = avg;
+                worstArea = area;
+            }
+        }
+        results.push({
+            feedbackType: type,
+            totalCount,
+            averageDelta,
+            recentTrend,
+            worstArea,
+        });
+    }
+    return results;
+}
+// ─── autoTuneParameters ───
+/**
+ * Analyze feedback history and suggest parameter adjustments.
+ * Only suggests when basedOnFeedbackCount >= 5 and confidence >= 0.6.
+ */
+export async function autoTuneParameters(deps, goalId) {
+    const all = await getStructuralFeedback(deps, goalId);
+    const suggestions = [];
+    const typeGroups = new Map();
+    for (const entry of all) {
+        const existing = typeGroups.get(entry.feedbackType) ?? [];
+        existing.push(entry);
+        typeGroups.set(entry.feedbackType, existing);
+    }
+    for (const [type, entries] of typeGroups) {
+        if (entries.length < 5)
+            continue;
+        const avgDelta = entries.reduce((sum, e) => sum + e.delta, 0) / entries.length;
+        // Confidence based on consistency: proportion with same sign as average
+        const sameSign = entries.filter((e) => avgDelta >= 0 ? e.delta >= 0 : e.delta < 0).length;
+        const confidence = sameSign / entries.length;
+        if (confidence < 0.6)
+            continue;
+        switch (type) {
+            case "observation_accuracy": {
+                const currentValue = deps.config.min_confidence_threshold;
+                const adjustment = avgDelta < 0 ? 0.05 : -0.05;
+                const suggestedValue = Math.min(1, Math.max(0, currentValue + adjustment));
+                suggestions.push({
+                    parameterId: `param_confidence_threshold_${goalId}`,
+                    parameterName: "min_confidence_threshold",
+                    currentValue,
+                    suggestedValue,
+                    confidence,
+                    basedOnFeedbackCount: entries.length,
+                    feedbackType: type,
+                });
+                break;
+            }
+            case "strategy_selection": {
+                const currentValue = 0.5;
+                const suggestedValue = avgDelta < 0 ? 0.3 : 0.7;
+                suggestions.push({
+                    parameterId: `param_strategy_weight_${goalId}`,
+                    parameterName: "strategy_exploitation_weight",
+                    currentValue,
+                    suggestedValue,
+                    confidence,
+                    basedOnFeedbackCount: entries.length,
+                    feedbackType: type,
+                });
+                break;
+            }
+            case "scope_sizing": {
+                const currentValue = 1.0;
+                const suggestedValue = avgDelta < 0 ? 0.7 : 1.2;
+                suggestions.push({
+                    parameterId: `param_task_granularity_${goalId}`,
+                    parameterName: "task_granularity_multiplier",
+                    currentValue,
+                    suggestedValue,
+                    confidence,
+                    basedOnFeedbackCount: entries.length,
+                    feedbackType: type,
+                });
+                break;
+            }
+            case "task_generation": {
+                const currentValue = 0.5;
+                const suggestedValue = avgDelta < 0 ? 0.2 : 0.8;
+                suggestions.push({
+                    parameterId: `param_template_reuse_${goalId}`,
+                    parameterName: "task_template_reuse_weight",
+                    currentValue,
+                    suggestedValue,
+                    confidence,
+                    basedOnFeedbackCount: entries.length,
+                    feedbackType: type,
+                });
+                break;
+            }
+        }
+    }
+    return suggestions;
+}
+// re-export randomUUID for use in learning-cross-goal
+export { randomUUID };
+//# sourceMappingURL=learning-feedback.js.map

package/dist/knowledge/learning-feedback.js.map

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

package/dist/knowledge/learning-pipeline-prompts.d.ts

@@ -0,0 +1,134 @@
+import { z } from "zod";
+import type { LearningTrigger } from "../types/learning.js";
+export declare const TripletSchema: z.ZodObject<{
+    state_context: z.ZodString;
+    action_taken: z.ZodString;
+    outcome: z.ZodString;
+    gap_delta: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    outcome: string;
+    state_context: string;
+    action_taken: string;
+    gap_delta: number;
+}, {
+    outcome: string;
+    state_context: string;
+    action_taken: string;
+    gap_delta: number;
+}>;
+export type Triplet = z.infer<typeof TripletSchema>;
+export declare const TripletsResponseSchema: z.ZodObject<{
+    triplets: z.ZodArray<z.ZodObject<{
+        state_context: z.ZodString;
+        action_taken: z.ZodString;
+        outcome: z.ZodString;
+        gap_delta: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        outcome: string;
+        state_context: string;
+        action_taken: string;
+        gap_delta: number;
+    }, {
+        outcome: string;
+        state_context: string;
+        action_taken: string;
+        gap_delta: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    triplets: {
+        outcome: string;
+        state_context: string;
+        action_taken: string;
+        gap_delta: number;
+    }[];
+}, {
+    triplets: {
+        outcome: string;
+        state_context: string;
+        action_taken: string;
+        gap_delta: number;
+    }[];
+}>;
+export declare const PatternItemSchema: z.ZodObject<{
+    description: z.ZodString;
+    pattern_type: z.ZodEnum<["observation_accuracy", "strategy_selection", "scope_sizing", "task_generation"]>;
+    action_group: z.ZodString;
+    applicable_domains: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    occurrence_count: z.ZodNumber;
+    consistent_count: z.ZodNumber;
+    total_count: z.ZodNumber;
+    is_specific: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    total_count: number;
+    applicable_domains: string[];
+    pattern_type: "task_generation" | "strategy_selection" | "observation_accuracy" | "scope_sizing";
+    action_group: string;
+    occurrence_count: number;
+    consistent_count: number;
+    is_specific: boolean;
+}, {
+    description: string;
+    total_count: number;
+    pattern_type: "task_generation" | "strategy_selection" | "observation_accuracy" | "scope_sizing";
+    action_group: string;
+    occurrence_count: number;
+    consistent_count: number;
+    is_specific: boolean;
+    applicable_domains?: string[] | undefined;
+}>;
+export declare const PatternsResponseSchema: z.ZodObject<{
+    patterns: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        pattern_type: z.ZodEnum<["observation_accuracy", "strategy_selection", "scope_sizing", "task_generation"]>;
+        action_group: z.ZodString;
+        applicable_domains: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        occurrence_count: z.ZodNumber;
+        consistent_count: z.ZodNumber;
+        total_count: z.ZodNumber;
+        is_specific: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        total_count: number;
+        applicable_domains: string[];
+        pattern_type: "task_generation" | "strategy_selection" | "observation_accuracy" | "scope_sizing";
+        action_group: string;
+        occurrence_count: number;
+        consistent_count: number;
+        is_specific: boolean;
+    }, {
+        description: string;
+        total_count: number;
+        pattern_type: "task_generation" | "strategy_selection" | "observation_accuracy" | "scope_sizing";
+        action_group: string;
+        occurrence_count: number;
+        consistent_count: number;
+        is_specific: boolean;
+        applicable_domains?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    patterns: {
+        description: string;
+        total_count: number;
+        applicable_domains: string[];
+        pattern_type: "task_generation" | "strategy_selection" | "observation_accuracy" | "scope_sizing";
+        action_group: string;
+        occurrence_count: number;
+        consistent_count: number;
+        is_specific: boolean;
+    }[];
+}, {
+    patterns: {
+        description: string;
+        total_count: number;
+        pattern_type: "task_generation" | "strategy_selection" | "observation_accuracy" | "scope_sizing";
+        action_group: string;
+        occurrence_count: number;
+        consistent_count: number;
+        is_specific: boolean;
+        applicable_domains?: string[] | undefined;
+    }[];
+}>;
+export declare function buildExtractionPrompt(trigger: LearningTrigger, logs: unknown): string;
+export declare function buildPatternizationPrompt(triplets: Triplet[]): string;
+//# sourceMappingURL=learning-pipeline-prompts.d.ts.map

package/dist/knowledge/learning-pipeline-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-pipeline-prompts.d.ts","sourceRoot":"","sources":["../../src/knowledge/learning-pipeline-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjC,CAAC;AAIH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,OAAO,GACZ,MAAM,CAiCR;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAyCrE"}

package/dist/knowledge/learning-pipeline-prompts.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { LearnedPatternTypeEnum } from "../types/learning.js";
+// ─── LLM Response Schemas ───
+export const TripletSchema = z.object({
+    state_context: z.string(),
+    action_taken: z.string(),
+    outcome: z.string(),
+    gap_delta: z.number(),
+});
+export const TripletsResponseSchema = z.object({
+    triplets: z.array(TripletSchema),
+});
+export const PatternItemSchema = z.object({
+    description: z.string(),
+    pattern_type: LearnedPatternTypeEnum,
+    action_group: z.string(),
+    applicable_domains: z.array(z.string()).default([]),
+    occurrence_count: z.number().int().min(0),
+    consistent_count: z.number().int().min(0),
+    total_count: z.number().int().min(1),
+    is_specific: z.boolean(),
+});
+export const PatternsResponseSchema = z.object({
+    patterns: z.array(PatternItemSchema),
+});
+// ─── Prompt Builders ───
+export function buildExtractionPrompt(trigger, logs) {
+    return `Analyze the experience logs for goal "${trigger.goal_id}" and extract state→action→outcome triplets.
+
+Trigger type: ${trigger.type}
+Context: ${trigger.context}
+Timestamp: ${trigger.timestamp}
+
+Experience logs:
+${JSON.stringify(logs, null, 2)}
+
+Extract concrete triplets describing what happened. Each triplet must include:
+- state_context: the observable state when the action was taken
+- action_taken: a specific, concrete action that was executed
+- outcome: what actually happened as a result
+- gap_delta: change in goal gap (-1.0 to 1.0, negative means gap reduced/improved)
+
+IMPORTANT: Only include triplets where action_taken describes a specific, concrete action.
+Examples of ACCEPTED actions: "reduced task scope to 3 steps", "added prerequisite check at start", "estimated effort at 1.5x"
+Examples of REJECTED actions: "did something better", "made improvements", "tried harder"
+
+Output JSON:
+{
+  "triplets": [
+    {
+      "state_context": "<specific state description>",
+      "action_taken": "<concrete specific action>",
+      "outcome": "<measurable outcome>",
+      "gap_delta": <number -1.0 to 1.0>
+    }
+  ]
+}
+
+Return ONLY the JSON object, no other text.`;
+}
+export function buildPatternizationPrompt(triplets) {
+    return `Analyze the following state→action→outcome triplets and identify repeating patterns.
+
+Triplets:
+${JSON.stringify(triplets, null, 2)}
+
+For each group of similar actions, create a pattern entry. Each pattern must have:
+- description: a concrete, actionable description (must specify what to do exactly)
+- pattern_type: one of "observation_accuracy", "strategy_selection", "scope_sizing", "task_generation"
+- action_group: the common action theme across the grouped triplets
+- applicable_domains: list of domains where this pattern applies (infer from context)
+- occurrence_count: how many triplets have this action group
+- consistent_count: how many of those triplets showed consistent outcome direction (all improving or all worsening)
+- total_count: total number of triplets analyzed
+- is_specific: true if description is concrete enough to act on directly (false for vague descriptions like "do better")
+
+Pattern type mapping:
+- "observation_accuracy": patterns about how well observations matched reality
+- "strategy_selection": patterns about which strategies worked/failed in which contexts
+- "scope_sizing": patterns about task scope, size, or granularity
+- "task_generation": patterns about task structure, format, or prerequisites
+
+Only include patterns where is_specific = true AND occurrence_count >= 2.
+
+Output JSON:
+{
+  "patterns": [
+    {
+      "description": "<concrete actionable description>",
+      "pattern_type": "<type>",
+      "action_group": "<common action theme>",
+      "applicable_domains": ["<domain1>"],
+      "occurrence_count": <int>,
+      "consistent_count": <int>,
+      "total_count": <int>,
+      "is_specific": <boolean>
+    }
+  ]
+}
+
+Return ONLY the JSON object, no other text.`;
+}
+//# sourceMappingURL=learning-pipeline-prompts.js.map

package/dist/knowledge/learning-pipeline-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-pipeline-prompts.js","sourceRoot":"","sources":["../../src/knowledge/learning-pipeline-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,+BAA+B;AAE/B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,sBAAsB;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CACrC,CAAC,CAAC;AAEH,0BAA0B;AAE1B,MAAM,UAAU,qBAAqB,CACnC,OAAwB,EACxB,IAAa;IAEb,OAAO,yCAAyC,OAAO,CAAC,OAAO;;gBAEjD,OAAO,CAAC,IAAI;WACjB,OAAO,CAAC,OAAO;aACb,OAAO,CAAC,SAAS;;;EAG5B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;4CAwBa,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAmB;IAC3D,OAAO;;;EAGP,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAoCS,CAAC;AAC7C,CAAC"}

package/dist/knowledge/learning-pipeline.d.ts

@@ -0,0 +1,105 @@
+import type { ILLMClient } from "../llm/llm-client.js";
+import type { VectorIndex } from "./vector-index.js";
+import type { StateManager } from "../state-manager.js";
+import type { IPromptGateway } from "../prompt/gateway.js";
+import type { LearningTrigger, LearnedPattern, FeedbackEntry, FeedbackTargetStep, LearningPipelineConfig, StructuralFeedback, StructuralFeedbackType, ParameterTuning, FeedbackAggregation, CrossGoalPattern, PatternSharingResult } from "../types/learning.js";
+import type { StallReport } from "../types/stall.js";
+/**
+ * LearningPipeline extracts patterns from goal execution logs and
+ * applies feedback to future iterations via SessionManager context injection.
+ *
+ * File layout:
+ *   <base>/learning/<goal_id>_logs.json
+ *   <base>/learning/<goal_id>_patterns.json
+ *   <base>/learning/<goal_id>_feedback.json
+ */
+export declare class LearningPipeline {
+    private readonly llmClient;
+    private readonly vectorIndex;
+    private readonly stateManager;
+    private readonly config;
+    private knowledgeTransfer?;
+    private readonly gateway?;
+    constructor(llmClient: ILLMClient, vectorIndex: VectorIndex | null, stateManager: StateManager, config?: LearningPipelineConfig, gateway?: IPromptGateway);
+    setKnowledgeTransfer(kt: {
+        updateMetaPatternsIncremental(): Promise<number>;
+    }): void;
+    /**
+     * Called when a goal dimension reaches a milestone threshold.
+     */
+    onMilestoneReached(goalId: string, milestoneContext: string): Promise<LearnedPattern[]>;
+    /**
+     * Called when a stall is detected for a goal.
+     */
+    onStallDetected(goalId: string, stallInfo: StallReport): Promise<LearnedPattern[]>;
+    /**
+     * Called during periodic review of a goal.
+     */
+    onPeriodicReview(goalId: string): Promise<LearnedPattern[]>;
+    /**
+     * Called when a goal is marked as completed.
+     * Also triggers cross-goal pattern sharing if enabled.
+     */
+    onGoalCompleted(goalId: string): Promise<LearnedPattern[]>;
+    /**
+     * Core analysis pipeline: reads logs, extracts triplets via LLM,
+     * detects patterns, filters by confidence, and persists results.
+     */
+    analyzeLogs(trigger: LearningTrigger): Promise<LearnedPattern[]>;
+    /**
+     * Generate FeedbackEntry objects from learned patterns.
+     * Maps each pattern type to a target step and persists the feedback.
+     */
+    generateFeedback(patterns: LearnedPattern[]): Promise<FeedbackEntry[]>;
+    /**
+     * Return adjustment strings for a given goal and target step.
+     * Returns at most 3 entries sorted by confidence descending.
+     */
+    applyFeedback(goalId: string, step: FeedbackTargetStep): Promise<string[]>;
+    /**
+     * Share a pattern from its source goal to similar goals in the VectorIndex.
+     * Only runs if vectorIndex is available and cross_goal_sharing_enabled.
+     */
+    sharePatternAcrossGoals(patternId: string): Promise<void>;
+    /**
+     * Load learned patterns for a goal. Returns empty array if not found.
+     */
+    getPatterns(goalId: string): Promise<LearnedPattern[]>;
+    /**
+     * Persist learned patterns for a goal.
+     */
+    savePatterns(goalId: string, patterns: LearnedPattern[]): Promise<void>;
+    /**
+     * Load feedback entries for a goal. Returns empty array if not found.
+     */
+    getFeedbackEntries(goalId: string): Promise<FeedbackEntry[]>;
+    /**
+     * Persist feedback entries for a goal.
+     */
+    saveFeedbackEntries(goalId: string, entries: FeedbackEntry[]): Promise<void>;
+    /**
+     * Record a structural feedback entry for a goal/iteration.
+     */
+    recordStructuralFeedback(feedback: StructuralFeedback): Promise<void>;
+    /**
+     * Load structural feedback for a goal.
+     */
+    getStructuralFeedback(goalId: string): Promise<StructuralFeedback[]>;
+    /**
+     * Aggregate structural feedback for a goal, optionally filtered by type.
+     */
+    aggregateFeedback(goalId: string, feedbackType?: StructuralFeedbackType): Promise<FeedbackAggregation[]>;
+    /**
+     * Analyze feedback history and suggest parameter adjustments.
+     */
+    autoTuneParameters(goalId: string): Promise<ParameterTuning[]>;
+    /**
+     * Extract cross-goal patterns by analyzing structural feedback across multiple goals.
+     */
+    extractCrossGoalPatterns(goalIds: string[]): Promise<CrossGoalPattern[]>;
+    /**
+     * Apply cross-goal patterns to target goals as feedback insights.
+     */
+    sharePatternsAcrossGoals(patterns: CrossGoalPattern[], targetGoalIds: string[]): Promise<PatternSharingResult>;
+}
+//# sourceMappingURL=learning-pipeline.d.ts.map

package/dist/knowledge/learning-pipeline.d.ts.map

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