ci/src/core/ci-files.test.ts

import * as os from "node:os";
import * as path from "node:path";
import * as fs from "node:fs";
import { CiFiles, ProjectMd, RoadmapMd, RequirementsMd, ArchitectureMd } from "../core/ci-files.js";

function createTempDir(): string {
  return fs.mkdtempSync(path.join(os.tmpdir(), "ci-files-test-"));
}

function cleanup(dir: string): void {
  fs.rmSync(dir, { recursive: true, force: true });
}

describe("CiFiles", () => {
  let dir: string;

  beforeEach(() => {
    dir = createTempDir();
  });

  afterEach(() => {
    cleanup(dir);
  });

  describe("ensureCIDir", () => {
    it("creates .ci directory", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.ensureCIDir();
      expect(fs.existsSync(path.join(dir, ".ci"))).toBe(true);
    });
  });

  describe("isInitialized", () => {
    it("returns false when no config.json exists", () => {
      const ciFiles = new CiFiles(dir);
      expect(ciFiles.isInitialized()).toBe(false);
    });

    it("returns true when config.json exists", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.ensureCIDir();
      fs.writeFileSync(path.join(dir, ".ci", "config.json"), "{}");
      expect(ciFiles.isInitialized()).toBe(true);
    });
  });

  describe("PROJECT.md", () => {
    const project: ProjectMd = {
      name: "Task API",
      coreValue: "Build a REST API for task management",
      requirements: {
        validated: ["User auth works"],
        active: ["Real-time notifications", "CRUD operations"],
        outOfScope: ["Admin dashboard"],
      },
      constraints: ["Must use Node.js", "Production-ready"],
      context: "This is a task management API",
      keyDecisions: [
        { decision: "Use PostgreSQL", rationale: "ACID compliance", outcome: "✓ Good" },
      ],
    };

    it("writes and reads PROJECT.md", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.writeProjectMd(project, "initial creation");

      const read = ciFiles.readProjectMd();
      expect(read).not.toBeNull();
      expect(read!.name).toBe("Task API");
      expect(read!.requirements.active).toContain("Real-time notifications");
      expect(read!.constraints).toContain("Must use Node.js");
    });

    it("overwrites PROJECT.md on update", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.writeProjectMd(project, "initial");

      const updated = { ...project, coreValue: "Updated description" };
      ciFiles.writeProjectMd(updated, "phase 1 complete");

      const read = ciFiles.readProjectMd();
      expect(read!.coreValue).toBe("Updated description");
    });
  });

  describe("ROADMAP.md", () => {
    const roadmap: RoadmapMd = {
      overview: "4-phase delivery",
      phases: [
        {
          number: 1,
          name: "auth",
          description: "Auth system",
          status: "in_progress",
          dependsOn: [],
          requirements: ["AUTH-01"],
          successCriteria: ["Users can sign up"],
        },
        {
          number: 2,
          name: "tasks",
          description: "Task CRUD",
          status: "not_started",
          dependsOn: [1],
          requirements: ["TASK-01"],
          successCriteria: ["Users can create tasks"],
        },
      ],
    };

    it("writes and reads ROADMAP.md", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.writeRoadmapMd(roadmap);

      const read = ciFiles.readRoadmapMd();
      expect(read).not.toBeNull();
      expect(read!.overview).toBe("4-phase delivery");
    });
  });

  describe("REQUIREMENTS.md", () => {
    const requirements: RequirementsMd = {
      v1: [
        {
          category: "Auth",
          items: [
            { id: "AUTH-01", description: "User can sign up" },
            { id: "AUTH-02", description: "User can log in" },
          ],
        },
      ],
      v2: [
        {
          category: "Notifications",
          items: [{ id: "NOTIF-01", description: "Push notifications" }],
        },
      ],
      outOfScope: [{ feature: "Admin dashboard", reason: "Not core value" }],
      traceability: [
        { requirement: "AUTH-01", phase: 1, status: "pending" },
        { requirement: "AUTH-02", phase: 1, status: "pending" },
      ],
    };

    it("writes and reads REQUIREMENTS.md", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.writeRequirementsMd(requirements);

      const read = ciFiles.readRequirementsMd();
      expect(read).not.toBeNull();
    });

    it("updates requirement status", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.writeRequirementsMd(requirements);

      ciFiles.updateRequirementStatus("AUTH-01", "complete");

      const read = ciFiles.readRequirementsMd();
      expect(read).not.toBeNull();
    });
  });

  describe("ARCHITECTURE.md", () => {
    const arch: ArchitectureMd = {
      overview: "Monolith with modules",
      components: [
        {
          name: "API",
          description: "REST API server",
          boundaries: "HTTP layer only",
          dependsOn: ["Auth", "Tasks"],
        },
      ],
      dataFlow: "Client -> API -> DB",
      buildOrder: ["Auth", "Tasks", "API"],
    };

    it("writes and reads ARCHITECTURE.md", () => {
      const ciFiles = new CiFiles(dir);
      ciFiles.writeArchitectureMd(arch);

      const read = ciFiles.readArchitectureMd();
      expect(read).not.toBeNull();
      expect(read!.overview).toBe("Monolith with modules");
    });
  });

  describe("updatePhaseStatus", () => {
    it("updates phase status in roadmap", () => {
      const ciFiles = new CiFiles(dir);
      const roadmap: RoadmapMd = {
        overview: "test",
        phases: [
          {
            number: 1,
            name: "auth",
            description: "Auth",
            status: "not_started",
            dependsOn: [],
            requirements: [],
            successCriteria: [],
          },
        ],
      };

      ciFiles.writeRoadmapMd(roadmap);
      ciFiles.updatePhaseStatus(1, "complete");

      const read = ciFiles.readRoadmapMd();
      expect(read).not.toBeNull();
    });
  });
});