@cdoing/core 0.1.0

package/dist/context-providers/codebase.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Codebase Context Provider — @codebase
+ *
+ * Semantic search across the entire repository.
+ * Finds the most relevant files/code for a given query.
+ *
+ * How it works:
+ *   1. User types @codebase followed by a search query
+ *   2. We search file names and content using glob + grep
+ *   3. Rank results by relevance (filename match > content match)
+ *   4. Return the top N most relevant code snippets
+ *
+ * Learning note: This is a text-based search approach (not embedding-based).
+ * For true semantic search, you'd want vector embeddings + a vector DB.
+ * But text search with smart ranking gets you 80% of the way there
+ * and works offline without any setup.
+ *
+ * Future enhancement: Add optional embedding-based indexing for
+ * projects that configure it.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodebaseContextProvider = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+/** Max files to include in results */
+const MAX_RESULTS = 10;
+/** Max chars per file snippet */
+const SNIPPET_LIMIT = 2000;
+/** Total max chars for all results */
+const TOTAL_LIMIT = 20000;
+/** File extensions to search (common code files) */
+const CODE_EXTENSIONS = new Set([
+    ".ts", ".tsx", ".js", ".jsx", ".py", ".rs", ".go", ".java",
+    ".rb", ".php", ".cs", ".cpp", ".c", ".h", ".hpp", ".swift",
+    ".kt", ".scala", ".r", ".html", ".css", ".scss", ".less",
+    ".json", ".yaml", ".yml", ".toml", ".xml", ".sql", ".sh",
+    ".bash", ".zsh", ".md", ".mdx", ".txt", ".vue", ".svelte",
+]);
+/** Directories to skip during search */
+const SKIP_DIRS = new Set([
+    "node_modules", ".git", "dist", "build", ".next", ".nuxt",
+    "__pycache__", ".cache", ".turbo", "coverage", "venv",
+    ".venv", ".tox", "target", "vendor",
+]);
+class CodebaseContextProvider {
+    id = "codebase";
+    trigger = "@codebase";
+    description = "Search the entire codebase for relevant code";
+    requiresArg = true;
+    async resolve(arg, options) {
+        const query = arg?.trim();
+        if (!query) {
+            return {
+                label: "Codebase Search",
+                content: "[Please provide a search query after @codebase, e.g.: @codebase authentication flow]",
+                metadata: { source: "codebase" },
+            };
+        }
+        const workingDir = options?.workingDir || process.cwd();
+        // Search using ripgrep if available, fall back to simple search
+        const results = await this.search(query, workingDir);
+        if (results.length === 0) {
+            return {
+                label: `Codebase: "${query}"`,
+                content: `[No results found for "${query}" in the codebase.]`,
+                metadata: { source: "codebase", itemCount: 0 },
+            };
+        }
+        // Format results with code snippets
+        const sections = [];
+        let totalChars = 0;
+        for (const result of results.slice(0, MAX_RESULTS)) {
+            if (totalChars >= TOTAL_LIMIT) {
+                sections.push(`\n... [more results omitted]`);
+                break;
+            }
+            const relPath = path.relative(workingDir, result.file);
+            const ext = path.extname(result.file).slice(1);
+            const lang = ext || "text";
+            let snippet = result.snippet;
+            if (snippet.length > SNIPPET_LIMIT) {
+                snippet = snippet.substring(0, SNIPPET_LIMIT) + "\n... [truncated]";
+            }
+            sections.push(`### ${relPath}${result.line ? `:${result.line}` : ""}\n\n\`\`\`${lang}\n${snippet}\n\`\`\``);
+            totalChars += snippet.length;
+        }
+        return {
+            label: `Codebase: "${query}" (${results.length} results)`,
+            content: `## Codebase Search: "${query}"\n\n${sections.join("\n\n")}`,
+            metadata: {
+                source: "codebase",
+                itemCount: results.length,
+                truncated: results.length > MAX_RESULTS,
+            },
+        };
+    }
+    /**
+     * Search the codebase for a query string.
+     * Uses ripgrep (rg) if available for fast searching,
+     * otherwise falls back to a simple Node.js file walker.
+     */
+    async search(query, workingDir) {
+        // Try ripgrep first (much faster for large codebases)
+        try {
+            return this.searchWithRipgrep(query, workingDir);
+        }
+        catch {
+            // Fall back to simple search
+            return this.searchSimple(query, workingDir);
+        }
+    }
+    /**
+     * Fast search using ripgrep (rg).
+     * Learning note: ripgrep respects .gitignore by default,
+     * which is exactly what we want.
+     */
+    searchWithRipgrep(query, workingDir) {
+        // Use ripgrep with context lines around matches
+        const escapedQuery = query.replace(/['"\\]/g, "\\$&");
+        const output = (0, child_process_1.execSync)(`rg --ignore-case --max-count=3 --context=3 --with-filename --line-number "${escapedQuery}" .`, {
+            cwd: workingDir,
+            encoding: "utf-8",
+            timeout: 10000,
+            maxBuffer: 5 * 1024 * 1024,
+        });
+        // Parse ripgrep output into structured results
+        const results = new Map();
+        const lines = output.split("\n");
+        let currentFile = "";
+        let currentSnippet = "";
+        let currentLine;
+        for (const line of lines) {
+            // ripgrep format: "file:line:content" or "file-line-content" (context)
+            const match = line.match(/^(.+?)[:-](\d+)[:-](.*)$/);
+            if (match) {
+                const [, file, lineNum, content] = match;
+                const absFile = path.resolve(workingDir, file);
+                if (file !== currentFile) {
+                    // Save previous file's results
+                    if (currentFile && currentSnippet) {
+                        const existing = results.get(currentFile);
+                        if (!existing || currentSnippet.length > existing.snippet.length) {
+                            results.set(currentFile, {
+                                file: path.resolve(workingDir, currentFile),
+                                line: currentLine,
+                                snippet: currentSnippet.trim(),
+                                score: 1,
+                            });
+                        }
+                    }
+                    currentFile = file;
+                    currentSnippet = "";
+                    currentLine = parseInt(lineNum, 10);
+                }
+                currentSnippet += content + "\n";
+            }
+            else if (line === "--") {
+                // Separator between matches in the same file
+                currentSnippet += "...\n";
+            }
+        }
+        // Don't forget the last file
+        if (currentFile && currentSnippet) {
+            results.set(currentFile, {
+                file: path.resolve(workingDir, currentFile),
+                line: currentLine,
+                snippet: currentSnippet.trim(),
+                score: 1,
+            });
+        }
+        return Array.from(results.values());
+    }
+    /**
+     * Simple fallback search using Node.js file system.
+     * Slower but works everywhere without external dependencies.
+     */
+    searchSimple(query, workingDir) {
+        const results = [];
+        const queryLower = query.toLowerCase();
+        // Walk directory tree
+        const walk = (dir, depth) => {
+            if (depth > 5 || results.length >= MAX_RESULTS * 2)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                if (entry.name.startsWith(".") && entry.name !== ".cdoing")
+                    continue;
+                if (SKIP_DIRS.has(entry.name))
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(fullPath, depth + 1);
+                }
+                else if (entry.isFile()) {
+                    const ext = path.extname(entry.name);
+                    if (!CODE_EXTENSIONS.has(ext))
+                        continue;
+                    try {
+                        const content = fs.readFileSync(fullPath, "utf-8");
+                        const contentLower = content.toLowerCase();
+                        // Check if query appears in content
+                        const index = contentLower.indexOf(queryLower);
+                        if (index >= 0) {
+                            // Extract a snippet around the match
+                            const linesBefore = content.substring(0, index).split("\n");
+                            const lineNum = linesBefore.length;
+                            const allLines = content.split("\n");
+                            const start = Math.max(0, lineNum - 4);
+                            const end = Math.min(allLines.length, lineNum + 4);
+                            const snippet = allLines.slice(start, end).join("\n");
+                            // Score based on match quality
+                            let score = 1;
+                            if (entry.name.toLowerCase().includes(queryLower))
+                                score += 5; // Filename match
+                            if (content.toLowerCase().split(queryLower).length > 2)
+                                score += 2; // Multiple matches
+                            results.push({ file: fullPath, line: lineNum, snippet, score });
+                        }
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+        };
+        walk(workingDir, 0);
+        // Sort by score (highest first) and return top results
+        return results.sort((a, b) => b.score - a.score).slice(0, MAX_RESULTS);
+    }
+}
+exports.CodebaseContextProvider = CodebaseContextProvider;
+//# sourceMappingURL=codebase.js.map

package/dist/context-providers/codebase.js.map

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

package/dist/context-providers/diff.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Diff Context Provider — @diff
+ *
+ * Provides current working changes as context.
+ * Usage:
+ *   @diff           — unstaged working changes
+ *   @diff staged    — staged changes
+ *   @diff main      — diff against main branch
+ */
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+export declare class DiffContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(arg?: string, options?: ContextResolveOptions): Promise<ContextResult>;
+}
+//# sourceMappingURL=diff.d.ts.map

package/dist/context-providers/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/context-providers/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAIrF,qBAAa,mBAAoB,YAAW,eAAe;IACzD,EAAE,SAAU;IACZ,OAAO,SAAW;IAClB,WAAW,SAA8D;IACzE,WAAW,UAAS;IAEd,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;CA4CrF"}

package/dist/context-providers/diff.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Diff Context Provider — @diff
+ *
+ * Provides current working changes as context.
+ * Usage:
+ *   @diff           — unstaged working changes
+ *   @diff staged    — staged changes
+ *   @diff main      — diff against main branch
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiffContextProvider = void 0;
+const child_process_1 = require("child_process");
+const MAX_DIFF_CHARS = 30000;
+class DiffContextProvider {
+    id = "diff";
+    trigger = "@diff";
+    description = "Current git diff (working changes, staged, or vs branch)";
+    requiresArg = false;
+    async resolve(arg, options) {
+        const workingDir = options?.workingDir || process.cwd();
+        const target = (arg || "").trim();
+        let command = "git diff";
+        let label = "Working changes";
+        if (target === "staged") {
+            command = "git diff --cached";
+            label = "Staged changes";
+        }
+        else if (target) {
+            // Sanitize
+            if (!/^[a-zA-Z0-9_.\/~^@{}\-]+$/.test(target)) {
+                return { label: "Diff", content: `Invalid git ref: "${target}"` };
+            }
+            command = `git diff ${target}`;
+            label = `Diff vs ${target}`;
+        }
+        try {
+            const diff = await new Promise((resolve, reject) => {
+                (0, child_process_1.exec)(command, { cwd: workingDir, timeout: 15000, maxBuffer: 5 * 1024 * 1024 }, (err, stdout, stderr) => {
+                    if (err && !stdout)
+                        return reject(new Error(stderr?.trim() || err.message));
+                    resolve(stdout);
+                });
+            });
+            const trimmedDiff = diff.trim();
+            if (!trimmedDiff) {
+                return { label, content: `## ${label}\nNo changes.` };
+            }
+            const truncated = trimmedDiff.length > MAX_DIFF_CHARS
+                ? trimmedDiff.substring(0, MAX_DIFF_CHARS) + "\n... [truncated]"
+                : trimmedDiff;
+            return {
+                label,
+                content: `## ${label}\n\`\`\`diff\n${truncated}\n\`\`\``,
+            };
+        }
+        catch (err) {
+            return { label: "Diff", content: `Diff error: ${err.message}` };
+        }
+    }
+}
+exports.DiffContextProvider = DiffContextProvider;
+//# sourceMappingURL=diff.js.map

package/dist/context-providers/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/context-providers/diff.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,iDAAqC;AAGrC,MAAM,cAAc,GAAG,KAAK,CAAC;AAE7B,MAAa,mBAAmB;IAC9B,EAAE,GAAG,MAAM,CAAC;IACZ,OAAO,GAAG,OAAO,CAAC;IAClB,WAAW,GAAG,0DAA0D,CAAC;IACzE,WAAW,GAAG,KAAK,CAAC;IAEpB,KAAK,CAAC,OAAO,CAAC,GAAY,EAAE,OAA+B;QACzD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAElC,IAAI,OAAO,GAAG,UAAU,CAAC;QACzB,IAAI,KAAK,GAAG,iBAAiB,CAAC;QAE9B,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,GAAG,mBAAmB,CAAC;YAC9B,KAAK,GAAG,gBAAgB,CAAC;QAC3B,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,WAAW;YACX,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,MAAM,GAAG,EAAE,CAAC;YACpE,CAAC;YACD,OAAO,GAAG,YAAY,MAAM,EAAE,CAAC;YAC/B,KAAK,GAAG,WAAW,MAAM,EAAE,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACzD,IAAA,oBAAI,EAAC,OAAO,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBACrG,IAAI,GAAG,IAAI,CAAC,MAAM;wBAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;oBAC5E,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,eAAe,EAAE,CAAC;YACxD,CAAC;YAED,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,GAAG,cAAc;gBACnD,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,mBAAmB;gBAChE,CAAC,CAAC,WAAW,CAAC;YAEhB,OAAO;gBACL,KAAK;gBACL,OAAO,EAAE,MAAM,KAAK,iBAAiB,SAAS,UAAU;aACzD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAgB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;CACF;AAlDD,kDAkDC"}

package/dist/context-providers/docs.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Docs Context Provider — @docs
+ *
+ * Fetches documentation for packages/libraries and injects into context.
+ * Usage:
+ *   @docs react          — fetch React docs summary
+ *   @docs express/Router — fetch specific section
+ *   @docs https://...    — fetch docs from URL directly
+ */
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+export declare class DocsContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(arg?: string, options?: ContextResolveOptions): Promise<ContextResult>;
+    private fetchUrl;
+    private findLocalDocs;
+    private fetchNpmReadme;
+}
+//# sourceMappingURL=docs.d.ts.map

package/dist/context-providers/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/context-providers/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAmBrF,qBAAa,mBAAoB,YAAW,eAAe;IACzD,EAAE,SAAU;IACZ,OAAO,SAAW;IAClB,WAAW,SAA+E;IAC1F,WAAW,UAAQ;IAEb,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;YA8BtE,QAAQ;IAgCtB,OAAO,CAAC,aAAa;YA2BP,cAAc;CAiC7B"}

package/dist/context-providers/docs.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * Docs Context Provider — @docs
+ *
+ * Fetches documentation for packages/libraries and injects into context.
+ * Usage:
+ *   @docs react          — fetch React docs summary
+ *   @docs express/Router — fetch specific section
+ *   @docs https://...    — fetch docs from URL directly
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocsContextProvider = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MAX_CHARS = 30000;
+/**
+ * Docs registry is loaded from ~/.cdoing/docs-registry.json if it exists.
+ * Users can add their own package → URL mappings there.
+ * Format: { "react": "https://...", "express": "https://..." }
+ */
+function loadDocsRegistry() {
+    try {
+        const registryPath = require("path").join(require("os").homedir(), ".cdoing", "docs-registry.json");
+        if (require("fs").existsSync(registryPath)) {
+            return JSON.parse(require("fs").readFileSync(registryPath, "utf-8"));
+        }
+    }
+    catch { /* ignore */ }
+    return {};
+}
+class DocsContextProvider {
+    id = "docs";
+    trigger = "@docs";
+    description = "Fetch documentation for a package or URL (@docs react, @docs https://...)";
+    requiresArg = true;
+    async resolve(arg, options) {
+        if (!arg?.trim()) {
+            return {
+                label: "Docs",
+                content: `Usage: @docs <package-name> or @docs <url>\n\nSupported packages: ${Object.keys(loadDocsRegistry()).join(", ")}`,
+            };
+        }
+        const query = arg.trim().toLowerCase();
+        // Direct URL
+        if (query.startsWith("http://") || query.startsWith("https://")) {
+            return this.fetchUrl(query);
+        }
+        // Check registry
+        const registryUrl = loadDocsRegistry()[query];
+        if (registryUrl) {
+            return this.fetchUrl(registryUrl, query);
+        }
+        // Try to find local docs (README.md in node_modules)
+        const workingDir = options?.workingDir || process.cwd();
+        const localResult = this.findLocalDocs(workingDir, query);
+        if (localResult)
+            return localResult;
+        // Try npm registry as fallback
+        return this.fetchNpmReadme(query);
+    }
+    async fetchUrl(url, packageName) {
+        try {
+            const response = await fetch(url, {
+                headers: { "User-Agent": "cdoing-agent/1.0" },
+                signal: AbortSignal.timeout(10000),
+            });
+            if (!response.ok) {
+                return {
+                    label: `Docs: ${packageName || url}`,
+                    content: `Failed to fetch docs: HTTP ${response.status}`,
+                };
+            }
+            let text = await response.text();
+            if (text.length > MAX_CHARS) {
+                text = text.substring(0, MAX_CHARS) + "\n\n... [truncated]";
+            }
+            return {
+                label: `Docs: ${packageName || url}`,
+                content: `<docs source="${packageName || url}">\n${text}\n</docs>`,
+                metadata: { source: url, truncated: text.length >= MAX_CHARS },
+            };
+        }
+        catch (err) {
+            return {
+                label: `Docs: ${packageName || url}`,
+                content: `Failed to fetch docs: ${err.message}`,
+            };
+        }
+    }
+    findLocalDocs(workingDir, packageName) {
+        const candidates = [
+            path.join(workingDir, "node_modules", packageName, "README.md"),
+            path.join(workingDir, "node_modules", packageName, "readme.md"),
+            path.join(workingDir, "node_modules", packageName, "Readme.md"),
+            path.join(workingDir, "node_modules", `@${packageName.split("/")[0]}`, packageName.split("/")[1] || "", "README.md"),
+        ];
+        for (const candidate of candidates) {
+            if (fs.existsSync(candidate)) {
+                try {
+                    let content = fs.readFileSync(candidate, "utf-8");
+                    if (content.length > MAX_CHARS) {
+                        content = content.substring(0, MAX_CHARS) + "\n\n... [truncated]";
+                    }
+                    return {
+                        label: `Docs: ${packageName} (local)`,
+                        content: `<docs source="${packageName}" local="true">\n${content}\n</docs>`,
+                        metadata: { source: candidate },
+                    };
+                }
+                catch { /* skip */ }
+            }
+        }
+        return null;
+    }
+    async fetchNpmReadme(packageName) {
+        try {
+            const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}`, {
+                headers: { "Accept": "application/json", "User-Agent": "cdoing-agent/1.0" },
+                signal: AbortSignal.timeout(10000),
+            });
+            if (!response.ok) {
+                return {
+                    label: `Docs: ${packageName}`,
+                    content: `Package "${packageName}" not found. Available packages: ${Object.keys(loadDocsRegistry()).join(", ")}`,
+                };
+            }
+            const data = await response.json();
+            let readme = data.readme || data.description || "(no documentation found)";
+            if (readme.length > MAX_CHARS) {
+                readme = readme.substring(0, MAX_CHARS) + "\n\n... [truncated]";
+            }
+            return {
+                label: `Docs: ${packageName} (npm)`,
+                content: `<docs source="${packageName}" npm="true">\n${readme}\n</docs>`,
+                metadata: { source: `npm:${packageName}`, truncated: readme.length >= MAX_CHARS },
+            };
+        }
+        catch (err) {
+            return {
+                label: `Docs: ${packageName}`,
+                content: `Failed to fetch docs for "${packageName}": ${err.message}`,
+            };
+        }
+    }
+}
+exports.DocsContextProvider = DocsContextProvider;
+//# sourceMappingURL=docs.js.map

package/dist/context-providers/docs.js.map

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

package/dist/context-providers/file-include.d.ts

@@ -0,0 +1,13 @@
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+/**
+ * @file <path> — reads a file and injects its content into the prompt.
+ * Also handles bare relative/absolute paths that look like files.
+ */
+export declare class FileIncludeContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(arg?: string, opts?: ContextResolveOptions): Promise<ContextResult>;
+}
+//# sourceMappingURL=file-include.d.ts.map

package/dist/context-providers/file-include.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-include.d.ts","sourceRoot":"","sources":["../../src/context-providers/file-include.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAIrF;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,eAAe;IAChE,EAAE,SAAU;IACZ,OAAO,SAAW;IAClB,WAAW,SAAkE;IAC7E,WAAW,UAAQ;IAEb,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;CAqClF"}