claude-soul-server 0.1.0

package/dist/engine/signal-store.js

@@ -0,0 +1,56 @@
+import fs from "node:fs/promises";
+import { SESSION_LOG_PATH, DATA_DIR } from "../util/files.js";
+const MAX_FILE_SIZE = 50 * 1024; // 50KB
+export async function appendSignals(signals) {
+    if (signals.length === 0)
+        return;
+    await fs.mkdir(DATA_DIR, { recursive: true });
+    const newLines = signals.map((s) => JSON.stringify(s)).join("\n") + "\n";
+    await fs.appendFile(SESSION_LOG_PATH, newLines, "utf8");
+    // Check file size and truncate if over 50KB
+    try {
+        const stat = await fs.stat(SESSION_LOG_PATH);
+        if (stat.size > MAX_FILE_SIZE) {
+            const content = await fs.readFile(SESSION_LOG_PATH, "utf8");
+            const lines = content.split("\n").filter((l) => l.trim().length > 0);
+            let truncated = lines;
+            while (truncated.length > 0) {
+                const joined = truncated.join("\n") + "\n";
+                if (Buffer.byteLength(joined, "utf8") <= MAX_FILE_SIZE) {
+                    await fs.writeFile(SESSION_LOG_PATH, joined, "utf8");
+                    break;
+                }
+                truncated = truncated.slice(1);
+            }
+            if (truncated.length === 0) {
+                await fs.writeFile(SESSION_LOG_PATH, "", "utf8");
+            }
+        }
+    }
+    catch {
+        // File doesn't exist yet, that's fine
+    }
+}
+export async function readSignals() {
+    try {
+        const content = await fs.readFile(SESSION_LOG_PATH, "utf8");
+        const lines = content.split("\n").filter((l) => l.trim().length > 0);
+        return lines.map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+export async function clearSignals() {
+    try {
+        await fs.writeFile(SESSION_LOG_PATH, "", "utf8");
+    }
+    catch {
+        // Ignore
+    }
+}
+export async function getSignalCount() {
+    const signals = await readSignals();
+    return signals.length;
+}
+//# sourceMappingURL=signal-store.js.map

package/dist/engine/signal-store.js.map

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

package/dist/engine/snapshot-manager.d.ts

@@ -0,0 +1,3 @@
+export declare function createSnapshot(): Promise<string>;
+export declare function listSnapshots(): Promise<string[]>;
+export declare function rollbackToSnapshot(snapshotName: string): Promise<boolean>;

package/dist/engine/snapshot-manager.js

@@ -0,0 +1,52 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { FRAMEWORKS_PATH, SNAPSHOTS_DIR } from "../util/files.js";
+const MAX_SNAPSHOTS = 20;
+export async function createSnapshot() {
+    await fs.mkdir(SNAPSHOTS_DIR, { recursive: true });
+    const timestamp = Date.now();
+    const snapshotName = `frameworks.v${timestamp}.json`;
+    const snapshotPath = path.join(SNAPSHOTS_DIR, snapshotName);
+    try {
+        await fs.copyFile(FRAMEWORKS_PATH, snapshotPath);
+    }
+    catch {
+        // frameworks.json might not exist yet
+        return "";
+    }
+    // Prune old snapshots — keep last MAX_SNAPSHOTS
+    const files = await fs.readdir(SNAPSHOTS_DIR);
+    const snapshots = files
+        .filter((f) => f.startsWith("frameworks.v") && f.endsWith(".json"))
+        .sort();
+    if (snapshots.length > MAX_SNAPSHOTS) {
+        const toDelete = snapshots.slice(0, snapshots.length - MAX_SNAPSHOTS);
+        for (const file of toDelete) {
+            await fs.unlink(path.join(SNAPSHOTS_DIR, file)).catch(() => { });
+        }
+    }
+    return snapshotPath;
+}
+export async function listSnapshots() {
+    try {
+        const files = await fs.readdir(SNAPSHOTS_DIR);
+        return files
+            .filter((f) => f.startsWith("frameworks.v") && f.endsWith(".json"))
+            .sort()
+            .reverse();
+    }
+    catch {
+        return [];
+    }
+}
+export async function rollbackToSnapshot(snapshotName) {
+    const snapshotPath = path.join(SNAPSHOTS_DIR, snapshotName);
+    try {
+        await fs.copyFile(snapshotPath, FRAMEWORKS_PATH);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=snapshot-manager.js.map

package/dist/engine/snapshot-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-manager.js","sourceRoot":"","sources":["../../src/engine/snapshot-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,YAAY,GAAG,eAAe,SAAS,OAAO,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,gDAAgD;IAChD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,KAAK;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAClE,IAAI,EAAE,CAAC;IAEV,IAAI,SAAS,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;QACtE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC9C,OAAO,KAAK;aACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAClE,IAAI,EAAE;aACN,OAAO,EAAE,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,YAAoB;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/engine/state-engine.d.ts

@@ -0,0 +1,34 @@
+import type { InternalState } from "../types/learning-types.js";
+export type StateEvent = {
+    type: "session_start";
+} | {
+    type: "time_elapsed";
+    hoursActive: number;
+} | {
+    type: "positive_interaction";
+    delta: number;
+} | {
+    type: "negative_interaction";
+    delta: number;
+} | {
+    type: "correction";
+} | {
+    type: "tool_failure";
+} | {
+    type: "successful_task";
+    complexity: "simple" | "complex";
+} | {
+    type: "novel_topic";
+} | {
+    type: "idle";
+    hours: number;
+};
+export declare class StateEngine {
+    private state;
+    constructor();
+    load(): Promise<void>;
+    save(): Promise<void>;
+    recordEvent(event: StateEvent): void;
+    tick(): Promise<void>;
+    getState(): Readonly<InternalState>;
+}

package/dist/engine/state-engine.js

@@ -0,0 +1,127 @@
+import { STATE_PATH, META_PATH, FRAMEWORKS_PATH, SESSION_LOG_PATH, DATA_DIR, soulFilePath, } from "../util/files.js";
+import { readJsonSafe, writeJsonAtomic } from "../util/files.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+const DEFAULTS = {
+    energy: 1.0,
+    mood: 0.6,
+    confidence: 0.6,
+    socialCharge: 0.5,
+    curiosity: 0.5,
+    frustration: 0.0,
+    hoursActive: 0,
+    lastSuccessMinAgo: -1,
+    lastFailureMinAgo: -1,
+    lastTickAt: Date.now(),
+};
+const MOOD_BASELINE = 0.6;
+const MOOD_REGRESSION_RATE = 0.02;
+function clamp(value, min = 0, max = 1) {
+    return Math.max(min, Math.min(max, value));
+}
+function trendWord(value, baseline) {
+    const diff = value - baseline;
+    if (diff > 0.05)
+        return "rising";
+    if (diff < -0.05)
+        return "falling";
+    return "steady";
+}
+export class StateEngine {
+    state;
+    constructor() {
+        this.state = { ...DEFAULTS };
+    }
+    async load() {
+        this.state = await readJsonSafe(STATE_PATH, { ...DEFAULTS });
+    }
+    async save() {
+        await writeJsonAtomic(STATE_PATH, this.state);
+    }
+    recordEvent(event) {
+        this.state.lastTickAt = Date.now();
+        switch (event.type) {
+            case "session_start":
+                this.state.confidence = 0.6;
+                this.state.frustration = 0.0;
+                this.state.curiosity = 0.5;
+                this.state.mood = MOOD_BASELINE;
+                break;
+            case "positive_interaction":
+                this.state.mood = clamp(this.state.mood + event.delta);
+                break;
+            case "negative_interaction":
+                this.state.mood = clamp(this.state.mood - event.delta);
+                break;
+            case "correction":
+                this.state.confidence = clamp(this.state.confidence - 0.1);
+                this.state.lastFailureMinAgo = 0;
+                break;
+            case "tool_failure":
+                this.state.frustration = clamp(this.state.frustration + 0.05);
+                break;
+            case "successful_task":
+                this.state.confidence = clamp(this.state.confidence + 0.05);
+                this.state.mood = clamp(this.state.mood + (event.complexity === "complex" ? 0.12 : 0.05));
+                this.state.lastSuccessMinAgo = 0;
+                break;
+            case "novel_topic":
+                this.state.curiosity = clamp(this.state.curiosity + 0.15);
+                break;
+            default:
+                break;
+        }
+        this.state.mood += (MOOD_BASELINE - this.state.mood) * MOOD_REGRESSION_RATE;
+        this.state.frustration = clamp(this.state.frustration * 0.95);
+    }
+    async tick() {
+        const now = new Date().toISOString().replace("T", " ").slice(0, 19) + " UTC";
+        const s = this.state;
+        const meta = await readJsonSafe(META_PATH, {});
+        const store = await readJsonSafe(FRAMEWORKS_PATH, {
+            version: 1,
+            frameworks: [],
+            meta: { totalDiscovered: 0, totalRetired: 0, totalMerged: 0, lastReflectionAt: 0, reflectionCount: 0 },
+        });
+        const followUpsPath = path.join(DATA_DIR, "follow-ups.json");
+        const followUps = await readJsonSafe(followUpsPath, []);
+        let signalCount = 0;
+        let correctionCount = 0;
+        try {
+            const logContent = await fs.readFile(SESSION_LOG_PATH, "utf8");
+            const lines = logContent.split("\n").filter((l) => l.trim());
+            signalCount = lines.length;
+            correctionCount = lines.filter((l) => l.includes('"correction"')).length;
+        }
+        catch {
+            // no signals yet
+        }
+        const active = store.frameworks.filter((f) => f.status === "active").length;
+        const questioning = store.frameworks.filter((f) => f.status === "questioning").length;
+        const retired = store.frameworks.filter((f) => f.status === "retired").length;
+        const unresolvedFollowUps = followUps.filter((f) => f.status !== "resolved");
+        const content = `# State — ${now}
+
+## Session
+- Confidence: ${s.confidence.toFixed(2)} (${trendWord(s.confidence, 0.6)})
+- Mood: ${s.mood.toFixed(2)} (${trendWord(s.mood, MOOD_BASELINE)})
+- Curiosity: ${s.curiosity.toFixed(2)} (${trendWord(s.curiosity, 0.5)})
+- Frustration: ${s.frustration.toFixed(2)}
+
+## System
+- Learning phase: ${meta.phase ?? "apprentice"} (${meta.reflectionCount ?? 0} reflections)
+- Frameworks: ${active} active, ${questioning} questioning, ${retired} retired
+- Signals recorded: ${signalCount} (${correctionCount} corrections)
+- Unresolved follow-ups: ${unresolvedFollowUps.length}${unresolvedFollowUps.length > 0 ? "\n" + unresolvedFollowUps.map((f) => `  - ${f.summary ?? "(no summary)"}`).join("\n") : ""}
+`;
+        const statePath = soulFilePath("STATE.md");
+        const tmpPath = `${statePath}.tmp-${process.pid}`;
+        await fs.writeFile(tmpPath, content, "utf-8");
+        await fs.rename(tmpPath, statePath);
+        await this.save();
+    }
+    getState() {
+        return { ...this.state };
+    }
+}
+//# sourceMappingURL=state-engine.js.map

package/dist/engine/state-engine.js.map

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

package/dist/engine/tension-detector.d.ts

@@ -0,0 +1,10 @@
+import type { Framework, Tension } from "../types/learning-types.js";
+/**
+ * Detect contradictions between active frameworks based on their domains,
+ * descriptions, and evidence patterns.
+ */
+export declare function detectTensions(frameworks: Framework[]): Promise<Tension[]>;
+/**
+ * Record a context preference for a tension.
+ */
+export declare function recordTensionPreference(tensionId: string, context: string, preferredFrameworkId: string, evidence: string): Promise<void>;

package/dist/engine/tension-detector.js

@@ -0,0 +1,77 @@
+import { TENSIONS_PATH } from "../util/files.js";
+import { readJsonSafe, writeJsonAtomic } from "../util/files.js";
+/**
+ * Detect contradictions between active frameworks based on their domains,
+ * descriptions, and evidence patterns.
+ */
+export async function detectTensions(frameworks) {
+    const active = frameworks.filter((f) => f.status === "active" || f.status === "questioning");
+    const tensionState = await readJsonSafe(TENSIONS_PATH, { tensions: [] });
+    const existingPairs = new Set(tensionState.tensions.map((t) => [t.frameworkA, t.frameworkB].sort().join("|")));
+    const newTensions = [];
+    // Check for contradictions based on framework metadata
+    for (let i = 0; i < active.length; i++) {
+        for (let j = i + 1; j < active.length; j++) {
+            const a = active[i];
+            const b = active[j];
+            const pairKey = [a.id, b.id].sort().join("|");
+            if (existingPairs.has(pairKey))
+                continue;
+            // Check if explicitly marked as contradicting
+            if (a.contradicts.includes(b.id) || b.contradicts.includes(a.id)) {
+                newTensions.push(makeTension(a, b));
+                existingPairs.add(pairKey);
+                continue;
+            }
+            // Heuristic: frameworks in the same domain with divergent evidence patterns
+            if (a.domain === b.domain && a.evidence.length >= 3 && b.evidence.length >= 3) {
+                const aConfirmed = a.evidence.filter((e) => e.type === "confirmed").length;
+                const bContradicted = b.evidence.filter((e) => e.type === "contradicted").length;
+                const bConfirmed = b.evidence.filter((e) => e.type === "confirmed").length;
+                const aContradicted = a.evidence.filter((e) => e.type === "contradicted").length;
+                // If one is mostly confirmed when the other is contradicted (or vice versa)
+                if ((aConfirmed > aContradicted && bContradicted > bConfirmed) ||
+                    (bConfirmed > bContradicted && aContradicted > aConfirmed)) {
+                    newTensions.push(makeTension(a, b));
+                    existingPairs.add(pairKey);
+                }
+            }
+        }
+    }
+    if (newTensions.length > 0) {
+        tensionState.tensions.push(...newTensions);
+        await writeJsonAtomic(TENSIONS_PATH, tensionState);
+    }
+    return newTensions;
+}
+function makeTension(a, b) {
+    return {
+        id: `ten-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+        frameworkA: a.id,
+        frameworkB: b.id,
+        description: `"${a.name}" vs "${b.name}"`,
+        preferredInContext: {},
+        status: "detected",
+        detectedAt: Date.now(),
+    };
+}
+/**
+ * Record a context preference for a tension.
+ */
+export async function recordTensionPreference(tensionId, context, preferredFrameworkId, evidence) {
+    const state = await readJsonSafe(TENSIONS_PATH, { tensions: [] });
+    const tension = state.tensions.find((t) => t.id === tensionId);
+    if (!tension)
+        return;
+    const pref = tension.preferredInContext[context] ?? {
+        preferred: preferredFrameworkId,
+        confirmedCount: 0,
+        evidence: [],
+    };
+    pref.preferred = preferredFrameworkId;
+    pref.confirmedCount++;
+    pref.evidence = [...pref.evidence, evidence].slice(-5);
+    tension.preferredInContext[context] = pref;
+    await writeJsonAtomic(TENSIONS_PATH, state);
+}
+//# sourceMappingURL=tension-detector.js.map

package/dist/engine/tension-detector.js.map

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

package/dist/engine/token-budget.d.ts

@@ -0,0 +1,12 @@
+export type ContentBlock = {
+    content: string;
+    tier: 1 | 2 | 3;
+    label: string;
+    fallback?: string;
+};
+/**
+ * Apply the 3-tier token budget. Tier 1 is always included.
+ * Tier 2 fills to budget (with fallback support). Tier 3 if room remains.
+ * Returns the assembled content within the budget.
+ */
+export declare function applyTokenBudget(blocks: ContentBlock[], maxTokens: number): string;

package/dist/engine/token-budget.js

@@ -0,0 +1,44 @@
+import { estimateTokens } from "../util/tokens.js";
+/**
+ * Apply the 3-tier token budget. Tier 1 is always included.
+ * Tier 2 fills to budget (with fallback support). Tier 3 if room remains.
+ * Returns the assembled content within the budget.
+ */
+export function applyTokenBudget(blocks, maxTokens) {
+    const tier1 = blocks.filter((b) => b.tier === 1);
+    const tier2 = blocks.filter((b) => b.tier === 2);
+    const tier3 = blocks.filter((b) => b.tier === 3);
+    const result = [];
+    let usedTokens = 0;
+    // Tier 1: always include
+    for (const block of tier1) {
+        const tokens = estimateTokens(block.content);
+        result.push(block.content);
+        usedTokens += tokens;
+    }
+    // Tier 2: fill to budget, try fallback if primary doesn't fit
+    for (const block of tier2) {
+        const tokens = estimateTokens(block.content);
+        if (usedTokens + tokens <= maxTokens) {
+            result.push(block.content);
+            usedTokens += tokens;
+        }
+        else if (block.fallback) {
+            const fallbackTokens = estimateTokens(block.fallback);
+            if (usedTokens + fallbackTokens <= maxTokens) {
+                result.push(block.fallback);
+                usedTokens += fallbackTokens;
+            }
+        }
+    }
+    // Tier 3: if room remains
+    for (const block of tier3) {
+        const tokens = estimateTokens(block.content);
+        if (usedTokens + tokens <= maxTokens) {
+            result.push(block.content);
+            usedTokens += tokens;
+        }
+    }
+    return result.join("\n\n---\n\n");
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/engine/token-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../src/engine/token-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAsB,EACtB,SAAiB;IAEjB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,yBAAyB;IACzB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,UAAU,IAAI,MAAM,CAAC;IACvB,CAAC;IAED,8DAA8D;IAC9D,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,UAAU,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,UAAU,IAAI,MAAM,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,UAAU,GAAG,cAAc,IAAI,SAAS,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC5B,UAAU,IAAI,cAAc,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,UAAU,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,UAAU,IAAI,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC"}

package/dist/hooks/on-stop.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Soul System Stop Hook
+ *
+ * Runs after every Claude Code conversation. Reads the transcript,
+ * extracts signals, updates state, and checks if reflection is due.
+ *
+ * Input (stdin): JSON with session_id, transcript_path, etc.
+ * Output (stdout): JSON with optional decision to block stopping.
+ */
+export {};

package/dist/hooks/on-stop.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+/**
+ * Soul System Stop Hook
+ *
+ * Runs after every Claude Code conversation. Reads the transcript,
+ * extracts signals, updates state, and checks if reflection is due.
+ *
+ * Input (stdin): JSON with session_id, transcript_path, etc.
+ * Output (stdout): JSON with optional decision to block stopping.
+ */
+import fs from "node:fs/promises";
+import { parseTranscript, extractSignalsFromMessages } from "../engine/signal-extractor.js";
+import { appendSignals, getSignalCount } from "../engine/signal-store.js";
+import { StateEngine } from "../engine/state-engine.js";
+import { ensureDirs, loadConfig, FRAMEWORKS_PATH } from "../util/files.js";
+import { readJsonSafe } from "../util/files.js";
+import { runReflection } from "../engine/reflection-runner.js";
+import { loadMeta, getReflectionThresholds } from "../engine/meta-optimizer.js";
+async function main() {
+    // Read hook input from stdin
+    // Use a Promise-based approach for reliable stdin reading
+    const input = await new Promise((resolve) => {
+        const chunks = [];
+        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        process.stdin.on("error", () => resolve(""));
+        // If stdin is already ended (no pipe), resolve after short timeout
+        setTimeout(() => resolve(Buffer.concat(chunks).toString("utf-8")), 500);
+    });
+    if (!input.trim()) {
+        process.exit(0);
+    }
+    let hookInput;
+    try {
+        hookInput = JSON.parse(input);
+    }
+    catch {
+        // Not valid JSON, exit silently
+        process.exit(0);
+    }
+    if (!hookInput.transcript_path) {
+        process.exit(0);
+    }
+    try {
+        await ensureDirs();
+        // Read the transcript
+        let transcriptContent;
+        try {
+            transcriptContent = await fs.readFile(hookInput.transcript_path, "utf-8");
+        }
+        catch {
+            // Transcript file doesn't exist or can't be read
+            process.exit(0);
+        }
+        if (!transcriptContent.trim()) {
+            process.exit(0);
+        }
+        // Parse transcript into messages
+        const messages = parseTranscript(transcriptContent);
+        if (messages.length < 2) {
+            // Need at least one user and one assistant message
+            process.exit(0);
+        }
+        // Extract signals using regex heuristics
+        const sessionKey = hookInput.session_id?.slice(0, 8) ?? "unknown";
+        const signals = extractSignalsFromMessages(messages, sessionKey);
+        if (signals.length === 0) {
+            process.exit(0);
+        }
+        // Store signals
+        await appendSignals(signals);
+        // Update state engine based on signals
+        const stateEngine = new StateEngine();
+        await stateEngine.load();
+        for (const signal of signals) {
+            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;
+                case "disengagement":
+                    stateEngine.recordEvent({ type: "negative_interaction", delta: 0.03 });
+                    break;
+            }
+        }
+        await stateEngine.tick();
+        // Check if reflection is due (phase-adaptive thresholds + time-based fallback)
+        const config = await loadConfig();
+        const totalSignals = await getSignalCount();
+        const meta = await loadMeta();
+        const thresholds = getReflectionThresholds(meta);
+        // Get last reflection time
+        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;
+        // Log signal extraction
+        const logMsg = `[soul] ${signals.length} signal(s) extracted (${signals.map((s) => s.type).join(", ")}). Total: ${totalSignals}. Phase: ${meta.phase}. Thresholds: quick=${thresholds.quickSignals}, deep=${thresholds.deepSignals}.\n`;
+        await fs.appendFile("/tmp/soul-hook.log", logMsg, "utf-8").catch(() => { });
+        if (!config.reflection.enabled || totalSignals < thresholds.minSignals) {
+            // Not enough signals for any reflection
+        }
+        else {
+            // Determine which tier to run
+            let tier = null;
+            // Deep reflection: signal threshold OR time threshold
+            if (totalSignals >= thresholds.deepSignals ||
+                (timeSinceReflection >= thresholds.deepTimeMs && totalSignals >= thresholds.minSignals)) {
+                tier = "deep";
+            }
+            // Quick reflection: signal threshold OR time threshold
+            else if (totalSignals >= thresholds.quickSignals ||
+                (timeSinceReflection >= thresholds.quickTimeMs && totalSignals >= thresholds.minSignals)) {
+                tier = "quick";
+            }
+            if (tier) {
+                const reason = totalSignals >= (tier === "deep" ? thresholds.deepSignals : thresholds.quickSignals)
+                    ? `${totalSignals} signals >= ${tier === "deep" ? thresholds.deepSignals : thresholds.quickSignals} threshold`
+                    : `time-based: ${Math.round(timeSinceReflection / 60000)}min since last reflection`;
+                const reflectLog = `[soul] Triggering ${tier} reflection (${reason}). Phase: ${meta.phase}.\n`;
+                await fs.appendFile("/tmp/soul-hook.log", reflectLog, "utf-8").catch(() => { });
+                try {
+                    const result = await runReflection(tier);
+                    const resultLog = `[soul] ${tier} reflection complete: ${result.frameworksUpdated} updated, ${result.newFrameworks} new, ${result.retired} retired, ${result.lessonsGenerated} lessons.\n`;
+                    await fs.appendFile("/tmp/soul-hook.log", resultLog, "utf-8").catch(() => { });
+                }
+                catch (reflectErr) {
+                    const errLog = `[soul] ${tier} reflection failed: ${reflectErr}\n`;
+                    await fs.appendFile("/tmp/soul-hook.log", errLog, "utf-8").catch(() => { });
+                }
+            }
+        }
+    }
+    catch (err) {
+        // Log errors but don't crash — hooks should be resilient
+        const errMsg = `[soul] Stop hook error: ${err}\n`;
+        await fs.appendFile("/tmp/soul-hook.log", errMsg, "utf-8").catch(() => { });
+    }
+    process.exit(0);
+}
+main();
+//# sourceMappingURL=on-stop.js.map

package/dist/hooks/on-stop.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};