npm - khabotcli - Versions diffs - 1.0.0 - Mend

khabotcli 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2163) hide show

package/docs/index.html ADDED Viewed

@@ -0,0 +1,623 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>KhaBot CLI Documentation</title>
+    <!-- Tailwind CSS -->
+    <script src="https://cdn.tailwindcss.com"></script>
+    <!-- Marked.js for Markdown parsing -->
+    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/marked-highlight/lib/index.umd.js"></script>
+    <!-- Highlight.js for syntax highlighting -->
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/styles/github-dark.min.css">
+    <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/highlight.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/languages/json.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/languages/bash.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/languages/javascript.min.js"></script>
+    <!-- Fuse.js for fuzzy search -->
+    <script src="https://cdn.jsdelivr.net/npm/fuse.js@7.0.0"></script>
+    <!-- Lucide Icons -->
+    <script src="https://unpkg.com/lucide@latest"></script>
+    <script>
+        tailwind.config = {
+            darkMode: 'class',
+            theme: {
+                extend: {
+                    colors: {
+                        primary: {
+                            50: '#f0f9ff',
+                            100: '#e0f2fe',
+                            200: '#bae6fd',
+                            300: '#7dd3fc',
+                            400: '#38bdf8',
+                            500: '#0ea5e9',
+                            600: '#0284c7',
+                            700: '#0369a1',
+                            800: '#075985',
+                            900: '#0c4a6e',
+                        }
+                    }
+                }
+            }
+        }
+    </script>
+    <style>
+        /* Custom scrollbar */
+        ::-webkit-scrollbar { width: 6px; height: 6px; }
+        ::-webkit-scrollbar-track { background: transparent; }
+        ::-webkit-scrollbar-thumb { background: #475569; border-radius: 3px; }
+        ::-webkit-scrollbar-thumb:hover { background: #64748b; }
+        /* Markdown content styles */
+        .markdown-body {
+            line-height: 1.7;
+        }
+        .markdown-body h1 { font-size: 2rem; font-weight: 700; margin: 1.5rem 0 1rem; padding-bottom: 0.5rem; border-bottom: 1px solid #334155; }
+        .markdown-body h2 { font-size: 1.5rem; font-weight: 600; margin: 1.5rem 0 0.75rem; color: #38bdf8; }
+        .markdown-body h3 { font-size: 1.25rem; font-weight: 600; margin: 1.25rem 0 0.5rem; color: #94a3b8; }
+        .markdown-body h4 { font-size: 1.1rem; font-weight: 600; margin: 1rem 0 0.5rem; }
+        .markdown-body p { margin: 0.75rem 0; }
+        .markdown-body ul, .markdown-body ol { margin: 0.75rem 0; padding-left: 1.5rem; }
+        .markdown-body li { margin: 0.25rem 0; }
+        .markdown-body ul { list-style-type: disc; }
+        .markdown-body ol { list-style-type: decimal; }
+        .markdown-body code:not(pre code) {
+            background: #1e293b;
+            padding: 0.2rem 0.4rem;
+            border-radius: 4px;
+            font-size: 0.875rem;
+            color: #f472b6;
+        }
+        .markdown-body pre {
+            background: #0f172a;
+            padding: 1rem;
+            border-radius: 8px;
+            overflow-x: auto;
+            margin: 1rem 0;
+            border: 1px solid #1e293b;
+        }
+        .markdown-body pre code {
+            background: transparent;
+            padding: 0;
+            color: #e2e8f0;
+            font-size: 0.875rem;
+        }
+        .markdown-body table {
+            width: 100%;
+            border-collapse: collapse;
+            margin: 1rem 0;
+            font-size: 0.9rem;
+        }
+        .markdown-body th, .markdown-body td {
+            border: 1px solid #334155;
+            padding: 0.5rem 0.75rem;
+            text-align: left;
+        }
+        .markdown-body th {
+            background: #1e293b;
+            font-weight: 600;
+            color: #38bdf8;
+        }
+        .markdown-body tr:hover { background: #1e293b40; }
+        .markdown-body blockquote {
+            border-left: 4px solid #0ea5e9;
+            padding-left: 1rem;
+            margin: 1rem 0;
+            color: #94a3b8;
+            background: #1e293b40;
+            padding: 0.5rem 1rem;
+            border-radius: 0 8px 8px 0;
+        }
+        .markdown-body a { color: #38bdf8; text-decoration: none; }
+        .markdown-body a:hover { text-decoration: underline; }
+        .markdown-body hr { border: none; border-top: 1px solid #334155; margin: 2rem 0; }
+        /* Active nav item */
+        .nav-item.active { background: linear-gradient(90deg, #0ea5e920 0%, transparent 100%); border-left-color: #0ea5e9; }
+        /* Search highlight */
+        .search-highlight { background: #fbbf2440; color: #fbbf24; padding: 0 2px; border-radius: 2px; }
+        /* Smooth transitions */
+        .nav-item { transition: all 0.15s ease; }
+        /* Loading spinner */
+        @keyframes spin { to { transform: rotate(360deg); } }
+        .spinner { animation: spin 1s linear infinite; }
+    </style>
+</head>
+<body class="bg-slate-950 text-slate-200 min-h-screen">
+    <div class="flex h-screen overflow-hidden">
+        <!-- Sidebar -->
+        <aside id="sidebar" class="w-72 bg-slate-900 border-r border-slate-800 flex flex-col flex-shrink-0">
+            <!-- Header -->
+            <div class="p-4 border-b border-slate-800">
+                <div class="flex items-center gap-3">
+                    <div class="w-10 h-10 bg-gradient-to-br from-primary-500 to-primary-700 rounded-lg flex items-center justify-center">
+                        <i data-lucide="bot" class="w-6 h-6 text-white"></i>
+                    </div>
+                    <div>
+                        <h1 class="font-bold text-lg text-white">KhaBot CLI</h1>
+                        <p class="text-xs text-slate-500">Documentation</p>
+                    </div>
+                </div>
+            </div>
+            <!-- Search -->
+            <div class="p-3 border-b border-slate-800">
+                <div class="relative">
+                    <i data-lucide="search" class="w-4 h-4 absolute left-3 top-1/2 -translate-y-1/2 text-slate-500"></i>
+                    <input
+                        type="text"
+                        id="searchInput"
+                        placeholder="Search docs... (Ctrl+K)"
+                        class="w-full bg-slate-800 border border-slate-700 rounded-lg py-2 pl-10 pr-4 text-sm focus:outline-none focus:border-primary-500 focus:ring-1 focus:ring-primary-500 placeholder-slate-500"
+                    >
+                    <kbd class="absolute right-3 top-1/2 -translate-y-1/2 text-xs text-slate-500 bg-slate-700 px-1.5 py-0.5 rounded hidden sm:inline">⌘K</kbd>
+                </div>
+            </div>
+            <!-- Search Results -->
+            <div id="searchResults" class="hidden border-b border-slate-800 max-h-64 overflow-y-auto">
+                <div class="p-2 text-xs text-slate-500 font-medium px-4">Search Results</div>
+                <div id="searchResultsList" class="pb-2"></div>
+            </div>
+            <!-- Navigation -->
+            <nav id="navigation" class="flex-1 overflow-y-auto p-3">
+                <ul id="navList" class="space-y-1">
+                    <!-- Populated dynamically -->
+                </ul>
+            </nav>
+            <!-- Footer -->
+            <div class="p-4 border-t border-slate-800">
+                <div class="flex items-center justify-between text-xs text-slate-500">
+                    <span>v1.0.0</span>
+                    <a href="https://github.com" target="_blank" class="flex items-center gap-1 hover:text-slate-300">
+                        <i data-lucide="github" class="w-4 h-4"></i>
+                        GitHub
+                    </a>
+                </div>
+            </div>
+        </aside>
+        <!-- Main Content -->
+        <main class="flex-1 flex flex-col overflow-hidden">
+            <!-- Top Bar -->
+            <header class="bg-slate-900/50 backdrop-blur border-b border-slate-800 px-6 py-3 flex items-center justify-between flex-shrink-0">
+                <div class="flex items-center gap-4">
+                    <button id="sidebarToggle" class="lg:hidden p-2 hover:bg-slate-800 rounded-lg">
+                        <i data-lucide="menu" class="w-5 h-5"></i>
+                    </button>
+                    <nav id="breadcrumb" class="flex items-center gap-2 text-sm">
+                        <span class="text-slate-500">Docs</span>
+                        <i data-lucide="chevron-right" class="w-4 h-4 text-slate-600"></i>
+                        <span id="currentSection" class="text-slate-500">Guide</span>
+                        <i data-lucide="chevron-right" class="w-4 h-4 text-slate-600"></i>
+                        <span id="currentDoc" class="text-slate-300">README</span>
+                    </nav>
+                </div>
+                <div class="flex items-center gap-2">
+                    <button id="prevDoc" class="p-2 hover:bg-slate-800 rounded-lg disabled:opacity-30 disabled:cursor-not-allowed" title="Previous">
+                        <i data-lucide="chevron-left" class="w-5 h-5"></i>
+                    </button>
+                    <button id="nextDoc" class="p-2 hover:bg-slate-800 rounded-lg disabled:opacity-30 disabled:cursor-not-allowed" title="Next">
+                        <i data-lucide="chevron-right" class="w-5 h-5"></i>
+                    </button>
+                    <span class="w-px h-6 bg-slate-700 mx-2"></span>
+                    <button id="scrollTop" class="p-2 hover:bg-slate-800 rounded-lg" title="Scroll to top">
+                        <i data-lucide="arrow-up" class="w-5 h-5"></i>
+                    </button>
+                </div>
+            </header>
+            <!-- Content Area -->
+            <div id="contentWrapper" class="flex-1 overflow-y-auto">
+                <!-- Loading State -->
+                <div id="loading" class="flex items-center justify-center h-full">
+                    <div class="text-center">
+                        <i data-lucide="loader-2" class="w-8 h-8 text-primary-500 spinner mx-auto mb-4"></i>
+                        <p class="text-slate-500">Loading documentation...</p>
+                    </div>
+                </div>
+                <!-- Document Content -->
+                <article id="content" class="hidden max-w-4xl mx-auto px-6 py-8 markdown-body"></article>
+                <!-- Table of Contents (sticky on large screens) -->
+                <aside id="toc" class="hidden xl:block fixed right-8 top-24 w-56">
+                    <div class="bg-slate-900/80 backdrop-blur rounded-lg border border-slate-800 p-4">
+                        <h4 class="text-xs font-semibold text-slate-500 uppercase tracking-wider mb-3">On this page</h4>
+                        <ul id="tocList" class="space-y-2 text-sm max-h-[calc(100vh-12rem)] overflow-y-auto"></ul>
+                    </div>
+                </aside>
+            </div>
+        </main>
+    </div>
+    <script>
+        // State
+        let docs = [];
+        let currentDocIndex = 0;
+        let fuse = null;
+        let searchIndex = [];
+        // Documentation sections
+        const DOC_SECTIONS = [
+            {
+                label: 'Guide',
+                folder: 'guide/',
+                files: [
+                    'README.md',
+                    '01-quickstart.md',
+                    '02-folder-structure.md',
+                    '03-configuration.md',
+                    '04-agents.md',
+                    '05-cli.md',
+                    '06-tools.md',
+                    '07-permissions.md',
+                    '08-memory.md',
+                    '09-multi-agent.md',
+                    '10-daemons.md',
+                ]
+            },
+            {
+                label: 'API Reference',
+                folder: 'api/',
+                files: [
+                    'README.md',
+                    '01-system.md',
+                    '02-agents.md',
+                    '03-chat.md',
+                    '04-tasks.md',
+                    '05-sessions.md',
+                    '06-daemons.md',
+                    '07-memory.md',
+                    '08-settings.md',
+                    '09-models.md',
+                    '09-websocket.md',
+                    '10-completions.md',
+                ]
+            }
+        ];
+        // DOM elements
+        const navList = document.getElementById('navList');
+        const content = document.getElementById('content');
+        const loading = document.getElementById('loading');
+        const searchInput = document.getElementById('searchInput');
+        const searchResults = document.getElementById('searchResults');
+        const searchResultsList = document.getElementById('searchResultsList');
+        const currentDocEl = document.getElementById('currentDoc');
+        const tocList = document.getElementById('tocList');
+        const prevBtn = document.getElementById('prevDoc');
+        const nextBtn = document.getElementById('nextDoc');
+        // Initialize
+        async function init() {
+            lucide.createIcons();
+            await loadAllDocs();
+            setupSearch();
+            setupKeyboardShortcuts();
+            setupNavigation();
+            // Load first doc or from hash
+            const hash = window.location.hash.slice(1);
+            const docIndex = docs.findIndex(d => d.slug === hash);
+            loadDoc(docIndex >= 0 ? docIndex : 0);
+        }
+        // Load all markdown files
+        async function loadAllDocs() {
+            const allDocs = [];
+            for (const section of DOC_SECTIONS) {
+                const promises = section.files.map(async (file) => {
+                    try {
+                        const response = await fetch(section.folder + file);
+                        if (!response.ok) return null;
+                        const text = await response.text();
+                        const title = extractTitle(text, file);
+                        const prefix = section.folder.replace('/', '');
+                        const slug = prefix + '/' + file.replace('.md', '').toLowerCase();
+                        return { file, section: section.label, folder: section.folder, title, slug, content: text };
+                    } catch (e) {
+                        console.warn(`Failed to load ${section.folder + file}:`, e);
+                        return null;
+                    }
+                });
+                const sectionDocs = (await Promise.all(promises)).filter(Boolean);
+                allDocs.push(...sectionDocs);
+            }
+            docs = allDocs;
+            renderNavigation();
+        }
+        // Extract title from markdown content
+        function extractTitle(content, filename) {
+            const match = content.match(/^#\s+(.+)$/m);
+            if (match) return match[1];
+            // Fallback: format filename
+            return filename.replace('.md', '').replace(/^\d+-/, '').replace(/-/g, ' ')
+                .replace(/\b\w/g, c => c.toUpperCase());
+        }
+        // Render sidebar navigation
+        function renderNavigation() {
+            // Group docs by section in order
+            const sections = {};
+            const sectionOrder = [];
+            docs.forEach((doc, index) => {
+                if (!sections[doc.section]) {
+                    sections[doc.section] = [];
+                    sectionOrder.push(doc.section);
+                }
+                sections[doc.section].push({ doc, index });
+            });
+            navList.innerHTML = sectionOrder.map(sectionName => {
+                const items = sections[sectionName];
+                return `
+                    <li class="mt-4 first:mt-0">
+                        <div class="text-xs font-semibold text-slate-500 uppercase tracking-wider mb-1 px-3">${sectionName}</div>
+                        <ul class="space-y-1">
+                            ${items.map(({ doc, index }) => {
+                                const icon = getDocIcon(doc.slug);
+                                return `
+                                    <li>
+                                        <button
+                                            onclick="loadDoc(${index})"
+                                            class="nav-item w-full flex items-center gap-3 px-3 py-2 text-sm text-slate-400 hover:text-slate-200 hover:bg-slate-800/50 rounded-lg border-l-2 border-transparent"
+                                            data-index="${index}"
+                                        >
+                                            <i data-lucide="${icon}" class="w-4 h-4 flex-shrink-0"></i>
+                                            <span class="truncate">${doc.title}</span>
+                                        </button>
+                                    </li>
+                                `;
+                            }).join('')}
+                        </ul>
+                    </li>
+                `;
+            }).join('');
+            lucide.createIcons();
+        }
+        // Get icon for doc type
+        function getDocIcon(slug) {
+            const icons = {
+                // Guide
+                'guide/readme':              'book-open',
+                'guide/01-quickstart':       'zap',
+                'guide/02-folder-structure': 'folder-tree',
+                'guide/03-configuration':    'sliders',
+                'guide/04-agents':           'bot',
+                'guide/05-cli':              'terminal',
+                'guide/06-tools':            'wrench',
+                'guide/07-permissions':      'shield',
+                'guide/08-memory':           'brain',
+                'guide/09-multi-agent':      'network',
+                'guide/10-daemons':          'clock',
+                // API Reference
+                'api/readme':                'book-open',
+                'api/01-system':             'server',
+                'api/02-agents':             'bot',
+                'api/03-chat':               'message-circle',
+                'api/04-tasks':              'list-checks',
+                'api/05-sessions':           'users',
+                'api/06-daemons':            'activity',
+                'api/07-memory':             'database',
+                'api/08-settings':           'settings',
+                'api/09-models':             'cpu',
+                'api/09-websocket':          'plug',
+                'api/10-completions':        'sparkles',
+            };
+            return icons[slug] || 'file-text';
+        }
+        // Load and render a document
+        function loadDoc(index) {
+            if (index < 0 || index >= docs.length) return;
+            currentDocIndex = index;
+            const doc = docs[index];
+            // Update URL hash
+            window.location.hash = doc.slug;
+            // Update breadcrumb
+            const sectionEl = document.getElementById('currentSection');
+            if (sectionEl) sectionEl.textContent = doc.section;
+            currentDocEl.textContent = doc.title;
+            // Configure marked with highlight extension
+            const markedInstance = new marked.Marked(
+                markedHighlight.markedHighlight({
+                    langPrefix: 'hljs language-',
+                    highlight(code, lang) {
+                        const language = hljs.getLanguage(lang) ? lang : 'plaintext';
+                        return hljs.highlight(code, { language }).value;
+                    }
+                })
+            );
+            markedInstance.setOptions({ breaks: false, gfm: true });
+            // Render markdown
+            content.innerHTML = markedInstance.parse(doc.content);
+            // Show content
+            loading.classList.add('hidden');
+            content.classList.remove('hidden');
+            // Update active nav item
+            document.querySelectorAll('.nav-item').forEach((item, i) => {
+                item.classList.toggle('active', i === index);
+                item.classList.toggle('text-primary-400', i === index);
+                item.classList.toggle('text-slate-400', i !== index);
+            });
+            // Update prev/next buttons
+            prevBtn.disabled = index === 0;
+            nextBtn.disabled = index === docs.length - 1;
+            // Generate TOC
+            generateTOC();
+            // Scroll to top
+            document.getElementById('contentWrapper').scrollTop = 0;
+        }
+        // Generate table of contents
+        function generateTOC() {
+            const headings = content.querySelectorAll('h2, h3');
+            if (headings.length === 0) {
+                document.getElementById('toc').classList.add('hidden');
+                return;
+            }
+            document.getElementById('toc').classList.remove('hidden');
+            tocList.innerHTML = Array.from(headings).map(h => {
+                const id = h.textContent.toLowerCase().replace(/[^\w]+/g, '-');
+                h.id = id;
+                const isH3 = h.tagName === 'H3';
+                return `
+                    <li>
+                        <a href="#${id}" class="block text-slate-400 hover:text-slate-200 truncate ${isH3 ? 'pl-3 text-xs' : ''}">${h.textContent}</a>
+                    </li>
+                `;
+            }).join('');
+        }
+        // Setup search
+        function setupSearch() {
+            // Build search index
+            searchIndex = docs.flatMap(doc => {
+                const sections = doc.content.split(/^##\s+/m).slice(1);
+                return [
+                    { doc: doc.slug, title: doc.title, content: doc.content.slice(0, 500), type: 'doc' },
+                    ...sections.map(section => {
+                        const lines = section.split('\n');
+                        const sectionTitle = lines[0];
+                        const sectionContent = lines.slice(1).join('\n').slice(0, 300);
+                        return {
+                            doc: doc.slug,
+                            docTitle: doc.title,
+                            title: sectionTitle,
+                            content: sectionContent,
+                            type: 'section'
+                        };
+                    })
+                ];
+            });
+            fuse = new Fuse(searchIndex, {
+                keys: ['title', 'content'],
+                threshold: 0.3,
+                includeMatches: true,
+                minMatchCharLength: 2
+            });
+            // Search input handler
+            let debounceTimer;
+            searchInput.addEventListener('input', (e) => {
+                clearTimeout(debounceTimer);
+                debounceTimer = setTimeout(() => performSearch(e.target.value), 150);
+            });
+        }
+        // Perform search
+        function performSearch(query) {
+            if (query.length < 2) {
+                searchResults.classList.add('hidden');
+                return;
+            }
+            const results = fuse.search(query).slice(0, 10);
+            if (results.length === 0) {
+                searchResultsList.innerHTML = `
+                    <div class="px-4 py-3 text-sm text-slate-500">No results found</div>
+                `;
+            } else {
+                searchResultsList.innerHTML = results.map(({ item }) => {
+                    const docIndex = docs.findIndex(d => d.slug === item.doc);
+                    const icon = item.type === 'doc' ? 'file-text' : 'hash';
+                    const subtitle = item.type === 'section' ? item.docTitle : '';
+                    return `
+                        <button
+                            onclick="loadDoc(${docIndex}); searchInput.value=''; searchResults.classList.add('hidden');"
+                            class="w-full flex items-start gap-3 px-4 py-2 hover:bg-slate-800 text-left"
+                        >
+                            <i data-lucide="${icon}" class="w-4 h-4 text-slate-500 mt-0.5 flex-shrink-0"></i>
+                            <div class="min-w-0">
+                                <div class="text-sm text-slate-200 truncate">${item.title}</div>
+                                ${subtitle ? `<div class="text-xs text-slate-500 truncate">${subtitle}</div>` : ''}
+                            </div>
+                        </button>
+                    `;
+                }).join('');
+            }
+            searchResults.classList.remove('hidden');
+            lucide.createIcons();
+        }
+        // Keyboard shortcuts
+        function setupKeyboardShortcuts() {
+            document.addEventListener('keydown', (e) => {
+                // Ctrl/Cmd + K for search
+                if ((e.ctrlKey || e.metaKey) && e.key === 'k') {
+                    e.preventDefault();
+                    searchInput.focus();
+                }
+                // Escape to close search
+                if (e.key === 'Escape') {
+                    searchInput.blur();
+                    searchInput.value = '';
+                    searchResults.classList.add('hidden');
+                }
+                // Arrow keys for navigation (when not in input)
+                if (document.activeElement !== searchInput) {
+                    if (e.key === 'ArrowLeft' && !prevBtn.disabled) {
+                        loadDoc(currentDocIndex - 1);
+                    } else if (e.key === 'ArrowRight' && !nextBtn.disabled) {
+                        loadDoc(currentDocIndex + 1);
+                    }
+                }
+            });
+        }
+        // Navigation buttons
+        function setupNavigation() {
+            prevBtn.addEventListener('click', () => loadDoc(currentDocIndex - 1));
+            nextBtn.addEventListener('click', () => loadDoc(currentDocIndex + 1));
+            document.getElementById('scrollTop').addEventListener('click', () => {
+                document.getElementById('contentWrapper').scrollTop = 0;
+            });
+            // Handle hash change
+            window.addEventListener('hashchange', () => {
+                const hash = window.location.hash.slice(1);
+                const docIndex = docs.findIndex(d => d.slug === hash);
+                if (docIndex >= 0 && docIndex !== currentDocIndex) {
+                    loadDoc(docIndex);
+                }
+            });
+        }
+        // Start
+        init();
+    </script>
+</body>
+</html>