docassert 0.6.0__tar.gz → 0.7.0__tar.gz

{docassert-0.6.0/docassert.egg-info → docassert-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.6.0
+Version: 0.7.0
 Summary: Unit testing for business documents — validate structured Markdown docs against a configurable audit standard.
 Author: C4G Enterprises Inc.
 License: Apache-2.0
@@ -117,6 +117,9 @@ kind is adding a trio — no code for the common cases.
 - **Structural — deterministic, blocking.** Required fields and sections,
   measurable success criteria, risks with owner + mitigation, resolving
   references, unique ids. Plain Python, reliable enough to gate a merge.
+  Within this tier, *integrity* checks (malformed items, bad types, duplicate
+  ids) block at any status, while *completeness* checks relax to advisory on
+  `status: draft` and gate once a document is proposed — WIP is never punished.
 - **Semantic — AI-graded, advisory.** Scored via the Anthropic API and posted to
   the PR — never blocking. Set `ANTHROPIC_API_KEY` to enable; skipped otherwise.
 

{docassert-0.6.0 → docassert-0.7.0}/README.md

@@ -77,6 +77,9 @@ kind is adding a trio — no code for the common cases.
 - **Structural — deterministic, blocking.** Required fields and sections,
   measurable success criteria, risks with owner + mitigation, resolving
   references, unique ids. Plain Python, reliable enough to gate a merge.
+  Within this tier, *integrity* checks (malformed items, bad types, duplicate
+  ids) block at any status, while *completeness* checks relax to advisory on
+  `status: draft` and gate once a document is proposed — WIP is never punished.
 - **Semantic — AI-graded, advisory.** Scored via the Anthropic API and posted to
   the PR — never blocking. Set `ANTHROPIC_API_KEY` to enable; skipped otherwise.
 

{docassert-0.6.0 → docassert-0.7.0}/docassert/__init__.py

@@ -5,4 +5,4 @@ standard: deterministic structural checks that gate a merge, plus optional
 AI-graded semantic checks that advise.
 """
 
-__version__ = "0.6.0"
+__version__ = "0.7.0"

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/adr.criteria.yaml

@@ -18,9 +18,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/adr.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: items-well-formed
     type: structural
@@ -28,7 +32,7 @@ checks:
     description: Every decision is a valid **ADR-###** item.
   - id: adr-items-have-status
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every decision declares a valid Status (proposed | accepted | superseded | deprecated | rejected).
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/benefits-realization.criteria.yaml

@@ -16,13 +16,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/benefits-realization.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: measurable-items
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every benefit states a measurable target.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/brd.criteria.yaml

@@ -16,9 +16,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/brd.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: items-well-formed
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/business-case.criteria.yaml

@@ -13,9 +13,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/business-case.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/charter.criteria.yaml

@@ -26,19 +26,23 @@ checks:
     blocking: true
     description: Frontmatter is present and valid against schema/charter.schema.json.
 
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
 
   - id: measurable-success-criteria
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every Success Criteria bullet states a measurable threshold (number, %, currency, or date).
 
   - id: risks-have-owner-and-mitigation
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every Risks bullet names an Owner and a Mitigation.
 
   - id: dates-consistent

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/data-migration-plan.criteria.yaml

@@ -14,13 +14,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/data-migration-plan.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: mapping-table
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: The Field Mapping section contains a mapping table.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/frnfr.criteria.yaml

@@ -17,9 +17,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/frnfr.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: items-well-formed
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/hypercare-plan.criteria.yaml

@@ -13,13 +13,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/hypercare-plan.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: measurable-exit-criteria
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every hypercare exit criterion states a measurable threshold.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/post-implementation-review.criteria.yaml

@@ -14,9 +14,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/post-implementation-review.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/prd.criteria.yaml

@@ -17,9 +17,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/prd.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: items-well-formed
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/project.criteria.yaml

@@ -16,6 +16,10 @@ checks:
     blocking: true
     description: Frontmatter is present and valid against schema/project.schema.json.
 
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: project-id-format
     type: structural
     blocking: true
@@ -23,7 +27,7 @@ checks:
 
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
 
   - id: unique-id

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/qa-test-plan.criteria.yaml

@@ -13,13 +13,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/qa-test-plan.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: measurable-exit-criteria
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every exit criterion states a measurable threshold.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/raci-stakeholder.criteria.yaml

@@ -10,13 +10,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/raci-stakeholder.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: raci-one-accountable
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every activity in the RACI Matrix has exactly one Accountable (A) role.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/release-cutover-plan.criteria.yaml

@@ -16,13 +16,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/release-cutover-plan.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: numbered-steps
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Cutover Steps is an ordered list of at least two numbered steps.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/risk-register.criteria.yaml

@@ -14,9 +14,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/risk-register.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: items-well-formed
     type: structural
@@ -24,7 +28,7 @@ checks:
     description: Every risk is a valid **RISK-###** item.
   - id: risk-items-complete
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every risk states a Probability, Impact, Owner, and Response.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/rollback-plan.criteria.yaml

@@ -15,13 +15,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/rollback-plan.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: numbered-steps
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Rollback Steps is an ordered list of at least two numbered steps.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/runbook.criteria.yaml

@@ -16,13 +16,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/runbook.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: numbered-steps
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Procedures is an ordered list of at least two numbered steps.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/status-report.criteria.yaml

@@ -12,13 +12,17 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid (includes a period date and a green/amber/red rag).
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: references-risk
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: The Risks & Issues section cites at least one RISK-### from the register.
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/test-cases.criteria.yaml

@@ -14,9 +14,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/test-cases.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: items-well-formed
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/_data/criteria/user-story.criteria.yaml

@@ -14,9 +14,13 @@ checks:
     type: structural
     blocking: true
     description: Frontmatter is valid against schema/user-story.schema.json.
+  - id: frontmatter-complete
+    type: structural
+    blocking: once-proposed
+    description: Every schema-required frontmatter field is present (advisory while draft).
   - id: required-sections
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every required section is present and non-empty.
   - id: items-well-formed
     type: structural
@@ -24,7 +28,7 @@ checks:
     description: Every story is a valid **US-###** item.
   - id: story-format
     type: structural
-    blocking: true
+    blocking: once-proposed
     description: Every story follows "As a … I want … so that …".
   - id: unique-id
     type: structural

{docassert-0.6.0 → docassert-0.7.0}/docassert/structural.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 import datetime as dt
 import re
 from collections.abc import Callable
+from pathlib import Path
 
 from jsonschema import Draft7Validator, FormatChecker
 
@@ -73,15 +74,31 @@ def _as_date(value) -> dt.date | None:
 
 
 # ── individual checks ──────────────────────────────────────────────────────
+def _schema_errors(doc: Document, ctx: dict) -> list:
+    validator = Draft7Validator(ctx["schema"], format_checker=FormatChecker())
+    return sorted(validator.iter_errors(_jsonify(doc.frontmatter)), key=str)
+
+
+def _format_errors(errors) -> str:
+    return "; ".join(f"{'/'.join(str(p) for p in e.path) or '(root)'}: {e.message}"
+                     for e in errors)
+
+
 def check_frontmatter_schema(doc: Document, ctx: dict) -> tuple[bool, str]:
-    schema = ctx["schema"]
-    validator = Draft7Validator(schema, format_checker=FormatChecker())
-    errors = sorted(validator.iter_errors(_jsonify(doc.frontmatter)), key=str)
+    """Frontmatter *wellformedness*: type, format, pattern, and enum errors.
+    Missing required fields are completeness, checked by frontmatter-complete."""
+    errors = [e for e in _schema_errors(doc, ctx) if e.validator != "required"]
     if not errors:
         return True, "Frontmatter is valid against the schema."
-    msgs = "; ".join(f"{'/'.join(str(p) for p in e.path) or '(root)'}: {e.message}"
-                     for e in errors)
-    return False, f"Frontmatter schema errors: {msgs}"
+    return False, f"Frontmatter schema errors: {_format_errors(errors)}"
+
+
+def check_frontmatter_complete(doc: Document, ctx: dict) -> tuple[bool, str]:
+    """Frontmatter *completeness*: every schema-required field is present."""
+    errors = [e for e in _schema_errors(doc, ctx) if e.validator == "required"]
+    if not errors:
+        return True, "All required frontmatter fields are present."
+    return False, f"Missing required frontmatter: {_format_errors(errors)}"
 
 
 def check_required_sections(doc: Document, ctx: dict) -> tuple[bool, str]:
@@ -133,8 +150,12 @@ def check_dates_consistent(doc: Document, ctx: dict) -> tuple[bool, str]:
     dates = doc.frontmatter.get("dates") or {}
     created = _as_date(dates.get("created"))
     target = _as_date(dates.get("target"))
+    if created is None and dates.get("created") is not None:
+        return False, f"dates.created is not a valid ISO date: {dates.get('created')!r}"
+    if target is None and dates.get("target") is not None:
+        return False, f"dates.target is not a valid ISO date: {dates.get('target')!r}"
     if created is None or target is None:
-        return False, "dates.created and dates.target must be valid ISO dates."
+        return True, "Date(s) not set yet (presence is checked by frontmatter-complete)."
     if target < created:
         return False, f"target ({target}) is before created ({created})."
     return True, f"Dates consistent (created {created} → target {target})."
@@ -143,7 +164,9 @@ def check_dates_consistent(doc: Document, ctx: dict) -> tuple[bool, str]:
 def check_unique_id(doc: Document, ctx: dict) -> tuple[bool, str]:
     if not doc.id:
         return False, "Document has no id."
-    others = [p for p in ctx.get("id_index", {}).get(doc.id, []) if p != doc.path]
+    me = Path(doc.path).resolve()
+    others = [p for p in ctx.get("id_index", {}).get(doc.id, [])
+              if Path(p).resolve() != me]
     if others:
         return False, f"id '{doc.id}' also used by: {', '.join(others)}"
     return True, f"id '{doc.id}' is unique."
@@ -371,6 +394,7 @@ def check_references_risk(doc: Document, ctx: dict) -> tuple[bool, str]:
 
 CHECKS: dict[str, Callable[[Document, dict], tuple[bool, str]]] = {
     "frontmatter-schema": check_frontmatter_schema,
+    "frontmatter-complete": check_frontmatter_complete,
     "required-sections": check_required_sections,
     "measurable-success-criteria": check_measurable_success_criteria,
     "risks-have-owner-and-mitigation": check_risks_owner_mitigation,
@@ -390,11 +414,29 @@ CHECKS: dict[str, Callable[[Document, dict], tuple[bool, str]]] = {
 }
 
 
+def _effective_blocking(spec: dict, doc: Document) -> bool:
+    """Interpret the criteria `blocking` value.
+
+    true/"always"  -> blocks at any status (integrity: malformed data)
+    "once-proposed" -> blocks once status is proposed or beyond; advisory for
+                       drafts (completeness: WIP is never punished)
+    false/"never"  -> advisory
+    """
+    b = spec.get("blocking", True)
+    if b in (True, "always"):
+        return True
+    if b in (False, "never"):
+        return False
+    if b == "once-proposed":
+        return str(doc.frontmatter.get("status", "draft")).lower() != "draft"
+    return bool(b)
+
+
 def run_structural(doc: Document, spec: dict, ctx: dict) -> CheckResult:
     """Run one structural check described by a criteria `spec` dict."""
     check_id = spec["id"]
     fn = CHECKS.get(check_id)
-    blocking = bool(spec.get("blocking", True))
+    blocking = _effective_blocking(spec, doc)
     if fn is None:
         return CheckResult(check_id, False, blocking,
                            f"Unknown structural check '{check_id}'.", kind="structural")

{docassert-0.6.0 → docassert-0.7.0/docassert.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.6.0
+Version: 0.7.0
 Summary: Unit testing for business documents — validate structured Markdown docs against a configurable audit standard.
 Author: C4G Enterprises Inc.
 License: Apache-2.0
@@ -117,6 +117,9 @@ kind is adding a trio — no code for the common cases.
 - **Structural — deterministic, blocking.** Required fields and sections,
   measurable success criteria, risks with owner + mitigation, resolving
   references, unique ids. Plain Python, reliable enough to gate a merge.
+  Within this tier, *integrity* checks (malformed items, bad types, duplicate
+  ids) block at any status, while *completeness* checks relax to advisory on
+  `status: draft` and gate once a document is proposed — WIP is never punished.
 - **Semantic — AI-graded, advisory.** Scored via the Anthropic API and posted to
   the PR — never blocking. Set `ANTHROPIC_API_KEY` to enable; skipped otherwise.
 

{docassert-0.6.0 → docassert-0.7.0}/docassert.egg-info/SOURCES.txt

@@ -94,6 +94,7 @@ tests/test_badge.py
 tests/test_config.py
 tests/test_consistency.py
 tests/test_defects.py
+tests/test_draft_relaxation.py
 tests/test_extract.py
 tests/test_graph.py
 tests/test_json_report.py

docassert-0.7.0/tests/test_draft_relaxation.py

@@ -0,0 +1,138 @@
+"""Tests for check severities: integrity always blocks; completeness relaxes
+to advisory while a document is a draft ("WIP is never punished")."""
+from pathlib import Path
+
+from docassert.cli import main
+from docassert.loader import parse_sections
+from docassert.models import Document
+from docassert.structural import (
+    _effective_blocking,
+    check_dates_consistent,
+    check_frontmatter_complete,
+    check_frontmatter_schema,
+)
+
+ROOT = Path(__file__).resolve().parent.parent
+
+DRAFT_CHARTER = """---
+kind: charter
+project: PRJ-001-TST
+id: TST-charter
+title: T — Draft Charter
+sponsor: jane.doe
+dates:
+  created: 2026-01-01
+status: {status}
+---
+
+## Objective
+Cut cycle time from 10 days to under 2 days.
+
+## Success Criteria
+- Median cycle time drops below 48 hours.
+
+## Scope
+In scope: the thing.
+
+## Milestones
+- TODO: none yet.
+
+## Risks
+- Might slip. Owner: jane.doe. Mitigation: buffer.
+
+## Approval
+Pending.
+"""
+
+
+def _write(tmp_path, status):
+    d = tmp_path / "documents" / "PRJ-001-TST"
+    d.mkdir(parents=True, exist_ok=True)
+    f = d / "charter.md"
+    f.write_text(DRAFT_CHARTER.format(status=status), encoding="utf-8")
+    return f
+
+
+# ── the Refuge scenario: an incomplete DRAFT merges (advisory only) ──────────
+def test_draft_missing_budget_is_advisory(tmp_path, monkeypatch, capsys):
+    f = _write(tmp_path, "draft")
+    monkeypatch.chdir(tmp_path)
+    assert main(["validate", str(f)]) == 0          # no blocking failures
+    out = capsys.readouterr().out
+    assert "Missing required frontmatter" in out    # ...but the gap is reported
+    assert "budget" in out
+
+
+def test_proposed_missing_budget_blocks(tmp_path, monkeypatch):
+    f = _write(tmp_path, "proposed")
+    monkeypatch.chdir(tmp_path)
+    assert main(["validate", str(f)]) >= 1          # completeness now gates
+
+
+def test_type_error_blocks_even_on_draft(tmp_path, monkeypatch):
+    f = _write(tmp_path, "draft")
+    f.write_text(f.read_text().replace("sponsor: jane.doe", "sponsor: j"),
+                 encoding="utf-8")                  # minLength violation = malformed
+    monkeypatch.chdir(tmp_path)
+    assert main(["validate", str(f)]) >= 1
+
+
+def test_malformed_item_blocks_even_on_draft(tmp_path, monkeypatch):
+    d = tmp_path / "documents" / "PRJ-001-TST"
+    d.mkdir(parents=True)
+    (d / "brd.md").write_text("""---
+kind: brd
+project: PRJ-001-TST
+id: TST-brd
+title: T
+owner: jane.doe
+status: draft
+---
+
+## Purpose
+p.
+
+## Business Requirements
+- **broken bullet** without a valid item id
+
+## Out of Scope
+n/a
+""", encoding="utf-8")
+    monkeypatch.chdir(tmp_path)
+    assert main(["validate", str(d / "brd.md")]) >= 1   # integrity: always blocks
+
+
+# ── the split checks ─────────────────────────────────────────────────────────
+def _doc(fm):
+    return Document("x.md", fm, parse_sections(""), "")
+
+
+def test_schema_vs_complete_split():
+    import json
+    schema = json.loads((ROOT / "schema" / "charter.schema.json").read_text())
+    ctx = {"schema": schema}
+    doc = _doc({"kind": "charter", "id": "TST-charter", "project": "PRJ-001-TST",
+                "title": "Test Charter", "sponsor": "jane.doe", "status": "draft"})  # no budget/dates
+    ok_schema, _ = check_frontmatter_schema(doc, ctx)
+    ok_complete, detail = check_frontmatter_complete(doc, ctx)
+    assert ok_schema                     # nothing malformed
+    assert not ok_complete and "budget" in detail
+
+
+def test_dates_absent_pass_invalid_fail():
+    assert check_dates_consistent(_doc({"dates": {}}), {})[0]
+    assert check_dates_consistent(_doc({}), {})[0]
+    ok, detail = check_dates_consistent(_doc({"dates": {"created": "soonish"}}), {})
+    assert not ok and "soonish" in detail
+
+
+# ── blocking interpretation ──────────────────────────────────────────────────
+def test_effective_blocking_modes():
+    draft, proposed = _doc({"status": "draft"}), _doc({"status": "proposed"})
+    assert _effective_blocking({"blocking": True}, draft)
+    assert _effective_blocking({"blocking": "always"}, draft)
+    assert not _effective_blocking({"blocking": False}, proposed)
+    assert not _effective_blocking({"blocking": "never"}, proposed)
+    assert not _effective_blocking({"blocking": "once-proposed"}, draft)
+    assert _effective_blocking({"blocking": "once-proposed"}, proposed)
+    assert not _effective_blocking({"blocking": "once-proposed"}, _doc({}))  # no status = draft