memoire-ai 0.1.0

package/dist/login.js

@@ -0,0 +1,93 @@
+import { execFileSync } from 'node:child_process';
+import { setTimeout as delay } from 'node:timers/promises';
+import { install } from './configure.js';
+import { detectClient } from './detect.js';
+export async function runLoginCommand(opts, deps = {}) {
+    const logger = deps.logger ?? console;
+    const fetchImpl = deps.fetchImpl ?? fetch;
+    const sleep = deps.sleep ?? ((ms) => delay(ms));
+    const installImpl = deps.installImpl ?? install;
+    const client = opts.client ?? (await (deps.detectClient ?? detectClient)());
+    if (!client) {
+        throw new Error('Could not detect client. Use --client to specify one.');
+    }
+    logger.log('\n  Memoire Login\n');
+    const startRes = await fetchImpl(`${opts.apiUrl.replace(/\/$/, '')}/v1/setup/device-auth/start`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ client }),
+    });
+    if (!startRes.ok) {
+        const body = await startRes.text().catch(() => '');
+        throw new Error(`Could not start device auth (${startRes.status}): ${body || 'unknown error'}`);
+    }
+    const start = await startRes.json();
+    const pollIntervalMs = Math.max(1000, (start.poll_interval_seconds ?? 2) * 1000);
+    logger.log(`  Your code: ${start.user_code}`);
+    logger.log(`  Verification URL: ${start.verification_url}`);
+    logger.log();
+    const opened = await (deps.openExternal ?? openExternalInBrowser)(start.verification_url);
+    if (opened) {
+        logger.log('  Opening browser...');
+    }
+    else {
+        logger.log('  Could not open a browser automatically. Open the verification URL manually.');
+    }
+    logger.log('  Waiting for approval...\n');
+    for (;;) {
+        const exchangeRes = await fetchImpl(`${opts.apiUrl.replace(/\/$/, '')}/v1/setup/device-auth/exchange`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ session_secret: start.session_secret }),
+        });
+        let exchangeBody = null;
+        try {
+            exchangeBody = await exchangeRes.json();
+        }
+        catch {
+            exchangeBody = null;
+        }
+        if (exchangeRes.status === 202 || exchangeBody?.status === 'pending') {
+            await sleep(pollIntervalMs);
+            continue;
+        }
+        if (exchangeRes.status === 410 || exchangeBody?.status === 'expired') {
+            throw new Error('Login session expired. Run `memoire login` again.');
+        }
+        if (!exchangeRes.ok) {
+            throw new Error(`Login failed during exchange (${exchangeRes.status}).`);
+        }
+        if (exchangeBody?.status !== 'approved' || !exchangeBody.api_key) {
+            throw new Error('Login approval succeeded but no API key was returned.');
+        }
+        await installImpl({
+            client: client,
+            apiKey: exchangeBody.api_key,
+            apiUrl: opts.apiUrl,
+            orgId: exchangeBody.org_id,
+            projectId: exchangeBody.project_id,
+            userName: opts.userName,
+            userEmail: opts.userEmail,
+        });
+        logger.log('  Login complete.\n');
+        return;
+    }
+}
+async function openExternalInBrowser(url) {
+    try {
+        if (process.platform === 'darwin') {
+            execFileSync('open', [url], { stdio: 'ignore' });
+            return true;
+        }
+        if (process.platform === 'win32') {
+            execFileSync('cmd', ['/c', 'start', '', url], { stdio: 'ignore' });
+            return true;
+        }
+        execFileSync('xdg-open', [url], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=login.js.map

package/dist/login.js.map

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

package/dist/manual.d.ts

@@ -0,0 +1,15 @@
+import type { MemoireConfig } from '@memoire/shared';
+export interface ManualSetupOptions {
+    client?: MemoireConfig['client'];
+    configPath?: string;
+}
+interface ManualSetupDeps {
+    readConfig?: (opts?: {
+        configPath?: string;
+    }) => MemoireConfig;
+    detectClient?: () => Promise<MemoireConfig['client'] | null>;
+    cwd?: string;
+}
+export declare function runManualSetupCommand(options?: ManualSetupOptions, deps?: ManualSetupDeps): Promise<string>;
+export {};
+//# sourceMappingURL=manual.d.ts.map

package/dist/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../src/manual.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,aAAa,CAAC;IAC/D,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,kBAAuB,EAChC,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,CAAC,CAyJjB"}

package/dist/manual.js

@@ -0,0 +1,143 @@
+import { detectClient } from './detect.js';
+import { getLocalConfigPath, readLocalConfig } from './local-config.js';
+export async function runManualSetupCommand(options = {}, deps = {}) {
+    const config = deps.readConfig?.({ configPath: options.configPath })
+        ?? readLocalConfig({ configPath: options.configPath });
+    const detectedClient = await (deps.detectClient ?? detectClient)();
+    const resolvedClient = (options.client ?? detectedClient ?? config.client);
+    const configPath = getLocalConfigPath({ configPath: options.configPath });
+    const repoRoot = config.repo_root ?? deps.cwd ?? process.cwd();
+    const clientId = config.client_id ?? '<client-id>';
+    const lines = [
+        'Memoire manual setup',
+        `Client: ${resolvedClient}`,
+        `Config path: ${configPath}`,
+        `Workspace: ${repoRoot}`,
+        `API URL: ${config.api_url}`,
+        '',
+    ];
+    if (resolvedClient === 'cursor') {
+        lines.push('Cursor MCP (~/.cursor/mcp.json)');
+        lines.push(JSON.stringify({
+            mcpServers: {
+                memoire: createManagedMcpServerConfig(configPath, 'cursor', clientId),
+            },
+        }, null, 2));
+        lines.push('');
+        lines.push('Cursor hooks (.cursor/hooks.json)');
+        lines.push(JSON.stringify({
+            version: 1,
+            hooks: {
+                beforeSubmitPrompt: [{ command: buildManagedCommand(['memoire', 'hook', 'cursor-before-submit', '--config-path', configPath, '--client', 'cursor', '--client-id', clientId]) }],
+                afterMCPExecution: [{ command: buildManagedCommand(['memoire', 'hook', 'cursor-after-mcp', '--config-path', configPath, '--client', 'cursor', '--client-id', clientId]) }],
+                afterShellExecution: [{ command: buildManagedCommand(['memoire', 'hook', 'cursor-after-shell', '--config-path', configPath, '--client', 'cursor', '--client-id', clientId]) }],
+                afterFileEdit: [{ command: buildManagedCommand(['memoire', 'hook', 'cursor-after-file-edit', '--config-path', configPath, '--client', 'cursor', '--client-id', clientId]) }],
+                stop: [{ command: buildManagedCommand(['memoire', 'hook', 'cursor-stop', '--config-path', configPath, '--client', 'cursor', '--client-id', clientId]) }],
+            },
+        }, null, 2));
+    }
+    else if (resolvedClient === 'claude') {
+        lines.push('Claude Code MCP (.mcp.json)');
+        lines.push(JSON.stringify({
+            mcpServers: {
+                memoire: createManagedMcpServerConfig(configPath, 'claude', clientId),
+            },
+        }, null, 2));
+        lines.push('');
+        lines.push('Claude hooks (.claude/settings.local.json)');
+        lines.push(JSON.stringify({
+            hooks: {
+                SessionStart: [
+                    {
+                        matcher: 'startup|clear|compact',
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: buildManagedCommand(['memoire', 'hook', 'claude-session-start', '--config-path', configPath, '--client', 'claude', '--client-id', clientId]),
+                                timeout: 30,
+                            },
+                        ],
+                    },
+                ],
+                UserPromptSubmit: [
+                    {
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: buildManagedCommand(['memoire', 'hook', 'claude-user-prompt', '--config-path', configPath, '--client', 'claude', '--client-id', clientId]),
+                                timeout: 30,
+                            },
+                        ],
+                    },
+                ],
+                PostToolUse: [
+                    {
+                        matcher: '*',
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: buildManagedCommand(['memoire', 'hook', 'claude-post-tool-use', '--config-path', configPath, '--client', 'claude', '--client-id', clientId]),
+                                timeout: 45,
+                            },
+                        ],
+                    },
+                ],
+                Stop: [
+                    {
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: buildManagedCommand(['memoire', 'hook', 'claude-stop', '--config-path', configPath, '--client', 'claude', '--client-id', clientId]),
+                                timeout: 30,
+                            },
+                        ],
+                    },
+                ],
+            },
+        }, null, 2));
+    }
+    else if (resolvedClient === 'codex') {
+        lines.push('Codex native command');
+        lines.push(`codex mcp add memoire --env MEMOIRE_CONFIG_PATH=${quoteCliValue(configPath)} --env MEMOIRE_CLIENT=codex --env MEMOIRE_CLIENT_ID=${quoteCliValue(clientId)} -- npx -y memoire mcp`);
+        lines.push('');
+        lines.push('Codex fallback (~/.codex/config.toml)');
+        lines.push([
+            '[mcp_servers.memoire]',
+            'command = "npx"',
+            'args = ["-y", "memoire", "mcp"]',
+            '',
+            '[mcp_servers.memoire.env]',
+            `MEMOIRE_CONFIG_PATH = ${JSON.stringify(configPath)}`,
+            'MEMOIRE_CLIENT = "codex"',
+            `MEMOIRE_CLIENT_ID = ${JSON.stringify(clientId)}`,
+        ].join('\n'));
+    }
+    else {
+        lines.push('Manual setup');
+        lines.push(JSON.stringify({
+            mcpServers: {
+                memoire: createManagedMcpServerConfig(configPath, resolvedClient, clientId),
+            },
+        }, null, 2));
+    }
+    return lines.join('\n');
+}
+function createManagedMcpServerConfig(configPath, client, clientId) {
+    return {
+        command: 'npx',
+        args: ['-y', 'memoire', 'mcp'],
+        env: {
+            MEMOIRE_CONFIG_PATH: configPath,
+            MEMOIRE_CLIENT: client,
+            MEMOIRE_CLIENT_ID: clientId,
+        },
+    };
+}
+function buildManagedCommand(args) {
+    const quoted = args.map((arg) => JSON.stringify(arg)).join(' ');
+    return `npx -y ${quoted}`;
+}
+function quoteCliValue(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=manual.js.map

package/dist/manual.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,5 @@
+import { runMemoireStdioServer } from '@memoire/mcp-runtime';
+export declare function runMcpCommand(env?: NodeJS.ProcessEnv, deps?: {
+    runServer?: typeof runMemoireStdioServer;
+}): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,wBAAsB,aAAa,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,OAAO,qBAAqB,CAAC;CACrC,GACL,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/mcp.js

@@ -0,0 +1,18 @@
+import { runMemoireStdioServer } from '@memoire/mcp-runtime';
+import { readLocalConfig } from './local-config.js';
+export async function runMcpCommand(env = process.env, deps = {}) {
+    const config = readLocalConfig({
+        configPath: env.MEMOIRE_CONFIG_PATH,
+    });
+    const clientId = env.MEMOIRE_CLIENT_ID ?? config.client_id;
+    await (deps.runServer ?? runMemoireStdioServer)({
+        apiUrl: env.MEMOIRE_API_URL ?? config.api_url,
+        apiKey: env.MEMOIRE_API_KEY ?? config.api_key,
+        orgId: env.MEMOIRE_ORG_ID ?? config.org_id,
+        projectId: env.MEMOIRE_PROJECT_ID ?? config.project_id,
+        userId: env.MEMOIRE_USER_ID ?? config.user_id,
+        sessionId: env.MEMOIRE_SESSION_ID,
+        ...(clientId ? { clientId } : {}),
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAyB,OAAO,CAAC,GAAG,EACpC,OAEI,EAAE;IAEN,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,UAAU,EAAE,GAAG,CAAC,mBAAmB;KACpC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,GAAG,CAAC,iBAAiB,IAAI,MAAM,CAAC,SAAS,CAAC;IAE3D,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,qBAAqB,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,OAAO;QAC7C,MAAM,EAAE,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,OAAO;QAC7C,KAAK,EAAE,GAAG,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM;QAC1C,SAAS,EAAE,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,UAAU;QACtD,MAAM,EAAE,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,OAAO;QAC7C,SAAS,EAAE,GAAG,CAAC,kBAAkB;QACjC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "memoire-ai",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Memoire CLI for installing and querying shared AI coding context",
+  "license": "AGPL-3.0",
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/*.test.*",
+    "skills",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "cursor",
+    "claude",
+    "codex",
+    "mcp",
+    "memory"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "memoire": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "yaml": "^2.8.1",
+    "@memoire/collector": "0.1.0",
+    "@memoire/dashboard": "0.1.0",
+    "@memoire/sdk": "0.1.0",
+    "@memoire/shared": "0.1.0",
+    "@memoire/mcp-runtime": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --test dist/*.test.js"
+  }
+}

package/skills/use-memoire/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: use-memoire
+description: Search and contribute to shared project memory across your team's AI agents
+activation: When you need project context, past decisions, team conventions, or want to record what you learned
+---
+
+# Use Memoire
+
+## When to Activate
+
+- You need project context, architecture decisions, or team conventions
+- You want to check if someone already tried an approach (avoid repeating failures)
+- You are starting a new task and need to understand current project state
+- You finished work and want to record decisions, observations, or failed attempts
+- You need to hand off context to another agent or teammate
+
+## Workflow
+
+### 1. Search — find relevant context before you start
+
+```
+search_context(query: "your task description")
+project_profile()                              # architecture, conventions, focus
+assemble_context(query: "optional focus")      # prompt-ready context block
+```
+
+### 2. Use — apply what you found
+
+- Follow conventions already recorded in memory
+- Avoid approaches that were previously attempted and failed
+- Build on existing architectural decisions
+
+### 3. Record — persist what you learned
+
+```
+write_memory_event(
+  event_type: "decision" | "observation" | "attempt" | "convention",
+  content: "what happened and why",
+  files_modified: ["src/foo.ts"],
+  concepts: ["auth", "jwt"]
+)
+```
+
+Record **failed attempts** — they prevent teammates from repeating mistakes.
+
+### 4. Handoff — pass context forward (optional)
+
+```
+save_handoff(query: "focus area", title: "Auth refactor status")
+```
+
+## Tool Quick Reference
+
+| Tool | Use For |
+|------|---------|
+| `search_context` | Find past decisions, observations, attempts |
+| `timeline_context` | See recent chronological activity |
+| `project_profile` | Get architecture, conventions, current focus |
+| `project_facts` | Get derived static/dynamic project facts |
+| `assemble_context` | Get a prompt-ready context block |
+| `oracle_research` | Deep research: "why did we...", "how does..." |
+| `tracer_search` | Trace decision/concept history across events |
+| `write_memory_event` | Record a decision, observation, attempt, or convention |
+| `write_scratchpad` | Write a temporary note (expires in 24h) |
+| `get_scratchpad` | Read temporary notes from teammates |
+| `save_handoff` | Save context bundle for another agent |
+| `list_handoffs` / `get_handoff` | Retrieve saved handoffs |
+| `search_docs` | Search indexed dependency documentation |
+| `index_docs` | Index docs for a package by name |
+| `memory_health` | Check project memory health and coverage |
+| `memoire_advisor` | Analyze code against project conventions |
+
+## Key Rules
+
+- Always search before implementing. Someone may have already solved your problem.
+- Record the "why" behind decisions, not just the "what".
+- Use `attempt` event type for failed or abandoned approaches.
+- Include `files_modified` and `concepts` for better future search recall.
+- Use `write_scratchpad` for ephemeral notes; `write_memory_event` for durable knowledge.