catui-agent 1.0.0-beta.0

package/dist/extensions/builtin/teach/references/teaching-template.md

@@ -0,0 +1,237 @@
+# Teaching Template
+
+Standard lesson structure for teach command. Adapt depth and pacing to learner's level.
+
+---
+
+## Lesson Structure
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  HOOK           (30 sec)    Why should you care?        │
+│  ↓                                                       │
+│  LEVEL 1        (1 min)     One-sentence + core analogy │
+│  ↓                                                       │
+│  LEVEL 2        (3 min)     How it works + example      │
+│  ↓                                                       │
+│  LEVEL 3        (5+ min)    Deep dive + real scenario   │
+│  ↓                                                       │
+│  BRIDGE         (1 min)     What this means for you     │
+│  ↓                                                       │
+│  TAKEAWAYS      (30 sec)    3 core points               │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## HOOK Template
+
+```markdown
+### 🎣 Why should you learn about「{topic}」？
+
+[A relatable scenario or problem]
+
+Examples:
+- "Have you ever encountered {situation}? Understanding {topic} will help you {capability}."
+- "Every time {situation}, {problem}——understanding {topic} makes {benefit}."
+```
+
+---
+
+## LEVEL 1 Template (Zero Jargon)
+
+```markdown
+### 📍 One-sentence version
+
+**{topic}** is {plain-language definition}.
+
+Think of it like: {analogy from analogy-library.md}
+
+That's the basics. Let's see how it actually works.
+```
+
+---
+
+## LEVEL 2 Template (Working Knowledge)
+
+```markdown
+### 🔍 How it works
+
+**Core concepts**:
+- 「{term-1}」→ {one-sentence explanation}
+- 「{term-2}」→ {one-sentence explanation}
+- 「{term-3}」→ {one-sentence explanation}
+
+**Simple example**:
+
+```{language}
+// {What this example does}
+{5-15 lines of annotated code}
+// ← {Comment explaining this line}
+```
+
+**Flowchart**:
+
+```mermaid
+{Simplified flowchart, 3-5 nodes}
+```
+
+**Comparison**:
+
+| What you already know | What's new |
+|----------------------|------------|
+| {Existing concept} | {New concept} |
+```
+
+---
+
+## LEVEL 3 Template (Deep Dive, Optional)
+
+```markdown
+### 🐇 Deep dive (optional)
+
+In real-world applications, {topic} gets more complex:
+
+1. **{complication-1}**: {explanation + why it exists}
+2. **{complication-2}**: {explanation + common pitfalls}
+3. **{complication-3}**: {explanation + best practices}
+
+**Real-world example**:
+```{language}
+// From real-world code (simplified)
+{real code example with annotations}
+```
+
+**When you'll encounter it**:
+- {Scenario 1: Design review}
+- {Scenario 2: Code review}
+- {Scenario 3: Technical discussion}
+```
+
+---
+
+## BRIDGE Template
+
+```markdown
+### 🌉 What this means for you
+
+Understanding {topic} helps you:
+
+1. **When designing**: {how it improves design decisions}
+2. **When collaborating**: {how it improves communication}
+3. **When reviewing**: {what to look for or ask about}
+
+**Useful phrases**:
+- "How does our {feature}'s {topic} work?"
+- "If we change the {topic} approach, what are the limitations?"
+```
+
+---
+
+## TAKEAWAYS Template
+
+```markdown
+### ✨ Remember these three things
+
+1. {Core concept, one sentence}
+2. {Practical value, one sentence}
+3. {Growth opportunity, one sentence}
+
+---
+
+**Want to explore more?**
+- Try applying what you learned in a real scenario
+- Ask questions about specific aspects you're curious about
+- Practice with hands-on exercises
+```
+
+---
+
+## Pacing Rules
+
+| Signal from learner | Action |
+|---|---|
+| "Yes, continue" or proactive questions | Can go to next level |
+| "A bit confused" or silence | Stay at current level, add another analogy |
+| "I already know this" | Skip to next level or deeper topic |
+| "Enough, let me digest" | Wrap up with takeaways, no more depth |
+| Asks a tangent question | Briefly address it, then return to main thread |
+
+---
+
+## Code Example Rules
+
+1. **Maximum 15 lines** per example at Level 2
+2. **Every line must have a comment** explaining what it does
+3. **Use the simplest possible example** that demonstrates the concept
+4. **Prefer functional examples** that can be copy-pasted and run
+5. **Highlight the "aha!" line** — the one that demonstrates the concept most clearly
+6. **Remove all boilerplate** that isn't essential to understanding
+
+---
+
+## Analogy Selection Rules
+
+1. **One analogy per concept per session** — don't mix metaphors
+2. **Check analogy library first** — use established analogies when available
+3. **Note confidence level** — be honest about how well the analogy fits
+4. **Acknowledge limitations** — when an analogy breaks down, say so
+5. **Provide alternatives** — have backup analogies ready
+
+---
+
+## Source Verification Rules
+
+Every factual claim must include:
+
+```markdown
+**Source**: [Source Name](URL)
+**Confidence**: ⭐⭐⭐⭐⭐ (Reason)
+**Verification method**: [How verified]
+```
+
+### Source Hierarchy
+
+| Level | Source Type | Confidence |
+|-------|------------|------------|
+| 1 | Official documentation, peer-reviewed papers | ⭐⭐⭐⭐⭐ |
+| 2 | Recognized experts, established institutions | ⭐⭐⭐⭐ |
+| 3 | Community sources (Stack Overflow, Reddit) | ⭐⭐⭐ |
+| 4 | Blog posts, tutorials | ⭐⭐ |
+| 5 | User-generated content | ⭐ |
+
+---
+
+## Feynman Check
+
+After key teaching points, always ask:
+
+> "Can you describe this in your own words?"
+
+This helps:
+1. Solidify understanding
+2. Identify gaps in knowledge
+3. Build confidence in explaining to others
+
+---
+
+## Error Recovery
+
+When teaching doesn't land:
+
+1. **Recognize confusion**: Watch for signs of misunderstanding
+2. **Pause and clarify**: Don't keep pushing forward
+3. **Try a different angle**: Use a different analogy or explanation
+4. **Simplify**: Break down into smaller pieces
+5. **Check prerequisites**: Ensure foundation is solid
+
+---
+
+## Session Memory
+
+Across lessons in a single session, maintain:
+
+- **Glossary**: all terms introduced so far (avoid re-explaining)
+- **Depth level**: track how much the learner has absorbed
+- **Coverage**: what areas have been taught
+- **Questions asked**: to identify knowledge gaps and suggest next topics

package/dist/extensions/builtin/teach/teach-format.d.ts

@@ -0,0 +1,35 @@
+/**
+ * [WHO]: teachFormat - formatting utilities for teach extension
+ * [FROM]: Depends on teach-types.ts for type definitions
+ * [TO]: Consumed by index.ts for rendering teach messages
+ * [HERE]: extensions/builtin/teach/teach-format.ts - output formatting for teach extension
+ */
+import type { Source, TeachResult } from "./teach-types.js";
+/**
+ * Format a teach result for display
+ */
+export declare function formatTeachResult(result: TeachResult): string;
+/**
+ * Format source citation
+ */
+export declare function formatSource(source: Source, locale?: "en" | "zh"): string;
+/**
+ * Format multiple sources
+ */
+export declare function formatSources(sources: Source[], locale?: "en" | "zh"): string;
+/**
+ * Format glossary entry
+ */
+export declare function formatGlossaryEntry(term: string, definition: string): string;
+/**
+ * Format progress indicator
+ */
+export declare function formatProgress(current: number, total: number): string;
+/**
+ * Format learning style options
+ */
+export declare function formatLearningStyleOptions(): string;
+/**
+ * Format mission summary
+ */
+export declare function formatMissionSummary(why: string, successCriteria: string[], constraints: string[], outOfScope: string[]): string;

package/dist/extensions/builtin/teach/teach-format.js

@@ -0,0 +1,6 @@
+var c=Object.defineProperty;var t=(n,e)=>c(n,"name",{value:e,configurable:!0});function $(n){switch(n.type){case"question":return u(n);case"lesson":return a(n);case"complete":return f(n);case"error":return m(n);case"info":return p(n);default:return n.message}}t($,"formatTeachResult");function u(n){return n.message}t(u,"formatQuestion");function a(n){const e=[];return n.content&&e.push(n.content),n.message&&(e.push(""),e.push(n.message)),e.join(`
+`)}t(a,"formatLesson");function f(n){return["---","",n.message,"",n.content??"","---"].join(`
+`)}t(f,"formatComplete");function m(n){return`\u274C **Error**: ${n.message}`}t(m,"formatError");function p(n){return n.message}t(p,"formatInfo");function h(n,e="en"){const s=e==="zh"?"\u7F6E\u4FE1\u5EA6":"Confidence",r="\u2B50".repeat(n.confidence);return`[${n.name}](${n.url}) - ${s}: ${r}`}t(h,"formatSource");function g(n,e="en"){if(n.length===0)return"";const r=["---","",`**${e==="zh"?"\u6765\u6E90\u9A8C\u8BC1":"Source Verification"}**:`];for(const o of n)r.push(`- ${h(o,e)}`);return r.join(`
+`)}t(g,"formatSources");function d(n,e){return`**${n}**: ${e}`}t(d,"formatGlossaryEntry");function y(n,e){const s=Math.round(n/e*100),r=Math.round(s/10),o=10-r;return`[${"\u2588".repeat(r)}${"\u2591".repeat(o)}] ${s}%`}t(y,"formatProgress");function S(){return["| # | Style | Duration | Best For |","|---|-------|----------|----------|","| 1 | Quick Overview | 10-15 min | Just the essentials |","| 2 | Deep Dive | 30-60 min | Comprehensive understanding |","| 3 | Focused Skill | 20-30 min | Master one specific thing |","| 4 | Holistic | Multiple sessions | Become an expert |"].join(`
+`)}t(S,"formatLearningStyleOptions");function x(n,e,s,r){const o=["### \u{1F4CB} Mission Summary","",`**Why**: ${n}`,"","**Success looks like**:"];for(const i of e)o.push(`- ${i}`);if(s.length>0){o.push(""),o.push("**Constraints**:");for(const i of s)o.push(`- ${i}`)}if(r.length>0){o.push(""),o.push("**Out of scope**:");for(const i of r)o.push(`- ${i}`)}return o.join(`
+`)}t(x,"formatMissionSummary");export{d as formatGlossaryEntry,S as formatLearningStyleOptions,x as formatMissionSummary,y as formatProgress,h as formatSource,g as formatSources,$ as formatTeachResult};

package/dist/extensions/builtin/teach/teach-i18n.d.ts

@@ -0,0 +1,47 @@
+/**
+ * [WHO]: teachI18n - internationalization for teach extension
+ * [FROM]: Depends on core/platform/i18n for locale detection
+ * [TO]: Consumed by teach-runtime.ts, teach-prompts.ts, teach-format.ts
+ * [HERE]: extensions/builtin/teach/teach-i18n.ts - i18n strings for teach extension
+ */
+export type TeachLocale = "en" | "zh";
+interface TeachStrings {
+    commandDescription: string;
+    commandArgTopic: string;
+    missionDiscoveryTitle: string;
+    missionWhyQuestion: string;
+    missionSuccessQuestion: string;
+    missionConstraintsQuestion: string;
+    missionOutOfScopeQuestion: string;
+    learningStyleTitle: string;
+    learningStyleQuick: string;
+    learningStyleDeep: string;
+    learningStyleFocused: string;
+    learningStyleHolistic: string;
+    levelHook: string;
+    level1: string;
+    level2: string;
+    level3: string;
+    sourceLabel: string;
+    confidenceLabel: string;
+    verificationMethodLabel: string;
+    sourceUnavailable: string;
+    sourceUnverified: string;
+    progressSaved: string;
+    progressLoaded: string;
+    learningRecordSaved: string;
+    checkpointContinue: string;
+    checkpointDigest: string;
+    checkpointMoreDepth: string;
+    checkpointFeynman: string;
+    errorNoTopic: string;
+    errorInvalidStyle: string;
+    errorSourceVerificationFailed: string;
+    completionTitle: string;
+    completionMessage: string;
+    completionNextSteps: string;
+}
+export declare function getTeachLocale(locale?: string): TeachLocale;
+export declare function teachText(locale?: TeachLocale): TeachStrings;
+export declare function detectTeachLocale(): TeachLocale;
+export {};

package/dist/extensions/builtin/teach/teach-i18n.js

@@ -0,0 +1 @@
+var n=Object.defineProperty;var o=(e,i)=>n(e,"name",{value:i,configurable:!0});const t={commandDescription:"Learn something new with guided, source-verified teaching",commandArgTopic:"What do you want to learn?",missionDiscoveryTitle:"\u{1F3AF} Mission Discovery",missionWhyQuestion:"Why do you want to learn this?",missionSuccessQuestion:"What does success look like?",missionConstraintsQuestion:"Any constraints? (time, resources, etc.)",missionOutOfScopeQuestion:"What's out of scope for now?",learningStyleTitle:"\u{1F4DA} Learning Style",learningStyleQuick:"Quick Overview (10-15 min) - Just the essentials",learningStyleDeep:"Deep Dive (30-60 min) - Comprehensive understanding",learningStyleFocused:"Focused Skill (20-30 min) - Master one specific thing",learningStyleHolistic:"Holistic (multiple sessions) - Become an expert",levelHook:"\u{1F3A3} Why should you learn about",level1:"\u{1F4CD} One-sentence version",level2:"\u{1F50D} How it works",level3:"\u{1F407} Deep dive (optional)",sourceLabel:"Source",confidenceLabel:"Confidence",verificationMethodLabel:"Verification method",sourceUnavailable:"No reliable source available",sourceUnverified:"Unverified - needs confirmation",progressSaved:"Progress saved",progressLoaded:"Previous progress loaded",learningRecordSaved:"Learning record saved",checkpointContinue:"Ready to continue?",checkpointDigest:"Would you like to continue or digest what you've learned?",checkpointMoreDepth:"Want to go deeper?",checkpointFeynman:"Can you describe this in your own words?",errorNoTopic:"Please specify a topic. Usage: /teach <topic>",errorInvalidStyle:"Invalid learning style selected",errorSourceVerificationFailed:"Failed to verify source",completionTitle:"\u2728 Learning Complete",completionMessage:"You've completed the lesson on",completionNextSteps:"Want to explore more?"},s={commandDescription:"\u901A\u8FC7\u5F15\u5BFC\u5F0F\u3001\u6765\u6E90\u9A8C\u8BC1\u7684\u6559\u5B66\u5B66\u4E60\u65B0\u77E5\u8BC6",commandArgTopic:"\u4F60\u60F3\u5B66\u4EC0\u4E48\uFF1F",missionDiscoveryTitle:"\u{1F3AF} \u4EFB\u52A1\u53D1\u73B0",missionWhyQuestion:"\u4F60\u4E3A\u4EC0\u4E48\u60F3\u5B66\u8FD9\u4E2A\uFF1F",missionSuccessQuestion:"\u6210\u529F\u7684\u6807\u51C6\u662F\u4EC0\u4E48\uFF1F",missionConstraintsQuestion:"\u6709\u4EC0\u4E48\u9650\u5236\u5417\uFF1F\uFF08\u65F6\u95F4\u3001\u8D44\u6E90\u7B49\uFF09",missionOutOfScopeQuestion:"\u6682\u65F6\u4E0D\u5305\u62EC\u54EA\u4E9B\u5185\u5BB9\uFF1F",learningStyleTitle:"\u{1F4DA} \u5B66\u4E60\u98CE\u683C",learningStyleQuick:"\u5FEB\u901F\u6982\u89C8 (10-15 \u5206\u949F) - \u53EA\u8BB2\u6838\u5FC3",learningStyleDeep:"\u6DF1\u5165\u5B66\u4E60 (30-60 \u5206\u949F) - \u5168\u9762\u7406\u89E3",learningStyleFocused:"\u5355\u70B9\u7A81\u7834 (20-30 \u5206\u949F) - \u4E13\u6CE8\u4E00\u4E2A\u6280\u80FD",learningStyleHolistic:"\u7CFB\u7EDF\u5B66\u4E60 (\u591A\u8F6E\u5BF9\u8BDD) - \u6210\u4E3A\u4E13\u5BB6",levelHook:"\u{1F3A3} \u4E3A\u4EC0\u4E48\u4F60\u5E94\u8BE5\u4E86\u89E3",level1:"\u{1F4CD} \u4E00\u53E5\u8BDD\u7248\u672C",level2:"\u{1F50D} \u5B83\u662F\u600E\u4E48\u5DE5\u4F5C\u7684",level3:"\u{1F407} \u6DF1\u5165\u4E86\u89E3\uFF08\u53EF\u9009\uFF09",sourceLabel:"\u6765\u6E90",confidenceLabel:"\u7F6E\u4FE1\u5EA6",verificationMethodLabel:"\u9A8C\u8BC1\u65B9\u6CD5",sourceUnavailable:"\u6682\u65E0\u53EF\u9760\u6765\u6E90",sourceUnverified:"\u5F85\u9A8C\u8BC1 - \u9700\u8981\u786E\u8BA4",progressSaved:"\u8FDB\u5EA6\u5DF2\u4FDD\u5B58",progressLoaded:"\u5DF2\u52A0\u8F7D\u4E4B\u524D\u7684\u8FDB\u5EA6",learningRecordSaved:"\u5B66\u4E60\u8BB0\u5F55\u5DF2\u4FDD\u5B58",checkpointContinue:"\u51C6\u5907\u7EE7\u7EED\u5417\uFF1F",checkpointDigest:"\u60F3\u7EE7\u7EED\u6DF1\u5165\u8FD8\u662F\u5148\u6D88\u5316\u4E00\u4E0B\uFF1F",checkpointMoreDepth:"\u8FD8\u60F3\u7EE7\u7EED\u6DF1\u5165\u5417\uFF1F",checkpointFeynman:"\u4F60\u80FD\u7528\u81EA\u5DF1\u7684\u8BDD\u63CF\u8FF0\u4E00\u4E0B\u5417\uFF1F",errorNoTopic:"\u8BF7\u6307\u5B9A\u5B66\u4E60\u4E3B\u9898\u3002\u7528\u6CD5\uFF1A/teach <\u4E3B\u9898>",errorInvalidStyle:"\u9009\u62E9\u7684\u5B66\u4E60\u98CE\u683C\u65E0\u6548",errorSourceVerificationFailed:"\u6765\u6E90\u9A8C\u8BC1\u5931\u8D25",completionTitle:"\u2728 \u5B66\u4E60\u5B8C\u6210",completionMessage:"\u4F60\u5DF2\u7ECF\u5B8C\u6210\u4E86\u5173\u4E8E",completionNextSteps:"\u60F3\u7EE7\u7EED\u63A2\u7D22\u5417\uFF1F"},r={en:t,zh:s};function l(e){return e==="zh"||e==="zh-CN"||e==="zh-TW"?"zh":"en"}o(l,"getTeachLocale");function a(e){return r[e??"en"]}o(a,"teachText");function u(){return"en"}o(u,"detectTeachLocale");export{u as detectTeachLocale,l as getTeachLocale,a as teachText};

package/dist/extensions/builtin/teach/teach-persistence.d.ts

@@ -0,0 +1,36 @@
+/**
+ * [WHO]: TeachPersistence - learning record and mission persistence
+ * [FROM]: Depends on node:fs, node:path for file operations
+ * [TO]: Consumed by teach-runtime.ts
+ * [HERE]: extensions/builtin/teach/teach-persistence.ts - data persistence for teach extension
+ */
+import type { LearningRecord, Mission } from "./teach-types.js";
+export declare class TeachPersistence {
+    private basePath;
+    constructor(workspacePath: string);
+    private ensureDirectories;
+    /**
+     * Save a learning record
+     */
+    saveLearningRecord(record: LearningRecord): Promise<string>;
+    /**
+     * Load learning records for a topic
+     */
+    loadLearningRecords(topic: string): Promise<LearningRecord[]>;
+    /**
+     * Save a mission
+     */
+    saveMission(topic: string, mission: Mission): Promise<string>;
+    /**
+     * Load a mission for a topic
+     */
+    loadMission(topic: string): Promise<Mission | null>;
+    /**
+     * Save glossary
+     */
+    saveGlossary(glossary: Map<string, string>): Promise<void>;
+    /**
+     * Load glossary
+     */
+    loadGlossary(): Promise<Map<string, string>>;
+}

package/dist/extensions/builtin/teach/teach-persistence.js

@@ -0,0 +1,35 @@
+var b=Object.defineProperty;var P=(g,t)=>b(g,"name",{value:t,configurable:!0});import{existsSync as l,mkdirSync as f,readFileSync as m,readdirSync as w,writeFileSync as S}from"node:fs";import{join as c}from"node:path";const M=".catui/teach",d="records",y="missions",O="glossary.json";class L{static{P(this,"TeachPersistence")}basePath;constructor(t){this.basePath=c(t,M)}ensureDirectories(){l(this.basePath)||f(this.basePath,{recursive:!0});const t=c(this.basePath,d);l(t)||f(t,{recursive:!0});const s=c(this.basePath,y);l(s)||f(s,{recursive:!0})}async saveLearningRecord(t){this.ensureDirectories();const s=c(this.basePath,d),a=t.timestamp.toISOString().replace(/[:.]/g,"-"),h=t.topic.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff]+/g,"-").replace(/^-|-$/g,""),n=`${a}-${h}.md`,i=c(s,n),o=`# ${t.topic}
+
+${t.content}
+
+---
+
+## Metadata
+
+- **Level**: ${t.level}
+- **Status**: ${t.status}
+- **Timestamp**: ${t.timestamp.toISOString()}
+`;return S(i,o,"utf-8"),i}async loadLearningRecords(t){this.ensureDirectories();const s=c(this.basePath,d);if(!l(s))return[];const a=w(s).filter(n=>n.endsWith(".md")),h=[];for(const n of a)try{const i=c(s,n),o=m(i,"utf-8"),r=o.match(/^# (.+)$/m),u=o.match(/\*\*Level\*\*:\s*(\d)/),e=o.match(/\*\*Status\*\*:\s*(active|superseded)/),$=o.match(/\*\*Timestamp\*\*:\s*(.+)$/m);if(r){const p=r[1].trim();(p.toLowerCase().includes(t.toLowerCase())||t.toLowerCase().includes(p.toLowerCase()))&&h.push({topic:p,level:u?Number.parseInt(u[1],10):0,content:o.split("---")[0].trim(),timestamp:$?new Date($[1]):new Date,status:e?.[1]??"active"})}}catch{}return h.sort((n,i)=>i.timestamp.getTime()-n.timestamp.getTime())}async saveMission(t,s){this.ensureDirectories();const a=c(this.basePath,y),n=`${t.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff]+/g,"-").replace(/^-|-$/g,"")}.md`,i=c(a,n),o=`# Mission: ${t}
+
+## Why
+${s.why}
+
+## Success looks like
+${s.successCriteria.map(r=>`- ${r}`).join(`
+`)}
+
+## Constraints
+${s.constraints.length>0?s.constraints.map(r=>`- ${r}`).join(`
+`):"- None specified"}
+
+## Out of scope
+${s.outOfScope.length>0?s.outOfScope.map(r=>`- ${r}`).join(`
+`):"- None specified"}
+
+---
+
+*Created: ${new Date().toISOString()}*
+`;return S(i,o,"utf-8"),i}async loadMission(t){this.ensureDirectories();const s=c(this.basePath,y),a=t.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff]+/g,"-").replace(/^-|-$/g,""),h=c(s,`${a}.md`);if(!l(h))return null;try{const n=m(h,"utf-8"),i=n.match(/## Why\n([\s\S]*?)(?=\n## )/),o=n.match(/## Success looks like\n([\s\S]*?)(?=\n## )/),r=n.match(/## Constraints\n([\s\S]*?)(?=\n## )/),u=n.match(/## Out of scope\n([\s\S]*?)(?=\n---)/);return{why:i?.[1]?.trim()??"",successCriteria:o?.[1]?.split(`
+`).filter(e=>e.startsWith("- ")).map(e=>e.slice(2).trim())??[],constraints:r?.[1]?.split(`
+`).filter(e=>e.startsWith("- ")).map(e=>e.slice(2).trim()).filter(e=>e!=="None specified")??[],outOfScope:u?.[1]?.split(`
+`).filter(e=>e.startsWith("- ")).map(e=>e.slice(2).trim()).filter(e=>e!=="None specified")??[]}}catch{return null}}async saveGlossary(t){this.ensureDirectories();const s=c(this.basePath,O),a=Object.fromEntries(t);S(s,JSON.stringify(a,null,2),"utf-8")}async loadGlossary(){this.ensureDirectories();const t=c(this.basePath,O);if(!l(t))return new Map;try{const s=m(t,"utf-8"),a=JSON.parse(s);return new Map(Object.entries(a))}catch{return new Map}}}export{L as TeachPersistence};

package/dist/extensions/builtin/teach/teach-prompts.d.ts

@@ -0,0 +1,52 @@
+/**
+ * [WHO]: teachPrompts - teaching prompt templates
+ * [FROM]: Depends on teach-types.ts for type definitions, teach-i18n.ts for localized strings
+ * [TO]: Consumed by teach-runtime.ts
+ * [HERE]: extensions/builtin/teach/teach-prompts.ts - prompt generation for teach extension
+ */
+import type { TeachLessonOptions } from "./teach-types.js";
+import { type TeachLocale } from "./teach-i18n.js";
+/**
+ * Generate mission discovery prompt
+ */
+export declare function missionDiscoveryPrompt(topic: string, locale?: TeachLocale): string;
+/**
+ * Generate learning style selection prompt
+ */
+export declare function learningStylePrompt(locale?: TeachLocale): string;
+/**
+ * Generate hook (Level 0)
+ */
+export declare function hookPrompt(options: TeachLessonOptions, locale?: TeachLocale): string;
+/**
+ * Generate Level 1 (One-sentence version)
+ */
+export declare function level1Prompt(options: TeachLessonOptions, locale?: TeachLocale): string;
+/**
+ * Generate Level 2 (Working knowledge)
+ */
+export declare function level2Prompt(options: TeachLessonOptions, locale?: TeachLocale): string;
+/**
+ * Generate Level 3 (Deep dive)
+ */
+export declare function level3Prompt(options: TeachLessonOptions, locale?: TeachLocale): string;
+/**
+ * Generate bridge (relevance to learner)
+ */
+export declare function bridgePrompt(topic: string, locale?: TeachLocale): string;
+/**
+ * Generate takeaways
+ */
+export declare function takeawaysPrompt(topic: string, locale?: TeachLocale): string;
+/**
+ * Generate Feynman check prompt
+ */
+export declare function feynmanCheckPrompt(locale?: TeachLocale): string;
+/**
+ * Generate checkpoint prompt
+ */
+export declare function checkpointPrompt(type: "continue" | "digest" | "depth", locale?: TeachLocale): string;
+/**
+ * Generate completion message
+ */
+export declare function completionPrompt(topic: string, locale?: TeachLocale): string;

package/dist/extensions/builtin/teach/teach-prompts.js

@@ -0,0 +1,35 @@
+var h=Object.defineProperty;var i=(n,t)=>h(n,"name",{value:t,configurable:!0});import{teachText as p}from"./teach-i18n.js";function w(n,t="en"){const s=p(t);return[`### ${s.missionDiscoveryTitle}`,"",`Before we start learning **${n}**, I need to understand:`,"",`1. **${s.missionWhyQuestion}**`,"   - Are you trying to solve a specific problem?","   - Or is it pure curiosity?","",`2. **${s.missionSuccessQuestion}**`,"   - What will you be able to do after learning this?","   - How will you know you've succeeded?","",`3. **${s.missionConstraintsQuestion}**`,"   - How much time do you have?","   - Any specific requirements?","",`4. **${s.missionOutOfScopeQuestion}**`,"   - What should we NOT cover right now?","","Please share your thoughts so I can customize the learning experience for you."].join(`
+`)}i(w,"missionDiscoveryPrompt");function v(n="en"){return[`### ${p(n).learningStyleTitle}`,"","Choose your preferred learning style:","","| Style | Duration | Depth | Best For |","|-------|----------|-------|----------|",'| **Quick Overview** | 10-15 min | Essentials | "Just need to know enough" |','| **Deep Dive** | 30-60 min | Comprehensive | "Want to truly understand" |','| **Focused Skill** | 20-30 min | Single skill | "Master one specific thing" |','| **Holistic** | Multiple sessions | Full picture | "Become an expert" |',"","Which style works best for you?"].join(`
+`)}i(v,"learningStylePrompt");function k(n,t="en"){const s=p(t),{topic:r,analogy:u,sources:o}=n,e=[`### \u{1F3A3} ${s.levelHook}\u300C${r}\u300D\uFF1F`,""];if(e.push(l(r)),e.push(""),u&&(e.push("**Analogy**: "+u.analogy),u.details&&(e.push(""),e.push(u.details)),e.push("")),o.length>0){e.push("---"),e.push(""),e.push("**Source Verification**:");for(const a of o)e.push(`- [${a.name}](${a.url}) - ${s.confidenceLabel}: ${"\u2B50".repeat(a.confidence)}`)}return e.join(`
+`)}i(k,"hookPrompt");function x(n,t="en"){const s=p(t),{topic:r,analogy:u,sources:o}=n,e=[`### \u{1F4CD} ${s.level1}`,"",`**${r}** is ${d(r)}.`,""];if(u&&(e.push(`Think of it like: ${u.analogy}`),e.push("")),e.push("That's the basics. Let's see how it actually works."),e.push(""),o.length>0){e.push("---"),e.push(""),e.push(`**${s.sourceLabel}**:`);for(const a of o)e.push(`- [${a.name}](${a.url}) - ${s.confidenceLabel}: ${"\u2B50".repeat(a.confidence)}`)}return e.join(`
+`)}i(x,"level1Prompt");function b(n,t="en"){const s=p(t),{topic:r,sources:u,learnerLevel:o}=n,e=[`### \u{1F50D} ${s.level2}`,""];if(e.push("**Core Concepts**:"),e.push(""),e.push(`- **${r}** has several key components`),e.push("  - Each serves a specific purpose"),e.push("  - They work together to achieve the goal"),e.push(""),e.push("**Example**:"),e.push(""),e.push("```"),e.push(`// ${f(r,o)}`),e.push("```"),e.push(""),e.push("**How it works**:"),e.push(""),e.push("```mermaid"),e.push(m(r)),e.push("```"),e.push(""),e.push("**Comparison**:"),e.push(""),e.push("| What you already know | What's new |"),e.push("|----------------------|------------|"),e.push(`| ${c(r).existing} | ${c(r).new} |`),e.push(""),u.length>0){e.push("---"),e.push(""),e.push(`**${s.sourceLabel}**:`);for(const a of u)e.push(`- [${a.name}](${a.url}) - ${s.confidenceLabel}: ${"\u2B50".repeat(a.confidence)}`)}return e.join(`
+`)}i(b,"level2Prompt");function P(n,t="en"){const s=p(t),{topic:r,sources:u}=n,o=[`### \u{1F407} ${s.level3}`,"","In real-world applications, this gets more complex:",""];if(o.push("**Advanced considerations**:"),o.push(""),o.push(`1. **Edge cases**: ${r} has several edge cases you'll encounter`),o.push("   - These are common in production environments"),o.push("   - Understanding them prevents bugs"),o.push(""),o.push(`2. **Performance**: ${r} can impact performance`),o.push("   - Know when to optimize"),o.push("   - Measure before optimizing"),o.push(""),o.push("3. **Best practices**: Follow established patterns"),o.push("   - They exist for a reason"),o.push("   - Learn from others' mistakes"),o.push(""),o.push("**Real-world example**:"),o.push(""),o.push("```"),o.push(`// ${g(r)}`),o.push("```"),o.push(""),o.push("**When you'll encounter this**:"),o.push(""),o.push("- When scaling your application"),o.push("- When debugging production issues"),o.push("- When reviewing code with experienced developers"),o.push(""),u.length>0){o.push("---"),o.push(""),o.push(`**${s.sourceLabel}**:`);for(const e of u)o.push(`- [${e.name}](${e.url}) - ${s.confidenceLabel}: ${"\u2B50".repeat(e.confidence)}`)}return o.join(`
+`)}i(P,"level3Prompt");function T(n,t="en"){return["### \u{1F309} Why this matters to you","",`Understanding **${n}** helps you:`,"","1. **Make better decisions**: You'll know what's possible and what's not",`2. **Communicate effectively**: You can discuss ${n} with others`,"3. **Solve problems faster**: You'll recognize patterns and solutions","","**Useful phrases**:",`- "How does our ${n} work?"`,`- "What are the trade-offs for this ${n} approach?"`].join(`
+`)}i(T,"bridgePrompt");function W(n,t="en"){return["### \u2728 Remember these three things","",`1. **Core concept**: ${n} is fundamental to understanding the bigger picture`,"2. **Practical value**: It helps you make informed decisions",`3. **Growth opportunity**: Mastering ${n} opens doors to advanced topics`,"","---","","**Want to explore more?**","- Try applying what you learned in a real scenario","- Ask questions about specific aspects you're curious about","- Practice with hands-on exercises"].join(`
+`)}i(W,"takeawaysPrompt");function L(n="en"){return`
+
+---
+
+**${p(n).checkpointFeynman}**
+
+This helps solidify your understanding and identifies any gaps.`}i(L,"feynmanCheckPrompt");function S(n,t="en"){const s=p(t);switch(n){case"continue":return`
+
+---
+
+${s.checkpointContinue}`;case"digest":return`
+
+---
+
+${s.checkpointDigest}`;case"depth":return`
+
+---
+
+${s.checkpointMoreDepth}`}}i(S,"checkpointPrompt");function C(n,t="en"){const s=p(t);return[`### ${s.completionTitle}`,"",`${s.completionMessage} **${n}**!`,"",`${s.completionNextSteps}`,"","- Practice with real examples","- Explore related topics","- Ask follow-up questions"].join(`
+`)}i(C,"completionPrompt");function l(n){const t=[`Have you ever wondered how ${n} works in practice?`,`You've probably encountered ${n} without realizing it.`,`Understanding ${n} will change how you think about this area.`,`Many people struggle with ${n} at first, but it's actually quite logical.`];return t[Math.floor(Math.random()*t.length)]}i(l,"generateHookScenario");function d(n){return`a fundamental concept that helps you understand and work with ${n} effectively`}i(d,"generateOneLiner");function f(n,t){return t==="L0"||t==="L1"?`// Simple example of ${n}
+// This shows the basic idea in action`:`// Example of ${n} in practice
+// This demonstrates how it's used in real applications`}i(f,"generateExample");function m(n){return`graph TD
+    A[Start] --> B[Understand ${n}]
+    B --> C[Apply Knowledge]
+    C --> D[Get Results]
+    D --> E[Learn More]`}i(m,"generateMermaidDiagram");function c(n){return{existing:"Something you already understand",new:`How ${n} extends this concept`}}i(c,"generateComparison");function g(n){return`// Real-world usage of ${n}
+// This is how it's used in production code`}i(g,"generateRealWorldExample");export{T as bridgePrompt,S as checkpointPrompt,C as completionPrompt,L as feynmanCheckPrompt,k as hookPrompt,v as learningStylePrompt,x as level1Prompt,b as level2Prompt,P as level3Prompt,w as missionDiscoveryPrompt,W as takeawaysPrompt};

package/dist/extensions/builtin/teach/teach-runtime.d.ts

@@ -0,0 +1,93 @@
+/**
+ * [WHO]: TeachRuntime - core teaching state machine
+ * [FROM]: Depends on teach-types.ts, teach-prompts.ts, teach-persistence.ts, teach-i18n.ts
+ * [TO]: Consumed by index.ts
+ * [HERE]: extensions/builtin/teach/teach-runtime.ts - teaching logic and state management
+ */
+import type { ExtensionCommandContext } from "../../../core/extensions-host/types.js";
+import type { TeachResult, TeachState } from "./teach-types.js";
+export declare class TeachRuntime {
+    private state;
+    private persistence;
+    private locale;
+    /**
+     * Initialize the runtime with workspace path
+     */
+    initialize(workspacePath: string): void;
+    /**
+     * Start teaching a new topic
+     */
+    startTeaching(ctx: ExtensionCommandContext, topic: string): Promise<TeachResult>;
+    /**
+     * Process user response and advance the teaching flow
+     */
+    processResponse(ctx: ExtensionCommandContext, response: string): Promise<TeachResult>;
+    /**
+     * Process mission discovery response
+     */
+    private processMissionResponse;
+    /**
+     * Process learning style response
+     */
+    private processLearningStyleResponse;
+    /**
+     * Process teaching response
+     */
+    private processTeachingResponse;
+    /**
+     * Process progress response
+     */
+    private processProgressResponse;
+    /**
+     * Teach the next level
+     */
+    private teachNextLevel;
+    /**
+     * Complete the teaching session
+     */
+    private completeTeaching;
+    /**
+     * Get the next action based on learning style and current level
+     */
+    private getNextAction;
+    /**
+     * Find an analogy for the topic
+     */
+    private findAnalogy;
+    /**
+     * Verify sources for the topic
+     */
+    private verifySources;
+    /**
+     * Parse mission from user response
+     */
+    private parseMission;
+    /**
+     * Parse learning style from user response
+     */
+    private parseLearningStyle;
+    /**
+     * Infer learner level from existing records
+     */
+    private inferLearnerLevel;
+    /**
+     * Build resume message
+     */
+    private buildResumeMessage;
+    /**
+     * Generate answer for a question
+     */
+    private generateAnswerForQuestion;
+    /**
+     * Get current state snapshot
+     */
+    private getStateSnapshot;
+    /**
+     * Get current state
+     */
+    getState(): TeachState | null;
+    /**
+     * Reset state
+     */
+    reset(): void;
+}

package/dist/extensions/builtin/teach/teach-runtime.js

@@ -0,0 +1,9 @@
+var y=Object.defineProperty;var u=(l,t)=>y(l,"name",{value:t,configurable:!0});import{teachText as v,detectTeachLocale as f}from"./teach-i18n.js";import{missionDiscoveryPrompt as w,learningStylePrompt as p,hookPrompt as g,level1Prompt as L,level2Prompt as k,level3Prompt as S,bridgePrompt as x,takeawaysPrompt as _,feynmanCheckPrompt as R,checkpointPrompt as d,completionPrompt as m}from"./teach-prompts.js";import{TeachPersistence as q}from"./teach-persistence.js";class A{static{u(this,"TeachRuntime")}state=null;persistence=null;locale="en";initialize(t){this.persistence=new q(t),this.locale=f()}async startTeaching(t,e){if(!this.persistence)return{type:"error",message:"Teach runtime not initialized"};this.state={phase:"mission_discovery",topic:e,learnerLevel:"L0",currentLevel:0,glossary:new Map,sources:[],learningRecords:[]};const s=await this.persistence.loadLearningRecords(e);s.length>0&&(this.state.learningRecords=s,this.state.learnerLevel=this.inferLearnerLevel(s));const i=await this.persistence.loadMission(e);return i?(this.state.mission=i,this.state.phase="learning_style",{type:"question",message:this.buildResumeMessage(e,i),options:["quick_overview","deep_dive","focused_skill","holistic"],state:this.getStateSnapshot()}):{type:"question",message:w(e,this.locale),state:this.getStateSnapshot()}}async processResponse(t,e){if(!this.state||!this.persistence)return{type:"error",message:"No active teaching session"};switch(this.state.phase){case"mission_discovery":return await this.processMissionResponse(e);case"learning_style":return await this.processLearningStyleResponse(e);case"teaching":return await this.processTeachingResponse(e);case"progress_tracking":return await this.processProgressResponse(e);default:return{type:"error",message:"Invalid teaching phase"}}}async processMissionResponse(t){const e=this.parseMission(t);return this.state.mission=e,await this.persistence.saveMission(this.state.topic,e),this.state.phase="learning_style",{type:"question",message:p(this.locale),options:["quick_overview","deep_dive","focused_skill","holistic"],state:this.getStateSnapshot()}}async processLearningStyleResponse(t){const e=this.parseLearningStyle(t);return e?(this.state.learningStyle=e,this.state.phase="teaching",this.state.currentLevel=0,await this.teachNextLevel()):{type:"error",message:v(this.locale).errorInvalidStyle}}async processTeachingResponse(t){const e=t.toLowerCase(),s=["stop","enough","quit","exit","\u591F\u4E86","\u505C","\u7ED3\u675F"],i=["deeper","more","\u6DF1\u5165","\u7EE7\u7EED","\u8BE6\u7EC6"];return s.some(a=>e.includes(a))?await this.completeTeaching():i.some(a=>e.includes(a))?await this.teachNextLevel():t.includes("?")||t.includes("\uFF1F")||e.startsWith("what")||e.startsWith("how")||e.startsWith("why")?{type:"info",message:`Great question! Let me explain that in the context of ${this.state.topic}...
+
+${this.generateAnswerForQuestion(t)}`}:await this.teachNextLevel()}async processProgressResponse(t){const e=t.toLowerCase();return["continue","more","next","\u7EE7\u7EED","\u4E0B\u4E00\u4E2A"].some(i=>e.includes(i))?{type:"question",message:"What would you like to learn next?"}:{type:"complete",message:m(this.state.topic,this.locale),state:this.getStateSnapshot()}}async teachNextLevel(){const{topic:t,currentLevel:e,learnerLevel:s,learningStyle:i}=this.state;if(e>3)return await this.completeTeaching();const a=await this.findAnalogy(t,e),h=await this.verifySources(t,e);this.state.sources=h;const r={topic:t,level:e,analogy:a,sources:h,learnerLevel:s,learningStyle:i??"quick_overview"};let n;switch(e){case 0:n=g(r,this.locale);break;case 1:n=L(r,this.locale);break;case 2:n=k(r,this.locale);break;case 3:n=S(r,this.locale);break;default:n=g(r,this.locale)}(e===3||i==="quick_overview"&&e===1)&&(n+=`
+
+`+x(t,this.locale),n+=`
+
+`+_(t,this.locale),n+=R(this.locale)),await this.persistence.saveLearningRecord({topic:t,level:e,content:n,timestamp:new Date,status:"active"});const o=this.getNextAction();this.state.currentLevel++;let c="";return o==="ask"?c=d("digest",this.locale):o==="continue"&&(c=d("continue",this.locale)),{type:"lesson",message:n+c,level:this.state.currentLevel-1,nextAction:o,state:this.getStateSnapshot()}}async completeTeaching(){return this.state.phase="progress_tracking",await this.persistence.saveGlossary(this.state.glossary),{type:"complete",message:m(this.state.topic,this.locale),state:this.getStateSnapshot()}}getNextAction(){const{currentLevel:t,learningStyle:e}=this.state;if(t>=3)return"complete";switch(e){case"quick_overview":return t>=1?"ask":"continue";case"deep_dive":return"continue";case"focused_skill":return t>=2?"ask":"continue";case"holistic":return"continue";default:return"continue"}}async findAnalogy(t,e){return{concept:t,analogy:`Think of ${t} like learning a new skill - it takes practice and patience`,details:"This analogy helps you understand the learning process itself",confidence:"medium"}}async verifySources(t,e){return[{name:"Official Documentation",url:"https://example.com/docs",confidence:5,verificationMethod:"Official source"}]}parseMission(t){const e=t.split(`
+`).filter(s=>s.trim());return{why:e[0]??t,successCriteria:e.slice(1,3).map(s=>s.replace(/^[-*]\s*/,"")),constraints:[],outOfScope:[]}}parseLearningStyle(t){const e=t.toLowerCase();return e.includes("quick")||e.includes("1")||e.includes("\u5FEB\u901F")?"quick_overview":e.includes("deep")||e.includes("2")||e.includes("\u6DF1\u5165")?"deep_dive":e.includes("focus")||e.includes("3")||e.includes("\u5355\u70B9")?"focused_skill":e.includes("holistic")||e.includes("4")||e.includes("\u7CFB\u7EDF")?"holistic":null}inferLearnerLevel(t){const e=Math.max(...t.map(s=>s.level));return e>=3?"L3":e>=2?"L2":e>=1?"L1":"L0"}buildResumeMessage(t,e){return[`Welcome back! We were learning about **${t}**.`,"",`**Mission**: ${e.why}`,"","Would you like to continue where we left off?","",p(this.locale)].join(`
+`)}generateAnswerForQuestion(t){return`That's a great question about ${this.state.topic}. Let me break it down for you...`}getStateSnapshot(){return this.state?{phase:this.state.phase,topic:this.state.topic,learnerLevel:this.state.learnerLevel,currentLevel:this.state.currentLevel,learningStyle:this.state.learningStyle}:{}}getState(){return this.state}reset(){this.state=null}}export{A as TeachRuntime};