sumd 0.3.35__tar.gz → 0.3.37__tar.gz

{sumd-0.3.35 → sumd-0.3.37}/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.37] - 2026-04-23
+
+### Docs
+- Update README.md
+
+### Other
+- Update sumd/extractor.py
+- Update sumd/pipeline.py
+- Update sumd/sections/__init__.py
+- Update sumd/sections/base.py
+- Update sumd/sections/swop.py
+- Update sumd/validator.py
+
+## [0.3.36] - 2026-04-23
+
+### Docs
+- Update README.md
+
 ## [0.3.35] - 2026-04-23
 
 ### Docs

{sumd-0.3.35 → sumd-0.3.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sumd
-Version: 0.3.35
+Version: 0.3.37
 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.35-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-21.9h-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.37-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-23.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (65 commits)
-- 👤 **Human dev:** ~$2193 (21.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (67 commits)
+- 👤 **Human dev:** ~$2387 (23.9h @ $100/h, 30min dedup)
 
 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.35-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.37-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.35 → sumd-0.3.37}/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.35-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-21.9h-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.37-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-23.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (65 commits)
-- 👤 **Human dev:** ~$2193 (21.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (67 commits)
+- 👤 **Human dev:** ~$2387 (23.9h @ $100/h, 30min dedup)
 
 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.35-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.37-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.35 → sumd-0.3.37}/pyproject.toml

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

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

{sumd-0.3.35 → sumd-0.3.37}/sumd/extractor.py

@@ -877,6 +877,58 @@ def extract_source_snippets(proj_dir: Path, pkg_name: str) -> list[dict]:
     return results
 
 
+def extract_swop(proj_dir: Path) -> dict[str, Any]:
+    """Extract SWOP manifest files from .swop/manifests/<context>/ directory.
+
+    Returns dict with structure:
+    {
+        "contexts": {
+            "<context_name>": {
+                "commands": {file, content},
+                "queries": {file, content},
+                "events": {file, content}
+            }
+        },
+        "sources": [list of file paths]
+    }
+    """
+    swop_dir = proj_dir / ".swop" / "manifests"
+    if not swop_dir.is_dir():
+        return {}
+
+    contexts: dict[str, dict[str, Any]] = {}
+    sources: list[str] = []
+
+    for context_dir in sorted(swop_dir.iterdir()):
+        if not context_dir.is_dir():
+            continue
+
+        context_name = context_dir.name
+        context_data: dict[str, dict[str, str]] = {}
+
+        for manifest_type in ("commands.yml", "queries.yml", "events.yml"):
+            manifest_path = context_dir / manifest_type
+            if manifest_path.exists():
+                rel_path = f".swop/manifests/{context_name}/{manifest_type}"
+                try:
+                    content = manifest_path.read_text(encoding="utf-8").rstrip()
+                    context_data[manifest_type.replace(".yml", "")] = {
+                        "file": rel_path,
+                        "content": content,
+                    }
+                    sources.append(rel_path)
+                except Exception:
+                    pass
+
+        if context_data:
+            contexts[context_name] = context_data
+
+    if not contexts:
+        return {}
+
+    return {"contexts": contexts, "sources": sources}
+
+
 def extract_project_analysis(
     proj_dir: Path, refactor: bool = False
 ) -> list[dict[str, str]]:

{sumd-0.3.35 → sumd-0.3.37}/sumd/pipeline.py

@@ -42,6 +42,7 @@ from sumd.extractor import (
     extract_readme_title,
     extract_requirements,
     extract_source_snippets,
+    extract_swop,
     extract_taskfile,
     generate_map_toon,
     required_tools_for_profile,
@@ -228,11 +229,15 @@ def _collect_sources(
     pkg_json: dict,
     modules: list,
     project_analysis: list,
+    swop: dict,
 ) -> list[str]:
     """Build the list of source labels that contributed data to this SUMD."""
-    return _collect_pkg_sources(
+    sources = _collect_pkg_sources(
         pyproj, reqs, tasks, makefile, scenarios, openapi, doql, pyqual, goal, env_vars
     ) + _collect_infra_sources(dockerfile, compose, pkg_json, modules, project_analysis)
+    if swop.get("sources"):
+        sources.extend(swop["sources"])
+    return sources
 
 
 def _inject_toc(content: str) -> str:
@@ -289,6 +294,7 @@ class RenderPipeline:
         dockerfile = extract_dockerfile(proj_dir)
         compose = extract_docker_compose(proj_dir)
         pkg_json = extract_package_json(proj_dir)
+        swop = extract_swop(proj_dir)
 
         # Auto-regenerate map.toon.yaml — pure-Python, always fast.
         _refresh_map_toon(proj_dir)
@@ -320,6 +326,7 @@ class RenderPipeline:
             pkg_json,
             modules,
             project_analysis,
+            swop,
         )
 
         return RenderContext(
@@ -348,6 +355,7 @@ class RenderPipeline:
             pkg_json=pkg_json,
             project_analysis=project_analysis,
             source_snippets=source_snippets,
+            swop=swop,
             raw_sources=self.raw_sources,
             sources_used=sources_used,
             title=title or name,

{sumd-0.3.35 → sumd-0.3.37}/sumd/sections/__init__.py

@@ -28,6 +28,7 @@ from sumd.sections.metadata import MetadataSection
 from sumd.sections.quality import QualitySection
 from sumd.sections.refactor_analysis import RefactorAnalysisSection
 from sumd.sections.source_snippets import SourceSnippetsSection
+from sumd.sections.swop import SwopSection
 from sumd.sections.test_contracts import TestContractsSection
 from sumd.sections.workflows import WorkflowsSection
 
@@ -36,6 +37,7 @@ from sumd.sections.workflows import WorkflowsSection
 SECTION_REGISTRY: list[type] = [
     MetadataSection,
     ArchitectureSection,
+    SwopSection,
     InterfacesSection,
     WorkflowsSection,
     QualitySection,
@@ -71,6 +73,7 @@ PROFILES: dict[str, set[str]] = {
     "rich": {
         "metadata",
         "architecture",
+        "swop",
         "interfaces",
         "workflows",
         "quality",

{sumd-0.3.35 → sumd-0.3.37}/sumd/sections/base.py

@@ -53,6 +53,7 @@ class RenderContext:
     pkg_json: dict = field(default_factory=dict)
     project_analysis: list = field(default_factory=list)
     source_snippets: list = field(default_factory=list)
+    swop: dict = field(default_factory=dict)
 
     # Rendering options
     raw_sources: bool = True

sumd-0.3.37/sumd/sections/swop.py

@@ -0,0 +1,68 @@
+"""sumd.sections.swop — SwopSection for SWOP manifest files."""
+
+from __future__ import annotations
+
+from sumd.sections.base import RenderContext, Section
+
+
+def _render_swop_section(swop: dict, raw_sources: bool) -> list[str]:
+    """Render SWOP manifest section."""
+    L: list[str] = []
+    a = L.append
+
+    if not swop.get("contexts"):
+        return L
+
+    contexts = swop["contexts"]
+    sources = swop.get("sources", [])
+
+    a("## SWOP")
+    a("")
+    a("SWOP - Bi-directional runtime reconciler and drift-aware state graph for full-stack systems.")
+    a("")
+
+    if raw_sources:
+        # Render raw YAML files
+        for context_name, context_data in sorted(contexts.items()):
+            a(f"### Context: `{context_name}`")
+            a("")
+
+            for manifest_type in ("commands", "queries", "events"):
+                if manifest_type in context_data:
+                    manifest = context_data[manifest_type]
+                    file_path = manifest["file"]
+                    content = manifest["content"]
+                    a(f"#### {manifest_type.capitalize()} (`{file_path}`)")
+                    a("")
+                    a(f"```yaml markpact:swop path={file_path}")
+                    a(content)
+                    a("```")
+                    a("")
+    else:
+        # Render parsed/structured view
+        for context_name, context_data in sorted(contexts.items()):
+            a(f"### Context: `{context_name}`")
+            a("")
+
+            for manifest_type in ("commands", "queries", "events"):
+                if manifest_type in context_data:
+                    file_path = context_data[manifest_type]["file"]
+                    a(f"- **{manifest_type.capitalize()}**: `{file_path}`")
+            a("")
+
+    return L
+
+
+class SwopSection:
+    name = "swop"
+    level = 2
+    profiles = frozenset({"rich"})
+
+    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)
+
+
+assert isinstance(SwopSection(), Section)

{sumd-0.3.35 → sumd-0.3.37}/sumd/validator.py

@@ -122,6 +122,7 @@ _VALID_MARKPACT_KINDS = {
     "taskfile",
     "pyqual",
     "analysis",
+    "swop",
 }
 _MARKPACT_REQUIRED_ATTRS = {
     "file": "path",
@@ -131,6 +132,7 @@ _MARKPACT_REQUIRED_ATTRS = {
     "taskfile": "path",
     "pyqual": "path",
     "analysis": "path",
+    "swop": "path",
 }