codd-dev 0.2.0a5__tar.gz → 0.3.0__tar.gz

{codd_dev-0.2.0a5 → codd_dev-0.3.0}/.gitignore

@@ -22,5 +22,5 @@ htmlcov/
 .pytest_cache/
 
 # CoDD generated (for development/testing)
-codd/graph.db
+codd/scan/
 codd/reports/

{codd_dev-0.2.0a5 → codd_dev-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codd-dev
-Version: 0.2.0a5
+Version: 0.3.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
@@ -16,13 +16,23 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Quality Assurance
 Requires-Python: >=3.10
 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'
+Provides-Extra: api-parsers
+Requires-Dist: graphql-core>=3.2.0; extra == 'api-parsers'
+Provides-Extra: infra
+Requires-Dist: python-hcl2>=7.0.0; extra == 'infra'
 Provides-Extra: mcp
 Provides-Extra: scan
 Requires-Dist: tree-sitter-java>=0.22; extra == 'scan'
 Requires-Dist: tree-sitter-python>=0.22; extra == 'scan'
 Requires-Dist: tree-sitter-typescript>=0.22; extra == 'scan'
 Requires-Dist: tree-sitter>=0.22; extra == 'scan'
+Provides-Extra: tree-sitter
+Requires-Dist: tree-sitter-python<0.26.0,>=0.25.0; extra == 'tree-sitter'
+Requires-Dist: tree-sitter-typescript<0.24.0,>=0.23.0; extra == 'tree-sitter'
+Requires-Dist: tree-sitter<0.26.0,>=0.25.0; extra == 'tree-sitter'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -49,7 +59,7 @@ Description-Content-Type: text/markdown
 pip install codd-dev
 ```
 
-**Public Alpha** — `init` / `scan` / `impact` / `validate` are stable today.
+**Public Alpha** — `init` / `scan` / `impact` are stable; `validate` is alpha.
 
 ---
 
@@ -256,7 +266,17 @@ codd:
 ---
 ```
 
-`graph.db` is a cache — regenerated on every `codd scan`.
+`codd/scan/` is a cache — regenerated on every `codd scan`.
+
+## Config Directory Discovery
+
+By default, `codd init` creates a `codd/` directory. If your project already has a `codd/` directory (e.g., it's your source code package), use `--config-dir`:
+
+```bash
+codd init --config-dir .codd --project-name "my-project" --language "python"
+```
+
+All other commands (`scan`, `impact`, `generate`, etc.) automatically discover whichever config directory exists — `codd/` first, then `.codd/`. No extra flags needed.
 
 ## Brownfield? Start Here
 
@@ -291,7 +311,7 @@ codd impact
 
 | Command | Status | Description |
 |---------|--------|-------------|
-| `codd init` | **Stable** | Initialize CoDD in any project |
+| `codd init` | **Stable** | Initialize CoDD in any project (`--config-dir .codd` for projects where `codd/` exists) |
 | `codd scan` | **Stable** | Build dependency graph from frontmatter |
 | `codd impact` | **Stable** | Change impact analysis (Green / Amber / Gray) |
 | `codd validate` | **Alpha** | Frontmatter integrity & graph consistency check |
@@ -395,11 +415,24 @@ docs/
 └── infra/              # Infrastructure design
 ```
 
+### CoDD Manages Its Own Development
+
+CoDD dogfoods itself. The `.codd/` directory contains CoDD's own config, and `codd extract` reverse-engineers design docs from its own source code. The full V-Model lifecycle runs on itself:
+
+```bash
+codd init --config-dir .codd --project-name "codd-dev" --language "python"
+codd extract          # 15 modules → design docs with dependency frontmatter
+codd scan             # 49 nodes, 83 edges
+codd verify           # mypy + pytest (127/127 tests pass)
+```
+
+If CoDD can't manage itself, it shouldn't manage your project.
+
 ## Roadmap
 
 - [ ] Semantic dependency types (`requires`, `affects`, `verifies`, `implements`)
 - [x] `codd extract` — reverse-generate design docs from existing codebases (brownfield support)
-- [ ] `codd verify` — full docs-code-tests coherence check
+- [x] `codd verify` — language-agnostic verification (Python: mypy + pytest, TypeScript: tsc + jest)
 - [ ] Multi-harness integration examples (Claude Code, Copilot, Cursor)
 - [ ] VS Code extension for impact visualization
 

{codd_dev-0.2.0a5 → codd_dev-0.3.0}/README.md

@@ -22,7 +22,7 @@
 pip install codd-dev
 ```
 
-**Public Alpha** — `init` / `scan` / `impact` / `validate` are stable today.
+**Public Alpha** — `init` / `scan` / `impact` are stable; `validate` is alpha.
 
 ---
 
@@ -229,7 +229,17 @@ codd:
 ---
 ```
 
-`graph.db` is a cache — regenerated on every `codd scan`.
+`codd/scan/` is a cache — regenerated on every `codd scan`.
+
+## Config Directory Discovery
+
+By default, `codd init` creates a `codd/` directory. If your project already has a `codd/` directory (e.g., it's your source code package), use `--config-dir`:
+
+```bash
+codd init --config-dir .codd --project-name "my-project" --language "python"
+```
+
+All other commands (`scan`, `impact`, `generate`, etc.) automatically discover whichever config directory exists — `codd/` first, then `.codd/`. No extra flags needed.
 
 ## Brownfield? Start Here
 
@@ -264,7 +274,7 @@ codd impact
 
 | Command | Status | Description |
 |---------|--------|-------------|
-| `codd init` | **Stable** | Initialize CoDD in any project |
+| `codd init` | **Stable** | Initialize CoDD in any project (`--config-dir .codd` for projects where `codd/` exists) |
 | `codd scan` | **Stable** | Build dependency graph from frontmatter |
 | `codd impact` | **Stable** | Change impact analysis (Green / Amber / Gray) |
 | `codd validate` | **Alpha** | Frontmatter integrity & graph consistency check |
@@ -368,11 +378,24 @@ docs/
 └── infra/              # Infrastructure design
 ```
 
+### CoDD Manages Its Own Development
+
+CoDD dogfoods itself. The `.codd/` directory contains CoDD's own config, and `codd extract` reverse-engineers design docs from its own source code. The full V-Model lifecycle runs on itself:
+
+```bash
+codd init --config-dir .codd --project-name "codd-dev" --language "python"
+codd extract          # 15 modules → design docs with dependency frontmatter
+codd scan             # 49 nodes, 83 edges
+codd verify           # mypy + pytest (127/127 tests pass)
+```
+
+If CoDD can't manage itself, it shouldn't manage your project.
+
 ## Roadmap
 
 - [ ] Semantic dependency types (`requires`, `affects`, `verifies`, `implements`)
 - [x] `codd extract` — reverse-generate design docs from existing codebases (brownfield support)
-- [ ] `codd verify` — full docs-code-tests coherence check
+- [x] `codd verify` — language-agnostic verification (Python: mypy + pytest, TypeScript: tsc + jest)
 - [ ] Multi-harness integration examples (Claude Code, Copilot, Cursor)
 - [ ] VS Code extension for impact visualization
 

{codd_dev-0.2.0a5 → codd_dev-0.3.0}/codd/cli.py

@@ -6,9 +6,20 @@ import os
 import shutil
 from pathlib import Path
 
+from codd.config import find_codd_dir
+
 TEMPLATES_DIR = Path(__file__).parent / "templates"
 
 
+def _require_codd_dir(project_root: Path) -> Path:
+    """Return the CoDD config dir or exit with a helpful message."""
+    codd_dir = find_codd_dir(project_root)
+    if codd_dir is None:
+        click.echo("Error: CoDD config dir not found (looked for codd/ and .codd/). Run 'codd init' first.")
+        raise SystemExit(1)
+    return codd_dir
+
+
 @click.group()
 @click.version_option(package_name="codd-dev")
 def main():
@@ -18,7 +29,7 @@ def main():
 
 @main.command()
 @click.option("--project-name", prompt="Project name", help="Name of the project")
-@click.option("--language", prompt="Primary language", help="Primary language (python/typescript/java/go)")
+@click.option("--language", prompt="Primary language", help="Primary language (python/typescript/javascript/go — full support; java — symbols only)")
 @click.option("--dest", default=".", help="Destination directory (default: current dir)")
 @click.option(
     "--requirements",
@@ -26,10 +37,15 @@ def main():
     type=click.Path(exists=True),
     help="Import a requirements file (any format: .md, .txt, .doc). CoDD adds frontmatter automatically.",
 )
-def init(project_name: str, language: str, dest: str, requirements: str | None):
+@click.option(
+    "--config-dir",
+    default="codd",
+    help="Name of the CoDD config directory (default: codd). Use .codd when codd/ is your source directory.",
+)
+def init(project_name: str, language: str, dest: str, requirements: str | None, config_dir: str):
     """Initialize CoDD in a project directory."""
     dest_path = Path(dest).resolve()
-    codd_dir = dest_path / "codd"
+    codd_dir = dest_path / config_dir
 
     if codd_dir.exists():
         if requirements:
@@ -81,11 +97,7 @@ def scan(path: str):
     """Scan codebase and update dependency graph (Stage 1)."""
     from codd.scanner import run_scan
     project_root = Path(path).resolve()
-    codd_dir = project_root / "codd"
-
-    if not codd_dir.exists():
-        click.echo("Error: codd/ not found. Run 'codd init' first.")
-        raise SystemExit(1)
+    codd_dir = _require_codd_dir(project_root)
 
     run_scan(project_root, codd_dir)
 
@@ -98,11 +110,7 @@ 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 = project_root / "codd"
-
-    if not codd_dir.exists():
-        click.echo("Error: codd/ not found. Run 'codd init' first.")
-        raise SystemExit(1)
+    codd_dir = _require_codd_dir(project_root)
 
     run_impact(project_root, codd_dir, diff, output)
 
@@ -121,11 +129,7 @@ def generate(wave: int, path: str, force: bool, ai_cmd: str | None):
     from codd.generator import generate_wave, _load_project_config
 
     project_root = Path(path).resolve()
-    codd_dir = project_root / "codd"
-
-    if not codd_dir.exists():
-        click.echo("Error: codd/ not found. Run 'codd init' first.")
-        raise SystemExit(1)
+    codd_dir = _require_codd_dir(project_root)
 
     # Auto-generate wave_config if missing
     config = _load_project_config(project_root)
@@ -174,11 +178,7 @@ def implement(sprint: int, path: str, task: str | None, ai_cmd: str | None):
     from codd.implementer import implement_sprint
 
     project_root = Path(path).resolve()
-    codd_dir = project_root / "codd"
-
-    if not codd_dir.exists():
-        click.echo("Error: codd/ not found. Run 'codd init' first.")
-        raise SystemExit(1)
+    codd_dir = _require_codd_dir(project_root)
 
     try:
         results = implement_sprint(project_root, sprint, task=task, ai_command=ai_cmd)
@@ -204,11 +204,7 @@ def verify(path: str, sprint: int | None) -> None:
     from codd.verifier import VerifyPreflightError, run_verify
 
     project_root = Path(path).resolve()
-    codd_dir = project_root / "codd"
-
-    if not codd_dir.exists():
-        click.echo("Error: codd/ not found. Run 'codd init' first.")
-        raise SystemExit(1)
+    codd_dir = _require_codd_dir(project_root)
 
     try:
         result = run_verify(project_root, sprint=sprint)
@@ -248,7 +244,7 @@ def verify(path: str, sprint: int | None) -> None:
 
 @main.command()
 @click.option("--path", default=".", help="Project root directory")
-@click.option("--language", default=None, help="Override language detection (python/typescript/javascript/java/go)")
+@click.option("--language", default=None, help="Override language detection (python/typescript/javascript/go — full support; java — symbols only)")
 @click.option("--source-dirs", default=None, help="Comma-separated source directories (default: auto-detect)")
 @click.option("--output", default=None, help="Output directory (default: codd/extracted/)")
 def extract(path: str, language: str | None, source_dirs: str | None, output: str | None):
@@ -289,11 +285,7 @@ def validate(path: str):
     from codd.validator import run_validate
 
     project_root = Path(path).resolve()
-    codd_dir = project_root / "codd"
-
-    if not codd_dir.exists():
-        click.echo("Error: codd/ not found. Run 'codd init' first.")
-        raise SystemExit(1)
+    codd_dir = _require_codd_dir(project_root)
 
     raise SystemExit(run_validate(project_root, codd_dir))
 
@@ -313,11 +305,7 @@ def plan(path: str, as_json: bool, initialize: bool, force: bool, ai_cmd: str |
     from codd.planner import build_plan, plan_init, plan_to_dict, render_plan_text
 
     project_root = Path(path).resolve()
-    codd_dir = project_root / "codd"
-
-    if not codd_dir.exists():
-        click.echo("Error: codd/ not found. Run 'codd init' first.")
-        raise SystemExit(1)
+    codd_dir = _require_codd_dir(project_root)
 
     if initialize:
         if as_json:

{codd_dev-0.2.0a5 → codd_dev-0.3.0}/codd/config.py

@@ -12,10 +12,33 @@ import yaml
 
 DEFAULTS_PATH = Path(__file__).with_name("defaults.yaml")
 
+# Supported CoDD config directory names, in priority order.
+CODD_DIR_CANDIDATES = ("codd", ".codd")
+
+
+def find_codd_dir(project_root: Path) -> Path | None:
+    """Discover the CoDD config directory under *project_root*.
+
+    A valid CoDD config directory must contain ``codd.yaml``.
+    Checks ``codd/`` first, then ``.codd/``.  Returns ``None`` when
+    neither qualifies (caller decides whether that is an error).
+    """
+    for name in CODD_DIR_CANDIDATES:
+        candidate = project_root / name
+        if candidate.is_dir() and (candidate / "codd.yaml").exists():
+            return candidate
+    return None
+
 
 def load_project_config(project_root: Path) -> dict[str, Any]:
     """Load CoDD defaults and merge project-local overrides."""
-    config_path = project_root / "codd" / "codd.yaml"
+    codd_dir = find_codd_dir(project_root)
+    if codd_dir is None:
+        raise FileNotFoundError(
+            f"CoDD config dir not found in {project_root} "
+            f"(looked for {', '.join(CODD_DIR_CANDIDATES)})"
+        )
+    config_path = codd_dir / "codd.yaml"
     if not config_path.exists():
         raise FileNotFoundError(f"{config_path} not found")