npm - memax-cli - Versions diffs - 0.1.0-alpha.2 → 0.1.0-alpha.21 - Mend

memax-cli 0.1.0-alpha.2 → 0.1.0-alpha.21

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 (97) hide show

package/assets/skills/memax-memory/SKILL.md +154 -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 +60 -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 +32 -7
package/dist/commands/login.js.map +1 -1
package/dist/commands/mcp.d.ts.map +1 -1
package/dist/commands/mcp.js +226 -26
package/dist/commands/mcp.js.map +1 -1
package/dist/commands/push.d.ts +2 -1
package/dist/commands/push.d.ts.map +1 -1
package/dist/commands/push.js +49 -11
package/dist/commands/push.js.map +1 -1
package/dist/commands/recall.d.ts +1 -0
package/dist/commands/recall.d.ts.map +1 -1
package/dist/commands/recall.js +30 -27
package/dist/commands/recall.js.map +1 -1
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 +184 -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 +276 -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 +18 -0
package/dist/commands/setup.d.ts.map +1 -0
package/dist/commands/setup.js +371 -0
package/dist/commands/setup.js.map +1 -0
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 +7 -2
package/dist/commands/sync.d.ts.map +1 -1
package/dist/commands/sync.js +614 -107
package/dist/commands/sync.js.map +1 -1
package/dist/index.js +85 -14
package/dist/index.js.map +1 -1
package/dist/lib/client.d.ts +6 -0
package/dist/lib/client.d.ts.map +1 -0
package/dist/lib/client.js +69 -0
package/dist/lib/client.js.map +1 -0
package/dist/lib/project-context.d.ts +40 -0
package/dist/lib/project-context.d.ts.map +1 -0
package/dist/lib/project-context.js +157 -0
package/dist/lib/project-context.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/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 -159
package/src/commands/mcp.ts +0 -282
package/src/commands/push.ts +0 -82
package/src/commands/recall.ts +0 -160
package/src/commands/show.ts +0 -35
package/src/commands/sync.ts +0 -403
package/src/index.ts +0 -167
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,159 +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 after handling the callback
-        setTimeout(() => server.close(), 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,282 +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_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}]${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_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);
-}
-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);
-  }
-}

package/src/commands/recall.ts DELETED Viewed

@@ -1,160 +0,0 @@
-import chalk from "chalk";
-import { 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 RecallOptions {
-  category?: string;
-  tags?: string;
-  limit?: string;
-  format?: string;
-  includeArchived?: boolean;
-  hook?: boolean;
-  maxTokens?: string;
-}
-export async function recallCommand(
-  query: string | undefined,
-  options: RecallOptions,
-): Promise<void> {
-  if (!query) {
-    // Read from stdin if no query argument
-    if (!process.stdin.isTTY) {
-      const chunks: Buffer[] = [];
-      for await (const chunk of process.stdin) {
-        chunks.push(chunk);
-      }
-      query = Buffer.concat(chunks).toString("utf-8").trim();
-    }
-    if (!query) {
-      console.error(chalk.red('Provide a query: memax recall "your question"'));
-      process.exit(1);
-    }
-  }
-  const limit = parseInt(options.limit ?? "5", 10);
-  try {
-    const result = await apiPost<RecallResult>("/v1/recall", {
-      query,
-      category: options.category ?? "",
-      limit,
-      include_archived: options.includeArchived ?? false,
-      source: options.hook ? "hook" : "cli",
-      working_dir: process.cwd(),
-    });
-    const notes = result.notes ?? [];
-    if (options.format === "json") {
-      console.log(JSON.stringify({ ...result, notes }, null, 2));
-      return;
-    }
-    // Hook mode: output clean context for agent injection
-    if (options.hook) {
-      if (notes.length === 0) return;
-      let output = "<memax-context>\n";
-      output += "## Relevant Context (from Memax)\n\n";
-      for (const note of notes) {
-        const heading = note.heading_chain ? ` — ${note.heading_chain}` : "";
-        output += `### ${note.title} [${note.category}, ${note.age}]${heading}\n`;
-        output += note.chunk_content + "\n\n";
-      }
-      output += "</memax-context>";
-      // Truncate to fit within token budget (1 token ≈ 4 characters)
-      const maxTokens = options.maxTokens
-        ? parseInt(options.maxTokens, 10)
-        : undefined;
-      if (maxTokens) {
-        const maxChars = maxTokens * 4;
-        if (output.length > maxChars) {
-          output =
-            output.substring(0, maxChars - 50) +
-            "\n\n[truncated to fit token budget]\n</memax-context>";
-        }
-      }
-      console.log(output);
-      return;
-    }
-    // Pipe-friendly plain text output when stdout is not a TTY
-    if (!process.stdout.isTTY) {
-      if (notes.length === 0) {
-        return;
-      }
-      for (const note of notes) {
-        const score = (note.relevance_score * 100).toFixed(0);
-        console.log(`${note.title} [${note.category}] ${score}% · ${note.age}`);
-        if (note.heading_chain) {
-          console.log(`  ${note.heading_chain}`);
-        }
-        const lines = note.chunk_content.split("\n").slice(0, 3);
-        for (const line of lines) {
-          console.log(`  ${line}`);
-        }
-        console.log();
-      }
-      return;
-    }
-    // Human-readable output
-    if (notes.length === 0) {
-      console.log(chalk.yellow("No results found."));
-      console.log(
-        chalk.gray(
-          `  Searched ${result.query_metadata.total_candidates} chunks in ${result.query_metadata.latency_ms}ms`,
-        ),
-      );
-      return;
-    }
-    console.log(
-      chalk.blue(`${notes.length} result${notes.length > 1 ? "s" : ""}`),
-      chalk.gray(
-        `(${result.query_metadata.total_candidates} chunks searched, ${result.query_metadata.latency_ms}ms)`,
-      ),
-    );
-    console.log();
-    for (const note of notes) {
-      const score = (note.relevance_score * 100).toFixed(0);
-      console.log(
-        chalk.bold(note.title),
-        chalk.gray(`[${note.category}]`),
-        chalk.cyan(`${score}%`),
-        chalk.gray(`· ${note.age}`),
-      );
-      if (note.heading_chain) {
-        console.log(chalk.gray(`  ${note.heading_chain}`));
-      }
-      // Show first 3 lines of chunk content
-      const lines = note.chunk_content.split("\n").slice(0, 3);
-      for (const line of lines) {
-        console.log(chalk.white(`  ${line}`));
-      }
-      console.log();
-    }
-  } catch (err) {
-    console.error(chalk.red(`Recall failed: ${(err as Error).message}`));
-    process.exit(1);
-  }
-}