sumd 0.3.28__tar.gz → 0.3.30__tar.gz

{sumd-0.3.28 → sumd-0.3.30}/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.30] - 2026-04-23
+
+### Docs
+- Update README.md
+- Update SUMD.md
+- Update SUMR.md
+- Update docs/README.md
+- Update docs/USAGE.md
+- Update examples/SUMD.md
+- Update examples/SUMR.md
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update app.doql.less
+- Update examples/app.doql.less
+- Update examples/project/map.toon.yaml
+- Update project.sh
+- 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
+- ... and 13 more files
+
+## [0.3.29] - 2026-04-23
+
+### Docs
+- Update README.md
+
 ## [0.3.28] - 2026-04-23
 
 ### Docs

{sumd-0.3.28 → sumd-0.3.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sumd
-Version: 0.3.28
+Version: 0.3.30
 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
@@ -15,25 +15,25 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
-Requires-Dist: click>=8.0
-Requires-Dist: costs>=0.1.20
-Requires-Dist: goal>=2.1.0
-Requires-Dist: pfix>=0.1.60
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: toml>=0.10.0
+Requires-Dist: click>=8.3.3
+Requires-Dist: costs>=0.1.50
+Requires-Dist: goal>=2.1.190
+Requires-Dist: pfix>=0.1.72
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: toml>=0.10.2
 Provides-Extra: dev
-Requires-Dist: build; extra == 'dev'
-Requires-Dist: costs>=0.1.20; extra == 'dev'
-Requires-Dist: goal>=2.1.0; extra == 'dev'
-Requires-Dist: mcp>=1.0.0; extra == 'dev'
-Requires-Dist: pfix>=0.1.60; extra == 'dev'
-Requires-Dist: pyqual>=0.1; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff>=0.1; extra == 'dev'
-Requires-Dist: twine; extra == 'dev'
+Requires-Dist: build>=1.4.4; extra == 'dev'
+Requires-Dist: costs>=0.1.50; extra == 'dev'
+Requires-Dist: goal>=2.1.190; extra == 'dev'
+Requires-Dist: mcp>=1.27.0; extra == 'dev'
+Requires-Dist: pfix>=0.1.72; extra == 'dev'
+Requires-Dist: pyqual>=0.1.143; extra == 'dev'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
+Requires-Dist: pytest>=9.0.3; extra == 'dev'
+Requires-Dist: ruff>=0.15.11; extra == 'dev'
+Requires-Dist: twine>=6.2.0; extra == 'dev'
 Provides-Extra: mcp
-Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Requires-Dist: mcp>=1.27.0; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # SUMD
@@ -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.28-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.3.30-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-20.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (58 commits)
+- 🤖 **LLM usage:** $7.5000 (60 commits)
 - 👤 **Human dev:** ~$2071 (20.7h @ $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.28-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.30-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.
@@ -255,6 +255,17 @@ SUMD is part of a three-layer system:
 
 SUMD can refresh `app.doql.less` metadata and optionally trigger DOQL's cache-aware rebuild.
 
+### Generating DOQL from source
+
+For a rich, reverse-engineered `app.doql.less` (entities, interfaces, dependencies extracted from actual code), run `doql adopt` **before** `sumd`:
+
+```bash
+doql adopt . --format less --force   # generate/update app.doql.less from source
+sumd . --fix                         # consume it into SUMD.md
+```
+
+`sumd` alone generates only a minimal boilerplate. Use `doql` when you need a full declarative architecture extracted from the codebase.
+
 ### `app.doql.less` refresh behaviour
 
 When `sumd scan . --fix` runs (or the shorthand `sumd .`):

{sumd-0.3.28 → sumd-0.3.30}/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.28-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.3.30-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-20.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (58 commits)
+- 🤖 **LLM usage:** $7.5000 (60 commits)
 - 👤 **Human dev:** ~$2071 (20.7h @ $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.28-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.30-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.
@@ -217,6 +217,17 @@ SUMD is part of a three-layer system:
 
 SUMD can refresh `app.doql.less` metadata and optionally trigger DOQL's cache-aware rebuild.
 
+### Generating DOQL from source
+
+For a rich, reverse-engineered `app.doql.less` (entities, interfaces, dependencies extracted from actual code), run `doql adopt` **before** `sumd`:
+
+```bash
+doql adopt . --format less --force   # generate/update app.doql.less from source
+sumd . --fix                         # consume it into SUMD.md
+```
+
+`sumd` alone generates only a minimal boilerplate. Use `doql` when you need a full declarative architecture extracted from the codebase.
+
 ### `app.doql.less` refresh behaviour
 
 When `sumd scan . --fix` runs (or the shorthand `sumd .`):

{sumd-0.3.28 → sumd-0.3.30}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sumd"
-version = "0.3.28"
+version = "0.3.30"
 description = "SUMD - Structured Unified Markdown Descriptor for AI-aware project documentation"
 readme = "README.md"
 license = "Apache-2.0"
@@ -14,12 +14,12 @@ authors = [
 ]
 keywords = ["sumd", "markdown", "documentation", "llm", "project-descriptor"]
 dependencies = [
-    "click>=8.0",
-    "pyyaml>=6.0",
-    "toml>=0.10.0",
-    "goal>=2.1.0",
-    "costs>=0.1.20",
-    "pfix>=0.1.60",
+    "click>=8.3.3",
+    "pyyaml>=6.0.3",
+    "toml>=0.10.2",
+    "goal>=2.1.190",
+    "costs>=0.1.50",
+    "pfix>=0.1.72",
 ]
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -32,19 +32,19 @@ classifiers = [
 
 [project.optional-dependencies]
 mcp = [
-    "mcp>=1.0.0",
+    "mcp>=1.27.0",
 ]
 dev = [
-    "pytest>=7.0",
-    "pytest-cov>=4.0",
-    "ruff>=0.1",
-    "build",
-    "twine",
-    "pyqual>=0.1",
-    "goal>=2.1.0",
-    "costs>=0.1.20",
-    "pfix>=0.1.60",
-    "mcp>=1.0.0",
+    "pytest>=9.0.3",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.15.11",
+    "build>=1.4.4",
+    "twine>=6.2.0",
+    "pyqual>=0.1.143",
+    "goal>=2.1.190",
+    "costs>=0.1.50",
+    "pfix>=0.1.72",
+    "mcp>=1.27.0",
 ]
 
 [tool.pytest.ini_options]

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

{sumd-0.3.28 → sumd-0.3.30}/sumd/pipeline.py

@@ -46,10 +46,6 @@ from sumd.extractor import (
     generate_map_toon,
     required_tools_for_profile,
 )
-from sumd.renderer import (
-    _collect_sources,
-    _inject_toc,
-)
 from sumd.sections import PROFILES, SECTION_REGISTRY
 from sumd.sections.base import RenderContext
 from sumd.toon_parser import extract_testql_scenarios
@@ -138,6 +134,126 @@ def _refresh_analysis_files(proj_dir: Path, profile: str) -> None:
         pass  # non-fatal
 
 
+# ---------------------------------------------------------------------------
+# Source collection helpers (moved from renderer.py)
+# ---------------------------------------------------------------------------
+
+
+def _collect_tool_sources(
+    pyproj: dict, reqs: list, tasks: list, makefile: list, scenarios: list
+) -> list[str]:
+    """Collect source labels for file-based tool inputs."""
+    sources: list[str] = []
+    if pyproj:
+        sources.append("pyproject.toml")
+    if reqs:
+        sources.extend(r["file"] for r in reqs)
+    if tasks:
+        sources.append("Taskfile.yml")
+    if makefile:
+        sources.append("Makefile")
+    if scenarios:
+        sources.append(f"testql({len(scenarios)})")
+    return sources
+
+
+def _doql_sources(doql: dict) -> list[str]:
+    """Return doql source labels if any doql content is present."""
+    if doql.get("app") or doql.get("workflows") or doql.get("entities"):
+        return doql.get("sources", ["app.doql.less"])
+    return []
+
+
+def _collect_pkg_sources(
+    pyproj: dict,
+    reqs: list,
+    tasks: list,
+    makefile: list,
+    scenarios: list,
+    openapi: dict,
+    doql: dict,
+    pyqual: dict,
+    goal: dict,
+    env_vars: list,
+) -> list[str]:
+    """Collect source labels for code/pipeline sources."""
+    sources = _collect_tool_sources(pyproj, reqs, tasks, makefile, scenarios)
+    if openapi.get("endpoints"):
+        sources.append(f"openapi({len(openapi['endpoints'])} ep)")
+    sources.extend(_doql_sources(doql))
+    if pyqual.get("stages"):
+        sources.append("pyqual.yaml")
+    if goal.get("name"):
+        sources.append("goal.yaml")
+    if env_vars:
+        sources.append(".env.example")
+    return sources
+
+
+def _collect_infra_sources(
+    dockerfile: dict,
+    compose: dict,
+    pkg_json: dict,
+    modules: list,
+    project_analysis: list,
+) -> list[str]:
+    """Collect source labels for infra/module sources."""
+    sources: list[str] = []
+    if dockerfile:
+        sources.append("Dockerfile")
+    if compose.get("services"):
+        sources.append(compose.get("file", "docker-compose.yml"))
+    if pkg_json.get("name"):
+        sources.append("package.json")
+    if modules:
+        sources.append(f"src({len(modules)} mod)")
+    if project_analysis:
+        sources.append(f"project/({len(project_analysis)} analysis files)")
+    return sources
+
+
+def _collect_sources(
+    pyproj: dict,
+    reqs: list,
+    tasks: list,
+    makefile: list,
+    scenarios: list,
+    openapi: dict,
+    doql: dict,
+    pyqual: dict,
+    goal: dict,
+    env_vars: list,
+    dockerfile: dict,
+    compose: dict,
+    pkg_json: dict,
+    modules: list,
+    project_analysis: list,
+) -> list[str]:
+    """Build the list of source labels that contributed data to this SUMD."""
+    return _collect_pkg_sources(
+        pyproj, reqs, tasks, makefile, scenarios, openapi, doql, pyqual, goal, env_vars
+    ) + _collect_infra_sources(dockerfile, compose, pkg_json, modules, project_analysis)
+
+
+def _inject_toc(content: str) -> str:
+    """Inject a ## Contents TOC block before ## Metadata."""
+    import re
+
+    h2_sections = re.findall(r"^## (.+)$", content, re.MULTILINE)
+    if not h2_sections:
+        return content
+    toc_lines = ["## Contents", ""]
+    for sec in h2_sections:
+        anchor = re.sub(r"[^\w\s-]", "", sec.lower()).strip()
+        anchor = re.sub(r"\s+", "-", anchor)
+        toc_lines.append(f"- [{sec}](#{anchor})")
+    toc_lines.append("")
+    toc_block = "\n".join(toc_lines)
+    return re.sub(
+        r"(\n## Metadata\n)", f"\n{toc_block}\n## Metadata\n", content, count=1
+    )
+
+
 class RenderPipeline:
     """Collect project data → build sections → render → inject TOC.
 

sumd-0.3.30/sumd/sections/architecture.py

@@ -0,0 +1,156 @@
+"""sumd.sections.architecture — ArchitectureSection."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from sumd.sections.base import RenderContext, Section
+
+
+# ---------------------------------------------------------------------------
+# Private renderers (moved from renderer.py)
+# ---------------------------------------------------------------------------
+
+
+def _render_architecture_doql_section(
+    doql: dict, proj_dir: Path, raw_sources: bool, L: list[str]
+) -> None:
+    a = L.append
+    doql_sources = ", ".join(f"`{s}`" for s in doql.get("sources", ["app.doql.less"]))
+    a(f"### DOQL Application Declaration ({doql_sources})")
+    a("")
+    if raw_sources:
+        for fname in doql.get("sources", ["app.doql.less"]):
+            fpath = proj_dir / fname
+            if fpath.exists():
+                lang = "less" if fname.endswith(".less") else "css"
+                a(f"```{lang} markpact:doql path={fname}")
+                a(fpath.read_text(encoding="utf-8").rstrip())
+                a("```")
+                a("")
+    else:
+        _render_architecture_doql_parsed(doql, L)
+
+
+def _render_architecture_modules(modules: list[str], name: str, L: list[str]) -> None:
+    a = L.append
+    a("### Source Modules")
+    a("")
+    for mod in modules:
+        a(f"- `{name}.{mod}`")
+    a("")
+
+
+def _render_doql_app(doql: dict, L: list[str]) -> None:
+    if not doql.get("app"):
+        return
+    a = L.append
+    a("```less")
+    a("app {")
+    for k, v in doql["app"].items():
+        a(f"  {k}: {v};")
+    a("}")
+    a("```")
+    a("")
+
+
+def _render_doql_entities(doql: dict, L: list[str]) -> None:
+    if not doql.get("entities"):
+        return
+    a = L.append
+    a("### DOQL Data Model (`entity`)")
+    a("")
+    for ent in doql["entities"]:
+        attrs_str = ""
+        if ent.get("attrs"):
+            attrs_str = " — " + ", ".join(
+                f"`{k}: {v}`" for k, v in ent["attrs"].items()
+            )
+        page_str = f" page=`{ent['page']}`" if ent.get("page") else ""
+        a(f"- `entity[{ent['name']}]`{page_str}{attrs_str}")
+    a("")
+
+
+def _render_doql_interfaces(doql: dict, L: list[str]) -> None:
+    if not doql.get("interfaces"):
+        return
+    a = L.append
+    a("### DOQL Interfaces")
+    a("")
+    for iface in list(doql["interfaces"]):
+        sel = iface.get("selector", "")
+        attrs = ", ".join(
+            f"{k}: {v}" for k, v in iface.items() if k not in ("selector", "page")
+        )
+        page_str = f" page=`{iface['page']}`" if iface.get("page") else ""
+        a(f"- `interface[{sel}]`{page_str} — {attrs}")
+    a("")
+
+
+def _render_doql_integrations(doql: dict, L: list[str]) -> None:
+    if not doql.get("integrations"):
+        return
+    a = L.append
+    a("### DOQL Integrations")
+    a("")
+    for intg in list(doql["integrations"]):
+        sel = intg.get("selector", "")
+        attrs = ", ".join(f"{k}: {v}" for k, v in intg.items() if k != "selector")
+        a(f"- `integration[{sel}]` — {attrs}")
+    a("")
+
+
+def _render_architecture_doql_parsed(doql: dict, L: list[str]) -> None:
+    """Render parsed DOQL blocks into L (mutates in place)."""
+    _render_doql_app(doql, L)
+    _render_doql_entities(doql, L)
+    _render_doql_interfaces(doql, L)
+    _render_doql_integrations(doql, L)
+
+
+def _render_architecture(
+    doql: dict, modules: list[str], name: str, proj_dir: Path, raw_sources: bool
+) -> list[str]:
+    L: list[str] = []
+    a = L.append
+    a("## Architecture")
+    a("")
+    a("```")
+    a(
+        "SUMD (description) → DOQL/source (code) → taskfile (automation) → testql (verification)"
+    )
+    a("```")
+    a("")
+    if (
+        doql.get("app")
+        or doql.get("entities")
+        or doql.get("interfaces")
+        or doql.get("workflows")
+    ):
+        _render_architecture_doql_section(doql, proj_dir, raw_sources, L)
+    if modules:
+        _render_architecture_modules(modules, name, L)
+    return L
+
+
+# ---------------------------------------------------------------------------
+# Section class
+# ---------------------------------------------------------------------------
+
+
+class ArchitectureSection:
+    name = "architecture"
+    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
+        )
+
+
+assert isinstance(ArchitectureSection(), Section)
+

sumd-0.3.30/sumd/sections/interfaces.py

@@ -0,0 +1,157 @@
+"""sumd.sections.interfaces — InterfacesSection."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from sumd.sections.base import RenderContext, Section
+
+
+# ---------------------------------------------------------------------------
+# Private renderers (moved from renderer.py)
+# ---------------------------------------------------------------------------
+
+
+def _render_interfaces_openapi(
+    openapi: dict, proj_dir: Path, raw_sources: bool, L: list[str]
+) -> None:
+    """Render REST API section into L (mutates in place)."""
+    a = L.append
+    a("### REST API (from `openapi.yaml`)")
+    a("")
+    if raw_sources:
+        op_path = proj_dir / "openapi.yaml"
+        if op_path.exists():
+            a("```yaml markpact:openapi path=openapi.yaml")
+            a(op_path.read_text(encoding="utf-8").rstrip())
+            a("```")
+            a("")
+    else:
+        a("| Method | Path | OperationId | Summary |")
+        a("|--------|------|-------------|---------|")
+        for ep in openapi["endpoints"]:
+            summary = ep.get("summary", "").replace("|", "\\|")
+            a(
+                f"| `{ep['method']}` | `{ep['path']}` | `{ep['operationId']}` | {summary} |"
+            )
+        a("")
+        if openapi.get("schemas"):
+            a("**Schemas**: " + ", ".join(f"`{s}`" for s in openapi["schemas"]))
+            a("")
+
+
+def _render_testql_raw(scenarios: list, proj_dir: Path, L: list[str]) -> None:
+    a = L.append
+    seen_scenario_files: set[str] = set()
+    for sc in scenarios:
+        rel = sc.get("rel_path", sc["file"])
+        fpath = proj_dir / rel
+        if not fpath.exists() or rel in seen_scenario_files:
+            continue
+        seen_scenario_files.add(rel)
+        a(f"#### `{rel}`")
+        a("")
+        a(f"```toon markpact:testql path={rel}")
+        a(fpath.read_text(encoding="utf-8").rstrip())
+        a("```")
+        a("")
+
+
+def _render_testql_endpoint(ep: dict, L: list[str]) -> None:
+    """Render one endpoint line for a testql scenario."""
+    op = f" — `{ep['operationId']}`" if ep.get("operationId") else ""
+    sm = f": {ep['summary']}" if ep.get("summary") else ""
+    L.append(f"  - `{ep['method']} {ep['path']}` → `{ep['status']}`{op}{sm}")
+
+
+def _render_testql_extras(sc: dict, L: list[str]) -> None:
+    """Render performance / navigate / gui blocks for a testql scenario."""
+    a = L.append
+    if sc.get("performance"):
+        a("- **performance**:")
+        for p in sc["performance"]:
+            a(f"  - `{p['metric']} < {p['threshold']}`")
+    if sc.get("navigate"):
+        a("- **navigate**: " + ", ".join(f"`{u}`" for u in sc["navigate"]))
+    if sc.get("gui"):
+        a("- **gui actions**:")
+        for g in sc["gui"]:
+            a(f"  - `{g['action']} {g['selector']}`")
+
+
+def _render_testql_one_structured(sc: dict, L: list[str]) -> None:
+    a = L.append
+    a(f"#### `{sc['file']}`")
+    a("")
+    a(f"- **name**: {sc['name']}")
+    a(f"- **type**: `{sc['type']}`")
+    if sc["detectors"]:
+        a(f"- **detectors**: {sc['detectors']}")
+    for k, v in sc["config"].items():
+        a(f"- **{k}**: `{v}`")
+    if sc["endpoints"]:
+        a("- **endpoints**:")
+        for ep in sc["endpoints"]:
+            _render_testql_endpoint(ep, L)
+    if sc["asserts"]:
+        a("- **asserts**:")
+        for ass in sc["asserts"]:
+            a(f"  - `{ass['field']} {ass['op']} {ass['expected']}`")
+    _render_testql_extras(sc, L)
+    a("")
+
+
+def _render_interfaces_testql(
+    scenarios: list, proj_dir: Path, raw_sources: bool, L: list[str]
+) -> None:
+    """Render testql scenarios section into L (mutates in place)."""
+    a = L.append
+    a("### testql Scenarios")
+    a("")
+    if raw_sources:
+        _render_testql_raw(scenarios, proj_dir, L)
+    else:
+        for sc in scenarios:
+            _render_testql_one_structured(sc, L)
+
+
+def _render_interfaces(
+    scripts: list, openapi: dict, scenarios: list, proj_dir: Path, raw_sources: bool
+) -> list[str]:
+    L: list[str] = []
+    a = L.append
+    a("## Interfaces")
+    a("")
+    if scripts:
+        a("### CLI Entry Points")
+        a("")
+        for s in scripts:
+            a(f"- `{s}`")
+        a("")
+    if openapi.get("endpoints"):
+        _render_interfaces_openapi(openapi, proj_dir, raw_sources, L)
+    if scenarios:
+        _render_interfaces_testql(scenarios, proj_dir, raw_sources, L)
+    return L
+
+
+# ---------------------------------------------------------------------------
+# Section class
+# ---------------------------------------------------------------------------
+
+
+class InterfacesSection:
+    name = "interfaces"
+    level = 2
+    profiles = frozenset({"light", "rich"})
+
+    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
+        )
+
+
+assert isinstance(InterfacesSection(), Section)

sumd-0.3.28/sumd/sections/architecture.py

@@ -1,23 +0,0 @@
-"""sumd.sections.architecture — ArchitectureSection."""
-
-from __future__ import annotations
-
-from sumd.renderer import _render_architecture
-from sumd.sections.base import RenderContext, Section
-
-
-class ArchitectureSection:
-    name = "architecture"
-    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
-        )
-
-
-assert isinstance(ArchitectureSection(), Section)

sumd-0.3.28/sumd/sections/interfaces.py

@@ -1,23 +0,0 @@
-"""sumd.sections.interfaces — InterfacesSection."""
-
-from __future__ import annotations
-
-from sumd.renderer import _render_interfaces
-from sumd.sections.base import RenderContext, Section
-
-
-class InterfacesSection:
-    name = "interfaces"
-    level = 2
-    profiles = frozenset({"light", "rich"})
-
-    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
-        )
-
-
-assert isinstance(InterfacesSection(), Section)