Add standards authoring support (backwards-compatible)

Four additions to support OGC standards-as-building-blocks authoring:

- bblock.schema.yaml: new itemClass values (requirements-class, clause,
  terms, references) and new resource roles (requirements, terms, references)
- tests.schema.yaml: new optional id and method fields on test entries,
  allowing requirements.yaml to reference tests by id and ATS entries to
  carry an explicit test method description
- postprocess.py: compile testResources from tests.yaml into bblock metadata,
  resolving relative refs to absolute URLs (same base-URL logic as other fields)
- entrypoint.py: detect standards.yaml at repo root and embed its standards
  array into register.json for consumption by bblocks-specgen

Author: avillar

ogc/bblocks/entrypoint.py

@@ -248,6 +248,12 @@
             )
         local_url_mappings = bb_local_config.get('url-mappings')
 
+    standards_file = Path('standards.yaml')
+    if standards_file.is_file():
+        standards_config = load_yaml(filename=standards_file) or {}
+        if standards := standards_config.get('standards'):
+            register_additional_metadata['standards'] = standards
+
     register_additional_metadata['modified'] = datetime.datetime.now().isoformat()
 
     if os.environ.get('BBP_GIT_INFO_FILE'):

ogc/bblocks/postprocess.py

@@ -25,7 +25,7 @@
 from ogc.bblocks.generate_docs import DocGenerator
 from ogc.bblocks.oas30 import oas31_to_oas30
 from ogc.bblocks.util import write_jsonld_context, CustomJSONEncoder, \
-    PathOrUrl, get_git_repo_url
+    PathOrUrl, get_git_repo_url, load_yaml
 from ogc.bblocks.schema import annotate_schema, resolve_all_schema_references, write_annotated_schema
 from ogc.bblocks.models import BuildingBlock, BuildingBlockRegister, ImportedBuildingBlocks, BuildingBlockError
 from ogc.bblocks.validate import validate_test_resources, write_report
@@ -194,6 +194,27 @@ def do_postprocess(bblock: BuildingBlock, light: bool = False) -> bool:
                     base_url, cwd if base_url else output_file_root
                 )
 
+        tests_yaml_path = bblock.files_path / 'tests.yaml'
+        if tests_yaml_path.exists():
+            tests_entries = load_yaml(tests_yaml_path) or []
+            compiled_tests = []
+            for test in tests_entries:
+                ref = test.get('ref')
+                entry = {}
+                if test_id := test.get('id'):
+                    entry['id'] = test_id
+                if method := test.get('method'):
+                    entry['method'] = method
+                if test.get('require-fail'):
+                    entry['require-fail'] = True
+                if ref:
+                    entry['url'] = PathOrUrl(bblock.files_path / ref).with_base_url(
+                        base_url, cwd if base_url else output_file_root
+                    ) if not is_url(ref) else ref
+                compiled_tests.append(entry)
+            if compiled_tests:
+                bblock.metadata['testResources'] = compiled_tests
+
         if not light:
             if not steps or 'tests' in steps:
                 logger.info("Running tests")

ogc/bblocks/schemas/bblock.schema.yaml

@@ -61,6 +61,10 @@ properties:
       - response # OpenAPI response object
       - api # Partial or full OpenAPI document
       - model # Ontology or data model
+      - requirements-class # ModSpec requirements class (standard authoring)
+      - clause # Prose-only clause (scope, conventions, informative annex)
+      - terms # Terms and definitions clause
+      - references # Normative/informative references clause
   register:
     description: Register to which this Building Block belongs.
     type: string
@@ -250,7 +254,7 @@ properties:
         role:
           description: Role or relationship of this resource to the Building Block. Can be a well-known role name or a URI.
           oneOf:
-            - enum: [constraints, example, guidance, mapping, schema, specification, validation, vocabulary, data]
+            - enum: [constraints, example, guidance, mapping, schema, specification, validation, vocabulary, data, requirements, terms, references]
             - type: string
               format: uri
               pattern: ^https?://.*

ogc/bblocks/schemas/tests.schema.yaml

@@ -21,3 +21,13 @@ items:
         Name for the output file name that will be used when generating uplifted versions of the test resource.
         If not provided, the file name from "ref" will be used.
       type: string
+    id:
+      description: |
+        A logical identifier for this test entry. Used by requirements.yaml 'tested-by' fields to
+        reference tests by id rather than by filename.
+      type: string
+    method:
+      description: |
+        Explicit ATS test method description. When absent, the standard generator infers the method
+        from the file extension. When present, this text is used verbatim in the generated ATS entry.
+      type: string