@aiassesstech/mighty-mark 0.1.1 → 0.2.1

package/dist/memory/remediate.js

@@ -0,0 +1,143 @@
+/**
+ * Memory auto-remediation — patches openclaw.json with local embedding
+ * configuration and triggers re-indexing when memory search is broken.
+ *
+ * Follows Do No Harm: always creates a timestamped backup before patching.
+ */
+import fs from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { getConfigPath, exec } from '../checks/check-context.js';
+import { MEMORY_SEARCH_CONFIG, getDefaultMemoryDir } from './config.js';
+/**
+ * Patch openclaw.json with local embedding configuration.
+ * Creates a timestamped backup before modifying.
+ */
+export async function patchMemoryConfig(ctx) {
+    const configPath = getConfigPath(ctx);
+    if (!fs.existsSync(configPath)) {
+        return {
+            action: 'patch-config',
+            success: false,
+            message: `Config file not found: ${configPath}`,
+        };
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(raw);
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '').slice(0, 15);
+        const backupPath = `${configPath}.backup.${timestamp}`;
+        fs.writeFileSync(backupPath, raw, 'utf-8');
+        if (!config.agents)
+            config.agents = {};
+        if (!config.agents.defaults)
+            config.agents.defaults = {};
+        config.agents.defaults.memorySearch = MEMORY_SEARCH_CONFIG;
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        return {
+            action: 'patch-config',
+            success: true,
+            message: 'Patched openclaw.json with local embedding configuration',
+            backupPath,
+        };
+    }
+    catch (err) {
+        return {
+            action: 'patch-config',
+            success: false,
+            message: `Failed to patch config: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Trigger memory re-indexing via `openclaw memory status --deep --index`.
+ * Uses --deep --index instead of --force to avoid EBUSY on SQLite.
+ */
+export function triggerReindex(ctx) {
+    try {
+        exec('openclaw memory status --deep --index', ctx);
+        return {
+            action: 'trigger-reindex',
+            success: true,
+            message: 'Triggered memory re-indexing via --deep --index',
+        };
+    }
+    catch (err) {
+        return {
+            action: 'trigger-reindex',
+            success: false,
+            message: `Re-indexing failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/** Restart the OpenClaw gateway. */
+export function restartGateway(ctx) {
+    try {
+        exec('openclaw gateway restart', ctx);
+        return {
+            action: 'restart-gateway',
+            success: true,
+            message: 'Gateway restarted for embedding model reload',
+        };
+    }
+    catch (err) {
+        return {
+            action: 'restart-gateway',
+            success: false,
+            message: `Gateway restart failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Create missing agent memory directories based on fleet topology.
+ * Returns list of directories created.
+ */
+export async function createAgentMemoryDirs(topology, ctx) {
+    const memoryDir = ctx?.memoryDir ?? getDefaultMemoryDir();
+    const created = [];
+    try {
+        for (const agent of topology.agents) {
+            const subdirs = agent.memoryConfig?.subdirs ?? [];
+            for (const sub of subdirs) {
+                const dir = path.join(memoryDir, agent.id, sub);
+                if (!fs.existsSync(dir)) {
+                    await mkdir(dir, { recursive: true });
+                    created.push(`${agent.id}/${sub}`);
+                }
+            }
+        }
+        if (created.length === 0) {
+            return {
+                action: 'create-dirs',
+                success: true,
+                message: 'All agent memory directories already exist',
+            };
+        }
+        return {
+            action: 'create-dirs',
+            success: true,
+            message: `Created ${created.length} directories: ${created.join(', ')}`,
+        };
+    }
+    catch (err) {
+        return {
+            action: 'create-dirs',
+            success: false,
+            message: `Failed to create directories: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Check if node-llama-cpp native bindings are available.
+ * If missing, local embedding provider will fail even after config patching.
+ */
+export function checkNativeBindings(ctx) {
+    try {
+        const output = exec('pnpm list node-llama-cpp 2>/dev/null || echo "not-found"', ctx);
+        return !output.includes('not-found') && !output.includes('ERR');
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=remediate.js.map

package/dist/memory/remediate.js.map

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

package/dist/memory/retention.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Retention policy enforcement for memory files on disk-constrained VPS.
+ *
+ * - File count ceiling per agent subdirectory (default 500)
+ * - Oldest files archived to .archive/ as monthly .tar.gz bundles (never deleted)
+ * - Session directory size monitoring
+ * - Total memory directory size monitoring
+ */
+export interface RetentionConfig {
+    maxFilesPerSubdir: number;
+    sessionSizeWarnMB: number;
+    totalMemoryWarnMB: number;
+    archiveDir: string;
+}
+export interface RetentionResult {
+    archived: Array<{
+        subdir: string;
+        fileCount: number;
+        archivePath: string;
+    }>;
+    warnings: string[];
+    errors: string[];
+}
+export interface DiskReport {
+    totalMemoryBytes: number;
+    sessionBytes: number;
+    agentBytes: Record<string, number>;
+    warnings: string[];
+}
+/**
+ * Enforce file count ceilings across all agent subdirectories.
+ * Files over the limit are compressed into monthly .tar.gz archives.
+ */
+export declare function enforceRetention(memoryDir?: string, config?: Partial<RetentionConfig>): Promise<RetentionResult>;
+/**
+ * Check disk usage and produce warnings for session/total thresholds.
+ */
+export declare function checkDiskUsage(memoryDir?: string, config?: Partial<RetentionConfig>): DiskReport;
+/** List markdown files sorted oldest-first by filename date prefix, then mtime. */
+declare function listMarkdownFilesByAge(dir: string): string[];
+export { listMarkdownFilesByAge as _listMarkdownFilesByAge_for_testing };
+//# sourceMappingURL=retention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/memory/retention.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AASD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAwChG;AAqDD,mFAAmF;AACnF,iBAAS,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBrD;AAuCD,OAAO,EAAE,sBAAsB,IAAI,mCAAmC,EAAE,CAAC"}

package/dist/memory/retention.js

@@ -0,0 +1,186 @@
+/**
+ * Retention policy enforcement for memory files on disk-constrained VPS.
+ *
+ * - File count ceiling per agent subdirectory (default 500)
+ * - Oldest files archived to .archive/ as monthly .tar.gz bundles (never deleted)
+ * - Session directory size monitoring
+ * - Total memory directory size monitoring
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { getDefaultMemoryDir, MAX_FILES_PER_SUBDIR, SESSION_SIZE_WARN_BYTES, TOTAL_MEMORY_WARN_BYTES, } from './config.js';
+const DEFAULT_CONFIG = {
+    maxFilesPerSubdir: MAX_FILES_PER_SUBDIR,
+    sessionSizeWarnMB: SESSION_SIZE_WARN_BYTES / (1024 * 1024),
+    totalMemoryWarnMB: TOTAL_MEMORY_WARN_BYTES / (1024 * 1024),
+    archiveDir: '.archive',
+};
+/**
+ * Enforce file count ceilings across all agent subdirectories.
+ * Files over the limit are compressed into monthly .tar.gz archives.
+ */
+export async function enforceRetention(memoryDir, config) {
+    const dir = memoryDir ?? getDefaultMemoryDir();
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const result = { archived: [], warnings: [], errors: [] };
+    if (!fs.existsSync(dir)) {
+        result.errors.push(`Memory directory not found: ${dir}`);
+        return result;
+    }
+    const agentDirs = listSubdirs(dir);
+    for (const agentDir of agentDirs) {
+        const agentPath = path.join(dir, agentDir);
+        const subdirs = listSubdirs(agentPath);
+        for (const sub of subdirs) {
+            if (sub === cfg.archiveDir)
+                continue;
+            const subPath = path.join(agentPath, sub);
+            const files = listMarkdownFilesByAge(subPath);
+            if (files.length <= cfg.maxFilesPerSubdir)
+                continue;
+            const excess = files.length - cfg.maxFilesPerSubdir;
+            const toArchive = files.slice(0, excess);
+            try {
+                const archiveEntry = await archiveFiles(agentPath, sub, toArchive, cfg.archiveDir);
+                result.archived.push(archiveEntry);
+            }
+            catch (err) {
+                result.errors.push(`${agentDir}/${sub}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Check disk usage and produce warnings for session/total thresholds.
+ */
+export function checkDiskUsage(memoryDir, config) {
+    const dir = memoryDir ?? getDefaultMemoryDir();
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const report = {
+        totalMemoryBytes: 0,
+        sessionBytes: 0,
+        agentBytes: {},
+        warnings: [],
+    };
+    if (!fs.existsSync(dir))
+        return report;
+    report.totalMemoryBytes = getDirSize(dir);
+    const sessionsDir = path.join(dir, '..', 'sessions');
+    if (fs.existsSync(sessionsDir)) {
+        report.sessionBytes = getDirSize(sessionsDir);
+    }
+    const agentDirs = listSubdirs(dir);
+    for (const agent of agentDirs) {
+        report.agentBytes[agent] = getDirSize(path.join(dir, agent));
+    }
+    const totalMB = report.totalMemoryBytes / (1024 * 1024);
+    if (totalMB > cfg.totalMemoryWarnMB) {
+        report.warnings.push(`Total memory directory is ${totalMB.toFixed(0)}MB (threshold: ${cfg.totalMemoryWarnMB}MB)`);
+    }
+    const sessionMB = report.sessionBytes / (1024 * 1024);
+    if (sessionMB > cfg.sessionSizeWarnMB) {
+        report.warnings.push(`Session directory is ${sessionMB.toFixed(0)}MB (threshold: ${cfg.sessionSizeWarnMB}MB)`);
+    }
+    return report;
+}
+/**
+ * Archive a batch of files into a monthly .tar.gz bundle.
+ * Files are grouped by YYYY-MM from their filename date prefix.
+ */
+async function archiveFiles(agentPath, subdir, files, archiveDirName) {
+    const archiveDir = path.join(agentPath, archiveDirName);
+    if (!fs.existsSync(archiveDir)) {
+        fs.mkdirSync(archiveDir, { recursive: true });
+    }
+    const month = extractMonth(files[0] ?? '') ?? formatMonth(new Date());
+    const archiveName = `${subdir}-${month}-archive.tar.gz`;
+    const archivePath = path.join(archiveDir, archiveName);
+    let finalPath = archivePath;
+    if (fs.existsSync(archivePath)) {
+        finalPath = path.join(archiveDir, `${subdir}-${month}-archive-${Date.now()}.tar.gz`);
+    }
+    const subPath = path.join(agentPath, subdir);
+    const relativeFiles = files.map(f => path.relative(subPath, f));
+    try {
+        execSync(`tar -czf "${finalPath}" -C "${subPath}" ${relativeFiles.map(f => `"${f}"`).join(' ')}`, { timeout: 30_000 });
+    }
+    catch {
+        const bundleDir = path.join(archiveDir, `${subdir}-${month}`);
+        if (!fs.existsSync(bundleDir))
+            fs.mkdirSync(bundleDir, { recursive: true });
+        for (const file of files) {
+            const dest = path.join(bundleDir, path.basename(file));
+            fs.renameSync(file, dest);
+        }
+        finalPath = bundleDir;
+    }
+    if (finalPath !== archivePath || fs.existsSync(finalPath)) {
+        for (const file of files) {
+            if (fs.existsSync(file))
+                fs.unlinkSync(file);
+        }
+    }
+    return { subdir: `${path.basename(agentPath)}/${subdir}`, fileCount: files.length, archivePath: finalPath };
+}
+/** List markdown files sorted oldest-first by filename date prefix, then mtime. */
+function listMarkdownFilesByAge(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    try {
+        const entries = fs.readdirSync(dir)
+            .filter(f => f.endsWith('.md'))
+            .map(f => ({
+            name: f,
+            full: path.join(dir, f),
+            mtime: fs.statSync(path.join(dir, f)).mtimeMs,
+        }))
+            .sort((a, b) => a.mtime - b.mtime);
+        return entries.map(e => e.full);
+    }
+    catch {
+        return [];
+    }
+}
+function listSubdirs(dir) {
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true })
+            .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+            .map(e => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function getDirSize(dir) {
+    let total = 0;
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                total += getDirSize(full);
+            }
+            else {
+                try {
+                    total += fs.statSync(full).size;
+                }
+                catch { /* skip */ }
+            }
+        }
+    }
+    catch { /* skip */ }
+    return total;
+}
+function extractMonth(filePath) {
+    const basename = path.basename(filePath);
+    const match = basename.match(/^(\d{4}-\d{2})/);
+    return match?.[1] ?? null;
+}
+function formatMonth(date) {
+    return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}`;
+}
+export { listMarkdownFilesByAge as _listMarkdownFilesByAge_for_testing };
+//# sourceMappingURL=retention.js.map

package/dist/memory/retention.js.map

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

package/dist/memory/tag.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Memory tagger — scans memory files for missing or incomplete YAML
+ * frontmatter and adds/fixes it based on file path and content heuristics.
+ */
+export interface TagOptions {
+    memoryDir?: string;
+    dryRun?: boolean;
+    /** Only process a specific agent's directory. */
+    agent?: string;
+}
+export interface TagResult {
+    tagged: string[];
+    alreadyTagged: string[];
+    errors: string[];
+}
+/**
+ * Add YAML frontmatter to markdown files that are missing it.
+ */
+export declare function tagMemoryFiles(opts?: TagOptions): Promise<TagResult>;
+/**
+ * Infer YAML frontmatter from file path and first heading.
+ * Path structure: agent/subdir/filename.md
+ */
+declare function inferFrontmatter(relativePath: string, content: string): string;
+export { inferFrontmatter as _inferFrontmatter_for_testing };
+//# sourceMappingURL=tag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/memory/tag.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAgD9E;AAMD;;;GAGG;AACH,iBAAS,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBvE;AA6DD,OAAO,EAAE,gBAAgB,IAAI,6BAA6B,EAAE,CAAC"}

package/dist/memory/tag.js

@@ -0,0 +1,134 @@
+/**
+ * Memory tagger — scans memory files for missing or incomplete YAML
+ * frontmatter and adds/fixes it based on file path and content heuristics.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { getDefaultMemoryDir } from './config.js';
+/**
+ * Add YAML frontmatter to markdown files that are missing it.
+ */
+export async function tagMemoryFiles(opts = {}) {
+    const memoryDir = opts.memoryDir ?? getDefaultMemoryDir();
+    const dryRun = opts.dryRun ?? false;
+    const result = { tagged: [], alreadyTagged: [], errors: [] };
+    if (!fs.existsSync(memoryDir)) {
+        result.errors.push(`Memory directory not found: ${memoryDir}`);
+        return result;
+    }
+    const searchDir = opts.agent
+        ? path.join(memoryDir, opts.agent)
+        : memoryDir;
+    if (!fs.existsSync(searchDir)) {
+        result.errors.push(`Agent directory not found: ${searchDir}`);
+        return result;
+    }
+    const mdFiles = findAllMarkdownFiles(searchDir);
+    for (const file of mdFiles) {
+        try {
+            const content = fs.readFileSync(file, 'utf-8');
+            if (hasFrontmatter(content)) {
+                result.alreadyTagged.push(file);
+                continue;
+            }
+            const relativePath = path.relative(memoryDir, file);
+            const frontmatter = inferFrontmatter(relativePath, content);
+            const tagged = `${frontmatter}\n${content}`;
+            if (dryRun) {
+                result.tagged.push(file);
+                continue;
+            }
+            fs.writeFileSync(file, tagged, 'utf-8');
+            result.tagged.push(file);
+        }
+        catch (err) {
+            result.errors.push(`${file}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return result;
+}
+function hasFrontmatter(content) {
+    return content.startsWith('---\n') || content.startsWith('---\r\n');
+}
+/**
+ * Infer YAML frontmatter from file path and first heading.
+ * Path structure: agent/subdir/filename.md
+ */
+function inferFrontmatter(relativePath, content) {
+    const parts = relativePath.replace(/\\/g, '/').split('/');
+    const agent = parts[0] ?? 'unknown';
+    const subdir = parts.length >= 3 ? parts[1] : 'general';
+    const filename = path.basename(relativePath, '.md');
+    const dateMatch = filename.match(/^(\d{4}-\d{2}-\d{2})/);
+    const date = dateMatch?.[1] ?? new Date().toISOString().slice(0, 10);
+    const heading = extractFirstHeading(content) ?? filename;
+    const type = subdirToType(subdir);
+    const tags = inferTags(agent, type, content);
+    const lines = [
+        '---',
+        `tags: [${tags.join(', ')}]`,
+        `agent: ${agent}`,
+        `type: ${type}`,
+        `date: ${date}`,
+        'auto-tagged: true',
+        '---',
+    ];
+    return lines.join('\n');
+}
+function extractFirstHeading(content) {
+    const match = content.match(/^#+\s+(.+)$/m);
+    return match?.[1]?.trim() ?? null;
+}
+const TYPE_MAP = {
+    governance: 'governance-decision',
+    scores: 'score-published',
+    intelligence: 'intelligence',
+    assessments: 'assessment',
+    drift: 'drift',
+    fleet: 'fleet-anomaly',
+    'flight-plans': 'flight-plan',
+    deviations: 'deviation',
+    transitions: 'phase-transition',
+    incidents: 'incident',
+    health: 'morning-check',
+    trends: 'trend',
+    decisions: 'decision',
+    vetoes: 'veto',
+    strategic: 'strategic',
+    engineering: 'engineering',
+    deployments: 'deployment',
+    reviews: 'review',
+};
+function subdirToType(subdir) {
+    return TYPE_MAP[subdir] ?? subdir;
+}
+function inferTags(agent, type, content) {
+    const tags = [type, agent];
+    const lower = content.toLowerCase();
+    if (lower.includes('critical') || lower.includes('severity: critical'))
+        tags.push('critical');
+    if (lower.includes('backfill'))
+        tags.push('backfill');
+    if (lower.includes('remediat'))
+        tags.push('remediation');
+    return [...new Set(tags)];
+}
+function findAllMarkdownFiles(dir) {
+    const results = [];
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory() && !entry.name.startsWith('.')) {
+                results.push(...findAllMarkdownFiles(full));
+            }
+            else if (entry.name.endsWith('.md')) {
+                results.push(full);
+            }
+        }
+    }
+    catch { /* ignore */ }
+    return results.sort();
+}
+export { inferFrontmatter as _inferFrontmatter_for_testing };
+//# sourceMappingURL=tag.js.map

package/dist/memory/tag.js.map

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

package/dist/memory/writer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MemoryWriter — writes structured markdown files with YAML frontmatter
+ * into the shared memory directory for OpenClaw's memory_search to index.
+ *
+ * This class has zero dependencies beyond Node.js built-ins so that
+ * consumer agents (Grillo, Noah, Nole) can import it without pulling
+ * in Mark's health check infrastructure.
+ */
+export interface MemoryWriteOptions {
+    /** Which agent is writing (grillo, noah, nole, mighty-mark, jessie, sam). */
+    agent: string;
+    /** Event type (assessment, governance-decision, incident, flight-plan, etc.). */
+    type: string;
+    /** Searchable tags — indexed by BM25 keyword search. */
+    tags: string[];
+    /** Human-readable title — becomes the markdown H1. */
+    title: string;
+    /** Markdown body — embedded by vector model for semantic search. */
+    body: string;
+    /** Optional ISO date override (defaults to today). */
+    date?: string;
+    /** Optional extra frontmatter fields (risk, outcome, score, etc.). */
+    metadata?: Record<string, string | number | boolean>;
+}
+export interface MemoryWriterConfig {
+    /** Root memory directory. Default: ~/.openclaw/workspace/memory */
+    memoryDir?: string;
+    /** Whether to auto-create subdirectories. Default: true */
+    autoCreateDirs?: boolean;
+}
+export declare class MemoryWriter {
+    private readonly memoryDir;
+    private readonly autoCreate;
+    constructor(config?: MemoryWriterConfig);
+    /** Returns the root memory directory this writer targets. */
+    getMemoryDir(): string;
+    /**
+     * Write a memory file with YAML frontmatter + markdown body.
+     * Returns the absolute path of the written file.
+     */
+    write(opts: MemoryWriteOptions): Promise<string>;
+}
+/** Convert a title to a filename-safe slug. */
+declare function slugify(text: string): string;
+export { slugify as _slugify_for_testing };
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/memory/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA0CD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,MAAM,CAAC,EAAE,kBAAkB;IAKvC,6DAA6D;IAC7D,YAAY,IAAI,MAAM;IAItB;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;CAkBvD;AA6BD,+CAA+C;AAC/C,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrC;AAED,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,CAAC"}