codd-dev 3.25.0__tar.gz → 3.26.0__tar.gz

{codd_dev-3.25.0 → codd_dev-3.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codd-dev
-Version: 3.25.0
+Version: 3.26.0
 Summary: CoDD: Coherence-Driven Development — cross-artifact change impact analysis
 Project-URL: Homepage, https://github.com/yohey-w/codd-dev
 Project-URL: Repository, https://github.com/yohey-w/codd-dev

{codd_dev-3.25.0 → codd_dev-3.26.0}/codd/__init__.py

@@ -1,3 +1,3 @@
 """CoDD — Coherence-Driven Development."""
 
-__version__ = "3.25.0"
+__version__ = "3.26.0"

codd_dev-3.26.0/codd/json_safe.py

@@ -0,0 +1,32 @@
+"""Shared JSON serialization defaults for CoDD.
+
+Design-doc frontmatter and impact/event payloads can carry values the stdlib
+``json`` encoder rejects — most commonly a bare ``date: 2026-05-29`` which PyYAML
+parses to a :class:`datetime.date` (issue #28). Every ``json.dumps`` that may
+serialize frontmatter-derived or impact/event data must pass
+``default=json_default`` so serialization never raises.
+"""
+
+from __future__ import annotations
+
+import json
+from datetime import date, datetime
+from typing import Any
+
+
+def json_default(obj: Any) -> Any:
+    """Fallback for ``json.dumps(default=...)``.
+
+    Coerce date/datetime to ISO 8601 and any other non-serializable value to its
+    string form so serialization never raises. Generic by design: not tied to any
+    field name, project, or code path.
+    """
+    if isinstance(obj, (date, datetime)):
+        return obj.isoformat()
+    return str(obj)
+
+
+def dumps(obj: Any, **kwargs: Any) -> str:
+    """``json.dumps`` with :func:`json_default` pre-wired (override via kwargs)."""
+    kwargs.setdefault("default", json_default)
+    return json.dumps(obj, **kwargs)

{codd_dev-3.25.0 → codd_dev-3.26.0}/codd/scanner.py

@@ -14,7 +14,7 @@ from typing import Any
 import yaml
 
 from codd.discovery import scan_exclude_patterns
-from codd.frontmatter import read_frontmatter
+from codd.frontmatter import as_list, read_frontmatter
 from codd.graph import CEG
 from codd.parsing import get_extractor
 from codd.path_safety import require_project_path, resolve_project_path
@@ -344,8 +344,14 @@ def _load_frontmatter(ceg: CEG, doc_path: str, codd: dict):
     node_type = codd.get("type", "document")
     ceg.upsert_node(node_id, node_type, path=doc_path, name=node_id)
 
-    # Process depends_on (outgoing edges from this document)
-    for dep in codd.get("depends_on", []):
+    # Process depends_on (outgoing edges from this document).
+    # ``as_list`` normalizes null-vs-missing: a bare ``depends_on:`` key parses
+    # to None, which would raise TypeError on iteration (issue #33). Non-dict
+    # entries are malformed shape (the validator reports them); skip them here so
+    # a scan never crashes on hand-authored frontmatter.
+    for dep in as_list(codd.get("depends_on")):
+        if not isinstance(dep, dict):
+            continue
         target_id = dep.get("id")
         if not target_id:
             continue
@@ -357,8 +363,11 @@ def _load_frontmatter(ceg: CEG, doc_path: str, codd: dict):
         ceg.add_evidence(edge_id, "frontmatter", "frontmatter", 0.9,
                          detail=f"from {doc_path}")
 
-    # Process depended_by (incoming edges — other things that depend on this)
-    for dep in codd.get("depended_by", []):
+    # Process depended_by (incoming edges — other things that depend on this).
+    # Same null-vs-missing normalization + malformed-shape skip as depends_on.
+    for dep in as_list(codd.get("depended_by")):
+        if not isinstance(dep, dict):
+            continue
         source_id = dep.get("id")
         if not source_id:
             continue

{codd_dev-3.25.0 → codd_dev-3.26.0}/codd/watch/propagation_log.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import json
 from pathlib import Path
 
+from codd.json_safe import json_default
 from codd.watch.events import FileChangeEvent
 
 PROPAGATION_LOG_PATH = ".codd/propagation_log.jsonl"
@@ -26,7 +27,9 @@ def append_propagation_log(
 
     with log_path.open("w", encoding="utf-8") as handle:
         for item in entries:
-            handle.write(json.dumps(item, ensure_ascii=False) + "\n")
+            # default=json_default: a propagated design doc's `date:` frontmatter
+            # parses to datetime.date, which raw json.dumps rejects (issue #28).
+            handle.write(json.dumps(item, ensure_ascii=False, default=json_default) + "\n")
 
 
 def read_propagation_log(project_root: Path) -> list[dict]:

{codd_dev-3.25.0 → codd_dev-3.26.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codd-dev"
-version = "3.25.0"
+version = "3.26.0"
 description = "CoDD: Coherence-Driven Development — cross-artifact change impact analysis"
 readme = "README.md"
 license = "MIT"