import assert from "node:assert/strict";
import { readFileSync } from "node:fs";
import path from "node:path";
import { test } from "node:test";
import { fileURLToPath } from "node:url";
import {
  COMMANDS_FILE,
  generateCommandsMarkdown,
  mdCell,
  opsActions,
  opsExamples,
  opsParagraphs,
  RECIPES_FILE,
  renderCommandsMarkdown,
  splitUsage,
  unknownCommandsIn,
  unknownRecipeCommands,
} from "./cli-docs";

const REPO = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");

const OPS_USAGE = [
  "Usage: pnpm ops <action> [--json '<body>'] [--wait]",
  "       pnpm ops list",
  "",
  "Actions: sync, build-site, deploy-site, lane",
  "",
  "--wait follows the job's log.",
  "",
  'build-site and deploy-site take "siteId" or',
  '  "siteIds" (a list).',
  "",
  'deploy-site ships a built bundle: {"siteId"}. See `a | b`.',
  "",
  "Env: WORKER_TOKEN",
].join("\n");

test("splitUsage splits at the first double space; a usage with none is all text", () => {
  assert.deepEqual(splitUsage("<id> [--force]  build it  now"), {
    args: "<id> [--force]",
    text: "build it  now",
  });
  assert.deepEqual(splitUsage("rebuild the index"), { args: "", text: "rebuild the index" });
});

test("mdCell escapes markup outside code and only the pipe inside it", () => {
  assert.equal(mdCell("a <id> | *b* _c_ [x]"), "a &lt;id&gt; \\| \\*b\\* \\_c\\_ \\[x\\]");
  assert.equal(mdCell("run `x | y <z>` then"), "run `x \\| y <z>` then");
});

test("opsActions reads the Actions line, and refuses a usage without one", () => {
  assert.deepEqual(opsActions(OPS_USAGE), ["sync", "build-site", "deploy-site", "lane"]);
  assert.throws(() => opsActions("Usage: nothing"), /no `Actions:` line/);
});

test("opsParagraphs attributes a paragraph to every action it opens with", () => {
  const ps = opsParagraphs(OPS_USAGE, opsActions(OPS_USAGE));
  assert.deepEqual(
    ps.map((p) => p.actions),
    [[], [], ["build-site", "deploy-site"], ["deploy-site"], []],
  );
  assert.ok(!ps.some((p) => p.text.startsWith("Actions: ")));
});

test("opsExamples takes header lines of known actions only, padding collapsed", () => {
  const source = [
    "//   pnpm ops sync      --json '{\"slug\":\"x\"}'   --wait",
    "//   pnpm ops get channel x",
    "//   pnpm ops lane",
    "//   pnpm ops sync --json '{\"slug\":\"y\"}'",
    "const x = 1; // pnpm ops sync not a header line",
  ].join("\n");
  const ex = opsExamples(source, ["sync", "lane"]);
  assert.deepEqual(ex.get("sync"), [
    "pnpm ops sync --json '{\"slug\":\"x\"}' --wait",
    "pnpm ops sync --json '{\"slug\":\"y\"}'",
  ]);
  assert.deepEqual(ex.get("lane"), ["pnpm ops lane"]);
  assert.equal(ex.has("get"), false);
});

test("the rendered reference lists every command and every action exactly once as a row head", () => {
  const md = renderCommandsMarkdown(
    [
      { path: ["index"], usage: "rebuild the LMDB transcript index" },
      { path: ["publish", "build"], usage: "<id|all> [--force]  build a site" },
      { path: ["mcp"], usage: "[--local <dir>]  start the MCP server", passthrough: true },
    ],
    OPS_USAGE,
    new Map([["deploy-site", ["pnpm ops deploy-site --json '{}'"]]]),
  );
  assert.match(md, /^# Command reference\n\n<!-- GENERATED by common\/bin\/cli-docs\.ts/);
  assert.match(md, /\| `archilyzer index` \|  \| rebuild the LMDB transcript index \|/);
  assert.match(md, /\| `archilyzer publish build` \| `<id\\\|all> \[--force\]` \| build a site \|/);
  assert.match(md, /\| `archilyzer mcp` \| .* \*\(passthrough\)\* \|/);
  // An action with no paragraph still has its row.
  assert.match(md, /\| `sync` \| — \|  \|/);
  assert.match(md, /\| `lane` \| — \|  \|/);
  // The shared paragraph is one row naming both; deploy-site's example sits on
  // that first row, not on its own paragraph's.
  assert.match(
    md,
    /\| `build-site`, `deploy-site` \| build-site and deploy-site take "siteId" or "siteIds" \(a list\)\. \| `pnpm ops deploy-site --json '\{\}'` \|/,
  );
  assert.match(md, /\| `deploy-site` \| deploy-site ships a built bundle: \{"siteId"\}\. See `a \\\| b`\. \|  \|/);
  // The general paragraphs are printed as they stand, in a text block.
  assert.match(md, /```text\nUsage: pnpm ops <action>[^]*--wait follows the job's log\.\n\nEnv: WORKER_TOKEN\n```\n$/);
  assert.doesNotMatch(md, /Actions: sync/);
});

test("unknownCommandsIn names what no action, getter or command answers to", () => {
  const cli = [{ path: ["publish", "build"], usage: "" }, { path: ["doctor"], usage: "" }];
  const md = [
    "`pnpm ops <action>` and `pnpm archilyzer <command>` are placeholders.",
    "pnpm ops sync --json '{}' --wait",
    "pnpm ops list",
    "pnpm ops get channel x and pnpm ops get bogus",
    "pnpm ops frobnicate --wait",
    "`pnpm archilyzer publish build <id>`, `pnpm archilyzer doctor`.",
    "pnpm archilyzer publish destroy x",
  ].join("\n");
  const usage = OPS_USAGE.replace("pnpm ops list", "pnpm ops list\n       pnpm ops get channel <slug>");
  assert.deepEqual(unknownCommandsIn(md, cli, usage), [
    "pnpm ops get bogus",
    "pnpm ops frobnicate",
    "pnpm archilyzer publish destroy x",
  ]);
});

test(`every command ${RECIPES_FILE} names exists`, async () => {
  assert.deepEqual(await unknownRecipeCommands(), []);
});

test(`${COMMANDS_FILE} is what the command table and pnpm ops --help generate`, async () => {
  assert.equal(
    readFileSync(path.join(REPO, COMMANDS_FILE), "utf8"),
    await generateCommandsMarkdown(),
    `${COMMANDS_FILE} is stale: run \`archilyzer docs cli\``,
  );
});