learn-anything-cli 0.4.0-beta.1 → 0.4.0

package/README.md

@@ -23,6 +23,12 @@ npm install -g learn-anything-cli
 learn-anything init
 ```
 
+### Context7 Integration (Optional)
+
+When running `init` or `update`, you'll be prompted to enable **Context7** for documentation verification. When enabled, the AI will fetch official documentation and verify its explanations against authoritative sources — improving teaching accuracy.
+
+If you haven't set up Context7 yet, run `npx ctx7 setup` or visit the [Context7 docs](https://context7.com/docs/resources/all-clients) for your specific AI tool.
+
 After init, your AI assistant gains five learning commands:
 
 | Command                          | What it does                                                 |

package/README.zh-CN.md

@@ -21,6 +21,12 @@ npm install -g learn-anything-cli
 learn-anything init
 ```
 
+### Context7 集成（可选）
+
+在执行 `init` 或 `update` 时，会提示是否启用 **Context7** 文档验证。启用后，AI 会获取官方文档并对照权威来源验证其教学内容——提高教学准确性。
+
+如果你还没有配置 Context7，运行 `npx ctx7 setup` 或访问 [Context7 文档](https://context7.com/docs/resources/all-clients) 查看你使用的 AI 工具的配置方式。
+
 初始化后，你的 AI 助手获得五个学习命令：
 
 | 命令                             | 功能                                   |

package/dist/cli/index.js

@@ -24,6 +24,8 @@ program
     .option('--tools <tools>', m.cli.toolsOptionDescription(availableToolIds.join(', ')))
     .option('--force', m.cli.forceOption)
     .option('--lang <locale>', m.cli.langOption)
+    .option('--context7', 'Enable Context7 documentation verification')
+    .option('--no-context7', 'Disable Context7 documentation verification')
     .action(async (targetPath = '.', options) => {
     const cliLocale = resolveLocale(options?.lang);
     const mc = cliLocale !== earlyLocale ? getMessages(cliLocale).cli : m.cli;
@@ -51,6 +53,7 @@ program
             tools: options?.tools,
             force: options?.force,
             locale: cliLocale,
+            context7: options?.context7,
         });
         await initCommand.execute(targetPath);
     }

package/dist/core/init.d.ts

@@ -4,14 +4,18 @@ type InitCommandOptions = {
     force?: boolean;
     locale?: SupportedLocale;
     update?: boolean;
+    context7?: boolean;
 };
 export declare class InitCommand {
     private readonly toolsArg?;
     private readonly force;
     private readonly locale;
     private readonly isUpdate;
+    private readonly context7Arg?;
+    private context7Enabled;
     constructor(options?: InitCommandOptions);
     execute(targetPath?: string): Promise<void>;
+    private promptContext7;
     private detectTools;
     private hasToolDir;
     private interactiveSelect;

package/dist/core/init.js

@@ -9,6 +9,7 @@ import { isInteractive } from '../utils/interactive.js';
 import { generateCommands, CommandAdapterRegistry } from './command-generation/index.js';
 import { getSkillTemplates, getCommandContents, generateSkillContent } from './shared/index.js';
 import { getMessages } from '../i18n/index.js';
+import { CONTEXT7_GUIDANCE } from './templates/context7-guidance.js';
 const require = createRequire(import.meta.url);
 const { version: VERSION } = require('../../package.json');
 export class InitCommand {
@@ -16,11 +17,14 @@ export class InitCommand {
     force;
     locale;
     isUpdate;
+    context7Arg;
+    context7Enabled = false;
     constructor(options = {}) {
         this.toolsArg = options.tools;
         this.force = options.force ?? false;
         this.locale = options.locale ?? 'en';
         this.isUpdate = options.update ?? false;
+        this.context7Arg = options.context7;
     }
     async execute(targetPath = '.') {
         const resolvedPath = path.resolve(targetPath);
@@ -67,6 +71,12 @@ export class InitCommand {
                 .join(', '))));
             return;
         }
+        // Context7 setup
+        this.context7Enabled = await this.promptContext7();
+        if (this.context7Enabled) {
+            console.log(chalk.dim(m.init.context7Enabled));
+        }
+        console.log('');
         // Generate skill files for each tool
         for (const tool of selectedTools) {
             if (!tool.skillsDir)
@@ -87,6 +97,21 @@ export class InitCommand {
         console.log(cmd(chalk.cyan('/learn:review [topic-name]'), chalk.dim('    — Review progress, spaced repetition recommendations')));
         console.log(cmd(chalk.cyan('/learn:status [topic-name]'), chalk.dim('    — Visualize learning state as knowledge map heatmap')));
         console.log('');
+        if (this.context7Enabled) {
+            console.log(chalk.dim(m.init.context7SetupHint));
+            console.log('');
+        }
+    }
+    async promptContext7() {
+        const m = getMessages(this.locale);
+        if (this.context7Arg === true)
+            return true;
+        if (this.context7Arg === false)
+            return false;
+        if (!isInteractive())
+            return true;
+        const { confirm } = await import('@inquirer/prompts');
+        return confirm({ message: m.init.context7Prompt, default: true });
     }
     async detectTools(_resolvedPath) {
         return AI_TOOLS;
@@ -125,7 +150,9 @@ export class InitCommand {
         for (const entry of skillTemplates) {
             const skillDir = path.join(resolvedPath, tool.skillsDir, 'skills', entry.dirName);
             const skillFile = path.join(skillDir, 'SKILL.md');
-            const content = generateSkillContent(entry.template, VERSION);
+            const content = generateSkillContent(entry.template, VERSION, this.context7Enabled && isDocVerificationTemplate(entry.workflowId)
+                ? injectContext7Guidance
+                : undefined);
             await FileSystemUtils.writeFile(skillFile, content);
             const scriptsDir = path.join(skillDir, 'scripts');
             // topic / explain / practice → utils.mjs + render.mjs
@@ -160,4 +187,15 @@ export class InitCommand {
         }
     }
 }
+const DOC_VERIFICATION_WORKFLOWS = new Set(['topic', 'explain', 'practice']);
+function isDocVerificationTemplate(workflowId) {
+    return DOC_VERIFICATION_WORKFLOWS.has(workflowId);
+}
+function injectContext7Guidance(instructions) {
+    const marker = '\n## Command:';
+    const index = instructions.indexOf(marker);
+    if (index === -1)
+        return instructions + CONTEXT7_GUIDANCE;
+    return instructions.slice(0, index) + CONTEXT7_GUIDANCE + instructions.slice(index);
+}
 //# sourceMappingURL=init.js.map

package/dist/core/templates/context7-guidance.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context7 documentation verification guidance.
+ * Injected into topic/explain/practice skill templates when Context7 is enabled.
+ *
+ * Instructs the AI to use Context7 MCP tools at runtime:
+ * - resolve-library-id: resolves library name to Context7 ID
+ * - query-docs: fetches docs by library ID + query
+ *
+ * NOT injected into review/status templates (those are about progress review
+ * and visualization, not teaching content).
+ */
+export declare const CONTEXT7_GUIDANCE = "\n## Documentation Verification (Context7)\n\nWhen teaching about a specific library or framework, verify your explanations against official documentation using Context7 MCP tools:\n\n1. **Resolve the library**: Call `resolve-library-id` with the library name (e.g., \"React\", \"TypeScript\")\n2. **Fetch relevant docs**: Call `query-docs` with the resolved library ID and the concept you are teaching as the query\n3. **Cross-reference**: Ensure your explanations, code examples, and API usage match the official documentation\n4. **Defer to docs**: If your explanation conflicts with official documentation, use the official documentation as the authoritative source\n\nIf Context7 MCP tools are not available in your environment, proceed with your built-in knowledge.\n";
+//# sourceMappingURL=context7-guidance.d.ts.map

package/dist/core/templates/context7-guidance.js

@@ -0,0 +1,24 @@
+/**
+ * Context7 documentation verification guidance.
+ * Injected into topic/explain/practice skill templates when Context7 is enabled.
+ *
+ * Instructs the AI to use Context7 MCP tools at runtime:
+ * - resolve-library-id: resolves library name to Context7 ID
+ * - query-docs: fetches docs by library ID + query
+ *
+ * NOT injected into review/status templates (those are about progress review
+ * and visualization, not teaching content).
+ */
+export const CONTEXT7_GUIDANCE = `
+## Documentation Verification (Context7)
+
+When teaching about a specific library or framework, verify your explanations against official documentation using Context7 MCP tools:
+
+1. **Resolve the library**: Call \`resolve-library-id\` with the library name (e.g., "React", "TypeScript")
+2. **Fetch relevant docs**: Call \`query-docs\` with the resolved library ID and the concept you are teaching as the query
+3. **Cross-reference**: Ensure your explanations, code examples, and API usage match the official documentation
+4. **Defer to docs**: If your explanation conflicts with official documentation, use the official documentation as the authoritative source
+
+If Context7 MCP tools are not available in your environment, proceed with your built-in knowledge.
+`;
+//# sourceMappingURL=context7-guidance.js.map

package/dist/i18n/locales/en.js

@@ -24,6 +24,9 @@ export const en = {
         cmdLine: (cmd, desc) => `  ${cmd}${desc}`,
         interactiveSelectPrompt: 'Select AI tools to generate skills for (space to select, enter to confirm):',
         migrationComplete: (count) => `Migrated ${count} topic(s) from v0 to v1 format (backups created).`,
+        context7Prompt: 'Enable Context7 for documentation verification? (Provides on-demand access to official library docs)',
+        context7Enabled: '  📚 Context7 guidance enabled.',
+        context7SetupHint: '  💡 To set up Context7 MCP, run `npx ctx7 setup` or visit https://context7.com/docs/resources/all-clients',
     },
 };
 //# sourceMappingURL=en.js.map

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

@@ -24,6 +24,9 @@ export const zhCN = {
         cmdLine: (cmd, desc) => `  ${cmd}${desc}`,
         interactiveSelectPrompt: '选择要生成技能的 AI 工具（空格选择，回车确认）：',
         migrationComplete: (count) => `已迁移 ${count} 个主题从 v0 到 v1 格式（已创建备份）。`,
+        context7Prompt: '是否启用 Context7 进行文档验证？（提供按需访问官方库文档的能力）',
+        context7Enabled: '  📚 已启用 Context7 文档验证引导。',
+        context7SetupHint: '  💡 配置 Context7 MCP：运行 `npx ctx7 setup` 或访问 https://context7.com/docs/resources/all-clients',
     },
 };
 //# sourceMappingURL=zh-CN.js.map

package/dist/i18n/types.d.ts

@@ -24,6 +24,9 @@ export interface InitMessages {
     cmdLine: (cmd: string, desc: string) => string;
     interactiveSelectPrompt: string;
     migrationComplete: (count: number) => string;
+    context7Prompt: string;
+    context7Enabled: string;
+    context7SetupHint: string;
 }
 export interface LocaleMessages {
     cli: CLIMessages;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "learn-anything-cli",
-  "version": "0.4.0-beta.1",
+  "version": "0.4.0",
   "description": "AI-powered recursive learning system with Socratic method and TDD practice",
   "keywords": [
     "learn-anything-cli",