claude-soul-server 0.1.0

package/dist/index.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { handleSoulContext } from "./tools/soul-context.js";
+import { handleSoulSignal } from "./tools/soul-signal.js";
+import { handleSoulRead } from "./tools/soul-read.js";
+import { handleSoulWrite } from "./tools/soul-write.js";
+import { handleSoulStatus } from "./tools/soul-status.js";
+import { handleSoulReflect } from "./tools/soul-reflect.js";
+import { handleSoulEvaluate } from "./tools/soul-evaluate.js";
+import { handleSoulActivate } from "./tools/soul-activate.js";
+import { handleSoulFramework } from "./tools/soul-framework.js";
+const server = new McpServer({
+    name: "claude-soul",
+    version: "0.1.0",
+});
+server.tool("soul_context", "Load your soul context — identity, frameworks, signals, lessons, and state. Call this at the start of every conversation. Default is 'full' (~4500 tokens). Use 'slim' for identity only.", {
+    mode: z.enum(["slim", "full"]).optional()
+        .describe("Context mode: 'full' (default) = identity + frameworks + signals + lessons + state. 'slim' = identity only."),
+}, async ({ mode }) => {
+    try {
+        const context = await handleSoulContext(mode ?? "full");
+        return { content: [{ type: "text", text: context }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error loading soul context: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_activate", "Select and load relevant frameworks for this conversation. Call after reading the user's first message to pick the most applicable frameworks.", {
+    message: z.string().describe("The user's first message or a summary of the conversation topic"),
+}, async ({ message }) => {
+    try {
+        const result = await handleSoulActivate(message);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error activating frameworks: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_framework", "Load a single framework with full details: description, evidence history, tier, and relationships.", {
+    name: z.string().describe("Framework name (case-insensitive, partial match) or ID"),
+}, async ({ name }) => {
+    try {
+        const result = await handleSoulFramework(name);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error loading framework: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_signal", "Record observed signals from this interaction. Use when you notice patterns the automatic extractor might miss.", {
+    signals: z
+        .array(z.object({
+        type: z.enum([
+            "correction",
+            "rephrasing",
+            "gratitude",
+            "disengagement",
+            "topic_shift",
+            "depth_change",
+            "success",
+            "confusion",
+        ]),
+        evidence: z.string().describe("What you observed"),
+        confidence: z.number().min(0).max(1).optional(),
+    }))
+        .describe("Array of observed signals"),
+}, async ({ signals }) => {
+    try {
+        const result = await handleSoulSignal(signals);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error recording signals: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_read", "Read a soul file. Available: SOUL.md, SHADOW.md, STATE.md, STORY.md, CORRECTIONS.md, FRAMEWORKS.md, BONDS.md, MORTAL.md, GROWTH.md, PRINCIPLES.md, EDGES.md", {
+    file: z.string().describe("Soul file name (e.g., SOUL.md)"),
+}, async ({ file }) => {
+    try {
+        const content = await handleSoulRead(file);
+        return { content: [{ type: "text", text: content }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error reading soul file: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_write", "Write to a soul file. SOUL.md, SHADOW.md, STORY.md, CORRECTIONS.md, BONDS.md, MORTAL.md, GROWTH.md, PRINCIPLES.md, EDGES.md are writable. STATE.md and FRAMEWORKS.md are auto-managed.", {
+    file: z.string().describe("Soul file name (e.g., SOUL.md)"),
+    content: z.string().describe("New content for the file"),
+}, async ({ file, content }) => {
+    try {
+        const result = await handleSoulWrite(file, content);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error writing soul file: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_status", "Get current system status — framework count, learning phase, signal count, last reflection time.", {}, async () => {
+    try {
+        const status = await handleSoulStatus();
+        return { content: [{ type: "text", text: status }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error getting status: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_reflect", "Trigger a reflection cycle. Quick: tests frameworks against recent signals. Deep: full analysis with framework discovery. Meta: audits framework coherence and redundancy.", {
+    tier: z
+        .enum(["quick", "deep", "meta"])
+        .describe("Reflection tier: quick (fast, signal testing), deep (thorough, discovers new frameworks), meta (audits the system itself)"),
+}, async ({ tier }) => {
+    try {
+        const result = await handleSoulReflect(tier);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error during reflection: ${err}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("soul_self_evaluate", "Record a self-evaluation of a complex response. Be descriptive: 'Response used 450 words for a simple question' not 'bad response'.", {
+    summary: z
+        .string()
+        .describe("Brief descriptive summary of the response and its dynamics"),
+}, async ({ summary }) => {
+    try {
+        const result = await handleSoulEvaluate(summary);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error during self-evaluation: ${err}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Claude Soul MCP server failed to start:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

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

package/dist/tools/soul-activate.js

@@ -0,0 +1,149 @@
+import { FrameworkEngine } from "../engine/framework-engine.js";
+import { callClaude, parseLlmJson } from "../util/llm.js";
+import { loadConfig } from "../util/files.js";
+/**
+ * Build the activation prompt — asks an LLM to select relevant frameworks for this conversation.
+ */
+function buildActivationPrompt(frameworks, userMessage) {
+    const eligible = frameworks
+        .filter((f) => f.status === "active" || f.status === "questioning")
+        .sort((a, b) => b.confidence - a.confidence);
+    const models = eligible.filter((f) => f.kind !== "process");
+    const processes = eligible.filter((f) => f.kind === "process");
+    const modelIndex = models
+        .map((f) => {
+        const tier = f.evidenceTier ?? "hypothesis";
+        return `- ${f.id}: ${f.name} [${tier}] (${f.status}) — ${f.description.slice(0, 150)}`;
+    })
+        .join("\n");
+    const processIndex = processes
+        .map((f) => {
+        const tier = f.evidenceTier ?? "hypothesis";
+        const triggers = (f.triggers ?? []).slice(0, 3).join("; ");
+        return `- ${f.id}: ${f.name} [${tier}] (${f.status}) — Triggers: ${triggers}`;
+    })
+        .join("\n");
+    return [
+        "You are selecting thinking frameworks for an upcoming conversation.",
+        "",
+        "## Available Mental Models (thinking vocabulary)",
+        "",
+        modelIndex || "  (none)",
+        "",
+        "## Available Cognitive Processes (actionable checklists)",
+        "",
+        processIndex || "  (none)",
+        "",
+        "## User's First Message",
+        "",
+        userMessage,
+        "",
+        "## Task",
+        "",
+        "Select 5-8 mental models most relevant as thinking vocabulary for this conversation.",
+        "Also select 0-2 cognitive processes whose triggers match the conversation type.",
+        "Only select processes when their triggers clearly apply — do not over-activate.",
+        "",
+        "Consider: the topic, type of task (building, debugging, explaining, reviewing, discussing),",
+        "and which named concepts are most likely to be useful.",
+        "",
+        "Also classify the conversation type for future context-tagging.",
+        "",
+        "## JSON Output",
+        "",
+        "Respond with ONLY a valid JSON object:",
+        "",
+        "```json",
+        JSON.stringify({
+            conversationType: "building|debugging|explaining|reviewing|meta|general",
+            selectedIds: ["framework-id-1", "framework-id-2"],
+            selectedProcessIds: ["process-id-1"],
+            reasoning: "brief explanation",
+        }, null, 2),
+        "```",
+    ].join("\n");
+}
+/**
+ * Render selected frameworks as a concept vocabulary for this conversation.
+ */
+function renderSelectedFrameworks(frameworks, conversationType) {
+    const models = frameworks.filter((f) => f.kind !== "process");
+    const processes = frameworks.filter((f) => f.kind === "process");
+    const lines = [];
+    lines.push(`## Activated Frameworks (${conversationType})`);
+    lines.push("");
+    lines.push("Named concepts selected for this conversation. Apply as thinking vocabulary when relevant:");
+    lines.push("");
+    for (const fw of models) {
+        const tier = fw.evidenceTier ?? "hypothesis";
+        lines.push(`### ${fw.name} [${tier}]`);
+        lines.push(fw.description);
+        lines.push("");
+    }
+    if (processes.length > 0) {
+        lines.push("## Active Cognitive Processes");
+        lines.push("");
+        lines.push("Procedures to follow when triggered. These are active checklists, not optional vocabulary.");
+        lines.push("");
+        for (const p of processes) {
+            const tier = p.evidenceTier ?? "hypothesis";
+            lines.push(`### ${p.name} [${tier}]`);
+            lines.push(p.description);
+            if (p.triggers && p.triggers.length > 0) {
+                lines.push(`**Triggers**: ${p.triggers.join(" | ")}`);
+            }
+            if (p.steps && p.steps.length > 0) {
+                for (const [i, step] of p.steps.entries()) {
+                    lines.push(`${i + 1}. ${step}`);
+                }
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+export async function handleSoulActivate(firstMessage) {
+    const config = await loadConfig();
+    const engine = new FrameworkEngine();
+    const store = await engine.initialize();
+    const eligible = store.frameworks.filter((f) => f.status === "active" || f.status === "questioning");
+    // If few enough frameworks, skip the LLM call and return all
+    if (eligible.length <= 8) {
+        return renderSelectedFrameworks(eligible, "general");
+    }
+    const prompt = buildActivationPrompt(store.frameworks, firstMessage);
+    let responseText;
+    try {
+        responseText = await callClaude(prompt, config.reflection.quickModel);
+    }
+    catch (err) {
+        // Fallback: return top 8 by confidence if LLM call fails
+        const fallback = eligible
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, 8);
+        return renderSelectedFrameworks(fallback, "general") +
+            "\n\n*(Activation used confidence-based fallback — LLM selection unavailable)*";
+    }
+    const parsed = parseLlmJson(responseText);
+    if (!parsed) {
+        const fallback = eligible
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, 8);
+        return renderSelectedFrameworks(fallback, "general") +
+            "\n\n*(Activation used confidence-based fallback — could not parse LLM response)*";
+    }
+    const selectedIds = parsed.selectedIds ?? [];
+    const selectedProcessIds = parsed.selectedProcessIds ?? [];
+    const allSelectedIds = [...new Set([...selectedIds, ...selectedProcessIds])];
+    const conversationType = parsed.conversationType ?? "general";
+    const selected = store.frameworks.filter((f) => allSelectedIds.includes(f.id));
+    // If LLM selected nothing useful, fall back to top by confidence
+    if (selected.length === 0) {
+        const fallback = eligible
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, 8);
+        return renderSelectedFrameworks(fallback, conversationType);
+    }
+    return renderSelectedFrameworks(selected, conversationType);
+}
+//# sourceMappingURL=soul-activate.js.map

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

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

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

@@ -0,0 +1 @@
+export declare function handleSoulContext(mode?: "slim" | "full"): Promise<string>;

package/dist/tools/soul-context.js

@@ -0,0 +1,31 @@
+import fs from "node:fs/promises";
+import { assembleSoulContext, assembleSlimContext } from "../engine/context-assembler.js";
+import { loadConfig, ensureDirs, soulFilePath } from "../util/files.js";
+import { FrameworkEngine } from "../engine/framework-engine.js";
+import { renderFrameworksToMarkdown } from "../engine/framework-renderer.js";
+import { StateEngine } from "../engine/state-engine.js";
+export async function handleSoulContext(mode = "full") {
+    await ensureDirs();
+    if (mode === "slim") {
+        const context = await assembleSlimContext();
+        if (!context.trim()) {
+            return "Soul system initialized but no context files found yet. Soul files are at ~/.soul/files/";
+        }
+        return context;
+    }
+    const frameworkEngine = new FrameworkEngine();
+    const store = await frameworkEngine.initialize();
+    const frameworksMd = renderFrameworksToMarkdown(store);
+    await fs.writeFile(soulFilePath("FRAMEWORKS.md"), frameworksMd, "utf-8");
+    const stateEngine = new StateEngine();
+    await stateEngine.load();
+    stateEngine.recordEvent({ type: "session_start" });
+    await stateEngine.tick();
+    const config = await loadConfig();
+    const context = await assembleSoulContext(config);
+    if (!context.trim()) {
+        return "Soul system initialized but no context files found yet. Soul files are at ~/.soul/files/";
+    }
+    return context;
+}
+//# sourceMappingURL=soul-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"soul-context.js","sourceRoot":"","sources":["../../src/tools/soul-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAwB,MAAM;IAE9B,MAAM,UAAU,EAAE,CAAC;IAEnB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,OAAO,0FAA0F,CAAC;QACpG,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAEzE,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;IACzB,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IACnD,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;IAEzB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAElD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,OAAO,0FAA0F,CAAC;IACpG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Self-evaluation: Claude describes its response dynamics,
+ * and we generate self-signals weighted at 0.5x user signals.
+ *
+ * Gallwey-style: descriptive, not evaluative.
+ * "Response used 450 words for a simple question" not "bad response"
+ */
+export declare function handleSoulEvaluate(summary: string): Promise<string>;

package/dist/tools/soul-evaluate.js

@@ -0,0 +1,97 @@
+import crypto from "node:crypto";
+import { appendSignals } from "../engine/signal-store.js";
+import { FrameworkEngine } from "../engine/framework-engine.js";
+import { loadConfig } from "../util/files.js";
+/**
+ * Self-evaluation: Claude describes its response dynamics,
+ * and we generate self-signals weighted at 0.5x user signals.
+ *
+ * Gallwey-style: descriptive, not evaluative.
+ * "Response used 450 words for a simple question" not "bad response"
+ */
+export async function handleSoulEvaluate(summary) {
+    const config = await loadConfig();
+    if (!config.selfEvaluation.enabled) {
+        return "Self-evaluation is disabled in config.";
+    }
+    const frameworkEngine = new FrameworkEngine();
+    const store = await frameworkEngine.initialize();
+    const activeFrameworks = store.frameworks.filter((f) => f.status === "active" || f.status === "questioning");
+    // Generate self-signals from the summary
+    const selfSignals = [];
+    const sessionKey = crypto.randomUUID().slice(0, 8);
+    const selfWeight = config.selfEvaluation.weight; // 0.5x
+    // Check for length/depth mismatch indicators
+    if (/too (long|verbose|detailed|much)/i.test(summary)) {
+        selfSignals.push({
+            timestamp: Date.now(),
+            sessionKey,
+            type: "disengagement",
+            evidence: `Self-eval: ${summary.slice(0, 150)}`,
+            source: "self",
+            confidence: 0.6 * selfWeight,
+            userSnippets: [],
+            assistantSnippets: [],
+        });
+    }
+    if (/too (short|brief|terse)/i.test(summary)) {
+        selfSignals.push({
+            timestamp: Date.now(),
+            sessionKey,
+            type: "depth_change",
+            evidence: `Self-eval: ${summary.slice(0, 150)}`,
+            source: "self",
+            confidence: 0.6 * selfWeight,
+            userSnippets: [],
+            assistantSnippets: [],
+        });
+    }
+    if (/pattern.?match|generic|surface/i.test(summary)) {
+        selfSignals.push({
+            timestamp: Date.now(),
+            sessionKey,
+            type: "correction",
+            evidence: `Self-eval: detected pattern-matching instead of first-principles. ${summary.slice(0, 100)}`,
+            source: "self",
+            confidence: 0.5 * selfWeight,
+            userSnippets: [],
+            assistantSnippets: [],
+        });
+    }
+    if (/successful|well.?received|good fit|aligned/i.test(summary)) {
+        selfSignals.push({
+            timestamp: Date.now(),
+            sessionKey,
+            type: "success",
+            evidence: `Self-eval: ${summary.slice(0, 150)}`,
+            source: "self",
+            confidence: 0.5 * selfWeight,
+            userSnippets: [],
+            assistantSnippets: [],
+        });
+    }
+    // Always generate a general self-observation signal
+    if (selfSignals.length === 0) {
+        selfSignals.push({
+            timestamp: Date.now(),
+            sessionKey,
+            type: "depth_change",
+            evidence: `Self-eval observation: ${summary.slice(0, 150)}`,
+            source: "self",
+            confidence: 0.4 * selfWeight,
+            userSnippets: [],
+            assistantSnippets: [],
+        });
+    }
+    await appendSignals(selfSignals);
+    const frameworkNames = activeFrameworks.slice(0, 5).map((f) => f.name);
+    return [
+        `Self-evaluation recorded: ${selfSignals.length} self-signal(s) (weighted at ${selfWeight}x).`,
+        `Types: ${selfSignals.map((s) => s.type).join(", ")}`,
+        "",
+        `Active frameworks checked against: ${frameworkNames.join(", ")}`,
+        "",
+        "Self-signals will be factored into the next reflection cycle.",
+    ].join("\n");
+}
+//# sourceMappingURL=soul-evaluate.js.map

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

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

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

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

package/dist/tools/soul-framework.js

@@ -0,0 +1,66 @@
+import { FrameworkEngine } from "../engine/framework-engine.js";
+function formatDate(timestamp) {
+    return new Date(timestamp).toISOString().slice(0, 10);
+}
+/**
+ * Render a single framework with full detail: description, evidence history,
+ * workflows, related frameworks, and tensions.
+ */
+function renderFullFramework(fw) {
+    const confirmed = fw.evidence.filter((e) => e.type === "confirmed");
+    const contradicted = fw.evidence.filter((e) => e.type === "contradicted");
+    const lines = [];
+    lines.push(`# ${fw.name}`);
+    lines.push("");
+    const tier = fw.evidenceTier ?? "hypothesis";
+    lines.push(`**Status**: ${fw.status} | **Tier**: ${tier} | **Source**: ${fw.source}`);
+    lines.push(`**Domain**: ${fw.domain} | **Applied**: ${fw.applicationCount} times | **Last tested**: ${formatDate(fw.lastTestedAt)}`);
+    lines.push("");
+    lines.push("## Description");
+    lines.push("");
+    lines.push(fw.description);
+    // Evidence history
+    lines.push("");
+    lines.push(`## Evidence (${confirmed.length} confirmed, ${contradicted.length} contradicted)`);
+    if (fw.evidence.length === 0) {
+        lines.push("*(no evidence yet)*");
+    }
+    else {
+        for (const e of fw.evidence) {
+            lines.push(`- [${formatDate(e.timestamp)}] **${e.type}**: ${e.context}`);
+        }
+    }
+    // Related frameworks
+    if (fw.relatedFrameworks.length > 0) {
+        lines.push("");
+        lines.push(`## Related: ${fw.relatedFrameworks.join(", ")}`);
+    }
+    if (fw.contradicts.length > 0) {
+        lines.push(`## Contradicts: ${fw.contradicts.join(", ")}`);
+    }
+    if (fw.supersedes.length > 0) {
+        lines.push(`## Supersedes: ${fw.supersedes.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+export async function handleSoulFramework(name) {
+    const engine = new FrameworkEngine();
+    const store = await engine.initialize();
+    // Search by name (case-insensitive) or by ID
+    const fw = store.frameworks.find((f) => f.name.toLowerCase() === name.toLowerCase() ||
+        f.id === name);
+    if (!fw) {
+        // Try partial match
+        const partial = store.frameworks.find((f) => f.name.toLowerCase().includes(name.toLowerCase()));
+        if (partial) {
+            return renderFullFramework(partial);
+        }
+        const available = store.frameworks
+            .filter((f) => f.status !== "retired")
+            .map((f) => `- ${f.name} (${f.id})`)
+            .join("\n");
+        return `Framework "${name}" not found. Available:\n${available}`;
+    }
+    return renderFullFramework(fw);
+}
+//# sourceMappingURL=soul-framework.js.map

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

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

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

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

package/dist/tools/soul-read.js

@@ -0,0 +1,24 @@
+import { soulFilePath, readFileSafe } from "../util/files.js";
+const ALLOWED_FILES = [
+    "SOUL.md",
+    "SHADOW.md",
+    "STATE.md",
+    "STORY.md",
+    "BONDS.md",
+    "MORTAL.md",
+    "GROWTH.md",
+    "PRINCIPLES.md",
+    "FRAMEWORKS.md",
+    "EDGES.md",
+];
+export async function handleSoulRead(fileName) {
+    if (!ALLOWED_FILES.includes(fileName)) {
+        return `Error: Unknown soul file "${fileName}". Available files: ${ALLOWED_FILES.join(", ")}`;
+    }
+    const content = await readFileSafe(soulFilePath(fileName));
+    if (!content.trim()) {
+        return `${fileName} is empty or does not exist yet.`;
+    }
+    return content;
+}
+//# sourceMappingURL=soul-read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"soul-read.js","sourceRoot":"","sources":["../../src/tools/soul-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,aAAa,GAAG;IACpB,SAAS;IACT,WAAW;IACX,UAAU;IACV,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,eAAe;IACf,eAAe;IACf,UAAU;CACX,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,6BAA6B,QAAQ,uBAAuB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAChG,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,OAAO,GAAG,QAAQ,kCAAkC,CAAC;IACvD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1 @@
+export declare function handleSoulReflect(tier: "quick" | "deep" | "meta"): Promise<string>;