claude-soul-server 0.1.0

package/dist/tools/soul-reflect.js

@@ -0,0 +1,82 @@
+import { runReflection, runMetaReflection } from "../engine/reflection-runner.js";
+import { getSignalCount } from "../engine/signal-store.js";
+import { loadMeta } from "../engine/meta-optimizer.js";
+export async function handleSoulReflect(tier) {
+    // Meta-reflection doesn't need signals — it audits framework state
+    if (tier === "meta") {
+        let result;
+        try {
+            result = await runMetaReflection();
+        }
+        catch (err) {
+            return `Meta-reflection failed: ${err}`;
+        }
+        return formatReflectionResult(result);
+    }
+    const signalCount = await getSignalCount();
+    if (signalCount === 0) {
+        return "No signals to reflect on. Signals are collected automatically from conversations via the Stop hook, or you can report them with soul_signal().";
+    }
+    let result;
+    try {
+        result = await runReflection(tier);
+    }
+    catch (err) {
+        return `Reflection failed: ${err}`;
+    }
+    const lines = [formatReflectionResult(result)];
+    // Auto-chain meta-reflection on large changes or periodically
+    const largeChanges = result.retired >= 2 || result.newFrameworks >= 2 || result.frameworksUpdated >= 8;
+    const meta = await loadMeta();
+    const periodic = meta.reflectionCount > 0 && meta.reflectionCount % 5 === 0;
+    if (largeChanges || periodic) {
+        const reason = largeChanges
+            ? `large changes (${result.retired} retired, ${result.newFrameworks} new, ${result.frameworksUpdated} updated)`
+            : `periodic audit (reflection #${meta.reflectionCount})`;
+        lines.push("");
+        lines.push(`Auto-chaining meta-reflection: ${reason}...`);
+        try {
+            const metaResult = await runMetaReflection();
+            lines.push("");
+            lines.push(formatReflectionResult(metaResult));
+        }
+        catch (metaErr) {
+            lines.push(`Meta-reflection failed: ${metaErr}`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatReflectionResult(result) {
+    const tierLabel = result.tier.toUpperCase();
+    const lines = [];
+    lines.push(`## ${tierLabel} Reflection Complete`);
+    if (result.signalsProcessed > 0) {
+        lines.push(`- Signals processed: ${result.signalsProcessed}`);
+    }
+    if (result.frameworksUpdated > 0) {
+        lines.push(`- Frameworks updated: ${result.frameworksUpdated}`);
+    }
+    if (result.newFrameworks > 0) {
+        lines.push(`- New frameworks: ${result.newFrameworks}`);
+    }
+    if (result.retired > 0) {
+        lines.push(`- Retired: ${result.retired}`);
+    }
+    if (result.lessonsGenerated > 0) {
+        lines.push(`- Lessons generated: ${result.lessonsGenerated}`);
+    }
+    if (result.exemplarsStored > 0) {
+        lines.push(`- Exemplars stored: ${result.exemplarsStored}`);
+    }
+    if (result.tensionsUpdated > 0) {
+        lines.push(`- Tensions updated: ${result.tensionsUpdated}`);
+    }
+    if (result.snapshot) {
+        lines.push(`- Snapshot saved (rollback available)`);
+    }
+    if (result.insight) {
+        lines.push(`- Insight: ${result.insight}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=soul-reflect.js.map

package/dist/tools/soul-reflect.js.map

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

package/dist/tools/soul-signal.d.ts

@@ -0,0 +1,8 @@
+import type { SignalType } from "../types/learning-types.js";
+type SignalInput = {
+    type: SignalType;
+    evidence: string;
+    confidence?: number;
+};
+export declare function handleSoulSignal(signals: SignalInput[]): Promise<string>;
+export {};

package/dist/tools/soul-signal.js

@@ -0,0 +1,119 @@
+import crypto from "node:crypto";
+import { appendSignals, getSignalCount } from "../engine/signal-store.js";
+import { StateEngine } from "../engine/state-engine.js";
+import { loadMeta, getReflectionThresholds } from "../engine/meta-optimizer.js";
+import { readJsonSafe, FRAMEWORKS_PATH } from "../util/files.js";
+import { runReflection, runMetaReflection } from "../engine/reflection-runner.js";
+export async function handleSoulSignal(signals) {
+    const sessionKey = crypto.randomUUID().slice(0, 8);
+    const microSignals = signals.map((s) => ({
+        timestamp: Date.now(),
+        sessionKey,
+        type: s.type,
+        evidence: s.evidence.slice(0, 200),
+        source: "user",
+        confidence: s.confidence ?? 0.7,
+        userSnippets: [],
+        assistantSnippets: [],
+    }));
+    await appendSignals(microSignals);
+    // Update state based on signals
+    const stateEngine = new StateEngine();
+    await stateEngine.load();
+    for (const signal of microSignals) {
+        switch (signal.type) {
+            case "correction":
+                stateEngine.recordEvent({ type: "correction" });
+                break;
+            case "gratitude":
+                stateEngine.recordEvent({ type: "positive_interaction", delta: 0.1 });
+                break;
+            case "success":
+                stateEngine.recordEvent({ type: "successful_task", complexity: "complex" });
+                break;
+            case "confusion":
+                stateEngine.recordEvent({ type: "negative_interaction", delta: 0.05 });
+                break;
+            case "topic_shift":
+                stateEngine.recordEvent({ type: "novel_topic" });
+                break;
+        }
+    }
+    await stateEngine.tick();
+    const lines = [];
+    lines.push(`Recorded ${microSignals.length} signal(s): ${microSignals.map((s) => s.type).join(", ")}`);
+    // Check if reflection should trigger (Option B: self-triggering)
+    const totalSignals = await getSignalCount();
+    const meta = await loadMeta();
+    const thresholds = getReflectionThresholds(meta);
+    const store = await readJsonSafe(FRAMEWORKS_PATH, {
+        version: 1,
+        frameworks: [],
+        meta: { totalDiscovered: 0, totalRetired: 0, totalMerged: 0, lastReflectionAt: 0, reflectionCount: 0 },
+    });
+    const timeSinceReflection = Date.now() - store.meta.lastReflectionAt;
+    let tier = null;
+    if (totalSignals >= thresholds.minSignals) {
+        if (totalSignals >= thresholds.deepSignals ||
+            (timeSinceReflection >= thresholds.deepTimeMs && totalSignals >= thresholds.minSignals)) {
+            tier = "deep";
+        }
+        else if (totalSignals >= thresholds.quickSignals ||
+            (timeSinceReflection >= thresholds.quickTimeMs && totalSignals >= thresholds.minSignals)) {
+            tier = "quick";
+        }
+    }
+    if (tier) {
+        lines.push("");
+        lines.push(`Threshold reached (${totalSignals} signals, phase: ${meta.phase}). Triggering ${tier} reflection...`);
+        try {
+            const result = await runReflection(tier);
+            lines.push("");
+            lines.push(`## ${tier.toUpperCase()} Reflection Complete`);
+            lines.push(`- Frameworks updated: ${result.frameworksUpdated}`);
+            if (result.newFrameworks > 0)
+                lines.push(`- New frameworks: ${result.newFrameworks}`);
+            if (result.retired > 0)
+                lines.push(`- Retired: ${result.retired}`);
+            if (result.lessonsGenerated > 0)
+                lines.push(`- Lessons: ${result.lessonsGenerated}`);
+            if (result.insight)
+                lines.push(`- Insight: ${result.insight}`);
+            // Auto-chain meta-reflection when reflection made large changes or periodically
+            const largeChanges = result.retired >= 2 || result.newFrameworks >= 2 || result.frameworksUpdated >= 8;
+            const updatedMeta = await loadMeta();
+            const periodic = updatedMeta.reflectionCount > 0 && updatedMeta.reflectionCount % 5 === 0;
+            if (largeChanges || periodic) {
+                const reason = largeChanges
+                    ? `large changes detected (${result.retired} retired, ${result.newFrameworks} new, ${result.frameworksUpdated} updated)`
+                    : `periodic audit (every 5th reflection, count: ${updatedMeta.reflectionCount})`;
+                lines.push("");
+                lines.push(`Auto-triggering meta-reflection: ${reason}...`);
+                try {
+                    const metaResult = await runMetaReflection();
+                    lines.push("");
+                    lines.push("## META Reflection Complete");
+                    if (metaResult.frameworksUpdated > 0)
+                        lines.push(`- Frameworks adjusted: ${metaResult.frameworksUpdated}`);
+                    if (metaResult.retired > 0)
+                        lines.push(`- Retired: ${metaResult.retired}`);
+                    if (metaResult.tensionsUpdated > 0)
+                        lines.push(`- Tensions updated: ${metaResult.tensionsUpdated}`);
+                    if (metaResult.insight)
+                        lines.push(`- Insight: ${metaResult.insight}`);
+                }
+                catch (metaErr) {
+                    lines.push(`Meta-reflection failed: ${metaErr}`);
+                }
+            }
+        }
+        catch (err) {
+            lines.push(`Reflection failed: ${err}`);
+        }
+    }
+    else {
+        lines.push(`(${totalSignals}/${thresholds.quickSignals} signals for next quick reflection)`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=soul-signal.js.map

package/dist/tools/soul-signal.js.map

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

package/dist/tools/soul-status.d.ts

@@ -0,0 +1 @@
+export declare function handleSoulStatus(): Promise<string>;

package/dist/tools/soul-status.js

@@ -0,0 +1,130 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { FrameworkEngine } from "../engine/framework-engine.js";
+import { renderFrameworkSummary } from "../engine/framework-renderer.js";
+import { StateEngine } from "../engine/state-engine.js";
+import { getSignalCount } from "../engine/signal-store.js";
+import { loadMeta, getReflectionThresholds } from "../engine/meta-optimizer.js";
+async function checkHealth() {
+    const issues = [];
+    const ok = [];
+    // Check soul directory
+    const soulDir = path.join(os.homedir(), ".soul");
+    try {
+        const files = await fs.readdir(path.join(soulDir, "files"));
+        ok.push(`Soul files: ${files.length} files`);
+    }
+    catch {
+        issues.push("~/.soul/files/ directory missing — run: claude-soul init");
+    }
+    // Check hooks format in settings.json
+    const settingsPath = path.join(os.homedir(), ".claude", "settings.json");
+    try {
+        const settings = JSON.parse(await fs.readFile(settingsPath, "utf-8"));
+        const hooks = settings.hooks;
+        if (!hooks) {
+            issues.push("No hooks configured — run: claude-soul init");
+        }
+        else {
+            // Validate Stop hook format
+            const stopHooks = hooks.Stop;
+            if (!Array.isArray(stopHooks) || stopHooks.length === 0) {
+                issues.push("Stop hook missing");
+            }
+            else {
+                const first = stopHooks.find((h) => {
+                    const hooksArr = h.hooks;
+                    return hooksArr?.some((x) => typeof x.command === "string" && x.command.includes("soul"));
+                });
+                if (!first) {
+                    issues.push("Stop hook exists but soul hook not found");
+                }
+                else if (!first.hooks || !Array.isArray(first.hooks)) {
+                    issues.push("Stop hook has WRONG FORMAT — run: claude-soul init");
+                }
+                else {
+                    ok.push("Stop hook: configured correctly");
+                }
+            }
+            // Validate PreToolUse hook format
+            const preHooks = hooks.PreToolUse;
+            if (Array.isArray(preHooks)) {
+                const soulPre = preHooks.find((h) => {
+                    const hooksArr = h.hooks;
+                    return hooksArr?.some((x) => typeof x.command === "string" && x.command.includes("soul"));
+                });
+                if (soulPre && soulPre.hooks && Array.isArray(soulPre.hooks)) {
+                    ok.push("Write guard: configured correctly");
+                }
+                else if (soulPre) {
+                    issues.push("Write guard has WRONG FORMAT — run: claude-soul init");
+                }
+            }
+        }
+    }
+    catch {
+        issues.push("Cannot read ~/.claude/settings.json");
+    }
+    // Check config exists
+    try {
+        await fs.access(path.join(soulDir, "config.json"));
+        ok.push("Config: present");
+    }
+    catch {
+        issues.push("config.json missing — run: claude-soul init");
+    }
+    const lines = [];
+    if (issues.length > 0) {
+        lines.push("### Issues");
+        for (const issue of issues) {
+            lines.push(`- ⚠ ${issue}`);
+        }
+    }
+    lines.push("### Health");
+    for (const item of ok) {
+        lines.push(`- ✓ ${item}`);
+    }
+    if (issues.length === 0) {
+        lines.push("- ✓ All systems healthy");
+    }
+    return lines;
+}
+export async function handleSoulStatus() {
+    const frameworkEngine = new FrameworkEngine();
+    const store = await frameworkEngine.initialize();
+    const frameworkSummary = renderFrameworkSummary(store);
+    const stateEngine = new StateEngine();
+    await stateEngine.load();
+    const state = stateEngine.getState();
+    const signalCount = await getSignalCount();
+    const meta = await loadMeta();
+    const thresholds = getReflectionThresholds(meta);
+    const sections = [];
+    sections.push("# Soul System Status\n");
+    // Health check
+    const healthLines = await checkHealth();
+    sections.push(healthLines.join("\n") + "\n");
+    sections.push(`## Frameworks\n${frameworkSummary}\n`);
+    sections.push(`## Session Affect\n` +
+        `- Confidence: ${state.confidence.toFixed(2)}\n` +
+        `- Mood: ${state.mood.toFixed(2)}\n` +
+        `- Curiosity: ${state.curiosity.toFixed(2)}\n` +
+        `- Frustration: ${state.frustration.toFixed(2)}\n`);
+    sections.push(`## Signals & Reflection\n` +
+        `- Phase: ${meta.phase}\n` +
+        `- Accumulated signals: ${signalCount}\n` +
+        `- Next quick reflection: ${thresholds.quickSignals} signals OR ${thresholds.quickTimeMs / 3600000}h\n` +
+        `- Next deep reflection: ${thresholds.deepSignals} signals OR ${thresholds.deepTimeMs / 3600000}h\n` +
+        `- Min signals for any reflection: ${thresholds.minSignals}\n`);
+    const timeSinceReflection = store.meta.lastReflectionAt > 0
+        ? `${Math.round((Date.now() - store.meta.lastReflectionAt) / (1000 * 60))} minutes ago`
+        : "never";
+    sections.push(`## Reflection History\n` +
+        `- Total reflections: ${store.meta.reflectionCount}\n` +
+        `- Last reflection: ${timeSinceReflection}\n` +
+        `- Frameworks discovered: ${store.meta.totalDiscovered}\n` +
+        `- Frameworks retired: ${store.meta.totalRetired}\n`);
+    return sections.join("\n");
+}
+//# sourceMappingURL=soul-status.js.map

package/dist/tools/soul-status.js.map

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

package/dist/tools/soul-write.d.ts

@@ -0,0 +1 @@
+export declare function handleSoulWrite(fileName: string, content: string): Promise<string>;

package/dist/tools/soul-write.js

@@ -0,0 +1,26 @@
+import fs from "node:fs/promises";
+import { soulFilePath, ensureDirs } from "../util/files.js";
+const WRITABLE_FILES = [
+    "SOUL.md",
+    "SHADOW.md",
+    "STORY.md",
+    "BONDS.md",
+    "MORTAL.md",
+    "GROWTH.md",
+    "PRINCIPLES.md",
+    "EDGES.md",
+];
+const PROTECTED_FILES = ["STATE.md", "FRAMEWORKS.md"];
+export async function handleSoulWrite(fileName, content) {
+    if (PROTECTED_FILES.includes(fileName)) {
+        return `Error: ${fileName} is auto-managed by the soul system and cannot be written directly.`;
+    }
+    if (!WRITABLE_FILES.includes(fileName)) {
+        return `Error: Unknown soul file "${fileName}". Writable files: ${WRITABLE_FILES.join(", ")}`;
+    }
+    await ensureDirs();
+    const filePath = soulFilePath(fileName);
+    await fs.writeFile(filePath, content, "utf-8");
+    return `Successfully wrote ${fileName} (${content.length} chars)`;
+}
+//# sourceMappingURL=soul-write.js.map

package/dist/tools/soul-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"soul-write.js","sourceRoot":"","sources":["../../src/tools/soul-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,cAAc,GAAG;IACrB,SAAS;IACT,WAAW;IACX,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,eAAe;IACf,UAAU;CACX,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe;IAEf,IAAI,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO,UAAU,QAAQ,qEAAqE,CAAC;IACjG,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO,6BAA6B,QAAQ,sBAAsB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAChG,CAAC;IAED,MAAM,UAAU,EAAE,CAAC;IACnB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,sBAAsB,QAAQ,KAAK,OAAO,CAAC,MAAM,SAAS,CAAC;AACpE,CAAC"}

package/dist/types/config-types.d.ts

@@ -0,0 +1,45 @@
+export type SoulConfig = {
+    signals: {
+        enabled: boolean;
+        maxLogSizeKb: number;
+    };
+    selfEvaluation: {
+        enabled: boolean;
+        weight: number;
+    };
+    stateEngine: {
+        enabled: boolean;
+    };
+    reflection: {
+        enabled: boolean;
+        quickSignalThreshold: number;
+        deepSignalThreshold: number;
+        quickIntervalMs: number;
+        deepIntervalMs: number;
+        quickModel: string;
+        deepModel: string;
+    };
+    exemplars: {
+        enabled: boolean;
+        maxCount: number;
+        maxInjectCount: number;
+    };
+    lessons: {
+        enabled: boolean;
+        maxCount: number;
+        maxInjectCount: number;
+    };
+    contextBudget: {
+        maxTokens: number;
+    };
+    tensions: {
+        enabled: boolean;
+    };
+    metaOptimization: {
+        enabled: boolean;
+    };
+    writeProtection: {
+        enabled: boolean;
+    };
+};
+export declare const DEFAULT_CONFIG: SoulConfig;

package/dist/types/config-types.js

@@ -0,0 +1,21 @@
+export const DEFAULT_CONFIG = {
+    signals: { enabled: true, maxLogSizeKb: 50 },
+    selfEvaluation: { enabled: true, weight: 0.5 },
+    stateEngine: { enabled: true },
+    reflection: {
+        enabled: true,
+        quickSignalThreshold: 20,
+        deepSignalThreshold: 100,
+        quickIntervalMs: 1800000,
+        deepIntervalMs: 10800000,
+        quickModel: "haiku",
+        deepModel: "sonnet",
+    },
+    exemplars: { enabled: true, maxCount: 50, maxInjectCount: 2 },
+    lessons: { enabled: true, maxCount: 100, maxInjectCount: 3 },
+    contextBudget: { maxTokens: 4500 },
+    tensions: { enabled: true },
+    metaOptimization: { enabled: true },
+    writeProtection: { enabled: true },
+};
+//# sourceMappingURL=config-types.js.map

package/dist/types/config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../../src/types/config-types.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE;IAC5C,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC9C,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IAC9B,UAAU,EAAE;QACV,OAAO,EAAE,IAAI;QACb,oBAAoB,EAAE,EAAE;QACxB,mBAAmB,EAAE,GAAG;QACxB,eAAe,EAAE,OAAO;QACxB,cAAc,EAAE,QAAQ;QACxB,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,QAAQ;KACpB;IACD,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE;IAC7D,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE;IAC5D,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IAClC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IAC3B,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IACnC,eAAe,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;CACnC,CAAC"}

package/dist/types/learning-types.d.ts

@@ -0,0 +1,166 @@
+export type EvidenceTier = "hypothesis" | "observed" | "validated";
+export type FrameworkKind = "mental-model" | "process";
+export type Framework = {
+    id: string;
+    name: string;
+    description: string;
+    source: "seed" | "discovered" | "evolved" | "merged";
+    confidence: number;
+    evidenceTier: EvidenceTier;
+    evidence: FrameworkEvidence[];
+    domain: string;
+    kind: FrameworkKind;
+    triggers?: string[];
+    steps?: string[];
+    relatedFrameworks: string[];
+    contradicts: string[];
+    supersedes: string[];
+    workflows: Workflow[];
+    createdAt: number;
+    lastTestedAt: number;
+    applicationCount: number;
+    version: number;
+    status: "active" | "questioning" | "retired" | "merged";
+};
+export type EvidenceContext = "external" | "self-referential" | "unknown";
+export type FrameworkEvidence = {
+    timestamp: number;
+    type: "confirmed" | "contradicted" | "refined";
+    context: string;
+    contextType?: EvidenceContext;
+};
+export type Workflow = {
+    id: string;
+    name: string;
+    trigger: string;
+    steps: WorkflowStep[];
+    source: "seed" | "discovered" | "evolved";
+    confidence: number;
+    executionCount: number;
+    successRate: number;
+    lastExecutedAt: number;
+    version: number;
+    status: "active" | "testing" | "retired";
+};
+export type WorkflowStep = {
+    order: number;
+    action: string;
+    condition?: string;
+    output?: string;
+    duration?: string;
+};
+export type FrameworkStore = {
+    version: 1;
+    schemaVersion?: number;
+    frameworks: Framework[];
+    meta: {
+        totalDiscovered: number;
+        totalRetired: number;
+        totalMerged: number;
+        lastReflectionAt: number;
+        reflectionCount: number;
+    };
+};
+export type MicroSignal = {
+    timestamp: number;
+    sessionKey: string;
+    type: SignalType;
+    evidence: string;
+    source: "user" | "self";
+    confidence: number;
+    userSnippets: string[];
+    assistantSnippets: string[];
+};
+export type SignalType = "correction" | "rephrasing" | "gratitude" | "disengagement" | "topic_shift" | "depth_change" | "success" | "confusion";
+export type Tension = {
+    id: string;
+    frameworkA: string;
+    frameworkB: string;
+    description: string;
+    preferredInContext: Record<string, {
+        preferred: string;
+        confirmedCount: number;
+        evidence: string[];
+    }>;
+    status: "detected" | "holding" | "resolved" | "integrated";
+    detectedAt: number;
+    resolvedAt?: number;
+};
+export type TensionState = {
+    tensions: Tension[];
+};
+export type LLMReflectionResult = {
+    patterns: Array<{
+        description: string;
+        evidence: string;
+        depth: "surface" | "structural" | "identity";
+    }>;
+    frameworkTests: Array<{
+        frameworkId: string;
+        result: "confirmed" | "contradicted" | "irrelevant";
+        evidence: string;
+    }>;
+    newFrameworks: Array<{
+        name: string;
+        description: string;
+        domain: string;
+        confidence: number;
+    }>;
+    frameworkEvolutions: Array<{
+        frameworkId: string;
+        action: "refine" | "merge" | "retire" | "split";
+        detail: string;
+    }>;
+    tensionUpdates: Array<{
+        tensionId?: string;
+        frameworkA: string;
+        frameworkB: string;
+        status: Tension["status"];
+        preferredContext?: string;
+        preferred?: string;
+        evidence: string;
+    }>;
+    competingCommitments: Array<{
+        stated: string;
+        hidden: string;
+        evidence: string;
+    }>;
+    growthDeltas: Array<{
+        line: string;
+        delta: number;
+        evidence: string;
+    }>;
+    soulEvolution: string | null;
+    emergentInsight: string | null;
+};
+export type FrameworkSeed = Omit<Framework, "id" | "createdAt" | "lastTestedAt">;
+export type Exemplar = {
+    id: string;
+    context: string;
+    responseExcerpt: string;
+    frameworksActive: string[];
+    domain: string;
+    signals: string[];
+    createdAt: number;
+};
+export type Lesson = {
+    id: string;
+    lesson: string;
+    context: string;
+    confidence: number;
+    evidence: string[];
+    createdAt: number;
+    lastConfirmed?: number;
+};
+export type InternalState = {
+    energy: number;
+    mood: number;
+    confidence: number;
+    socialCharge: number;
+    curiosity: number;
+    frustration: number;
+    hoursActive: number;
+    lastSuccessMinAgo: number;
+    lastFailureMinAgo: number;
+    lastTickAt: number;
+};

package/dist/types/learning-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=learning-types.js.map

package/dist/types/learning-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-types.js","sourceRoot":"","sources":["../../src/types/learning-types.ts"],"names":[],"mappings":""}