bobo-ai-cli 1.0.1

package/dist/memory.js

@@ -0,0 +1,215 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfigDir } from './config.js';
+const MEMORY_FILE = 'memory.md';
+const MEMORY_DIR = 'memory';
+const LEARNINGS_DIR = '.learnings';
+const MAX_MEMORY_SIZE = 5 * 1024; // 5KB
+/**
+ * Get paths for memory storage
+ */
+function getMemoryPaths() {
+    const configDir = getConfigDir();
+    return {
+        memoryFile: join(configDir, MEMORY_FILE),
+        memoryDir: join(configDir, MEMORY_DIR),
+        learningsDir: join(configDir, LEARNINGS_DIR),
+        correctionsFile: join(configDir, LEARNINGS_DIR, 'corrections.md'),
+        changelogFile: join(configDir, LEARNINGS_DIR, 'changelog.md'),
+    };
+}
+/**
+ * Ensure memory directories exist
+ */
+function ensureMemoryDirs() {
+    const paths = getMemoryPaths();
+    for (const dir of [paths.memoryDir, paths.learningsDir]) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+/**
+ * Load memory.md content for system prompt injection
+ */
+export function loadMemory() {
+    const { memoryFile } = getMemoryPaths();
+    if (!existsSync(memoryFile))
+        return null;
+    const content = readFileSync(memoryFile, 'utf-8').trim();
+    return content || null;
+}
+/**
+ * Save a memory entry
+ */
+export function saveMemory(entry) {
+    ensureMemoryDirs();
+    const { memoryFile } = getMemoryPaths();
+    let content = '';
+    if (existsSync(memoryFile)) {
+        content = readFileSync(memoryFile, 'utf-8');
+    }
+    else {
+        content = getMemoryTemplate();
+    }
+    const sectionMap = {
+        user: '## 🔒 用户偏好',
+        feedback: '## 🔄 纠正记录',
+        project: '## 📋 活跃任务',
+        reference: '## 📝 业务经验',
+        experience: '## 📝 业务经验',
+    };
+    const section = sectionMap[entry.category] || '## 📝 业务经验';
+    const line = `- [${entry.timestamp}] ${entry.content}`;
+    // Find the section and append
+    const sectionIdx = content.indexOf(section);
+    if (sectionIdx !== -1) {
+        // Find next section or end
+        const nextSectionIdx = content.indexOf('\n## ', sectionIdx + section.length);
+        const insertAt = nextSectionIdx !== -1 ? nextSectionIdx : content.length;
+        content = content.slice(0, insertAt).trimEnd() + '\n' + line + '\n' + content.slice(insertAt);
+    }
+    else {
+        // Append section at end
+        content = content.trimEnd() + '\n\n' + section + '\n' + line + '\n';
+    }
+    // Check size and slim if needed
+    if (Buffer.byteLength(content, 'utf-8') > MAX_MEMORY_SIZE) {
+        content = slimMemory(content);
+    }
+    writeFileSync(memoryFile, content);
+    // Also log to daily file
+    logDaily(entry);
+    return `Memory saved: [${entry.category}] ${entry.content.slice(0, 50)}...`;
+}
+/**
+ * Search memory for relevant entries (multi-keyword scoring)
+ */
+export function searchMemory(query) {
+    const { memoryFile, memoryDir } = getMemoryPaths();
+    const queryLower = query.toLowerCase();
+    const keywords = queryLower.split(/\s+/).filter(k => k.length > 1);
+    const results = [];
+    function scoreLines(content, source) {
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const lineLower = lines[i].toLowerCase();
+            if (!lineLower.trim())
+                continue;
+            // Score: number of matching keywords + bonus for exact phrase match
+            let score = 0;
+            for (const kw of keywords) {
+                if (lineLower.includes(kw))
+                    score++;
+            }
+            if (score === 0)
+                continue;
+            // Bonus for exact phrase match
+            if (lineLower.includes(queryLower))
+                score += keywords.length;
+            // Include context (1 line before, 1 after)
+            const start = Math.max(0, i - 1);
+            const end = Math.min(lines.length, i + 2);
+            const text = lines.slice(start, end).join('\n');
+            results.push({ source, line: i + 1, text, score });
+        }
+    }
+    // Search main memory
+    if (existsSync(memoryFile)) {
+        scoreLines(readFileSync(memoryFile, 'utf-8'), 'memory.md');
+    }
+    // Search daily logs (last 7 days)
+    if (existsSync(memoryDir)) {
+        const files = readdirSync(memoryDir)
+            .filter(f => f.endsWith('.md'))
+            .sort()
+            .slice(-7);
+        for (const file of files) {
+            scoreLines(readFileSync(join(memoryDir, file), 'utf-8'), file);
+        }
+    }
+    if (results.length === 0) {
+        return `No memory entries found for: "${query}"`;
+    }
+    // Sort by score (highest first), deduplicate overlapping results
+    results.sort((a, b) => b.score - a.score);
+    const seen = new Set();
+    const deduped = [];
+    for (const r of results) {
+        const key = `${r.source}:${r.line}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            deduped.push(r);
+        }
+    }
+    return deduped
+        .slice(0, 10)
+        .map(r => `[${r.source}:${r.line}] (score:${r.score}) ${r.text}`)
+        .join('\n\n');
+}
+/**
+ * Log to daily memory file
+ */
+function logDaily(entry) {
+    const { memoryDir } = getMemoryPaths();
+    const date = entry.timestamp.split(' ')[0] || new Date().toISOString().split('T')[0];
+    const dailyFile = join(memoryDir, `${date}.md`);
+    let content = '';
+    if (existsSync(dailyFile)) {
+        content = readFileSync(dailyFile, 'utf-8');
+    }
+    else {
+        content = `# ${date} Daily Log\n`;
+    }
+    content += `\n- [${entry.timestamp}] [${entry.category}] ${entry.content}`;
+    writeFileSync(dailyFile, content);
+}
+/**
+ * Slim memory when it exceeds size limit
+ */
+function slimMemory(content) {
+    const lines = content.split('\n');
+    const result = [];
+    let inPermanentSection = false;
+    for (const line of lines) {
+        // Permanent sections - keep everything
+        if (line.includes('🔒') || line.includes('💼')) {
+            inPermanentSection = true;
+            result.push(line);
+            continue;
+        }
+        // New section starts
+        if (line.startsWith('## ')) {
+            inPermanentSection = false;
+            result.push(line);
+            continue;
+        }
+        if (inPermanentSection) {
+            result.push(line);
+            continue;
+        }
+        // For non-permanent sections, keep recent entries (last 10 per section)
+        result.push(line);
+    }
+    return result.join('\n');
+}
+/**
+ * Get the default memory template
+ */
+function getMemoryTemplate() {
+    return `# Memory - 大波比
+
+## 🔒 用户偏好（永久保留）
+
+## 💼 角色定位（永久保留）
+
+## 📝 业务经验（长期保留）
+
+## 📋 活跃任务（完成后删）
+
+## 🔄 纠正记录（≤10条）
+
+## 💬 对话摘要（7天后精简）
+`;
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/planner.d.ts

@@ -0,0 +1,22 @@
+import type { ChatCompletionTool } from 'openai/resources/index.js';
+export interface PlanStep {
+    id: number;
+    description: string;
+    status: 'pending' | 'in-progress' | 'done' | 'skipped';
+}
+export interface Plan {
+    title: string;
+    steps: PlanStep[];
+    createdAt: string;
+}
+export declare const plannerToolDefinitions: ChatCompletionTool[];
+export declare function executePlannerTool(name: string, args: Record<string, unknown>): string;
+export declare function isPlannerTool(name: string): boolean;
+/**
+ * Get current plan for display in /plan command
+ */
+export declare function getCurrentPlan(): string;
+/**
+ * Reset the plan (for /clear)
+ */
+export declare function resetPlan(): void;

package/dist/planner.js

@@ -0,0 +1,130 @@
+// Session-scoped plan (not persisted, lives within one REPL session)
+let currentPlan = null;
+// ─── Tool Definitions ────────────────────────────────────────
+export const plannerToolDefinitions = [
+    {
+        type: 'function',
+        function: {
+            name: 'create_plan',
+            description: 'Create a task plan with steps. Use for tasks with 3+ steps. Shows the plan to the user before execution.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Plan title' },
+                    steps: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of step descriptions',
+                    },
+                },
+                required: ['title', 'steps'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'update_plan',
+            description: 'Update the status of a plan step.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    stepId: { type: 'number', description: 'Step ID (1-indexed)' },
+                    status: {
+                        type: 'string',
+                        enum: ['pending', 'in-progress', 'done', 'skipped'],
+                        description: 'New status',
+                    },
+                },
+                required: ['stepId', 'status'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'show_plan',
+            description: 'Display the current task plan with progress.',
+            parameters: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+        },
+    },
+];
+// ─── Tool Execution ──────────────────────────────────────────
+export function executePlannerTool(name, args) {
+    switch (name) {
+        case 'create_plan': return createPlan(args);
+        case 'update_plan': return updatePlan(args);
+        case 'show_plan': return showPlan();
+        default: return `Unknown planner tool: ${name}`;
+    }
+}
+export function isPlannerTool(name) {
+    return ['create_plan', 'update_plan', 'show_plan'].includes(name);
+}
+function createPlan(args) {
+    const title = args.title;
+    const stepDescs = args.steps;
+    currentPlan = {
+        title,
+        steps: stepDescs.map((desc, i) => ({
+            id: i + 1,
+            description: desc,
+            status: 'pending',
+        })),
+        createdAt: new Date().toISOString(),
+    };
+    return formatPlan(currentPlan);
+}
+function updatePlan(args) {
+    if (!currentPlan)
+        return 'No active plan. Create one first with create_plan.';
+    const stepId = args.stepId;
+    const status = args.status;
+    const step = currentPlan.steps.find(s => s.id === stepId);
+    if (!step)
+        return `Step ${stepId} not found. Plan has ${currentPlan.steps.length} steps.`;
+    step.status = status;
+    return formatPlan(currentPlan);
+}
+function showPlan() {
+    if (!currentPlan)
+        return 'No active plan.';
+    return formatPlan(currentPlan);
+}
+function formatPlan(plan) {
+    const statusIcons = {
+        'pending': '⬜',
+        'in-progress': '🔵',
+        'done': '✅',
+        'skipped': '⏭️',
+    };
+    const total = plan.steps.length;
+    const done = plan.steps.filter(s => s.status === 'done').length;
+    const progress = Math.round((done / total) * 100);
+    let output = `📋 ${plan.title} [${done}/${total} = ${progress}%]\n`;
+    output += '─'.repeat(40) + '\n';
+    for (const step of plan.steps) {
+        const icon = statusIcons[step.status] || '⬜';
+        output += `${icon} ${step.id}. ${step.description}\n`;
+    }
+    return output;
+}
+/**
+ * Get current plan for display in /plan command
+ */
+export function getCurrentPlan() {
+    if (!currentPlan)
+        return 'No active plan.';
+    return formatPlan(currentPlan);
+}
+/**
+ * Reset the plan (for /clear)
+ */
+export function resetPlan() {
+    currentPlan = null;
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,25 @@
+export interface ProjectConfig {
+    name?: string;
+    description?: string;
+    knowledge?: string[];
+    rules?: string[];
+}
+/**
+ * Find project root by walking up from CWD looking for .bobo/
+ */
+export declare function findProjectRoot(): string | null;
+/**
+ * Load project config if in a project
+ */
+export declare function loadProjectConfig(): {
+    root: string;
+    config: ProjectConfig;
+} | null;
+/**
+ * Load project-level knowledge for system prompt injection
+ */
+export declare function loadProjectKnowledge(): string | null;
+/**
+ * Initialize a project .bobo/ directory
+ */
+export declare function initProject(): string;

package/dist/project.js

@@ -0,0 +1,117 @@
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const PROJECT_DIR = '.bobo';
+const PROJECT_CONFIG = 'project.json';
+/**
+ * Find project root by walking up from CWD looking for .bobo/
+ */
+export function findProjectRoot() {
+    let dir = process.cwd();
+    const root = resolve('/');
+    while (dir !== root) {
+        if (existsSync(join(dir, PROJECT_DIR))) {
+            return dir;
+        }
+        dir = resolve(dir, '..');
+    }
+    return null;
+}
+/**
+ * Load project config if in a project
+ */
+export function loadProjectConfig() {
+    const root = findProjectRoot();
+    if (!root)
+        return null;
+    const configPath = join(root, PROJECT_DIR, PROJECT_CONFIG);
+    if (!existsSync(configPath)) {
+        return { root, config: {} };
+    }
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        return { root, config };
+    }
+    catch {
+        return { root, config: {} };
+    }
+}
+/**
+ * Load project-level knowledge for system prompt injection
+ */
+export function loadProjectKnowledge() {
+    const project = loadProjectConfig();
+    if (!project)
+        return null;
+    const parts = [];
+    const boboDir = join(project.root, PROJECT_DIR);
+    // Load project description
+    if (project.config.name) {
+        parts.push(`# Project: ${project.config.name}`);
+        if (project.config.description) {
+            parts.push(project.config.description);
+        }
+    }
+    // Load project knowledge files
+    const knowledgeFiles = project.config.knowledge || [];
+    for (const file of knowledgeFiles) {
+        const filePath = join(boboDir, file);
+        if (existsSync(filePath)) {
+            parts.push(readFileSync(filePath, 'utf-8').trim());
+        }
+    }
+    // Load project rules
+    const ruleFiles = project.config.rules || [];
+    for (const file of ruleFiles) {
+        const filePath = join(boboDir, file);
+        if (existsSync(filePath)) {
+            parts.push(readFileSync(filePath, 'utf-8').trim());
+        }
+    }
+    // Auto-detect common project files
+    const autoDetect = ['AGENTS.md', 'CLAUDE.md', 'CONVENTIONS.md', 'RULES.md'];
+    for (const file of autoDetect) {
+        const filePath = join(project.root, file);
+        if (existsSync(filePath)) {
+            const content = readFileSync(filePath, 'utf-8').trim();
+            if (content.length < 5000) { // Don't load huge files
+                parts.push(`# ${file}\n\n${content}`);
+            }
+        }
+    }
+    return parts.length > 0 ? parts.join('\n\n---\n\n') : null;
+}
+/**
+ * Initialize a project .bobo/ directory
+ */
+export function initProject() {
+    const projectDir = join(process.cwd(), PROJECT_DIR);
+    if (existsSync(projectDir)) {
+        return `Project already initialized at ${projectDir}`;
+    }
+    mkdirSync(projectDir, { recursive: true });
+    const config = {
+        name: process.cwd().split('/').pop() || 'project',
+        description: '',
+        knowledge: [],
+        rules: [],
+    };
+    writeFileSync(join(projectDir, PROJECT_CONFIG), JSON.stringify(config, null, 2) + '\n');
+    writeFileSync(join(projectDir, 'README.md'), `# Project Configuration
+
+This directory contains project-specific configuration for bobo-cli.
+
+## Files
+
+- \`project.json\` — Project config (name, knowledge files, rules)
+- Add \`.md\` files here and reference them in project.json
+
+## Usage
+
+\`\`\`bash
+# Run bobo in this project (auto-detects .bobo/)
+bobo "explain this codebase"
+\`\`\`
+`);
+    return `Initialized project at ${projectDir}`;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,cAAc,GAAG,cAAc,CAAC;AAStC;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC;QACpB,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAEhD,2BAA2B;IAC3B,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC,wBAAwB;gBACnD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,OAAO,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IAEpD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,kCAAkC,UAAU,EAAE,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAkB;QAC5B,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS;QACjD,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,aAAa,CACX,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACvC,CAAC;IAEF,aAAa,CACX,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAC7B;;;;;;;;;;;;;;;CAeH,CACE,CAAC;IAEF,OAAO,0BAA0B,UAAU,EAAE,CAAC;AAChD,CAAC"}

package/dist/rules-commands.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerRulesCommand(program: Command): Command;

package/dist/rules-commands.js

@@ -0,0 +1,51 @@
+import chalk from 'chalk';
+import { KnowledgeLoader } from './structured/loader.js';
+import { KnowledgeSearch } from './structured/search.js';
+import { getStructuredKnowledgePath } from './structured/paths.js';
+import { renderRule, renderSearchResult } from './structured/render-markdown.js';
+import { renderTable } from './structured/render-table.js';
+export function registerRulesCommand(program) {
+    const rules = program.command('rules').description('Browse structured rules');
+    rules
+        .command('list')
+        .description('List all rules')
+        .option('-c, --category <cat>', '按分类过滤')
+        .action(async (opts) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const all = await loader.listRules();
+        const filtered = opts.category ? all.filter((rule) => rule.category === opts.category) : all;
+        if (filtered.length === 0) {
+            console.log(chalk.dim('No rules found.'));
+            return;
+        }
+        renderTable(['ID', 'Title', 'Category', 'Tags'], filtered.map((rule) => [rule.id, rule.title, rule.category, rule.tags.join(', ')]));
+        console.log(chalk.dim(`\n${filtered.length} rules`));
+    });
+    rules
+        .command('show <id>')
+        .description('显示规则全文')
+        .action(async (id) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const rule = await loader.loadRule(id);
+        if (!rule) {
+            console.log(chalk.red(`Rule not found: ${id}`));
+            process.exit(1);
+        }
+        renderRule(rule);
+    });
+    rules
+        .command('search <query>')
+        .description('Search rules')
+        .action(async (query) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const search = new KnowledgeSearch(loader);
+        const results = await search.searchByType(query, 'rule');
+        if (results.length === 0) {
+            console.log(chalk.dim('No matching rules.'));
+            return;
+        }
+        results.forEach(renderSearchResult);
+    });
+    return rules;
+}
+//# sourceMappingURL=rules-commands.js.map

package/dist/rules-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-commands.js","sourceRoot":"","sources":["../src/rules-commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAE9E,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gBAAgB,CAAC;SAC7B,MAAM,CAAC,sBAAsB,EAAE,OAAO,CAAC;SACvC,MAAM,CAAC,KAAK,EAAE,IAA2B,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,0BAA0B,EAAE,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,WAAW,CACT,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,EACnC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CACnF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,QAAQ,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,0BAA0B,EAAE,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,cAAc,CAAC;SAC3B,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,0BAA0B,EAAE,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEL,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,28 @@
+export interface Skill {
+    name: string;
+    description: string;
+    enabled: boolean;
+    type: 'builtin' | 'custom';
+    promptFile?: string;
+}
+/**
+ * List all available skills
+ */
+export declare function listSkills(): Skill[];
+/**
+ * Enable or disable a skill
+ */
+export declare function setSkillEnabled(name: string, enabled: boolean): string;
+/**
+ * Load enabled skill prompts for system prompt injection
+ */
+export declare function loadSkillPrompts(): string;
+/**
+ * Import OpenClaw skills from a directory into ~/.bobo/skills/
+ * Returns a report of imported/skipped skills
+ */
+export declare function importSkills(sourceDir: string): string;
+/**
+ * Initialize skills directory with README
+ */
+export declare function initSkills(): void;