truthmark/tests/agents/prompts.test.ts

import { describe, it } from "node:test";
import { expect } from "expect";

import { createDefaultConfig } from "../../src/config/defaults.js";
import { renderTruthRealizePrompt } from "../../src/agents/prompts.js";
import { renderTruthmarkRealizeSkill } from "../../src/templates/workflow-surfaces.js";

describe("renderTruthRealizePrompt", () => {
  it("renders manual doc-first realization guidance without a dedicated CLI command", () => {
    const prompt = renderTruthRealizePrompt();

    expect(prompt).toContain("### Manual Truth Realize");
    expect(prompt).toContain("Only run when the user explicitly asks");
    expect(prompt).toContain(
      "read the updated truth docs plus any present Truthmark config, route files, relevant code, and tests",
    );
    expect(prompt).toContain("Truth-doc ownership review");
    expect(prompt).toContain(
      "if a source truth doc is broad, mixed-owner, index-like, unrouteable, stale, or conflicts with implementation evidence",
    );
    expect(prompt).toContain(
      "implement only bounded, current truth claims from the source docs",
    );
    expect(prompt).toContain(
      "RepoIndex, RouteMap, ImpactSet, and WorkflowState/action context",
    );
    expect(prompt).toContain("workflow write boundaries");
    expect(prompt).toContain(
      "read product truth under docs/truthmark/product as requirements",
    );
    expect(prompt).toContain(
      "read engineering truth under docs/truthmark/engineering as implementation context",
    );
    expect(prompt).toContain("write functional code only");
    expect(prompt).toContain("do not edit truth docs or truth routing");
    expect(prompt).toContain("do not write truth docs or truth routing");
    expect(prompt).not.toContain("before writing canonical truth docs");
    expect(prompt).not.toContain("product-lane writes belong");
    expect(prompt).not.toContain("engineering-lane writes belong");
    expect(prompt).not.toContain("Truth-doc restructure gate");
    expect(prompt).not.toContain("Truth-doc shape repair review");
    expect(prompt).not.toContain("restructure truth docs");
    expect(prompt).toContain(
      "Report changed code files and verification steps",
    );
    expect(prompt).toContain("installed instruction or skill");
    expect(prompt).not.toContain("Invocations:");
    expect(prompt).not.toContain("OpenCode /skill truthmark-realize");
    expect(prompt).not.toContain("Codex /truthmark-realize");
    expect(prompt).not.toContain("Cursor @truthmark-realize");
    expect(prompt).not.toContain("truthmark realize");
  });

  it("uses the configured truth root in its example report", () => {
    const config = createDefaultConfig();
    config.truthmark.paths.productTruthRoot = "docs/product/product";
    config.truthmark.paths.engineeringTruthRoot = "docs/product/engineering";

    const prompt = renderTruthRealizePrompt(config);

    expect(prompt).toContain(
      "docs/product/product/capabilities/authentication-session.md",
    );
    expect(prompt).toContain(
      "read engineering truth under docs/product/engineering as implementation context",
    );
    expect(prompt).not.toContain(
      "docs/truthmark/product/capabilities/authentication-session.md",
    );
  });

  it("renders adjacent-workflow exclusions in generated skill metadata", () => {
    const skill = renderTruthmarkRealizeSkill();

    expect(skill).toContain(
      "description: Use when the user explicitly asks to realize Truthmark truth docs into code",
    );
    expect(skill).toContain(
      "Not for syncing docs after code changes, documenting existing code, topology repair, or truth audits.",
    );
  });
});