blyuecode 0.6.0 → 0.7.0

package/dist/core/agent.js

@@ -2,15 +2,19 @@ import { Provider } from './provider.js';
 import { getToolDefs, executeTool } from './tools.js';
 import { loadSession, saveSession, clearSession } from './session.js';
 import { formatSkillForPrompt } from './skills.js';
+import { memoryForPrompt } from './memory.js';
 const SYSTEM_PROMPT = 'You are BLYUE, a coding assistant running in a terminal. ' +
     'Use tools to read, write, and run commands. ' +
     'If n8n tools are available, you can also manage n8n workflows. ' +
-    'Always explain what you are doing. Be concise.';
+    'Always explain what you are doing. Be concise. ' +
+    'When the user says "remember X", call the remember tool. ' +
+    'When you discover a durable fact about the project worth persisting, ' +
+    'offer to remember it (do not do so silently).';
 export class Agent {
     provider = null;
     messages;
     constructor(resume = true) {
-        const sys = { role: 'system', content: SYSTEM_PROMPT };
+        const sys = this.buildSystemMessage([]);
         const history = resume ? loadSession() : null;
         if (history && history.length > 0) {
             this.messages = [sys, ...history];
@@ -32,6 +36,13 @@ export class Agent {
     }
     buildSystemMessage(skills) {
         let content = SYSTEM_PROMPT;
+        const mem = memoryForPrompt();
+        if (mem) {
+            content += '\n\n# Project memory\n' +
+                'The following notes come from .blyue/MEMORY.md in this project.\n' +
+                'Treat them as authoritative context unless contradicted by the user.\n\n' +
+                mem;
+        }
         if (skills.length > 0) {
             content += '\n\n# Active skills\n';
             for (const sk of skills) {

package/dist/core/memory.js

@@ -0,0 +1,63 @@
+import fs from 'fs';
+import path from 'path';
+const REL_DIR = '.blyue';
+const FILE = 'MEMORY.md';
+const MAX_INJECT_BYTES = 8 * 1024;
+export function memoryPath(cwd = process.cwd()) {
+    return path.join(cwd, REL_DIR, FILE);
+}
+export function memoryExists(cwd = process.cwd()) {
+    return fs.existsSync(memoryPath(cwd));
+}
+export function loadMemory(cwd = process.cwd()) {
+    const p = memoryPath(cwd);
+    if (!fs.existsSync(p))
+        return '';
+    try {
+        return fs.readFileSync(p, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+export function memoryForPrompt(cwd = process.cwd()) {
+    const raw = loadMemory(cwd);
+    if (!raw.trim())
+        return '';
+    if (Buffer.byteLength(raw, 'utf8') <= MAX_INJECT_BYTES)
+        return raw;
+    return raw.slice(0, MAX_INJECT_BYTES) +
+        '\n\n[...memory truncated by BLYUE to fit context...]\n';
+}
+export function saveMemory(text, cwd = process.cwd()) {
+    const p = memoryPath(cwd);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, text, 'utf8');
+    return p;
+}
+export function appendMemory(text, section = 'Notes', cwd = process.cwd()) {
+    const clean = text.trim().replace(/\n+/g, ' ');
+    if (!clean)
+        return loadMemory(cwd);
+    const existing = loadMemory(cwd);
+    const bullet = `- ${clean}`;
+    const header = `## ${section}`;
+    const headerRe = new RegExp(`^${header.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*$`, 'm');
+    let next;
+    if (!existing.trim()) {
+        next = `# Project memory\n\n${header}\n${bullet}\n`;
+    }
+    else if (headerRe.test(existing)) {
+        next = existing.replace(headerRe, `${header}\n${bullet}`);
+    }
+    else {
+        next = existing.trimEnd() + `\n\n${header}\n${bullet}\n`;
+    }
+    saveMemory(next, cwd);
+    return next;
+}
+export function clearMemory(cwd = process.cwd()) {
+    const p = memoryPath(cwd);
+    if (fs.existsSync(p))
+        fs.unlinkSync(p);
+}

package/dist/core/tools.js

@@ -6,6 +6,7 @@ import { tmpdir } from 'os';
 import { join } from 'path';
 import { hasN8n } from './config.js';
 import { getMcpToolDefsSync, executeMcpTool, isMcpTool } from './mcpRegistry.js';
+import { appendMemory } from './memory.js';
 import { permissions } from './permission.js';
 import { lineDiff, compactDiff } from './diff.js';
 import { isBlocked } from './sandbox.js';
@@ -77,6 +78,27 @@ const BASE_TOOLS = [
             },
         },
     },
+    {
+        type: 'function',
+        function: {
+            name: 'remember',
+            description: 'Append a note to this project\'s persistent memory (.blyue/MEMORY.md). ' +
+                'Use when the user says "remember X", or when you discover a durable fact ' +
+                'about the project (conventions, file layout, gotchas) worth persisting ' +
+                'across sessions. Do not use for transient task state.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    text: { type: 'string', description: 'The note to remember (one line).' },
+                    section: {
+                        type: 'string',
+                        description: 'Optional section heading (e.g. "Conventions", "Gotchas", "Notes"). Defaults to "Notes".',
+                    },
+                },
+                required: ['text'],
+            },
+        },
+    },
 ];
 const N8N_TOOLS = [
     { type: 'function', function: { name: 'n8n_list_workflows', description: 'List n8n workflows', parameters: { type: 'object', properties: {} } } },
@@ -212,6 +234,14 @@ export async function executeTool(name, args) {
                 const entries = await fs.readdir(dir, { withFileTypes: true });
                 return entries.map((e) => (e.isDirectory() ? e.name + '/' : e.name)).join('\n');
             }
+            case 'remember': {
+                const text = String(args.text || '').trim();
+                if (!text)
+                    return 'Error: remember needs a non-empty text.';
+                const section = String(args.section || 'Notes').trim() || 'Notes';
+                appendMemory(text, section);
+                return 'Remembered (' + section + '): ' + text;
+            }
             case 'run_command': {
                 const cmd = args.command;
                 if (!permissions.isAlwaysAllowed('run_command')) {

package/dist/ui/Chat.js

@@ -21,6 +21,8 @@ import { getConfig, saveConfig, applyConfig } from '../core/config.js';
 import { recordModelUse } from '../core/modelUsage.js';
 import { SkillsPanel } from './SkillsPanel.js';
 import { SkillStorePanel } from './SkillStorePanel.js';
+import { MemoryPanel } from './MemoryPanel.js';
+import { appendMemory } from '../core/memory.js';
 import { listSkills, findSkill, matchSkills, ensureSkillsDir, } from '../core/skills.js';
 let nextId = 0;
 const mkItem = (kind, text) => ({ kind, text, id: nextId++ });
@@ -110,6 +112,8 @@ export const Chat = ({ resumedCount = 0 }) => {
             setOverlay('settings');
         if (key.ctrl && inputChar === 'k')
             setOverlay('skillstore');
+        if (key.ctrl && inputChar === 'y')
+            setOverlay('memory');
     });
     useEffect(() => { try {
         ensureSkillsDir();
@@ -140,6 +144,40 @@ export const Chat = ({ resumedCount = 0 }) => {
             setOverlay('mcp');
             return;
         }
+        if (trimmed.startsWith('/remember ')) {
+            setInput('');
+            const text = trimmed.slice(10).trim();
+            if (!text) {
+                setHistory((h) => [
+                    ...h,
+                    mkItem('error', 'usage: /remember <text> [| section]'),
+                ]);
+                return;
+            }
+            let section = 'Notes';
+            let note = text;
+            const pipe = text.indexOf('|');
+            if (pipe > 0) {
+                note = text.slice(0, pipe).trim();
+                section = text.slice(pipe + 1).trim() || 'Notes';
+            }
+            try {
+                appendMemory(note, section);
+                setHistory((h) => [
+                    ...h,
+                    mkItem('tool', 'remembered (' + section + '): ' + note),
+                ]);
+            }
+            catch (e) {
+                setHistory((h) => [...h, mkItem('error', e?.message || String(e))]);
+            }
+            return;
+        }
+        if (trimmed === '/memory') {
+            setInput('');
+            setOverlay('memory');
+            return;
+        }
         if (trimmed === '/skillstore') {
             setInput('');
             setOverlay('skillstore');
@@ -218,6 +256,8 @@ export const Chat = ({ resumedCount = 0 }) => {
                 mkItem('tool', '  /mcp       show MCP servers and tools'),
                 mkItem('tool', '  /skills    list skills'),
                 mkItem('tool', '  /skillstore browse and install community skills'),
+                mkItem('tool', '  /memory    view this project\'s persistent memory'),
+                mkItem('tool', '  /remember <text> [| section]  append a note to memory'),
                 mkItem('tool', '  /skill <n> force-activate a skill for next msg'),
                 mkItem('tool', '  /compact   summarize history to free context'),
                 mkItem('tool', '  /debug     show last request to provider'),
@@ -313,6 +353,9 @@ export const Chat = ({ resumedCount = 0 }) => {
     if (overlay === 'mcp') {
         return (_jsx(Box, { flexDirection: "column", children: _jsx(McpPanel, { onClose: () => setOverlay('none') }) }));
     }
+    if (overlay === 'memory') {
+        return (_jsx(Box, { flexDirection: "column", children: _jsx(MemoryPanel, { onClose: () => setOverlay('none') }) }));
+    }
     if (overlay === 'skillstore') {
         return (_jsx(Box, { flexDirection: "column", children: _jsx(SkillStorePanel, { onClose: () => setOverlay('none') }) }));
     }

package/dist/ui/MemoryPanel.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text, useInput, useStdout } from 'ink';
+import { loadMemory, memoryPath, clearMemory } from '../core/memory.js';
+import { theme } from './theme.js';
+export const MemoryPanel = ({ onClose, onChanged }) => {
+    const { stdout } = useStdout();
+    const width = Math.max(40, stdout?.columns ?? 60);
+    const inner = width - 4;
+    const [content, setContent] = useState(() => loadMemory());
+    const [confirmClear, setConfirmClear] = useState(false);
+    const [status, setStatus] = useState(null);
+    useInput((input, key) => {
+        if (confirmClear) {
+            if (input === 'y' || input === 'Y') {
+                clearMemory();
+                setContent('');
+                setConfirmClear(false);
+                setStatus('✓ memory cleared');
+                onChanged?.();
+            }
+            else if (input === 'n' || input === 'N' || key.escape) {
+                setConfirmClear(false);
+            }
+            return;
+        }
+        if (key.escape)
+            return onClose();
+        if (input === 'r' || input === 'R') {
+            setContent(loadMemory());
+            setStatus('refreshed');
+            setTimeout(() => setStatus(null), 1500);
+        }
+        if (input === 'c' || input === 'C') {
+            setConfirmClear(true);
+        }
+    });
+    const label = 'project memory';
+    const topPad = Math.max(1, inner - label.length - 4);
+    const path = memoryPath();
+    const pathShort = path.length > inner - 4 ? '…' + path.slice(-(inner - 5)) : path;
+    const lines = content ? content.split('\n') : [];
+    const maxShow = 20;
+    const shown = lines.slice(0, maxShow);
+    const truncated = lines.length > maxShow;
+    const bytes = Buffer.byteLength(content, 'utf8');
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: '╭─ ' }), _jsx(Text, { color: theme.accent, bold: true, children: label }), _jsx(Text, { color: theme.muted, children: ' ' + '─'.repeat(topPad) + '╮' })] }), _jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: '│ ' }), _jsx(Text, { color: theme.muted, children: pathShort })] }), _jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: '│ ' }), _jsxs(Text, { color: theme.muted, children: [bytes, " bytes \u00B7 ", lines.length, " line", lines.length === 1 ? '' : 's'] }), status && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.muted, children: " \u00B7 " }), _jsx(Text, { color: theme.success, children: status })] }))] }), _jsx(Text, { color: theme.muted, children: '│ ' + '─'.repeat(Math.max(1, inner - 2)) }), !content.trim() ? (_jsxs(_Fragment, { children: [_jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: '│ ' }), _jsx(Text, { color: theme.warning, children: "memory is empty" })] }), _jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: '│ ' }), _jsx(Text, { color: theme.muted, children: "the agent will add notes when you say \"remember ...\"" })] })] })) : (shown.map((line, i) => (_jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: '│ ' }), _jsx(Text, { color: line.startsWith('#')
+                            ? theme.accent
+                            : line.startsWith('-')
+                                ? theme.text
+                                : theme.muted, bold: line.startsWith('#'), children: line.slice(0, inner - 2) })] }, i)))), truncated && (_jsx(Text, { children: _jsx(Text, { color: theme.muted, children: '│ …+' + (lines.length - maxShow) + ' more lines' }) })), _jsx(Text, { color: theme.muted, children: '╰' + '─'.repeat(inner) + '╯' }), confirmClear ? (_jsxs(Text, { children: [_jsx(Text, { color: theme.warning, children: "  clear all project memory? " }), _jsx(Text, { color: theme.success, bold: true, children: "[y]" }), _jsx(Text, { color: theme.muted, children: " yes  " }), _jsx(Text, { color: theme.error, bold: true, children: "[n]" }), _jsx(Text, { color: theme.muted, children: " no" })] })) : (_jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: "  [" }), _jsx(Text, { color: theme.accent, children: "r" }), _jsx(Text, { color: theme.muted, children: "] refresh \u00B7 [" }), _jsx(Text, { color: theme.accent, children: "c" }), _jsx(Text, { color: theme.muted, children: "] clear \u00B7 [" }), _jsx(Text, { color: theme.accent, children: "esc" }), _jsx(Text, { color: theme.muted, children: "] close" })] }))] }));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blyuecode",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "BLYUE Code — a coding agent by Lumen",
   "type": "module",
   "license": "MIT",