pi-continuous-learning 0.3.0

package/dist/observer-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-guard.d.ts","sourceRoot":"","sources":["../src/observer-guard.ts"],"names":[],"mappings":"AAMA,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAGhE"}

package/dist/observer-guard.js

@@ -0,0 +1,13 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+const LEARNING_BASE_DIR = join(homedir(), ".pi", "continuous-learning");
+const LEARNING_BASE_DIR_PREFIX = LEARNING_BASE_DIR + "/";
+export function shouldSkipPath(filePath) {
+    return filePath === LEARNING_BASE_DIR || filePath.startsWith(LEARNING_BASE_DIR_PREFIX);
+}
+export function shouldSkipObservation(filePath) {
+    if (filePath !== undefined && shouldSkipPath(filePath))
+        return true;
+    return false;
+}
+//# sourceMappingURL=observer-guard.js.map

package/dist/observer-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-guard.js","sourceRoot":"","sources":["../src/observer-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC;AACxE,MAAM,wBAAwB,GAAG,iBAAiB,GAAG,GAAG,CAAC;AAEzD,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,QAAQ,KAAK,iBAAiB,IAAI,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACrD,IAAI,QAAQ,KAAK,SAAS,IAAI,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Project detection via git remote URL hashing.
+ * Scopes observations and instincts to the correct project.
+ */
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ProjectEntry } from "./types.js";
+/**
+ * Detect the current project by inspecting git remote URL.
+ *
+ * Resolution order:
+ *   1. git remote get-url origin  -> hash of remote URL
+ *   2. git rev-parse --show-toplevel -> hash of repo root path
+ *   3. fallback to project ID "global"
+ */
+export declare function detectProject(pi: ExtensionAPI, cwd: string): Promise<ProjectEntry>;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,CAAC,CAyCvB"}

package/dist/project.js

@@ -0,0 +1,59 @@
+/**
+ * Project detection via git remote URL hashing.
+ * Scopes observations and instincts to the correct project.
+ */
+import { createHash } from "node:crypto";
+import { basename } from "node:path";
+const GLOBAL_PROJECT_ID = "global";
+const HASH_LENGTH = 12;
+function hashString(input) {
+    return createHash("sha256").update(input).digest("hex").substring(0, HASH_LENGTH);
+}
+/**
+ * Detect the current project by inspecting git remote URL.
+ *
+ * Resolution order:
+ *   1. git remote get-url origin  -> hash of remote URL
+ *   2. git rev-parse --show-toplevel -> hash of repo root path
+ *   3. fallback to project ID "global"
+ */
+export async function detectProject(pi, cwd) {
+    const now = new Date().toISOString();
+    const name = basename(cwd);
+    // 1. Try remote URL
+    const remoteResult = await pi.exec("git", ["remote", "get-url", "origin"], { cwd });
+    if (remoteResult.code === 0) {
+        const remote = remoteResult.stdout.trim();
+        return {
+            id: hashString(remote),
+            name,
+            root: cwd,
+            remote,
+            created_at: now,
+            last_seen: now,
+        };
+    }
+    // 2. Fallback: repo root path (no remote)
+    const rootResult = await pi.exec("git", ["rev-parse", "--show-toplevel"], { cwd });
+    if (rootResult.code === 0) {
+        const root = rootResult.stdout.trim();
+        return {
+            id: hashString(root),
+            name,
+            root,
+            remote: "",
+            created_at: now,
+            last_seen: now,
+        };
+    }
+    // 3. Fallback: not in a git repo
+    return {
+        id: GLOBAL_PROJECT_ID,
+        name,
+        root: cwd,
+        remote: "",
+        created_at: now,
+        last_seen: now,
+    };
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AACnC,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAgB,EAChB,GAAW;IAEX,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE3B,oBAAoB;IACpB,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACpF,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO;YACL,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC;YACtB,IAAI;YACJ,IAAI,EAAE,GAAG;YACT,MAAM;YACN,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACnF,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC;YACpB,IAAI;YACJ,IAAI;YACJ,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,OAAO;QACL,EAAE,EAAE,iBAAiB;QACrB,IAAI;QACJ,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/prompt-observer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * User prompt and agent end observation handlers for pi-continuous-learning.
+ * Captures before_agent_start (user_prompt) and agent_end events as JSONL observations.
+ */
+import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
+export interface BeforeAgentStartEvent {
+    type: "before_agent_start";
+    prompt: string;
+    systemPrompt: string;
+}
+export interface AgentEndEvent {
+    type: "agent_end";
+}
+import type { ProjectEntry } from "./types.js";
+/**
+ * Handles before_agent_start events.
+ * Records an observation with event: user_prompt and scrubbed prompt text.
+ */
+export declare function handleBeforeAgentStart(event: BeforeAgentStartEvent, ctx: ExtensionContext, project: ProjectEntry, baseDir?: string): void;
+/**
+ * Handles agent_end events.
+ * Records an observation with event: agent_end.
+ */
+export declare function handleAgentEnd(_event: AgentEndEvent, ctx: ExtensionContext, project: ProjectEntry, baseDir?: string): void;
+//# sourceMappingURL=prompt-observer.d.ts.map

package/dist/prompt-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-observer.d.ts","sourceRoot":"","sources":["../src/prompt-observer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;CACnB;AAOD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAW5D;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAoBN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAiBN"}

package/dist/prompt-observer.js

@@ -0,0 +1,63 @@
+/**
+ * User prompt and agent end observation handlers for pi-continuous-learning.
+ * Captures before_agent_start (user_prompt) and agent_end events as JSONL observations.
+ */
+import { getCurrentActiveInstincts } from "./active-instincts.js";
+import { appendObservation } from "./observations.js";
+import { shouldSkipObservation } from "./observer-guard.js";
+import { scrubSecrets } from "./scrubber.js";
+import { logError } from "./error-logger.js";
+function getSessionId(ctx) {
+    return ctx.sessionManager.getSessionId();
+}
+function buildActiveInstincts() {
+    const ids = getCurrentActiveInstincts();
+    return ids.length > 0 ? { active_instincts: ids } : {};
+}
+/**
+ * Handles before_agent_start events.
+ * Records an observation with event: user_prompt and scrubbed prompt text.
+ */
+export function handleBeforeAgentStart(event, ctx, project, baseDir) {
+    try {
+        if (shouldSkipObservation())
+            return;
+        const input = scrubSecrets(event.prompt);
+        const observation = {
+            timestamp: new Date().toISOString(),
+            event: "user_prompt",
+            session: getSessionId(ctx),
+            project_id: project.id,
+            project_name: project.name,
+            input,
+            ...buildActiveInstincts(),
+        };
+        appendObservation(observation, project.id, baseDir);
+    }
+    catch (err) {
+        logError(project.id, "prompt-observer:handleBeforeAgentStart", err, baseDir);
+    }
+}
+/**
+ * Handles agent_end events.
+ * Records an observation with event: agent_end.
+ */
+export function handleAgentEnd(_event, ctx, project, baseDir) {
+    try {
+        if (shouldSkipObservation())
+            return;
+        const observation = {
+            timestamp: new Date().toISOString(),
+            event: "agent_end",
+            session: getSessionId(ctx),
+            project_id: project.id,
+            project_name: project.name,
+            ...buildActiveInstincts(),
+        };
+        appendObservation(observation, project.id, baseDir);
+    }
+    catch (err) {
+        logError(project.id, "prompt-observer:handleAgentEnd", err, baseDir);
+    }
+}
+//# sourceMappingURL=prompt-observer.js.map

package/dist/prompt-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-observer.js","sourceRoot":"","sources":["../src/prompt-observer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,SAAS,YAAY,CAAC,GAAqB;IACzC,OAAO,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,GAAG,GAAG,yBAAyB,EAAE,CAAC;IACxC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA4B,EAC5B,GAAqB,EACrB,OAAqB,EACrB,OAAgB;IAEhB,IAAI,CAAC;QACH,IAAI,qBAAqB,EAAE;YAAE,OAAO;QAEpC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAgB;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC;YAC1B,UAAU,EAAE,OAAO,CAAC,EAAE;YACtB,YAAY,EAAE,OAAO,CAAC,IAAI;YAC1B,KAAK;YACL,GAAG,oBAAoB,EAAE;SAC1B,CAAC;QAEF,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,wCAAwC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAqB,EACrB,GAAqB,EACrB,OAAqB,EACrB,OAAgB;IAEhB,IAAI,CAAC;QACH,IAAI,qBAAqB,EAAE;YAAE,OAAO;QAEpC,MAAM,WAAW,GAAgB;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC;YAC1B,UAAU,EAAE,OAAO,CAAC,EAAE;YACtB,YAAY,EAAE,OAAO,CAAC,IAAI;YAC1B,GAAG,oBAAoB,EAAE;SAC1B,CAAC;QAEF,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,gCAAgC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Analyzer user prompt construction.
+ * Returns the user prompt string used by the Haiku background analyzer
+ * to locate observations and instinct files for the current project.
+ */
+import type { InstalledSkill, ProjectEntry } from "../types.js";
+/**
+ * Reads the last `maxEntries` lines from a JSONL observations file.
+ * Returns an empty array if the file does not exist.
+ *
+ * @param observationsPath - Absolute path to observations.jsonl
+ * @param maxEntries - Maximum number of lines to return (default 500)
+ */
+export declare function tailObservations(observationsPath: string, maxEntries?: number): string[];
+export interface TailSinceResult {
+    lines: string[];
+    totalLineCount: number;
+}
+export declare function tailObservationsSince(observationsPath: string, sinceLineCount: number, maxEntries?: number): TailSinceResult;
+export interface AnalyzerUserPromptOptions {
+    agentsMdProject?: string | null;
+    agentsMdGlobal?: string | null;
+    installedSkills?: InstalledSkill[];
+    observationLines?: string[];
+}
+/**
+ * Builds the user prompt for the background Haiku analyzer.
+ * Includes observation and instinct file paths plus project context.
+ * Optionally includes AGENTS.md content and installed skills for deduplication.
+ * Template construction only - no subprocess I/O.
+ *
+ * @param observationsPath - Absolute path to the project's observations.jsonl
+ * @param instinctsDir     - Absolute path to the project's instincts directory
+ * @param project          - ProjectEntry with id and name
+ * @param options          - Optional AGENTS.md content and installed skills
+ */
+export declare function buildAnalyzerUserPrompt(observationsPath: string, instinctsDir: string, project: ProjectEntry, options?: AnalyzerUserPromptOptions): string;
+//# sourceMappingURL=analyzer-user.d.ts.map

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

@@ -0,0 +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"}

package/dist/prompts/analyzer-user.js

@@ -0,0 +1,105 @@
+/**
+ * Analyzer user prompt construction.
+ * Returns the user prompt string used by the Haiku background analyzer
+ * to locate observations and instinct files for the current project.
+ */
+import { existsSync, readFileSync } from "node:fs";
+/** Maximum number of observation lines to include in analysis. */
+const MAX_TAIL_ENTRIES = 500;
+/**
+ * Reads the last `maxEntries` lines from a JSONL observations file.
+ * Returns an empty array if the file does not exist.
+ *
+ * @param observationsPath - Absolute path to observations.jsonl
+ * @param maxEntries - Maximum number of lines to return (default 500)
+ */
+export function tailObservations(observationsPath, maxEntries = MAX_TAIL_ENTRIES) {
+    if (!existsSync(observationsPath)) {
+        return [];
+    }
+    const content = readFileSync(observationsPath, "utf-8");
+    const lines = content
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    return lines.slice(-maxEntries);
+}
+export function tailObservationsSince(observationsPath, sinceLineCount, maxEntries = MAX_TAIL_ENTRIES) {
+    if (!existsSync(observationsPath)) {
+        return { lines: [], totalLineCount: 0 };
+    }
+    const content = readFileSync(observationsPath, "utf-8");
+    const allLines = content
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    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,
+    };
+}
+/**
+ * Builds the user prompt for the background Haiku analyzer.
+ * Includes observation and instinct file paths plus project context.
+ * Optionally includes AGENTS.md content and installed skills for deduplication.
+ * Template construction only - no subprocess I/O.
+ *
+ * @param observationsPath - Absolute path to the project's observations.jsonl
+ * @param instinctsDir     - Absolute path to the project's instincts directory
+ * @param project          - ProjectEntry with id and name
+ * @param options          - Optional AGENTS.md content and installed skills
+ */
+export function buildAnalyzerUserPrompt(observationsPath, instinctsDir, project, options = {}) {
+    const { agentsMdProject = null, agentsMdGlobal = null, installedSkills = [], observationLines } = options;
+    const tailedLines = observationLines ?? tailObservations(observationsPath);
+    const observationBlock = tailedLines.length > 0
+        ? tailedLines.join("\n")
+        : "(no observations recorded yet)";
+    const entriesLabel = observationLines
+        ? `new observations since last analysis (up to ${MAX_TAIL_ENTRIES})`
+        : `most recent entries (up to ${MAX_TAIL_ENTRIES})`;
+    const parts = [
+        "## Analysis Task",
+        "",
+        "Analyze the following session observations and update the instinct files accordingly.",
+        "",
+        "## Project Context",
+        "",
+        `project_id: ${project.id}`,
+        `project_name: ${project.name}`,
+        "",
+        "## File Paths",
+        "",
+        `Observations file: ${observationsPath}`,
+        `Instincts directory: ${instinctsDir}`,
+        "",
+        `The following observations are ${entriesLabel}:`,
+        "",
+        "```",
+        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. Read existing instinct files from the instincts directory.", "2. Analyze the observations above for patterns following the system prompt rules.", "3. Create new instinct files or update existing ones in the instincts directory.", "4. Apply feedback analysis using the active_instincts field in each observation.", "5. Do not delete any instinct files - only create or update.", "", "Note: Passive confidence decay has already been applied to existing instincts before this analysis.");
+    return parts.join("\n");
+}
+//# sourceMappingURL=analyzer-user.js.map

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

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

package/dist/prompts/evolve-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { Instinct, InstalledSkill } from "../types.js";
+export declare function buildEvolvePrompt(instincts: Instinct[], agentsMdProject?: string | null, agentsMdGlobal?: string | null, installedSkills?: InstalledSkill[]): string;
+//# sourceMappingURL=evolve-prompt.d.ts.map

package/dist/prompts/evolve-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolve-prompt.d.ts","sourceRoot":"","sources":["../../src/prompts/evolve-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAwB5D,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,QAAQ,EAAE,EACrB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,EAC9B,eAAe,CAAC,EAAE,cAAc,EAAE,GACjC,MAAM,CAyCR"}

package/dist/prompts/evolve-prompt.js

@@ -0,0 +1,51 @@
+function summarizeInstinct(i) {
+    return {
+        id: i.id,
+        title: i.title,
+        trigger: i.trigger,
+        action: i.action,
+        confidence: i.confidence,
+        domain: i.domain,
+        scope: i.scope,
+    };
+}
+export function buildEvolvePrompt(instincts, agentsMdProject, agentsMdGlobal, installedSkills) {
+    const parts = [
+        "Analyze the following learned instincts and identify opportunities for improvement.",
+        "You have access to instinct tools (instinct_merge, instinct_delete, instinct_write) to act on your findings.",
+        "",
+        "## Instincts",
+        "",
+        "```json",
+        JSON.stringify(instincts.map(summarizeInstinct), null, 2),
+        "```",
+        "",
+        "## Analysis Tasks",
+        "",
+        "1. **Merge candidates**: Find instincts with semantically similar triggers or actions (even if worded differently). Offer to merge them using the instinct_merge tool.",
+        "2. **Duplicates of AGENTS.md**: Flag instincts already covered by the guidelines below. Offer to delete them.",
+        "3. **Promotion candidates**: Project-scoped instincts with confidence >= 0.7 that could become global.",
+        "4. **Skill shadows**: Instincts whose purpose is already served by an installed skill (listed below). Offer to delete them.",
+        "5. **Low-confidence cleanup**: Instincts with confidence < 0.3 or flagged_for_removal that should be deleted.",
+        "",
+        "Present your findings conversationally. For each suggestion, explain your reasoning and ask if I'd like you to take action using the instinct tools.",
+        "If there are no issues, say so briefly.",
+    ];
+    if (agentsMdProject || agentsMdGlobal) {
+        parts.push("", "## Current Guidelines (AGENTS.md)", "");
+        if (agentsMdProject) {
+            parts.push("### Project AGENTS.md", "", agentsMdProject, "");
+        }
+        if (agentsMdGlobal) {
+            parts.push("### Global AGENTS.md", "", agentsMdGlobal, "");
+        }
+    }
+    if (installedSkills && installedSkills.length > 0) {
+        parts.push("", "## Installed Skills", "");
+        for (const skill of installedSkills) {
+            parts.push(`- **${skill.name}**: ${skill.description}`);
+        }
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=evolve-prompt.js.map

package/dist/prompts/evolve-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolve-prompt.js","sourceRoot":"","sources":["../../src/prompts/evolve-prompt.ts"],"names":[],"mappings":"AAYA,SAAS,iBAAiB,CAAC,CAAW;IACpC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAAqB,EACrB,eAA+B,EAC/B,cAA8B,EAC9B,eAAkC;IAElC,MAAM,KAAK,GAAa;QACtB,qFAAqF;QACrF,8GAA8G;QAC9G,EAAE;QACF,cAAc;QACd,EAAE;QACF,SAAS;QACT,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,KAAK;QACL,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,wKAAwK;QACxK,+GAA+G;QAC/G,wGAAwG;QACxG,6HAA6H;QAC7H,+GAA+G;QAC/G,EAAE;QACF,sJAAsJ;QACtJ,yCAAyC;KAC1C,CAAC;IAEF,IAAI,eAAe,IAAI,cAAc,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mCAAmC,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,eAAe,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,cAAc,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,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;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/scrubber.d.ts

@@ -0,0 +1,9 @@
+/** Secret scrubbing - replaces sensitive values with [REDACTED] before writing to disk */
+export declare const REDACTED = "[REDACTED]";
+/**
+ * Scrub secrets from arbitrary text.
+ * Replaces all matched secret patterns with [REDACTED].
+ * Non-secret text is returned unchanged.
+ */
+export declare function scrubSecrets(text: string): string;
+//# sourceMappingURL=scrubber.d.ts.map

package/dist/scrubber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrubber.d.ts","sourceRoot":"","sources":["../src/scrubber.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,eAAO,MAAM,QAAQ,eAAe,CAAC;AA2BrC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD"}

package/dist/scrubber.js

@@ -0,0 +1,40 @@
+/** Secret scrubbing - replaces sensitive values with [REDACTED] before writing to disk */
+export const REDACTED = "[REDACTED]";
+/**
+ * Ordered list of regex patterns that match common secret formats.
+ * Full matches are replaced with REDACTED.
+ */
+const SECRET_PATTERNS = [
+    // Authorization header value (bearer, basic, token schemes)
+    /authorization\s*:\s*(?:bearer|basic|token)\s+\S+/gi,
+    // Standalone bearer token (match full token value, any non-whitespace chars)
+    /bearer\s+\S+/gi,
+    // HTTP header shorthand: x-api-key: <value>, x-auth-token: <value>
+    /x-(?:api-key|auth-token)\s*:\s*\S+/gi,
+    // API key assignments: api_key=, apiKey:, api-key =, access_key=, secret_key=
+    /(?:api[_-]?key|apikey|access[_-]?key|secret[_-]?key)\s*[:=]\s*\S+/gi,
+    // Token assignments: token=, auth_token:, access_token=, refresh_token=
+    /(?:auth[_-]?token|access[_-]?token|refresh[_-]?token)\s*[:=]\s*\S+/gi,
+    // Password assignments: password=, passwd:, pwd =
+    /(?:password|passwd|pwd)\s*[:=]\s*\S+/gi,
+    // Secret / credential / private_key assignments
+    /(?:secret|credential|private[_-]?key)\s*[:=]\s*\S+/gi,
+    // AWS Access Key IDs (AKIA...)
+    /AKIA[0-9A-Z]{16}/g,
+    // OpenAI / Anthropic SDK keys: sk-..., sk-ant-...
+    /sk-(?:ant-api03-)?[a-zA-Z0-9]{32,}/g,
+];
+/**
+ * Scrub secrets from arbitrary text.
+ * Replaces all matched secret patterns with [REDACTED].
+ * Non-secret text is returned unchanged.
+ */
+export function scrubSecrets(text) {
+    let result = text;
+    for (const pattern of SECRET_PATTERNS) {
+        pattern.lastIndex = 0;
+        result = result.replace(pattern, REDACTED);
+    }
+    return result;
+}
+//# sourceMappingURL=scrubber.js.map

package/dist/scrubber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrubber.js","sourceRoot":"","sources":["../src/scrubber.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAErC;;;GAGG;AACH,MAAM,eAAe,GAAsB;IACzC,4DAA4D;IAC5D,oDAAoD;IACpD,6EAA6E;IAC7E,gBAAgB;IAChB,mEAAmE;IACnE,sCAAsC;IACtC,8EAA8E;IAC9E,qEAAqE;IACrE,wEAAwE;IACxE,sEAAsE;IACtE,kDAAkD;IAClD,wCAAwC;IACxC,gDAAgD;IAChD,sDAAsD;IACtD,+BAA+B;IAC/B,mBAAmB;IACnB,kDAAkD;IAClD,qCAAqC;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Storage layout creation for pi-continuous-learning.
+ * Creates the directory structure under ~/.pi/continuous-learning/
+ * on first use, and maintains the projects.json registry.
+ */
+import type { ProjectEntry } from "./types.js";
+export declare function getBaseDir(): string;
+export declare function getProjectDir(projectId: string, baseDir?: string): string;
+export declare function getObservationsPath(projectId: string, baseDir?: string): string;
+export declare function getArchiveDir(projectId: string, baseDir?: string): string;
+export declare function getProjectInstinctsDir(projectId: string, source: "personal" | "inherited", baseDir?: string): string;
+export declare function getGlobalInstinctsDir(source: "personal" | "inherited", baseDir?: string): string;
+export declare function getProjectsRegistryPath(baseDir?: string): string;
+/**
+ * Ensures the full storage directory layout exists.
+ * Idempotent - safe to call multiple times.
+ *
+ * @param project - Project entry with metadata
+ * @param baseDir - Base directory (defaults to ~/.pi/continuous-learning/)
+ */
+export declare function ensureStorageLayout(project: ProjectEntry, baseDir?: string): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,SAAe,GAAG,MAAM,CAE/E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,SAAe,GAAG,MAAM,CAErF;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,SAAe,GAAG,MAAM,CAE/E;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,OAAO,SAAe,GACrB,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,OAAO,SAAe,GACrB,MAAM,CAER;AAED,wBAAgB,uBAAuB,CAAC,OAAO,SAAe,GAAG,MAAM,CAEtE;AAiBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,SAAe,GAAG,IAAI,CAsBvF"}

package/dist/storage.js

@@ -0,0 +1,71 @@
+/**
+ * Storage layout creation for pi-continuous-learning.
+ * Creates the directory structure under ~/.pi/continuous-learning/
+ * on first use, and maintains the projects.json registry.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+export function getBaseDir() {
+    return join(homedir(), ".pi", "continuous-learning");
+}
+export function getProjectDir(projectId, baseDir = getBaseDir()) {
+    return join(baseDir, "projects", projectId);
+}
+export function getObservationsPath(projectId, baseDir = getBaseDir()) {
+    return join(getProjectDir(projectId, baseDir), "observations.jsonl");
+}
+export function getArchiveDir(projectId, baseDir = getBaseDir()) {
+    return join(getProjectDir(projectId, baseDir), "observations.archive");
+}
+export function getProjectInstinctsDir(projectId, source, baseDir = getBaseDir()) {
+    return join(getProjectDir(projectId, baseDir), "instincts", source);
+}
+export function getGlobalInstinctsDir(source, baseDir = getBaseDir()) {
+    return join(baseDir, "instincts", source);
+}
+export function getProjectsRegistryPath(baseDir = getBaseDir()) {
+    return join(baseDir, "projects.json");
+}
+function ensureDir(dir) {
+    mkdirSync(dir, { recursive: true });
+}
+function readProjectsRegistry(registryPath) {
+    if (!existsSync(registryPath)) {
+        return {};
+    }
+    try {
+        return JSON.parse(readFileSync(registryPath, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Ensures the full storage directory layout exists.
+ * Idempotent - safe to call multiple times.
+ *
+ * @param project - Project entry with metadata
+ * @param baseDir - Base directory (defaults to ~/.pi/continuous-learning/)
+ */
+export function ensureStorageLayout(project, baseDir = getBaseDir()) {
+    // Global instinct directories
+    ensureDir(join(baseDir, "instincts", "personal"));
+    ensureDir(join(baseDir, "instincts", "inherited"));
+    // Project-scoped directories
+    const projectDir = getProjectDir(project.id, baseDir);
+    ensureDir(join(projectDir, "instincts", "personal"));
+    ensureDir(join(projectDir, "instincts", "inherited"));
+    ensureDir(join(projectDir, "observations.archive"));
+    // Write project.json only if it does not yet exist
+    const projectJsonPath = join(projectDir, "project.json");
+    if (!existsSync(projectJsonPath)) {
+        writeFileSync(projectJsonPath, JSON.stringify(project, null, 2), "utf-8");
+    }
+    // Update projects.json registry (always updates the entry)
+    const registryPath = getProjectsRegistryPath(baseDir);
+    const registry = readProjectsRegistry(registryPath);
+    const updated = { ...registry, [project.id]: project };
+    writeFileSync(registryPath, JSON.stringify(updated, null, 2), "utf-8");
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/tool-observer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tool call observation handlers for pi-continuous-learning.
+ * Captures tool_execution_start and tool_execution_end events as JSONL observations.
+ */
+import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
+export interface ToolExecutionStartEvent {
+    type: "tool_execution_start";
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+}
+export interface ToolExecutionEndEvent {
+    type: "tool_execution_end";
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    isError: boolean;
+}
+import type { ProjectEntry } from "./types.js";
+export declare const MAX_TOOL_INPUT_LENGTH = 5000;
+export declare const MAX_TOOL_OUTPUT_LENGTH = 5000;
+/**
+ * Handles tool_execution_start events.
+ * Records an observation with event: tool_start, tool name, and scrubbed/truncated input.
+ */
+export declare function handleToolStart(event: ToolExecutionStartEvent, ctx: ExtensionContext, project: ProjectEntry, baseDir?: string): void;
+/**
+ * Handles tool_execution_end events.
+ * Records an observation with event: tool_complete, tool name, scrubbed/truncated output, and is_error.
+ */
+export declare function handleToolEnd(event: ToolExecutionEndEvent, ctx: ExtensionContext, project: ProjectEntry, baseDir?: string): void;
+//# sourceMappingURL=tool-observer.d.ts.map

package/dist/tool-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-observer.d.ts","sourceRoot":"","sources":["../src/tool-observer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAgB3C;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,uBAAuB,EAC9B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAsBN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAwBN"}