keating 0.3.9 → 0.3.10

package/dist/src/core/benchmark.js

@@ -2,6 +2,7 @@ import { Prng } from "./random.js";
 import { benchmarkTopics } from "./topics.js";
 import { clamp, mean } from "./util.js";
 import { DEFAULT_WEIGHTS, clampWeights } from "./policy.js";
+import { piCompleteJson } from "./pi-agent.js";
 function buildLearnerPopulation(seed, count) {
     const prng = new Prng(seed);
     const learners = [];
@@ -20,7 +21,6 @@ function buildLearnerPopulation(seed, count) {
     }
     return learners;
 }
-import { piCompleteJson } from "./pi-agent.js";
 export async function simulateTeaching(cwd, policy, topic, learner, weights = DEFAULT_WEIGHTS) {
     // Use pure math to calculate initial constraints as baseline context
     const intuitionFit = 1 - Math.abs(policy.analogyDensity - learner.analogyNeed);
@@ -38,6 +38,41 @@ export async function simulateTeaching(cwd, policy, topic, learner, weights = DE
         learner.persistence * 0.2 +
         learner.anxiety * 0.25 -
         learner.priorKnowledge * 0.15);
+    const deterministicBaseline = () => {
+        const masteryGain = clamp(0.14 + intuitionFit * 0.18 + rigorFit * 0.2 + dialogueFit * 0.12 + diagramFit * 0.09 + practiceFit * 0.12 + (1 - overload) * 0.18);
+        const retention = clamp(masteryGain * (0.55 + policy.retrievalPractice * 0.45));
+        const engagement = clamp(0.12 + intuitionFit * 0.16 + dialogueFit * 0.16 + diagramFit * 0.1 + reflectionFit * 0.14 + (1 - overload) * 0.18);
+        const transfer = clamp(masteryGain * (0.55 + policy.interdisciplinaryBias * 0.25 + learner.transferDesire * 0.2));
+        const confusion = clamp(0.04 + overload * 0.55 + Math.abs(policy.formalism - learner.abstractionComfort) * 0.18 + Math.abs(policy.challengeRate - learner.persistence) * 0.12);
+        const score = clamp(masteryGain * weights.masteryGain +
+            retention * weights.retention +
+            engagement * weights.engagement +
+            transfer * weights.transfer -
+            confusion * weights.confusion, 0, 1);
+        return {
+            learner,
+            topic,
+            masteryGain,
+            retention,
+            engagement,
+            transfer,
+            confusion,
+            score,
+            breakdown: {
+                intuitionFit,
+                rigorFit,
+                dialogueFit,
+                diagramFit,
+                practiceFit,
+                reflectionFit,
+                overload
+            },
+            explanation: ["Deterministic algebraic baseline."]
+        };
+    };
+    if (process.env.KEATING_LLM_BENCHMARK !== "1") {
+        return deterministicBaseline();
+    }
     const prompt = `Simulate an educational interaction based on the following context.
 Teacher Policy: ${JSON.stringify(policy, null, 2)}
 Topic: ${topic.title} (${topic.domain}) - ${topic.summary}
@@ -83,36 +118,7 @@ Respond ONLY as a JSON matching:
     }
     catch (error) {
         console.error("LLM simulation failed, falling back to algebraic baseline", error);
-        const masteryGain = clamp(0.14 + intuitionFit * 0.18 + rigorFit * 0.2 + dialogueFit * 0.12 + diagramFit * 0.09 + practiceFit * 0.12 + (1 - overload) * 0.18);
-        const retention = clamp(masteryGain * (0.55 + policy.retrievalPractice * 0.45));
-        const engagement = clamp(0.12 + intuitionFit * 0.16 + dialogueFit * 0.16 + diagramFit * 0.1 + reflectionFit * 0.14 + (1 - overload) * 0.18);
-        const transfer = clamp(masteryGain * (0.55 + policy.interdisciplinaryBias * 0.25 + learner.transferDesire * 0.2));
-        const confusion = clamp(0.04 + overload * 0.55 + Math.abs(policy.formalism - learner.abstractionComfort) * 0.18 + Math.abs(policy.challengeRate - learner.persistence) * 0.12);
-        const score = clamp(masteryGain * weights.masteryGain +
-            retention * weights.retention +
-            engagement * weights.engagement +
-            transfer * weights.transfer -
-            confusion * weights.confusion, 0, 1);
-        return {
-            learner,
-            topic,
-            masteryGain,
-            retention,
-            engagement,
-            transfer,
-            confusion,
-            score,
-            breakdown: {
-                intuitionFit,
-                rigorFit,
-                dialogueFit,
-                diagramFit,
-                practiceFit,
-                reflectionFit,
-                overload
-            },
-            explanation: ["Fallback deterministic explanation."]
-        };
+        return deterministicBaseline();
     }
 }
 function classifyDominantSignal(simulations, kind) {

package/dist/src/core/pi-agent.js

@@ -10,7 +10,7 @@ export async function piComplete(cwd, prompt, options = {}) {
     const config = await loadKeatingConfig(cwd);
     const runtime = await detectAiRuntime(cwd);
     if (!runtime.selected) {
-        throw new Error("No AI runtime found. Install `pi` with `npm install -g @mariozechner/pi-coding-agent`, or reinstall Keating so its embedded runtime dependency is present.");
+        throw new Error("No AI runtime found. Install `pi` with `npm install -g @earendil-works/pi-coding-agent`, or reinstall Keating so its embedded runtime dependency is present.");
     }
     const args = ["-p", "--no-session", "--no-tools", "--no-extensions", "--no-skills"];
     if (options.systemPrompt) {

package/dist/src/pi/hyperteacher-extension.js

@@ -7,14 +7,40 @@ import { loadKeatingConfig } from "../core/config.js";
 import { shellCommandSections } from "../core/commands.js";
 import { KEATING_VOICE_TOOL_NAME, VOICE_TAGS, normalizeVoiceUtterance, speechStrategySummary, voiceTagLine } from "../core/speech.js";
 import { KEATING_ASCII_LOGO, KEATING_SUBTITLE_LINES } from "../core/terminal.js";
-const KEATING_VERSION = "0.3.9";
+const KEATING_VERSION = "0.3.10";
 const ANSI_RE = /\x1b\[[0-9;]*[a-zA-Z]/g;
 function visibleWidth(text) {
     return text.replace(ANSI_RE, "").length;
 }
+function truncateVisible(text, width) {
+    const limit = Math.max(0, width);
+    if (visibleWidth(text) <= limit)
+        return text;
+    if (limit === 0)
+        return "";
+    const suffix = limit > 1 ? "…" : "";
+    const contentLimit = Math.max(0, limit - visibleWidth(suffix));
+    let visible = 0;
+    let output = "";
+    for (let index = 0; index < text.length;) {
+        const ansi = text.slice(index).match(/^\x1b\[[0-9;]*[a-zA-Z]/);
+        if (ansi) {
+            output += ansi[0];
+            index += ansi[0].length;
+            continue;
+        }
+        if (visible >= contentLimit)
+            break;
+        output += text[index];
+        visible += 1;
+        index += 1;
+    }
+    return `${output}${suffix}`;
+}
 function padVisible(text, width) {
-    const vw = visibleWidth(text);
-    return vw >= width ? text : text + " ".repeat(width - vw);
+    const fitted = truncateVisible(text, width);
+    const vw = visibleWidth(fitted);
+    return vw >= width ? fitted : fitted + " ".repeat(width - vw);
 }
 function truncatePlain(text, width) {
     if (text.length <= width)
@@ -101,7 +127,7 @@ function topicFromArgs(args) {
 function info(ctx, message) {
     ctx.ui.notify(message, "info");
 }
-function createKeatingHeaderComponent(pi, ctx) {
+export function createKeatingHeaderComponent(pi, ctx) {
     const sections = shellCommandSections();
     const commandCount = sections.reduce((sum, section) => sum + section.commands.length, 0);
     return (_tui, theme) => {

package/dist/src/runtime/pi.js

@@ -23,7 +23,7 @@ function missingRuntimeMessage(report) {
             "Keating is configured for standalone-only but no `pi` AI agent binary was found on PATH.",
             "",
             "Recover with one of:",
-            "  npm install -g @mariozechner/pi-coding-agent",
+            "  npm install -g @earendil-works/pi-coding-agent",
             "  keating setup",
             "  edit keating.config.json and set pi.runtimePreference to prefer-standalone"
         ].join("\n");
@@ -33,7 +33,7 @@ function missingRuntimeMessage(report) {
             "Keating is configured for embedded-only but no embedded AI agent was found.",
             "",
             "Recover with one of:",
-            "  npm install -g @mariozechner/pi-coding-agent",
+            "  npm install -g @earendil-works/pi-coding-agent",
             "  keating setup",
             "  npm install -g keating"
         ].join("\n");
@@ -42,7 +42,7 @@ function missingRuntimeMessage(report) {
         "Could not find an AI runtime.",
         "",
         "Recover with one of:",
-        "  npm install -g @mariozechner/pi-coding-agent",
+        "  npm install -g @earendil-works/pi-coding-agent",
         "  npm install -g keating",
         "  curl -fsSL https://raw.githubusercontent.com/Diogenesoftoronto/keating/main/scripts/install/install.sh | bash"
     ].join("\n");
@@ -62,6 +62,7 @@ function resolveStandaloneAgent() {
     return null;
 }
 const CLI_AGENT_PACKAGES = [
+    ["@earendil-works", "pi-coding-agent"],
     ["@interleavelove", "keating-coding-agent"],
     ["@mariozechner", "pi-coding-agent"],
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keating",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "type": "module",
   "description": "A Pi-powered hyperteacher package with self-improving teaching policies, lesson maps, and animated visual teaching artifacts.",
   "keywords": [
@@ -34,7 +34,8 @@
     "pi/",
     "scripts/install/",
     "SYSTEM.md",
-    "web/dist/"
+    "web/dist/",
+    "web/.output/"
   ],
   "pi": {
     "extensions": [
@@ -56,7 +57,7 @@
   "dependencies": {
     "@ax-llm/ax": "^19.0.43",
     "@google/generative-ai": "^0.24.1",
-    "@mariozechner/pi-coding-agent": "^0.73.1",
+    "@earendil-works/pi-coding-agent": "^0.75.4",
     "dotenv": "^17.4.0",
     "h3": "^2.0.1-rc.20",
     "ink": "^7.0.3",

package/web/.output/nitro.json

@@ -0,0 +1,17 @@
+{
+  "date": "2026-05-21T19:05:26.549Z",
+  "preset": "node-server",
+  "framework": {
+    "name": "nitro",
+    "version": "3.0.260311-beta"
+  },
+  "versions": {
+    "nitro": "3.0.260311-beta"
+  },
+  "serverEntry": "server/index.mjs",
+  "publicDir": "public",
+  "commands": {
+    "preview": "node ./server/index.mjs"
+  },
+  "config": {}
+}

package/web/.output/public/.well-known/llms.txt

@@ -0,0 +1,44 @@
+# Keating
+
+> A Pi-powered hyperteacher scaffold designed to ensure that humans remain the authors of their own understanding. Keating uses the most advanced AI models not to provide answers, but to force the rigorous reconstruction of ideas within the learner's own identity — Socratic method, powered by silicon.
+
+## Overview
+
+Open source (MIT), runs in the browser or CLI. Supports local inference via WebGPU (Gemma 4 E4B), cloud providers (Google, Anthropic, OpenAI), and custom endpoints (Ollama, llama.cpp, LiteLLM). Includes speech, automated lesson planning, concept maps, animations, quizzes, flashcards, benchmarked self-improvement, and a persistent engagement timeline.
+
+## Get Started
+
+- Website: https://keating.help
+- GitHub: https://github.com/Diogenesoftoronto/keating
+- Paper PDF: https://keating.help/keating-metaharness.pdf
+- Install: https://keating.help/#install
+
+## Documentation
+
+- Architecture: https://github.com/Diogenesoftoronto/keating/blob/main/docs/ARCHITECTURE.md
+- Visual Architecture: https://github.com/Diogenesoftoronto/keating/blob/main/docs/VISUAL-ARCHITECTURE.md
+- Testing Strategy: https://github.com/Diogenesoftoronto/keating/blob/main/docs/TESTING.md
+- Oxdraw Tutorial: https://github.com/Diogenesoftoronto/keating/blob/main/docs/OXDRAW-TUTORIAL.md
+- Changelog: https://github.com/Diogenesoftoronto/keating/blob/main/CHANGELOG.md
+
+## Core Prompts
+
+- Learn workflow: https://github.com/Diogenesoftoronto/keating/blob/main/pi/prompts/learn.md
+- Diagnose workflow: https://github.com/Diogenesoftoronto/keating/blob/main/pi/prompts/diagnose.md
+- Quiz workflow: https://github.com/Diogenesoftoronto/keating/blob/main/pi/prompts/quiz.md
+- Bridge workflow: https://github.com/Diogenesoftoronto/keating/blob/main/pi/prompts/bridge.md
+- Improve workflow: https://github.com/Diogenesoftoronto/keating/blob/main/pi/prompts/improve.md
+
+## Key Modules
+
+- Core types and domain model: `src/core/types.ts`
+- Teaching policy and benchmark simulation: `src/core/benchmark.ts`
+- Policy evolution with safety gates: `src/core/evolution.ts`
+- Prompt evolution with multi-objective selection: `src/core/prompt-evolution.ts`
+- Lesson plan generator: `src/core/lesson-plan.ts`
+- Animation bundle generator (manim-web): `src/core/animation.ts`
+- Concept map generator (Mermaid / oxdraw): `src/core/map.ts`
+- CLI shell and commands: `src/cli/main.ts`
+- Pi extension entrypoint: `src/pi/hyperteacher-extension.ts`
+- Web chat runtime: `web/src/hooks/useKeatingAgent.ts`
+- Web app entry: `web/src/App.tsx`

package/web/.output/public/apple-touch-icon.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 180 180">
+  <defs>
+    <linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1"/>
+      <stop offset="100%" style="stop-color:#8b5cf6"/>
+    </linearGradient>
+  </defs>
+  <rect width="180" height="180" rx="32" fill="url(#grad)"/>
+  <text x="90" y="125" font-family="Georgia, serif" font-size="90" font-weight="bold" fill="white" text-anchor="middle">K</text>
+</svg>