warnings: string[];

};

const MATURITY_DOC_OUTPUTS = ["maturity/scorecard.md", "maturity/taxonomy.md"] as const;

function parseArgs(argv: string[]): Args {

const args: Args = {

taxonomy: DEFAULT_TAXONOMY_PATH,

return false;

}

function checkEvidenceIndependentInputs({

args,

scoresPath,

taxonomy,

taxonomyPath,

}: {

args: Args;

scoresPath: string;

taxonomy: QaMaturityTaxonomy;

taxonomyPath: string;

}): void {

const { warnings } = readValidatedQaMaturityScoreSources({

scoresPath,

taxonomy,

taxonomyPath,

});

writeInputWarnings(warnings);

if (args.strictInputs) {

enforceStrictInputs(warnings);

}

const missing = MATURITY_DOC_OUTPUTS.map((fileName) =>

path.join(args.outputDir, fileName),

).filter((outputPath) => !fs.existsSync(outputPath));

if (missing.length > 0) {

throw new Error(

`maturity docs check cannot skip evidence-backed freshness because generated docs are missing:\n${missing.map((file) => `- ${file}`).join("\n")}`,

);

}

}

function main(): void {

const args = parseArgs(process.argv.slice(2));

const taxonomyPath = path.normalize(args.taxonomy);

const scoresPath = path.normalize(args.scores);

const docsRoot = path.normalize(args.docsRoot);

const outputDir = path.normalize(args.outputDir);

const evidenceSummaries = readEvidenceSummaries(args.evidenceDir);

const taxonomy = readQaMaturityTaxonomySource(taxonomyPath);

if (args.check && !args.evidenceDir?.trim()) {

checkEvidenceIndependentInputs({

args: { ...args, outputDir },

scoresPath,

taxonomy,

taxonomyPath,

});

process.stdout.write(

`maturity docs inputs are valid in ${outputDir}; evidence-backed freshness check skipped because --evidence-dir was not supplied\n`,

);

return;

}

const evidenceSummaries = readEvidenceSummaries(args.evidenceDir);

const coverage = deriveCoverageScores(taxonomy, evidenceSummaries);

const { scores, warnings: scoreWarnings } = readValidatedQaMaturityScoreSources({

coverageScores: coverage,

["scripts/qa-lab-up.ts", ["test/scripts/qa-lab-up.test.ts"]],

["scripts/qa-coverage-report.ts", ["test/scripts/qa-report-cli.test.ts"]],

["scripts/qa-parity-report.ts", ["test/scripts/qa-report-cli.test.ts"]],

["scripts/qa/render-maturity-docs.ts", ["test/scripts/render-maturity-docs.test.ts"]],

[

"scripts/qa/ux-matrix-evidence-producer.ts",

["test/scripts/qa-ux-matrix-evidence-producer.test.ts"],

// Maturity docs renderer tests cover evidence-backed generated-doc checks.

import { spawnSync } from "node:child_process";

import path from "node:path";

import { afterEach, describe, expect, it } from "vitest";

import { createTempDirTracker } from "../helpers/temp-dir.js";

const repoRoot = path.resolve(__dirname, "../..");

const tempDirs = createTempDirTracker();

afterEach(() => {

tempDirs.cleanup();

});

function runCli(...args: string[]) {

return spawnSync(

process.execPath,

["--import", "tsx", "scripts/qa/render-maturity-docs.ts", ...args],

{

cwd: repoRoot,

encoding: "utf8",

},

);

}

describe("maturity docs renderer CLI", () => {

it("checks maturity inputs without requiring QA evidence artifacts", () => {

const result = runCli("--check");

expect(result.status).toBe(0);

expect(result.stderr).toBe("");

expect(result.stdout).toContain("maturity docs inputs are valid in docs");

expect(result.stdout).toContain("evidence-backed freshness check skipped");

});

it("still requires QA evidence artifacts when rendering generated docs", () => {

const outputDir = tempDirs.make("openclaw-maturity-docs-test-");

const result = runCli("--output-dir", outputDir);

expect(result.status).toBe(1);

expect(result.stdout).toBe("");

expect(result.stderr).toContain(

"maturity scorecard rendering requires all or release profile qa-evidence.json",

);

});

});