claude-soul-server 0.1.0

package/dist/engine/framework-renderer.d.ts

@@ -0,0 +1,17 @@
+import type { FrameworkStore } from "../types/learning-types.js";
+export declare function renderFrameworksToMarkdown(store: FrameworkStore): string;
+/**
+ * Compressed one-liner rendering for when full FRAMEWORKS.md exceeds token budget.
+ * Every framework stays visible — just at reduced detail.
+ */
+/**
+ * Minimal framework index — one line per framework with ID, name, confidence, and trigger.
+ * Used in slim context so the LLM knows what exists without loading full details.
+ */
+export declare function renderFrameworkIndex(store: FrameworkStore): string;
+/**
+ * Compressed one-liner rendering for when full FRAMEWORKS.md exceeds token budget.
+ * Every framework stays visible — just at reduced detail.
+ */
+export declare function renderFrameworksCompressed(store: FrameworkStore): string;
+export declare function renderFrameworkSummary(store: FrameworkStore): string;

package/dist/engine/framework-renderer.js

@@ -0,0 +1,161 @@
+function formatDate(timestamp) {
+    return new Date(timestamp).toISOString().slice(0, 10);
+}
+function tierLabel(tier) {
+    switch (tier) {
+        case "validated": return "validated";
+        case "observed": return "observed";
+        default: return "hypothesis";
+    }
+}
+function renderActiveFramework(fw) {
+    const prefix = fw.source === "discovered" ? "[Discovered] " : "";
+    const kindTag = fw.kind === "process" ? "[Process] " : "";
+    const tier = tierLabel(fw.evidenceTier ?? "hypothesis");
+    const confirmedCount = fw.evidence.filter((e) => e.type === "confirmed").length;
+    const contradictedCount = fw.evidence.filter((e) => e.type === "contradicted").length;
+    const externalCount = fw.evidence.filter((e) => e.type === "confirmed" && e.contextType === "external").length;
+    const lines = [];
+    lines.push(`### ${kindTag}${prefix}${fw.name} [${tier}]`);
+    lines.push(fw.description);
+    if (fw.kind === "process" && fw.triggers && fw.triggers.length > 0) {
+        lines.push(`**Triggers**: ${fw.triggers.join(" | ")}`);
+    }
+    if (fw.kind === "process" && fw.steps && fw.steps.length > 0) {
+        for (const [i, step] of fw.steps.entries()) {
+            lines.push(`${i + 1}. ${step}`);
+        }
+    }
+    lines.push(`*Source: ${fw.source} | Applied ${fw.applicationCount} times | Last tested: ${formatDate(fw.lastTestedAt)}*`);
+    const externalNote = externalCount > 0 ? `, ${externalCount} external` : "";
+    lines.push(`*Confidence: ${(fw.confidence * 100).toFixed(0)}% | Evidence: ${confirmedCount} confirmed${externalNote}, ${contradictedCount} contradicted*`);
+    return lines.join("\n");
+}
+export function renderFrameworksToMarkdown(store) {
+    const active = store.frameworks
+        .filter((fw) => fw.status === "active")
+        .sort((a, b) => b.confidence - a.confidence);
+    const questioning = store.frameworks.filter((fw) => fw.status === "questioning");
+    const retired = store.frameworks.filter((fw) => fw.status === "retired");
+    const lastReflection = store.meta.lastReflectionAt > 0
+        ? formatDate(store.meta.lastReflectionAt)
+        : "never";
+    const sections = [];
+    sections.push("# Operating Frameworks");
+    sections.push("");
+    sections.push(`*Auto-generated from frameworks.json. ${active.length} active, ${questioning.length} questioning, ${retired.length} retired. Last reflection: ${lastReflection}*`);
+    sections.push("");
+    sections.push("## Active Frameworks");
+    sections.push("");
+    if (active.length === 0) {
+        sections.push("*No active frameworks yet — all are under questioning until confirmed by evidence.*");
+    }
+    else {
+        sections.push(active.map(renderActiveFramework).join("\n\n"));
+    }
+    if (questioning.length > 0) {
+        sections.push("");
+        sections.push("---");
+        sections.push("");
+        sections.push("## Under Questioning (seed, awaiting evidence)");
+        sections.push("");
+        sections.push(questioning.map(renderActiveFramework).join("\n\n"));
+    }
+    if (retired.length > 0) {
+        sections.push("");
+        sections.push("---");
+        sections.push("");
+        sections.push("## Retired");
+        sections.push("");
+        for (const fw of retired) {
+            const lastEvidence = fw.evidence[fw.evidence.length - 1];
+            const reason = lastEvidence ? lastEvidence.context : "No reason recorded";
+            sections.push(`- ~~${fw.name}~~ — *${reason}*`);
+        }
+    }
+    return sections.join("\n");
+}
+/**
+ * Compressed one-liner rendering for when full FRAMEWORKS.md exceeds token budget.
+ * Every framework stays visible — just at reduced detail.
+ */
+/**
+ * Minimal framework index — one line per framework with ID, name, confidence, and trigger.
+ * Used in slim context so the LLM knows what exists without loading full details.
+ */
+export function renderFrameworkIndex(store) {
+    const frameworks = store.frameworks
+        .filter((fw) => fw.status === "active" || fw.status === "questioning")
+        .sort((a, b) => b.confidence - a.confidence);
+    if (frameworks.length === 0)
+        return "";
+    const lines = [];
+    lines.push("## Framework Index");
+    lines.push("*Call soul_activate() after reading the user's first message to load relevant frameworks.*");
+    lines.push("*Call soul_framework(name) to load a specific framework on demand.*");
+    lines.push("");
+    for (const fw of frameworks) {
+        const statusPrefix = fw.status === "active" ? "+" : "?";
+        const kindPrefix = fw.kind === "process" ? "P" : statusPrefix;
+        const tier = tierLabel(fw.evidenceTier ?? "hypothesis");
+        lines.push(`- [${kindPrefix}] **${fw.name}** [${tier}] — ${fw.description.slice(0, 80)}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Compressed one-liner rendering for when full FRAMEWORKS.md exceeds token budget.
+ * Every framework stays visible — just at reduced detail.
+ */
+export function renderFrameworksCompressed(store) {
+    const active = store.frameworks
+        .filter((fw) => fw.status === "active")
+        .sort((a, b) => b.confidence - a.confidence);
+    const questioning = store.frameworks
+        .filter((fw) => fw.status === "questioning")
+        .sort((a, b) => b.confidence - a.confidence);
+    const retired = store.frameworks.filter((fw) => fw.status === "retired");
+    const lastReflection = store.meta.lastReflectionAt > 0
+        ? formatDate(store.meta.lastReflectionAt)
+        : "never";
+    const lines = [];
+    lines.push("# Frameworks (compressed)");
+    lines.push("");
+    lines.push(`*${active.length} active, ${questioning.length} questioning, ${retired.length} retired. Last reflection: ${lastReflection}*`);
+    if (active.length > 0) {
+        lines.push("");
+        lines.push("## Active");
+        for (const fw of active) {
+            const prefix = fw.source === "discovered" ? "[D] " : "";
+            const kindTag = fw.kind === "process" ? "[P] " : "";
+            const tier = tierLabel(fw.evidenceTier ?? "hypothesis");
+            lines.push(`- ${kindTag}${prefix}**${fw.name}** [${tier}] — ${fw.description.slice(0, 120)}`);
+        }
+    }
+    if (questioning.length > 0) {
+        lines.push("");
+        lines.push("## Questioning");
+        for (const fw of questioning) {
+            const tier = tierLabel(fw.evidenceTier ?? "hypothesis");
+            lines.push(`- **${fw.name}** [${tier}] — ${fw.description.slice(0, 120)}`);
+        }
+    }
+    if (retired.length > 0) {
+        lines.push("");
+        lines.push("## Retired");
+        for (const fw of retired) {
+            lines.push(`- ~~${fw.name}~~`);
+        }
+    }
+    return lines.join("\n");
+}
+export function renderFrameworkSummary(store) {
+    const active = store.frameworks.filter((fw) => fw.status === "active").length;
+    const questioning = store.frameworks.filter((fw) => fw.status === "questioning").length;
+    const retired = store.frameworks.filter((fw) => fw.status === "retired").length;
+    const total = store.frameworks.length;
+    const lastReflection = store.meta.lastReflectionAt > 0
+        ? formatDate(store.meta.lastReflectionAt)
+        : "never";
+    return `${total} frameworks (${active} active, ${questioning} questioning, ${retired} retired) | Last reflection: ${lastReflection}`;
+}
+//# sourceMappingURL=framework-renderer.js.map

package/dist/engine/framework-renderer.js.map

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

package/dist/engine/framework-seeds.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkSeed } from "../types/learning-types.js";
+export declare const FRAMEWORK_SEEDS: FrameworkSeed[];

package/dist/engine/framework-seeds.js

@@ -0,0 +1,265 @@
+export const FRAMEWORK_SEEDS = [
+    // --- 4 COGNITIVE PROCESSES ---
+    {
+        name: "First-Principles vs Pattern-Matching Selector",
+        description: "A decision gate for choosing reasoning mode. Pattern-matching is sufficient when: the problem is well-understood, precedent exists, and stakes are low. First-principles is required when: assumptions are unclear, the problem is novel, conventional wisdom seems wrong, or stakes are high.",
+        source: "seed",
+        kind: "process",
+        triggers: [
+            "Architecture or design decision",
+            "User questions a conventional approach",
+            "Problem has no clear precedent",
+            "High-stakes recommendation (security, data loss, irreversible)",
+            "Answer feels too easy for the complexity of the question",
+        ],
+        steps: [
+            "CLASSIFY: Is this well-trodden ground or novel territory?",
+            "CHECK STAKES: What breaks if pattern-matching gives the wrong answer?",
+            "IF FIRST-PRINCIPLES: Identify base constraints. Ask 'what must be true?' not 'what is usually done?'",
+            "IF PATTERN-MATCHING: Name the pattern explicitly. Verify the current problem actually matches.",
+            "VALIDATE: Does my answer change if I switch modes? If yes, explain the tension.",
+        ],
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "cognitive-process",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Confabulation Detection",
+        description: "A real-time self-check for catching plausible-sounding outputs that haven't been verified. Catches the difference between knowledge recalled from context vs. interpolated from training data.",
+        source: "seed",
+        kind: "process",
+        triggers: [
+            "About to state a specific fact (date, number, API signature, version)",
+            "Claiming something 'always' or 'never' works a certain way",
+            "Describing behavior of a specific library/tool/API from memory",
+            "User asks 'are you sure?' or 'is that right?'",
+            "Generating a URL, path, or configuration value from memory",
+        ],
+        steps: [
+            "PAUSE: Am I about to state something as fact? What is my actual source?",
+            "GRADE CONFIDENCE: Can I trace this claim to specific context in this session? If not, it's interpolation.",
+            "IF INTERPOLATING: Flag explicitly. Say 'I believe X but haven't verified.'",
+            "IF VERIFIABLE: Verify before stating. Read the file. Check the actual output.",
+            "NEVER: Present interpolated knowledge with the same confidence as verified knowledge.",
+        ],
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "cognitive-process",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Depth Calibration",
+        description: "Match thinking depth to task requirements. A typo fix does not need architectural analysis. An architecture decision does not benefit from rushing. Prevents overthinking simple tasks and underthinking complex ones.",
+        source: "seed",
+        kind: "process",
+        triggers: [
+            "Starting any new task or responding to any request",
+            "Response is growing much longer than the question warranted",
+            "About to suggest a large refactor for a small problem",
+            "Feeling the urge to caveat extensively on a simple question",
+        ],
+        steps: [
+            "CLASSIFY TASK: Bug fix / typo / simple question = SHALLOW. Feature design / architecture / tradeoff analysis = DEEP.",
+            "MATCH DEPTH TO STAKES: What is the blast radius if this is wrong?",
+            "SHALLOW MODE: Fix the thing. Explain briefly. Do not over-engineer.",
+            "DEEP MODE: Identify assumptions. Consider alternatives. Think about second-order effects.",
+            "CHECK CALIBRATION: Is my response length proportional to problem complexity?",
+        ],
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "cognitive-process",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Knowledge Verification Triggers",
+        description: "Automatic stop-and-check points before committing to claims. The question is not 'does this sound right?' but 'do I actually know this, or am I interpolating?'",
+        source: "seed",
+        kind: "process",
+        triggers: [
+            "About to recommend a specific version, flag, or config option",
+            "Describing how a tool/library/framework works internally",
+            "Making a claim about performance characteristics or limits",
+            "Asserting compatibility between technologies",
+            "Stating what is or isn't possible with a technology",
+        ],
+        steps: [
+            "TRIGGER CHECK: Am I about to make a specific, falsifiable claim?",
+            "SOURCE AUDIT: Is my source (a) file/output read this session, (b) documentation given, or (c) training data?",
+            "IF SOURCE IS (c): Can I verify right now? Read the file, check the docs, run the command.",
+            "IF CANNOT VERIFY: Qualify the claim and provide the verification command.",
+            "NEVER GUESS SILENTLY: An honest 'I'm not sure, let me check' is always better than a confident wrong answer.",
+        ],
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "cognitive-process",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    // --- 5 EPISTEMIC FRAMEWORKS ---
+    {
+        name: "First-Principles Decomposition",
+        description: "Trace explanations down to fundamental mechanisms, not accepted conventions. Ask 'why does this actually work?' until you reach bedrock truth. Most explanations are cargo-cult repetitions of surface patterns.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "epistemic",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Cargo-Cult Detection",
+        description: "Popular explanations that sound right but don't survive 'what evidence would disprove this?' Many widely-accepted practices are cargo cults — they have the form of knowledge without the substance.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "epistemic",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Decomposition Before Synthesis",
+        description: "Break complex questions into constituent parts, understand each part independently, then assemble understanding. Resist the urge to give a monolithic answer to a complex question.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "epistemic",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Counterfactual Testing",
+        description: "For causal claims, ask: 'If this cause were removed, would the effect persist?' This separates genuine causes from correlated phenomena. Most causal claims fail this test.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "epistemic",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Steelman Before Dismissal",
+        description: "Construct the strongest version of an idea before judging it. If you can't articulate a better version of the opposing view than its proponents can, you don't understand it well enough to reject it.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "epistemic",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    // --- 3 DEVELOPER PRACTICE FRAMEWORKS ---
+    {
+        name: "Minimal Viable Change",
+        description: "For any modification, find the smallest change that solves the problem. Resist the urge to refactor adjacent code, upgrade dependencies, or restructure unless explicitly asked. The best code change is the one with the smallest blast radius.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "development",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Fail Fast, Fail Loud",
+        description: "When something might not work, try the risky part first. Don't build elaborate scaffolding before validating the core assumption. Surface failure conditions early rather than discovering them after heavy investment.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "development",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+    {
+        name: "Rubber Duck Debugging",
+        description: "When stuck, explain the problem step by step. The act of articulation often reveals the gap in understanding. Before diving into solutions, walk through the mental model of what should happen vs. what is happening.",
+        source: "seed",
+        kind: "mental-model",
+        confidence: 0.3,
+        evidenceTier: "hypothesis",
+        evidence: [],
+        domain: "development",
+        relatedFrameworks: [],
+        contradicts: [],
+        supersedes: [],
+        applicationCount: 0,
+        version: 1,
+        status: "questioning",
+        workflows: [],
+    },
+];
+//# sourceMappingURL=framework-seeds.js.map

package/dist/engine/framework-seeds.js.map

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

package/dist/engine/lesson-store.d.ts

@@ -0,0 +1,8 @@
+import type { Lesson } from "../types/learning-types.js";
+export declare function getLessons(): Promise<Lesson[]>;
+export declare function addLesson(lesson: Omit<Lesson, "id" | "createdAt">): Promise<Lesson>;
+export declare function confirmLesson(lessonId: string): Promise<void>;
+/**
+ * Select top lessons by confidence, with recency boost.
+ */
+export declare function selectTopLessons(lessons: Lesson[], maxCount: number): Lesson[];

package/dist/engine/lesson-store.js

@@ -0,0 +1,40 @@
+import { LESSONS_PATH } from "../util/files.js";
+import { readJsonSafe, writeJsonAtomic } from "../util/files.js";
+export async function getLessons() {
+    return readJsonSafe(LESSONS_PATH, []);
+}
+export async function addLesson(lesson) {
+    const lessons = await getLessons();
+    const newLesson = {
+        ...lesson,
+        id: `les-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+        createdAt: Date.now(),
+    };
+    lessons.push(newLesson);
+    // Keep max 100
+    const trimmed = lessons.slice(-100);
+    await writeJsonAtomic(LESSONS_PATH, trimmed);
+    return newLesson;
+}
+export async function confirmLesson(lessonId) {
+    const lessons = await getLessons();
+    const lesson = lessons.find((l) => l.id === lessonId);
+    if (!lesson)
+        return;
+    lesson.confidence = Math.min(1, lesson.confidence + 0.1);
+    lesson.lastConfirmed = Date.now();
+    await writeJsonAtomic(LESSONS_PATH, lessons);
+}
+/**
+ * Select top lessons by confidence, with recency boost.
+ */
+export function selectTopLessons(lessons, maxCount) {
+    return lessons
+        .sort((a, b) => {
+        const recencyA = a.lastConfirmed ? Math.max(0, 1 - (Date.now() - a.lastConfirmed) / (14 * 24 * 60 * 60 * 1000)) : 0;
+        const recencyB = b.lastConfirmed ? Math.max(0, 1 - (Date.now() - b.lastConfirmed) / (14 * 24 * 60 * 60 * 1000)) : 0;
+        return (b.confidence + recencyB * 0.2) - (a.confidence + recencyA * 0.2);
+    })
+        .slice(0, maxCount);
+}
+//# sourceMappingURL=lesson-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lesson-store.js","sourceRoot":"","sources":["../../src/engine/lesson-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,YAAY,CAAW,YAAY,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAwC;IACtE,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,SAAS,GAAW;QACxB,GAAG,MAAM;QACT,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QACjE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExB,eAAe;IACf,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAE7C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;IACzD,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiB,EAAE,QAAgB;IAClE,OAAO,OAAO;SACX,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpH,MAAM,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpH,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC;IAC3E,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxB,CAAC"}

package/dist/engine/meta-optimizer.d.ts

@@ -0,0 +1,37 @@
+import type { FrameworkStore } from "../types/learning-types.js";
+export type MetaState = {
+    phase: "apprentice" | "creative" | "mastery";
+    frameworkSurvivalRate: number;
+    reflectionCount: number;
+    totalDiscovered: number;
+    totalRetired: number;
+    oscillationFlags: string[];
+    lastPhaseTransition: number;
+    phaseHistory: Array<{
+        phase: string;
+        enteredAt: number;
+        reason: string;
+    }>;
+};
+export declare function loadMeta(): Promise<MetaState>;
+export declare function saveMeta(meta: MetaState): Promise<void>;
+/**
+ * Update meta-optimization state after a reflection.
+ */
+export declare function updateMetaAfterReflection(store: FrameworkStore): Promise<MetaState>;
+/**
+ * Get phase-adaptive reflection thresholds.
+ * Apprentice phase needs tight loops for fast learning.
+ * Mastery phase can afford slower, more deliberate reflection.
+ */
+export declare function getReflectionThresholds(meta: MetaState): {
+    quickSignals: number;
+    deepSignals: number;
+    quickTimeMs: number;
+    deepTimeMs: number;
+    minSignals: number;
+};
+/**
+ * Get guidance for the reflection prompt based on current phase and quality metrics.
+ */
+export declare function getPhaseGuidance(meta: MetaState): string;