implements PR-05.8

This commit is contained in:
2026-03-24 13:42:30 +00:00
parent 6dacedb5ed
commit 280c4b5adc
3 changed files with 228 additions and 0 deletions
@@ -0,0 +1,122 @@
package p.studio.compiler.specs;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;
import java.util.Optional;
import java.util.regex.Pattern;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.junit.jupiter.api.Assertions.fail;
class BackendConformanceMatrixSpecTest {
private static final String MATRIX_RELATIVE_PATH = "docs/general/specs/22. Backend Spec-to-Test Conformance Matrix.md";
private static final Pattern LAST_UPDATED_PATTERN = Pattern.compile("Last Updated: \\d{4}-\\d{2}-\\d{2}");
private static final List<String> REQUIRED_IDS = List.of(
"G19-5.1.1",
"G19-5.1.2",
"G19-5.1.3",
"G19-5.1.4",
"G19-5.2.1",
"G19-5.2.2",
"G19-5.2.3",
"G19-5.2.4",
"G19-5.2.5",
"G19-5.2.6",
"G19-5.2.7",
"G19-5.2.8",
"G20-6.2",
"G20-6.3",
"G20-6.4",
"G20-7.2",
"G20-7.3",
"G20-7.4",
"G20-8.1",
"G20-8.2",
"G20-8.3",
"G20-9.3",
"G20-9.4.2",
"G20-9.4.3",
"G20-10",
"G20-11.1",
"G20-11.2",
"G20-11.3",
"G21-5",
"G21-6.1",
"G21-6.2",
"G21-7.1",
"G21-7.2",
"G21-7.3",
"G21-7.4",
"G21-7.5",
"G21-9.1",
"G21-9.2",
"G21-9.3",
"PBS13-12.0",
"PBS13-12.1.1",
"PBS13-12.1.2",
"PBS13-12.1.3",
"PBS13-12.1.4",
"PBS13-12.1.5",
"PBS13-12.2.1",
"PBS13-12.2.2",
"PBS13-12.3.1",
"PBS13-12.3.2",
"PBS13-12.4.1",
"PBS13-12.4.2",
"PBS13-12.5");
@Test
void matrixMustExistAndContainRequiredRequirementRows() throws IOException {
final var matrixPath = locateRepoRoot().resolve(MATRIX_RELATIVE_PATH);
assertTrue(Files.isRegularFile(matrixPath), "matrix spec is missing: " + matrixPath);
final var content = Files.readString(matrixPath);
assertTrue(content.contains("Status Legend"), "matrix spec must contain a status legend section");
assertTrue(LAST_UPDATED_PATTERN.matcher(content).find(), "matrix spec must declare a Last Updated date");
for (final var requirementId : REQUIRED_IDS) {
assertTrue(content.contains("| " + requirementId + " |"),
"matrix is missing requirement row: " + requirementId);
}
}
@Test
void matrixRequirementRowsMustUseKnownStatusValues() throws IOException {
final var lines = Files.readAllLines(locateRepoRoot().resolve(MATRIX_RELATIVE_PATH));
for (final var requirementId : REQUIRED_IDS) {
final var row = findRequirementRow(lines, requirementId)
.orElseThrow(() -> new AssertionError("missing matrix row for requirement: " + requirementId));
final var hasKnownStatus = row.contains("| pass |")
|| row.contains("| partial |")
|| row.contains("| missing |")
|| row.contains("| deferred |");
assertTrue(hasKnownStatus, "matrix row must declare known status for requirement: " + requirementId);
}
}
private Optional<String> findRequirementRow(
final List<String> lines,
final String requirementId) {
final var prefix = "| " + requirementId + " |";
return lines.stream().filter(line -> line.startsWith(prefix)).findFirst();
}
private Path locateRepoRoot() {
var cursor = Path.of(System.getProperty("user.dir")).toAbsolutePath().normalize();
while (cursor != null) {
final var hasDocs = Files.isDirectory(cursor.resolve("docs/general/specs"));
final var hasCompiler = Files.isDirectory(cursor.resolve("prometeu-compiler"));
if (hasDocs && hasCompiler) {
return cursor;
}
cursor = cursor.getParent();
}
fail("could not locate repository root from working directory");
throw new IllegalStateException("unreachable");
}
}