openhorse 0.1.5

package/dist/memory/storage.d.ts

@@ -0,0 +1,79 @@
+/**
+ * openhorse - Memory Storage
+ *
+ * File-based memory system stored in ~/.openhorse/projects/<hash>/memory/
+ * - MEMORY.md: Index file (one-line hooks)
+ * - *.md: Individual memory entries with frontmatter
+ *
+ * Memory is project-scoped: each project has its own memory directory.
+ */
+import type { MemoryEntry, MemoryType } from './types';
+export type { MemoryEntry, MemoryType } from './types';
+export declare const PROJECTS_SUBDIR = "projects";
+export declare const MEMORY_SUBDIR = "memory";
+export declare const ENTRYPOINT_NAME = "MEMORY.md";
+export declare const MAX_ENTRYPOINT_LINES = 200;
+export declare const MAX_ENTRYPOINT_BYTES = 25000;
+/**
+ * Convert project path to a hash for directory naming.
+ * Uses SHA256 truncated to 16 characters for shorter paths.
+ */
+export declare function getProjectHash(projectPath: string): string;
+/**
+ * Get memory directory path for a specific project.
+ * @param projectPath - Project path (defaults to current working directory)
+ *
+ * Note: when `projectPath` is omitted we fall back to the legacy v0.1.2
+ * global memory directory. This branch is preserved for backwards
+ * compatibility with existing config homes; new code should always pass a
+ * `projectPath`. The fallback is slated for removal once a migration tool
+ * lands (tracked in v0.1.4-plus roadmap Part 10).
+ */
+export declare function getMemoryDir(projectPath?: string): string;
+/**
+ * Get MEMORY.md path for a project.
+ */
+export declare function getEntrypointPath(projectPath?: string): string;
+/**
+ * Ensure memory directory exists for a project.
+ */
+export declare function ensureMemoryDir(projectPath?: string): string;
+/** Parse frontmatter from memory file */
+export declare function parseMemoryFrontmatter(content: string): MemoryEntry | null;
+/** Generate frontmatter for memory file */
+export declare function generateMemoryFrontmatter(entry: MemoryEntry): string;
+/**
+ * Load all memory entries from a project's memory directory.
+ * @param projectPath - Project path (defaults to cwd)
+ */
+export declare function loadAllMemories(projectPath?: string): MemoryEntry[];
+/**
+ * Load MEMORY.md index for a project.
+ */
+export declare function loadMemoryIndex(projectPath?: string): string;
+/**
+ * Load specific memory by name from a project.
+ */
+export declare function loadMemory(name: string, projectPath?: string): MemoryEntry | null;
+/**
+ * Save memory entry to a project's memory directory.
+ */
+export declare function saveMemory(entry: MemoryEntry, projectPath?: string): void;
+/**
+ * Delete memory entry from a project.
+ * Hard-deletes the file so `memory_recall` no longer returns it.
+ */
+export declare function deleteMemory(name: string, projectPath?: string): void;
+/**
+ * Update MEMORY.md index for a project.
+ */
+export declare function updateMemoryIndex(projectPath?: string): void;
+/**
+ * Search memories by query in a project.
+ */
+export declare function searchMemories(query: string, projectPath?: string): MemoryEntry[];
+/**
+ * Get memories by type from a project.
+ */
+export declare function getMemoriesByType(type: MemoryType, projectPath?: string): MemoryEntry[];
+//# sourceMappingURL=storage.d.ts.map

package/dist/memory/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/memory/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKvD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMvD,eAAO,MAAM,eAAe,aAAa,CAAC;AAC1C,eAAO,MAAM,aAAa,WAAW,CAAC;AACtC,eAAO,MAAM,eAAe,cAAc,CAAC;AAC3C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAM1C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAMD,yCAAyC;AACzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4B1E;AAED,2CAA2C;AAC3C,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQpE;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CA0BnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAkBjF;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAczE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAarE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAkC5D;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAYjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAGvF"}

package/dist/memory/storage.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * openhorse - Memory Storage
+ *
+ * File-based memory system stored in ~/.openhorse/projects/<hash>/memory/
+ * - MEMORY.md: Index file (one-line hooks)
+ * - *.md: Individual memory entries with frontmatter
+ *
+ * Memory is project-scoped: each project has its own memory directory.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_ENTRYPOINT_BYTES = exports.MAX_ENTRYPOINT_LINES = exports.ENTRYPOINT_NAME = exports.MEMORY_SUBDIR = exports.PROJECTS_SUBDIR = void 0;
+exports.getProjectHash = getProjectHash;
+exports.getMemoryDir = getMemoryDir;
+exports.getEntrypointPath = getEntrypointPath;
+exports.ensureMemoryDir = ensureMemoryDir;
+exports.parseMemoryFrontmatter = parseMemoryFrontmatter;
+exports.generateMemoryFrontmatter = generateMemoryFrontmatter;
+exports.loadAllMemories = loadAllMemories;
+exports.loadMemoryIndex = loadMemoryIndex;
+exports.loadMemory = loadMemory;
+exports.saveMemory = saveMemory;
+exports.deleteMemory = deleteMemory;
+exports.updateMemoryIndex = updateMemoryIndex;
+exports.searchMemories = searchMemories;
+exports.getMemoriesByType = getMemoriesByType;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+const config_dir_1 = require("../services/config-dir");
+const atomic_write_1 = require("../services/atomic-write");
+// ============================================================================
+// Constants
+// ============================================================================
+exports.PROJECTS_SUBDIR = 'projects';
+exports.MEMORY_SUBDIR = 'memory';
+exports.ENTRYPOINT_NAME = 'MEMORY.md';
+exports.MAX_ENTRYPOINT_LINES = 200;
+exports.MAX_ENTRYPOINT_BYTES = 25000;
+// ============================================================================
+// Project Path Hash
+// ============================================================================
+/**
+ * Convert project path to a hash for directory naming.
+ * Uses SHA256 truncated to 16 characters for shorter paths.
+ */
+function getProjectHash(projectPath) {
+    return (0, crypto_1.createHash)('sha256').update(projectPath).digest('hex').slice(0, 16);
+}
+// ============================================================================
+// Paths
+// ============================================================================
+/**
+ * Get memory directory path for a specific project.
+ * @param projectPath - Project path (defaults to current working directory)
+ *
+ * Note: when `projectPath` is omitted we fall back to the legacy v0.1.2
+ * global memory directory. This branch is preserved for backwards
+ * compatibility with existing config homes; new code should always pass a
+ * `projectPath`. The fallback is slated for removal once a migration tool
+ * lands (tracked in v0.1.4-plus roadmap Part 10).
+ */
+function getMemoryDir(projectPath) {
+    const configHome = (0, config_dir_1.getConfigHome)();
+    if (projectPath) {
+        const hash = getProjectHash(projectPath);
+        return (0, path_1.join)(configHome, exports.PROJECTS_SUBDIR, hash, exports.MEMORY_SUBDIR);
+    }
+    return (0, path_1.join)(configHome, exports.MEMORY_SUBDIR);
+}
+/**
+ * Get MEMORY.md path for a project.
+ */
+function getEntrypointPath(projectPath) {
+    return (0, path_1.join)(getMemoryDir(projectPath), exports.ENTRYPOINT_NAME);
+}
+/**
+ * Ensure memory directory exists for a project.
+ */
+function ensureMemoryDir(projectPath) {
+    const dir = getMemoryDir(projectPath);
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    return dir;
+}
+// ============================================================================
+// Parsing
+// ============================================================================
+/** Parse frontmatter from memory file */
+function parseMemoryFrontmatter(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch)
+        return null;
+    const [, frontmatter, body] = frontmatterMatch;
+    const lines = frontmatter.split('\n');
+    const fields = {};
+    for (const line of lines) {
+        const match = line.match(/^(\w+):\s*(.*)$/);
+        if (match) {
+            fields[match[1]] = match[2].trim();
+        }
+    }
+    if (!fields.name || !fields.type)
+        return null;
+    const type = fields.type;
+    if (!['user', 'feedback', 'project', 'reference'].includes(type))
+        return null;
+    return {
+        name: fields.name,
+        description: fields.description || '',
+        type,
+        content: body.trim(),
+        createdAt: 0, // Will be set from file
+        updatedAt: 0,
+    };
+}
+/** Generate frontmatter for memory file */
+function generateMemoryFrontmatter(entry) {
+    return `---
+name: ${entry.name}
+description: ${entry.description}
+type: ${entry.type}
+---
+
+${entry.content}`;
+}
+// ============================================================================
+// Loading
+// ============================================================================
+/**
+ * Load all memory entries from a project's memory directory.
+ * @param projectPath - Project path (defaults to cwd)
+ */
+function loadAllMemories(projectPath) {
+    const dir = ensureMemoryDir(projectPath);
+    const memories = [];
+    try {
+        const files = (0, fs_1.readdirSync)(dir);
+        for (const file of files) {
+            if (!file.endsWith('.md') || file === exports.ENTRYPOINT_NAME)
+                continue;
+            const filePath = (0, path_1.join)(dir, file);
+            try {
+                const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+                const entry = parseMemoryFrontmatter(content);
+                if (entry) {
+                    entry.name = (0, path_1.basename)(file, '.md');
+                    memories.push(entry);
+                }
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or unreadable
+    }
+    return memories;
+}
+/**
+ * Load MEMORY.md index for a project.
+ */
+function loadMemoryIndex(projectPath) {
+    const path = getEntrypointPath(projectPath);
+    if (!(0, fs_1.existsSync)(path))
+        return '';
+    return (0, fs_1.readFileSync)(path, 'utf-8');
+}
+/**
+ * Load specific memory by name from a project.
+ */
+function loadMemory(name, projectPath) {
+    const dir = getMemoryDir(projectPath);
+    const filePath = (0, path_1.join)(dir, `${name}.md`);
+    if (!(0, fs_1.existsSync)(filePath))
+        return null;
+    try {
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        const entry = parseMemoryFrontmatter(content);
+        if (entry) {
+            entry.name = name;
+            return entry;
+        }
+    }
+    catch {
+        // File unreadable
+    }
+    return null;
+}
+// ============================================================================
+// Saving
+// ============================================================================
+/**
+ * Save memory entry to a project's memory directory.
+ */
+function saveMemory(entry, projectPath) {
+    ensureMemoryDir(projectPath);
+    const dir = getMemoryDir(projectPath);
+    const filePath = (0, path_1.join)(dir, `${entry.name}.md`);
+    const now = Date.now();
+    entry.createdAt = entry.createdAt || now;
+    entry.updatedAt = now;
+    const content = generateMemoryFrontmatter(entry);
+    (0, atomic_write_1.atomicWriteFileSync)(filePath, content);
+    // Update MEMORY.md index
+    updateMemoryIndex(projectPath);
+}
+/**
+ * Delete memory entry from a project.
+ * Hard-deletes the file so `memory_recall` no longer returns it.
+ */
+function deleteMemory(name, projectPath) {
+    const dir = getMemoryDir(projectPath);
+    const filePath = (0, path_1.join)(dir, `${name}.md`);
+    if ((0, fs_1.existsSync)(filePath)) {
+        try {
+            (0, fs_1.unlinkSync)(filePath);
+        }
+        catch {
+            // ignore — index regeneration below will reflect whatever is on disk
+        }
+    }
+    updateMemoryIndex(projectPath);
+}
+/**
+ * Update MEMORY.md index for a project.
+ */
+function updateMemoryIndex(projectPath) {
+    const memories = loadAllMemories(projectPath);
+    const lines = [
+        '# Memory Index',
+        '',
+        'This file lists all saved memories. Each entry is one line under ~150 characters.',
+        '',
+    ];
+    for (const mem of memories) {
+        const hook = mem.description || mem.content.slice(0, 80);
+        const line = `- [${mem.name}](${mem.name}.md) — ${hook}`;
+        if (line.length <= 150) {
+            lines.push(line);
+        }
+        else {
+            lines.push(line.slice(0, 147) + '...');
+        }
+    }
+    // Truncate if exceeds limits
+    if (lines.length > exports.MAX_ENTRYPOINT_LINES) {
+        lines.splice(exports.MAX_ENTRYPOINT_LINES);
+        lines.push('', '> WARNING: MEMORY.md truncated. Keep index entries concise.');
+    }
+    const content = lines.join('\n');
+    if (content.length > exports.MAX_ENTRYPOINT_BYTES) {
+        // Truncate by removing oldest entries
+        while (content.length > exports.MAX_ENTRYPOINT_BYTES && lines.length > 10) {
+            lines.pop();
+        }
+    }
+    (0, atomic_write_1.atomicWriteFileSync)(getEntrypointPath(projectPath), lines.join('\n'));
+}
+// ============================================================================
+// Search
+// ============================================================================
+/**
+ * Search memories by query in a project.
+ */
+function searchMemories(query, projectPath) {
+    const memories = loadAllMemories(projectPath);
+    const lowerQuery = query.toLowerCase();
+    return memories.filter(mem => {
+        return (mem.name.toLowerCase().includes(lowerQuery) ||
+            mem.description.toLowerCase().includes(lowerQuery) ||
+            mem.content.toLowerCase().includes(lowerQuery) ||
+            mem.type.toLowerCase().includes(lowerQuery));
+    });
+}
+/**
+ * Get memories by type from a project.
+ */
+function getMemoriesByType(type, projectPath) {
+    const memories = loadAllMemories(projectPath);
+    return memories.filter(mem => mem.type === type);
+}
+//# sourceMappingURL=storage.js.map

package/dist/memory/storage.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,103 @@
+/**
+ * openhorse - 基础记忆系统（内存版）
+ *
+ * 提供三层记忆架构：
+ *   - 工作记忆 (Working): 当前上下文，容量小，LRU 淘汰
+ *   - 短期记忆 (Short-term): 最近历史，容量中等，自动晋升
+ *   - 长期记忆 (Long-term): 持久化存储，容量大，支持检索
+ *
+ * 所有数据保存在内存中，进程重启后丢失。
+ * 未来可扩展为文件/数据库后端。
+ */
+import { EventEmitter } from 'eventemitter3';
+/** 记忆条目 */
+export interface MemoryEntry {
+    /** 唯一标识 */
+    id: string;
+    /** 内容 */
+    content: unknown;
+    /** 创建时间戳 */
+    createdAt: number;
+    /** 最后访问时间戳 */
+    lastAccessedAt: number;
+    /** 访问次数 */
+    accessCount: number;
+    /** 标签 */
+    tags: string[];
+    /** 来源 Agent ID */
+    source?: string;
+}
+/** 记忆层级 */
+export type MemoryTier = 'working' | 'short-term' | 'long-term';
+/** 记忆配置 */
+export interface MemoryStoreConfig {
+    /** 工作记忆容量 */
+    workingCapacity: number;
+    /** 短期记忆容量 */
+    shortTermCapacity: number;
+    /** 短期记忆淘汰后是否自动晋升到长期 */
+    autoPromoteToLongTerm: boolean;
+    /** TTL - 工作记忆条目最大存活时间 (ms)，0 表示不限制 */
+    workingTTL: number;
+}
+/** 记忆查询选项 */
+export interface MemoryQuery {
+    /** 搜索关键词 */
+    query?: string;
+    /** 标签过滤 */
+    tags?: string[];
+    /** 来源过滤 */
+    source?: string;
+    /** 时间范围起点 */
+    after?: number;
+    /** 时间范围终点 */
+    before?: number;
+    /** 最大返回数 */
+    limit?: number;
+}
+export declare class MemoryStore extends EventEmitter {
+    private working;
+    private shortTerm;
+    private longTerm;
+    private config;
+    constructor(config?: Partial<MemoryStoreConfig>);
+    /** 写入工作记忆 */
+    pushWorking(content: unknown, options?: {
+        tags?: string[];
+        source?: string;
+    }): MemoryEntry;
+    /** 读取工作记忆 */
+    readWorking(): MemoryEntry[];
+    /** 清空工作记忆 */
+    clearWorking(): number;
+    /** 写入短期记忆 */
+    pushShortTerm(content: unknown, options?: {
+        tags?: string[];
+        source?: string;
+    }): MemoryEntry;
+    /** 读取短期记忆 */
+    readShortTerm(): MemoryEntry[];
+    /** 写入长期记忆 */
+    pushLongTerm(content: unknown, options?: {
+        tags?: string[];
+        source?: string;
+    }): MemoryEntry;
+    /** 按 ID 读取长期记忆 */
+    readLongTerm(id: string): MemoryEntry | undefined;
+    /** 按 ID 删除长期记忆 */
+    deleteLongTerm(id: string): boolean;
+    /** 搜索记忆（全层级） */
+    search(query: MemoryQuery, tier?: MemoryTier): MemoryEntry[];
+    /** 获取各层记忆数量 */
+    getStats(): Record<MemoryTier, number>;
+    /** 获取全部记忆条目 */
+    getAll(tier?: MemoryTier): MemoryEntry[];
+    /** 重置记忆系统 */
+    reset(): void;
+    private createEntry;
+    private evictWorking;
+    private expireWorking;
+    private promoteToShortTerm;
+    private touchAll;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/store.d.ts.map

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