opencode-working-memory/tests/memory-diag-cli.test.ts

import test from "node:test";
import assert from "node:assert/strict";
import { parseArgs } from "../scripts/memory-diag/cli.ts";

test("help returns usage without exposing hidden or removed commands", () => {
  const parsed = parseArgs(["--help"]);

  assert.equal(parsed.ok, true);
  assert.equal("help" in parsed && parsed.help, true);
  assert.match(parsed.usage, /Usage:/);
  assert.match(parsed.usage, /memory-diag \[status\]/);
  assert.match(parsed.usage, /memory-diag quality/);
  assert.match(parsed.usage, /memory-diag commands/);
  assert.match(parsed.usage, /memory-diag revert/);
  for (const command of ["health", "rejections", "disappearances", "trace", "coverage", "audit"]) {
    assert.doesNotMatch(parsed.usage, new RegExp(command));
  }
});

test("status defaults when no subcommand", () => {
  const parsed = parseArgs([]);

  assert.equal(parsed.ok, true);
  assert.equal("command" in parsed && parsed.command, "status");
  assert.deepEqual("options" in parsed && parsed.options, { raw: false, positional: [] });
});

test("unknown command returns usage error", () => {
  const parsed = parseArgs(["unknown"]);

  assert.equal(parsed.ok, false);
  if (parsed.ok) return;
  assert.equal(parsed.message, "Unknown subcommand: unknown");
  assert.equal(parsed.exitCode, 1);
  assert.match(parsed.usage, /Usage:/);
});

test("removed legacy aliases are ordinary unknown subcommands", () => {
  for (const command of ["health", "rejections", "disappearances", "trace"]) {
    const parsed = parseArgs([command]);

    assert.equal(parsed.ok, false, command);
    if (parsed.ok) continue;
    assert.equal(parsed.message, `Unknown subcommand: ${command}`);
    assert.match(parsed.usage, /Usage:/);
  }
});

test("quality accepts read-only workspace json and display flags", () => {
  const parsed = parseArgs(["quality", "--workspace", "/tmp/workspace", "--json", "--verbose", "--raw", "--no-emoji"]);

  assert.equal(parsed.ok, true);
  assert.equal("command" in parsed && parsed.command, "quality");
  assert.equal("options" in parsed && parsed.options.workspace, "/tmp/workspace");
  assert.equal("options" in parsed && parsed.options.json, true);
  assert.equal("options" in parsed && parsed.options.verbose, true);
  assert.equal("options" in parsed && parsed.options.raw, true);
  assert.equal("options" in parsed && parsed.options.noEmoji, true);
});

test("quality rejects mutation filter and drill-down flags", () => {
  const cases: Array<{ args: string[]; message: string }> = [
    { args: ["quality", "--all"], message: "quality does not accept --all" },
    { args: ["quality", "--apply"], message: "quality does not accept --apply" },
    { args: ["quality", "--memory", "mem-1"], message: "quality does not accept --memory" },
    { args: ["quality", "--event", "evt-1"], message: "quality does not accept --event" },
    { args: ["quality", "--reason", "bad_decision"], message: "quality does not accept rejection filters" },
    { args: ["quality", "--since", "7d"], message: "quality does not accept rejection filters" },
    { args: ["quality", "--soft-only"], message: "quality does not accept rejection filters" },
    { args: ["quality", "--trigger-only"], message: "quality does not accept rejection filters" },
    { args: ["quality", "--include-historical"], message: "quality does not accept --include-historical" },
    { args: ["quality", "--explain"], message: "quality does not accept --explain" },
  ];

  for (const item of cases) {
    const parsed = parseArgs(item.args);
    assert.equal(parsed.ok, false, item.args.join(" "));
    if (parsed.ok) continue;
    assert.equal(parsed.message, item.message);
    assert.match(parsed.usage, /Usage:/);
  }
});

test("hidden maintainer commands are accepted with neutral notices", () => {
  const coverage = parseArgs(["coverage"]);
  assert.equal(coverage.ok, true);
  assert.equal("command" in coverage && coverage.command, "coverage");
  assert.equal("deprecationNotice" in coverage && coverage.deprecationNotice, "Note: 'coverage' is a maintainer-only diagnostic and is not part of the public CLI surface.");

  const audit = parseArgs(["audit"]);
  assert.equal(audit.ok, true);
  assert.equal("command" in audit && audit.command, "audit");
  assert.equal("deprecationNotice" in audit && audit.deprecationNotice, "Note: 'audit' is a maintainer-only diagnostic and is not part of the public CLI surface.");
});

test("current command flag validation messages are preserved", () => {
  const cases: Array<{ args: string[]; message: string }> = [
    { args: ["status", "--all"], message: "status does not accept --all" },
    { args: ["coverage", "--all"], message: "coverage does not accept --all" },
    { args: ["missing", "--all"], message: "missing does not accept --all" },
    { args: ["rejected", "--all"], message: "rejected does not accept --all" },
    { args: ["audit", "--workspace", "/tmp/workspace"], message: "audit does not accept --all or --workspace" },
    { args: ["explain", "--all"], message: "explain does not accept --all" },
    { args: ["status", "--since", "forever"], message: "status does not accept rejection filters" },
    { args: ["status", "--reason", "bad_decision"], message: "status does not accept rejection filters" },
    { args: ["status", "--quality"], message: "Unknown option: --quality" },
    { args: ["rejected", "--unique"], message: "Unknown option: --unique" },
  ];

  for (const item of cases) {
    const parsed = parseArgs(item.args);
    assert.equal(parsed.ok, false, item.args.join(" "));
    if (parsed.ok) continue;
    assert.equal(parsed.message, item.message);
    assert.match(parsed.usage, /Usage:/);
  }
});

test("commands accepts workspace json and verbose flags", () => {
  const parsed = parseArgs(["commands", "--workspace", "/tmp/workspace", "--json", "--verbose"]);

  assert.equal(parsed.ok, true);
  assert.equal("command" in parsed && parsed.command, "commands");
  assert.equal("options" in parsed && parsed.options.workspace, "/tmp/workspace");
  assert.equal("options" in parsed && parsed.options.json, true);
  assert.equal("options" in parsed && parsed.options.verbose, true);
});

test("commands accepts memory drill-down selector", () => {
  const parsed = parseArgs(["commands", "--workspace", "/tmp/workspace", "--memory", "mem-1", "--json", "--verbose"]);

  assert.equal(parsed.ok, true);
  assert.equal("command" in parsed && parsed.command, "commands");
  assert.equal("options" in parsed && parsed.options.memory, "mem-1");
  assert.equal("options" in parsed && parsed.options.json, true);
  assert.equal("options" in parsed && parsed.options.verbose, true);
});

test("revert accepts memory or event selectors and apply flag", () => {
  const byMemory = parseArgs(["revert", "--memory", "mem-new", "--workspace", "/tmp/workspace", "--apply"]);
  assert.equal(byMemory.ok, true);
  assert.equal("command" in byMemory && byMemory.command, "revert");
  assert.equal("options" in byMemory && byMemory.options.memory, "mem-new");
  assert.equal("options" in byMemory && byMemory.options.workspace, "/tmp/workspace");
  assert.equal("options" in byMemory && byMemory.options.apply, true);

  const byEvent = parseArgs(["revert", "--event", "evt_1"]);
  assert.equal(byEvent.ok, true);
  assert.equal("command" in byEvent && byEvent.command, "revert");
  assert.equal("options" in byEvent && byEvent.options.event, "evt_1");
  assert.equal("options" in byEvent && byEvent.options.apply, undefined);
});

test("revert requires exactly one selector", () => {
  const missing = parseArgs(["revert"]);
  assert.equal(missing.ok, false);
  if (!missing.ok) assert.equal(missing.message, "revert requires --memory or --event");

  const both = parseArgs(["revert", "--memory", "mem-new", "--event", "evt_1"]);
  assert.equal(both.ok, false);
  if (!both.ok) assert.equal(both.message, "Use either --memory or --event, not both");
});

test("rejected invalid since value returns current error", () => {
  const parsed = parseArgs(["rejected", "--since", "forever"]);

  assert.equal(parsed.ok, false);
  if (parsed.ok) return;
  assert.equal(parsed.message, "Invalid --since value: forever");
  assert.match(parsed.usage, /Usage:/);
});

test("explain accepts positional memory id", () => {
  const parsed = parseArgs(["explain", "mem-1", "--workspace", "/tmp/workspace"]);

  assert.equal(parsed.ok, true);
  assert.equal("command" in parsed && parsed.command, "explain");
  assert.equal("options" in parsed && parsed.options.memory, "mem-1");
  assert.deepEqual("options" in parsed && parsed.options.positional, ["mem-1"]);
});

test("explain with both positional and memory flag errors", () => {
  const parsed = parseArgs(["explain", "mem-1", "--memory", "mem-2"]);

  assert.equal(parsed.ok, false);
  if (parsed.ok) return;
  assert.equal(parsed.message, "Use either explain <memory-id> or --memory, not both");
});