pi-continuous-learning 0.6.0 → 0.8.0

package/README.md

@@ -57,6 +57,7 @@ To analyze observations and create/update instincts, you need to run the analyze
 | `/instinct-export` | Export instincts to a JSON file (filterable by scope/domain) |
 | `/instinct-import <path>` | Import instincts from a JSON file |
 | `/instinct-promote [id]` | Promote project instincts to global scope |
+| `/instinct-graduate` | Graduate mature instincts to AGENTS.md, skills, or commands |
 | `/instinct-projects` | List all known projects and their instinct counts |
 
 ### LLM Tools
@@ -244,6 +245,46 @@ inactive_count: 12
 Always search with grep to find relevant context before editing files.
 ```
 
+Graduated instincts include additional fields:
+
+```yaml
+---
+id: grep-before-edit
+# ...other fields...
+graduated_to: agents-md
+graduated_at: "2026-03-27T12:00:00.000Z"
+---
+```
+
+## Instinct Quality Control
+
+Every instinct write (from the LLM tools or the background analyzer) is validated and deduplicated before being saved.
+
+### Content Validation
+
+| Rule | Details |
+|---|---|
+| Non-empty fields | `action` and `trigger` cannot be `undefined`, `null`, `"null"`, `"none"`, or empty |
+| Minimum length | Both fields must be >= 10 characters |
+| Known domain | `domain` must be in the known set: `git`, `testing`, `debugging`, `workflow`, `typescript`, `javascript`, `python`, `go`, `css`, `design`, `security`, `performance`, `documentation`, `react`, `node`, `database`, `api`, `devops`, `architecture`, or `other` |
+| Verb heuristic | `action` should start with an imperative verb - a warning is logged but the write is not rejected |
+
+### Semantic Deduplication
+
+Before a new instinct is created, a Jaccard similarity check runs against all existing instincts. Tokenize `trigger + action`, compute `|intersection| / |union|`, and block the write if any existing instinct scores >= 0.6.
+
+This prevents near-duplicate instincts from accumulating. When a similar instinct exists, the LLM is told to update the existing one instead.
+
+### Analyzer Quality Tiers
+
+The background analyzer is instructed to classify patterns before recording them:
+
+- **Project Conventions** (Tier 1): Project-specific patterns like "use Result<T,E> for errors in this codebase" → record as project-scoped instinct
+- **Workflow Patterns** (Tier 2): Universal multi-step workflows → record as global-scoped instinct
+- **Generic Agent Behavior** (Tier 3): Read-before-edit, clarify-before-implement, check-errors-after-tool-calls → **skip entirely**, these are fundamental behaviors not learned patterns
+
+The analyzer also checks AGENTS.md content before creating instincts - if a pattern is already covered by AGENTS.md, it is skipped.
+
 ## Confidence Scoring
 
 Confidence comes from two sources:
@@ -263,6 +304,39 @@ Confidence comes from two sources:
 
 This means an instinct observed 20 times but consistently contradicted in practice will lose confidence. Frequency alone doesn't equal correctness.
 
+## Instinct Graduation
+
+Instincts are designed to be short-lived - they should graduate into permanent knowledge within a few weeks. The graduation pipeline (`/instinct-graduate`) handles this lifecycle:
+
+```
+Observation -> Instinct (days) -> AGENTS.md / Skill / Command (1-2 weeks)
+```
+
+### Graduation Targets
+
+| Target | When | What happens |
+|--------|------|--------------|
+| **AGENTS.md** | Single mature instinct | Appended as a guideline entry to your project or global AGENTS.md |
+| **Skill** | 3+ related instincts in the same domain | Scaffolded into a `SKILL.md` file |
+| **Command** | 3+ workflow instincts in the same domain | Scaffolded into a slash command specification |
+
+### Maturity Criteria
+
+An instinct qualifies for graduation when all of these are met:
+- Age >= 7 days
+- Confidence >= 0.75
+- Confirmed >= 3 times
+- Contradicted <= 1 time
+- Not a duplicate of existing AGENTS.md content
+
+### TTL Enforcement
+
+Instincts that don't graduate within 28 days are subject to TTL enforcement:
+- **Confidence < 0.3**: Deleted outright
+- **Confidence >= 0.3**: Aggressively decayed (confidence halved, flagged for removal)
+
+Graduated instincts are tracked with `graduated_to` and `graduated_at` fields so they aren't left as duplicates of the knowledge they graduated into.
+
 ## Updating
 
 ```bash
@@ -296,12 +370,16 @@ Only include the fields you want to change — missing fields use the defaults a
 
 | Field | Default | Description |
 |-------|---------|-------------|
+| `run_interval_minutes` | 5 | How often the analyzer is expected to run (informational, used for decay calculations) |
 | `min_observations_to_analyze` | 20 | Minimum observations before analysis triggers |
 | `min_confidence` | 0.5 | Instincts below this are not injected into prompts |
 | `max_instincts` | 20 | Maximum instincts injected per turn |
 | `max_injection_chars` | 4000 | Character budget for the injection block (~1000 tokens) |
 | `model` | `claude-haiku-4-5` | Model for the background analyzer (lightweight models recommended to minimize cost) |
 | `timeout_seconds` | 120 | Per-project timeout for the analyzer LLM session |
+| `active_hours_start` | 8 | Hour (0-23) at which the active observation window starts |
+| `active_hours_end` | 23 | Hour (0-23) at which the active observation window ends |
+| `max_idle_seconds` | 1800 | Seconds of inactivity before a session is considered idle |
 | `log_path` | `~/.pi/continuous-learning/analyzer.log` | Path to the analyzer log file |
 
 ## Storage

package/dist/agents-md.d.ts

@@ -1,7 +1,8 @@
 /**
- * Utility for reading AGENTS.md files.
- * Provides a safe wrapper around filesystem access that returns null on any failure.
+ * Utility for reading and writing AGENTS.md files.
+ * Provides safe wrappers around filesystem access.
  */
+import type { Instinct } from "./types.js";
 /**
  * Reads an AGENTS.md file and returns its content.
  * Returns null if the file does not exist or cannot be read.
@@ -9,4 +10,24 @@
  * @param filePath - Absolute path to the AGENTS.md file
  */
 export declare function readAgentsMd(filePath: string): string | null;
+/**
+ * Formats an instinct as an AGENTS.md section entry.
+ * Produces a markdown block with the instinct title as heading and
+ * trigger/action as content.
+ */
+export declare function formatInstinctAsAgentsMdEntry(instinct: Instinct): string;
+/**
+ * Generates a complete AGENTS.md diff showing proposed additions.
+ * Returns the full new content that would result from appending the entries.
+ */
+export declare function generateAgentsMdDiff(currentContent: string | null, instincts: Instinct[]): string;
+/**
+ * Appends graduated instinct entries to an AGENTS.md file.
+ * Creates the file and parent directories if they don't exist.
+ *
+ * @param filePath - Absolute path to AGENTS.md
+ * @param instincts - Instincts to append as entries
+ * @returns The new file content that was written
+ */
+export declare function appendToAgentsMd(filePath: string, instincts: Instinct[]): string;
 //# sourceMappingURL=agents-md.d.ts.map

package/dist/agents-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5D"}
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAUxE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,SAAS,EAAE,QAAQ,EAAE,GACpB,MAAM,CAmBR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,QAAQ,EAAE,GACpB,MAAM,CAUR"}

package/dist/agents-md.js

@@ -1,8 +1,9 @@
 /**
- * Utility for reading AGENTS.md files.
- * Provides a safe wrapper around filesystem access that returns null on any failure.
+ * Utility for reading and writing AGENTS.md files.
+ * Provides safe wrappers around filesystem access.
  */
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
 /**
  * Reads an AGENTS.md file and returns its content.
  * Returns null if the file does not exist or cannot be read.
@@ -20,4 +21,58 @@ export function readAgentsMd(filePath) {
         return null;
     }
 }
+/**
+ * Formats an instinct as an AGENTS.md section entry.
+ * Produces a markdown block with the instinct title as heading and
+ * trigger/action as content.
+ */
+export function formatInstinctAsAgentsMdEntry(instinct) {
+    const lines = [
+        `### ${instinct.title}`,
+        "",
+        `**When:** ${instinct.trigger}`,
+        "",
+        instinct.action,
+        "",
+    ];
+    return lines.join("\n");
+}
+/**
+ * Generates a complete AGENTS.md diff showing proposed additions.
+ * Returns the full new content that would result from appending the entries.
+ */
+export function generateAgentsMdDiff(currentContent, instincts) {
+    const entries = instincts.map(formatInstinctAsAgentsMdEntry);
+    const graduatedSection = [
+        "",
+        "## Graduated Instincts",
+        "",
+        ...entries,
+    ].join("\n");
+    if (currentContent === null || currentContent.trim().length === 0) {
+        return `# Project Guidelines\n${graduatedSection}\n`;
+    }
+    // If the section already exists, append to it; otherwise add a new section
+    if (currentContent.includes("## Graduated Instincts")) {
+        return `${currentContent.trimEnd()}\n\n${entries.join("\n")}\n`;
+    }
+    return `${currentContent.trimEnd()}\n${graduatedSection}\n`;
+}
+/**
+ * Appends graduated instinct entries to an AGENTS.md file.
+ * Creates the file and parent directories if they don't exist.
+ *
+ * @param filePath - Absolute path to AGENTS.md
+ * @param instincts - Instincts to append as entries
+ * @returns The new file content that was written
+ */
+export function appendToAgentsMd(filePath, instincts) {
+    if (instincts.length === 0)
+        return readAgentsMd(filePath) ?? "";
+    const currentContent = readAgentsMd(filePath);
+    const newContent = generateAgentsMdDiff(currentContent, instincts);
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, newContent, "utf-8");
+    return newContent;
+}
 //# sourceMappingURL=agents-md.js.map

package/dist/agents-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAkB;IAC9D,MAAM,KAAK,GAAG;QACZ,OAAO,QAAQ,CAAC,KAAK,EAAE;QACvB,EAAE;QACF,aAAa,QAAQ,CAAC,OAAO,EAAE;QAC/B,EAAE;QACF,QAAQ,CAAC,MAAM;QACf,EAAE;KACH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,cAA6B,EAC7B,SAAqB;IAErB,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC7D,MAAM,gBAAgB,GAAG;QACvB,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,GAAG,OAAO;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,cAAc,KAAK,IAAI,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,yBAAyB,gBAAgB,IAAI,CAAC;IACvD,CAAC;IAED,2EAA2E;IAC3E,IAAI,cAAc,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACtD,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAClE,CAAC;IAED,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,gBAAgB,IAAI,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,SAAqB;IAErB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEhE,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,oBAAoB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAEnE,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAE7C,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/analysis-event-log.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Append-only analysis event log with atomic rename for safe consumption.
+ *
+ * The background analyzer appends events to `analysis-events.jsonl`.
+ * The extension consumes events by atomically renaming the file to
+ * `.consumed`, reading it, then deleting it. On POSIX, rename is atomic -
+ * any in-flight appends follow the inode to the renamed file.
+ *
+ * Multiple analyzer runs can append before the extension reads. No events
+ * are lost because each run only appends; the file is never truncated by
+ * the analyzer.
+ */
+export interface InstinctChangeSummary {
+    readonly id: string;
+    readonly title: string;
+    readonly scope: "project" | "global";
+    readonly trigger?: string;
+    readonly action?: string;
+    readonly confidence_delta?: number;
+}
+export interface AnalysisEvent {
+    readonly timestamp: string;
+    readonly project_id: string;
+    readonly project_name: string;
+    readonly created: readonly InstinctChangeSummary[];
+    readonly updated: readonly InstinctChangeSummary[];
+    readonly deleted: readonly InstinctChangeSummary[];
+}
+export declare function getEventsPath(projectId: string, baseDir?: string): string;
+export declare function getConsumedPath(projectId: string, baseDir?: string): string;
+/**
+ * Appends an analysis event to the project's event log.
+ * Skips writing if nothing changed (all arrays empty).
+ * Creates the parent directory if needed.
+ */
+export declare function appendAnalysisEvent(event: AnalysisEvent, baseDir?: string): void;
+/**
+ * Atomically consumes all pending analysis events for a project.
+ *
+ * Strategy:
+ * 1. Check for orphaned `.consumed` file from a prior crash - read it first
+ * 2. Rename `analysis-events.jsonl` to `.consumed` (atomic on POSIX)
+ * 3. Read and parse all lines from `.consumed`
+ * 4. Delete `.consumed`
+ *
+ * Returns an empty array if no events exist or rename fails (e.g. file
+ * doesn't exist, or another consumer raced us).
+ */
+export declare function consumeAnalysisEvents(projectId: string, baseDir?: string): readonly AnalysisEvent[];
+//# sourceMappingURL=analysis-event-log.d.ts.map

package/dist/analysis-event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-event-log.d.ts","sourceRoot":"","sources":["../src/analysis-event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwBH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACpD;AAMD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAYhF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,SAAS,aAAa,EAAE,CA8B1B"}

package/dist/analysis-event-log.js

@@ -0,0 +1,120 @@
+/**
+ * Append-only analysis event log with atomic rename for safe consumption.
+ *
+ * The background analyzer appends events to `analysis-events.jsonl`.
+ * The extension consumes events by atomically renaming the file to
+ * `.consumed`, reading it, then deleting it. On POSIX, rename is atomic -
+ * any in-flight appends follow the inode to the renamed file.
+ *
+ * Multiple analyzer runs can append before the extension reads. No events
+ * are lost because each run only appends; the file is never truncated by
+ * the analyzer.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { getProjectDir } from "./storage.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const EVENTS_FILENAME = "analysis-events.jsonl";
+const CONSUMED_FILENAME = "analysis-events.consumed";
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+export function getEventsPath(projectId, baseDir) {
+    return join(getProjectDir(projectId, baseDir), EVENTS_FILENAME);
+}
+export function getConsumedPath(projectId, baseDir) {
+    return join(getProjectDir(projectId, baseDir), CONSUMED_FILENAME);
+}
+// ---------------------------------------------------------------------------
+// Write (analyzer side)
+// ---------------------------------------------------------------------------
+/**
+ * Appends an analysis event to the project's event log.
+ * Skips writing if nothing changed (all arrays empty).
+ * Creates the parent directory if needed.
+ */
+export function appendAnalysisEvent(event, baseDir) {
+    if (event.created.length === 0 &&
+        event.updated.length === 0 &&
+        event.deleted.length === 0) {
+        return;
+    }
+    const eventsPath = getEventsPath(event.project_id, baseDir);
+    mkdirSync(dirname(eventsPath), { recursive: true });
+    appendFileSync(eventsPath, JSON.stringify(event) + "\n", "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Read and clear (extension side)
+// ---------------------------------------------------------------------------
+/**
+ * Atomically consumes all pending analysis events for a project.
+ *
+ * Strategy:
+ * 1. Check for orphaned `.consumed` file from a prior crash - read it first
+ * 2. Rename `analysis-events.jsonl` to `.consumed` (atomic on POSIX)
+ * 3. Read and parse all lines from `.consumed`
+ * 4. Delete `.consumed`
+ *
+ * Returns an empty array if no events exist or rename fails (e.g. file
+ * doesn't exist, or another consumer raced us).
+ */
+export function consumeAnalysisEvents(projectId, baseDir) {
+    const eventsPath = getEventsPath(projectId, baseDir);
+    const consumedPath = getConsumedPath(projectId, baseDir);
+    const allEvents = [];
+    // Step 1: recover orphaned consumed file from prior crash
+    if (existsSync(consumedPath)) {
+        allEvents.push(...parseEventsFile(consumedPath));
+        safeUnlink(consumedPath);
+    }
+    // Step 2: atomically rename the events file
+    if (existsSync(eventsPath)) {
+        try {
+            renameSync(eventsPath, consumedPath);
+        }
+        catch {
+            // Rename failed (race with another consumer, or OS issue).
+            // Return whatever we recovered from step 1.
+            return allEvents;
+        }
+        // Step 3: read the renamed file
+        allEvents.push(...parseEventsFile(consumedPath));
+        // Step 4: delete consumed file
+        safeUnlink(consumedPath);
+    }
+    return allEvents;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function parseEventsFile(filePath) {
+    const events = [];
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const lines = content.split("\n").filter((line) => line.trim().length > 0);
+        for (const line of lines) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                // Skip malformed lines - don't lose other events
+            }
+        }
+    }
+    catch {
+        // File read failed - return empty
+    }
+    return events;
+}
+function safeUnlink(filePath) {
+    try {
+        if (existsSync(filePath))
+            unlinkSync(filePath);
+    }
+    catch {
+        // Best effort cleanup
+    }
+}
+//# sourceMappingURL=analysis-event-log.js.map

package/dist/analysis-event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-event-log.js","sourceRoot":"","sources":["../src/analysis-event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAwBrD,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,OAAgB;IAC/D,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAgB;IACjE,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAoB,EAAE,OAAgB;IACxE,IACE,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC1B,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC1B,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAC1B,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5D,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,OAAgB;IAEhB,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,0DAA0D;IAC1D,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;QACjD,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IAED,4CAA4C;IAC5C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;YAC3D,4CAA4C;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,gCAAgC;QAChC,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;QAEjD,+BAA+B;QAC/B,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE3E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC"}

package/dist/analysis-notification.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Extension-side notification for analysis events.
+ *
+ * On `before_agent_start`, consumes pending analysis events and shows
+ * a brief one-line notification summarizing instinct changes since the
+ * last session interaction.
+ */
+import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { type AnalysisEvent } from "./analysis-event-log.js";
+/**
+ * Aggregates multiple analysis events into a single summary line.
+ * Returns null when no changes occurred.
+ */
+export declare function formatNotification(events: readonly AnalysisEvent[]): string | null;
+/**
+ * Checks for pending analysis events and shows a notification if any exist.
+ * Safe to call on every `before_agent_start` - no-ops when there's nothing.
+ */
+export declare function checkAnalysisNotifications(ctx: ExtensionContext, projectId: string | null, baseDir?: string): void;
+//# sourceMappingURL=analysis-notification.d.ts.map

package/dist/analysis-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-notification.d.ts","sourceRoot":"","sources":["../src/analysis-notification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAMjC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,GAAG,IAAI,CAiClF;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CASN"}

package/dist/analysis-notification.js

@@ -0,0 +1,63 @@
+/**
+ * Extension-side notification for analysis events.
+ *
+ * On `before_agent_start`, consumes pending analysis events and shows
+ * a brief one-line notification summarizing instinct changes since the
+ * last session interaction.
+ */
+import { consumeAnalysisEvents, } from "./analysis-event-log.js";
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+/**
+ * Aggregates multiple analysis events into a single summary line.
+ * Returns null when no changes occurred.
+ */
+export function formatNotification(events) {
+    if (events.length === 0)
+        return null;
+    let created = 0;
+    let updated = 0;
+    let deleted = 0;
+    const createdIds = [];
+    for (const event of events) {
+        created += event.created.length;
+        updated += event.updated.length;
+        deleted += event.deleted.length;
+        for (const c of event.created) {
+            createdIds.push(c.id);
+        }
+    }
+    if (created === 0 && updated === 0 && deleted === 0)
+        return null;
+    const parts = [];
+    if (created > 0) {
+        const idList = createdIds.slice(0, 3).join(", ");
+        const suffix = createdIds.length > 3 ? ", ..." : "";
+        parts.push(`+${created} new (${idList}${suffix})`);
+    }
+    if (updated > 0) {
+        parts.push(`${updated} updated`);
+    }
+    if (deleted > 0) {
+        parts.push(`${deleted} deleted`);
+    }
+    return `[instincts] Background analysis: ${parts.join(", ")}`;
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+/**
+ * Checks for pending analysis events and shows a notification if any exist.
+ * Safe to call on every `before_agent_start` - no-ops when there's nothing.
+ */
+export function checkAnalysisNotifications(ctx, projectId, baseDir) {
+    if (!projectId)
+        return;
+    const events = consumeAnalysisEvents(projectId, baseDir);
+    const message = formatNotification(events);
+    if (message) {
+        ctx.ui.notify(message, "info");
+    }
+}
+//# sourceMappingURL=analysis-notification.js.map

package/dist/analysis-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-notification.js","sourceRoot":"","sources":["../src/analysis-notification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC;AAEjC,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgC;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,SAAS,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,oCAAoC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAqB,EACrB,SAAwB,EACxB,OAAgB;IAEhB,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3C,IAAI,OAAO,EAAE,CAAC;QACZ,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/cli/analyze-single-shot.d.ts

@@ -21,6 +21,7 @@ export interface InstinctChangePayload {
     contradicted_count?: number;
     inactive_count?: number;
     evidence?: string[];
+    last_confirmed_session?: string;
 }
 export interface InstinctChange {
     action: "create" | "update" | "delete";
@@ -41,11 +42,28 @@ export interface SingleShotResult {
 export declare function parseChanges(raw: string): InstinctChange[];
 /**
  * Builds a full Instinct from a create/update change.
- * Returns null for delete changes or changes with missing instinct data.
+ * Returns null for delete changes, changes with missing instinct data,
+ * invalid fields, or semantically duplicate actions.
+ *
+ * @param change        - The change to apply
+ * @param existing      - The existing instinct with this ID, if any
+ * @param projectId     - Project ID for scoping
+ * @param allInstincts  - All current instincts, used for dedup check on creates
+ */
+export declare function buildInstinctFromChange(change: InstinctChange, existing: Instinct | null, projectId: string, allInstincts?: Instinct[]): Instinct | null;
+/**
+ * Formats existing instincts as a compact JSON array for inline context.
+ * Reduces token usage by ~70% compared to full YAML+markdown serialization.
+ * Includes only the fields the analyzer needs to make decisions.
+ */
+export declare function formatInstinctsCompact(instincts: Instinct[]): string;
+/**
+ * Estimates the token count of a text string using a chars/token heuristic.
  */
-export declare function buildInstinctFromChange(change: InstinctChange, existing: Instinct | null, projectId: string): Instinct | null;
+export declare function estimateTokens(text: string): number;
 /**
  * Formats existing instincts as serialized markdown blocks for inline context.
+ * @deprecated Use formatInstinctsCompact for lower token usage.
  */
 export declare function formatInstinctsForPrompt(instincts: Instinct[]): string;
 /**

package/dist/cli/analyze-single-shot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-single-shot.d.ts","sourceRoot":"","sources":["../../src/cli/analyze-single-shot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CA0B1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,SAAS,EAAE,MAAM,GAChB,QAAQ,GAAG,IAAI,CA0BjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAKtE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EACrC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B"}
+{"version":3,"file":"analyze-single-shot.d.ts","sourceRoot":"","sources":["../../src/cli/analyze-single-shot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CA0B1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,QAAQ,EAAO,GAC5B,QAAQ,GAAG,IAAI,CAgGjB;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAoBpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAKtE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EACrC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B"}