codd-dev 1.22.0__tar.gz → 1.24.0__tar.gz

{codd_dev-1.22.0 → codd_dev-1.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codd-dev
-Version: 1.22.0
+Version: 1.24.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
@@ -19,6 +19,7 @@ Requires-Dist: click>=8.0
 Requires-Dist: jinja2>=3.1.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: tomli>=2.0.1; python_version < '3.11'
+Requires-Dist: watchdog>=4.0.0
 Provides-Extra: ai
 Provides-Extra: api-parsers
 Requires-Dist: graphql-core>=3.2.0; extra == 'api-parsers'
@@ -950,23 +951,49 @@ You:  yes
 
 ### Hook Integration — Set It Once, Never Think Again
 
-Add this hook and **you never run `codd scan` manually again.** Every file edit triggers it automatically — the dependency graph is always current, always accurate, zero mental overhead:
+CoDD ships copyable hook recipes in `codd/hooks/recipes/` so Claude, Codex, and Git can all trigger the same change-driven propagation path:
+`codd propagate-from --files <changed-file>`.
+
+#### Claude PostToolUse
+
+Use `codd/hooks/recipes/claude_settings_example.json` as the starting point for `.claude/settings.json`. It listens for Edit / Write / MultiEdit and extracts changed files from `TOOL_INPUT` before calling `propagate-from`.
 
 ```json
 {
   "hooks": {
     "PostToolUse": [{
-      "matcher": "Edit|Write",
+      "matcher": "Edit|Write|MultiEdit",
       "hooks": [{
         "type": "command",
-        "command": "codd scan --path ."
+        "command": "python -m codd propagate-from --files <changed-file> --source editor_hook --editor claude"
       }]
     }]
   }
 }
 ```
 
-With hooks active, your entire workflow becomes: **edit files normally, then run `/codd-impact` when you want to know what's affected.** That's it. The graph maintenance is invisible.
+#### Codex Post-Edit
+
+Use `codd/hooks/recipes/codex_hook.sh` when your Codex wrapper can pass edited files through `CODEX_EDITED_FILES`:
+
+```bash
+export CODEX_EDITED_FILES="src/app.ts,docs/design/api.md"
+bash codd/hooks/recipes/codex_hook.sh
+```
+
+#### Git Hooks
+
+Use the git recipes as a final catch for manual edits and non-editor workflows:
+
+```bash
+cp codd/hooks/recipes/git_pre_commit.sh .git/hooks/pre-commit
+cp codd/hooks/recipes/git_post_commit.sh .git/hooks/post-commit
+chmod +x .git/hooks/pre-commit .git/hooks/post-commit
+```
+
+The pre-commit hook runs `propagate-from` in `--dry-run` mode against staged files. The post-commit hook runs propagation against the committed file set.
+
+With hooks active, your entire workflow becomes: **edit files normally, and CoDD propagates the change from the files that actually changed.** The graph maintenance is invisible.
 
 ### Available Skills
 

{codd_dev-1.22.0 → codd_dev-1.24.0}/README.md

@@ -912,23 +912,49 @@ You:  yes
 
 ### Hook Integration — Set It Once, Never Think Again
 
-Add this hook and **you never run `codd scan` manually again.** Every file edit triggers it automatically — the dependency graph is always current, always accurate, zero mental overhead:
+CoDD ships copyable hook recipes in `codd/hooks/recipes/` so Claude, Codex, and Git can all trigger the same change-driven propagation path:
+`codd propagate-from --files <changed-file>`.
+
+#### Claude PostToolUse
+
+Use `codd/hooks/recipes/claude_settings_example.json` as the starting point for `.claude/settings.json`. It listens for Edit / Write / MultiEdit and extracts changed files from `TOOL_INPUT` before calling `propagate-from`.
 
 ```json
 {
   "hooks": {
     "PostToolUse": [{
-      "matcher": "Edit|Write",
+      "matcher": "Edit|Write|MultiEdit",
       "hooks": [{
         "type": "command",
-        "command": "codd scan --path ."
+        "command": "python -m codd propagate-from --files <changed-file> --source editor_hook --editor claude"
       }]
     }]
   }
 }
 ```
 
-With hooks active, your entire workflow becomes: **edit files normally, then run `/codd-impact` when you want to know what's affected.** That's it. The graph maintenance is invisible.
+#### Codex Post-Edit
+
+Use `codd/hooks/recipes/codex_hook.sh` when your Codex wrapper can pass edited files through `CODEX_EDITED_FILES`:
+
+```bash
+export CODEX_EDITED_FILES="src/app.ts,docs/design/api.md"
+bash codd/hooks/recipes/codex_hook.sh
+```
+
+#### Git Hooks
+
+Use the git recipes as a final catch for manual edits and non-editor workflows:
+
+```bash
+cp codd/hooks/recipes/git_pre_commit.sh .git/hooks/pre-commit
+cp codd/hooks/recipes/git_post_commit.sh .git/hooks/post-commit
+chmod +x .git/hooks/pre-commit .git/hooks/post-commit
+```
+
+The pre-commit hook runs `propagate-from` in `--dry-run` mode against staged files. The post-commit hook runs propagation against the committed file set.
+
+With hooks active, your entire workflow becomes: **edit files normally, and CoDD propagates the change from the files that actually changed.** The graph maintenance is invisible.
 
 ### Available Skills
 

{codd_dev-1.22.0 → codd_dev-1.24.0}/codd/__init__.py

@@ -1,3 +1,3 @@
 """CoDD — Coherence-Driven Development."""
 
-__version__ = "1.22.0"
+__version__ = "1.24.0"

{codd_dev-1.22.0 → codd_dev-1.24.0}/codd/cli.py

@@ -344,23 +344,65 @@ def scan(path: str):
     run_scan(project_root, codd_dir)
 
 
-@main.command()
-@click.option("--diff", default="HEAD", help="Git diff target (default: HEAD, shows uncommitted changes)")
-@click.option("--path", default=".", help="Project root directory")
-@click.option("--output", default=None, help="Output file (default: stdout)")
-def impact(diff: str, path: str, output: str):
+@main.command()
+@click.option("--diff", default="HEAD", help="Git diff target (default: HEAD, shows uncommitted changes)")
+@click.option("--path", default=".", help="Project root directory")
+@click.option("--output", default=None, help="Output file (default: stdout)")
+def impact(diff: str, path: str, output: str):
     """Analyze change impact from git diff."""
     from codd.propagate import run_impact
     project_root = Path(path).resolve()
     codd_dir = _require_codd_dir(project_root)
-
-    run_impact(project_root, codd_dir, diff, output)
-
-
-@main.command()
-@click.option("--wave", required=True, type=click.IntRange(min=1), help="Wave number to generate")
-@click.option("--path", default=".", help="Project root directory")
-@click.option("--force", is_flag=True, help="Overwrite existing files")
+
+    run_impact(project_root, codd_dir, diff, output)
+
+
+@main.command("watch")
+@click.option("--project-path", "--path", default=".", show_default=True, help="Project root directory")
+@click.option("--debounce", default=500, show_default=True, type=int, help="Debounce interval in milliseconds")
+@click.option("--background", is_flag=True, default=False, help="Run watcher in background mode")
+@click.option("--status", is_flag=True, default=False, help="Show watcher status")
+def watch_cmd(project_path: str, debounce: int, background: bool, status: bool) -> None:
+    """Watch for file changes and emit CDAP file-change events."""
+    project_root = Path(project_path).resolve()
+    pid_file = project_root / ".codd" / "watch.pid"
+
+    if status:
+        if pid_file.exists():
+            click.echo(f"Watcher running (PID: {pid_file.read_text(encoding='utf-8').strip()})")
+        else:
+            click.echo("Watcher not running")
+        return
+
+    from codd.watch.events import FileChangeEvent
+    from codd.watch.watcher import start_watch
+
+    if not project_root.exists():
+        click.echo(f"Error: Project path does not exist: {project_root}")
+        raise SystemExit(1)
+    if not project_root.is_dir():
+        click.echo(f"Error: Project path is not a directory: {project_root}")
+        raise SystemExit(1)
+
+    pid_file.parent.mkdir(parents=True, exist_ok=True)
+    pid_file.write_text(f"{os.getpid()}\n", encoding="utf-8")
+
+    def on_change(event: FileChangeEvent) -> None:
+        preview = ", ".join(event.files[:3])
+        suffix = "" if len(event.files) <= 3 else f", ... {len(event.files) - 3} more"
+        click.echo(f"[watch] {len(event.files)} file(s) changed: {preview}{suffix}")
+
+    click.echo(f"Watching {project_root} (debounce={debounce}ms)")
+    observer = start_watch(project_root, on_change, debounce_ms=debounce, background=background)
+    if background:
+        click.echo(f"Watcher running in background mode (PID: {os.getpid()})")
+        observer.join(timeout=0)
+
+
+@main.command()
+@click.option("--wave", required=True, type=click.IntRange(min=1), help="Wave number to generate")
+@click.option("--path", default=".", help="Project root directory")
+@click.option("--force", is_flag=True, help="Overwrite existing files")
 @click.option(
     "--ai-cmd",
     default=None,
@@ -852,11 +894,47 @@ def propagate(diff: str, path: str, update: bool, verify: bool, do_commit: bool,
         click.echo(f"  [{status}] {doc.path} ({doc.node_id})")
         click.echo(f"    modules: {', '.join(doc.matched_modules)}")
 
-    if not update and result.affected_docs:
-        click.echo(f"\nRun with --update to update these docs via AI.")
-
-
-@main.command()
+    if not update and result.affected_docs:
+        click.echo(f"\nRun with --update to update these docs via AI.")
+
+
+@main.command("propagate-from")
+@click.option("--project-path", default=".", show_default=True, help="Project root directory")
+@click.option("--files", multiple=True, required=True, help="Changed file path. Can be repeated.")
+@click.option(
+    "--source",
+    default="manual",
+    show_default=True,
+    type=click.Choice(["watch", "git_hook", "editor_hook", "manual"]),
+    help="Change source that triggered propagation.",
+)
+@click.option(
+    "--editor",
+    default=None,
+    type=click.Choice(["claude", "codex", "manual"]),
+    help="Editor that produced the change, when known.",
+)
+@click.option("--dry-run", is_flag=True, default=False, help="Compute impact without propagate/fix/log writes.")
+def propagate_from(project_path: str, files: tuple[str, ...], source: str, editor: str | None, dry_run: bool):
+    """Run the CDAP propagation pipeline from changed files."""
+    from codd.watch.events import FileChangeEvent
+    from codd.watch.propagation_pipeline import run_propagation_pipeline
+
+    project_root = Path(project_path).resolve()
+    event = FileChangeEvent(files=list(files), source=source, editor=editor)
+    result = run_propagation_pipeline(project_root, list(files), dry_run=dry_run, event=event)
+
+    click.echo(f"Impacted nodes: {len(result.impacted_nodes)}")
+    click.echo(f"Propagated: {result.propagated_count}")
+    click.echo(f"Fixed: {result.fixed_count}")
+    if result.errors:
+        click.echo(f"Errors: {result.errors}", err=True)
+
+    if not result.success:
+        raise SystemExit(1)
+
+
+@main.command()
 @click.option("--path", default=".", help="Project root directory")
 @click.option("--task", default=None, help="Generate only one task by task ID or title match")
 @click.option("--clean", is_flag=True, default=False, help="Remove existing generated output before re-generating")
@@ -2183,6 +2261,28 @@ def mcp_server(project: str):
     run_stdio(project_root)
 
 
+@main.command("test")
+@click.option("--project-path", "--path", default=".", show_default=True, help="Project root directory")
+@click.option("--related", multiple=True, help="Run only tests related to these files")
+@click.option("--dry-run", is_flag=True, default=False, help="Print the related test command without running it")
+def test_cmd(project_path: str, related: tuple[str, ...], dry_run: bool):
+    """Run tests. Use --related <file> to run only related tests."""
+    from codd.watch.test_runner import run_related_tests
+
+    project_root = Path(project_path).resolve()
+    if not related:
+        click.echo("Use --related <file> to specify files. Full test run not supported via this command.")
+        return
+
+    result = run_related_tests(project_root, list(related), dry_run=dry_run)
+    click.echo(f"Related tests: {result['related']}")
+    if result.get("cmd"):
+        click.echo(f"Command: {result['cmd']}")
+    click.echo(f"Status: {result['status']}")
+    if result.get("exit_code") not in (None, 0):
+        raise SystemExit(1)
+
+
 @main.group()
 def dag():
     """DAG Completeness Gate commands."""

{codd_dev-1.22.0 → codd_dev-1.24.0}/codd/coherence_engine.py

@@ -80,7 +80,6 @@ def set_coherence_bus(bus: EventBus | None) -> None:
     """Set the opt-in coherence bus on detectors that publish DriftEvents."""
     for module_name in (
         "codd.drift",
-        "codd.drift_linkers.api",
         "codd.deployer",
         "codd.hitl_session",
         "codd.validator",

{codd_dev-1.22.0 → codd_dev-1.24.0}/codd/coverage_metrics.py

@@ -134,7 +134,7 @@ def compute_screen_flow_coverage(
     config: dict[str, Any],
     threshold: float = 100.0,
 ) -> CoverageResult:
-    """Measure screen-flow drift as a coverage gate metric."""
+    """Measure screen-flow route drift as a coverage gate metric."""
 
     try:
         from codd.cli import CoddCLIError
@@ -153,25 +153,9 @@ def compute_screen_flow_coverage(
             details=[f"error: {exc}"],
         )
 
-    design_drift_details: list[str] = []
-    design_drift_count = 0
-    try:
-        from codd.drift_linkers.screen_flow import ScreenFlowGate
-
-        gate_result = ScreenFlowGate(
-            project_root=project_root,
-            settings={**config, "apply": True},
-        ).run()
-        if not gate_result.skipped:
-            design_drift_count = gate_result.drift_count
-            design_drift_details = gate_result.details
-    except Exception as exc:  # pragma: no cover - defensive gate behavior
-        return _exception_result("screen_flow_coverage", threshold, exc)
-
-    drift_count = len(drifts) + design_drift_count
+    drift_count = len(drifts)
     pct = 100.0 if drift_count == 0 else max(0.0, 100.0 - drift_count * 10.0)
     details = [f"drift_count: {drift_count}"]
-    details.extend(design_drift_details)
     return CoverageResult(
         metric="screen_flow_coverage",
         total=1,

{codd_dev-1.22.0 → codd_dev-1.24.0}/codd/dag/__init__.py

@@ -19,6 +19,7 @@ class Edge:
     from_id: str
     to_id: str
     kind: str
+    attributes: dict[str, Any] = field(default_factory=dict)
 
 
 class DAG: