k0ntext 3.6.0 → 3.8.0

package/dist/utils/chunking.js

@@ -0,0 +1,133 @@
+/**
+ * Text Chunking Utility
+ *
+ * Splits large texts into chunks suitable for embedding generation.
+ * Handles token limits, word boundaries, and overlap for context preservation.
+ */
+/**
+ * Estimate token count for text.
+ *
+ * Uses a simple heuristic: ~4 characters per token for English text.
+ * This is approximate but works well for our use case.
+ *
+ * @param text - Text to estimate tokens for
+ * @returns Estimated token count
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    // Remove whitespace for more accurate estimate
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return 0;
+    // Rough estimate: 1 token per 4 characters for English text
+    // This is a simplification but works well for most cases
+    return Math.ceil(trimmed.length / 4);
+}
+/**
+ * Split text into chunks that fit within max tokens.
+ *
+ * Tries to break at word boundaries when possible.
+ * Adds overlap between chunks to preserve context.
+ *
+ * @param text - Text to chunk
+ * @param maxTokens - Maximum tokens per chunk (default: 8000 for OpenRouter)
+ * @param overlapTokens - Number of tokens to overlap between chunks (default: 0)
+ * @returns Array of text chunks
+ */
+export function chunkText(text, maxTokens = 8000, overlapTokens = 0) {
+    // Handle empty or very short text
+    if (!text || text.trim().length === 0) {
+        return [''];
+    }
+    const trimmedText = text.trim();
+    const estimatedTokens = estimateTokens(trimmedText);
+    // If text is under the limit, return as-is
+    if (estimatedTokens <= maxTokens) {
+        return [trimmedText];
+    }
+    const chunks = [];
+    const maxChars = maxTokens * 4; // Convert tokens to approximate characters
+    const overlapChars = overlapTokens * 4;
+    let startIndex = 0;
+    let previousEndIndex = 0;
+    let loopCount = 0;
+    const maxLoops = 1000; // Safety limit to prevent infinite loops
+    while (startIndex < trimmedText.length && loopCount < maxLoops) {
+        loopCount++;
+        // Calculate end index for this chunk
+        let endIndex = Math.min(startIndex + maxChars, trimmedText.length);
+        // If not the last chunk, try to break at a word boundary
+        if (endIndex < trimmedText.length) {
+            // Look for word boundary near the end
+            const boundaryChars = 200; // Look back up to 200 chars
+            const searchStart = Math.max(startIndex, endIndex - boundaryChars);
+            const substring = trimmedText.slice(searchStart, endIndex);
+            // Try to find line break first, then space, then punctuation
+            let breakIndex = -1;
+            // Look for last newline in the window
+            const lastNewline = substring.lastIndexOf('\n');
+            if (lastNewline !== -1) {
+                breakIndex = searchStart + lastNewline + 1;
+            }
+            else {
+                // Look for last space in the window
+                const lastSpace = substring.lastIndexOf(' ');
+                if (lastSpace !== -1) {
+                    breakIndex = searchStart + lastSpace + 1;
+                }
+                else {
+                    // Look for sentence-ending punctuation
+                    for (let i = substring.length - 1; i >= Math.max(0, substring.length - 100); i--) {
+                        const char = substring[i];
+                        if (char === '.' || char === '!' || char === '?') {
+                            // Make sure it's actually a sentence end (followed by space or end)
+                            const nextChar = substring[i + 1];
+                            if (!nextChar || nextChar === ' ' || nextChar === '\n') {
+                                breakIndex = searchStart + i + 1;
+                                break;
+                            }
+                        }
+                    }
+                }
+            }
+            // Use the break index if found, otherwise use the calculated end
+            if (breakIndex > startIndex) {
+                endIndex = breakIndex;
+            }
+        }
+        // Extract the chunk
+        const chunk = trimmedText.slice(startIndex, endIndex);
+        chunks.push(chunk);
+        // Move to next chunk, accounting for overlap
+        if (overlapChars > 0 && endIndex < trimmedText.length) {
+            // Only apply overlap if not at the end
+            startIndex = Math.max(endIndex - overlapChars, endIndex - maxChars / 2);
+            // Ensure we make progress
+            if (startIndex <= previousEndIndex) {
+                startIndex = endIndex;
+            }
+            // Also ensure we move forward at least a bit
+            if (startIndex >= endIndex) {
+                startIndex = endIndex;
+            }
+        }
+        else {
+            startIndex = endIndex;
+        }
+        previousEndIndex = endIndex;
+    }
+    return chunks;
+}
+/**
+ * Chunk text specifically for embedding generation.
+ *
+ * Uses 8000 token limit (OpenRouter's limit for text-embedding-3-small).
+ *
+ * @param text - Text to chunk
+ * @returns Array of text chunks suitable for embeddings
+ */
+export function chunkForEmbedding(text) {
+    return chunkText(text, 8000, 100); // 100 token overlap for context
+}
+//# sourceMappingURL=chunking.js.map

package/dist/utils/chunking.js.map

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

package/dist/utils/encoding.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Encoding Utilities
+ *
+ * Handles text encoding issues across different platforms.
+ */
+/**
+ * Strip UTF-8 BOM (Byte Order Mark) from a string.
+ *
+ * The UTF-8 BOM is the byte sequence EF BB BF (U+FEFF).
+ * Some Windows editors add this to the start of files,
+ * which can break environment variable parsing.
+ *
+ * @param str - String that may contain a BOM
+ * @returns String with BOM removed if present
+ */
+export declare function stripBOM(str: string): string;
+/**
+ * Detect if a string has a UTF-8 BOM.
+ *
+ * @param str - String to check
+ * @returns true if BOM is present
+ */
+export declare function hasBOM(str: string): boolean;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/utils/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/utils/encoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C"}

package/dist/utils/encoding.js

@@ -0,0 +1,32 @@
+/**
+ * Encoding Utilities
+ *
+ * Handles text encoding issues across different platforms.
+ */
+/**
+ * Strip UTF-8 BOM (Byte Order Mark) from a string.
+ *
+ * The UTF-8 BOM is the byte sequence EF BB BF (U+FEFF).
+ * Some Windows editors add this to the start of files,
+ * which can break environment variable parsing.
+ *
+ * @param str - String that may contain a BOM
+ * @returns String with BOM removed if present
+ */
+export function stripBOM(str) {
+    // Check for BOM at position 0
+    if (str.charCodeAt(0) === 0xFEFF) {
+        return str.slice(1);
+    }
+    return str;
+}
+/**
+ * Detect if a string has a UTF-8 BOM.
+ *
+ * @param str - String to check
+ * @returns true if BOM is present
+ */
+export function hasBOM(str) {
+    return str.charCodeAt(0) === 0xFEFF;
+}
+//# sourceMappingURL=encoding.js.map

package/dist/utils/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/utils/encoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,8BAA8B;IAC9B,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;AACtC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared Utilities Module
+ *
+ * Exports all shared utility functions.
+ */
+export * from './encoding.js';
+export * from './chunking.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Shared Utilities Module
+ *
+ * Exports all shared utility functions.
+ */
+export * from './encoding.js';
+export * from './chunking.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/docs/QUICKSTART.md

@@ -81,7 +81,7 @@ your-project/
 ## Next Steps
 
 1. **Configure Claude Desktop with MCP** → [MCP Quick Start](MCP_QUICKSTART.md)
-2. **Learn about cross-tool sync** → [Migration Guide](MIGRATE_TO_UNIFIED.md)
+2. **Learn about cross-tool sync** → [Migration Guide](ARCHIVE/MIGRATE_TO_UNIFIED.md)
 3. **Troubleshoot issues** → [Troubleshooting](TROUBLESHOOTING.md)
 
 ## How It Works

package/docs/TROUBLESHOOTING.md

@@ -1,6 +1,6 @@
 # Troubleshooting Guide
 
-Common issues and solutions for Claude Context Engineering.
+Common issues and solutions for K0ntext (v3.8.0).
 
 ---
 
@@ -9,17 +9,14 @@ Common issues and solutions for Claude Context Engineering.
 Run diagnostics to automatically detect issues:
 
 ```bash
-# Using the unified package
+# Check database and indexing status
 k0ntext stats
 
-# Or using the legacy tools (deprecated)
-npx .k0ntext/tools/bin/claude-context.js diagnose
-```
-
-To attempt auto-fix:
+# Validate context files
+k0ntext validate
 
-```bash
-npx .k0ntext/tools/bin/claude-context.js diagnose --fix
+# Check for documentation drift
+k0ntext drift-detect
 ```
 
 ---
@@ -41,12 +38,12 @@ npx .k0ntext/tools/bin/claude-context.js diagnose --fix
 ### TSG-001: CLI Tools Won't Install
 
 **Symptoms:**
-- `npm install` fails in `.k0ntext/tools/`
+- `npm install -g k0ntext` fails
 - Missing dependencies errors
 
 **Diagnosis:**
 ```bash
-node --version  # Should be 16+
+node --version  # Should be 18+
 npm --version   # Should be 8+
 ```
 
@@ -62,13 +59,10 @@ nvm use 18
 **B. Clear npm cache**
 ```bash
 npm cache clean --force
-cd .k0ntext/tools && rm -rf node_modules && npm install
+npm install -g k0ntext
 ```
 
-**C. Use yarn instead**
-```bash
-cd .k0ntext/tools && yarn install
-```
+**C. Windows users** - Use Node.js LTS (v18, v20, v22) for pre-built SQLite binaries. Non-LTS versions may require Visual Studio Build Tools.
 
 ---
 
@@ -76,20 +70,18 @@ cd .k0ntext/tools && yarn install
 
 **Symptoms:**
 - "AI_CONTEXT.md not found" errors
-- Missing `.k0ntext/` directory
+- Missing `.claude/` directory
 
 **Solutions:**
 
-**A. Verify copy was complete**
+**A. Re-initialize project**
 ```bash
-ls -la .k0ntext/
-# Should contain: agents/, commands/, context/, indexes/, settings.json, README.md
+k0ntext init
 ```
 
-**B. Re-copy from template**
+**B. Sync templates manually**
 ```bash
-cp -r /path/to/template/.claude ./.claude
-cp /path/to/template/AI_CONTEXT.md ./AI_CONTEXT.md
+k0ntext sync-templates
 ```
 
 ---
@@ -181,7 +173,7 @@ The agent should merge related workflows. If not:
 
 **A. Resume initialization**
 ```bash
-npx .k0ntext/tools/bin/claude-context.js init --resume
+k0ntext init
 # Or in Claude Code:
 @context-engineer "Resume initialization"
 ```
@@ -189,7 +181,7 @@ npx .k0ntext/tools/bin/claude-context.js init --resume
 **B. Start fresh**
 ```bash
 rm .k0ntext/INIT_PROGRESS.json
-@context-engineer "Initialize context engineering for this repository"
+k0ntext init
 ```
 
 ---
@@ -261,18 +253,18 @@ Search for the specific function: [function name] in [file pattern]
 
 **Diagnosis:**
 ```bash
-npx .k0ntext/tools/bin/claude-context.js validate --schema
+k0ntext validate --strict
 ```
 
 **Solutions:**
 
-**A. Auto-fix with defaults**
+**A. Auto-fix with validation**
 ```bash
-npx .k0ntext/tools/bin/claude-context.js diagnose --fix
+k0ntext validate --fix
 ```
 
 **B. Manual fix**
-Compare your `settings.json` with the schema in `.k0ntext/schemas/settings.schema.json`.
+Compare your `settings.json` with the schema in `.claude/schemas/settings.schema.json`.
 
 ---
 
@@ -284,7 +276,7 @@ Compare your `settings.json` with the schema in `.k0ntext/schemas/settings.schem
 
 **Diagnosis:**
 ```bash
-npx .k0ntext/tools/bin/claude-context.js validate --links
+k0ntext validate
 ```
 
 **Solutions:**
@@ -293,7 +285,7 @@ npx .k0ntext/tools/bin/claude-context.js validate --links
 After refactoring, update documentation:
 ```bash
 # Find all references to old path
-grep -r "old/path" .k0ntext/
+grep -r "old/path" .claude/
 # Update to new path
 ```
 
@@ -312,7 +304,7 @@ grep -r "old/path" .k0ntext/
 
 **Diagnosis:**
 ```bash
-npx .k0ntext/tools/bin/claude-context.js validate --lines --threshold 60
+k0ntext validate
 ```
 
 **Solutions:**
@@ -340,7 +332,7 @@ Line numbers within ±10 lines are acceptable. Focus on function names as anchor
 
 **Diagnosis:**
 ```bash
-npx .k0ntext/tools/bin/claude-context.js validate --placeholders
+k0ntext validate
 ```
 
 **Solutions:**
@@ -367,7 +359,7 @@ Search and replace remaining placeholders in AI_CONTEXT.md with actual values.
 
 **A. Check agent exists**
 ```bash
-ls .k0ntext/agents/
+ls .claude/agents/
 ```
 
 **B. Use correct invocation**
@@ -391,7 +383,7 @@ ls .k0ntext/agents/
 
 **A. Check command exists**
 ```bash
-ls .k0ntext/commands/
+ls .claude/commands/
 ```
 
 **B. Verify command is registered**
@@ -420,12 +412,9 @@ Check `settings.json` includes the command:
 @context-engineer "Initialize focusing on src/ directory only"
 ```
 
-**B. Increase timeout**
-Edit `settings.json`:
-```json
-"rpi_workflow": {
-  "research_timeout_minutes": 60
-}
+**B. Skip intelligent analysis**
+```bash
+k0ntext init --no-intelligent
 ```
 
 ---
@@ -438,13 +427,9 @@ Edit `settings.json`:
 
 **Solutions:**
 
-**A. Validate specific checks only**
+**A. Use quick validation**
 ```bash
-# Just schema
-npx .k0ntext/tools/bin/claude-context.js validate --schema
-
-# Just structure
-npx .k0ntext/tools/bin/claude-context.js validate --structure
+k0ntext validate
 ```
 
 **B. Skip external link checking**
@@ -462,19 +447,20 @@ Ensure this is disabled (default):
 ### TSG-060: MCP Server Won't Start
 
 **Symptoms:**
-- `mcp:start` exits immediately
+- `k0ntext mcp` exits immediately
 - "Database not found" or "Missing OPENROUTER_API_KEY"
 
 **Diagnosis:**
 ```bash
-npx k0ntext mcp:status
+k0ntext stats
 ```
 
 **Solutions:**
 
 **A. Initialize the database first**
 ```bash
-npx k0ntext mcp:init
+k0ntext init
+k0ntext index
 ```
 
 **B. Set the OpenRouter API key**
@@ -482,9 +468,9 @@ npx k0ntext mcp:init
 export OPENROUTER_API_KEY="your-api-key-here"
 ```
 
-**C. Start the server again**
+**C. Start the server**
 ```bash
-npx k0ntext mcp:start
+k0ntext mcp
 ```
 
 ---
@@ -492,25 +478,21 @@ npx k0ntext mcp:start
 ### TSG-061: MCP Sync Exports Missing
 
 **Symptoms:**
-- `mcp:sync` finishes without generating files
+- Sync finishes without generating files
 - Output files remain unchanged
 
-**Diagnosis:**
-```bash
-npx k0ntext mcp:sync --status
-```
-
 **Solutions:**
 
-**A. Force overwrite managed files**
+**A. Force sync**
 ```bash
-npx k0ntext mcp:sync --force
+k0ntext sync --force
 ```
 
 **B. Recreate database index**
 ```bash
 rm -f .k0ntext.db
-npx k0ntext mcp:init
+k0ntext init
+k0ntext index
 ```
 
 **C. Ensure database exists**
@@ -520,8 +502,6 @@ ls -la .k0ntext.db
 
 ---
 
-## New Error Codes (v3.0.0)
-
 ### TSG-062: Generate Command Failed
 
 **Error:** `Failed to generate context files`
@@ -566,19 +546,18 @@ k0ntext sync --from claude
 
 ---
 
-### TSG-064: MCP Server Not Starting
+### TSG-064: MCP Server Build Issues
 
 **Error:** `MCP server failed to start`
 
 **Diagnosis:**
-1. Verify build: `cd packages/ai-context && npm run build`
-2. Check port availability
+1. Verify build: `npm run build`
+2. Check that database file exists
 3. Verify OpenRouter API key
 
 **Solution:**
 ```bash
 # Rebuild
-cd packages/ai-context
 npm run build
 
 # Test MCP server
@@ -591,21 +570,17 @@ npm run start:mcp
 
 If your issue isn't listed:
 
-1. **Run full diagnostics:**
-   ```bash
-   npx .k0ntext/tools/bin/claude-context.js diagnose --verbose
-   ```
-
-2. **Check logs:**
+1. **Run diagnostics:**
    ```bash
-   cat .k0ntext/logs/claude.log
+   k0ntext stats
+   k0ntext validate -v
    ```
 
-3. **Report an issue:**
+2. **Report an issue:**
    https://github.com/SireJeff/k0ntext/issues
 
 Include:
 - Error message
-- Diagnostic output
+- Diagnostic output (`k0ntext stats`)
 - Tech stack
 - Steps to reproduce