pulseed 0.0.1 → 0.1.1

package/dist/learning-pipeline.d.ts

@@ -0,0 +1,107 @@
+import type { ILLMClient } from "./llm/llm-client.js";
+import type { VectorIndex } from "./vector-index.js";
+import type { StateManager } from "./state-manager.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;
+    constructor(llmClient: ILLMClient, vectorIndex: VectorIndex | null, stateManager: StateManager, config?: LearningPipelineConfig);
+    /**
+     * 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[]): 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): 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): LearnedPattern[];
+    /**
+     * Persist learned patterns for a goal.
+     */
+    savePatterns(goalId: string, patterns: LearnedPattern[]): void;
+    /**
+     * Load feedback entries for a goal. Returns empty array if not found.
+     */
+    getFeedbackEntries(goalId: string): FeedbackEntry[];
+    /**
+     * Persist feedback entries for a goal.
+     */
+    saveFeedbackEntries(goalId: string, entries: FeedbackEntry[]): void;
+    /**
+     * Record a structural feedback entry for a goal/iteration.
+     * Validates with Zod and persists via StateManager.
+     */
+    recordStructuralFeedback(feedback: StructuralFeedback): void;
+    /**
+     * Load structural feedback for a goal.
+     */
+    getStructuralFeedback(goalId: string): StructuralFeedback[];
+    /**
+     * Aggregate structural feedback for a goal, optionally filtered by type.
+     * Calculates averageDelta, recent trend (last 10 vs previous 10), and worst area.
+     */
+    aggregateFeedback(goalId: string, feedbackType?: StructuralFeedbackType): FeedbackAggregation[];
+    /**
+     * Analyze feedback history and suggest parameter adjustments.
+     * Only suggests when basedOnFeedbackCount >= 5 and confidence >= 0.6.
+     */
+    autoTuneParameters(goalId: string): ParameterTuning[];
+    /**
+     * Extract cross-goal patterns by analyzing structural feedback across multiple goals.
+     * A pattern is identified when the same feedbackType appears with similar delta values
+     * (within ±0.2) across 2 or more goals.
+     */
+    extractCrossGoalPatterns(goalIds: string[]): CrossGoalPattern[];
+    /**
+     * Apply cross-goal patterns to target goals as feedback insights.
+     * For each target goal, patterns whose applicableConditions match the goal's
+     * feedback context keys are applied.
+     */
+    sharePatternsAcrossGoals(patterns: CrossGoalPattern[], targetGoalIds: string[]): PatternSharingResult;
+    private _buildSuggestedAction;
+}
+//# sourceMappingURL=learning-pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learning-pipeline.d.ts","sourceRoot":"","sources":["../src/learning-pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYvD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAoHpD;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAL/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAG7B,SAAS,EAAE,UAAU,EACrB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,YAAY,EAAE,YAAY,EAC3C,MAAM,CAAC,EAAE,sBAAsB;IAOjC;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC;IAc5B;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,WAAW,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC;IAc5B;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAcjE;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA0BhE;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA6HtE;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE;IA4C7D;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE;IAsBjE;;;OAGG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0F/D;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAU7C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI;IAI9D;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;IAUnD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI;IAMnE;;;OAGG;IACH,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAU5D;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAc3D;;;OAGG;IACH,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,sBAAsB,GACpC,mBAAmB,EAAE;IAgFxB;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IA0GrD;;;;OAIG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE;IA2G/D;;;;OAIG;IACH,wBAAwB,CACtB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,aAAa,EAAE,MAAM,EAAE,GACtB,oBAAoB;IAiEvB,OAAO,CAAC,qBAAqB;CAuB9B"}