sumd 0.3.24__tar.gz → 0.3.26__tar.gz

{sumd-0.3.24 → sumd-0.3.26}/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.26] - 2026-04-23
+
+### Docs
+- Update README.md
+- Update docs/README.md
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/calls.toon.yaml
+- Update project/calls.yaml
+- Update project/compact_flow.mmd
+- Update project/compact_flow.png
+- Update project/duplication.toon.yaml
+- Update project/evolution.toon.yaml
+- Update project/flow.mmd
+- ... and 11 more files
+
+## [0.3.25] - 2026-04-22
+
+### Docs
+- Update README.md
+
 ## [0.3.24] - 2026-04-22
 
 ### Docs

{sumd-0.3.24 → sumd-0.3.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sumd
-Version: 0.3.24
+Version: 0.3.26
 Summary: SUMD - Structured Unified Markdown Descriptor for AI-aware project documentation
 Project-URL: Homepage, https://github.com/tom/statement
 Project-URL: Repository, https://github.com/tom/statement
@@ -41,17 +41,17 @@ Description-Content-Type: text/markdown
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.3.24-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-19.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.3.26-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-19.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (54 commits)
-- 👤 **Human dev:** ~$1946 (19.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (56 commits)
+- 👤 **Human dev:** ~$1971 (19.7h @ $100/h, 30min dedup)
 
-Generated on 2026-04-22 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-23 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![Version](https://img.shields.io/badge/version-0.3.24-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![Version](https://img.shields.io/badge/version-0.3.26-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 **SUMD** (Structured Unified Markdown Descriptor) is a semantic project descriptor format in Markdown.  
 It defines intent, structure, execution entry points, and the mental model of a system for both humans and LLMs.

{sumd-0.3.24 → sumd-0.3.26}/README.md

@@ -3,17 +3,17 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.3.24-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-19.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.3.26-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-19.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (54 commits)
-- 👤 **Human dev:** ~$1946 (19.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (56 commits)
+- 👤 **Human dev:** ~$1971 (19.7h @ $100/h, 30min dedup)
 
-Generated on 2026-04-22 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-23 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![Version](https://img.shields.io/badge/version-0.3.24-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![Version](https://img.shields.io/badge/version-0.3.26-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 **SUMD** (Structured Unified Markdown Descriptor) is a semantic project descriptor format in Markdown.  
 It defines intent, structure, execution entry points, and the mental model of a system for both humans and LLMs.

{sumd-0.3.24 → sumd-0.3.26}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sumd"
-version = "0.3.24"
+version = "0.3.26"
 description = "SUMD - Structured Unified Markdown Descriptor for AI-aware project documentation"
 readme = "README.md"
 license = "Apache-2.0"

{sumd-0.3.24 → sumd-0.3.26}/sumd/__init__.py

@@ -4,7 +4,7 @@ SUMD is a semantic project descriptor format in Markdown that defines intent,
 structure, execution entry points, and mental model of a system for both humans and LLMs.
 """
 
-__version__ = "0.3.24"
+__version__ = "0.3.26"
 
 from sumd.parser import (
     SUMDDocument,
@@ -12,10 +12,12 @@ from sumd.parser import (
     parse,
     parse_file,
     validate,
+)
+from sumd.validator import (
+    CodeBlockIssue,
     validate_codeblocks,
     validate_markdown,
     validate_sumd_file,
-    CodeBlockIssue,
 )
 from sumd.generator import generate_sumd_content
 

{sumd-0.3.24 → sumd-0.3.26}/sumd/cli.py

@@ -872,6 +872,78 @@ def _echo_scan_result(proj_dir: Path, doc, sources: list, cb_warnings: list) ->
     )
 
 
+def _maybe_generate_doql(proj_dir: Path, fix: bool) -> None:
+    """Generate app.doql.less BEFORE rendering SUMD so it gets included.
+
+    Pull name/version from the most specific manifest available and
+    pick language-appropriate defaults for the boilerplate.
+    """
+    project_type = _detect_project_type(proj_dir)
+    pyproj = extract_pyproject(proj_dir)
+    pkg_json = extract_package_json(proj_dir) if project_type == "node" else {}
+    project_name = (
+        pyproj.get("name")
+        or pkg_json.get("name")
+        or proj_dir.name
+    )
+    version = (
+        pyproj.get("version")
+        or pkg_json.get("version")
+        or "0.1.0"
+    )
+    doql_path = _generate_doql_less(
+        proj_dir, project_name, version,
+        force=fix, project_type=project_type,
+    )
+    if doql_path:
+        click.echo(f"   📝 Generated {doql_path.name} ({project_type})")
+
+
+def _finalize_scan(
+    proj_dir: Path,
+    doc,
+    sources: list,
+    cb_warnings: list,
+    export_json: bool,
+    run_analyze: bool,
+    tool_list: list[str],
+    doql_sync: bool,
+    sumd_path: Path,
+) -> dict:
+    """Run post-scan actions: export JSON, run analysis, DOQL sync."""
+    _echo_scan_result(proj_dir, doc, sources, cb_warnings)
+
+    if export_json:
+        _export_sumd_json(proj_dir, doc)
+
+    if run_analyze:
+        click.echo("   🔬 Running analysis...")
+        _run_analysis_tools(proj_dir, tool_list)
+        click.echo(f"   ✅ Analysis complete → {proj_dir / 'project'}/")
+
+    if doql_sync and ((proj_dir / "app.doql.less").exists() or (proj_dir / "app.doql.css").exists()):
+        click.echo("   ⚙️  Syncing DOQL...")
+        r = subprocess.run(
+            ["doql", "sync"],
+            cwd=str(proj_dir),
+            capture_output=True,
+            text=True,
+        )
+        if r.returncode == 0:
+            click.echo("   ✅ DOQL sync complete")
+        else:
+            click.echo(f"   ⚠️  DOQL sync failed: {r.stderr.strip() or r.stdout.strip()}", err=True)
+
+    return {
+        "status": "OK",
+        "project_name": doc.project_name,
+        "sections": len(doc.sections),
+        "sources": sources,
+        "path": str(sumd_path),
+        "warnings": [c.message for c in cb_warnings],
+    }
+
+
 def _scan_one_project(
     proj_dir: Path,
     fix: bool,
@@ -896,29 +968,8 @@ def _scan_one_project(
         return {"status": "SKIP", "path": str(sumd_path)}
 
     try:
-        # Generate app.doql.less BEFORE rendering SUMD so it gets included.
-        # Pull name/version from the most specific manifest available and
-        # pick language-appropriate defaults for the boilerplate.
         if generate_doql:
-            project_type = _detect_project_type(proj_dir)
-            pyproj = extract_pyproject(proj_dir)
-            pkg_json = extract_package_json(proj_dir) if project_type == "node" else {}
-            project_name = (
-                pyproj.get("name")
-                or pkg_json.get("name")
-                or proj_dir.name
-            )
-            version = (
-                pyproj.get("version")
-                or pkg_json.get("version")
-                or "0.1.0"
-            )
-            doql_path = _generate_doql_less(
-                proj_dir, project_name, version,
-                force=fix, project_type=project_type,
-            )
-            if doql_path:
-                click.echo(f"   📝 Generated {doql_path.name} ({project_type})")
+            _maybe_generate_doql(proj_dir, fix)
 
         doc, md_issues, cb_errors, cb_warnings, sources = _render_write_validate(
             proj_dir, sumd_path, raw, profile
@@ -933,37 +984,10 @@ def _scan_one_project(
                 click.echo(f"       \u2193 {e}")
             return {"status": "INVALID", "errors": all_errors, "path": str(sumd_path)}
 
-        _echo_scan_result(proj_dir, doc, sources, cb_warnings)
-
-        if export_json:
-            _export_sumd_json(proj_dir, doc)
-
-        if run_analyze:
-            click.echo("   \U0001f52c Running analysis...")
-            _run_analysis_tools(proj_dir, tool_list)
-            click.echo(f"   \u2705 Analysis complete \u2192 {proj_dir / 'project'}/")
-
-        if doql_sync and ((proj_dir / "app.doql.less").exists() or (proj_dir / "app.doql.css").exists()):
-            click.echo("   \u2699\ufe0f  Syncing DOQL...")
-            r = subprocess.run(
-                ["doql", "sync"],
-                cwd=str(proj_dir),
-                capture_output=True,
-                text=True,
-            )
-            if r.returncode == 0:
-                click.echo("   \u2705 DOQL sync complete")
-            else:
-                click.echo(f"   \u26a0\ufe0f  DOQL sync failed: {r.stderr.strip() or r.stdout.strip()}", err=True)
-
-        return {
-            "status": "OK",
-            "project_name": doc.project_name,
-            "sections": len(doc.sections),
-            "sources": sources,
-            "path": str(sumd_path),
-            "warnings": [c.message for c in cb_warnings],
-        }
+        return _finalize_scan(
+            proj_dir, doc, sources, cb_warnings,
+            export_json, run_analyze, tool_list, doql_sync, sumd_path,
+        )
 
     except Exception as exc:
         dash = "\u2013"
@@ -975,7 +999,7 @@ def _scan_one_project(
 @click.argument("workspace", type=click.Path(exists=True, path_type=Path), default=".")
 @click.option(
     "--export-json/--no-export-json",
-    default=True,
+    default=False,
     help="Also export sumd.json per project",
 )
 @click.option(

sumd-0.3.26/sumd/parser.py

@@ -0,0 +1,233 @@
+"""SUMD Parser - Parse and validate SUMD markdown documents."""
+
+import re
+from dataclasses import dataclass, field
+from enum import Enum
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+
+class SectionType(Enum):
+    """SUMD section types."""
+
+    PROJECT_HEADER = "project_header"
+    METADATA = "metadata"
+    INTENT = "intent"
+    ARCHITECTURE = "architecture"
+    INTERFACES = "interfaces"
+    WORKFLOWS = "workflows"
+    CONFIGURATION = "configuration"
+    DEPENDENCIES = "dependencies"
+    DEPLOYMENT = "deployment"
+    UNKNOWN = "unknown"
+
+
+@dataclass
+class Section:
+    """Represents a SUMD section."""
+
+    name: str
+    type: SectionType
+    content: str
+    level: int
+    subsections: List["Section"] = field(default_factory=list)
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class SUMDDocument:
+    """Represents a parsed SUMD document."""
+
+    project_name: str
+    description: str
+    sections: List[Section] = field(default_factory=list)
+    metadata: Dict[str, Any] = field(default_factory=dict)
+    raw_content: str = ""
+
+
+class SUMDParser:
+    """Parser for SUMD markdown documents."""
+
+    SECTION_MAPPING = {
+        "metadata": SectionType.METADATA,
+        "intent": SectionType.INTENT,
+        "architecture": SectionType.ARCHITECTURE,
+        "interfaces": SectionType.INTERFACES,
+        "workflows": SectionType.WORKFLOWS,
+        "configuration": SectionType.CONFIGURATION,
+        "dependencies": SectionType.DEPENDENCIES,
+        "deployment": SectionType.DEPLOYMENT,
+    }
+
+    def __init__(self):
+        self.current_document: Optional[SUMDDocument] = None
+
+    def parse(self, content: str) -> SUMDDocument:
+        """Parse a SUMD markdown document.
+
+        Args:
+            content: The markdown content to parse
+
+        Returns:
+            SUMDDocument: Parsed document structure
+        """
+        self.current_document = SUMDDocument(
+            project_name="", description="", raw_content=content
+        )
+
+        lines = content.split("\n")
+        self._parse_header(lines)
+        self._parse_sections(lines)
+
+        return self.current_document
+
+    def parse_file(self, path: Path) -> SUMDDocument:
+        """Parse a SUMD file.
+
+        Args:
+            path: Path to the SUMD markdown file
+
+        Returns:
+            SUMDDocument: Parsed document structure
+        """
+        content = path.read_text(encoding="utf-8")
+        return self.parse(content)
+
+    def _parse_header(self, lines: List[str]) -> None:
+        """Parse the project header (H1).
+
+        Args:
+            lines: List of document lines
+        """
+        if not lines:
+            return
+
+        # Find H1 header
+        for i, line in enumerate(lines):
+            if line.startswith("# ") and not line.startswith("##"):
+                header_content = line[2:].strip()
+                # Split into name and description
+                parts = header_content.split(" - ", 1)
+                self.current_document.project_name = parts[0].strip()
+                if len(parts) > 1:
+                    self.current_document.description = parts[1].strip()
+                else:
+                    # Look for description on next lines
+                    for j in range(i + 1, min(i + 3, len(lines))):
+                        if lines[j].strip() and not lines[j].startswith("#"):
+                            self.current_document.description = lines[j].strip()
+                            break
+                break
+
+    def _parse_sections(self, lines: List[str]) -> None:
+        """Parse all sections in the document.
+
+        Args:
+            lines: List of document lines
+        """
+        sections = []
+        current_section = None
+        current_content = []
+
+        for line in lines:
+            if line.startswith("##"):
+                # Save previous section
+                if current_section:
+                    current_section.content = "\n".join(current_content).strip()
+                    sections.append(current_section)
+                    current_content = []
+
+                # Start new section
+                section_name = line[2:].strip().lower()
+                section_type = self.SECTION_MAPPING.get(
+                    section_name, SectionType.UNKNOWN
+                )
+                current_section = Section(
+                    name=section_name, type=section_type, content="", level=2
+                )
+            elif current_section:
+                current_content.append(line)
+
+        # Save last section
+        if current_section:
+            current_section.content = "\n".join(current_content).strip()
+            sections.append(current_section)
+
+        self.current_document.sections = sections
+
+    def validate(self, document: SUMDDocument) -> List[str]:
+        """Validate a SUMD document against the specification.
+
+        Args:
+            document: The document to validate
+
+        Returns:
+            List of validation errors (empty if valid)
+        """
+        errors = []
+
+        # Check required sections
+        section_types = {section.type for section in document.sections}
+
+        if SectionType.INTENT not in section_types:
+            errors.append("Missing required section: Intent")
+
+        if SectionType.ARCHITECTURE not in section_types:
+            errors.append("Missing required section: Architecture")
+
+        if SectionType.INTERFACES not in section_types:
+            errors.append("Missing required section: Interfaces")
+
+        # Check project name
+        if not document.project_name:
+            errors.append("Missing project name in header")
+
+        return errors
+
+
+def parse(content: str) -> SUMDDocument:
+    """Parse a SUMD markdown document.
+
+    Args:
+        content: The markdown content to parse
+
+    Returns:
+        SUMDDocument: Parsed document structure
+    """
+    parser = SUMDParser()
+    return parser.parse(content)
+
+
+def parse_file(path: Path) -> SUMDDocument:
+    """Parse a SUMD file.
+
+    Args:
+        path: Path to the SUMD markdown file
+
+    Returns:
+        SUMDDocument: Parsed document structure
+    """
+    parser = SUMDParser()
+    return parser.parse_file(path)
+
+
+def validate(document: SUMDDocument) -> List[str]:
+    """Validate a SUMD document.
+
+    Args:
+        document: The document to validate
+
+    Returns:
+        List of validation errors (empty if valid)
+    """
+    parser = SUMDParser()
+    return parser.validate(document)
+
+
+# Backward-compatible re-exports from validator module
+from sumd.validator import (
+    CodeBlockIssue,
+    validate_codeblocks,
+    validate_markdown,
+    validate_sumd_file,
+)

sumd-0.3.24/sumd/parser.py → sumd-0.3.26/sumd/validator.py

@@ -1,227 +1,8 @@
-"""SUMD Parser - Parse and validate SUMD markdown documents."""
+"""SUMD Validator — validate markdown structure and fenced codeblocks."""
 
 import re
-from dataclasses import dataclass, field
-from enum import Enum
+from dataclasses import dataclass
 from pathlib import Path
-from typing import Any, Dict, List, Optional
-
-
-class SectionType(Enum):
-    """SUMD section types."""
-
-    PROJECT_HEADER = "project_header"
-    METADATA = "metadata"
-    INTENT = "intent"
-    ARCHITECTURE = "architecture"
-    INTERFACES = "interfaces"
-    WORKFLOWS = "workflows"
-    CONFIGURATION = "configuration"
-    DEPENDENCIES = "dependencies"
-    DEPLOYMENT = "deployment"
-    UNKNOWN = "unknown"
-
-
-@dataclass
-class Section:
-    """Represents a SUMD section."""
-
-    name: str
-    type: SectionType
-    content: str
-    level: int
-    subsections: List["Section"] = field(default_factory=list)
-    metadata: Dict[str, Any] = field(default_factory=dict)
-
-
-@dataclass
-class SUMDDocument:
-    """Represents a parsed SUMD document."""
-
-    project_name: str
-    description: str
-    sections: List[Section] = field(default_factory=list)
-    metadata: Dict[str, Any] = field(default_factory=dict)
-    raw_content: str = ""
-
-
-class SUMDParser:
-    """Parser for SUMD markdown documents."""
-
-    SECTION_MAPPING = {
-        "metadata": SectionType.METADATA,
-        "intent": SectionType.INTENT,
-        "architecture": SectionType.ARCHITECTURE,
-        "interfaces": SectionType.INTERFACES,
-        "workflows": SectionType.WORKFLOWS,
-        "configuration": SectionType.CONFIGURATION,
-        "dependencies": SectionType.DEPENDENCIES,
-        "deployment": SectionType.DEPLOYMENT,
-    }
-
-    def __init__(self):
-        self.current_document: Optional[SUMDDocument] = None
-
-    def parse(self, content: str) -> SUMDDocument:
-        """Parse a SUMD markdown document.
-
-        Args:
-            content: The markdown content to parse
-
-        Returns:
-            SUMDDocument: Parsed document structure
-        """
-        self.current_document = SUMDDocument(
-            project_name="", description="", raw_content=content
-        )
-
-        lines = content.split("\n")
-        self._parse_header(lines)
-        self._parse_sections(lines)
-
-        return self.current_document
-
-    def parse_file(self, path: Path) -> SUMDDocument:
-        """Parse a SUMD file.
-
-        Args:
-            path: Path to the SUMD markdown file
-
-        Returns:
-            SUMDDocument: Parsed document structure
-        """
-        content = path.read_text(encoding="utf-8")
-        return self.parse(content)
-
-    def _parse_header(self, lines: List[str]) -> None:
-        """Parse the project header (H1).
-
-        Args:
-            lines: List of document lines
-        """
-        if not lines:
-            return
-
-        # Find H1 header
-        for i, line in enumerate(lines):
-            if line.startswith("# ") and not line.startswith("##"):
-                header_content = line[2:].strip()
-                # Split into name and description
-                parts = header_content.split(" - ", 1)
-                self.current_document.project_name = parts[0].strip()
-                if len(parts) > 1:
-                    self.current_document.description = parts[1].strip()
-                else:
-                    # Look for description on next lines
-                    for j in range(i + 1, min(i + 3, len(lines))):
-                        if lines[j].strip() and not lines[j].startswith("#"):
-                            self.current_document.description = lines[j].strip()
-                            break
-                break
-
-    def _parse_sections(self, lines: List[str]) -> None:
-        """Parse all sections in the document.
-
-        Args:
-            lines: List of document lines
-        """
-        sections = []
-        current_section = None
-        current_content = []
-
-        for line in lines:
-            if line.startswith("##"):
-                # Save previous section
-                if current_section:
-                    current_section.content = "\n".join(current_content).strip()
-                    sections.append(current_section)
-                    current_content = []
-
-                # Start new section
-                section_name = line[2:].strip().lower()
-                section_type = self.SECTION_MAPPING.get(
-                    section_name, SectionType.UNKNOWN
-                )
-                current_section = Section(
-                    name=section_name, type=section_type, content="", level=2
-                )
-            elif current_section:
-                current_content.append(line)
-
-        # Save last section
-        if current_section:
-            current_section.content = "\n".join(current_content).strip()
-            sections.append(current_section)
-
-        self.current_document.sections = sections
-
-    def validate(self, document: SUMDDocument) -> List[str]:
-        """Validate a SUMD document against the specification.
-
-        Args:
-            document: The document to validate
-
-        Returns:
-            List of validation errors (empty if valid)
-        """
-        errors = []
-
-        # Check required sections
-        section_types = {section.type for section in document.sections}
-
-        if SectionType.INTENT not in section_types:
-            errors.append("Missing required section: Intent")
-
-        if SectionType.ARCHITECTURE not in section_types:
-            errors.append("Missing required section: Architecture")
-
-        if SectionType.INTERFACES not in section_types:
-            errors.append("Missing required section: Interfaces")
-
-        # Check project name
-        if not document.project_name:
-            errors.append("Missing project name in header")
-
-        return errors
-
-
-def parse(content: str) -> SUMDDocument:
-    """Parse a SUMD markdown document.
-
-    Args:
-        content: The markdown content to parse
-
-    Returns:
-        SUMDDocument: Parsed document structure
-    """
-    parser = SUMDParser()
-    return parser.parse(content)
-
-
-def parse_file(path: Path) -> SUMDDocument:
-    """Parse a SUMD file.
-
-    Args:
-        path: Path to the SUMD markdown file
-
-    Returns:
-        SUMDDocument: Parsed document structure
-    """
-    parser = SUMDParser()
-    return parser.parse_file(path)
-
-
-def validate(document: SUMDDocument) -> List[str]:
-    """Validate a SUMD document.
-
-    Args:
-        document: The document to validate
-
-    Returns:
-        List of validation errors (empty if valid)
-    """
-    parser = SUMDParser()
-    return parser.validate(document)
 
 
 # ---------------------------------------------------------------------------