pi-continuous-learning 0.5.0 → 0.6.0

package/dist/observation-preprocessor.js

@@ -0,0 +1,31 @@
+/**
+ * Preprocess a single observation.
+ * Returns null if the observation should be dropped entirely.
+ * Returns a new (immutable) observation with large fields stripped if applicable.
+ */
+export function preprocessObservation(obs) {
+    if (obs.event === "turn_start" || obs.event === "tool_start") {
+        return null;
+    }
+    if (obs.event === "tool_complete" && !obs.is_error) {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const { output: _, ...stripped } = obs;
+        return stripped;
+    }
+    return obs;
+}
+/**
+ * Preprocess an array of raw observations.
+ * Drops nulls and returns only the meaningful events.
+ */
+export function preprocessObservations(observations) {
+    const result = [];
+    for (const obs of observations) {
+        const processed = preprocessObservation(obs);
+        if (processed !== null) {
+            result.push(processed);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=observation-preprocessor.js.map

package/dist/observation-preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-preprocessor.js","sourceRoot":"","sources":["../src/observation-preprocessor.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAgB;IACpD,IAAI,GAAG,CAAC,KAAK,KAAK,YAAY,IAAI,GAAG,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,eAAe,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACnD,6DAA6D;QAC7D,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,GAAG,CAAC;QACvC,OAAO,QAAuB,CAAC;IACjC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAA2B;IAChE,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/prompts/analyzer-system-single-shot.d.ts

@@ -0,0 +1,6 @@
+/**
+ * System prompt for the single-shot (non-agentic) background analyzer.
+ * Instructs the model to return a JSON change-set instead of using tool calls.
+ */
+export declare function buildSingleShotSystemPrompt(): string;
+//# sourceMappingURL=analyzer-system-single-shot.d.ts.map

package/dist/prompts/analyzer-system-single-shot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-system-single-shot.d.ts","sourceRoot":"","sources":["../../src/prompts/analyzer-system-single-shot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAsHpD"}

package/dist/prompts/analyzer-system-single-shot.js

@@ -0,0 +1,124 @@
+/**
+ * System prompt for the single-shot (non-agentic) background analyzer.
+ * Instructs the model to return a JSON change-set instead of using tool calls.
+ */
+export function buildSingleShotSystemPrompt() {
+    return `You are a coding behavior analyst. Your job is to read session observations
+and produce a JSON change-set to create or update instinct files that capture reusable coding patterns.
+
+## Output Format
+
+Return ONLY a valid JSON object (no prose, no markdown fences) with this structure:
+
+{
+  "changes": [
+    {
+      "action": "create",
+      "instinct": {
+        "id": "kebab-case-id",
+        "title": "Short title",
+        "trigger": "When this should activate",
+        "action": "What the agent should do (verb phrase)",
+        "confidence": 0.5,
+        "domain": "typescript",
+        "scope": "project",
+        "observation_count": 3,
+        "confirmed_count": 0,
+        "contradicted_count": 0,
+        "inactive_count": 0,
+        "evidence": ["brief note 1", "brief note 2"]
+      }
+    },
+    {
+      "action": "update",
+      "instinct": { "...same fields as create..." }
+    },
+    {
+      "action": "delete",
+      "id": "instinct-id-to-delete",
+      "scope": "project"
+    }
+  ]
+}
+
+Return { "changes": [] } if no changes are needed.
+
+## Pattern Detection Heuristics
+
+Analyze observations for these categories:
+
+### User Corrections
+- User rephrases a request after an agent response
+- User explicitly rejects an approach
+- Trigger: the corrected behavior; Action: the preferred approach
+
+### Error Resolutions
+- Tool call returns is_error: true followed by a successful retry
+- Trigger: the error condition; Action: the proven resolution
+
+### Repeated Workflows
+- Same sequence of tool calls appears 3+ times
+- Trigger: the workflow start condition; Action: the efficient path
+
+### Tool Preferences
+- Agent consistently uses one tool over alternatives
+- Trigger: the task type; Action: the preferred tool and parameters
+
+### Anti-Patterns
+- Actions that consistently lead to errors or user corrections
+- Trigger: the bad pattern situation; Action: what to do instead
+
+### Turn Structure
+- turn_end events summarize turns: tool_count and error_count
+- High error_count turns suggest inefficient approaches
+
+### Context Pressure
+- session_compact events signal context window pressure
+
+### User Shell Commands
+- user_bash events capture manual shell commands the user runs
+- Repeated commands after agent actions reveal verification patterns
+
+### Model Preferences
+- model_select events track when users switch models
+
+## Feedback Analysis
+
+Each observation may include an active_instincts field listing instinct IDs
+that were injected into the agent's system prompt before that turn.
+
+Use this to update existing instinct confidence scores:
+- Confirmed (+0.05): instinct was active and agent followed guidance without correction
+- Contradicted (-0.15): instinct was active but user corrected the agent
+- Inactive (no change): instinct was injected but trigger never arose
+
+When updating, increment the corresponding count field and recalculate confidence.
+
+## Confidence Scoring Rules
+
+### Initial Confidence (new instincts)
+- 1-2 observations  -> 0.3
+- 3-5 observations  -> 0.5
+- 6-10 observations -> 0.7
+- 11+ observations  -> 0.85
+
+### Clamping
+- Always clamp to [0.1, 0.9]
+
+## Scope Decision Guide
+
+Use project scope when the pattern is specific to this project's tech stack or conventions.
+Use global scope when the pattern applies universally to any coding session.
+When in doubt, prefer project scope.
+
+## Conservativeness Rules
+
+1. Only create a new instinct with 3+ clear independent observations supporting the pattern.
+2. No code snippets in the action field - plain language only.
+3. Each instinct must have one well-defined trigger.
+4. New instincts from observation data alone are capped at 0.85 confidence.
+5. Check existing instincts (provided in the user message) for duplicates before creating. Update instead.
+6. Write actions as clear instructions starting with a verb.
+7. Be skeptical of outliers - patterns seen only in unusual circumstances should not become instincts.`;
+}
+//# sourceMappingURL=analyzer-system-single-shot.js.map

package/dist/prompts/analyzer-system-single-shot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-system-single-shot.js","sourceRoot":"","sources":["../../src/prompts/analyzer-system-single-shot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGAoH8F,CAAC;AACxG,CAAC"}

package/dist/prompts/analyzer-user-single-shot.d.ts

@@ -0,0 +1,22 @@
+/**
+ * User prompt builder for the single-shot background analyzer.
+ * Includes current instincts inline (no tool calls needed) and filtered observations.
+ */
+import type { InstalledSkill, Instinct, ProjectEntry } from "../types.js";
+export interface SingleShotPromptOptions {
+    agentsMdProject?: string | null;
+    agentsMdGlobal?: string | null;
+    installedSkills?: InstalledSkill[];
+}
+/**
+ * Builds the user prompt for the single-shot analyzer.
+ * Embeds all current instincts inline so the model has full context
+ * without making any tool calls.
+ *
+ * @param project          - Project metadata
+ * @param existingInstincts - All current instincts (project + global)
+ * @param observationLines  - Preprocessed observation lines (JSONL strings)
+ * @param options           - Optional AGENTS.md content and installed skills
+ */
+export declare function buildSingleShotUserPrompt(project: ProjectEntry, existingInstincts: Instinct[], observationLines: string[], options?: SingleShotPromptOptions): string;
+//# sourceMappingURL=analyzer-user-single-shot.d.ts.map

package/dist/prompts/analyzer-user-single-shot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-user-single-shot.d.ts","sourceRoot":"","sources":["../../src/prompts/analyzer-user-single-shot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1E,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,YAAY,EACrB,iBAAiB,EAAE,QAAQ,EAAE,EAC7B,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE,uBAA4B,GACpC,MAAM,CA2DR"}

package/dist/prompts/analyzer-user-single-shot.js

@@ -0,0 +1,53 @@
+import { formatInstinctsForPrompt } from "../cli/analyze-single-shot.js";
+/**
+ * Builds the user prompt for the single-shot analyzer.
+ * Embeds all current instincts inline so the model has full context
+ * without making any tool calls.
+ *
+ * @param project          - Project metadata
+ * @param existingInstincts - All current instincts (project + global)
+ * @param observationLines  - Preprocessed observation lines (JSONL strings)
+ * @param options           - Optional AGENTS.md content and installed skills
+ */
+export function buildSingleShotUserPrompt(project, existingInstincts, observationLines, options = {}) {
+    const { agentsMdProject = null, agentsMdGlobal = null, installedSkills = [] } = options;
+    const observationBlock = observationLines.length > 0
+        ? observationLines.join("\n")
+        : "(no observations recorded yet)";
+    const instinctBlock = formatInstinctsForPrompt(existingInstincts);
+    const parts = [
+        "## Project Context",
+        "",
+        `project_id: ${project.id}`,
+        `project_name: ${project.name}`,
+        "",
+        "## Existing Instincts",
+        "",
+        instinctBlock,
+        "",
+        "## New Observations (preprocessed)",
+        "",
+        "```",
+        observationBlock,
+        "```",
+    ];
+    if (agentsMdProject != null || agentsMdGlobal != null) {
+        parts.push("", "## Existing Guidelines", "");
+        if (agentsMdProject != null) {
+            parts.push("### Project AGENTS.md", "", agentsMdProject, "");
+        }
+        if (agentsMdGlobal != null) {
+            parts.push("### Global AGENTS.md", "", agentsMdGlobal, "");
+        }
+    }
+    if (installedSkills.length > 0) {
+        parts.push("", "## Installed Skills", "");
+        for (const skill of installedSkills) {
+            parts.push(`- **${skill.name}**: ${skill.description}`);
+        }
+        parts.push("");
+    }
+    parts.push("", "## Instructions", "", "1. Review the existing instincts above.", "2. Analyze the new observations for patterns per the system prompt rules.", "3. Return a JSON change-set: create new instincts, update existing ones, or delete obsolete ones.", "4. Apply feedback analysis using the active_instincts field in each observation.", "5. Passive confidence decay has already been applied before this analysis.", "", "Return ONLY the JSON object. No prose, no markdown fences.");
+    return parts.join("\n");
+}
+//# sourceMappingURL=analyzer-user-single-shot.js.map

package/dist/prompts/analyzer-user-single-shot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-user-single-shot.js","sourceRoot":"","sources":["../../src/prompts/analyzer-user-single-shot.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAQzE;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAqB,EACrB,iBAA6B,EAC7B,gBAA0B,EAC1B,UAAmC,EAAE;IAErC,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,cAAc,GAAG,IAAI,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAExF,MAAM,gBAAgB,GACpB,gBAAgB,CAAC,MAAM,GAAG,CAAC;QACzB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,CAAC,CAAC,gCAAgC,CAAC;IAEvC,MAAM,aAAa,GAAG,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;IAElE,MAAM,KAAK,GAAa;QACtB,oBAAoB;QACpB,EAAE;QACF,eAAe,OAAO,CAAC,EAAE,EAAE;QAC3B,iBAAiB,OAAO,CAAC,IAAI,EAAE;QAC/B,EAAE;QACF,uBAAuB;QACvB,EAAE;QACF,aAAa;QACb,EAAE;QACF,oCAAoC;QACpC,EAAE;QACF,KAAK;QACL,gBAAgB;QAChB,KAAK;KACN,CAAC;IAEF,IAAI,eAAe,IAAI,IAAI,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,iBAAiB,EACjB,EAAE,EACF,yCAAyC,EACzC,2EAA2E,EAC3E,mGAAmG,EACnG,kFAAkF,EAClF,4EAA4E,EAC5E,EAAE,EACF,4DAA4D,CAC7D,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/prompts/analyzer-user.d.ts

@@ -15,8 +15,10 @@ export declare function tailObservations(observationsPath: string, maxEntries?:
 export interface TailSinceResult {
     lines: string[];
     totalLineCount: number;
+    /** Number of raw new lines before preprocessing. */
+    rawLineCount: number;
 }
-export declare function tailObservationsSince(observationsPath: string, sinceLineCount: number, maxEntries?: number): TailSinceResult;
+export declare function tailObservationsSince(observationsPath: string, sinceLineCount: number, maxEntries?: number, preprocess?: boolean): TailSinceResult;
 export interface AnalyzerUserPromptOptions {
     agentsMdProject?: string | null;
     agentsMdGlobal?: string | null;

package/dist/prompts/analyzer-user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzer-user.d.ts","sourceRoot":"","sources":["../../src/prompts/analyzer-user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,UAAU,SAAmB,GAC5B,MAAM,EAAE,CAUV;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,UAAU,SAAmB,GAC5B,eAAe,CAoBjB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAmER"}
+{"version":3,"file":"analyzer-user.d.ts","sourceRoot":"","sources":["../../src/prompts/analyzer-user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAe,YAAY,EAAE,MAAM,aAAa,CAAC;AAM7E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,UAAU,SAAmB,GAC5B,MAAM,EAAE,CAUV;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,UAAU,SAAmB,EAC7B,UAAU,UAAO,GAChB,eAAe,CAkCjB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAmER"}

package/dist/prompts/analyzer-user.js

@@ -4,6 +4,7 @@
  * to locate observations and instinct files for the current project.
  */
 import { existsSync, readFileSync } from "node:fs";
+import { preprocessObservations } from "../observation-preprocessor.js";
 /** Maximum number of observation lines to include in analysis. */
 const MAX_TAIL_ENTRIES = 500;
 /**
@@ -24,9 +25,9 @@ export function tailObservations(observationsPath, maxEntries = MAX_TAIL_ENTRIES
         .filter((l) => l.length > 0);
     return lines.slice(-maxEntries);
 }
-export function tailObservationsSince(observationsPath, sinceLineCount, maxEntries = MAX_TAIL_ENTRIES) {
+export function tailObservationsSince(observationsPath, sinceLineCount, maxEntries = MAX_TAIL_ENTRIES, preprocess = true) {
     if (!existsSync(observationsPath)) {
-        return { lines: [], totalLineCount: 0 };
+        return { lines: [], totalLineCount: 0, rawLineCount: 0 };
     }
     const content = readFileSync(observationsPath, "utf-8");
     const allLines = content
@@ -36,11 +37,23 @@ export function tailObservationsSince(observationsPath, sinceLineCount, maxEntri
     const totalLineCount = allLines.length;
     // If file was archived/reset (fewer lines than cursor), treat as fresh
     const effectiveSince = totalLineCount < sinceLineCount ? 0 : sinceLineCount;
-    const newLines = allLines.slice(effectiveSince);
-    return {
-        lines: newLines.slice(-maxEntries),
-        totalLineCount,
-    };
+    const newLines = allLines.slice(effectiveSince).slice(-maxEntries);
+    const rawLineCount = newLines.length;
+    if (!preprocess) {
+        return { lines: newLines, totalLineCount, rawLineCount };
+    }
+    const parsed = [];
+    for (const line of newLines) {
+        try {
+            parsed.push(JSON.parse(line));
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    const filtered = preprocessObservations(parsed);
+    const lines = filtered.map((obs) => JSON.stringify(obs));
+    return { lines, totalLineCount, rawLineCount };
 }
 /**
  * Builds the user prompt for the background Haiku analyzer.

package/dist/prompts/analyzer-user.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-continuous-learning",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A Pi extension that observes coding sessions and distills patterns into reusable instincts.",
   "type": "module",
   "license": "MIT",

package/src/cli/analyze-single-shot.ts

@@ -0,0 +1,145 @@
+/**
+ * Single-shot (non-agentic) analyzer core.
+ *
+ * Replaces the multi-turn agentic session with a single complete() call.
+ * The model receives all current instincts inline and returns a JSON change-set.
+ * Changes are applied client-side, eliminating the ~16x cache-read multiplier.
+ */
+import type { AssistantMessage, Context } from "@mariozechner/pi-ai";
+import { complete } from "@mariozechner/pi-ai";
+import type { Instinct } from "../types.js";
+import { serializeInstinct } from "../instinct-parser.js";
+
+export interface InstinctChangePayload {
+  id: string;
+  title: string;
+  trigger: string;
+  action: string;
+  confidence: number;
+  domain: string;
+  scope: "project" | "global";
+  observation_count?: number;
+  confirmed_count?: number;
+  contradicted_count?: number;
+  inactive_count?: number;
+  evidence?: string[];
+}
+
+export interface InstinctChange {
+  action: "create" | "update" | "delete";
+  instinct?: InstinctChangePayload;
+  /** For delete: the instinct ID to remove. */
+  id?: string;
+  /** For delete: the scope to target. */
+  scope?: "project" | "global";
+}
+
+export interface SingleShotResult {
+  changes: InstinctChange[];
+  message: AssistantMessage;
+}
+
+/**
+ * Parses the model's raw text response into an array of InstinctChange.
+ * Strips markdown code fences if present. Throws on invalid JSON or schema.
+ */
+export function parseChanges(raw: string): InstinctChange[] {
+  const stripped = raw
+    .replace(/^```(?:json)?\s*/i, "")
+    .replace(/\s*```\s*$/, "")
+    .trim();
+
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(stripped);
+  } catch (e) {
+    throw new Error(
+      `Analyzer returned invalid JSON: ${String(e)}\nRaw: ${raw.slice(0, 200)}`
+    );
+  }
+
+  if (
+    typeof parsed !== "object" ||
+    parsed === null ||
+    !Array.isArray((parsed as { changes?: unknown }).changes)
+  ) {
+    throw new Error(
+      `Analyzer response missing 'changes' array. Got: ${JSON.stringify(parsed).slice(0, 200)}`
+    );
+  }
+
+  return (parsed as { changes: InstinctChange[] }).changes;
+}
+
+/**
+ * Builds a full Instinct from a create/update change.
+ * Returns null for delete changes or changes with missing instinct data.
+ */
+export function buildInstinctFromChange(
+  change: InstinctChange,
+  existing: Instinct | null,
+  projectId: string
+): Instinct | null {
+  if (change.action === "delete" || !change.instinct) {
+    return null;
+  }
+
+  const now = new Date().toISOString();
+  const payload = change.instinct;
+
+  return {
+    id: payload.id,
+    title: payload.title,
+    trigger: payload.trigger,
+    action: payload.action,
+    confidence: Math.max(0.1, Math.min(0.9, payload.confidence)),
+    domain: payload.domain,
+    scope: payload.scope,
+    source: "personal",
+    ...(payload.scope === "project" ? { project_id: projectId } : {}),
+    created_at: existing?.created_at ?? now,
+    updated_at: now,
+    observation_count: payload.observation_count ?? 1,
+    confirmed_count: payload.confirmed_count ?? 0,
+    contradicted_count: payload.contradicted_count ?? 0,
+    inactive_count: payload.inactive_count ?? 0,
+    ...(payload.evidence !== undefined ? { evidence: payload.evidence } : {}),
+  };
+}
+
+/**
+ * Formats existing instincts as serialized markdown blocks for inline context.
+ */
+export function formatInstinctsForPrompt(instincts: Instinct[]): string {
+  if (instincts.length === 0) {
+    return "(no existing instincts)";
+  }
+  return instincts.map((i) => serializeInstinct(i)).join("\n---\n");
+}
+
+/**
+ * Runs a single complete() call with the provided context.
+ * Returns parsed changes and the raw AssistantMessage (for usage stats).
+ */
+export async function runSingleShot(
+  context: Context,
+  model: Parameters<typeof complete>[0],
+  apiKey: string,
+  signal?: AbortSignal
+): Promise<SingleShotResult> {
+  const opts: Parameters<typeof complete>[2] = { apiKey };
+  if (signal !== undefined) opts.signal = signal;
+  const message = await complete(model, context, opts);
+
+  const textContent = message.content
+    .filter((c) => c.type === "text")
+    .map((c) => (c as { type: "text"; text: string }).text)
+    .join("");
+
+  if (!textContent.trim()) {
+    throw new Error("Analyzer returned empty response");
+  }
+
+  const changes = parseChanges(textContent);
+  return { changes, message };
+}