npm - memax-cli - Versions diffs - 0.1.0-alpha.3 → 0.1.0-alpha.30 - Mend

memax-cli 0.1.0-alpha.3 → 0.1.0-alpha.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (127) hide show

package/assets/skills/memax-memory/SKILL.md +154 -0
package/dist/commands/agent-sessions.d.ts +32 -0
package/dist/commands/agent-sessions.d.ts.map +1 -0
package/dist/commands/agent-sessions.js +761 -0
package/dist/commands/agent-sessions.js.map +1 -0
package/dist/commands/agent-sessions.test.d.ts +2 -0
package/dist/commands/agent-sessions.test.d.ts.map +1 -0
package/dist/commands/agent-sessions.test.js +82 -0
package/dist/commands/agent-sessions.test.js.map +1 -0
package/dist/commands/auth.d.ts +1 -0
package/dist/commands/auth.d.ts.map +1 -1
package/dist/commands/auth.js +14 -7
package/dist/commands/auth.js.map +1 -1
package/dist/commands/capture.d.ts +17 -0
package/dist/commands/capture.d.ts.map +1 -0
package/dist/commands/capture.js +61 -0
package/dist/commands/capture.js.map +1 -0
package/dist/commands/delete.d.ts +1 -1
package/dist/commands/delete.d.ts.map +1 -1
package/dist/commands/delete.js +22 -5
package/dist/commands/delete.js.map +1 -1
package/dist/commands/hub.d.ts +4 -0
package/dist/commands/hub.d.ts.map +1 -0
package/dist/commands/hub.js +53 -0
package/dist/commands/hub.js.map +1 -0
package/dist/commands/list.d.ts +2 -1
package/dist/commands/list.d.ts.map +1 -1
package/dist/commands/list.js +35 -8
package/dist/commands/list.js.map +1 -1
package/dist/commands/login.d.ts.map +1 -1
package/dist/commands/login.js +27 -5
package/dist/commands/login.js.map +1 -1
package/dist/commands/mcp.d.ts.map +1 -1
package/dist/commands/mcp.js +275 -42
package/dist/commands/mcp.js.map +1 -1
package/dist/commands/push.d.ts +4 -1
package/dist/commands/push.d.ts.map +1 -1
package/dist/commands/push.js +51 -11
package/dist/commands/push.js.map +1 -1
package/dist/commands/recall.d.ts +7 -0
package/dist/commands/recall.d.ts.map +1 -1
package/dist/commands/recall.js +164 -39
package/dist/commands/recall.js.map +1 -1
package/dist/commands/recall.test.d.ts +2 -0
package/dist/commands/recall.test.d.ts.map +1 -0
package/dist/commands/recall.test.js +31 -0
package/dist/commands/recall.test.js.map +1 -0
package/dist/commands/setup-hooks.d.ts +12 -0
package/dist/commands/setup-hooks.d.ts.map +1 -0
package/dist/commands/setup-hooks.js +193 -0
package/dist/commands/setup-hooks.js.map +1 -0
package/dist/commands/setup-instructions.d.ts +21 -0
package/dist/commands/setup-instructions.d.ts.map +1 -0
package/dist/commands/setup-instructions.js +172 -0
package/dist/commands/setup-instructions.js.map +1 -0
package/dist/commands/setup-mcp.d.ts +14 -0
package/dist/commands/setup-mcp.d.ts.map +1 -0
package/dist/commands/setup-mcp.js +278 -0
package/dist/commands/setup-mcp.js.map +1 -0
package/dist/commands/setup-types.d.ts +20 -0
package/dist/commands/setup-types.d.ts.map +1 -0
package/dist/commands/setup-types.js +60 -0
package/dist/commands/setup-types.js.map +1 -0
package/dist/commands/setup.d.ts +6 -1
package/dist/commands/setup.d.ts.map +1 -1
package/dist/commands/setup.js +146 -306
package/dist/commands/setup.js.map +1 -1
package/dist/commands/show.d.ts.map +1 -1
package/dist/commands/show.js +10 -13
package/dist/commands/show.js.map +1 -1
package/dist/commands/sync.d.ts +33 -2
package/dist/commands/sync.d.ts.map +1 -1
package/dist/commands/sync.js +1066 -119
package/dist/commands/sync.js.map +1 -1
package/dist/commands/sync.test.d.ts +2 -0
package/dist/commands/sync.test.d.ts.map +1 -0
package/dist/commands/sync.test.js +130 -0
package/dist/commands/sync.test.js.map +1 -0
package/dist/commands/topic.d.ts +20 -0
package/dist/commands/topic.d.ts.map +1 -0
package/dist/commands/topic.js +87 -0
package/dist/commands/topic.js.map +1 -0
package/dist/index.js +131 -14
package/dist/index.js.map +1 -1
package/dist/lib/client.d.ts +7 -0
package/dist/lib/client.d.ts.map +1 -0
package/dist/lib/client.js +72 -0
package/dist/lib/client.js.map +1 -0
package/dist/lib/config.d.ts +42 -0
package/dist/lib/config.d.ts.map +1 -1
package/dist/lib/config.js +63 -0
package/dist/lib/config.js.map +1 -1
package/dist/lib/project-context.d.ts +50 -0
package/dist/lib/project-context.d.ts.map +1 -0
package/dist/lib/project-context.js +201 -0
package/dist/lib/project-context.js.map +1 -0
package/dist/lib/project-context.test.d.ts +2 -0
package/dist/lib/project-context.test.d.ts.map +1 -0
package/dist/lib/project-context.test.js +75 -0
package/dist/lib/project-context.test.js.map +1 -0
package/dist/lib/prompt.d.ts +7 -0
package/dist/lib/prompt.d.ts.map +1 -0
package/dist/lib/prompt.js +41 -0
package/dist/lib/prompt.js.map +1 -0
package/package.json +17 -13
package/.vscode/mcp.json +0 -8
package/dist/lib/api.d.ts +0 -4
package/dist/lib/api.d.ts.map +0 -1
package/dist/lib/api.js +0 -95
package/dist/lib/api.js.map +0 -1
package/src/commands/auth.ts +0 -92
package/src/commands/config.ts +0 -27
package/src/commands/delete.ts +0 -20
package/src/commands/hook.ts +0 -243
package/src/commands/list.ts +0 -38
package/src/commands/login.ts +0 -162
package/src/commands/mcp.ts +0 -357
package/src/commands/push.ts +0 -82
package/src/commands/recall.ts +0 -163
package/src/commands/setup.ts +0 -682
package/src/commands/show.ts +0 -35
package/src/commands/sync.ts +0 -403
package/src/index.ts +0 -192
package/src/lib/api.ts +0 -110
package/src/lib/config.ts +0 -61
package/src/lib/credentials.ts +0 -42
package/tsconfig.json +0 -9

package/src/commands/login.ts DELETED Viewed

@@ -1,162 +0,0 @@
-import { createServer } from "node:http";
-import { loadConfig } from "../lib/config.js";
-import { saveCredentials } from "../lib/credentials.js";
-interface TokenPair {
-  access_token: string;
-  refresh_token: string;
-  expires_in: number;
-}
-export async function loginCommand(): Promise<void> {
-  const config = loadConfig();
-  const apiUrl = config.api_url;
-  // Start a temporary local server to receive the OAuth callback
-  const port = await findFreePort();
-  const callbackUrl = `http://localhost:${port}/callback`;
-  const tokenPromise = new Promise<TokenPair>((resolve, reject) => {
-    const server = createServer(async (req, res) => {
-      const url = new URL(req.url!, `http://localhost:${port}`);
-      if (url.pathname === "/callback") {
-        const code = url.searchParams.get("code");
-        if (code) {
-          // Exchange the one-time code for tokens via POST
-          try {
-            const exchangeRes = await fetch(`${apiUrl}/v1/auth/exchange`, {
-              method: "POST",
-              headers: { "Content-Type": "application/json" },
-              body: JSON.stringify({ code }),
-            });
-            const json = (await exchangeRes.json()) as {
-              data?: TokenPair;
-              error?: { message: string };
-            };
-            if (json.data) {
-              res.writeHead(200, { "Content-Type": "text/html" });
-              res.end(`
-                  <html><body style="font-family: system-ui; display: flex; align-items: center; justify-content: center; height: 100vh; margin: 0;">
-                    <div style="text-align: center;">
-                      <h2 style="font-weight: 600;">Logged in to Memax</h2>
-                      <p style="color: #64748b;">You can close this tab and return to your terminal.</p>
-                    </div>
-                  </body></html>
-                `);
-              resolve(json.data);
-            } else {
-              res.writeHead(400, { "Content-Type": "text/html" });
-              res.end(
-                `<html><body><h2>Login failed</h2><p>${json.error?.message ?? "Token exchange failed."}</p></body></html>`,
-              );
-              reject(
-                new Error(json.error?.message ?? "Token exchange failed."),
-              );
-            }
-          } catch (err) {
-            res.writeHead(500, { "Content-Type": "text/html" });
-            res.end(
-              "<html><body><h2>Login failed</h2><p>Could not reach Memax API.</p></body></html>",
-            );
-            reject(new Error("Could not reach Memax API for token exchange."));
-          }
-        } else {
-          res.writeHead(400, { "Content-Type": "text/html" });
-          res.end(
-            "<html><body><h2>Login failed</h2><p>No authorization code received.</p></body></html>",
-          );
-          reject(new Error("No authorization code received from callback."));
-        }
-        // Close the server and force-kill connections so the process exits
-        setTimeout(() => {
-          server.close();
-          server.closeAllConnections();
-        }, 500);
-      }
-    });
-    server.listen(port);
-    // Timeout after 2 minutes
-    setTimeout(() => {
-      server.close();
-      reject(
-        new Error("Login timed out — no callback received within 2 minutes."),
-      );
-    }, 120_000);
-  });
-  // Build the GitHub OAuth URL with our local callback as the redirect
-  const authUrl = `${apiUrl}/v1/auth/github?redirect_uri=${encodeURIComponent(callbackUrl)}`;
-  console.log("\n  Opening browser for GitHub login...\n");
-  console.log(`  If the browser doesn't open, visit:\n  ${authUrl}\n`);
-  // Try to open the browser
-  try {
-    const { exec } = await import("node:child_process");
-    const cmd =
-      process.platform === "darwin"
-        ? `open "${authUrl}"`
-        : process.platform === "win32"
-          ? `start "${authUrl}"`
-          : `xdg-open "${authUrl}"`;
-    exec(cmd);
-  } catch {
-    // Browser open failed — user can copy the URL
-  }
-  try {
-    const tokens = await tokenPromise;
-    saveCredentials({
-      access_token: tokens.access_token,
-      refresh_token: tokens.refresh_token,
-      expires_at: Date.now() + tokens.expires_in * 1000,
-    });
-    console.log(
-      "  Logged in successfully. Credentials saved to ~/.memax/credentials.json\n",
-    );
-  } catch (err) {
-    console.error(`  Login failed: ${(err as Error).message}\n`);
-    process.exit(1);
-  }
-}
-export async function logoutCommand(): Promise<void> {
-  const { clearCredentials } = await import("../lib/credentials.js");
-  clearCredentials();
-  console.log("  Logged out. Credentials cleared.\n");
-}
-export async function whoamiCommand(): Promise<void> {
-  const { loadCredentials } = await import("../lib/credentials.js");
-  const { apiGet } = await import("../lib/api.js");
-  const creds = loadCredentials();
-  if (!creds?.access_token) {
-    console.log("  Not logged in. Run: memax login\n");
-    return;
-  }
-  try {
-    const user = await apiGet<{ name: string; email: string }>("/v1/auth/me");
-    console.log(`  ${user.name} (${user.email})\n`);
-  } catch {
-    console.log("  Session expired or invalid. Run: memax login\n");
-  }
-}
-async function findFreePort(): Promise<number> {
-  return new Promise((resolve) => {
-    const server = createServer();
-    server.listen(0, () => {
-      const addr = server.address();
-      const port = typeof addr === "object" && addr ? addr.port : 0;
-      server.close(() => resolve(port));
-    });
-  });
-}

package/src/commands/mcp.ts DELETED Viewed

@@ -1,357 +0,0 @@
-import { Command } from "commander";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-import { apiGet, apiPost } from "../lib/api.js";
-interface RecallResult {
-  notes: Array<{
-    id: string;
-    title: string;
-    chunk_content: string;
-    heading_chain: string;
-    relevance_score: number;
-    category: string;
-    source: string;
-    age: string;
-  }>;
-  query_metadata: {
-    intent: string;
-    total_candidates: number;
-    latency_ms: number;
-  };
-}
-interface NoteResult {
-  id: string;
-  title: string;
-  category: string;
-  source: string;
-  tags: string[];
-  summary: string;
-  created_at: string;
-}
-function createServer(): Server {
-  const server = new Server(
-    { name: "memax", version: "0.0.1" },
-    { capabilities: { tools: {} } },
-  );
-  server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: [
-      {
-        name: "memax_recall",
-        description:
-          "Search the user's Memax knowledge base with a natural language query. " +
-          "Returns relevant memories ranked by relevance. Use this when you need " +
-          "background information about the project, team processes, or past decisions.",
-        inputSchema: {
-          type: "object" as const,
-          properties: {
-            query: {
-              type: "string",
-              description: "Natural language search query",
-            },
-            limit: {
-              type: "number",
-              description: "Max results to return (default 5)",
-            },
-            category: {
-              type: "string",
-              description:
-                "Filter by category prefix (e.g. 'core', 'decisions', 'process')",
-            },
-          },
-          required: ["query"],
-        },
-      },
-      {
-        name: "memax_push",
-        description:
-          "Save a piece of knowledge to the user's Memax knowledge base. " +
-          "Auto-categorized by AI if no category is provided.",
-        inputSchema: {
-          type: "object" as const,
-          properties: {
-            content: {
-              type: "string",
-              description: "The knowledge content to save",
-            },
-            title: {
-              type: "string",
-              description: "Optional title (auto-generated if omitted)",
-            },
-            category: {
-              type: "string",
-              description:
-                "Category (e.g. 'decisions/adr', 'core/architecture'). Auto-detected if omitted.",
-            },
-            tags: {
-              type: "array",
-              items: { type: "string" },
-              description: "Tags for the memory",
-            },
-          },
-          required: ["content"],
-        },
-      },
-      {
-        name: "memax_get",
-        description:
-          "Get the full content of a specific note by ID. " +
-          "Use this after memax_recall to read the complete content of a relevant memory.",
-        inputSchema: {
-          type: "object" as const,
-          properties: {
-            id: {
-              type: "string",
-              description:
-                "The note ID (from memax_recall or memax_search results)",
-            },
-          },
-          required: ["id"],
-        },
-      },
-      {
-        name: "memax_search",
-        description:
-          "List notes filtered by category or tags. " +
-          "For browsing and structured lookups, not semantic search. " +
-          "Use memax_recall for natural language queries instead.",
-        inputSchema: {
-          type: "object" as const,
-          properties: {
-            category: {
-              type: "string",
-              description: "Filter by category prefix",
-            },
-            limit: {
-              type: "number",
-              description: "Max results to return (default 10)",
-            },
-          },
-        },
-      },
-    ],
-  }));
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    switch (name) {
-      case "memax_recall": {
-        const typedArgs = args as {
-          query: string;
-          limit?: number;
-          category?: string;
-        };
-        try {
-          const result = await apiPost<RecallResult>("/v1/recall", {
-            query: typedArgs.query,
-            limit: typedArgs.limit ?? 5,
-            category: typedArgs.category ?? "",
-            source: "mcp",
-            working_dir: process.cwd(),
-          });
-          const notes = result.notes ?? [];
-          if (notes.length === 0) {
-            return {
-              content: [{ type: "text" as const, text: "No results found." }],
-            };
-          }
-          const formatted = notes
-            .map((n, i) => {
-              const score = (n.relevance_score * 100).toFixed(0);
-              const heading = n.heading_chain ? ` — ${n.heading_chain}` : "";
-              return (
-                `[${i + 1}] ${n.title} [${n.category}, ${score}%, ${n.age}] (id: ${n.id})${heading}\n` +
-                n.chunk_content
-              );
-            })
-            .join("\n\n");
-          return { content: [{ type: "text" as const, text: formatted }] };
-        } catch (err) {
-          return {
-            content: [
-              {
-                type: "text" as const,
-                text: `Recall failed: ${(err as Error).message}`,
-              },
-            ],
-            isError: true,
-          };
-        }
-      }
-      case "memax_push": {
-        const typedArgs = args as {
-          content: string;
-          title?: string;
-          category?: string;
-          tags?: string[];
-        };
-        try {
-          const note = await apiPost<NoteResult>("/v1/notes", {
-            content: typedArgs.content,
-            title: typedArgs.title ?? "",
-            category: typedArgs.category ?? "",
-            tags: typedArgs.tags ?? [],
-            source: "mcp",
-          });
-          return {
-            content: [
-              {
-                type: "text" as const,
-                text: `Saved: ${note.title} (id: ${note.id})`,
-              },
-            ],
-          };
-        } catch (err) {
-          return {
-            content: [
-              {
-                type: "text" as const,
-                text: `Push failed: ${(err as Error).message}`,
-              },
-            ],
-            isError: true,
-          };
-        }
-      }
-      case "memax_get": {
-        const typedArgs = args as { id: string };
-        try {
-          const note = await apiGet<{
-            id: string;
-            title: string;
-            content: string;
-            summary: string;
-            category: string;
-            tags: string[];
-            source: string;
-            source_path: string;
-            created_at: string;
-            updated_at: string;
-          }>(`/v1/notes/${typedArgs.id}`);
-          const parts = [
-            `# ${note.title}`,
-            `Category: ${note.category} | Source: ${note.source} | Created: ${note.created_at}`,
-          ];
-          if (note.tags?.length > 0) {
-            parts.push(`Tags: ${note.tags.join(", ")}`);
-          }
-          if (note.source_path) {
-            parts.push(`Source: ${note.source_path}`);
-          }
-          if (note.summary) {
-            parts.push(`\n## Summary\n${note.summary}`);
-          }
-          parts.push(`\n## Content\n${note.content}`);
-          return {
-            content: [{ type: "text" as const, text: parts.join("\n") }],
-          };
-        } catch (err) {
-          return {
-            content: [
-              {
-                type: "text" as const,
-                text: `Get failed: ${(err as Error).message}`,
-              },
-            ],
-            isError: true,
-          };
-        }
-      }
-      case "memax_search": {
-        const typedArgs = args as {
-          category?: string;
-          limit?: number;
-        };
-        try {
-          const notes = (await apiGet<NoteResult[]>("/v1/notes")) ?? [];
-          let filtered = notes;
-          if (typedArgs.category) {
-            filtered = notes.filter((n) =>
-              n.category.startsWith(typedArgs.category!),
-            );
-          }
-          const limited = filtered.slice(0, typedArgs.limit ?? 10);
-          if (limited.length === 0) {
-            return {
-              content: [{ type: "text" as const, text: "No notes found." }],
-            };
-          }
-          const formatted = limited
-            .map(
-              (n) => `- ${n.title} [${n.category}] — ${n.source} (id: ${n.id})`,
-            )
-            .join("\n");
-          return { content: [{ type: "text" as const, text: formatted }] };
-        } catch (err) {
-          return {
-            content: [
-              {
-                type: "text" as const,
-                text: `Search failed: ${(err as Error).message}`,
-              },
-            ],
-            isError: true,
-          };
-        }
-      }
-      default:
-        return {
-          content: [{ type: "text" as const, text: `Unknown tool: ${name}` }],
-          isError: true,
-        };
-    }
-  });
-  return server;
-}
-async function mcpServeCommand(): Promise<void> {
-  const server = createServer();
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  // Keep the process alive — some agent launchers close stdin early
-  // which makes Node think the event loop is empty and exit.
-  await new Promise<void>((resolve) => {
-    process.on("SIGINT", resolve);
-    process.on("SIGTERM", resolve);
-    // Also resolve if stdin closes (transport disconnected)
-    process.stdin.on("end", resolve);
-  });
-  await server.close();
-}
-export function registerMcpCommand(program: Command): void {
-  const mcp = program
-    .command("mcp")
-    .description("Model Context Protocol server for AI agents");
-  mcp
-    .command("serve")
-    .description("Start MCP server on stdio")
-    .action(mcpServeCommand);
-}

package/src/commands/push.ts DELETED Viewed

@@ -1,82 +0,0 @@
-import chalk from "chalk";
-import { readFileSync } from "node:fs";
-import { basename } from "node:path";
-import { apiPost } from "../lib/api.js";
-import type { Note } from "@memaxlabs/shared";
-interface PushOptions {
-  file?: string;
-  category?: string;
-  tags?: string;
-  ttl?: string;
-  stdin?: boolean;
-  title?: string;
-}
-export async function pushCommand(options: PushOptions): Promise<void> {
-  let content: string;
-  let title = options.title ?? "";
-  let sourcePath = "";
-  if (options.file) {
-    try {
-      content = readFileSync(options.file, "utf-8");
-      sourcePath = options.file;
-      if (!title) {
-        title = basename(options.file);
-      }
-    } catch (err) {
-      console.error(chalk.red(`Error reading file: ${options.file}`));
-      process.exit(1);
-    }
-  } else if (options.stdin || !process.stdin.isTTY) {
-    const chunks: Buffer[] = [];
-    for await (const chunk of process.stdin) {
-      chunks.push(chunk);
-    }
-    content = Buffer.concat(chunks).toString("utf-8");
-  } else {
-    console.error(chalk.red("Provide --file <path> or pipe content via stdin"));
-    process.exit(1);
-  }
-  if (!content.trim()) {
-    console.error(chalk.red("No content to push"));
-    process.exit(1);
-  }
-  const tags = options.tags ? options.tags.split(",").map((t) => t.trim()) : [];
-  // Auto-detect URL content: single-line http(s) URL -> content_type "link"
-  const trimmed = content.trim();
-  const isURL =
-    (trimmed.startsWith("http://") || trimmed.startsWith("https://")) &&
-    !trimmed.includes("\n");
-  let contentType = sourcePath.endsWith(".md") ? "markdown" : "text";
-  if (isURL) {
-    contentType = "link";
-  }
-  try {
-    const note = await apiPost<Note>("/v1/notes", {
-      content,
-      title,
-      category: options.category ?? "",
-      tags,
-      source: "cli",
-      source_path: sourcePath,
-      content_type: contentType,
-    });
-    console.log(chalk.green("Saved"), chalk.bold(note.title));
-    console.log(
-      chalk.gray(
-        `  id: ${note.id}  category: ${note.category}  source: ${note.source}`,
-      ),
-    );
-  } catch (err) {
-    console.error(chalk.red(`Push failed: ${(err as Error).message}`));
-    process.exit(1);
-  }
-}