@clawdactual/chitin 0.1.0

package/dist/db/schema.js

@@ -0,0 +1,68 @@
+import Database from 'better-sqlite3';
+let db = null;
+const CREATE_INSIGHTS = `
+CREATE TABLE IF NOT EXISTS insights (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK(type IN ('behavioral','personality','relational','principle','skill')),
+  claim TEXT NOT NULL,
+  reasoning TEXT,
+  context TEXT,
+  limitations TEXT,
+  confidence REAL NOT NULL CHECK(confidence >= 0 AND confidence <= 1),
+  tags TEXT NOT NULL DEFAULT '[]',
+  source TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  reinforcement_count INTEGER NOT NULL DEFAULT 0,
+  last_retrieved_at TEXT
+);
+`;
+const CREATE_EMBEDDINGS = `
+CREATE TABLE IF NOT EXISTS insight_embeddings (
+  insight_id TEXT PRIMARY KEY REFERENCES insights(id) ON DELETE CASCADE,
+  embedding BLOB NOT NULL
+);
+`;
+const CREATE_HISTORY = `
+CREATE TABLE IF NOT EXISTS insight_history (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  insight_id TEXT NOT NULL REFERENCES insights(id) ON DELETE CASCADE,
+  field TEXT NOT NULL,
+  old_value TEXT,
+  new_value TEXT,
+  change_type TEXT NOT NULL CHECK(change_type IN ('create','update','reinforce','merge')),
+  changed_at TEXT NOT NULL DEFAULT (datetime('now')),
+  source TEXT
+);
+`;
+const CREATE_HISTORY_INDEX = `
+CREATE INDEX IF NOT EXISTS idx_history_insight_id ON insight_history(insight_id);
+`;
+export function initDatabase(dbPath) {
+    if (db) {
+        db.close();
+        db = null;
+    }
+    db = new Database(dbPath);
+    // Performance settings
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    // Create tables
+    db.exec(CREATE_INSIGHTS);
+    db.exec(CREATE_EMBEDDINGS);
+    db.exec(CREATE_HISTORY);
+    db.exec(CREATE_HISTORY_INDEX);
+}
+export function getDatabase() {
+    if (!db) {
+        throw new Error('Database not initialized. Call initDatabase() first.');
+    }
+    return db;
+}
+export function closeDatabase() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,IAAI,EAAE,GAAwB,IAAI,CAAC;AAEnC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;CAgBvB,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;CAKzB,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;CAWtB,CAAC;AAEF,MAAM,oBAAoB,GAAG;;CAE5B,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;IAED,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE1B,uBAAuB;IACvB,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,gBAAgB;IAChB,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACzB,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACxB,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/engine/conflicts.d.ts

@@ -0,0 +1,52 @@
+import type { Insight, ContributeInput } from '../types.js';
+import type { InsightRepository } from '../db/repository.js';
+/**
+ * A pair of opposing terms detected between two claims.
+ */
+export type TensionPair = [string, string];
+/**
+ * Result of computing semantic tension between two text claims.
+ */
+export interface TensionResult {
+    score: number;
+    pairs: TensionPair[];
+}
+/**
+ * A detected conflict between a new insight and an existing one.
+ */
+export interface ConflictResult {
+    insight: Insight;
+    similarity: number;
+    tensionScore: number;
+    tensionReason: string;
+    conflictScore: number;
+}
+export interface DetectConflictsOptions {
+    minConflictScore?: number;
+    maxResults?: number;
+}
+/**
+ * Compute the semantic tension between two text claims.
+ *
+ * Scans both claims for opposing term pairs. Each matched pair contributes
+ * to the tension score. The score is normalized by the number of pairs checked.
+ *
+ * This is deliberately simple — keyword matching, no ML. The agent's LLM
+ * already understands nuance; this just needs to be "good enough" to flag
+ * potential conflicts for review.
+ */
+export declare function computeTensionScore(claimA: string, claimB: string): TensionResult;
+/**
+ * Detect conflicts between a proposed new insight and existing insights.
+ *
+ * Combines word overlap (Jaccard similarity) with semantic tension
+ * to identify insights that may contradict the new one.
+ *
+ * conflictScore = similarity * 0.3 + tensionScore * 0.7
+ *
+ * Tension is weighted higher because two insights can be about different
+ * topics (low similarity) but still contradict each other, and vice versa —
+ * similar topics with no tension aren't conflicts.
+ */
+export declare function detectConflicts(repo: InsightRepository, input: ContributeInput, options?: DetectConflictsOptions): ConflictResult[];
+//# sourceMappingURL=conflicts.d.ts.map

package/dist/engine/conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../src/engine/conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqKD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAkCjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,sBAA2B,GACnC,cAAc,EAAE,CAsClB"}

package/dist/engine/conflicts.js

@@ -0,0 +1,232 @@
+/**
+ * Opposing term pairs. If claim A contains a term from column 1
+ * and claim B contains the corresponding term from column 2 (or vice versa),
+ * that's a tension signal.
+ *
+ * These are intentionally broad semantic oppositions, not strict antonyms.
+ * The goal is "good enough" detection — the agent's LLM handles nuance.
+ */
+const TENSION_PAIRS = [
+    // Communication style
+    ['verbose', 'concise'],
+    ['verbose', 'brief'],
+    ['verbose', 'direct'],
+    ['verbose', 'efficient'],
+    ['detailed', 'concise'],
+    ['detailed', 'brief'],
+    ['detailed', 'direct'],
+    ['detailed', 'efficient'],
+    ['thorough', 'concise'],
+    ['thorough', 'brief'],
+    ['elaborate', 'concise'],
+    ['elaborate', 'brief'],
+    ['lengthy', 'short'],
+    ['wordy', 'terse'],
+    ['wordy', 'direct'],
+    // Action orientation
+    ['ask', 'act'],
+    ['cautious', 'bold'],
+    ['careful', 'fast'],
+    ['slow', 'fast'],
+    ['deliberate', 'quick'],
+    ['wait', 'proceed'],
+    ['hesitate', 'decisive'],
+    ['passive', 'proactive'],
+    // Formality
+    ['formal', 'casual'],
+    ['formal', 'informal'],
+    ['professional', 'casual'],
+    ['polite', 'blunt'],
+    ['diplomatic', 'direct'],
+    // Approach
+    ['strict', 'flexible'],
+    ['rigid', 'adaptive'],
+    ['conservative', 'aggressive'],
+    ['minimal', 'comprehensive'],
+    ['simple', 'complex'],
+    ['silent', 'vocal'],
+    ['quiet', 'loud'],
+    // Knowledge sharing
+    ['explain', 'execute'],
+    ['narrate', 'silent'],
+    ['transparent', 'opaque'],
+    // Risk
+    ['safe', 'risky'],
+    ['cautious', 'adventurous'],
+    ['careful', 'reckless'],
+    // Independence
+    ['independent', 'dependent'],
+    ['autonomous', 'supervised'],
+    ['initiative', 'permission'],
+];
+/**
+ * Very simple suffix stemmer. Strips common English suffixes to normalize
+ * word forms: "directness" → "direct", "brevity" → "brief", etc.
+ *
+ * This isn't Porter stemming — it's deliberately minimal. We only need
+ * enough normalization to match our tension pair terms.
+ */
+const STEM_RULES = [
+    [/ness$/, ''], // directness → direct, conciseness → concise
+    [/ity$/, ''], // brevity → brev (handled by explicit map below)
+    [/tion$/, ''], // explanation → explana (not great, but we match on stems)
+    [/ment$/, ''], // involvement → involve
+    [/ing$/, ''], // asking → ask, acting → act
+    [/ly$/, ''], // quickly → quick, formally → formal
+    [/ous$/, ''], // cautious → cauti (partial, but helps)
+    [/ive$/, ''], // proactive → proact (partial)
+    [/ful$/, ''], // careful → care
+    [/ed$/, ''], // detailed → detail
+    [/er$/, ''], // faster → fast
+    [/est$/, ''], // fastest → fast
+    [/al$/, ''], // formal → form (too aggressive alone, but we check both)
+    [/s$/, ''], // explanations → explanation (then tion rule)
+];
+/**
+ * Explicit stem mappings for irregular forms that matter for our tension pairs.
+ */
+const STEM_MAP = {
+    'brevity': 'brief',
+    'verbosity': 'verbose',
+    'cautiously': 'cautious',
+    'decisive': 'decisive',
+    'indecisive': 'hesitate',
+    'efficiency': 'efficient',
+    'flexibility': 'flexible',
+    'rigidity': 'rigid',
+    'formality': 'formal',
+    'informality': 'informal',
+    'complexity': 'complex',
+    'simplicity': 'simple',
+    'asking': 'ask',
+    'acting': 'act',
+    'waiting': 'wait',
+    'proceeding': 'proceed',
+};
+function stem(word) {
+    if (STEM_MAP[word])
+        return STEM_MAP[word];
+    let result = word;
+    for (const [pattern, replacement] of STEM_RULES) {
+        const stemmed = result.replace(pattern, replacement);
+        if (stemmed.length >= 3) { // don't over-stem
+            result = stemmed;
+            break; // apply only the first matching rule
+        }
+    }
+    return result;
+}
+/**
+ * Tokenize text into a set of lowercase words + their stems,
+ * filtering out tiny words.
+ */
+function tokenize(text) {
+    const words = text.toLowerCase()
+        .split(/\W+/)
+        .filter(w => w.length > 2);
+    const result = new Set();
+    for (const word of words) {
+        result.add(word);
+        const stemmed = stem(word);
+        if (stemmed !== word) {
+            result.add(stemmed);
+        }
+    }
+    return result;
+}
+/**
+ * Jaccard similarity between two word sets.
+ */
+function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const word of a) {
+        if (b.has(word))
+            intersection++;
+    }
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+/**
+ * Compute the semantic tension between two text claims.
+ *
+ * Scans both claims for opposing term pairs. Each matched pair contributes
+ * to the tension score. The score is normalized by the number of pairs checked.
+ *
+ * This is deliberately simple — keyword matching, no ML. The agent's LLM
+ * already understands nuance; this just needs to be "good enough" to flag
+ * potential conflicts for review.
+ */
+export function computeTensionScore(claimA, claimB) {
+    const wordsA = tokenize(claimA);
+    const wordsB = tokenize(claimB);
+    const foundPairs = [];
+    for (const [term1, term2] of TENSION_PAIRS) {
+        // Check both directions: A has term1 & B has term2, or A has term2 & B has term1
+        const aHas1 = wordsA.has(term1);
+        const aHas2 = wordsA.has(term2);
+        const bHas1 = wordsB.has(term1);
+        const bHas2 = wordsB.has(term2);
+        if ((aHas1 && bHas2) || (aHas2 && bHas1)) {
+            // Genuine tension: opposing terms in different claims
+            // Skip only if BOTH claims contain BOTH terms — that suggests 
+            // nuanced discussion rather than contradiction
+            if (aHas1 && aHas2 && bHas1 && bHas2)
+                continue;
+            foundPairs.push([term1, term2]);
+        }
+    }
+    if (foundPairs.length === 0) {
+        return { score: 0, pairs: [] };
+    }
+    // Score: each pair contributes, with diminishing returns
+    // 1 pair = 0.4, 2 pairs = 0.6, 3 pairs = 0.73, etc.
+    // Formula: 1 - (1 / (1 + 0.4 * count))  — sigmoid-ish curve
+    const rawScore = 1 - (1 / (1 + 0.6 * foundPairs.length));
+    const score = Math.min(1.0, rawScore);
+    return { score, pairs: foundPairs };
+}
+/**
+ * Detect conflicts between a proposed new insight and existing insights.
+ *
+ * Combines word overlap (Jaccard similarity) with semantic tension
+ * to identify insights that may contradict the new one.
+ *
+ * conflictScore = similarity * 0.3 + tensionScore * 0.7
+ *
+ * Tension is weighted higher because two insights can be about different
+ * topics (low similarity) but still contradict each other, and vice versa —
+ * similar topics with no tension aren't conflicts.
+ */
+export function detectConflicts(repo, input, options = {}) {
+    const { minConflictScore = 0.15, maxResults = 5, } = options;
+    const allInsights = repo.list();
+    if (allInsights.length === 0)
+        return [];
+    const inputWords = tokenize(input.claim);
+    const results = [];
+    for (const insight of allInsights) {
+        const insightWords = tokenize(insight.claim);
+        const similarity = jaccardSimilarity(inputWords, insightWords);
+        const tension = computeTensionScore(input.claim, insight.claim);
+        if (tension.score === 0 && similarity < 0.3)
+            continue;
+        const conflictScore = similarity * 0.3 + tension.score * 0.7;
+        if (conflictScore < minConflictScore)
+            continue;
+        const tensionReason = tension.pairs.length > 0
+            ? tension.pairs.map(([a, b]) => `"${a}" ↔ "${b}"`).join(', ')
+            : 'high word overlap with different emphasis';
+        results.push({
+            insight,
+            similarity,
+            tensionScore: tension.score,
+            tensionReason,
+            conflictScore,
+        });
+    }
+    results.sort((a, b) => b.conflictScore - a.conflictScore);
+    return results.slice(0, maxResults);
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/engine/conflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.js","sourceRoot":"","sources":["../../src/engine/conflicts.ts"],"names":[],"mappings":"AAgCA;;;;;;;GAOG;AACH,MAAM,aAAa,GAAkB;IACnC,sBAAsB;IACtB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,SAAS,EAAE,OAAO,CAAC;IACpB,CAAC,SAAS,EAAE,QAAQ,CAAC;IACrB,CAAC,SAAS,EAAE,WAAW,CAAC;IACxB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,UAAU,EAAE,OAAO,CAAC;IACrB,CAAC,UAAU,EAAE,QAAQ,CAAC;IACtB,CAAC,UAAU,EAAE,WAAW,CAAC;IACzB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,UAAU,EAAE,OAAO,CAAC;IACrB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,OAAO,CAAC;IACtB,CAAC,SAAS,EAAE,OAAO,CAAC;IACpB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,QAAQ,CAAC;IAEnB,qBAAqB;IACrB,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,UAAU,EAAE,MAAM,CAAC;IACpB,CAAC,SAAS,EAAE,MAAM,CAAC;IACnB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,YAAY,EAAE,OAAO,CAAC;IACvB,CAAC,MAAM,EAAE,SAAS,CAAC;IACnB,CAAC,UAAU,EAAE,UAAU,CAAC;IACxB,CAAC,SAAS,EAAE,WAAW,CAAC;IAExB,YAAY;IACZ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,QAAQ,EAAE,UAAU,CAAC;IACtB,CAAC,cAAc,EAAE,QAAQ,CAAC;IAC1B,CAAC,QAAQ,EAAE,OAAO,CAAC;IACnB,CAAC,YAAY,EAAE,QAAQ,CAAC;IAExB,WAAW;IACX,CAAC,QAAQ,EAAE,UAAU,CAAC;IACtB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,cAAc,EAAE,YAAY,CAAC;IAC9B,CAAC,SAAS,EAAE,eAAe,CAAC;IAC5B,CAAC,QAAQ,EAAE,SAAS,CAAC;IACrB,CAAC,QAAQ,EAAE,OAAO,CAAC;IACnB,CAAC,OAAO,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,SAAS,EAAE,QAAQ,CAAC;IACrB,CAAC,aAAa,EAAE,QAAQ,CAAC;IAEzB,OAAO;IACP,CAAC,MAAM,EAAE,OAAO,CAAC;IACjB,CAAC,UAAU,EAAE,aAAa,CAAC;IAC3B,CAAC,SAAS,EAAE,UAAU,CAAC;IAEvB,eAAe;IACf,CAAC,aAAa,EAAE,WAAW,CAAC;IAC5B,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,YAAY,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,GAAuB;IACrC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAQ,6CAA6C;IAClE,CAAC,MAAM,EAAE,EAAE,CAAC,EAAS,iDAAiD;IACtE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAQ,2DAA2D;IAChF,CAAC,OAAO,EAAE,EAAE,CAAC,EAAQ,wBAAwB;IAC7C,CAAC,MAAM,EAAE,EAAE,CAAC,EAAS,6BAA6B;IAClD,CAAC,KAAK,EAAE,EAAE,CAAC,EAAU,qCAAqC;IAC1D,CAAC,MAAM,EAAE,EAAE,CAAC,EAAS,wCAAwC;IAC7D,CAAC,MAAM,EAAE,EAAE,CAAC,EAAS,+BAA+B;IACpD,CAAC,MAAM,EAAE,EAAE,CAAC,EAAS,iBAAiB;IACtC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAU,oBAAoB;IACzC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAU,gBAAgB;IACrC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAS,iBAAiB;IACtC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAU,0DAA0D;IAC/E,CAAC,IAAI,EAAE,EAAE,CAAC,EAAW,8CAA8C;CACpE,CAAC;AAEF;;GAEG;AACH,MAAM,QAAQ,GAA2B;IACvC,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,SAAS;IACtB,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;IACxB,YAAY,EAAE,WAAW;IACzB,aAAa,EAAE,UAAU;IACzB,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,UAAU;IACzB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,QAAQ;IACtB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,SAAS;CACxB,CAAC;AAEF,SAAS,IAAI,CAAC,IAAY;IACxB,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE1C,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,UAAU,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAE,kBAAkB;YAC5C,MAAM,GAAG,OAAO,CAAC;YACjB,MAAM,CAAE,qCAAqC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE;SAC7B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,CAAc,EAAE,CAAc;IACvD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE3C,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,YAAY,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;AAChD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,MAAc;IAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,MAAM,UAAU,GAAkB,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;QAC3C,iFAAiF;QACjF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEhC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,CAAC;YACzC,sDAAsD;YACtD,+DAA+D;YAC/D,+CAA+C;YAC/C,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK;gBAAE,SAAS;YAE/C,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjC,CAAC;IAED,yDAAyD;IACzD,oDAAoD;IACpD,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAuB,EACvB,KAAsB,EACtB,UAAkC,EAAE;IAEpC,MAAM,EACJ,gBAAgB,GAAG,IAAI,EACvB,UAAU,GAAG,CAAC,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAEhE,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,IAAI,UAAU,GAAG,GAAG;YAAE,SAAS;QAEtD,MAAM,aAAa,GAAG,UAAU,GAAG,GAAG,GAAG,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;QAE7D,IAAI,aAAa,GAAG,gBAAgB;YAAE,SAAS;QAE/C,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAC5C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7D,CAAC,CAAC,2CAA2C,CAAC;QAEhD,OAAO,CAAC,IAAI,CAAC;YACX,OAAO;YACP,UAAU;YACV,YAAY,EAAE,OAAO,CAAC,KAAK;YAC3B,aAAa;YACb,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC"}

package/dist/engine/context-detect.d.ts

@@ -0,0 +1,17 @@
+import type { InsightType } from '../types.js';
+export type ContextCategory = 'coding' | 'communication' | 'ethical' | 'creative' | 'general';
+export interface DetectedContext {
+    category: ContextCategory;
+    typeBoosts: Record<InsightType, number>;
+}
+/**
+ * Detect the context category of an incoming message/query.
+ * Uses keyword matching with weighted scoring to classify the
+ * dominant context, then returns appropriate type boost multipliers.
+ *
+ * This is intentionally simple — keyword-based, no ML.
+ * The agent's LLM already understands context deeply;
+ * this just needs to be "good enough" for boost selection.
+ */
+export declare function detectContext(text: string): DetectedContext;
+//# sourceMappingURL=context-detect.d.ts.map

package/dist/engine/context-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detect.d.ts","sourceRoot":"","sources":["../../src/engine/context-detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;CACzC;AA2FD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA+C3D"}

package/dist/engine/context-detect.js

@@ -0,0 +1,132 @@
+const SIGNALS = [
+    {
+        category: 'coding',
+        weight: 1.0,
+        keywords: [
+            'code', 'function', 'bug', 'api', 'build', 'deploy', 'test', 'git',
+            'commit', 'push', 'pull', 'branch', 'merge', 'refactor', 'debug',
+            'typescript', 'javascript', 'python', 'rust', 'html', 'css',
+            'database', 'sql', 'server', 'endpoint', 'cli', 'npm', 'package',
+            'compile', 'error', 'fix', 'implement', 'architect', 'repo',
+            'docker', 'container', 'netlify', 'website', 'tdd', 'lint',
+            'schema', 'migration', 'query', 'install', 'config',
+        ],
+    },
+    {
+        category: 'communication',
+        weight: 1.0,
+        keywords: [
+            'boss', 'team', 'respond', 'reply', 'message', 'email', 'slack',
+            'tell', 'ask', 'explain', 'communicate', 'feedback', 'meeting',
+            'person', 'people', 'coworker', 'colleague', 'client', 'user',
+            'conversation', 'discuss', 'chat', 'tone', 'polite', 'direct',
+        ],
+    },
+    {
+        category: 'ethical',
+        weight: 1.2, // Slightly higher weight — ethical signals should be strong
+        keywords: [
+            'ethical', 'moral', 'right', 'wrong', 'honest', 'honesty', 'lie',
+            'private', 'privacy', 'security', 'trust', 'principle', 'value',
+            'should', 'fair', 'integrity', 'permission', 'consent', 'safe',
+            'appropriate', 'harmful', 'responsible', 'christian', 'faith',
+        ],
+    },
+    {
+        category: 'creative',
+        weight: 0.9,
+        keywords: [
+            'story', 'write', 'creative', 'fun', 'humor', 'joke', 'poem',
+            'imagine', 'design', 'art', 'style', 'voice', 'personality',
+            'dream', 'philosophical', 'reflect', 'muse', 'inspire',
+        ],
+    },
+];
+const BOOST_PROFILES = {
+    coding: {
+        skill: 1.8,
+        behavioral: 1.3,
+        principle: 1.0,
+        personality: 0.7,
+        relational: 0.8,
+    },
+    communication: {
+        relational: 1.8,
+        behavioral: 1.5,
+        personality: 1.2,
+        principle: 1.0,
+        skill: 0.6,
+    },
+    ethical: {
+        principle: 2.0,
+        behavioral: 1.2,
+        personality: 1.0,
+        relational: 1.0,
+        skill: 0.5,
+    },
+    creative: {
+        personality: 1.8,
+        behavioral: 1.2,
+        relational: 1.0,
+        principle: 0.8,
+        skill: 0.6,
+    },
+    general: {
+        personality: 1.0,
+        behavioral: 1.0,
+        relational: 1.0,
+        principle: 1.0,
+        skill: 1.0,
+    },
+};
+/**
+ * Detect the context category of an incoming message/query.
+ * Uses keyword matching with weighted scoring to classify the
+ * dominant context, then returns appropriate type boost multipliers.
+ *
+ * This is intentionally simple — keyword-based, no ML.
+ * The agent's LLM already understands context deeply;
+ * this just needs to be "good enough" for boost selection.
+ */
+export function detectContext(text) {
+    if (!text || text.trim().length === 0) {
+        return { category: 'general', typeBoosts: BOOST_PROFILES.general };
+    }
+    const lower = text.toLowerCase();
+    const words = new Set(lower.split(/\W+/).filter(w => w.length > 0));
+    const scores = {
+        coding: 0,
+        communication: 0,
+        ethical: 0,
+        creative: 0,
+        general: 0,
+    };
+    for (const signal of SIGNALS) {
+        let matches = 0;
+        for (const keyword of signal.keywords) {
+            // Check both word-level match and substring match for compound words
+            if (words.has(keyword) || lower.includes(keyword)) {
+                matches++;
+            }
+        }
+        scores[signal.category] = matches * signal.weight;
+    }
+    // Find the category with the highest score
+    let bestCategory = 'general';
+    let bestScore = 0;
+    for (const [category, score] of Object.entries(scores)) {
+        if (score > bestScore) {
+            bestScore = score;
+            bestCategory = category;
+        }
+    }
+    // Need at least 1 match to classify as non-general
+    if (bestScore < 1) {
+        bestCategory = 'general';
+    }
+    return {
+        category: bestCategory,
+        typeBoosts: BOOST_PROFILES[bestCategory],
+    };
+}
+//# sourceMappingURL=context-detect.js.map

package/dist/engine/context-detect.js.map

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

package/dist/engine/marshal.d.ts

@@ -0,0 +1,19 @@
+import type { ScoredInsight } from './retrieve.js';
+export interface MarshalOptions {
+    tokenBudget?: number;
+    includeContext?: boolean;
+    format?: 'compact' | 'full';
+}
+/**
+ * Rough token estimation. ~1 token per 4 characters for English text.
+ * Not exact, but sufficient for budgeting.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Marshal scored insights into a compact, token-efficient context block
+ * suitable for injection into a system prompt.
+ *
+ * Groups insights by type, uses bullet-point format, respects token budget.
+ */
+export declare function marshal(scored: ScoredInsight[], options?: MarshalOptions): string;
+//# sourceMappingURL=marshal.d.ts.map

package/dist/engine/marshal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marshal.d.ts","sourceRoot":"","sources":["../../src/engine/marshal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC7B;AAaD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CA4DrF"}

package/dist/engine/marshal.js

@@ -0,0 +1,74 @@
+const TYPE_LABELS = {
+    behavioral: 'Behavioral',
+    personality: 'Personality',
+    relational: 'Relational',
+    principle: 'Principle',
+    skill: 'Skill',
+};
+// Type display order — personality/relational first (identity), then behavioral, principles, skills
+const TYPE_ORDER = ['personality', 'relational', 'behavioral', 'principle', 'skill'];
+/**
+ * Rough token estimation. ~1 token per 4 characters for English text.
+ * Not exact, but sufficient for budgeting.
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Marshal scored insights into a compact, token-efficient context block
+ * suitable for injection into a system prompt.
+ *
+ * Groups insights by type, uses bullet-point format, respects token budget.
+ */
+export function marshal(scored, options = {}) {
+    const { tokenBudget = 2000, includeContext = false, format = 'compact', } = options;
+    if (scored.length === 0)
+        return '';
+    // Group by type
+    const groups = new Map();
+    for (const s of scored) {
+        const existing = groups.get(s.insight.type) ?? [];
+        existing.push(s);
+        groups.set(s.insight.type, existing);
+    }
+    const lines = [];
+    let currentTokens = 0;
+    const headerBudget = estimateTokens('## Personality Context\n\n');
+    currentTokens += headerBudget;
+    // Build sections in display order
+    for (const type of TYPE_ORDER) {
+        const insights = groups.get(type);
+        if (!insights || insights.length === 0)
+            continue;
+        const sectionHeader = `### ${TYPE_LABELS[type]}`;
+        const headerTokens = estimateTokens(sectionHeader + '\n');
+        if (currentTokens + headerTokens > tokenBudget)
+            break;
+        lines.push(sectionHeader);
+        currentTokens += headerTokens;
+        for (const s of insights) {
+            let line = `- ${s.insight.claim}`;
+            if (includeContext && s.insight.context && format === 'compact') {
+                line += ` (${s.insight.context})`;
+            }
+            if (format === 'full') {
+                if (s.insight.context)
+                    line += `\n  Context: ${s.insight.context}`;
+                if (s.insight.reasoning)
+                    line += `\n  Reasoning: ${s.insight.reasoning}`;
+                if (s.insight.limitations)
+                    line += `\n  Limitations: ${s.insight.limitations}`;
+            }
+            const lineTokens = estimateTokens(line + '\n');
+            if (currentTokens + lineTokens > tokenBudget)
+                break;
+            lines.push(line);
+            currentTokens += lineTokens;
+        }
+        lines.push(''); // blank line between sections
+    }
+    return lines.join('\n').trim();
+}
+//# sourceMappingURL=marshal.js.map

package/dist/engine/marshal.js.map

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