elspais 0.11.1__py3-none-any.whl → 0.43.5__py3-none-any.whl

elspais/validation/format.py

@@ -0,0 +1,264 @@
+"""Format validation - Validate requirement format against configurable rules.
+
+Validates requirements against rules defined in [rules.format] config section:
+- require_hash: Check hash exists in footer
+- require_assertions: Check at least one assertion exists
+- require_rationale: Check rationale section exists
+- require_shall: Check "shall" keyword in assertion text
+- require_status: Check status field in metadata
+- allowed_statuses: List of valid status values
+- labels_sequential: Check assertion labels are sequential (A,B,C not A,C,E)
+- labels_unique: Check no duplicate assertion labels
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from elspais.graph import GraphNode
+
+
+@dataclass
+class FormatRulesConfig:
+    """Configuration for format validation rules.
+
+    All rules default to False (disabled) for backwards compatibility.
+    Enable rules explicitly in [rules.format] config section.
+    """
+
+    require_hash: bool = False
+    require_assertions: bool = False
+    require_rationale: bool = False
+    require_shall: bool = False
+    require_status: bool = False
+    allowed_statuses: list[str] = field(default_factory=list)
+    labels_sequential: bool = False
+    labels_unique: bool = True  # Default True - duplicates are usually errors
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> FormatRulesConfig:
+        """Create FormatRulesConfig from configuration dictionary.
+
+        Args:
+            data: Dictionary from [rules.format] config section
+
+        Returns:
+            FormatRulesConfig instance
+        """
+        return cls(
+            require_hash=data.get("require_hash", False),
+            require_assertions=data.get("require_assertions", False),
+            require_rationale=data.get("require_rationale", False),
+            require_shall=data.get("require_shall", False),
+            require_status=data.get("require_status", False),
+            allowed_statuses=data.get("allowed_statuses", []),
+            labels_sequential=data.get("labels_sequential", False),
+            labels_unique=data.get("labels_unique", True),
+        )
+
+
+@dataclass
+class FormatViolation:
+    """A format rule violation found during validation.
+
+    Attributes:
+        rule: The rule that was violated
+        message: Human-readable description of the violation
+        severity: "error" or "warning"
+        node_id: ID of the requirement node with the violation
+        details: Additional context about the violation
+    """
+
+    rule: str
+    message: str
+    severity: str = "error"
+    node_id: str = ""
+    details: dict[str, Any] = field(default_factory=dict)
+
+
+def validate_requirement_format(
+    node: GraphNode,
+    rules: FormatRulesConfig,
+) -> list[FormatViolation]:
+    """Validate a requirement node against format rules.
+
+    Args:
+        node: The requirement GraphNode to validate
+        rules: Format rules configuration
+
+    Returns:
+        List of FormatViolation objects (empty if valid)
+    """
+    from elspais.graph import NodeKind
+
+    violations: list[FormatViolation] = []
+
+    # Only validate requirement nodes
+    if node.kind != NodeKind.REQUIREMENT:
+        return violations
+
+    node_id = node.id
+
+    # Rule: require_hash
+    if rules.require_hash:
+        hash_value = node.hash  # Use convenience property
+        if not hash_value or hash_value == "00000000":
+            violations.append(
+                FormatViolation(
+                    rule="require_hash",
+                    message=f"{node_id}: Missing or placeholder hash value",
+                    node_id=node_id,
+                    details={"current_hash": hash_value},
+                )
+            )
+
+    # Rule: require_assertions
+    if rules.require_assertions:
+        # Count assertion children
+        assertion_count = sum(
+            1 for child in node.iter_children() if child.kind == NodeKind.ASSERTION
+        )
+        if assertion_count == 0:
+            violations.append(
+                FormatViolation(
+                    rule="require_assertions",
+                    message=f"{node_id}: No assertions defined",
+                    node_id=node_id,
+                )
+            )
+
+    # Rule: require_rationale
+    if rules.require_rationale:
+        rationale = node.get_field("rationale", "")
+        if not rationale or not rationale.strip():
+            violations.append(
+                FormatViolation(
+                    rule="require_rationale",
+                    message=f"{node_id}: Missing rationale section",
+                    node_id=node_id,
+                )
+            )
+
+    # Rule: require_shall
+    if rules.require_shall:
+        # Check assertions for SHALL keyword
+        assertions_without_shall = []
+        for child in node.iter_children():
+            if child.kind == NodeKind.ASSERTION:
+                assertion_text = child.get_field("text", "") or child.get_label()
+                if "shall" not in assertion_text.lower():
+                    assertions_without_shall.append(child.get_label())
+
+        if assertions_without_shall:
+            violations.append(
+                FormatViolation(
+                    rule="require_shall",
+                    message=(
+                        f"{node_id}: Assertions missing 'SHALL' keyword: "
+                        f"{', '.join(assertions_without_shall)}"
+                    ),
+                    node_id=node_id,
+                    details={"assertions": assertions_without_shall},
+                )
+            )
+
+    # Rule: require_status
+    if rules.require_status:
+        status = node.status  # Use convenience property
+        if not status:
+            violations.append(
+                FormatViolation(
+                    rule="require_status",
+                    message=f"{node_id}: Missing status field",
+                    node_id=node_id,
+                )
+            )
+
+    # Rule: allowed_statuses
+    if rules.allowed_statuses:
+        status = node.status  # Use convenience property
+        if status and status not in rules.allowed_statuses:
+            violations.append(
+                FormatViolation(
+                    rule="allowed_statuses",
+                    message=(
+                        f"{node_id}: Invalid status '{status}' "
+                        f"(allowed: {', '.join(rules.allowed_statuses)})"
+                    ),
+                    node_id=node_id,
+                    details={"current": status, "allowed": rules.allowed_statuses},
+                )
+            )
+
+    # Collect assertion labels for sequential and unique checks
+    assertion_labels: list[str] = []
+    for child in node.iter_children():
+        if child.kind == NodeKind.ASSERTION:
+            # Extract label from assertion ID (e.g., "REQ-p00001-A" -> "A")
+            label = child.get_field("label")
+            if not label and "-" in child.id:
+                label = child.id.split("-")[-1]
+            if label:
+                assertion_labels.append(label)
+
+    # Rule: labels_unique
+    if rules.labels_unique and assertion_labels:
+        seen = set()
+        duplicates = []
+        for label in assertion_labels:
+            if label in seen:
+                duplicates.append(label)
+            seen.add(label)
+
+        if duplicates:
+            violations.append(
+                FormatViolation(
+                    rule="labels_unique",
+                    message=f"{node_id}: Duplicate assertion labels: {', '.join(set(duplicates))}",
+                    node_id=node_id,
+                    details={"duplicates": list(set(duplicates))},
+                )
+            )
+
+    # Rule: labels_sequential
+    if rules.labels_sequential and assertion_labels:
+        # Check if uppercase letter labels are sequential
+        uppercase_labels = [lbl for lbl in assertion_labels if len(lbl) == 1 and lbl.isupper()]
+        if uppercase_labels:
+            sorted_labels = sorted(set(uppercase_labels))
+            expected_next = "A"
+            gaps = []
+
+            for label in sorted_labels:
+                if label != expected_next:
+                    gaps.append(f"expected {expected_next}, found {label}")
+                    break
+                expected_next = chr(ord(expected_next) + 1)
+
+            if gaps:
+                violations.append(
+                    FormatViolation(
+                        rule="labels_sequential",
+                        message=f"{node_id}: Non-sequential assertion labels ({gaps[0]})",
+                        node_id=node_id,
+                        severity="warning",  # Less severe - sometimes intentional
+                        details={"labels": uppercase_labels, "gaps": gaps},
+                    )
+                )
+
+    return violations
+
+
+def get_format_rules_config(config: dict[str, Any]) -> FormatRulesConfig:
+    """Get FormatRulesConfig from configuration dictionary.
+
+    Args:
+        config: Full configuration dictionary from get_config()
+
+    Returns:
+        FormatRulesConfig instance from [rules.format] section
+    """
+    rules_data = config.get("rules", {}).get("format", {})
+    return FormatRulesConfig.from_dict(rules_data)

{elspais-0.11.1.dist-info → elspais-0.43.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elspais
-Version: 0.11.1
+Version: 0.43.5
 Summary: Requirements validation and traceability tools - L-Space connects all libraries
 Project-URL: Homepage, https://github.com/anspar/elspais
 Project-URL: Documentation, https://github.com/anspar/elspais#readme
@@ -25,12 +25,15 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Provides-Extra: all
+Requires-Dist: argcomplete>=3.0; extra == 'all'
 Requires-Dist: flask-cors>=4.0; extra == 'all'
 Requires-Dist: flask>=2.0; extra == 'all'
 Requires-Dist: jinja2>=3.0; extra == 'all'
 Requires-Dist: mcp>=1.0; extra == 'all'
 Provides-Extra: binary
 Requires-Dist: pyinstaller>=6.0; extra == 'binary'
+Provides-Extra: completion
+Requires-Dist: argcomplete>=3.0; extra == 'completion'
 Provides-Extra: dev
 Requires-Dist: black>=23.0; extra == 'dev'
 Requires-Dist: mypy>=1.0; extra == 'dev'
@@ -97,7 +100,7 @@ FROM python:3.11-slim
 COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
 
 # Install elspais (10-100x faster than pip)
-RUN uv pip install --system --no-cache elspais==0.9.3
+RUN uv pip install --system --no-cache elspais==0.24.3
 ```
 
 ```yaml
@@ -106,7 +109,7 @@ RUN uv pip install --system --no-cache elspais==0.9.3
   uses: astral-sh/setup-uv@v2
 
 - name: Install elspais
-  run: uv pip install --system elspais==0.9.3
+  run: uv pip install --system elspais==0.24.3
 ```
 
 **Note:** For regulated/medical software projects, always pin the exact version for reproducibility.
@@ -424,7 +427,7 @@ For reproducible builds, pin the version in your project:
 
 ```bash
 # .github/versions.env
-ELSPAIS_VERSION=0.1.0
+ELSPAIS_VERSION=0.24.3
 ```
 
 ```yaml

elspais-0.43.5.dist-info/RECORD

@@ -0,0 +1,80 @@
+elspais/__init__.py,sha256=ddJTTPg5aTpGZSeriPjIiSW5fxnYWQ33Lquah3HLw6g,730
+elspais/__main__.py,sha256=rCMaObqJeT_6dhyfND7S4dh_lv30j7Ww3Z7992YYwaE,130
+elspais/associates.py,sha256=Wtue2cn60VkLGoIMQDAZeOJtuOdfJjVbXsIc7EKuun0,14221
+elspais/cli.py,sha256=ccIvB7JseseSXDCLXv8euyIfK4BrEV-ttTSFj3VgLd0,29369
+elspais/content_rules.py,sha256=YEjsMB07gjcWymlRRf2z1E39-RvZMHXAwVxypo7ylog,4829
+elspais/commands/__init__.py,sha256=E8otW6goXASgd0cDvG3SiuqXxC-U6rfyRCnN8ZI3tcQ,256
+elspais/commands/analyze.py,sha256=t4THSyUytRjoECMToDSELj6OKJu_BTiEuCQsmRt18EY,5197
+elspais/commands/changed.py,sha256=DmZ8taBHOKrckiqm5RNA0zUJKMYAoWNCPzVZSUD2ugM,4524
+elspais/commands/config_cmd.py,sha256=r1BATGOVYOuFNd1gl2AnktMj4LOSc1O7KuzykPExTpo,13995
+elspais/commands/edit.py,sha256=_ok7MWUhtYviCFSf6ZR_ol6Ab0HPn4NTMIuZFTEBejc,16784
+elspais/commands/example_cmd.py,sha256=DGByHbTwj0iyeabtJCD7o3Vx5crj9IpgsZ01ZnmmI98,8804
+elspais/commands/hash_cmd.py,sha256=dNvH0dzBpyshvpe6Dz9iFODLb-k9UA_qPyVQfyz4h2E,6010
+elspais/commands/health.py,sha256=ihE_pPPFySI3opNPRTShhY9Mr4PH7g8qb7W297oS7vo,37801
+elspais/commands/index.py,sha256=JbNyGjaS3GqElIkAV1_fKyLuIcna1Kko6fPaetZ3DuY,4569
+elspais/commands/init.py,sha256=fvGjuN6rDe_7bZvwwEW3Lqr7r4xgYXcsn1wlDOWVvPA,6939
+elspais/commands/reformat_cmd.py,sha256=AFFGWX-OVx__xdMVvdbahLYK8G7d5Kdsm7oSHOAVX5E,1950
+elspais/commands/rules_cmd.py,sha256=UwFzDoAXKzSpzjJ1LIJK1bfAkosnGwtS9k_CsPhUrH4,3451
+elspais/commands/trace.py,sha256=iq-gF_M_OIC7_2kxYC3zT-V8RYJqOX-nmRsuujUMtbY,16432
+elspais/commands/validate.py,sha256=iTrN9v6ZQM-HoNacVOzS1B1sp5JUi4FlOPtINZCCa9I,7456
+elspais/config/__init__.py,sha256=LlfrMXtUd_E0bQIDBgSh29EpYAUqXMuGrPyp1qGUwE8,23272
+elspais/graph/GraphNode.py,sha256=UuqcXPLzwdC2JyZhDaIHc2rGeZ9fACmPdsdzMGKjkmw,12327
+elspais/graph/__init__.py,sha256=rifZItDPBLJRqsn1lDKLtfxzSF9kbJ-3Vl0byxlniRs,1196
+elspais/graph/annotators.py,sha256=WGhR6gXXzQqYl8SxliECRpluUDnIwIM2kwt30JqyPfI,28464
+elspais/graph/builder.py,sha256=Ro1VYBnN4sVfRUsPnUo2qA4ov9BxrNUkhLnk3H_yRnQ,70544
+elspais/graph/deserializer.py,sha256=4jiGe3agIYDwrTNCShS-jKzdKK0ndZIvU__rX9c6xkU,7906
+elspais/graph/factory.py,sha256=1VirAq1YO0nqPpa-Z8EvnlC1F3AuM_hZ-NE2uTGAMgI,11812
+elspais/graph/metrics.py,sha256=Z5-rfm5DeEcwmdx4LltrWxCM104O2Cmw8uFZU8zCb4I,4811
+elspais/graph/mutations.py,sha256=Nd0_S2CEMllYHYjwDdmKkMvnBvah7pSSquMniq47F5E,4882
+elspais/graph/relations.py,sha256=O8Wbht2J3OuHx2Ah18FWUXhRA47Kc2xgeutQ7VAjnlU,2538
+elspais/graph/serialize.py,sha256=U_WQKCbAAygg59Ocvjr8_f4--UdGtK534Ys4WDR2fOE,5571
+elspais/graph/parsers/__init__.py,sha256=jqD4N5Z3qRzmCcz8jpSpo-NdBCvPZrcgSOAFt5ZH0gQ,4538
+elspais/graph/parsers/code.py,sha256=9txDvj6umxHkP_t07HfNayMre1pNhUP1cScBEeBj_Qk,7422
+elspais/graph/parsers/comments.py,sha256=JxB79XSg0wDhEkOgGhivk6evrft7IkcCBhdur82ZC4M,3469
+elspais/graph/parsers/config_helpers.py,sha256=Vz3xitKnNgZbCSYKnBSeDCW1TKVyHlB9UbEzq-q21zg,995
+elspais/graph/parsers/heredocs.py,sha256=kEyIZrGXOUWu-JJkfM56OD1uDYYBYOtzY1qoslhkGZQ,7219
+elspais/graph/parsers/journey.py,sha256=Amj40qEq_zE7maz8ewR-djlSy5SiWQB6JeEIa_Q5Fic,3928
+elspais/graph/parsers/remainder.py,sha256=u004gg9twwN_oW9hfqyDt_6MSEvxRrFNIeoAMVic7j4,2308
+elspais/graph/parsers/requirement.py,sha256=HcSL5gFUpOmWHBoI1EOazvOszkVuEnSPIKhWR-k8DzI,12002
+elspais/graph/parsers/test.py,sha256=EfM1eySf2bUYrPknfPGW1hOu_98_HA2V1K5ral5UQSg,11244
+elspais/graph/parsers/results/__init__.py,sha256=QRo0_DIh4xar2kv4HKnqV2IRg7Rjbku9AGO8vJtolsA,254
+elspais/graph/parsers/results/junit_xml.py,sha256=k_wRG_sblQMBdlVmoaMxDcHHqW30XQqHKhEhAY-UmNg,7821
+elspais/graph/parsers/results/pytest_json.py,sha256=eZf3tXCm4Tv8oDdLsrCnbPShSaIrG55CoIegGxQs-nw,10395
+elspais/html/__init__.py,sha256=csyyiBoU_WKkFyP5c4zTnx1uHwQ4sZlbA66OvFgpAis,212
+elspais/html/generator.py,sha256=RJMEwzgrNLzmIPEomkGfJRogcyqQQj24sjpRJsdYOlg,27927
+elspais/html/templates/trace_view.html.j2,sha256=6tUx9BgiQqjnThUZ4NG6sSKXH1F1pXGhaSM6n3CRDJc,76871
+elspais/mcp/__init__.py,sha256=Sr-YJtQgYO2gKDD4vHwJ9si3PeAnoqX6DntUXM-qekI,1450
+elspais/mcp/__main__.py,sha256=QgFm_G-BkqjW0cULzUfdLAeGeam5R4qneBCs5k2pUTc,182
+elspais/mcp/file_mutations.py,sha256=ts2-m7-mupe96rkkQe6nS_u_K3JPf_rH02pANw8RhCA,4457
+elspais/mcp/server.py,sha256=OEmUzpMLf_gront2E5MmFNnhSfoPaR_VFU_lXvNu2uI,77388
+elspais/testing/__init__.py,sha256=RIGednU6uRUcYHNT5nbLTrDPY-SCh3HCYj0A-iEWCHg,916
+elspais/testing/config.py,sha256=iobz9r6CHEcfx4r2QTWlGN6S8XWj3OJ0DEW7GyxmpLw,1813
+elspais/testing/mapper.py,sha256=itcatI7vaVn7RkW6SSTb4bj0R8hZXINWVN8KtBf24iI,5657
+elspais/testing/result_parser.py,sha256=YgSNQa3mlT-ovo3PzjoUypN2urR1dIunPcfdB2IMAH8,9415
+elspais/testing/scanner.py,sha256=9YttAeHA1uNuyMMHaVVhotbAqVQQN5U2J5HVK7c6gC8,17724
+elspais/utilities/__init__.py,sha256=_HN7tawOZdaopnl3ISEWqDp2L_3fzkWsx4iKu0kYohs,55
+elspais/utilities/docs_loader.py,sha256=NiXOU-NAP97JMDR8w_H0xq6eMP7Gbq4NeDeoNgq-6h4,2693
+elspais/utilities/git.py,sha256=yEw-ARaVjQIC8Fu5evAgmvi77mDLFesXdX1bd4v8yKU,19887
+elspais/utilities/hasher.py,sha256=2gwHgdMYf6r87Rd1R2YEfIfz3KqymESu_DD1SgYFkXk,3782
+elspais/utilities/md_renderer.py,sha256=nKKO4RxechfayduCC-jr2YmyzxPTfd5JY8W5kvsLOXs,6378
+elspais/utilities/patterns.py,sha256=jCILSUsk9rBI18sVp9StBxw7lImnI1kBtEU7Bajlm1s,13050
+elspais/utilities/reference_config.py,sha256=i0bA0NMplip2TY2XQvRPN1TvDoqafnuPv9PtsPMABdw,21461
+elspais/validation/__init__.py,sha256=pgP-4_gkmkaBX1uRGiwzZf0n3kSJpYKCAQppIq65fpQ,441
+elspais/validation/format.py,sha256=nlYF5WVPbygo2jlscDg4Bk3R4J7fyYVf362nfGvvPsY,9219
+elspais/docs/cli/assertions.md,sha256=Rp8KM7s-2JU9A2QA0GtsaL12BTf5gGU_rbOfvMW1gaU,1538
+elspais/docs/cli/commands.md,sha256=41luTLMrl3qvhl_OcEEuAou7BFQpC3--i6D-I8Uut10,8789
+elspais/docs/cli/config.md,sha256=ckRwF2ImcxYeXku-oVomnQrp0xqlvsG7FADdOQMEjfw,6075
+elspais/docs/cli/format.md,sha256=ygsfxdIYvWMGoO-8DzlY8ELATlaUJhGNxfLe77ehljM,1633
+elspais/docs/cli/git.md,sha256=kXW5WaVu9XkzgQ0ryBl4H-Vav2sVGThH_DifdvBqQFs,1284
+elspais/docs/cli/health.md,sha256=mFLUEOhcSfZ6aHMrzYjqUbcDhMmaieMIaEQaVD4DqUo,5146
+elspais/docs/cli/hierarchy.md,sha256=_hqxQVu-sp_BhJnLznKljiTDZDMNXKYqMh-uDyjVuB0,1677
+elspais/docs/cli/ignore.md,sha256=THa2hdt05Hq4Bi3eKdt4prDUntU1xV3rySldY2DLhNw,2097
+elspais/docs/cli/mcp.md,sha256=4UrxT6QSC-qgtz_pkWcWarpnDVRBb8hemK9jBnYFi6o,6564
+elspais/docs/cli/quickstart.md,sha256=y7rpVjN3lcL32517rEpNF0b2Nw8IAH5xMCFh02wRK74,1412
+elspais/docs/cli/traceability.md,sha256=CtZfFUqyWNqtAgL3yQYGT8OUpsof0tkzTturRk4vzJ0,2573
+elspais/docs/cli/validation.md,sha256=LYnL3YaSOhdx-kBGOUYUxD9yYDUasX41RhuO7BolnWs,2535
+elspais-0.43.5.dist-info/METADATA,sha256=HBl9hNKnkh9Q-xRm1JP6m5U6ZKMm9bRHWwh9bPmSSJE,11767
+elspais-0.43.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+elspais-0.43.5.dist-info/entry_points.txt,sha256=yWZZEfn2fBSKSzGoS-fMQ9YoTkyeu6-i7Oht6NsdKpk,45
+elspais-0.43.5.dist-info/licenses/LICENSE,sha256=x_dNMsy_askp2MmKXZFL2bKW_tDiJHcRTyAg0TY1RMI,1063
+elspais-0.43.5.dist-info/RECORD,,

elspais/config/defaults.py

@@ -1,173 +0,0 @@
-"""
-elspais.config.defaults - Default configuration values.
-
-Provides built-in defaults matching the HHT-diary repository structure.
-"""
-
-DEFAULT_CONFIG = {
-    "project": {
-        "name": "",
-        "type": "core",
-    },
-    "directories": {
-        "spec": "spec",
-        "docs": "docs",
-        "database": "database",
-        "code": ["apps", "packages", "server", "tools"],
-        "ignore": [
-            "node_modules",
-            ".git",
-            "build",
-            "dist",
-            ".dart_tool",
-            "__pycache__",
-            ".venv",
-            "venv",
-        ],
-    },
-    "patterns": {
-        "id_template": "{prefix}-{associated}{type}{id}",
-        "prefix": "REQ",
-        "types": {
-            "prd": {"id": "p", "name": "Product Requirement", "level": 1},
-            "ops": {"id": "o", "name": "Operations Requirement", "level": 2},
-            "dev": {"id": "d", "name": "Development Requirement", "level": 3},
-        },
-        "id_format": {
-            "style": "numeric",
-            "digits": 5,
-            "leading_zeros": True,
-        },
-        "associated": {
-            "enabled": True,
-            "position": "after_prefix",
-            "format": "uppercase",
-            "length": 3,
-            "separator": "-",
-        },
-        "assertions": {
-            "label_style": "uppercase",  # uppercase | numeric | alphanumeric | numeric_1based
-            "max_count": 26,
-            "zero_pad": False,
-        },
-    },
-    "spec": {
-        "index_file": "INDEX.md",
-        "readme_file": "README.md",
-        "format_guide": "requirements-format.md",
-        "skip_files": ["README.md", "requirements-format.md", "INDEX.md"],
-        "file_patterns": {
-            "prd-*.md": "prd",
-            "ops-*.md": "ops",
-            "dev-*.md": "dev",
-        },
-        # Values in Implements field that mean "no references"
-        "no_reference_values": ["-", "null", "none", "x", "X", "N/A", "n/a"],
-    },
-    "core": {
-        "path": None,
-        "remote": None,
-    },
-    "associated": {
-        "prefix": None,
-        "id_range": [1, 99999],
-    },
-    "rules": {
-        "hierarchy": {
-            "allowed_implements": [
-                "dev -> ops, prd",
-                "ops -> prd",
-                "prd -> prd",
-            ],
-            "allow_circular": False,
-            "allow_orphans": False,
-            "max_depth": 5,
-            "cross_repo_implements": True,
-        },
-        "format": {
-            "require_hash": True,
-            "require_rationale": False,
-            "require_status": True,
-            "allowed_statuses": ["Active", "Draft", "Deprecated", "Superseded"],
-            # Assertion format rules
-            "require_assertions": True,
-            "acceptance_criteria": "warn",  # allow | warn | error
-            "require_shall": True,
-            "labels_sequential": True,
-            "labels_unique": True,
-            "placeholder_values": [
-                "obsolete", "removed", "deprecated", "N/A", "n/a", "-", "reserved"
-            ],
-        },
-        "traceability": {
-            "require_code_link": False,
-            "scan_for_orphans": True,
-        },
-        "naming": {
-            "title_min_length": 10,
-            "title_max_length": 100,
-            "title_pattern": "^[A-Z].*",
-        },
-        "content_rules": [],  # List of content rule markdown file paths
-    },
-    "validation": {
-        "strict_hierarchy": True,
-        "hash_algorithm": "sha256",
-        "hash_length": 8,
-        "normalize_whitespace": False,  # If True, normalize whitespace before hashing
-    },
-    "traceability": {
-        "output_formats": ["markdown", "html"],
-        "output_dir": ".",
-        "scan_patterns": [
-            "database/**/*.sql",
-            "apps/**/*.dart",
-            "packages/**/*.dart",
-            "server/**/*.dart",
-            "tools/**/*.py",
-            ".github/workflows/**/*.yml",
-        ],
-        "impl_patterns": [
-            r"IMPLEMENTS.*REQ-",
-            r"Implements:\s*REQ-",
-            r"Fixes:\s*REQ-",
-        ],
-    },
-    "index": {
-        "auto_regenerate": False,
-    },
-    "testing": {
-        "enabled": False,
-        "test_dirs": [
-            "apps/**/test",
-            "apps/**/tests",
-            "packages/**/test",
-            "packages/**/tests",
-            "tools/**/tests",
-            "tests",
-        ],
-        "patterns": [
-            "*_test.dart",
-            "test_*.dart",
-            "test_*.py",
-            "*_test.py",
-            "*_test.sql",
-        ],
-        "result_files": [
-            "build-reports/**/TEST-*.xml",
-            "build-reports/pytest-results.json",
-        ],
-        "reference_patterns": [
-            # Test function names containing requirement IDs
-            r"test_.*(?:REQ[-_])?([pod]\d{5})(?:_[A-Z])?",
-            # Comment/docstring patterns
-            r"(?:IMPLEMENTS|Implements|implements)[:\s]+(?:REQ[-_])?([pod]\d{5})(?:-[A-Z])?",
-            # Direct requirement ID mentions
-            r"\bREQ[-_]([pod]\d{5})(?:-[A-Z])?\b",
-        ],
-    },
-    "hooks": {
-        "pre_commit": True,
-        "commit_msg": True,
-    },
-}