@radix-ai/ai-memory 0.1.0

package/dist/evals/platform-integration.js

@@ -0,0 +1,186 @@
+/**
+ * Platform integration evals.
+ * Measures how well ai-memory integrates with Cursor, Claude Code, and cloud environments.
+ */
+import { readFile, readdir } from "fs/promises";
+import { join } from "path";
+import { existsSync } from "fs";
+/**
+ * Hook coverage: % of recommended Claude Code hooks installed.
+ * Checks for Stop, PreCompact, SubagentStop, WorktreeCreate in .claude/settings.json
+ * or plugin hooks.
+ */
+export async function evalHookCoverage(projectDir) {
+    const recommended = ["Stop", "PreCompact", "SubagentStop", "WorktreeCreate"];
+    let found = 0;
+    // Check .claude/settings.json
+    const settingsPath = join(projectDir, ".claude", "settings.json");
+    if (existsSync(settingsPath)) {
+        try {
+            const settings = JSON.parse(await readFile(settingsPath, "utf-8"));
+            const hooks = settings.hooks ?? {};
+            for (const hook of recommended) {
+                if (hooks[hook])
+                    found++;
+            }
+        }
+        catch { /* malformed */ }
+    }
+    // Check plugin hooks — take the max of settings.json and plugin hooks
+    const pluginHooksPath = join(projectDir, "plugins", "adapters", "claude-code", "hooks", "hooks.json");
+    if (existsSync(pluginHooksPath)) {
+        try {
+            const pluginHooks = JSON.parse(await readFile(pluginHooksPath, "utf-8"));
+            const hooks = pluginHooks.hooks ?? {};
+            let pluginFound = 0;
+            for (const hook of recommended) {
+                if (hooks[hook])
+                    pluginFound++;
+            }
+            found = Math.max(found, pluginFound);
+        }
+        catch { /* malformed */ }
+    }
+    const pct = Math.round((found / recommended.length) * 100);
+    return {
+        name: "hook_coverage",
+        value: `${pct}%`,
+        status: pct >= 75 ? "good" : pct >= 50 ? "warn" : "bad",
+        note: `${found}/${recommended.length} recommended hooks (${recommended.join(", ")})`,
+    };
+}
+/**
+ * Skill discoverability: % of skills present in portable .agents/skills/ directory.
+ */
+export async function evalSkillDiscoverability(projectDir) {
+    const expected = ["mem-compound", "mem-session-close", "mem-validate", "mem-init"];
+    const agentsSkillsDir = join(projectDir, ".agents", "skills");
+    let found = 0;
+    if (existsSync(agentsSkillsDir)) {
+        for (const skill of expected) {
+            if (existsSync(join(agentsSkillsDir, skill, "SKILL.md")))
+                found++;
+        }
+    }
+    const pct = Math.round((found / expected.length) * 100);
+    return {
+        name: "skill_discoverability",
+        value: `${pct}%`,
+        status: pct === 100 ? "good" : pct >= 50 ? "warn" : "bad",
+        note: found === expected.length
+            ? "All skills in portable .agents/skills/"
+            : `${found}/${expected.length} skills found. Run \`ai-memory install --to cursor\` or \`--to claude-code\` to install.`,
+    };
+}
+/**
+ * Cloud readiness: .ai/ is git-tracked + sync_memory available + HTTP transport exists.
+ */
+export async function evalCloudReadiness(projectDir) {
+    const checks = [];
+    let passed = 0;
+    // Check .ai/ is git-tracked
+    const aiDir = join(projectDir, ".ai");
+    if (existsSync(aiDir)) {
+        checks.push("✓ .ai/ exists");
+        passed++;
+    }
+    else {
+        checks.push("✗ .ai/ missing");
+    }
+    // Check .mcp.json exists (sync_memory available via MCP)
+    if (existsSync(join(projectDir, ".mcp.json"))) {
+        checks.push("✓ .mcp.json present (sync_memory available)");
+        passed++;
+    }
+    else {
+        checks.push("✗ .mcp.json missing");
+    }
+    // Check if MCP server code supports HTTP
+    const mcpIndex = join(projectDir, "src", "mcp-server", "index.ts");
+    if (existsSync(mcpIndex)) {
+        try {
+            const content = await readFile(mcpIndex, "utf-8");
+            if (content.includes("StreamableHTTPServerTransport") || content.includes("--http")) {
+                checks.push("✓ HTTP transport supported");
+                passed++;
+            }
+            else {
+                checks.push("✗ HTTP transport not implemented");
+            }
+        }
+        catch {
+            checks.push("? Could not read MCP server source");
+        }
+    }
+    else {
+        // Check dist for published package
+        checks.push("~ HTTP transport (check package)");
+        passed++; // Give benefit of doubt for installed packages
+    }
+    return {
+        name: "cloud_readiness",
+        value: `${passed}/3`,
+        status: passed === 3 ? "good" : passed >= 2 ? "warn" : "bad",
+        note: checks.join("; "),
+    };
+}
+/**
+ * Automation readiness: skills have automation sections and sync_memory calls.
+ */
+export async function evalAutomationReadiness(projectDir) {
+    const skillDirs = [
+        join(projectDir, "plugins", "ai-memory", "skills"),
+        join(projectDir, ".agents", "skills"),
+    ];
+    let totalSkills = 0;
+    let automationReady = 0;
+    for (const dir of skillDirs) {
+        if (!existsSync(dir))
+            continue;
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillPath = join(dir, entry.name, "SKILL.md");
+            if (!existsSync(skillPath))
+                continue;
+            totalSkills++;
+            const content = await readFile(skillPath, "utf-8");
+            if (content.toLowerCase().includes("automation") || content.includes("sync_memory")) {
+                automationReady++;
+            }
+        }
+    }
+    if (totalSkills === 0) {
+        return { name: "automation_readiness", value: "n/a", status: "warn", note: "No skills found" };
+    }
+    const pct = Math.round((automationReady / totalSkills) * 100);
+    return {
+        name: "automation_readiness",
+        value: `${pct}%`,
+        status: pct >= 80 ? "good" : pct >= 50 ? "warn" : "bad",
+        note: `${automationReady}/${totalSkills} skills are automation-ready (mention automation/sync_memory)`,
+    };
+}
+/**
+ * Integration coverage: % of recommended toolbox files that exist.
+ */
+export async function evalIntegrationCoverage(aiDir) {
+    const expected = ["integrations.md", "browser.md", "shell.md"];
+    const toolboxDir = join(aiDir, "toolbox");
+    let found = 0;
+    if (existsSync(toolboxDir)) {
+        for (const file of expected) {
+            if (existsSync(join(toolboxDir, file)))
+                found++;
+        }
+    }
+    const pct = Math.round((found / expected.length) * 100);
+    return {
+        name: "integration_coverage",
+        value: `${pct}%`,
+        status: pct === 100 ? "good" : pct >= 33 ? "warn" : "bad",
+        note: `${found}/${expected.length} toolbox files (${expected.join(", ")})`,
+    };
+}
+//# sourceMappingURL=platform-integration.js.map

package/dist/evals/platform-integration.js.map

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

package/dist/formatter/index.d.ts

@@ -0,0 +1,15 @@
+export interface ValidationError {
+    file: string;
+    message: string;
+    /** "error" fails validate; "warn" logs but does not fail */
+    severity?: "error" | "warn";
+}
+export declare function validateFrontmatter(filePath: string, content: string): string[];
+/** Warn if skill content contains tool names — skills should declare capabilities, not tools. */
+export declare function validateSkillContent(filePath: string, content: string): string[];
+export declare function ensureFrontmatter(filePath: string, content: string): string;
+export declare function validateAll(aiDir: string): Promise<ValidationError[]>;
+export declare function formatAll(aiDir: string): Promise<number>;
+/** Regenerate memory-index.md from decisions, patterns, debugging, improvements. */
+export declare function generateMemoryIndex(aiDir: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/formatter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatter/index.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAGD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CA+BV;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWhF;AAGD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA8C3E;AAGD,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAkB3E;AAGD,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc9D;AAiCD,oFAAoF;AACpF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CtE"}

package/dist/formatter/index.js

@@ -0,0 +1,207 @@
+import { readFile, writeFile, readdir } from "fs/promises";
+import { join } from "path";
+import { existsSync } from "fs";
+import matter from "gray-matter";
+import { VALID_TYPES, VALID_STATUSES, SKILL_TOOL_NAMES_BLOCKLIST } from "../schema-constants.js";
+// Validate frontmatter of a single file
+export function validateFrontmatter(filePath, content) {
+    const errors = [];
+    let parsed;
+    try {
+        parsed = matter(content);
+    }
+    catch {
+        return [`Invalid YAML frontmatter`];
+    }
+    const fm = parsed.data;
+    // Files in temp/ are auto-generated — skip validation
+    if (filePath.includes("/temp/") || filePath.includes("\\temp\\")) {
+        return [];
+    }
+    // Required fields
+    if (!fm.id)
+        errors.push(`Missing required field: id`);
+    if (!fm.type)
+        errors.push(`Missing required field: type`);
+    if (!fm.status)
+        errors.push(`Missing required field: status`);
+    // Valid enum values
+    if (fm.type && !VALID_TYPES.includes(fm.type)) {
+        errors.push(`Invalid type "${fm.type}". Must be one of: ${VALID_TYPES.join(", ")}`);
+    }
+    if (fm.status && !VALID_STATUSES.includes(fm.status)) {
+        errors.push(`Invalid status "${fm.status}". Must be one of: ${VALID_STATUSES.join(", ")}`);
+    }
+    return errors;
+}
+/** Warn if skill content contains tool names — skills should declare capabilities, not tools. */
+export function validateSkillContent(filePath, content) {
+    const warnings = [];
+    if (!filePath.includes("/skills/") || !filePath.endsWith("SKILL.md"))
+        return warnings;
+    const body = content.replace(/^---[\s\S]*?---\s*/m, "").toLowerCase();
+    for (const tool of SKILL_TOOL_NAMES_BLOCKLIST) {
+        if (body.includes(tool)) {
+            warnings.push(`Skill references tool "${tool}" — prefer capability-based requires (see [P1] Capability-based skills)`);
+        }
+    }
+    return warnings;
+}
+// Auto-add minimal frontmatter if missing
+export function ensureFrontmatter(filePath, content) {
+    // Skip temp/ and non-.md files
+    if (filePath.includes("/temp/") || filePath.includes("\\temp\\"))
+        return content;
+    let parsed;
+    try {
+        parsed = matter(content);
+    }
+    catch {
+        return content;
+    }
+    const fm = parsed.data;
+    let changed = false;
+    if (!fm.id) {
+        // Derive id from filename
+        const basename = filePath.split(/[\\/]/).pop()?.replace(".md", "") ?? "unknown";
+        fm.id = basename.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+        changed = true;
+    }
+    if (!fm.type) {
+        // Infer type from path
+        if (filePath.includes("/memory/"))
+            fm.type = "decision";
+        else if (filePath.includes("/agents/"))
+            fm.type = "agent";
+        else if (filePath.includes("/skills/"))
+            fm.type = "skill";
+        else if (filePath.includes("/toolbox/"))
+            fm.type = "toolbox";
+        else if (filePath.includes("/rules/"))
+            fm.type = "rule";
+        else if (filePath.endsWith("IDENTITY.md"))
+            fm.type = "identity";
+        else if (filePath.endsWith("PROJECT_STATUS.md"))
+            fm.type = "project-status";
+        else
+            fm.type = "decision";
+        changed = true;
+    }
+    if (!fm.status) {
+        fm.status = "active";
+        changed = true;
+    }
+    if (!changed)
+        return content;
+    // Reconstruct file with updated frontmatter
+    const newFm = Object.keys(fm)
+        .map((k) => `${k}: ${JSON.stringify(fm[k])}`)
+        .join("\n");
+    return `---\n${newFm}\n---\n\n${parsed.content.trimStart()}`;
+}
+// Validate all .md files under aiDir
+export async function validateAll(aiDir) {
+    const errors = [];
+    const files = await collectMdFiles(aiDir);
+    for (const file of files) {
+        const content = await readFile(file, "utf-8");
+        const fileErrors = validateFrontmatter(file, content);
+        const skillWarnings = validateSkillContent(file, content);
+        const rel = file.replace(aiDir, "").replace(/^[/\\]/, "");
+        for (const msg of fileErrors) {
+            errors.push({ file: rel, message: msg, severity: "error" });
+        }
+        for (const msg of skillWarnings) {
+            errors.push({ file: rel, message: msg, severity: "warn" });
+        }
+    }
+    return errors;
+}
+// Format (auto-fix frontmatter) on all .md files under aiDir
+export async function formatAll(aiDir) {
+    const files = await collectMdFiles(aiDir);
+    let count = 0;
+    for (const file of files) {
+        const original = await readFile(file, "utf-8");
+        const formatted = ensureFrontmatter(file, original);
+        if (formatted !== original) {
+            await writeFile(file, formatted);
+            count++;
+        }
+    }
+    return count;
+}
+async function collectMdFiles(dir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...(await collectMdFiles(full)));
+        }
+        else if (entry.name.endsWith(".md")) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+/** Extract [P0]/[P1]/[P2] entry titles from markdown (skip [DEPRECATED]). */
+function extractEntries(content) {
+    const entries = [];
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const m = line.match(/^###\s*\[(P[012])\]\s*(.+?)(?:\s*\[DEPRECATED\])?$/);
+        if (m) {
+            const title = m[2].replace(/\s*\[DEPRECATED\]\s*$/, "").trim();
+            if (!line.includes("[DEPRECATED]"))
+                entries.push({ priority: m[1], title });
+        }
+    }
+    return entries;
+}
+/** Regenerate memory-index.md from decisions, patterns, debugging, improvements. */
+export async function generateMemoryIndex(aiDir) {
+    const memoryDir = join(aiDir, "memory");
+    if (!existsSync(memoryDir))
+        return;
+    const sections = [];
+    for (const file of ["decisions.md", "patterns.md", "debugging.md", "improvements.md"]) {
+        const path = join(memoryDir, file);
+        if (!existsSync(path))
+            continue;
+        const content = await readFile(path, "utf-8");
+        const entries = extractEntries(content);
+        if (entries.length > 0)
+            sections.push({ file, entries });
+    }
+    const priorityOrder = ["P0", "P1", "P2"];
+    const lines = [
+        "---",
+        `id: memory-index`,
+        "type: index",
+        "status: active",
+        `last_updated: ${new Date().toISOString().slice(0, 10)}`,
+        "---",
+        "",
+        "# Memory Index",
+        "",
+        "**Auto-generated.** Run `ai-memory index` or `/mem-compound` to regenerate.",
+        "",
+        "---",
+        "",
+    ];
+    for (const { file, entries } of sections) {
+        const label = file.replace(".md", "").replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+        lines.push(`## ${label}\n`);
+        const sorted = [...entries].sort((a, b) => priorityOrder.indexOf(a.priority) - priorityOrder.indexOf(b.priority));
+        for (const e of sorted) {
+            lines.push(`- **[${e.priority}]** ${e.title}`);
+        }
+        lines.push("");
+    }
+    const indexPath = join(memoryDir, "memory-index.md");
+    await writeFile(indexPath, lines.join("\n").trimEnd() + "\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/formatter/index.js.map

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

package/dist/hybrid-search/index.d.ts

@@ -0,0 +1,40 @@
+export type SearchMode = "keyword" | "semantic" | "hybrid";
+/** Backend used for search: native (onnxruntime-node), wasm, or keyword-only. */
+export type SearchBackend = "native" | "wasm" | "keyword";
+export interface SearchResult {
+    file: string;
+    excerpt: string;
+    score: number;
+}
+export interface HybridSearchResponse {
+    results: SearchResult[];
+    backend: SearchBackend;
+}
+export interface Chunk {
+    file: string;
+    text: string;
+    content: string;
+}
+export declare function loadChunks(aiDir: string): Promise<Chunk[]>;
+/** Pre-warm the semantic model (download + load). Call at init or session start to avoid first-query latency. */
+export declare function warmSearchModel(): Promise<void>;
+/** Backend used for the last semantic/hybrid search, or "keyword" if only keyword was used. */
+export declare function getLastSearchBackend(): SearchBackend;
+export interface HybridSearchOptions {
+    mode: SearchMode;
+    limit?: number;
+    tags?: string[];
+    includeDeprecated?: boolean;
+}
+/**
+ * Run hybrid search. Returns results ordered by relevance.
+ * - keyword: TF-based only
+ * - semantic: vector similarity only (requires model load)
+ * - hybrid: RRF merge of keyword + semantic
+ */
+export declare function hybridSearch(aiDir: string, query: string, options: HybridSearchOptions): Promise<HybridSearchResponse>;
+/**
+ * Get current search mode from env. Default: hybrid.
+ */
+export declare function getSearchMode(): SearchMode;
+//# sourceMappingURL=index.d.ts.map

package/dist/hybrid-search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hybrid-search/index.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE3D,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CA6BhE;AA+ID,iHAAiH;AACjH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,IAAI,aAAa,CAEpD;AAuBD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAuE/B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAI1C"}