docs: consolidate canonical specs and preserve PBS reference IDs

This commit is contained in:
2026-10-28 15:11:00 +00:00
parent 9504f4694a
commit 3a3417eb44
74 changed files with 3231 additions and 270 deletions
@@ -9,6 +9,35 @@ import java.util.*;
import static org.junit.jupiter.api.Assertions.*;
class PbsDocumentationTest {
@Test void publishedFeatureIdsResolveToTheSameCanonicalChapterResourceAndHash() throws Exception {
// These IDs were published before the chapters were numbered.
var legacyIds = List.of("typed-arrays-and-optional-execution.md",
"first-class-functions-and-captures.md", "generic-contracts.md",
"generic-structs-and-free-functions.md", "input-and-existing-type-runtime-alignment.md",
"service-constants-and-runtime-math.md", "runtime-random-integration.md",
"sdk-list-and-cursor.md", "sdk-linked-and-cursor.md", "sdk-set-and-identity.md",
"sdk-map-and-keyval.md", "sdk-stack-and-queue.md");
var references = new PbsDocumentation().references(1, AppMode.Game).stream()
.collect(java.util.stream.Collectors.toMap(FrontendReferenceProvider.Reference::id, ref -> ref));
var entries = new HashMap<String, com.fasterxml.jackson.databind.JsonNode>();
try (var stream = getClass().getClassLoader().getResourceAsStream("pbs-knowledge/index.json")) {
assertNotNull(stream);
new com.fasterxml.jackson.databind.ObjectMapper().readTree(stream).get("references")
.forEach(entry -> entries.put(entry.get("id").asText(), entry));
}
for (int i = 0; i < legacyIds.size(); i++) {
String oldId = "pbs:spec:" + legacyIds.get(i);
String chapterId = "pbs:spec:" + (14 + i);
assertNotNull(references.get(oldId), oldId);
assertNotNull(references.get(chapterId), chapterId);
assertEquals(references.get(chapterId).text(), references.get(oldId).text(), oldId);
assertEquals(references.get(chapterId).kind(), references.get(oldId).kind(), oldId);
assertEquals(entries.get(chapterId).get("resource"), entries.get(oldId).get("resource"), oldId);
assertEquals(entries.get(chapterId).get("sha256"), entries.get(oldId).get("sha256"), oldId);
assertTrue(entries.get(oldId).get("resource").asText().startsWith("pbs-knowledge/specs/" + (14 + i) + ". "));
}
}
@Test void installedIndexHasAllKindsUniqueIdsAndExactSdkSources() throws Exception {
var references = new PbsDocumentation().references(1, AppMode.Game);
assertEquals(references.size(), references.stream().map(FrontendReferenceProvider.Reference::id).distinct().count());