conatus 0.1.0

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,108 @@
+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>;
+}
+export type { StructuralFeedback, StructuralFeedbackType, FeedbackAggregation, ParameterTuning, CrossGoalPattern, PatternSharingResult, } from "../types/learning.js";
+export { getStructuralFeedback, recordStructuralFeedback, aggregateFeedback, autoTuneParameters, } from "./learning-feedback.js";
+export { extractCrossGoalPatterns, sharePatternsAcrossGoals, } from "./learning-cross-goal.js";
+//# 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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"}