@crewx/memory 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# @crewx/memory
+
+Memory engine for CrewX - markdown + frontmatter based long-term memory.
+
+```bash
+npx memory index <agent_id>
+```

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,365 @@
+#!/usr/bin/env node
+"use strict";
+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 });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const engine_1 = require("./src/engine");
+const types_1 = require("./src/types");
+const mindmap_1 = require("./src/mindmap");
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        process.stdin.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+        process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8').trim()));
+        process.stdin.on('error', reject);
+    });
+}
+function loadTracer() {
+    const candidates = [
+        path.join(__dirname, '../../../../skills/lib/skill-tracer.js'),
+        path.join(__dirname, '../../../skills/lib/skill-tracer.js'),
+    ];
+    for (const p of candidates) {
+        try {
+            if (fs.existsSync(p))
+                return require(p);
+        }
+        catch { }
+    }
+    return null;
+}
+function showSkillHelp() {
+    const skillMd = path.join(__dirname, '..', 'SKILL.md');
+    if (fs.existsSync(skillMd)) {
+        process.stdout.write(fs.readFileSync(skillMd, 'utf-8'));
+    }
+    else {
+        console.log('No SKILL.md found. Use --help for usage.');
+    }
+}
+function printUsage() {
+    console.log('@crewx/memory - Agent memory management CLI\n');
+    console.log('Usage: npx memory <command> <agent_id> [args]\n');
+    console.log('Commands:');
+    console.log('  save <summary> [category]   새 기억 저장');
+    console.log('    예: npx memory save myagent "API 설계 결정" decision --tags=api,backend');
+    console.log('  index                        전체 인덱스 보기');
+    console.log('    예: npx memory index myagent');
+    console.log('  list [--category=...] [--tag=...] [--sort=date]  구조적 필터링');
+    console.log('    예: npx memory list myagent --category=backlog --tag=status:pending');
+    console.log('  stats                        카테고리/태그 통계');
+    console.log('    예: npx memory stats myagent');
+    console.log('  tags [tag_name]              전체 태그 목록 또는 특정 태그 필터');
+    console.log('    예: npx memory tags myagent');
+    console.log('    예: npx memory tags myagent api');
+    console.log('  recent (alias: ls)           최근 N일 기억');
+    console.log('    예: npx memory recent myagent 7');
+    console.log('  find <keyword>               키워드 검색 (빠름)');
+    console.log('    예: npx memory find myagent "API"');
+    console.log('  search <query>               AI 시멘틱 검색 (@memory_searcher 에이전트)');
+    console.log('    예: npx memory search myagent "인증 관련 결정 사항"');
+    console.log('  get (alias: read) <id>       기억 상세 조회');
+    console.log('    예: npx memory get myagent PWN3qt');
+    console.log('  update <id> [--summary=...] [--body=...]  기억 수정');
+    console.log('    예: npx memory update myagent PWN3qt --tags=api,v2');
+    console.log('  delete (alias: rm) <id> [--force]  기억 삭제');
+    console.log('    예: npx memory delete myagent PWN3qt --force');
+    console.log('  merge <id1> <id2>            두 기억 병합');
+    console.log('    예: npx memory merge myagent id1 id2 --summary="병합 요약"');
+    console.log('  summarize [--force]          summary.md 생성/갱신');
+    console.log('  summarize-dirty              dirty summary만 갱신');
+    console.log('  mindmap <sub> [agent_id]     기억 연결 그래프 (build/show/related/add/remove/html/open)');
+    console.log('    예: npx memory mindmap build myagent');
+    console.log('');
+    console.log('Other:');
+    console.log('  help                         SKILL.md 출력');
+    console.log('  --help, -h                   이 도움말 출력');
+}
+const ALIASES = {
+    read: 'get',
+    rm: 'delete',
+    ls: 'recent',
+};
+const BOOLEAN_FLAGS = new Set([
+    'help', 'force', 'verbose', 'full', 'important', 'no-important', 'json', 'all',
+]);
+function parseArgs(args) {
+    const result = { positional: [], options: {} };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '-h') {
+            result.options['help'] = true;
+        }
+        else if (arg.startsWith('--')) {
+            const eqIdx = arg.indexOf('=');
+            if (eqIdx !== -1) {
+                const key = arg.slice(2, eqIdx);
+                const value = arg.slice(eqIdx + 1);
+                result.options[key] = value;
+            }
+            else {
+                const key = arg.slice(2);
+                if (!BOOLEAN_FLAGS.has(key)) {
+                    const nextArg = args[i + 1];
+                    if (nextArg !== undefined && !nextArg.startsWith('--') && nextArg !== '-h') {
+                        result.options[key] = nextArg;
+                        i++;
+                    }
+                    else {
+                        result.options[key] = true;
+                    }
+                }
+                else {
+                    result.options[key] = true;
+                }
+            }
+        }
+        else {
+            result.positional.push(arg);
+        }
+    }
+    return result;
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const { positional, options } = parseArgs(args);
+    const [command, agentId, ...rest] = positional;
+    if (options.help) {
+        printUsage();
+        return;
+    }
+    if (command === 'help') {
+        showSkillHelp();
+        return;
+    }
+    if (!command) {
+        printUsage();
+        return;
+    }
+    const resolvedCommand = ALIASES[command] ?? command;
+    if (resolvedCommand === 'mindmap') {
+        const dataDir = process.env['MEMORY_DATA_DIR'] ?? path.resolve(process.cwd(), 'memory');
+        const mindmap = new mindmap_1.MindmapEngine(dataDir);
+        const subcommand = agentId;
+        const mAgentId = rest[0];
+        const mRest = rest.slice(1);
+        if (!subcommand) {
+            console.log('Usage: npx memory mindmap <subcommand> [agent_id] [args]');
+            console.log('');
+            console.log('Subcommands:');
+            console.log('  build <agent_id>                                        - 그래프 빌드');
+            console.log('  show <agent_id> [--period=stm|mtm|ltm] [--format=mermaid|text] - 그래프 요약');
+            console.log('  related <agent_id> <memory_id>                          - 연결된 기억 조회');
+            console.log('  add <agent_id> <from_id> <to_id> [type]                - 수동 연결 추가');
+            console.log('  remove <agent_id> <from_id> <to_id>                    - 연결 제거');
+            console.log('  html                                                    - 공용 HTML 생성');
+            console.log('  open [agent_id]                                         - 브라우저에서 열기');
+            process.exit(1);
+        }
+        switch (subcommand) {
+            case 'build':
+                if (!mAgentId) {
+                    console.log('Error: agent_id is required');
+                    process.exit(1);
+                }
+                mindmap.build(mAgentId, options);
+                break;
+            case 'show':
+                if (!mAgentId) {
+                    console.log('Error: agent_id is required');
+                    process.exit(1);
+                }
+                mindmap.show(mAgentId, { period: options.period, format: options.format });
+                break;
+            case 'related':
+                if (!mAgentId || !mRest?.[0]) {
+                    console.log('Error: agent_id and memory_id are required');
+                    process.exit(1);
+                }
+                mindmap.related(mAgentId, mRest[0]);
+                break;
+            case 'add':
+                if (!mAgentId || !mRest?.[0] || !mRest?.[1]) {
+                    console.log('Error: agent_id, from_id and to_id are required');
+                    process.exit(1);
+                }
+                mindmap.add(mAgentId, mRest[0], mRest[1], mRest[2]);
+                break;
+            case 'remove':
+                if (!mAgentId || !mRest?.[0] || !mRest?.[1]) {
+                    console.log('Error: agent_id, from_id and to_id are required');
+                    process.exit(1);
+                }
+                mindmap.remove(mAgentId, mRest[0], mRest[1]);
+                break;
+            case 'html':
+                mindmap.html();
+                break;
+            case 'open':
+                mindmap.open(mAgentId);
+                break;
+            default:
+                console.log(`Unknown mindmap subcommand: ${subcommand}`);
+                process.exit(1);
+        }
+        return;
+    }
+    const engine = new engine_1.MemoryEngine();
+    if (resolvedCommand === 'summarize-dirty') {
+        engine.summarizeDirty();
+        return;
+    }
+    if (!agentId) {
+        console.log('Error: agent_id is required');
+        process.exit(1);
+    }
+    switch (resolvedCommand) {
+        case 'save': {
+            const summary = rest[0];
+            if (!summary) {
+                console.log('Error: summary is required');
+                process.exit(1);
+            }
+            let category;
+            if (rest[1] && types_1.CATEGORIES.includes(rest[1])) {
+                category = rest[1];
+            }
+            else {
+                category = 'general';
+                if (rest[1] && !options.tags) {
+                    options.tags = rest[1];
+                }
+            }
+            if (rest[2] && !options.body) {
+                options.body = rest[2];
+            }
+            if (!options.body && !process.stdin.isTTY) {
+                const stdinBody = await Promise.race([
+                    readStdin(),
+                    new Promise((resolve) => setTimeout(() => resolve(''), 100)),
+                ]);
+                if (stdinBody) {
+                    options.body = stdinBody;
+                }
+            }
+            engine.save(agentId, summary, category, options);
+            break;
+        }
+        case 'index':
+            engine.index(agentId, options);
+            break;
+        case 'list':
+            engine.list(agentId, options);
+            break;
+        case 'stats':
+            engine.stats(agentId);
+            break;
+        case 'tags':
+            if (rest[0]) {
+                engine.topic(agentId, rest[0]);
+            }
+            else {
+                engine.tags(agentId);
+            }
+            break;
+        case 'recent':
+            engine.recent(agentId, parseInt(rest[0] ?? '', 10) || 30);
+            break;
+        case 'find':
+            if (!rest[0]) {
+                console.log('Error: keyword is required');
+                process.exit(1);
+            }
+            engine.find(agentId, rest[0]);
+            break;
+        case 'get':
+            if (!rest[0]) {
+                console.log('Error: memory_id is required');
+                process.exit(1);
+            }
+            engine.get(agentId, rest[0]);
+            break;
+        case 'search':
+            if (!rest[0]) {
+                console.log('Error: query is required');
+                process.exit(1);
+            }
+            engine.search(agentId, rest.join(' '));
+            break;
+        case 'update':
+            if (!rest[0]) {
+                console.log('Error: memory_id is required');
+                process.exit(1);
+            }
+            engine.update(agentId, rest[0], options);
+            break;
+        case 'delete':
+            if (!rest[0]) {
+                console.log('Error: memory_id is required');
+                process.exit(1);
+            }
+            engine.delete(agentId, rest[0], options);
+            break;
+        case 'merge':
+            if (!rest[0] || !rest[1]) {
+                console.log('Error: two memory_ids are required');
+                console.log('Usage: node cli.ts merge <agent_id> <id1> <id2> [--summary="병합 요약"]');
+                process.exit(1);
+            }
+            engine.merge(agentId, rest[0], rest[1], options);
+            break;
+        case 'summarize':
+            engine.summarize(agentId, options);
+            break;
+        default:
+            console.log(`Unknown command: ${command}`);
+            process.exit(1);
+    }
+}
+const tracer = loadTracer();
+if (tracer) {
+    tracer.run('crewx/memory', () => main()).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+    });
+}
+else {
+    main().catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/src/engine.d.ts

@@ -0,0 +1,43 @@
+import { MemoryEntry, SaveOptions, IndexOptions, ListOptions, UpdateOptions, DeleteOptions, MergeOptions, SummarizeOptions, SummaryResult, MemoryEngineConfig } from './types';
+export declare class MemoryEngine {
+    private readonly dataDir;
+    private readonly summaryDays;
+    private readonly recentDays;
+    private readonly shortTermHours;
+    constructor(config?: MemoryEngineConfig);
+    private getAgentDir;
+    private getEntriesDir;
+    private getSummaryPath;
+    private getDirtySummaryPath;
+    private ensureDir;
+    private generateId;
+    private getToday;
+    private getLocalISO8601;
+    private getPrimaryTag;
+    private toEntryTimestamp;
+    private markSummaryDirty;
+    loadAllEntries(agentId: string): MemoryEntry[];
+    private findEntryById;
+    save(agentId: string, summary: string, category?: string, options?: SaveOptions): void;
+    index(agentId: string, options?: IndexOptions): void;
+    private generateIndexContent;
+    topic(agentId: string, topicName: string): void;
+    recent(agentId: string, days?: number): void;
+    find(agentId: string, keyword: string): void;
+    list(agentId: string, options?: ListOptions): void;
+    stats(agentId: string): void;
+    tags(agentId: string): void;
+    get(agentId: string, memoryId: string): void;
+    update(agentId: string, memoryId: string, options?: UpdateOptions): void;
+    delete(agentId: string, memoryId: string, options?: DeleteOptions): void;
+    merge(agentId: string, memoryId1: string, memoryId2: string, options?: MergeOptions): void;
+    private buildFallbackSummary;
+    private callSummarizer;
+    generateSummary(agentId: string, options?: SummarizeOptions): SummaryResult;
+    summarize(agentId: string, options?: SummarizeOptions): void;
+    summarizeDirty(): void;
+    search(agentId: string, query: string): void;
+}
+export declare function createMemoryEngine(config?: MemoryEngineConfig): MemoryEngine;
+export { CATEGORIES, MemoryCategory } from './types';
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine.ts"],"names":[],"mappings":"AAqEA,OAAO,EAGL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,aAAa,EAEb,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,GAAE,kBAAuB;IAoB3C,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,gBAAgB;IAOxB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAwB9C,OAAO,CAAC,aAAa;IAyBrB,IAAI,CACF,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAkB,EAC5B,OAAO,GAAE,WAAgB,GACxB,IAAI;IAkDP,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IA6GxD,OAAO,CAAC,oBAAoB;IAkD5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAmB/C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,IAAI;IAwBhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAoD5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI;IAwCtD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAiD5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA4B3B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA6E5C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IA2C5E,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IA6B5E,KAAK,CACH,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,YAAiB,GACzB,IAAI;IAiEP,OAAO,CAAC,oBAAoB;IA+B5B,OAAO,CAAC,cAAc;IAqBtB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,aAAa;IA+H/E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI;IAsBhE,cAAc,IAAI,IAAI;IA6CtB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAqC7C;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E;AAGD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}