@cleocode/cleo 2026.3.66 → 2026.3.68

package/dist/mcp/resources/budget.d.ts

@@ -0,0 +1,22 @@
+/**
+ * LAFS Budget-Aware Truncation for MCP Resources
+ *
+ * Provides token estimation and truncation for MCP resource responses,
+ * ensuring they stay within LAFS MVI budget constraints.
+ *
+ * @task T5240
+ */
+/**
+ * Estimate the number of tokens in a text string.
+ * Uses a conservative character-based estimate (~4 chars per token).
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Truncate text to fit within a token budget.
+ *
+ * @param text - Text content to potentially truncate
+ * @param budget - Maximum token budget
+ * @returns Truncated text with indicator if truncation occurred
+ */
+export declare function truncateToTokenBudget(text: string, budget?: number): string;
+//# sourceMappingURL=budget.d.ts.map

package/dist/mcp/resources/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/mcp/resources/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB3E"}

package/dist/mcp/resources/budget.js

@@ -0,0 +1,46 @@
+/**
+ * LAFS Budget-Aware Truncation for MCP Resources
+ *
+ * Provides token estimation and truncation for MCP resource responses,
+ * ensuring they stay within LAFS MVI budget constraints.
+ *
+ * @task T5240
+ */
+/** Default token budget for MCP resources (conservative). */
+const DEFAULT_RESOURCE_BUDGET = 500;
+/** Approximate tokens per character (conservative estimate). */
+const TOKENS_PER_CHAR = 0.25;
+/**
+ * Estimate the number of tokens in a text string.
+ * Uses a conservative character-based estimate (~4 chars per token).
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length * TOKENS_PER_CHAR);
+}
+/**
+ * Truncate text to fit within a token budget.
+ *
+ * @param text - Text content to potentially truncate
+ * @param budget - Maximum token budget
+ * @returns Truncated text with indicator if truncation occurred
+ */
+export function truncateToTokenBudget(text, budget) {
+    const maxTokens = budget ?? DEFAULT_RESOURCE_BUDGET;
+    const estimated = estimateTokens(text);
+    if (estimated <= maxTokens) {
+        return text;
+    }
+    // Calculate max characters from budget
+    const maxChars = Math.floor(maxTokens / TOKENS_PER_CHAR);
+    // Find the last newline before the limit to truncate at line boundary
+    const truncated = text.substring(0, maxChars);
+    const lastNewline = truncated.lastIndexOf('\n');
+    const cutPoint = lastNewline > 0 ? lastNewline : maxChars;
+    return (text.substring(0, cutPoint) +
+        '\n\n[Truncated: ~' +
+        estimated +
+        ' tokens, budget: ' +
+        maxTokens +
+        ']');
+}
+//# sourceMappingURL=budget.js.map

package/dist/mcp/resources/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/mcp/resources/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,gEAAgE;AAChE,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAe;IACjE,MAAM,SAAS,GAAG,MAAM,IAAI,uBAAuB,CAAC;IACpD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAEvC,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IAEzD,sEAAsE;IACtE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE1D,OAAO,CACL,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC;QAC3B,mBAAmB;QACnB,SAAS;QACT,mBAAmB;QACnB,SAAS;QACT,GAAG,CACJ,CAAC;AACJ,CAAC"}

package/dist/mcp/resources/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MCP Resource Endpoints for CLEO Memory
+ *
+ * Provides dynamic, read-only resource URIs that serve brain.db content
+ * to any MCP-compatible provider. No file writing needed — data is
+ * served directly from brain.db.
+ *
+ * Resource URIs:
+ * - cleo://memory/recent     — Last 15 observations (compact)
+ * - cleo://memory/learnings  — Active learnings with confidence scores
+ * - cleo://memory/patterns   — Active patterns (follow/avoid)
+ * - cleo://memory/handoff    — Last session handoff summary
+ *
+ * @task T5240
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * MCP Resource definition.
+ */
+export interface McpResource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+/**
+ * MCP Resource content response.
+ */
+export interface McpResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+/**
+ * List all available CLEO memory resources.
+ */
+export declare function listMemoryResources(): McpResource[];
+/**
+ * Register MCP resource handlers on the server.
+ *
+ * @param server - MCP Server instance
+ */
+export declare function registerMemoryResources(server: Server): void;
+/**
+ * Read a CLEO memory resource by URI.
+ *
+ * @param uri - Resource URI (e.g. "cleo://memory/recent")
+ * @param tokenBudget - Optional token budget for truncation
+ * @returns Resource content or null if URI is unknown
+ */
+export declare function readMemoryResource(uri: string, tokenBudget?: number): Promise<McpResourceContent | null>;
+export { estimateTokens, truncateToTokenBudget } from './budget.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOxE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,EAAE,CA2BnD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAiC5D;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAkDpC;AAyKD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/resources/index.js

@@ -0,0 +1,278 @@
+/**
+ * MCP Resource Endpoints for CLEO Memory
+ *
+ * Provides dynamic, read-only resource URIs that serve brain.db content
+ * to any MCP-compatible provider. No file writing needed — data is
+ * served directly from brain.db.
+ *
+ * Resource URIs:
+ * - cleo://memory/recent     — Last 15 observations (compact)
+ * - cleo://memory/learnings  — Active learnings with confidence scores
+ * - cleo://memory/patterns   — Active patterns (follow/avoid)
+ * - cleo://memory/handoff    — Last session handoff summary
+ *
+ * @task T5240
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Execute a prepared statement and return typed rows.
+ * node:sqlite's StatementSync.all() returns unknown[], so this helper
+ * provides a single narrowing point instead of scattering casts.
+ */
+function typedAll(stmt) {
+    return stmt.all();
+}
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { truncateToTokenBudget } from './budget.js';
+/**
+ * List all available CLEO memory resources.
+ */
+export function listMemoryResources() {
+    return [
+        {
+            uri: 'cleo://memory/recent',
+            name: 'Recent Observations',
+            description: 'Last 15 brain observations in compact format (~200-400 tokens)',
+            mimeType: 'text/markdown',
+        },
+        {
+            uri: 'cleo://memory/learnings',
+            name: 'Active Learnings',
+            description: 'Active brain learnings with confidence scores (~150-300 tokens)',
+            mimeType: 'text/markdown',
+        },
+        {
+            uri: 'cleo://memory/patterns',
+            name: 'Active Patterns',
+            description: 'Active patterns to follow or avoid (~100-200 tokens)',
+            mimeType: 'text/markdown',
+        },
+        {
+            uri: 'cleo://memory/handoff',
+            name: 'Session Handoff',
+            description: 'Last session handoff summary (~100-200 tokens)',
+            mimeType: 'text/markdown',
+        },
+    ];
+}
+/**
+ * Register MCP resource handlers on the server.
+ *
+ * @param server - MCP Server instance
+ */
+export function registerMemoryResources(server) {
+    // ListResources handler
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const resources = listMemoryResources();
+        return {
+            resources: resources.map((r) => ({
+                uri: r.uri,
+                name: r.name,
+                description: r.description,
+                mimeType: r.mimeType,
+            })),
+        };
+    });
+    // ReadResource handler
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        const result = await readMemoryResource(uri);
+        if (!result) {
+            throw new Error(`Unknown resource URI: ${uri}`);
+        }
+        return {
+            contents: [
+                {
+                    uri: result.uri,
+                    mimeType: result.mimeType,
+                    text: result.text,
+                },
+            ],
+        };
+    });
+}
+/**
+ * Read a CLEO memory resource by URI.
+ *
+ * @param uri - Resource URI (e.g. "cleo://memory/recent")
+ * @param tokenBudget - Optional token budget for truncation
+ * @returns Resource content or null if URI is unknown
+ */
+export async function readMemoryResource(uri, tokenBudget) {
+    // Handoff uses sessions data, not brain.db — handle separately
+    if (uri === 'cleo://memory/handoff') {
+        const text = await getSessionHandoff();
+        return {
+            uri,
+            mimeType: 'text/markdown',
+            text: truncateToTokenBudget(text, tokenBudget),
+        };
+    }
+    const brainDbPath = join(process.cwd(), '.cleo', 'brain.db');
+    if (!existsSync(brainDbPath)) {
+        // Unknown URIs return null; known brain URIs get a helpful message
+        const knownBrainUris = new Set([
+            'cleo://memory/recent',
+            'cleo://memory/learnings',
+            'cleo://memory/patterns',
+        ]);
+        if (!knownBrainUris.has(uri)) {
+            return null;
+        }
+        return {
+            uri,
+            mimeType: 'text/markdown',
+            text: '# No Brain Data\n\nNo brain.db found. Run `cleo init` to initialize.',
+        };
+    }
+    let text;
+    switch (uri) {
+        case 'cleo://memory/recent':
+            text = await getRecentObservations();
+            break;
+        case 'cleo://memory/learnings':
+            text = await getActiveLearnings();
+            break;
+        case 'cleo://memory/patterns':
+            text = await getActivePatterns();
+            break;
+        default:
+            return null;
+    }
+    return {
+        uri,
+        mimeType: 'text/markdown',
+        text: truncateToTokenBudget(text, tokenBudget),
+    };
+}
+/**
+ * Get recent observations in compact markdown format.
+ */
+async function getRecentObservations() {
+    try {
+        const { getBrainDb, getBrainNativeDb } = await import('@cleocode/core/internal');
+        await getBrainDb(process.cwd());
+        const nativeDb = getBrainNativeDb();
+        if (!nativeDb)
+            return '# Recent Observations\n\nBrain database not available.';
+        const rows = typedAll(nativeDb.prepare(`SELECT id, type, title, created_at
+         FROM brain_observations
+         ORDER BY created_at DESC
+         LIMIT 15`));
+        if (rows.length === 0) {
+            return '# Recent Observations\n\nNo observations recorded yet.';
+        }
+        const lines = ['# Recent Observations\n'];
+        for (const row of rows) {
+            const date = (row.created_at ?? '').slice(0, 10);
+            const title = (row.title ?? '').substring(0, 90);
+            lines.push(`- [${row.id}] ${date} (${row.type}): ${title}`);
+        }
+        return lines.join('\n');
+    }
+    catch {
+        return '# Recent Observations\n\nUnable to read brain.db.';
+    }
+}
+/**
+ * Get active learnings in compact markdown format.
+ */
+async function getActiveLearnings() {
+    try {
+        const { getBrainDb, getBrainNativeDb } = await import('@cleocode/core/internal');
+        await getBrainDb(process.cwd());
+        const nativeDb = getBrainNativeDb();
+        if (!nativeDb)
+            return '# Active Learnings\n\nBrain database not available.';
+        const rows = typedAll(nativeDb.prepare(`SELECT id, insight, confidence, created_at
+         FROM brain_learnings
+         ORDER BY confidence DESC, created_at DESC
+         LIMIT 15`));
+        if (rows.length === 0) {
+            return '# Active Learnings\n\nNo learnings recorded yet.';
+        }
+        const lines = ['# Active Learnings\n'];
+        for (const row of rows) {
+            const conf = typeof row.confidence === 'number' ? row.confidence.toFixed(2) : String(row.confidence);
+            lines.push(`- [${row.id}] (confidence: ${conf}) ${(row.insight ?? '').substring(0, 120)}`);
+        }
+        return lines.join('\n');
+    }
+    catch {
+        return '# Active Learnings\n\nUnable to read brain.db.';
+    }
+}
+/**
+ * Get active patterns in compact markdown format.
+ */
+async function getActivePatterns() {
+    try {
+        const { getBrainDb, getBrainNativeDb } = await import('@cleocode/core/internal');
+        await getBrainDb(process.cwd());
+        const nativeDb = getBrainNativeDb();
+        if (!nativeDb)
+            return '# Active Patterns\n\nBrain database not available.';
+        const rows = typedAll(nativeDb.prepare(`SELECT id, pattern, type, impact, extracted_at
+         FROM brain_patterns
+         ORDER BY extracted_at DESC
+         LIMIT 30`));
+        if (rows.length === 0) {
+            return '# Active Patterns\n\nNo patterns recorded yet.';
+        }
+        const followTypes = new Set(['success', 'workflow', 'optimization']);
+        const followRows = rows.filter((r) => followTypes.has(r.type));
+        const avoidRows = rows.filter((r) => !followTypes.has(r.type));
+        const lines = ['# Active Patterns\n'];
+        if (followRows.length > 0) {
+            lines.push('## Follow\n');
+            for (const row of followRows) {
+                lines.push(`- [${row.id}] (${row.type}, ${row.impact ?? 'medium'}): ${(row.pattern ?? '').substring(0, 120)}`);
+            }
+            lines.push('');
+        }
+        if (avoidRows.length > 0) {
+            lines.push('## Avoid\n');
+            for (const row of avoidRows) {
+                lines.push(`- [${row.id}] AVOID (${row.type}, ${row.impact ?? 'medium'}): ${(row.pattern ?? '').substring(0, 120)}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    catch {
+        return '# Active Patterns\n\nUnable to read brain.db.';
+    }
+}
+/**
+ * Get session handoff in compact markdown format.
+ */
+async function getSessionHandoff() {
+    try {
+        const { getLastHandoff } = await import('@cleocode/core/internal');
+        const result = await getLastHandoff(process.cwd());
+        if (!result) {
+            return '# Session Handoff\n\nNo prior session handoff available.';
+        }
+        const { sessionId, handoff: h } = result;
+        const lines = ['# Session Handoff\n'];
+        lines.push(`- **Session**: ${sessionId}`);
+        if (h.lastTask)
+            lines.push(`- **Last task**: ${h.lastTask}`);
+        if (h.tasksCompleted.length > 0)
+            lines.push(`- **Completed**: ${h.tasksCompleted.join(', ')}`);
+        if (h.tasksCreated.length > 0)
+            lines.push(`- **Created**: ${h.tasksCreated.join(', ')}`);
+        if (h.nextSuggested.length > 0)
+            lines.push(`- **Next suggested**: ${h.nextSuggested.join(', ')}`);
+        if (h.openBlockers.length > 0)
+            lines.push(`- **Open blockers**: ${h.openBlockers.join(', ')}`);
+        if (h.note)
+            lines.push(`- **Note**: ${h.note}`);
+        return lines.join('\n');
+    }
+    catch {
+        return '# Session Handoff\n\nUnable to retrieve handoff data.';
+    }
+}
+export { estimateTokens, truncateToTokenBudget } from './budget.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/resources/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/cleo",
-  "version": "2026.3.66",
+  "version": "2026.3.68",
   "description": "CLEO CLI + MCP server — the assembled product consuming @cleocode/core",
   "type": "module",
   "main": "./dist/cli/index.js",
@@ -12,13 +12,18 @@
     "cleo": "dist/cli/index.js",
     "ct": "dist/cli/index.js"
   },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node bin/postinstall.js"
+  },
   "dependencies": {
     "@cleocode/caamp": "^1.8.1",
+    "@cleocode/contracts": "workspace:*",
+    "@cleocode/core": "workspace:*",
     "@cleocode/lafs-protocol": "^1.8.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "citty": "^0.2.1",
-    "@cleocode/contracts": "2026.3.66",
-    "@cleocode/core": "2026.3.66"
+    "citty": "^0.2.1"
   },
   "engines": {
     "node": ">=24.0.0"
@@ -37,10 +42,5 @@
     "type": "git",
     "url": "https://github.com/kryptobaseddev/cleo",
     "directory": "packages/cleo"
-  },
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "postinstall": "node bin/postinstall.js"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 CLEO Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.