Test Plan

Test file: test/v2-unified-item-architecture.test.ts

Tests the RequirementsTraceabilityExtension orchestrator — initialization, processing, query methods, role statistics, lifecycle. Covers the public API surface of the main extension class.

Test file: test/antora-extension.test.ts

Tests the AntoraTraceabilityExtension — initialization with default config, preset, config path, and disabled state. Tests event handler registration, content processing via contentClassified event, matrix generation via sitePublished event, and API access patterns.

Test file: test/cli.test.ts

Tests the Commander-based CLI — process command (valid content, empty content, invalid paths, malformed macros), matrix command (generation, empty graph), validate command (invalid graph state), export command (empty graph), stats command (empty statistics), preset commands (invalid names, init, listing), and help command.

Test file: test/config-loader.test.ts

Tests the ConfigLoader — initialization, built-in preset listing and loading, preset structure validation, configuration loading from file, missing file handling, invalid YAML handling, role and relation validation, matrix definition retrieval, configuration merging, and error messages for invalid configurations and preset names.

Test file: test/graph-and-api.test.ts

Tests the TraceabilityGraph (Section 4 — extended queries: merge, getRelatedItems, getItemsWithRelationTo, getRelationshipsByRoles, findPath, getImpactAnalysis) and RequirementsTraceabilityExtension API methods (Section 5 — processFiles, validate, export, coverage, config access, preset management, lifecycle).

Test file: test/matrix-generator.test.ts

Tests the MatrixGenerator — basic matrix generation with empty graph, matrix generation with default and named configurations, role-based matrix rows and columns, coverage percentage calculation and status determination, coverage relation filtering, CSV export, HTML export, JSON export, coverage report generation, and edge cases (no matching items, missing titles, missing source files, unknown matrix names).

Test file: test/neo4j-exporter.test.ts

Tests the Neo4jExporter — empty graph CSV export, items and relationships in CSV, all attributes in export, special character escaping, empty graph Cypher export, items and relationships in Cypher, includeContent option, includeAllAttributes option, output directory creation, multiple role types, and export result counts and file paths.

Test file: test/relationship-link-substitution.test.ts

Tests the in-memory regex substitution that replaces relationship macros with Asciidoctor xrefs. Covers same-page xref generation, cross-page xref generation with basename path resolution, orphan reference handling, non-relationship text preservation, hyphenated/dotted IDs, missing sourceFile fallback, and surrounding text preservation.