xmemory-cli 0.1.0

package/bin/xmemory-cli.js

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { Command } = require("commander");
+const { loadConfig, Client } = require("../src/index");
+const { SearchCommand } = require("../src/commands/search");
+const { AddCommand } = require("../src/commands/add");
+const { ListCommand } = require("../src/commands/list");
+const { DeleteCommand } = require("../src/commands/delete");
+const { GetCommand } = require("../src/commands/get");
+const { SpacesCommand } = require("../src/commands/spaces");
+const { TagsCommand } = require("../src/commands/tags");
+const { GraphCommand } = require("../src/commands/graph");
+const { readFileSync } = require("fs");
+const path = require("path");
+
+const { version } = JSON.parse(
+  readFileSync(path.join(__dirname, "..", "package.json"), "utf-8"),
+);
+
+const program = new Command();
+
+program
+  .name("xmemory-cli")
+  .description(
+    "xMemory CLI - Command-line interface for xMemory knowledge base",
+  )
+  .version(version)
+  .option("-c, --config <path>", "Path to config file")
+  .option("--api-base-url <url>", "API base URL", "http://localhost:50505/api")
+  .option("-s, --space <name>", "Default space name")
+  .option("--output <format>", "Output format: json or text", "text")
+  .hook("preAction", (thisCommand) => {
+    const opts = thisCommand.opts();
+    const config = loadConfig({
+      apiBaseUrl: opts.apiBaseUrl,
+      defaultSpace: opts.space,
+    });
+
+    program.mockClient = new Client(config);
+    program.mockConfig = config;
+  });
+
+program
+  .command("search <query>")
+  .description("Search memories by query")
+  .option("-l, --limit <number>", "Maximum number of results", "5")
+  .option("-s, --space <name>", "Filter by space")
+  .option("--json", "Output as JSON")
+  .action(async (query, opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await SearchCommand(client, query, {
+        limit: parseInt(opts.limit),
+        space: opts.space,
+        json: opts.json,
+      });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("add <content>")
+  .description("Add a new memory")
+  .option("-s, --space <name>", "Space name")
+  .option("--space-id <id>", "Space ID")
+  .option("-t, --tags <tags...>", "Tags")
+  .option("--source <source>", "Source of the memory")
+  .option("--json", "Output as JSON")
+  .action(async (content, opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await AddCommand(client, content, {
+        space: opts.space,
+        spaceId: opts.spaceId,
+        tags: opts.tags,
+        source: opts.source,
+        json: opts.json,
+      });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("list")
+  .description("List memories")
+  .option("-s, --space <name>", "Space name to list memories from")
+  .option("--json", "Output as JSON")
+  .action(async (opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await ListCommand(client, { space: opts.space, json: opts.json });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("get <id>")
+  .description("Get a single memory by ID")
+  .option("--json", "Output as JSON")
+  .action(async (id, opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await GetCommand(client, id, { json: opts.json });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("delete <id>")
+  .description("Delete a memory by ID")
+  .option("--json", "Output as JSON")
+  .action(async (id, opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await DeleteCommand(client, id, { json: opts.json });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+const spacesCmd = program.command("spaces").description("Manage spaces");
+
+spacesCmd
+  .command("list")
+  .description("List all spaces")
+  .option("--json", "Output as JSON")
+  .action(async (opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await SpacesCommand(client, { action: "list", json: opts.json });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+spacesCmd
+  .command("create <name>")
+  .description("Create a new space")
+  .option("-d, --description <text>", "Space description")
+  .option("--json", "Output as JSON")
+  .action(async (name, opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await SpacesCommand(client, {
+        action: "create",
+        name,
+        description: opts.description,
+        json: opts.json,
+      });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+spacesCmd
+  .command("delete <id>")
+  .description("Delete a space by ID")
+  .option("--json", "Output as JSON")
+  .action(async (id, opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await SpacesCommand(client, { action: "delete", id, json: opts.json });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+spacesCmd
+  .command("info <id>")
+  .description("Get space details by ID")
+  .option("--json", "Output as JSON")
+  .action(async (id, opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await SpacesCommand(client, { action: "info", id, json: opts.json });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("tags")
+  .description("List popular tags")
+  .option("--space-id <id>", "Filter by space ID")
+  .option("--json", "Output as JSON")
+  .action(async (opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await TagsCommand(client, { spaceId: opts.spaceId, json: opts.json });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("graph")
+  .description("Query the knowledge graph")
+  .option("-e, --entity <name>", "Entity name to look up")
+  .option("-t, --tag <tag>", "Filter by tag")
+  .option("--space-id <id>", "Filter by space ID")
+  .option("--json", "Output as JSON")
+  .action(async (opts) => {
+    const client = program.mockClient;
+    if (!client) {
+      console.error("Error: Client not initialized");
+      process.exit(1);
+    }
+    try {
+      await GraphCommand(client, {
+        entityName: opts.entity,
+        tag: opts.tag,
+        spaceId: opts.spaceId,
+        json: opts.json,
+      });
+    } catch (err) {
+      console.error("Error:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  });
+
+program.parse();