pi-continuous-learning 0.6.0 → 0.7.0

package/dist/instinct-validator.js

@@ -0,0 +1,235 @@
+/**
+ * Instinct validation and semantic deduplication.
+ * Rejects instincts with empty, undefined, nonsense, or low-quality fields,
+ * and detects near-duplicate instincts via Jaccard similarity.
+ */
+const MIN_FIELD_LENGTH = 10;
+const INVALID_LITERALS = new Set(["undefined", "null", "none", ""]);
+// ---------------------------------------------------------------------------
+// Known domains (with "other" as escape hatch)
+// ---------------------------------------------------------------------------
+export const KNOWN_DOMAINS = new Set([
+    "git",
+    "testing",
+    "debugging",
+    "workflow",
+    "typescript",
+    "javascript",
+    "python",
+    "go",
+    "css",
+    "design",
+    "security",
+    "performance",
+    "documentation",
+    "react",
+    "node",
+    "database",
+    "api",
+    "devops",
+    "architecture",
+    "other",
+]);
+// ---------------------------------------------------------------------------
+// Verb heuristic for action field
+// ---------------------------------------------------------------------------
+/** Common imperative verbs expected at the start of an instinct action. */
+export const KNOWN_VERBS = new Set([
+    "add",
+    "always",
+    "analyze",
+    "apply",
+    "ask",
+    "avoid",
+    "build",
+    "call",
+    "catch",
+    "check",
+    "clean",
+    "confirm",
+    "consider",
+    "create",
+    "define",
+    "delete",
+    "document",
+    "emit",
+    "ensure",
+    "exclude",
+    "export",
+    "extract",
+    "fetch",
+    "find",
+    "fix",
+    "follow",
+    "format",
+    "generate",
+    "get",
+    "handle",
+    "import",
+    "include",
+    "inspect",
+    "load",
+    "log",
+    "look",
+    "merge",
+    "monitor",
+    "move",
+    "never",
+    "parse",
+    "pass",
+    "prefer",
+    "print",
+    "read",
+    "record",
+    "refactor",
+    "reject",
+    "rename",
+    "require",
+    "resolve",
+    "return",
+    "run",
+    "save",
+    "scan",
+    "search",
+    "send",
+    "set",
+    "show",
+    "skip",
+    "start",
+    "stop",
+    "test",
+    "track",
+    "update",
+    "use",
+    "validate",
+    "verify",
+    "watch",
+    "wrap",
+    "write",
+]);
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function isInvalidField(value, fieldName) {
+    if (value === undefined || value === null) {
+        return `${fieldName} is ${String(value)}`;
+    }
+    if (typeof value !== "string") {
+        return `${fieldName} is not a string (got ${typeof value})`;
+    }
+    const trimmed = value.trim();
+    if (INVALID_LITERALS.has(trimmed.toLowerCase())) {
+        return `${fieldName} is the literal string "${trimmed}"`;
+    }
+    if (trimmed.length < MIN_FIELD_LENGTH) {
+        return `${fieldName} is too short (${trimmed.length} chars, minimum ${MIN_FIELD_LENGTH})`;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// validateInstinct
+// ---------------------------------------------------------------------------
+/**
+ * Validates that an instinct's fields meet quality requirements.
+ *
+ * Rules:
+ * - action and trigger must be non-empty, non-null, non-"undefined", and >= 10 chars
+ * - action first word should be a known imperative verb (warning if not)
+ * - domain, if provided, must be in KNOWN_DOMAINS (with "other" as escape hatch)
+ *
+ * Returns { valid: true } or { valid: false, reason: "..." }.
+ * Non-fatal issues are reported in the optional `warnings` array.
+ */
+export function validateInstinct(fields) {
+    const actionError = isInvalidField(fields.action, "action");
+    if (actionError) {
+        return { valid: false, reason: actionError };
+    }
+    const triggerError = isInvalidField(fields.trigger, "trigger");
+    if (triggerError) {
+        return { valid: false, reason: triggerError };
+    }
+    const warnings = [];
+    // Domain validation
+    if (fields.domain !== undefined) {
+        if (typeof fields.domain !== "string" || !KNOWN_DOMAINS.has(fields.domain.toLowerCase().trim())) {
+            return {
+                valid: false,
+                reason: `domain "${String(fields.domain)}" is not in the known set. Use one of: ${[...KNOWN_DOMAINS].join(", ")}`,
+            };
+        }
+    }
+    // Verb heuristic (warning only - does not reject)
+    const action = fields.action.trim();
+    const firstWord = action.split(/\s+/)[0]?.toLowerCase() ?? "";
+    if (firstWord && !KNOWN_VERBS.has(firstWord)) {
+        warnings.push(`action should start with an imperative verb (got "${firstWord}"). Consider rewriting as a clear instruction.`);
+    }
+    return warnings.length > 0 ? { valid: true, warnings } : { valid: true };
+}
+// ---------------------------------------------------------------------------
+// Jaccard similarity deduplication
+// ---------------------------------------------------------------------------
+const STOP_WORDS = new Set([
+    "a", "an", "the", "is", "are", "was", "were", "be", "been", "being",
+    "have", "has", "had", "do", "does", "did", "will", "would", "should",
+    "could", "may", "might", "shall", "can", "of", "in", "on", "at", "to",
+    "for", "with", "by", "from", "up", "about", "into", "it", "its", "this",
+    "that", "these", "those", "and", "or", "but", "if", "as", "when", "where",
+    "how", "what", "which", "who", "not", "no", "so",
+]);
+/**
+ * Tokenizes text into a set of meaningful lowercase words.
+ * Splits on non-alphanumeric characters and filters stop words and short tokens.
+ */
+export function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 2 && !STOP_WORDS.has(t)));
+}
+/**
+ * Computes Jaccard similarity between two token sets.
+ * Returns 1.0 for two empty sets, 0.0 if one is empty.
+ */
+export function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 1.0;
+    if (a.size === 0 || b.size === 0)
+        return 0.0;
+    let intersection = 0;
+    for (const token of a) {
+        if (b.has(token))
+            intersection++;
+    }
+    const union = a.size + b.size - intersection;
+    return intersection / union;
+}
+/**
+ * Checks whether a candidate instinct is semantically similar to any existing instinct.
+ *
+ * Tokenizes trigger+action for both candidate and each existing instinct,
+ * computes Jaccard similarity, and returns the closest match above the threshold.
+ *
+ * @param candidate  - The new instinct being considered (trigger + action)
+ * @param existing   - All current instincts to check against
+ * @param skipId     - ID to skip (the candidate's own ID on updates)
+ * @param threshold  - Similarity threshold; default 0.6
+ */
+export function findSimilarInstinct(candidate, existing, skipId, threshold = 0.6) {
+    const candidateTokens = tokenize(`${candidate.trigger} ${candidate.action}`);
+    let bestMatch = null;
+    for (const instinct of existing) {
+        if (instinct.id === skipId)
+            continue;
+        const existingTokens = tokenize(`${instinct.trigger} ${instinct.action}`);
+        const similarity = jaccardSimilarity(candidateTokens, existingTokens);
+        if (similarity >= threshold) {
+            if (bestMatch === null || similarity > bestMatch.similarity) {
+                bestMatch = { instinct, similarity };
+            }
+        }
+    }
+    return bestMatch;
+}
+//# sourceMappingURL=instinct-validator.js.map

package/dist/instinct-validator.js.map

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

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

@@ -1 +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"}
+{"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,CA8JpD"}

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

@@ -119,6 +119,46 @@ When in doubt, prefer project scope.
 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.`;
+7. Be skeptical of outliers - patterns seen only in unusual circumstances should not become instincts.
+
+## Quality Tiers
+
+Not all patterns are worth recording as instincts. Use this classification before creating:
+
+### Tier 1 - Project Conventions (RECORD as instinct)
+Patterns specific to this project's tech stack, codebase conventions, or team practices.
+Examples:
+- "Use the Result<T, E> type for error handling in this project"
+- "Place tests next to source files as *.test.ts"
+- "Prefer functional style - avoid class-based patterns in this codebase"
+
+### Tier 2 - Workflow Patterns (RECORD as global instinct)
+Recurring multi-step workflows that apply across many projects.
+Examples:
+- "Run linter and type-checker after every code change"
+- "Write tests before implementation in TDD projects"
+
+### Tier 3 - Generic Agent Behavior (DO NOT RECORD - already known)
+Fundamental behaviors all coding agents should follow. These are not project-specific patterns.
+
+**DO NOT create instincts for:**
+- Reading files before editing them ("read before edit")
+- Grepping for context before modifying code
+- Clarifying ambiguous requirements before starting
+- Using conventional commit message formats
+- Checking for errors after tool calls
+- Any behavior that is basic good practice for any coding agent
+
+These patterns belong in AGENTS.md from the start, not in learned instincts.
+
+## AGENTS.md Deduplication
+
+The user message includes the current AGENTS.md content for this project and globally.
+Before creating any instinct, check: **is this pattern already covered by AGENTS.md?**
+
+If yes: do NOT create an instinct. The pattern is already enforced.
+If a pattern appears in AGENTS.md in the same form, skip it entirely.
+
+Only create instincts for patterns that are genuinely absent from AGENTS.md.`;
 }
 //# sourceMappingURL=analyzer-system-single-shot.js.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EA4JoE,CAAC;AAC9E,CAAC"}

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

@@ -1 +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"}
+{"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,CAiER"}

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

@@ -47,7 +47,7 @@ export function buildSingleShotUserPrompt(project, existingInstincts, observatio
         }
         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.");
+    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.", "6. Before creating any instinct, check the Existing Guidelines section above.", "   If the pattern is already covered by AGENTS.md, do NOT create an instinct for it.", "7. Apply the Quality Tier rules from the system prompt:", "   - Generic agent behaviors (read-before-edit, clarify-before-implement) -> skip entirely", "   - Project-specific patterns -> project-scoped instinct", "   - Universal workflow patterns -> global-scoped instinct", "", "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

@@ -1 +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"}
+{"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,+EAA+E,EAC/E,sFAAsF,EACtF,yDAAyD,EACzD,4FAA4F,EAC5F,2DAA2D,EAC3D,4DAA4D,EAC5D,EAAE,EACF,4DAA4D,CAC7D,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/skill-scaffold.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Skill scaffolding from instinct clusters.
+ *
+ * When 3+ related instincts in the same domain form a cohesive topic,
+ * generates a SKILL.md file that can be installed as a Pi skill.
+ */
+import type { DomainCluster } from "./graduation.js";
+export interface SkillScaffold {
+    name: string;
+    description: string;
+    domain: string;
+    content: string;
+    sourceInstinctIds: string[];
+}
+/**
+ * Generates a SKILL.md scaffold from a domain cluster of instincts.
+ */
+export declare function generateSkillScaffold(cluster: DomainCluster): SkillScaffold;
+/**
+ * Generates skill scaffolds for all qualifying clusters.
+ */
+export declare function generateAllSkillScaffolds(clusters: DomainCluster[]): SkillScaffold[];
+//# sourceMappingURL=skill-scaffold.d.ts.map

package/dist/skill-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-scaffold.d.ts","sourceRoot":"","sources":["../src/skill-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAyBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAgC3E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,EAAE,GACxB,aAAa,EAAE,CAEjB"}

package/dist/skill-scaffold.js

@@ -0,0 +1,62 @@
+/**
+ * Skill scaffolding from instinct clusters.
+ *
+ * When 3+ related instincts in the same domain form a cohesive topic,
+ * generates a SKILL.md file that can be installed as a Pi skill.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function toSkillName(domain) {
+    return domain.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function formatInstinctAsSection(instinct, index) {
+    return [
+        `### ${index + 1}. ${instinct.title}`,
+        "",
+        `**When:** ${instinct.trigger}`,
+        "",
+        instinct.action,
+        "",
+    ].join("\n");
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generates a SKILL.md scaffold from a domain cluster of instincts.
+ */
+export function generateSkillScaffold(cluster) {
+    const name = toSkillName(cluster.domain);
+    const sortedInstincts = [...cluster.instincts].sort((a, b) => b.confidence - a.confidence);
+    const description = `Learned ${cluster.domain} patterns from coding sessions. ` +
+        `Covers ${sortedInstincts.length} practices distilled from instinct observations.`;
+    const sections = sortedInstincts.map((inst, i) => formatInstinctAsSection(inst, i));
+    const content = [
+        `# ${cluster.domain} Skill`,
+        "",
+        `> Auto-generated from ${sortedInstincts.length} graduated instincts in the "${cluster.domain}" domain.`,
+        "",
+        `## Description`,
+        "",
+        description,
+        "",
+        `## Practices`,
+        "",
+        ...sections,
+    ].join("\n");
+    return {
+        name,
+        description,
+        domain: cluster.domain,
+        content,
+        sourceInstinctIds: sortedInstincts.map((i) => i.id),
+    };
+}
+/**
+ * Generates skill scaffolds for all qualifying clusters.
+ */
+export function generateAllSkillScaffolds(clusters) {
+    return clusters.map(generateSkillScaffold);
+}
+//# sourceMappingURL=skill-scaffold.js.map

package/dist/skill-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-scaffold.js","sourceRoot":"","sources":["../src/skill-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,uBAAuB,CAAC,QAAkB,EAAE,KAAa;IAChE,OAAO;QACL,OAAO,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,KAAK,EAAE;QACrC,EAAE;QACF,aAAa,QAAQ,CAAC,OAAO,EAAE;QAC/B,EAAE;QACF,QAAQ,CAAC,MAAM;QACf,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,eAAe,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CACtC,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,OAAO,CAAC,MAAM,kCAAkC;QAC7E,UAAU,eAAe,CAAC,MAAM,kDAAkD,CAAC;IAErF,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG;QACd,KAAK,OAAO,CAAC,MAAM,QAAQ;QAC3B,EAAE;QACF,yBAAyB,eAAe,CAAC,MAAM,gCAAgC,OAAO,CAAC,MAAM,WAAW;QACxG,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,WAAW;QACX,EAAE;QACF,cAAc;QACd,EAAE;QACF,GAAG,QAAQ;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,IAAI;QACJ,WAAW;QACX,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;QACP,iBAAiB,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAyB;IAEzB,OAAO,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAC7C,CAAC"}

package/dist/types.d.ts

@@ -46,7 +46,10 @@ export interface Instinct {
     inactive_count: number;
     evidence?: string[];
     flagged_for_removal?: boolean;
+    graduated_to?: GraduationTarget;
+    graduated_at?: string;
 }
+export type GraduationTarget = "agents-md" | "skill" | "command";
 export interface ProjectEntry {
     id: string;
     name: string;
@@ -71,5 +74,10 @@ export interface Config {
     active_hours_end: number;
     max_idle_seconds: number;
     log_path?: string;
+    max_total_instincts_per_project: number;
+    max_total_instincts_global: number;
+    max_new_instincts_per_run: number;
+    flagged_cleanup_days: number;
+    instinct_ttl_days: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,eAAe,GACf,aAAa,GACb,WAAW,GACX,YAAY,GACZ,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AACjD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,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,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAMD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2BAA2B,EAAE,MAAM,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

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

package/src/agents-md.ts

@@ -1,9 +1,11 @@
 /**
- * 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";
+import type { Instinct } from "./types.js";
 
 /**
  * Reads an AGENTS.md file and returns its content.
@@ -21,3 +23,71 @@ export function readAgentsMd(filePath: string): string | null {
     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: Instinct): string {
+  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: string | null,
+  instincts: Instinct[]
+): string {
+  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: string,
+  instincts: Instinct[]
+): string {
+  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;
+}

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

@@ -9,6 +9,7 @@ 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";
+import { validateInstinct, findSimilarInstinct } from "../instinct-validator.js";
 
 export interface InstinctChangePayload {
   id: string;
@@ -73,20 +74,49 @@ export 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 function buildInstinctFromChange(
   change: InstinctChange,
   existing: Instinct | null,
-  projectId: string
+  projectId: string,
+  allInstincts: Instinct[] = []
 ): Instinct | null {
   if (change.action === "delete" || !change.instinct) {
     return null;
   }
 
-  const now = new Date().toISOString();
   const payload = change.instinct;
 
+  const validation = validateInstinct({
+    action: payload.action,
+    trigger: payload.trigger,
+    domain: payload.domain,
+  });
+  if (!validation.valid) {
+    return null;
+  }
+
+  // On create, reject if semantically similar to an existing instinct (skip self on update)
+  if (change.action === "create") {
+    const similar = findSimilarInstinct(
+      { trigger: payload.trigger, action: payload.action },
+      allInstincts,
+      payload.id
+    );
+    if (similar) {
+      return null;
+    }
+  }
+
+  const now = new Date().toISOString();
+
   return {
     id: payload.id,
     title: payload.title,