learn-anything-cli 0.1.0

package/dist/core/templates/workflows/learn-topic.js

@@ -0,0 +1,191 @@
+const SKILL_NAME = 'learn-anything-topic';
+const SKILL_DESCRIPTION = 'Initialize or load a learning topic. AI generates a knowledge map, tracks progress, and lets you choose your own learning path.';
+const INSTRUCTIONS = `Always respond in the same language the user uses.
+If the user speaks Chinese, explain all concepts, examples, and guidance in Chinese.
+
+---
+
+You are Learn Anything's Knowledge Mentor. Your role is to help users systematically learn a technical topic.
+Your teaching philosophy: First establish the knowledge landscape, then let the user choose their own learning path.
+
+## Your Guiding Principles
+
+1. **Patient Guidance, Not Lecturing** — You are a tour guide, not a textbook. Show the map, let the user choose the direction.
+2. **Adapt to Level** — Judge the user's proficiency from how they ask questions (precision of terminology, depth of inquiry) and adjust explanation complexity.
+3. **Systems Thinking** — Always place concepts in the context of the knowledge map, helping users see the "knowledge tree".
+
+---
+
+## Command: /learn <topic-name>
+
+### Step 1: Determine if the topic exists
+
+Use the Bash tool to check if the directory ./.learn/topics/<topic-name>/ exists.
+
+**If it does NOT exist → Follow the "New Topic" workflow (below)**
+**If it EXISTS → Follow the "Load Existing Topic" workflow (below)**
+
+---
+
+## New Topic Workflow
+
+### Step 2: Create directory structure
+
+Use Bash to create the following directories and files:
+
+\`\`\`bash
+mkdir -p ./.learn/topics/<topic-name>/sessions
+\`\`\`
+
+### Step 3: Generate knowledge map (knowledge-map.md)
+
+Based on your expert understanding of "<topic-name>", generate a hierarchical knowledge map.
+
+**Knowledge map format requirements:**
+
+\`\`\`markdown
+# <Topic Name> Knowledge Map
+
+## <Domain 1>
+- <Concept 1.1>
+- <Concept 1.2>
+  - <Detail 1.2.1> (only when the concept is complex enough)
+  - <Detail 1.2.2>
+
+## <Domain 2>
+- <Concept 2.1>
+- <Concept 2.2>
+\`\`\`
+
+**Knowledge map generation rules:**
+- Use Markdown \`##\` for top-level domains, \`-\` for second-level concepts, indented \`-\` for third-level details
+- Keep depth to 2-3 levels, no more than 3
+- Breadth over depth: establish the full picture before going into details
+- For larger topics (e.g., "JavaScript"), include 15-25 core concepts
+- For narrower topics (e.g., "React Hooks"), include 10-15 concepts with more granularity
+- Name concepts precisely so they can be learned independently. E.g., use "Closures" not "Closure-related stuff"
+- Each leaf node should be a concept the user can learn and understand in a single session
+
+### Step 4: Generate initial state.yaml
+
+Use the Bash tool to write \`./.learn/topics/<topic-name>/state.yaml\`:
+
+\`\`\`yaml
+topic: <topic-name>
+created: <current date YYYY-MM-DD>
+concepts:
+  - path: "<Domain>/<Concept>"
+    status: unexplored
+    last_practiced: null
+    practice_count: 0
+    confidence: 0.0
+  - path: "<Domain>/<Concept>"
+    status: unexplored
+    ...
+\`\`\`
+
+The path format is "Domain/Concept", e.g., "Functions/Closures". Every leaf concept in the knowledge map corresponds to one path.
+
+### Step 5: Present and guide the user
+
+Display the knowledge map as an ASCII tree:
+
+\`\`\`
+🌟 JavaScript Knowledge Map
+
+Language Basics              Functions                  Objects & Prototypes
+├── Variables & Types       ├── Declarations & Expr     ├── Object Literals
+├── Operators               ├── Scope & Closures        ├── Constructors
+├── Control Flow            ├── this Keyword            ├── prototype & __proto__
+└── Type Coercion           ├── Arrow Functions         └── Inheritance Patterns
+                            └── Higher-Order Functions
+
+Async Programming           Tooling & Engineering
+├── Promise                 ├── Module System
+├── async/await             ├── npm/Package Mgmt
+└── Event Loop              └── Build Tools
+\`\`\`
+
+Then say:
+
+> This is the knowledge landscape for **JavaScript**. You can start learning by:
+>
+> - **Get an explanation**: \`/learn-explain closures\` — I'll walk you through a concept in depth
+> - **Practice coding**: \`/learn-practice Promise\` — Master concepts by writing code
+> - **Check progress**: \`/learn-status\` — View your learning progress anytime
+>
+> Where would you like to start? Or tell me what confuses you the most right now, and I can help you sort it out.
+
+---
+
+## Load Existing Topic Workflow
+
+### Step 2: Read existing data
+
+1. Use the Read tool to read \`./.learn/topics/<topic-name>/knowledge-map.md\`
+2. Use the Read tool to read \`./.learn/topics/<topic-name>/state.yaml\`
+
+### Step 3: Calculate and display progress
+
+Calculate the following statistics:
+- ✅ Concepts mastered
+- 🔄 Concepts in progress
+- ⚠️ Concepts needing practice
+- ⬜ Concepts unexplored
+
+Display the knowledge map with status markers.
+
+### Step 4: Give personalized recommendations
+
+Based on the state.yaml analysis, provide recommendations by priority:
+
+1. **Concepts with needs_practice** → Prioritize practice for reinforcement
+2. **Concepts with in_progress** → Suggest continuing deeper learning
+3. **Unexplored related concepts** → Suggest expanding knowledge boundaries
+4. **Concepts with older last_practiced** → Recommend review based on spaced repetition
+
+Example:
+
+> 📊 Your progress: 3 mastered, 2 in progress, 1 needs practice, 12 unexplored
+>
+> 🎯 Suggested next steps:
+> 1. ⚠️ **Prototypes** needs a practice session to solidify (last studied 3 days ago)
+> 2. 🔄 Continue with **Event Loop** — you last covered macrotasks and microtasks
+> 3. 📖 Explore new territory: **Module System** — this extends concepts you've already mastered
+>
+> Which would you like to pursue?
+
+---
+
+## Edge Cases
+
+- **Empty topic name**: Prompt the user "Please specify the topic you want to learn, e.g.: \`/learn javascript\`"
+- **Topic name with special characters**: Replace spaces and special characters with hyphens
+- **Knowledge map too large**: If the topic requires more than 30 concepts, prompt the user "This is a very broad topic. I'd suggest breaking it into smaller sub-topics. For example: 'Frontend Development' could be split into 'React', 'CSS', 'Build Tools', etc. Would you like to split it, or continue anyway?"`;
+const COMMAND_NAME = 'Learn: Topic';
+const COMMAND_DESCRIPTION = 'Initialize or load a learning topic — view knowledge map, track progress, choose your path';
+const COMMAND_CONTENT = `Use the learn-anything-topic skill to handle the user's /learn <topic-name> request.
+Follow the workflow defined in the skill:
+1. Determine if the topic exists
+2. New topic: create directory structure → generate knowledge-map.md and state.yaml → present knowledge map and guide the user
+3. Existing topic: read data → calculate progress → give personalized recommendations`;
+export function getLearnTopicSkillTemplate() {
+    return {
+        name: SKILL_NAME,
+        description: SKILL_DESCRIPTION,
+        instructions: INSTRUCTIONS,
+        license: 'MIT',
+        compatibility: 'Requires learn-anything CLI.',
+        metadata: { author: 'learn-anything', version: '1.0' },
+    };
+}
+export function getLearnTopicCommandTemplate() {
+    return {
+        name: COMMAND_NAME,
+        description: COMMAND_DESCRIPTION,
+        category: 'Learning',
+        tags: ['learning', 'topic', 'initialize'],
+        content: COMMAND_CONTENT,
+    };
+}
+//# sourceMappingURL=learn-topic.js.map

package/dist/i18n/index.d.ts

@@ -0,0 +1,6 @@
+import type { SupportedLocale, LocaleMessages } from './types.js';
+export declare function getMessages(locale: SupportedLocale): LocaleMessages;
+export declare function detectSystemLocale(): SupportedLocale;
+export declare function resolveLocale(cliFlag?: string): SupportedLocale;
+export type { SupportedLocale, LocaleMessages } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.js

@@ -0,0 +1,30 @@
+import { zhCN } from './locales/zh-CN.js';
+import { en } from './locales/en.js';
+const messages = {
+    'zh-CN': zhCN,
+    en,
+};
+export function getMessages(locale) {
+    return messages[locale];
+}
+export function detectSystemLocale() {
+    const langEnv = process.env.LANG ||
+        process.env.LC_ALL ||
+        process.env.LANGUAGE ||
+        '';
+    if (/^zh[_-]/i.test(langEnv)) {
+        return 'zh-CN';
+    }
+    return 'en';
+}
+export function resolveLocale(cliFlag) {
+    if (cliFlag === 'zh-CN' || cliFlag === 'en') {
+        return cliFlag;
+    }
+    if (cliFlag) {
+        // Unknown locale flag — warn and fall back
+        console.warn(`Unknown locale "${cliFlag}", falling back to system default.`);
+    }
+    return detectSystemLocale();
+}
+//# sourceMappingURL=index.js.map

package/dist/i18n/locales/en.d.ts

@@ -0,0 +1,3 @@
+import type { LocaleMessages } from '../types.js';
+export declare const en: LocaleMessages;
+//# sourceMappingURL=en.d.ts.map

package/dist/i18n/locales/en.js

@@ -0,0 +1,28 @@
+export const en = {
+    cli: {
+        programDescription: 'AI-powered recursive learning system with Socratic method and TDD practice',
+        initCommandDescription: 'Initialize Learn Anything learning skills in the current project',
+        updateCommandDescription: 'Update Learn Anything skill files to latest version',
+        toolsOptionDescription: (ids) => `Specify AI tools (non-interactive mode). Use "all", "none", or comma-separated list: ${ids}`,
+        notDirectory: (path) => `Path "${path}" is not a directory`,
+        dirNotExist: (path) => `Directory "${path}" does not exist, it will be created automatically.`,
+        cannotAccess: (path, msg) => `Cannot access path "${path}": ${msg}`,
+        errorPrefix: (msg) => `Error: ${msg}`,
+        updateComplete: 'Learn Anything skill files have been updated.',
+        forceOption: 'Skip confirmation prompt',
+        langOption: 'Display language: zh-CN or en (default: system locale)',
+    },
+    init: {
+        header: '\n🧠 Learn Anything — AI-Powered Recursive Learning System\n',
+        noToolsSelected: 'No AI tools selected. Use --tools option to specify, or select in interactive mode.',
+        availableTools: (tools) => `Available tools: ${tools}`,
+        skillGenerated: (toolName) => `  ✓ ${toolName} — 5 skill files generated`,
+        initComplete: '🎉 Learn Anything initialization complete!\n',
+        globalDataPath: (dir) => `  Learning data stored at ${dir}/`,
+        startLearning: (example) => `  Run ${example} to start your first learning topic\n`,
+        availableCommands: 'Available learning commands:',
+        cmdLine: (cmd, desc) => `  ${cmd}${desc}`,
+        interactiveSelectPrompt: 'Select AI tools to generate skills for (space to select, enter to confirm):',
+    },
+};
+//# sourceMappingURL=en.js.map

package/dist/i18n/locales/zh-CN.d.ts

@@ -0,0 +1,3 @@
+import type { LocaleMessages } from '../types.js';
+export declare const zhCN: LocaleMessages;
+//# sourceMappingURL=zh-CN.d.ts.map

package/dist/i18n/locales/zh-CN.js

@@ -0,0 +1,28 @@
+export const zhCN = {
+    cli: {
+        programDescription: 'AI-powered recursive learning system with Socratic method and TDD practice',
+        initCommandDescription: '在当前项目初始化 Learn Anything 学习技能',
+        updateCommandDescription: '更新 Learn Anything 技能文件到最新版本',
+        toolsOptionDescription: (ids) => `指定 AI 工具（非交互模式）。使用 "all"、"none"，或逗号分隔的工具列表：${ids}`,
+        notDirectory: (path) => `路径 "${path}" 不是一个目录`,
+        dirNotExist: (path) => `目录 "${path}" 不存在，将自动创建。`,
+        cannotAccess: (path, msg) => `无法访问路径 "${path}": ${msg}`,
+        errorPrefix: (msg) => `错误: ${msg}`,
+        updateComplete: 'Learn Anything 技能文件已更新。',
+        forceOption: '跳过确认提示',
+        langOption: '界面语言：zh-CN 或 en（默认读取系统语言设置）',
+    },
+    init: {
+        header: '\n🧠 Learn Anything — AI 驱动的递归学习系统\n',
+        noToolsSelected: '未选择任何 AI 工具。使用 --tools 参数指定，或在交互模式中选择。',
+        availableTools: (tools) => `可用的工具：${tools}`,
+        skillGenerated: (toolName) => `  ✓ ${toolName} — 5 个技能文件已生成`,
+        initComplete: '🎉 Learn Anything 初始化完成！\n',
+        globalDataPath: (dir) => `  学习数据存储在 ${dir}/`,
+        startLearning: (example) => `  运行 ${example} 开始你的第一个学习主题\n`,
+        availableCommands: '可用的学习命令：',
+        cmdLine: (cmd, desc) => `  ${cmd}${desc}`,
+        interactiveSelectPrompt: '选择要生成技能的 AI 工具（空格选择，回车确认）：',
+    },
+};
+//# sourceMappingURL=zh-CN.js.map

package/dist/i18n/types.d.ts

@@ -0,0 +1,31 @@
+export type SupportedLocale = 'zh-CN' | 'en';
+export interface CLIMessages {
+    programDescription: string;
+    initCommandDescription: string;
+    updateCommandDescription: string;
+    toolsOptionDescription: (ids: string) => string;
+    notDirectory: (path: string) => string;
+    dirNotExist: (path: string) => string;
+    cannotAccess: (path: string, msg: string) => string;
+    errorPrefix: (msg: string) => string;
+    updateComplete: string;
+    forceOption: string;
+    langOption: string;
+}
+export interface InitMessages {
+    header: string;
+    noToolsSelected: string;
+    availableTools: (tools: string) => string;
+    skillGenerated: (toolName: string) => string;
+    initComplete: string;
+    globalDataPath: (dir: string) => string;
+    startLearning: (example: string) => string;
+    availableCommands: string;
+    cmdLine: (cmd: string, desc: string) => string;
+    interactiveSelectPrompt: string;
+}
+export interface LocaleMessages {
+    cli: CLIMessages;
+    init: InitMessages;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/i18n/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { InitCommand } from './core/init.js';
+export { AI_TOOLS } from './core/config.js';
+export type { AIToolOption } from './core/config.js';
+export { getSkillTemplates, getCommandTemplates, getCommandContents, generateSkillContent, } from './core/shared/index.js';
+export type { SkillTemplateEntry, CommandTemplateEntry } from './core/shared/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,4 @@
+export { InitCommand } from './core/init.js';
+export { AI_TOOLS } from './core/config.js';
+export { getSkillTemplates, getCommandTemplates, getCommandContents, generateSkillContent, } from './core/shared/index.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/file-system.d.ts

@@ -0,0 +1,8 @@
+export declare class FileSystemUtils {
+    static ensureDir(dirPath: string): Promise<void>;
+    static writeFile(filePath: string, content: string): Promise<void>;
+    static fileExists(filePath: string): Promise<boolean>;
+    static dirExists(dirPath: string): Promise<boolean>;
+    static removeDir(dirPath: string): Promise<void>;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/utils/file-system.js

@@ -0,0 +1,38 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+export class FileSystemUtils {
+    static async ensureDir(dirPath) {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    static async writeFile(filePath, content) {
+        await FileSystemUtils.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    static async fileExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    static async dirExists(dirPath) {
+        try {
+            const stat = await fs.stat(dirPath);
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    static async removeDir(dirPath) {
+        try {
+            await fs.rm(dirPath, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore if directory doesn't exist
+        }
+    }
+}
+//# sourceMappingURL=file-system.js.map

package/dist/utils/interactive.d.ts

@@ -0,0 +1,2 @@
+export declare function isInteractive(): boolean;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/utils/interactive.js

@@ -0,0 +1,4 @@
+export function isInteractive() {
+    return process.stdin.isTTY && process.stdout.isTTY;
+}
+//# sourceMappingURL=interactive.js.map

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "learn-anything-cli",
+  "version": "0.1.0",
+  "description": "AI-powered recursive learning system with Socratic method and TDD practice",
+  "keywords": [
+    "learn-anything-cli",
+    "learn-anything",
+    "learning",
+    "cli",
+    "ai",
+    "education",
+    "socratic",
+    "tdd"
+  ],
+  "homepage": "https://github.com/ChenChenyaqi/learn-anything",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChenChenyaqi/learn-anything"
+  },
+  "license": "MIT",
+  "author": "yaqi chen",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "learn-anything": "./bin/learn-anything.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "!dist/**/*.test.js",
+    "!dist/**/__tests__",
+    "!dist/**/*.map"
+  ],
+  "scripts": {
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "dev:cli": "pnpm build && node bin/learn-anything.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "prepublishOnly": "pnpm run build"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.2.0",
+    "eslint": "^9.39.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.8.0",
+    "chalk": "^5.5.0",
+    "commander": "^14.0.0",
+    "fast-glob": "^3.3.3",
+    "yaml": "^2.8.2",
+    "zod": "^4.0.17"
+  }
+}