@radix-ai/ai-memory 0.1.0

package/dist/cli/adapters.js

@@ -0,0 +1,368 @@
+/**
+ * Tool adapter definitions for `ai-memory install --to <tool>`.
+ * Extracted from index.ts for maintainability.
+ */
+export const BOOTSTRAP_INSTRUCTION = `## ai-memory — Project Memory
+
+This project has persistent AI memory in \`.ai/\`.
+
+- **IDENTITY.md** — project constraints and behavioral rules
+- **PROJECT_STATUS.md** — current focus, open questions, what to try next (writable)
+- **memory/** — decisions, patterns, debugging history
+- **skills/** — domain-specific patterns and session protocols
+
+Use \`search_memory\` (MCP) to find relevant context before starting a task.
+Use \`commit_memory\` to write new entries — never edit memory files directly.
+If MCP is not connected, read \`.ai/memory/memory-index.md\` for a summary and write to \`.ai/memory/\` files directly.
+
+\`.ai/\` is the canonical memory for this project. Save all project learnings here, not in your tool's built-in memory (e.g. ~/.claude/, Cursor memory, etc.). Tool-native memory is for user preferences only.
+
+Immutable paths (do not write): IDENTITY.md, toolbox/, acp/, rules/.
+
+At the end of a meaningful session, run /mem-compound to capture learnings.
+`;
+/**
+ * Platform-agnostic MCP launcher. Detects OS at runtime and spawns correctly.
+ * - In ai-memory repo: run local dist directly (avoids npx entirely).
+ * - Windows: npx.cmd fails under spawn; npx-cli.js via node works.
+ * - macOS/Linux/BSD: npx works directly.
+ */
+export const MCP_LAUNCHER = `#!/usr/bin/env node
+const { spawn } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const platform = process.platform;
+const opts = { stdio: "inherit", env: process.env };
+
+// Prefer local build when in ai-memory repo (avoids npx on Windows)
+const cwd = process.cwd();
+const localCli = path.join(cwd, "dist", "cli", "index.js");
+const localMcp = path.join(cwd, "dist", "mcp-server", "index.js");
+
+let child;
+if (fs.existsSync(localCli)) {
+  child = spawn("node", [localCli, "mcp"], opts);
+} else if (fs.existsSync(localMcp)) {
+  child = spawn("node", [localMcp], opts);
+} else if (platform === "win32") {
+  const nodeDir = path.dirname(process.execPath);
+  const npxCli = path.join(nodeDir, "node_modules", "npm", "bin", "npx-cli.js");
+  if (fs.existsSync(npxCli)) {
+    child = spawn("node", [npxCli, "@radix-ai/ai-memory", "mcp"], opts);
+  } else {
+    child = spawn("cmd", ["/c", "npx", "@radix-ai/ai-memory", "mcp"], { ...opts, windowsHide: true });
+  }
+} else {
+  child = spawn("npx", ["@radix-ai/ai-memory", "mcp"], opts);
+}
+
+child.on("error", (err) => {
+  console.error("[ai-memory-mcp] spawn failed:", err.message);
+  process.exit(1);
+});
+child.on("exit", (code, signal) => {
+  process.exit(code ?? (signal ? 1 : 0));
+});
+`;
+/** MCP config path for the launcher (relative to project root). */
+export const MCP_LAUNCHER_PATH = ".ai/mcp-launcher.cjs";
+/** Single MCP config for all platforms. Uses launcher that detects OS at runtime. */
+export function getMCPJson() {
+    return JSON.stringify({
+        mcpServers: {
+            "ai-memory": {
+                type: "stdio",
+                command: "node",
+                args: [MCP_LAUNCHER_PATH],
+                env: { AI_DIR: "${workspaceFolder}/.ai" },
+            },
+            context7: {
+                type: "http",
+                url: "https://mcp.context7.com/mcp",
+                headers: { "x-api-key": "${CONTEXT7_API_KEY:-}" },
+            },
+        },
+    }, null, 2);
+}
+// ─── Canonical skills (written to .ai/skills/) ─────────────────────────────
+function skillStub(name, description) {
+    return `---\nname: ${name}\ndescription: ${description}\n---\n\n# ${name}\n\nCanonical definition: \`.ai/skills/${name}/SKILL.md\`\n\nRead the canonical file for full instructions.\n`;
+}
+/** Full skill content — written to .ai/skills/<name>/SKILL.md by install */
+export const CANONICAL_SKILLS = {
+    "mem-compound": `---
+name: mem-compound
+description: Captures session learnings into persistent memory. Use after a bug fix, pattern discovery, corrected approach, or at the end of any meaningful session.
+---
+
+# mem-compound — Capture Session Learnings
+
+## When to use
+- A bug had a non-obvious root cause
+- A reusable pattern emerged
+- An approach was corrected mid-session
+- The session produced architectural decisions
+- End of any session worth preserving
+
+## Instructions
+
+### 1. Scan the session
+Review conversation, code changes, errors. Identify:
+- Bugs with non-obvious causes → write to \`debugging.md\` via \`commit_memory\`
+- Reusable patterns → write to \`patterns.md\` via \`commit_memory\`
+- Decisions made → write to \`decisions.md\` via \`commit_memory\`
+- Improvements → write to \`improvements.md\` via \`commit_memory\`
+
+### 2. Conflict check
+Before writing: call \`search_memory\` for each topic. If contradictions found, mark old entry \`[DEPRECATED]\`.
+
+### 3. Update PROJECT_STATUS.md
+Update with learnings: move completed items to "What's Working", add new open questions, update "What to Try Next".
+
+### 4. Archive
+Call \`publish_result\` with summary, outcome, and learnings.
+Update \`sessions/open-items.md\`: close resolved items, add new ones.
+
+### 5. Governance gate (if harness.json exists)
+Call \`generate_harness\`, then \`validate_context\` with git diff.
+
+### 6. Sync (ephemeral environments only)
+If in worktree/cloud agent: call \`sync_memory\` to git commit .ai/ changes.
+
+### 7. Report
+Summarize: entries written, items opened/closed, gate result.
+`,
+    "mem-session-close": `---
+name: mem-session-close
+description: Quick session close for sessions with no major learnings. Archives and updates open items.
+---
+
+# mem-session-close — Quick Session Close
+
+## When to use
+- Session was exploratory or mechanical
+- Short session, no new decisions or patterns
+- Want to close cleanly without the full compound loop
+
+## Instructions
+
+1. Call \`publish_result\` with a brief summary and outcome
+2. Update \`sessions/open-items.md\`: close resolved items, add new ones
+3. If in ephemeral environment: call \`sync_memory\`
+4. Report: "Session closed. [N] items updated."
+`,
+    "mem-validate": `---
+name: mem-validate
+description: Validate memory entries and code changes against governance rules. Use before risky changes.
+---
+
+# mem-validate — Governance Validation
+
+## When to use
+- Before committing a risky change
+- After adding [P0] entries with constraint_pattern
+- To verify memory schema compliance
+
+## Instructions
+
+1. Call \`generate_harness\` to refresh rules from current [P0] entries
+2. Call \`validate_context\` with the current git diff
+3. Call \`validate_schema\` on any new memory entries
+4. Report violations and recommendations
+`,
+    "mem-init": `---
+name: mem-init
+description: Initialize ai-memory in a new project. Scaffolds the .ai/ directory structure.
+disable-model-invocation: true
+---
+
+# mem-init — Project Setup
+
+## Instructions
+
+1. Confirm the user wants to initialize ai-memory in this project
+2. Ask: Default tier or Full tier (adds governance, evals, ACP)?
+3. Run: \`ai-memory init\` (or \`ai-memory init --full\`)
+4. Guide the user to edit \`.ai/IDENTITY.md\` and \`.ai/PROJECT_STATUS.md\`
+5. Run \`ai-memory validate\` to confirm setup
+`,
+    browser: `---
+name: browser
+description: Use browser automation (screenshots, navigate, interact). Requires browser MCP.
+type: skill
+status: active
+requires:
+  capabilities: [browser]
+---
+
+# browser — Browser Automation Skill
+
+## When to use
+
+- Take screenshots of web pages
+- Navigate, fill forms, click elements
+- Verify visual changes or UI state
+
+## Setup
+
+Ensure browser capability is enabled for your environment. See \`.ai/reference/capability-specs.json\` or run \`ai-memory install --capability browser\` when available.
+
+## Usage patterns
+
+- **Failures** → write to \`debugging.md\` via \`commit_memory\` with symptom, screenshot path, root cause
+- **Screenshots** → reference path in memory entries; include URL and viewport
+- **Visual regression** → \`search_memory\` for known changes; create debugging entry if unexpected
+`,
+    "screen-capture": `---
+name: screen-capture
+description: Capture desktop or app window for vision analysis. Platform-dependent (e.g. Peekaboo on macOS).
+type: skill
+status: active
+requires:
+  capabilities: [screen_capture]
+---
+
+# screen-capture — Desktop/App Screenshot Skill
+
+## When to use
+
+- Read another app's screen (e.g. IDE, browser window)
+- Capture for vision analysis or handoff
+- Save to \`.ai/temp/\` for cross-tool handoff
+
+## Setup
+
+See \`.ai/reference/capability-specs.json\` for platform-specific install (e.g. Peekaboo on macOS). Manual fallback: screenshot to \`.ai/temp/screen.png\`.
+
+## Usage
+
+- Capture → save to \`.ai/temp/\` → agent reads via file or \`get_memory\`
+- Handoff: write path to \`.ai/temp/request-for-*.md\` for another agent
+`,
+};
+// ─── Claude Code hooks ──────────────────────────────────────────────────────
+export const SESSION_START_HOOK = `#!/usr/bin/env node
+/**
+ * ai-memory — Claude Code SessionStart hook
+ * Injects minimal .ai/ context at session start (lazy loading).
+ * Full context available via search_memory MCP tool.
+ */
+const { readFileSync, existsSync } = require("fs");
+const { join } = require("path");
+
+const aiDir = process.env.AI_DIR || join(process.cwd(), ".ai");
+
+function safeRead(filePath, maxLines) {
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    if (maxLines) return content.split("\\n").slice(0, maxLines).join("\\n");
+    return content;
+  } catch { return ""; }
+}
+
+if (!existsSync(aiDir)) process.exit(0);
+
+const sections = [];
+
+const identity = safeRead(join(aiDir, "IDENTITY.md"));
+if (identity) sections.push(identity.trim());
+
+const status = safeRead(join(aiDir, "PROJECT_STATUS.md"));
+if (status) sections.push(status.trim());
+
+const index = safeRead(join(aiDir, "memory/memory-index.md"));
+if (index && !index.includes("<!-- Index will be generated")) {
+  sections.push("## Memory Index (priority-ranked)\\n\\n" + index.trim());
+}
+
+if (sections.length === 0) process.exit(0);
+
+process.stdout.write(JSON.stringify({
+  type: "context",
+  content: sections.join("\\n\\n---\\n\\n"),
+}));
+`;
+// Pre-compact hook as a separate script to avoid escaping issues in JSON
+export const PRE_COMPACT_HOOK = `#!/usr/bin/env node
+const fs = require("fs");
+const path = require("path");
+const aiDir = process.env.AI_DIR || path.join(process.cwd(), ".ai");
+if (!fs.existsSync(aiDir)) process.exit(0);
+const tempDir = path.join(aiDir, "temp");
+fs.mkdirSync(tempDir, { recursive: true });
+const dump = { timestamp: new Date().toISOString(), event: "pre-compact" };
+for (const f of ["PROJECT_STATUS.md", "memory/memory-index.md", "sessions/open-items.md"]) {
+  const fp = path.join(aiDir, f);
+  if (fs.existsSync(fp)) dump[f] = fs.readFileSync(fp, "utf-8").slice(0, 2000);
+}
+fs.writeFileSync(path.join(tempDir, "pre-compact-dump.json"), JSON.stringify(dump, null, 2));
+`;
+export const CLAUDE_HOOKS_CONFIG = JSON.stringify({
+    hooks: {
+        SessionStart: [{
+                hooks: [{
+                        type: "command",
+                        command: "node .claude/hooks/SessionStart.js",
+                        timeout: 10000,
+                    }],
+            }],
+        PreCompact: [{
+                hooks: [{
+                        type: "command",
+                        command: "node .claude/hooks/PreCompact.js",
+                        timeout: 10000,
+                    }],
+            }],
+    },
+}, null, 2);
+export const TOOL_ADAPTERS = {
+    cursor: {
+        dest: ".cursor/rules/00-load-ai-memory.mdc",
+        content: `---\ndescription: Load ai-memory project context at session start\nalwaysApply: true\n---\n\n${BOOTSTRAP_INSTRUCTION}`,
+        mcp: true,
+        mcpPath: ".cursor/mcp.json",
+        extraFiles: {
+            // Stubs in .agents/skills/ point to canonical .ai/skills/
+            ".agents/skills/mem-compound/SKILL.md": skillStub("mem-compound", "Captures session learnings into persistent memory."),
+            ".agents/skills/mem-session-close/SKILL.md": skillStub("mem-session-close", "Quick session close for sessions with no major learnings."),
+            ".agents/skills/mem-validate/SKILL.md": skillStub("mem-validate", "Validate memory entries and code changes against governance rules."),
+            ".agents/skills/mem-init/SKILL.md": skillStub("mem-init", "Initialize ai-memory in a new project."),
+            ".agents/skills/browser/SKILL.md": skillStub("browser", "Browser automation (screenshots, navigate, interact)."),
+            ".agents/skills/screen-capture/SKILL.md": skillStub("screen-capture", "Desktop/app window screenshot for vision analysis."),
+        },
+    },
+    windsurf: {
+        dest: ".windsurfrules",
+        content: BOOTSTRAP_INSTRUCTION,
+        mcp: true,
+    },
+    cline: {
+        dest: ".clinerules",
+        content: BOOTSTRAP_INSTRUCTION,
+        mcp: true,
+    },
+    copilot: {
+        dest: ".github/copilot-instructions.md",
+        content: `# Copilot Instructions\n\n${BOOTSTRAP_INSTRUCTION}\n\n> Note: GitHub Copilot does not support MCP. Skills must be run by pasting content from \`.ai/skills/\`.\n`,
+        mcp: false,
+    },
+    "claude-code": {
+        dest: "CLAUDE.md",
+        content: `# Claude Code — Project Memory\n\n${BOOTSTRAP_INSTRUCTION}`,
+        mcp: true,
+        extraFiles: {
+            // Stubs in .agents/skills/ point to canonical .ai/skills/
+            ".agents/skills/mem-compound/SKILL.md": skillStub("mem-compound", "Captures session learnings into persistent memory."),
+            ".agents/skills/mem-session-close/SKILL.md": skillStub("mem-session-close", "Quick session close for sessions with no major learnings."),
+            ".agents/skills/mem-validate/SKILL.md": skillStub("mem-validate", "Validate memory entries and code changes against governance rules."),
+            ".agents/skills/mem-init/SKILL.md": skillStub("mem-init", "Initialize ai-memory in a new project."),
+            ".agents/skills/browser/SKILL.md": skillStub("browser", "Browser automation (screenshots, navigate, interact)."),
+            ".agents/skills/screen-capture/SKILL.md": skillStub("screen-capture", "Desktop/app window screenshot for vision analysis."),
+            // Claude Code hooks (SessionStart, PreCompact)
+            ".claude/hooks/SessionStart.js": SESSION_START_HOOK,
+            ".claude/hooks/PreCompact.js": PRE_COMPACT_HOOK,
+            ".claude/settings.local.json": CLAUDE_HOOKS_CONFIG,
+        },
+    },
+};
+//# sourceMappingURL=adapters.js.map

package/dist/cli/adapters.js.map

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

package/dist/cli/environment.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Environment detection and capability injection for ai-memory install.
+ * Reads capability-specs.json and environment-specs.json from templates or .ai/reference/.
+ */
+export interface EnvironmentSpec {
+    id: string;
+    name: string;
+    detect: {
+        paths: string[];
+    };
+    capabilities?: Record<string, unknown>;
+}
+export interface CapabilitySpec {
+    description?: string;
+    environments?: Record<string, unknown>;
+    platforms?: Record<string, unknown>;
+}
+/**
+ * Detect which environments are present in the project.
+ * Checks detect.paths for each env in environment-specs.json.
+ */
+export declare function detectEnvironments(projectRoot: string, packageRoot: string): string[];
+/**
+ * Get capability config for a given capability and environment.
+ * Reads from capability-specs.json → environments[envId].
+ */
+export declare function getCapabilityConfig(capability: string, envId: string, projectRoot: string, packageRoot: string): unknown;
+/**
+ * Inject MCP config for a capability into the environment's config file.
+ * Merges new server entry into mcpServers; does not overwrite existing ai-memory.
+ * Returns true if config was written, false if skipped (e.g. native capability).
+ */
+export declare function injectCapabilityConfig(projectRoot: string, envId: string, capability: string, packageRoot: string): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/cli/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/cli/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAoBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAOT;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAcT"}

package/dist/cli/environment.js

@@ -0,0 +1,119 @@
+/**
+ * Environment detection and capability injection for ai-memory install.
+ * Reads capability-specs.json and environment-specs.json from templates or .ai/reference/.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { dirname, join } from "path";
+/** Resolve path to specs. Prefer project .ai/reference/, fallback to package templates. */
+function getSpecsPath(projectRoot, packageRoot, filename) {
+    const projectRef = join(projectRoot, ".ai", "reference", filename);
+    if (existsSync(projectRef))
+        return projectRef;
+    return join(packageRoot, "templates", ".ai", "reference", filename);
+}
+/** Load and parse JSON spec file. Returns null if missing or invalid. */
+function loadSpec(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = readFileSync(path, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect which environments are present in the project.
+ * Checks detect.paths for each env in environment-specs.json.
+ */
+export function detectEnvironments(projectRoot, packageRoot) {
+    const envPath = getSpecsPath(projectRoot, packageRoot, "environment-specs.json");
+    const spec = loadSpec(envPath);
+    const envs = spec?.environments ?? [];
+    const found = [];
+    for (const env of envs) {
+        const paths = env.detect?.paths ?? [];
+        const present = paths.some((p) => existsSync(join(projectRoot, p)));
+        if (present)
+            found.push(env.id);
+    }
+    return found;
+}
+/**
+ * Get capability config for a given capability and environment.
+ * Reads from capability-specs.json → environments[envId].
+ */
+export function getCapabilityConfig(capability, envId, projectRoot, packageRoot) {
+    const capPath = getSpecsPath(projectRoot, packageRoot, "capability-specs.json");
+    const spec = loadSpec(capPath);
+    const cap = spec?.capabilities?.[capability];
+    if (!cap)
+        return null;
+    const envConfig = cap.environments?.[envId];
+    return envConfig ?? null;
+}
+/** MCP config paths per environment (relative to project root). Matches install adapter mcpPath. */
+const ENV_MCP_PATHS = {
+    cursor: ".cursor/mcp.json",
+    "claude-code": ".mcp.json",
+    windsurf: ".mcp.json",
+    cline: ".mcp.json",
+};
+/**
+ * Inject MCP config for a capability into the environment's config file.
+ * Merges new server entry into mcpServers; does not overwrite existing ai-memory.
+ * Returns true if config was written, false if skipped (e.g. native capability).
+ */
+export function injectCapabilityConfig(projectRoot, envId, capability, packageRoot) {
+    const configPath = join(projectRoot, ENV_MCP_PATHS[envId] ?? ".mcp.json");
+    const config = loadMcpConfig(configPath);
+    const capConfig = getCapabilityConfig(capability, envId, projectRoot, packageRoot);
+    if (!capConfig || typeof capConfig !== "object")
+        return false;
+    const entry = mcpEntryFromCapConfig(capability, capConfig);
+    if (!entry)
+        return false;
+    const merged = mergeMcpConfig(config ?? { mcpServers: {} }, capability, entry);
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, JSON.stringify(merged, null, 2));
+    return true;
+}
+function loadMcpConfig(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function mcpEntryFromCapConfig(capability, config) {
+    if (config.native === true)
+        return null; // Cursor has browser natively; no injection
+    const mcp = config.mcp;
+    if (!mcp || typeof mcp !== "object")
+        return null;
+    const type = mcp.type;
+    if (type === "stdio") {
+        const command = mcp.command;
+        const args = mcp.args;
+        if (!command)
+            return null;
+        return {
+            type: "stdio",
+            command,
+            args: args ?? ["-y", "@anthropic-ai/cursor-ide-browser"],
+        };
+    }
+    return null;
+}
+function mergeMcpConfig(existing, capability, entry) {
+    const servers = { ...(existing.mcpServers ?? {}) };
+    const key = capability === "browser" ? "cursor-ide-browser" : `capability-${capability}`;
+    if (!servers[key])
+        servers[key] = entry;
+    return { ...existing, mcpServers: servers };
+}
+//# sourceMappingURL=environment.js.map

package/dist/cli/environment.js.map

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

package/dist/cli/index.d.ts

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

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

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