helixmind 0.1.0

package/dist/cli/validation/stats.js

@@ -0,0 +1,137 @@
+/**
+ * Validation Statistics — tracks validation results over time.
+ * Stores stats in spiral memory for long-term analysis.
+ */
+import chalk from 'chalk';
+/**
+ * Store validation result in spiral for long-term stats.
+ */
+export async function storeValidationResult(result, taskCategory, engine) {
+    if (!engine)
+        return;
+    const failed = result.results.filter(r => !r.passed);
+    if (failed.length === 0 && result.fixesApplied === 0)
+        return; // Don't store perfect passes
+    const content = formatForSpiral(result, taskCategory);
+    try {
+        await engine.store(content, 'code', {
+            tags: ['validation', taskCategory, result.status],
+        });
+    }
+    catch {
+        // Non-critical — don't block
+    }
+}
+/**
+ * Query validation stats from spiral memory.
+ */
+export async function getValidationStats(engine) {
+    if (!engine)
+        return null;
+    try {
+        const query = await engine.query('validation statistics issues autofix', undefined, [1, 2, 3]);
+        const nodes = [
+            ...query.level_1.map(n => n.content),
+            ...query.level_2.map(n => n.content),
+            ...query.level_3.map(n => n.content),
+        ];
+        if (nodes.length === 0)
+            return null;
+        return aggregateStats(nodes);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Render validation stats for display.
+ */
+export function renderValidationStats(stats) {
+    const lines = [];
+    lines.push(chalk.bold('\n\u{1F4CA} Validation Statistics:\n'));
+    // Top issues
+    const sorted = [...stats.issueFrequency.entries()]
+        .sort((a, b) => b[1].count - a[1].count)
+        .slice(0, 10);
+    if (sorted.length > 0) {
+        lines.push(chalk.dim('  Most common issues:'));
+        for (let i = 0; i < sorted.length; i++) {
+            const [id, data] = sorted[i];
+            const fixInfo = data.autofixed > 0
+                ? chalk.green(`${data.autofixed} autofixed`)
+                : chalk.yellow('manual fix');
+            lines.push(`  ${chalk.dim(`${i + 1}.`)} ${chalk.cyan(id.padEnd(20))} \u2014 ${data.count} time${data.count !== 1 ? 's' : ''} (${fixInfo})`);
+        }
+    }
+    lines.push('');
+    lines.push(`  Autofix success rate: ${chalk.bold(formatPercent(stats.autofixRate))}`);
+    lines.push(`  Average validation time: ${chalk.bold(stats.averageDuration.toFixed(0) + 'ms')}`);
+    lines.push(`  Average loops needed: ${chalk.bold(stats.averageLoops.toFixed(1))}`);
+    lines.push(`  Total validations: ${chalk.bold(String(stats.totalValidations))}`);
+    lines.push('');
+    return lines.join('\n');
+}
+// ── Internal ──
+function formatForSpiral(result, category) {
+    const failed = result.results.filter(r => !r.passed);
+    const lines = [
+        `[validation] category=${category} status=${result.status} checks=${result.results.length} loops=${result.loops} fixes=${result.fixesApplied} duration=${result.duration}ms`,
+    ];
+    for (const f of failed) {
+        lines.push(`  ${f.severity}: ${f.id} — ${f.details}${f.autofix ? ' [autofixed]' : ''}`);
+    }
+    return lines.join('\n');
+}
+function aggregateStats(nodes) {
+    let totalValidations = 0;
+    let totalChecks = 0;
+    let totalPassed = 0;
+    let totalFailed = 0;
+    let totalAutofixes = 0;
+    let totalDuration = 0;
+    let totalLoops = 0;
+    const issueFrequency = new Map();
+    for (const content of nodes) {
+        // Parse validation log lines
+        const headerMatch = content.match(/\[validation\]\s+.*checks=(\d+)\s+loops=(\d+)\s+fixes=(\d+)\s+duration=(\d+)/);
+        if (headerMatch) {
+            totalValidations++;
+            totalChecks += parseInt(headerMatch[1]);
+            totalLoops += parseInt(headerMatch[2]);
+            totalAutofixes += parseInt(headerMatch[3]);
+            totalDuration += parseInt(headerMatch[4]);
+        }
+        // Parse individual issue lines
+        const issueLines = content.match(/^\s+(error|warning|info):\s+(\S+)\s+/gm);
+        if (issueLines) {
+            for (const line of issueLines) {
+                const idMatch = line.match(/:\s+(\S+)/);
+                if (idMatch) {
+                    const id = idMatch[1];
+                    const entry = issueFrequency.get(id) || { count: 0, autofixed: 0 };
+                    entry.count++;
+                    if (line.includes('[autofixed]'))
+                        entry.autofixed++;
+                    issueFrequency.set(id, entry);
+                    totalFailed++;
+                }
+            }
+        }
+    }
+    totalPassed = totalChecks - totalFailed;
+    return {
+        totalValidations,
+        totalChecks,
+        totalPassed,
+        totalFailed,
+        totalAutofixes,
+        averageDuration: totalValidations > 0 ? totalDuration / totalValidations : 0,
+        averageLoops: totalValidations > 0 ? totalLoops / totalValidations : 0,
+        autofixRate: totalFailed > 0 ? totalAutofixes / totalFailed : 1,
+        issueFrequency,
+    };
+}
+function formatPercent(n) {
+    return (n * 100).toFixed(0) + '%';
+}
+//# sourceMappingURL=stats.js.map

package/dist/cli/validation/stats.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { loadConfig } from './utils/config.js';
+import { setLogLevel, logger } from './utils/logger.js';
+async function main() {
+    const config = loadConfig();
+    setLogLevel(config.logLevel);
+    logger.info('Starting spiral-context-mcp server...');
+    const { server, engine } = createServer(config);
+    // Initialize embedding model (async, non-blocking for server start)
+    engine.initialize().catch(err => {
+        logger.warn(`Embedding initialization failed: ${err}. Running in fallback mode.`);
+    });
+    // Connect via STDIO transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('spiral-context-mcp server connected via STDIO');
+    // Handle graceful shutdown
+    process.on('SIGINT', () => {
+        logger.info('Shutting down...');
+        engine.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        logger.info('Shutting down...');
+        engine.close();
+        process.exit(0);
+    });
+}
+main().catch(err => {
+    process.stderr.write(`Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAErD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhD,oEAAoE;IACpE,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;QAC9B,MAAM,CAAC,IAAI,CAAC,oCAAoC,GAAG,6BAA6B,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAE7D,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SpiralEngine } from './spiral/engine.js';
+import type { SpiralConfig } from './types.js';
+export declare function createServer(config: SpiralConfig): {
+    server: McpServer;
+    engine: SpiralEngine;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAgE9F"}

package/dist/server.js

@@ -0,0 +1,43 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SpiralEngine } from './spiral/engine.js';
+import { spiralQuerySchema, handleSpiralQuery } from './tools/spiral-query.js';
+import { spiralStoreSchema, handleSpiralStore } from './tools/spiral-store.js';
+import { handleSpiralStatus } from './tools/spiral-status.js';
+import { spiralCompactSchema, handleSpiralCompact } from './tools/spiral-compact.js';
+import { spiralRelateSchema, handleSpiralRelate } from './tools/spiral-relate.js';
+export function createServer(config) {
+    const engine = new SpiralEngine(config);
+    const server = new McpServer({ name: 'spiral-context-mcp', version: '0.1.0' }, { capabilities: { logging: {} } });
+    // Tool: spiral_context – Query context across spiral levels
+    server.registerTool('spiral_context', {
+        title: 'Spiral Context',
+        description: 'Query the spiral context store. Returns proactively assembled context across Focus (L1), Association (L2), and Periphery (L3) levels.',
+        inputSchema: spiralQuerySchema,
+    }, async (args) => handleSpiralQuery(engine, args));
+    // Tool: spiral_store – Store new context
+    server.registerTool('spiral_store', {
+        title: 'Spiral Store',
+        description: 'Store new context in the spiral. Automatically generates embeddings, detects relations to existing context, and assigns the appropriate spiral level.',
+        inputSchema: spiralStoreSchema,
+    }, async (args) => handleSpiralStore(engine, args));
+    // Tool: spiral_status – Get spiral metrics
+    server.registerTool('spiral_status', {
+        title: 'Spiral Status',
+        description: 'Show the current state of the spiral context store: node counts per level, edge counts, storage size, and embedding status.',
+        inputSchema: {},
+    }, async () => handleSpiralStatus(engine));
+    // Tool: spiral_compact – Manual compaction
+    server.registerTool('spiral_compact', {
+        title: 'Spiral Compact',
+        description: 'Trigger manual compaction. Compresses old context nodes and optionally deletes very old ones in aggressive mode.',
+        inputSchema: spiralCompactSchema,
+    }, async (args) => handleSpiralCompact(engine, args));
+    // Tool: spiral_relate – Create manual relations
+    server.registerTool('spiral_relate', {
+        title: 'Spiral Relate',
+        description: 'Manually create a relation between two context nodes. Relations are used to proactively inject associated context.',
+        inputSchema: spiralRelateSchema,
+    }, async (args) => handleSpiralRelate(engine, args));
+    return { server, engine };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,EAChD,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAClC,CAAC;IAEF,4DAA4D;IAC5D,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,uIAAuI;QACpJ,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAChD,CAAC;IAEF,yCAAyC;IACzC,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,uJAAuJ;QACpK,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAChD,CAAC;IAEF,2CAA2C;IAC3C,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,6HAA6H;QAC1I,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CACvC,CAAC;IAEF,2CAA2C;IAC3C,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,kHAAkH;QAC/H,WAAW,EAAE,mBAAmB;KACjC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAClD,CAAC;IAEF,gDAAgD;IAChD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,oHAAoH;QACjI,WAAW,EAAE,kBAAkB;KAChC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CACjD,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/spiral/cloud/content-extractor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Content Extractor — Processes raw web content into spiral-ready knowledge.
+ *
+ * Takes HTML text/extracted content and produces clean, structured
+ * knowledge chunks that can be stored in the spiral brain.
+ */
+export interface ExtractedKnowledge {
+    /** Compressed summary of the content */
+    summary: string;
+    /** Code examples found */
+    codeExamples: string[];
+    /** Key points / best practices */
+    keyPoints: string[];
+    /** Source URL */
+    source: string;
+    /** Estimated quality score 0-1 */
+    quality: number;
+}
+/**
+ * Extract structured knowledge from page content.
+ */
+export declare function extractKnowledge(content: string, sourceUrl: string, topic: string): ExtractedKnowledge;
+/**
+ * Format extracted knowledge into a spiral-storable string.
+ */
+export declare function formatForSpiral(knowledge: ExtractedKnowledge, topic: string): string;
+//# sourceMappingURL=content-extractor.d.ts.map

package/dist/spiral/cloud/content-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-extractor.d.ts","sourceRoot":"","sources":["../../../src/spiral/cloud/content-extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kCAAkC;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAapB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,GACZ,MAAM,CA6BR"}

package/dist/spiral/cloud/content-extractor.js

@@ -0,0 +1,175 @@
+/**
+ * Content Extractor — Processes raw web content into spiral-ready knowledge.
+ *
+ * Takes HTML text/extracted content and produces clean, structured
+ * knowledge chunks that can be stored in the spiral brain.
+ */
+/**
+ * Extract structured knowledge from page content.
+ */
+export function extractKnowledge(content, sourceUrl, topic) {
+    const codeExamples = extractCodeBlocks(content);
+    const keyPoints = extractKeyPoints(content, topic);
+    const summary = buildSummary(content, topic, keyPoints);
+    const quality = assessQuality(content, codeExamples, keyPoints, topic);
+    return {
+        summary,
+        codeExamples: codeExamples.slice(0, 3), // Max 3 code examples
+        keyPoints: keyPoints.slice(0, 8), // Max 8 key points
+        source: sourceUrl,
+        quality,
+    };
+}
+/**
+ * Format extracted knowledge into a spiral-storable string.
+ */
+export function formatForSpiral(knowledge, topic) {
+    const sections = [];
+    sections.push(`[Web Knowledge: ${topic}]`);
+    sections.push(`Source: ${knowledge.source}`);
+    sections.push('');
+    if (knowledge.summary) {
+        sections.push(knowledge.summary);
+        sections.push('');
+    }
+    if (knowledge.keyPoints.length > 0) {
+        sections.push('Key Points:');
+        for (const point of knowledge.keyPoints) {
+            sections.push(`- ${point}`);
+        }
+        sections.push('');
+    }
+    if (knowledge.codeExamples.length > 0) {
+        sections.push('Code Examples:');
+        for (const code of knowledge.codeExamples) {
+            sections.push(code);
+            sections.push('');
+        }
+    }
+    return sections.join('\n').slice(0, 4000); // Max 4000 chars per node
+}
+/**
+ * Extract code blocks from content (markdown-style or raw).
+ */
+function extractCodeBlocks(content) {
+    const blocks = [];
+    // Markdown fenced code blocks
+    const fencedPattern = /```[\w]*\n([\s\S]*?)```/g;
+    let match;
+    while ((match = fencedPattern.exec(content)) !== null) {
+        const code = match[1].trim();
+        if (code.length > 20 && code.length < 2000) {
+            blocks.push('```\n' + code + '\n```');
+        }
+    }
+    // Inline code (longer ones, likely examples)
+    const inlinePattern = /`([^`]{50,500})`/g;
+    while ((match = inlinePattern.exec(content)) !== null) {
+        blocks.push('`' + match[1].trim() + '`');
+    }
+    return blocks;
+}
+/**
+ * Extract key points related to the topic.
+ */
+function extractKeyPoints(content, topic) {
+    const points = [];
+    const topicWords = topic.toLowerCase().split(/\s+/);
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty, very short, or very long lines
+        if (trimmed.length < 20 || trimmed.length > 300)
+            continue;
+        // List items that mention the topic
+        if (trimmed.startsWith('- ') || trimmed.startsWith('* ') || /^\d+\./.test(trimmed)) {
+            const lower = trimmed.toLowerCase();
+            const isRelevant = topicWords.some(w => lower.includes(w));
+            if (isRelevant) {
+                points.push(trimmed.replace(/^[-*]\s+/, '').replace(/^\d+\.\s+/, ''));
+            }
+        }
+        // Sentences with "best practice", "should", "recommend", "important"
+        if (/\b(best practice|should|recommend|important|always|never|avoid|prefer|use|tip)\b/i.test(trimmed)) {
+            const lower = trimmed.toLowerCase();
+            const isRelevant = topicWords.some(w => lower.includes(w));
+            if (isRelevant && !trimmed.startsWith('#')) {
+                // Clean up and add
+                const clean = trimmed
+                    .replace(/^#+\s*/, '')
+                    .replace(/\*\*/g, '')
+                    .trim();
+                if (clean.length > 20 && !points.includes(clean)) {
+                    points.push(clean);
+                }
+            }
+        }
+    }
+    return points;
+}
+/**
+ * Build a concise summary from the content.
+ */
+function buildSummary(content, topic, keyPoints) {
+    // If we have key points, build summary from them
+    if (keyPoints.length >= 3) {
+        return `${topic}: ${keyPoints.slice(0, 3).join('. ')}.`;
+    }
+    // Otherwise extract first relevant paragraph
+    const paragraphs = content.split('\n\n');
+    const topicWords = topic.toLowerCase().split(/\s+/);
+    for (const para of paragraphs) {
+        const trimmed = para.trim();
+        if (trimmed.length < 50 || trimmed.length > 500)
+            continue;
+        if (trimmed.startsWith('```') || trimmed.startsWith('#'))
+            continue;
+        const lower = trimmed.toLowerCase();
+        if (topicWords.some(w => lower.includes(w))) {
+            return trimmed.slice(0, 300);
+        }
+    }
+    // Fallback: first substantial paragraph
+    for (const para of paragraphs) {
+        const trimmed = para.trim();
+        if (trimmed.length > 50 && trimmed.length < 500 && !trimmed.startsWith('```')) {
+            return trimmed.slice(0, 300);
+        }
+    }
+    return `Web knowledge about ${topic}`;
+}
+/**
+ * Assess the quality of extracted content.
+ * Higher quality = more code examples, more key points, topic relevance.
+ */
+function assessQuality(content, codeExamples, keyPoints, topic) {
+    let score = 0.3; // Base score for having any content
+    // Code examples boost quality
+    if (codeExamples.length > 0)
+        score += 0.2;
+    if (codeExamples.length >= 2)
+        score += 0.1;
+    // Key points boost quality
+    if (keyPoints.length >= 3)
+        score += 0.15;
+    if (keyPoints.length >= 5)
+        score += 0.1;
+    // Topic mention density
+    const topicWords = topic.toLowerCase().split(/\s+/);
+    const lower = content.toLowerCase();
+    let mentions = 0;
+    for (const word of topicWords) {
+        const regex = new RegExp(`\\b${escapeRegex(word)}\\b`, 'gi');
+        const matches = lower.match(regex);
+        mentions += matches?.length ?? 0;
+    }
+    if (mentions > 5)
+        score += 0.1;
+    if (mentions > 15)
+        score += 0.05;
+    return Math.min(1.0, score);
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=content-extractor.js.map

package/dist/spiral/cloud/content-extractor.js.map

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

package/dist/spiral/cloud/search-provider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Web Search Provider — Searches the internet for relevant knowledge.
+ *
+ * Uses DuckDuckGo Lite HTML search (no API key required).
+ * Falls back gracefully if no internet connection.
+ */
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+/**
+ * Search the web using DuckDuckGo Lite.
+ * Returns up to `maxResults` results.
+ */
+export declare function webSearch(query: string, maxResults?: number, signal?: AbortSignal): Promise<SearchResult[]>;
+/**
+ * Fetch the text content of a web page.
+ * Returns extracted text, limited to maxLength characters.
+ */
+export declare function fetchPageContent(url: string, maxLength?: number, signal?: AbortSignal): Promise<string | null>;
+//# sourceMappingURL=search-provider.d.ts.map

package/dist/spiral/cloud/search-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-provider.d.ts","sourceRoot":"","sources":["../../../src/spiral/cloud/search-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAU,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CA4BzB;AAmED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAa,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB"}