@vm0/cli 9.241.7 → 9.241.8

package/memory-XRUIDTIV.js

@@ -1,638 +0,0 @@
-#!/usr/bin/env node
-import { createRequire as __createRequire } from "node:module";
-const require = __createRequire(import.meta.url);
-import {
-  createZeroMemory,
-  forgetZeroMemory,
-  forgetZeroMemoryByPrompt,
-  getZeroMemoryContext,
-  listZeroMemory,
-  listZeroMemoryDocuments,
-  listZeroMemoryForgotten,
-  listZeroMemoryHistory,
-  recallZeroMemory,
-  searchZeroMemory,
-  updateZeroMemory
-} from "./chunk-KNATFPLD.js";
-import "./chunk-LTDQISD7.js";
-import {
-  source_default,
-  withErrorHandler
-} from "./chunk-AMJAGFT7.js";
-import "./chunk-LRHXR7JT.js";
-import {
-  Command
-} from "./chunk-B3W2RUBP.js";
-import {
-  init_esm_shims
-} from "./chunk-DIRAZ3YX.js";
-
-// src/commands/zero/memory/index.ts
-init_esm_shims();
-
-// src/commands/zero/memory/context.ts
-init_esm_shims();
-
-// src/commands/zero/memory/format.ts
-init_esm_shims();
-function formatDate(value) {
-  if (!value) {
-    return "unknown";
-  }
-  return new Intl.DateTimeFormat(void 0, {
-    year: "numeric",
-    month: "short",
-    day: "numeric"
-  }).format(new Date(value));
-}
-function formatKind(kind) {
-  switch (kind) {
-    case "key_fact": {
-      return "key fact";
-    }
-    case "open_loop": {
-      return "open loop";
-    }
-    case "preference": {
-      return "preference";
-    }
-  }
-}
-function sourceSummary(memory) {
-  const source = memory.sources[0];
-  if (!source) {
-    return "no source";
-  }
-  return `${source.provider}:${source.externalId} (${formatDate(source.occurredAt)})`;
-}
-function printMemoryRecall(memories) {
-  if (memories.length === 0) {
-    console.log("No memories found");
-    console.log(
-      source_default.dim(
-        '  Try a broader query, for example: zero memory recall "pricing"'
-      )
-    );
-    return;
-  }
-  console.log(source_default.green(`\u2713 Recalled ${memories.length} memories`));
-  for (const memory of memories) {
-    const entity = memory.relationship.entity.displayName;
-    console.log(`- ${memory.text}`);
-    console.log(
-      source_default.dim(
-        `  ${formatKind(memory.kind)} \xB7 ${entity} \xB7 confidence ${memory.confidence} \xB7 ${sourceSummary(memory)}`
-      )
-    );
-  }
-}
-function printMemoryContext(response) {
-  if (response.context.length === 0) {
-    console.log("No memory context found");
-    console.log(
-      source_default.dim('  Try: zero memory context --query "customer follow up"')
-    );
-    return;
-  }
-  console.log(response.context);
-}
-function compactText(value) {
-  const normalized = value.replace(/\s+/g, " ").trim();
-  if (normalized.length <= 180) {
-    return normalized;
-  }
-  return `${normalized.slice(0, 177)}...`;
-}
-function formatScore(score) {
-  return score.toFixed(2);
-}
-function printMemorySearchResult(result) {
-  if (result.kind === "memory") {
-    const memory = result.memory;
-    const entity = memory.relationship.entity.displayName;
-    console.log(`- ${memory.text}`);
-    console.log(
-      source_default.dim(
-        `  memory \xB7 ${formatKind(memory.kind)} \xB7 ${entity} \xB7 score ${formatScore(result.score)} \xB7 ${sourceSummary(memory)}`
-      )
-    );
-    return;
-  }
-  const title = result.title ?? result.externalId;
-  const citationUrl = result.citation.url ? ` \xB7 ${result.citation.url}` : "";
-  console.log(`- ${title}`);
-  console.log(source_default.dim(`  document \xB7 ${compactText(result.text)}`));
-  console.log(
-    source_default.dim(
-      `  ${result.provider}:${result.externalId} \xB7 ${result.contextSpace.displayName} \xB7 score ${formatScore(result.score)}${citationUrl}`
-    )
-  );
-}
-function printMemorySearch(response) {
-  if (response.results.length === 0) {
-    console.log("No memory or document results found");
-    console.log(
-      source_default.dim('  Try: zero memory search "security review" --mode hybrid')
-    );
-    return;
-  }
-  console.log(
-    source_default.green(
-      `\u2713 Found ${response.results.length} ${response.mode} memory results`
-    )
-  );
-  for (const result of response.results) {
-    printMemorySearchResult(result);
-  }
-}
-function contextSpaceSummary(memory) {
-  return memory.contextSpace ? `${memory.contextSpace.type}:${memory.contextSpace.key}` : "no context space";
-}
-function printLifecycleMemory(memory) {
-  console.log(`- ${memory.text}`);
-  console.log(
-    source_default.dim(
-      `  ${memory.kind} \xB7 ${memory.status} \xB7 confidence ${memory.confidence} \xB7 ${contextSpaceSummary(memory)} \xB7 ${memory.id}`
-    )
-  );
-}
-function printMemoryList(response) {
-  if (response.memories.length === 0) {
-    console.log("No lifecycle memories found");
-    console.log(
-      source_default.dim('  Create one: zero memory create "Remember this fact"')
-    );
-    return;
-  }
-  console.log(source_default.green(`\u2713 Found ${response.memories.length} memories`));
-  for (const memory of response.memories) {
-    printLifecycleMemory(memory);
-  }
-}
-function printMemoryCreated(memory) {
-  console.log(source_default.green("\u2713 Memory created"));
-  printLifecycleMemory(memory);
-  console.log(source_default.dim(`  History: zero memory history memory ${memory.id}`));
-}
-function printMemoryUpdated(memory) {
-  console.log(source_default.green("\u2713 Memory updated"));
-  printLifecycleMemory(memory);
-  console.log(source_default.dim(`  History: zero memory history memory ${memory.id}`));
-}
-function printMemoryForget(response) {
-  if (response.forgotten.length === 0) {
-    console.log("No matching active memory or document found");
-    console.log(source_default.dim('  Try: zero memory search "the thing to forget"'));
-    return;
-  }
-  console.log(
-    source_default.green(`\u2713 Recorded ${response.forgotten.length} tombstones`)
-  );
-  for (const tombstone of response.forgotten) {
-    console.log(
-      `- ${tombstone.targetKind}: ${tombstone.targetTitle ?? tombstone.targetText ?? tombstone.fingerprint}`
-    );
-    console.log(source_default.dim(`  ${tombstone.fingerprint} \xB7 ${tombstone.id}`));
-  }
-}
-function printMemoryHistory(response) {
-  if (response.history.length === 0) {
-    console.log("No memory history found");
-    return;
-  }
-  console.log(source_default.green(`\u2713 Found ${response.history.length} versions`));
-  for (const version of response.history) {
-    console.log(
-      `- v${version.version} ${version.operation ?? "change"} ${formatDate(
-        version.createdAt
-      )}`
-    );
-    console.log(
-      source_default.dim(
-        `  ${version.targetKind}:${version.targetId} \xB7 ${version.contentHash}`
-      )
-    );
-    if (version.text ?? version.title) {
-      console.log(
-        source_default.dim(`  ${compactText(version.text ?? version.title ?? "")}`)
-      );
-    }
-  }
-}
-function printMemoryDocuments(response) {
-  if (response.documents.length === 0) {
-    console.log("No memory documents found");
-    console.log(source_default.dim("  Backfill GitHub or Notion memory sources first"));
-    return;
-  }
-  console.log(source_default.green(`\u2713 Found ${response.documents.length} documents`));
-  for (const document of response.documents) {
-    console.log(`- ${document.title ?? document.externalId}`);
-    console.log(
-      source_default.dim(
-        `  ${document.provider}:${document.externalId} \xB7 ${document.status} \xB7 ${document.chunkCount} chunks \xB7 ${document.id}`
-      )
-    );
-  }
-}
-function printMemoryForgotten(response) {
-  if (response.forgotten.length === 0) {
-    console.log("No forgotten memory records found");
-    return;
-  }
-  console.log(source_default.green(`\u2713 Found ${response.forgotten.length} tombstones`));
-  for (const tombstone of response.forgotten) {
-    console.log(
-      `- ${tombstone.targetKind}: ${tombstone.targetTitle ?? tombstone.targetText ?? tombstone.fingerprint}`
-    );
-    console.log(
-      source_default.dim(`  ${tombstone.fingerprint} \xB7 ${tombstone.createdAt}`)
-    );
-  }
-}
-
-// src/commands/zero/memory/context.ts
-function parseLimit(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  const parsed = Number(value);
-  return Number.isInteger(parsed) ? parsed : void 0;
-}
-var contextCommand = new Command().name("context").description("Print prompt-ready structured memory context").option("--query <query>", "Optional query to focus the context").option("--limit <limit>", "Maximum memories to include").option("--json", "Print machine-readable JSON").addHelpText(
-  "after",
-  `
-Examples:
-  General context:  zero memory context
-  Focus context:    zero memory context --query "security review"
-  Print JSON:       zero memory context --query "Acme" --json
-
-Notes:
-  - Uses the authenticated user's active organization
-  - Requires relationship memory to be enabled for the organization
-  - This command is read-only`
-).action(
-  withErrorHandler(async (options) => {
-    const response = await getZeroMemoryContext({
-      q: options.query,
-      limit: parseLimit(options.limit)
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemoryContext(response);
-  })
-);
-
-// src/commands/zero/memory/lifecycle.ts
-init_esm_shims();
-var MEMORY_KINDS = [
-  "key_fact",
-  "preference",
-  "open_loop",
-  "role",
-  "project",
-  "communication_style",
-  "recent_context"
-];
-var CONTEXT_TYPES = [
-  "user",
-  "org",
-  "project",
-  "repo",
-  "customer",
-  "agent",
-  "workflow"
-];
-var PROVIDERS = ["gmail", "slack", "github", "notion"];
-function parseLimit2(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  const parsed = Number(value);
-  return Number.isInteger(parsed) ? parsed : void 0;
-}
-function parseConfidence(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  const parsed = Number(value);
-  return Number.isInteger(parsed) ? parsed : void 0;
-}
-function parseMemoryKind(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (MEMORY_KINDS.some((kind) => {
-    return kind === value;
-  })) {
-    return value;
-  }
-  console.error(source_default.red("\u2717 Unsupported memory kind"));
-  console.error(source_default.dim(`  Use one of: ${MEMORY_KINDS.join(", ")}`));
-  process.exit(1);
-}
-function parseProvider(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (PROVIDERS.some((provider) => {
-    return provider === value;
-  })) {
-    return value;
-  }
-  console.error(source_default.red("\u2717 Unsupported memory provider"));
-  console.error(source_default.dim(`  Use one of: ${PROVIDERS.join(", ")}`));
-  process.exit(1);
-}
-function parseContextSpace(options) {
-  if (!options.contextKey && !options.contextType && !options.contextName) {
-    return void 0;
-  }
-  const type = options.contextType ?? "user";
-  if (!CONTEXT_TYPES.some((contextType) => {
-    return contextType === type;
-  })) {
-    console.error(source_default.red("\u2717 Unsupported context space type"));
-    console.error(source_default.dim(`  Use one of: ${CONTEXT_TYPES.join(", ")}`));
-    process.exit(1);
-  }
-  if (!options.contextKey || !options.contextName) {
-    console.error(
-      source_default.red("\u2717 --context-key and --context-name are required together")
-    );
-    console.error(
-      source_default.dim(
-        '  Example: zero memory create "Fact" --context-type repo --context-key github:vm0-ai/vm0 --context-name vm0-ai/vm0'
-      )
-    );
-    process.exit(1);
-  }
-  return {
-    type,
-    key: options.contextKey,
-    displayName: options.contextName
-  };
-}
-function requireYes(options) {
-  if (options.yes) {
-    return;
-  }
-  console.error(source_default.red("\u2717 --yes is required for forget operations"));
-  console.error(
-    source_default.dim("  This records tombstones and removes active search results")
-  );
-  process.exit(1);
-}
-var listCommand = new Command().name("list").description("List lifecycle-aware structured memories").option("--status <status>", "Filter by active or archived", "active").option("--kind <kind>", "Filter by memory kind").option("--limit <limit>", "Maximum rows to return").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(async (options) => {
-    const response = await listZeroMemory({
-      status: options.status === "archived" ? "archived" : "active",
-      kind: parseMemoryKind(options.kind),
-      limit: parseLimit2(options.limit)
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemoryList(response);
-  })
-);
-var createCommand = new Command().name("create").description("Create a direct structured memory").argument("<text>", "Memory text").option("--kind <kind>", "Memory kind", "key_fact").option("--confidence <confidence>", "Confidence 0-100").option("--entity <name>", "Entity display name").option("--context-type <type>", "Context space type").option("--context-key <key>", "Context space key").option("--context-name <name>", "Context space display name").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(async (text, options) => {
-    const memory = await createZeroMemory({
-      text,
-      kind: parseMemoryKind(options.kind) ?? "key_fact",
-      confidence: parseConfidence(options.confidence) ?? 90,
-      contextSpace: parseContextSpace(options),
-      entityDisplayName: options.entity
-    });
-    if (options.json) {
-      console.log(JSON.stringify({ memory }));
-      return;
-    }
-    printMemoryCreated(memory);
-  })
-);
-var updateCommand = new Command().name("update").description("Update a structured memory and create a new version").argument("<memory-id>", "Memory ID").option("--text <text>", "Replacement memory text").option("--kind <kind>", "Replacement memory kind").option("--confidence <confidence>", "Confidence 0-100").option("--entity <name>", "Entity display name").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(async (memoryId, options) => {
-    const memory = await updateZeroMemory(memoryId, {
-      text: options.text,
-      kind: parseMemoryKind(options.kind),
-      confidence: parseConfidence(options.confidence),
-      entityDisplayName: options.entity
-    });
-    if (options.json) {
-      console.log(JSON.stringify({ memory }));
-      return;
-    }
-    printMemoryUpdated(memory);
-  })
-);
-var forgetCommand = new Command().name("forget").description("Forget one structured memory by ID").argument("<memory-id>", "Memory ID").option("--reason <reason>", "Reason to record in the tombstone").option("--yes", "Confirm the forget operation").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(async (memoryId, options) => {
-    requireYes(options);
-    const response = await forgetZeroMemory(memoryId, {
-      reason: options.reason
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemoryForget(response);
-  })
-);
-var forgetPromptCommand = new Command().name("forget-prompt").description("Forget memories or documents matching a prompt").argument("<prompt>", "Forget prompt").option("--target <target>", "all, memories, or documents", "all").option("--provider <provider>", "Filter documents by provider").option("--limit <limit>", "Maximum matches to forget").option("--reason <reason>", "Reason to record in tombstones").option("--yes", "Confirm the forget operation").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(async (prompt, options) => {
-    requireYes(options);
-    const targetKind = options.target === "memories" || options.target === "documents" ? options.target : "all";
-    const response = await forgetZeroMemoryByPrompt({
-      prompt,
-      targetKind,
-      provider: parseProvider(options.provider),
-      limit: parseLimit2(options.limit) ?? 5,
-      reason: options.reason
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemoryForget(response);
-  })
-);
-var historyCommand = new Command().name("history").description("List memory, document, or profile version history").argument("<target-kind>", "memory, document, or profile").argument("<target-id>", "Target ID").option("--limit <limit>", "Maximum versions to return").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(
-    async (targetKind, targetId, options) => {
-      if (targetKind !== "memory" && targetKind !== "document" && targetKind !== "profile") {
-        console.error(source_default.red("\u2717 Unsupported history target"));
-        console.error(source_default.dim("  Use one of: memory, document, profile"));
-        process.exit(1);
-      }
-      const response = await listZeroMemoryHistory({
-        targetKind,
-        targetId,
-        limit: parseLimit2(options.limit)
-      });
-      if (options.json) {
-        console.log(JSON.stringify(response));
-        return;
-      }
-      printMemoryHistory(response);
-    }
-  )
-);
-var documentsCommand = new Command().name("documents").description("List indexed memory documents").option("--status <status>", "active, archived, or deleted", "active").option("--provider <provider>", "Filter by provider").option("--limit <limit>", "Maximum rows to return").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(async (options) => {
-    const status = options.status === "archived" || options.status === "deleted" ? options.status : "active";
-    const response = await listZeroMemoryDocuments({
-      status,
-      provider: parseProvider(options.provider),
-      limit: parseLimit2(options.limit)
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemoryDocuments(response);
-  })
-);
-var forgottenCommand = new Command().name("forgotten").description("List forgotten memory tombstones").option("--limit <limit>", "Maximum rows to return").option("--json", "Print machine-readable JSON").action(
-  withErrorHandler(async (options) => {
-    const response = await listZeroMemoryForgotten({
-      limit: parseLimit2(options.limit)
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemoryForgotten(response);
-  })
-);
-
-// src/commands/zero/memory/recall.ts
-init_esm_shims();
-var MEMORY_KINDS2 = ["key_fact", "preference", "open_loop"];
-function parseLimit3(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  const parsed = Number(value);
-  return Number.isInteger(parsed) ? parsed : void 0;
-}
-function parseKind(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (MEMORY_KINDS2.some((kind) => {
-    return kind === value;
-  })) {
-    return value;
-  }
-  console.error(source_default.red("\u2717 Unsupported memory kind"));
-  console.error(source_default.dim("  Use one of: key_fact, preference, open_loop"));
-  process.exit(1);
-}
-var recallCommand = new Command().name("recall").description("Recall structured memory by query").argument("<query>", "Recall query").option("--kind <kind>", "Filter by key_fact, preference, or open_loop").option("--limit <limit>", "Maximum memories to return").option("--json", "Print machine-readable JSON").addHelpText(
-  "after",
-  `
-Examples:
-  Recall memory:  zero memory recall "security review"
-  Filter kind:    zero memory recall "pricing" --kind open_loop
-  Print JSON:     zero memory recall "Acme" --json
-
-Notes:
-  - Uses the authenticated user's active organization
-  - Requires relationship memory to be enabled for the organization
-  - This command is read-only`
-).action(
-  withErrorHandler(async (query, options) => {
-    const response = await recallZeroMemory({
-      q: query,
-      kind: parseKind(options.kind),
-      limit: parseLimit3(options.limit)
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemoryRecall(response.memories);
-  })
-);
-
-// src/commands/zero/memory/search.ts
-init_esm_shims();
-var MEMORY_SEARCH_MODES = ["hybrid", "memories", "documents"];
-var MEMORY_PROVIDERS = ["gmail", "slack", "github", "notion"];
-function parseLimit4(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  const parsed = Number(value);
-  return Number.isInteger(parsed) ? parsed : void 0;
-}
-function parseMode(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (MEMORY_SEARCH_MODES.some((mode) => {
-    return mode === value;
-  })) {
-    return value;
-  }
-  console.error(source_default.red("\u2717 Unsupported memory search mode"));
-  console.error(source_default.dim("  Use one of: hybrid, memories, documents"));
-  process.exit(1);
-}
-function parseProvider2(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (MEMORY_PROVIDERS.some((provider) => {
-    return provider === value;
-  })) {
-    return value;
-  }
-  console.error(source_default.red("\u2717 Unsupported memory provider"));
-  console.error(source_default.dim("  Use one of: gmail, slack, github, notion"));
-  process.exit(1);
-}
-var searchCommand = new Command().name("search").description("Search structured memory and document chunks").argument("<query>", "Search query").option(
-  "--mode <mode>",
-  "Search mode: hybrid, memories, or documents",
-  "hybrid"
-).option("--provider <provider>", "Filter documents by source provider").option("--limit <limit>", "Maximum results to return").option("--json", "Print machine-readable JSON").addHelpText(
-  "after",
-  `
-Examples:
-  Hybrid search:     zero memory search "security review"
-  Documents only:    zero memory search "retention policy" --mode documents
-  GitHub documents:  zero memory search "release plan" --provider github
-  Print JSON:        zero memory search "Acme" --json
-
-Notes:
-  - Uses the authenticated user's active organization
-  - Requires relationship memory to be enabled for the organization
-  - This command is read-only`
-).action(
-  withErrorHandler(async (query, options) => {
-    const response = await searchZeroMemory({
-      q: query,
-      mode: parseMode(options.mode),
-      provider: parseProvider2(options.provider),
-      limit: parseLimit4(options.limit)
-    });
-    if (options.json) {
-      console.log(JSON.stringify(response));
-      return;
-    }
-    printMemorySearch(response);
-  })
-);
-
-// src/commands/zero/memory/index.ts
-var zeroMemoryCommand = new Command().name("memory").description("Manage, recall, and search structured memory").addCommand(listCommand).addCommand(createCommand).addCommand(updateCommand).addCommand(forgetCommand).addCommand(forgetPromptCommand).addCommand(historyCommand).addCommand(documentsCommand).addCommand(forgottenCommand).addCommand(recallCommand).addCommand(searchCommand).addCommand(contextCommand);
-export {
-  zeroMemoryCommand
-};
-//# sourceMappingURL=memory-XRUIDTIV.js.map