sumd 0.3.44__tar.gz → 0.3.45__tar.gz

{sumd-0.3.44 → sumd-0.3.45}/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.45] - 2026-04-25
+
+### Docs
+- Update README.md
+
+### Other
+- Update sumd/sections/api_stubs.py
+- Update sumd/sections/architecture.py
+- Update sumd/sections/call_graph.py
+- Update sumd/sections/configuration.py
+- Update sumd/sections/dependencies.py
+- Update sumd/sections/deployment.py
+- Update sumd/sections/extras.py
+- Update sumd/sections/interfaces.py
+- Update sumd/sections/metadata.py
+- Update sumd/sections/quality.py
+- ... and 8 more files
+
 ## [0.3.44] - 2026-04-24
 
 ### Docs

{sumd-0.3.44 → sumd-0.3.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sumd
-Version: 0.3.44
+Version: 0.3.45
 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.44-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-26.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.45-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-27.6h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (74 commits)
-- 👤 **Human dev:** ~$2650 (26.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (75 commits)
+- 👤 **Human dev:** ~$2765 (27.6h @ $100/h, 30min dedup)
 
-Generated on 2026-04-24 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![Version](https://img.shields.io/badge/version-0.3.44-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.45-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.44 → sumd-0.3.45}/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.44-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-26.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.45-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-27.6h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (74 commits)
-- 👤 **Human dev:** ~$2650 (26.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (75 commits)
+- 👤 **Human dev:** ~$2765 (27.6h @ $100/h, 30min dedup)
 
-Generated on 2026-04-24 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![Version](https://img.shields.io/badge/version-0.3.44-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.45-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.44 → sumd-0.3.45}/pyproject.toml

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

{sumd-0.3.44 → sumd-0.3.45}/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.44"
+__version__ = "0.3.45"
 
 from sumd.models import SUMDDocument
 from sumd.parser import (

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/api_stubs.py

@@ -7,6 +7,7 @@ LLM sees function signatures and HTTP method/path without reading full openapi.y
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
 
 
 # ---------------------------------------------------------------------------
@@ -69,8 +70,7 @@ class ApiStubsSection:
     def should_render(self, ctx: RenderContext) -> bool:
         return bool(ctx.openapi.get("endpoints"))
 
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_api_stubs(ctx.openapi)
+    render = call_with_ctx(_render_api_stubs, "openapi")
 
 
 assert isinstance(ApiStubsSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/architecture.py

@@ -5,6 +5,8 @@ from __future__ import annotations
 from pathlib import Path
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
+from sumd.sections.utils.should_render import always
 
 
 # ---------------------------------------------------------------------------
@@ -143,13 +145,10 @@ class ArchitectureSection:
     level = 2
     profiles = frozenset({"minimal", "light", "rich"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return True
-
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_architecture(
-            ctx.doql, ctx.modules, ctx.name, ctx.proj_dir, ctx.raw_sources
-        )
+    should_render = always
+    render = call_with_ctx(
+        _render_architecture, "doql", "modules", "name", "proj_dir", "raw_sources"
+    )
 
 
 assert isinstance(ArchitectureSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/call_graph.py

@@ -11,6 +11,7 @@ from __future__ import annotations
 import re
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
 
 
 # ---------------------------------------------------------------------------
@@ -149,8 +150,7 @@ class CallGraphSection:
     def should_render(self, ctx: RenderContext) -> bool:
         return any("calls.toon" in e.get("file", "") for e in ctx.project_analysis)
 
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_call_graph(ctx.project_analysis)
+    render = call_with_ctx(_render_call_graph, "project_analysis")
 
 
 assert isinstance(CallGraphSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/configuration.py

@@ -3,6 +3,8 @@
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
+from sumd.sections.utils.should_render import always
 
 
 # ---------------------------------------------------------------------------
@@ -34,11 +36,8 @@ class ConfigurationSection:
     level = 2
     profiles = frozenset({"light", "rich"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return True
-
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_configuration_section(ctx.name, ctx.version)
+    should_render = always
+    render = call_with_ctx(_render_configuration_section, "name", "version")
 
 
 assert isinstance(ConfigurationSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/dependencies.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
 
 
 # ---------------------------------------------------------------------------
@@ -90,8 +91,7 @@ class DependenciesSection:
             or ctx.pkg_json.get("devDependencies")
         )
 
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_dependencies(ctx.deps, ctx.dev_deps, ctx.pkg_json)
+    render = call_with_ctx(_render_dependencies, "deps", "dev_deps", "pkg_json")
 
 
 assert isinstance(DependenciesSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/deployment.py

@@ -3,6 +3,8 @@
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
+from sumd.sections.utils.should_render import always
 
 
 # ---------------------------------------------------------------------------
@@ -99,13 +101,10 @@ class DeploymentSection:
     level = 2
     profiles = frozenset({"light", "rich"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return True
-
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_deployment(
-            ctx.pkg_json, ctx.name, ctx.reqs, ctx.dockerfile, ctx.compose
-        )
+    should_render = always
+    render = call_with_ctx(
+        _render_deployment, "pkg_json", "name", "reqs", "dockerfile", "compose"
+    )
 
 
 assert isinstance(DeploymentSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/extras.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
 
 
 # ---------------------------------------------------------------------------
@@ -65,8 +66,7 @@ class ExtrasSection:
     def should_render(self, ctx: RenderContext) -> bool:
         return bool(ctx.makefile or ctx.pkg_json.get("scripts"))
 
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_extras(ctx.makefile, ctx.pkg_json)
+    render = call_with_ctx(_render_extras, "makefile", "pkg_json")
 
 
 assert isinstance(ExtrasSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/interfaces.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
 
 
 # ---------------------------------------------------------------------------
@@ -148,10 +149,9 @@ class InterfacesSection:
     def should_render(self, ctx: RenderContext) -> bool:
         return bool(ctx.scripts or ctx.openapi.get("endpoints") or ctx.scenarios)
 
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_interfaces(
-            ctx.scripts, ctx.openapi, ctx.scenarios, ctx.proj_dir, ctx.raw_sources
-        )
+    render = call_with_ctx(
+        _render_interfaces, "scripts", "openapi", "scenarios", "proj_dir", "raw_sources"
+    )
 
 
 assert isinstance(InterfacesSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/metadata.py

@@ -8,6 +8,7 @@ This serves as the reference implementation for all other sections.
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.should_render import always
 
 
 class MetadataSection:
@@ -17,8 +18,7 @@ class MetadataSection:
     level: int = 2
     profiles: frozenset[str] = frozenset({"minimal", "light", "rich"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return True  # Always render
+    should_render = always
 
     def render(self, ctx: RenderContext) -> list[str]:
         L: list[str] = []

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/quality.py

@@ -5,6 +5,8 @@ from __future__ import annotations
 from pathlib import Path
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
+from sumd.sections.utils.should_render import has_attr
 
 
 # ---------------------------------------------------------------------------
@@ -72,11 +74,8 @@ class QualitySection:
     level = 2
     profiles = frozenset({"light", "rich", "refactor"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return bool(ctx.pyqual)
-
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_quality(ctx.pyqual, ctx.proj_dir, ctx.raw_sources)
+    should_render = has_attr("pyqual")
+    render = call_with_ctx(_render_quality, "pyqual", "proj_dir", "raw_sources")
 
 
 assert isinstance(QualitySection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/refactor_analysis.py

@@ -17,6 +17,7 @@ Files that don't exist are silently skipped (non-blocking).
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.should_render import has_attr
 
 # Display order and labels for refactor analysis files.
 _REFACTOR_FILE_LABELS: dict[str, str] = {
@@ -36,8 +37,7 @@ class RefactorAnalysisSection:
     level = 2
     profiles = frozenset({"refactor"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return bool(ctx.project_analysis)
+    should_render = has_attr("project_analysis")
 
     def render(self, ctx: RenderContext) -> list[str]:
         L: list[str] = []

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/source_snippets.py

@@ -8,6 +8,8 @@ to read full source files.
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
+from sumd.sections.utils.should_render import has_attr
 
 
 # ---------------------------------------------------------------------------
@@ -59,11 +61,8 @@ class SourceSnippetsSection:
     level = 2
     profiles = frozenset({"rich"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return bool(ctx.source_snippets)
-
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_source_snippets(ctx.source_snippets)
+    should_render = has_attr("source_snippets")
+    render = call_with_ctx(_render_source_snippets, "source_snippets")
 
 
 assert isinstance(SourceSnippetsSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/swop.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
 
 
 def _render_swop_section(swop: dict, raw_sources: bool) -> list[str]:
@@ -61,8 +62,7 @@ class SwopSection:
     def should_render(self, ctx: RenderContext) -> bool:
         return bool(ctx.swop.get("contexts"))
 
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_swop_section(ctx.swop, ctx.raw_sources)
+    render = call_with_ctx(_render_swop_section, "swop", "raw_sources")
 
 
 assert isinstance(SwopSection(), Section)

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/test_contracts.py

@@ -7,6 +7,8 @@ LLM sees what the system guarantees without reading full scenario files.
 from __future__ import annotations
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
+from sumd.sections.utils.should_render import has_attr
 
 
 # ---------------------------------------------------------------------------
@@ -68,11 +70,8 @@ class TestContractsSection:
     level = 2
     profiles = frozenset({"rich"})
 
-    def should_render(self, ctx: RenderContext) -> bool:
-        return bool(ctx.scenarios)
-
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_test_contracts(ctx.scenarios)
+    should_render = has_attr("scenarios")
+    render = call_with_ctx(_render_test_contracts, "scenarios")
 
 
 assert isinstance(TestContractsSection(), Section)

sumd-0.3.45/sumd/sections/utils/__init__.py

@@ -0,0 +1,12 @@
+"""sumd.sections.utils — shared utilities for section renderers.
+
+Factories for common ``should_render`` and ``render`` patterns so section
+classes stay DRY.
+"""
+
+from __future__ import annotations
+
+from sumd.sections.utils.render import call_with_ctx
+from sumd.sections.utils.should_render import always, has_attr
+
+__all__ = ["always", "has_attr", "call_with_ctx"]

sumd-0.3.45/sumd/sections/utils/render.py

@@ -0,0 +1,25 @@
+"""Utility factory for common ``render`` patterns.
+
+Usage::
+
+    class MySection:
+        render = call_with_ctx(_render_my_section, "attr1", "attr2")
+"""
+
+from __future__ import annotations
+
+from typing import Callable
+
+from sumd.sections.base import RenderContext
+
+
+def call_with_ctx(render_fn: Callable, *attr_names: str):
+    """Return a ``render`` method that calls *render_fn* with ctx attributes.
+
+    The returned callable accepts ``(self, ctx)`` so it works when assigned
+    as a class attribute (Python binds ``self`` automatically).
+    """
+    def render(_self: object, ctx: RenderContext) -> list[str]:
+        args = [getattr(ctx, name) for name in attr_names]
+        return render_fn(*args)
+    return render

sumd-0.3.45/sumd/sections/utils/should_render.py

@@ -0,0 +1,25 @@
+"""Utility factories for common ``should_render`` patterns.
+
+Usage::
+
+    class MySection:
+        should_render = always
+        # or
+        should_render = has_attr("my_data")
+"""
+
+from __future__ import annotations
+
+from sumd.sections.base import RenderContext
+
+
+def always(_self: object, _ctx: RenderContext) -> bool:
+    """Always render the section."""
+    return True
+
+
+def has_attr(attr: str):
+    """Return a ``should_render`` that checks ``bool(ctx.<attr>)``."""
+    def should_render(_self: object, ctx: RenderContext) -> bool:
+        return bool(getattr(ctx, attr))
+    return should_render

{sumd-0.3.44 → sumd-0.3.45}/sumd/sections/workflows.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from sumd.sections.base import RenderContext, Section
+from sumd.sections.utils.render import call_with_ctx
 
 
 # ---------------------------------------------------------------------------
@@ -79,8 +80,7 @@ class WorkflowsSection:
     def should_render(self, ctx: RenderContext) -> bool:
         return bool(ctx.tasks or ctx.doql.get("workflows"))
 
-    def render(self, ctx: RenderContext) -> list[str]:
-        return _render_workflows(ctx.doql, ctx.tasks, ctx.proj_dir, ctx.raw_sources)
+    render = call_with_ctx(_render_workflows, "doql", "tasks", "proj_dir", "raw_sources")
 
 
 assert isinstance(WorkflowsSection(), Section)