feat: scaffold CLI and minimal issue list (task 0001)

Tracer bullet for gitea-axi: runnable npm package on axi-sdk-js with gitea-js as the sole HTTP layer, ESM on Node 20+. - issue list with --state/--limit, default fields, count line from X-Total-Count, type=issues guard, explicit empty state, and next-step suggestions - repo context detection from the git origin remote (SSH/scp/HTTPS), tea credential discovery with the three-way login-matching split, and -R/--repo and --login overrides (flag > env > auto) - token retrieval via tea login helper get: tea's login list JSON carries no token (ADR 0001 amended) - full AxiError classification table with path-based 404 split, TOON errors on stdout, exit codes 0/1/2 - test mode (GITEA_AXI_API_URL/TOKEN/REPO) suppressing subprocesses, fixture server, and vitest suites driving the CLI seam (50 tests)
2026-07-11 07:11:07 -04:00
parent 21a075f8cd
commit 38026f963d
34 changed files with 3892 additions and 0 deletions
--- a/test/fixture-server.ts
+++ b/test/fixture-server.ts
@@ -0,0 +1,96 @@
+import { readFileSync } from "node:fs";
+import { createServer, type Server } from "node:http";
+
+export interface FixtureRoute {
+  method: string;
+  /** Exact pathname to match, e.g. "/api/v1/repos/o/r/issues". */
+  path: string;
+  /** Query params that must all be present with these exact values. */
+  query?: Record<string, string>;
+  status?: number;
+  headers?: Record<string, string>;
+  /** Inline JSON body; mutually exclusive with `fixture`. */
+  body?: unknown;
+  /** Name of a JSON file in test/fixtures to serve as the body. */
+  fixture?: string;
+}
+
+export interface RecordedRequest {
+  method: string;
+  path: string;
+  query: Record<string, string>;
+  headers: Record<string, string>;
+}
+
+export interface FixtureServer {
+  url: string;
+  requests: RecordedRequest[];
+  close: () => Promise<void>;
+}
+
+function loadBody(route: FixtureRoute): unknown {
+  if (route.fixture !== undefined) {
+    return JSON.parse(
+      readFileSync(new URL(`./fixtures/${route.fixture}`, import.meta.url), "utf8"),
+    );
+  }
+  return route.body ?? {};
+}
+
+function matches(route: FixtureRoute, request: RecordedRequest): boolean {
+  if (route.method !== request.method || route.path !== request.path) {
+    return false;
+  }
+  for (const [key, value] of Object.entries(route.query ?? {})) {
+    if (request.query[key] !== value) {
+      return false;
+    }
+  }
+  return true;
+}
+
+export async function startFixtureServer(routes: FixtureRoute[]): Promise<FixtureServer> {
+  const requests: RecordedRequest[] = [];
+  const server: Server = createServer((req, res) => {
+    const url = new URL(req.url ?? "/", "http://fixture");
+    const recorded: RecordedRequest = {
+      method: req.method ?? "GET",
+      path: url.pathname,
+      query: Object.fromEntries(url.searchParams),
+      headers: Object.fromEntries(
+        Object.entries(req.headers).map(([k, v]) => [k, Array.isArray(v) ? v.join(",") : (v ?? "")]),
+      ),
+    };
+    requests.push(recorded);
+    const route = routes.find((candidate) => matches(candidate, recorded));
+    if (!route) {
+      res.writeHead(599, { "content-type": "application/json" });
+      res.end(
+        JSON.stringify({
+          message: `no fixture route matched ${recorded.method} ${recorded.path} ${JSON.stringify(recorded.query)}`,
+        }),
+      );
+      return;
+    }
+    res.writeHead(route.status ?? 200, {
+      "content-type": "application/json",
+      ...route.headers,
+    });
+    res.end(JSON.stringify(loadBody(route)));
+  });
+  await new Promise<void>((resolve) => {
+    server.listen(0, "127.0.0.1", resolve);
+  });
+  const address = server.address();
+  if (address === null || typeof address === "string") {
+    throw new Error("fixture server has no address");
+  }
+  return {
+    url: `http://127.0.0.1:${address.port}`,
+    requests,
+    close: () =>
+      new Promise<void>((resolve, reject) => {
+        server.close((error) => (error ? reject(error) : resolve()));
+      }),
+  };
+}