automaker/apps/server/tests/unit/lib/app-spec-format.test.ts

import { describe, it, expect } from "vitest";
import {
  specToXml,
  getStructuredSpecPromptInstruction,
  getAppSpecFormatInstruction,
  APP_SPEC_XML_FORMAT,
  type SpecOutput,
} from "@/lib/app-spec-format.js";

describe("app-spec-format.ts", () => {
  describe("specToXml", () => {
    it("should convert minimal spec to XML", () => {
      const spec: SpecOutput = {
        project_name: "Test Project",
        overview: "A test project",
        technology_stack: ["TypeScript", "Node.js"],
        core_capabilities: ["Testing", "Development"],
        implemented_features: [
          { name: "Feature 1", description: "First feature" },
        ],
      };

      const xml = specToXml(spec);

      expect(xml).toContain('<?xml version="1.0" encoding="UTF-8"?>');
      expect(xml).toContain("<project_specification>");
      expect(xml).toContain("</project_specification>");
      expect(xml).toContain("<project_name>Test Project</project_name>");
      expect(xml).toContain("<technology>TypeScript</technology>");
      expect(xml).toContain("<capability>Testing</capability>");
    });

    it("should escape XML special characters", () => {
      const spec: SpecOutput = {
        project_name: "Test & Project",
        overview: "Description with <tags>",
        technology_stack: ["TypeScript"],
        core_capabilities: ["Cap"],
        implemented_features: [],
      };

      const xml = specToXml(spec);

      expect(xml).toContain("Test &amp; Project");
      expect(xml).toContain("&lt;tags&gt;");
    });

    it("should include file_locations when provided", () => {
      const spec: SpecOutput = {
        project_name: "Test",
        overview: "Test",
        technology_stack: ["TS"],
        core_capabilities: ["Cap"],
        implemented_features: [
          {
            name: "Feature",
            description: "Desc",
            file_locations: ["src/index.ts"],
          },
        ],
      };

      const xml = specToXml(spec);

      expect(xml).toContain("<file_locations>");
      expect(xml).toContain("<location>src/index.ts</location>");
    });

    it("should not include file_locations when empty", () => {
      const spec: SpecOutput = {
        project_name: "Test",
        overview: "Test",
        technology_stack: ["TS"],
        core_capabilities: ["Cap"],
        implemented_features: [
          { name: "Feature", description: "Desc", file_locations: [] },
        ],
      };

      const xml = specToXml(spec);

      expect(xml).not.toContain("<file_locations>");
    });

    it("should include additional_requirements when provided", () => {
      const spec: SpecOutput = {
        project_name: "Test",
        overview: "Test",
        technology_stack: ["TS"],
        core_capabilities: ["Cap"],
        implemented_features: [],
        additional_requirements: ["Node.js 18+"],
      };

      const xml = specToXml(spec);

      expect(xml).toContain("<additional_requirements>");
      expect(xml).toContain("<requirement>Node.js 18+</requirement>");
    });

    it("should include development_guidelines when provided", () => {
      const spec: SpecOutput = {
        project_name: "Test",
        overview: "Test",
        technology_stack: ["TS"],
        core_capabilities: ["Cap"],
        implemented_features: [],
        development_guidelines: ["Use ESLint"],
      };

      const xml = specToXml(spec);

      expect(xml).toContain("<development_guidelines>");
      expect(xml).toContain("<guideline>Use ESLint</guideline>");
    });

    it("should include implementation_roadmap when provided", () => {
      const spec: SpecOutput = {
        project_name: "Test",
        overview: "Test",
        technology_stack: ["TS"],
        core_capabilities: ["Cap"],
        implemented_features: [],
        implementation_roadmap: [
          { phase: "Phase 1", status: "completed", description: "Setup" },
        ],
      };

      const xml = specToXml(spec);

      expect(xml).toContain("<implementation_roadmap>");
      expect(xml).toContain("<status>completed</status>");
    });

    it("should not include optional sections when empty", () => {
      const spec: SpecOutput = {
        project_name: "Test",
        overview: "Test",
        technology_stack: ["TS"],
        core_capabilities: ["Cap"],
        implemented_features: [],
        additional_requirements: [],
        development_guidelines: [],
        implementation_roadmap: [],
      };

      const xml = specToXml(spec);

      expect(xml).not.toContain("<additional_requirements>");
      expect(xml).not.toContain("<development_guidelines>");
      expect(xml).not.toContain("<implementation_roadmap>");
    });
  });

  describe("getStructuredSpecPromptInstruction", () => {
    it("should return non-empty prompt instruction", () => {
      const instruction = getStructuredSpecPromptInstruction();
      expect(instruction).toBeTruthy();
      expect(instruction.length).toBeGreaterThan(100);
    });

    it("should mention required fields", () => {
      const instruction = getStructuredSpecPromptInstruction();
      expect(instruction).toContain("project_name");
      expect(instruction).toContain("overview");
      expect(instruction).toContain("technology_stack");
    });
  });

  describe("getAppSpecFormatInstruction", () => {
    it("should return non-empty format instruction", () => {
      const instruction = getAppSpecFormatInstruction();
      expect(instruction).toBeTruthy();
      expect(instruction.length).toBeGreaterThan(100);
    });

    it("should include critical formatting requirements", () => {
      const instruction = getAppSpecFormatInstruction();
      expect(instruction).toContain("CRITICAL FORMATTING REQUIREMENTS");
    });
  });

  describe("APP_SPEC_XML_FORMAT", () => {
    it("should contain valid XML template structure", () => {
      expect(APP_SPEC_XML_FORMAT).toContain("<project_specification>");
      expect(APP_SPEC_XML_FORMAT).toContain("</project_specification>");
    });
  });
});