code2schema 0.1.1__tar.gz → 0.1.4__tar.gz

{code2schema-0.1.1 → code2schema-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2schema
-Version: 0.1.1
+Version: 0.1.4
 Summary: Semantic compiler: Code → AST → CQRS Model → Workflow DAG → Proto/Schema
 License: Apache-2.0
 Keywords: ast,cqrs,static-analysis,code-quality,schema
@@ -34,18 +34,16 @@ Dynamic: license-file
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.1-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-$0.15-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-1.0h-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.1.4-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-$0.45-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-3.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $0.1500 (1 commits)
-- 👤 **Human dev:** ~$100 (1.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $0.4500 (3 commits)
+- 👤 **Human dev:** ~$350 (3.5h @ $100/h, 30min dedup)
 
-Generated on 2026-05-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-07 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-
-
 **Semantic Compiler for Software Systems**
 
 Przekształca kod Python w model semantyczny CQRS → kontrakty API → graf architektury.
@@ -80,33 +78,81 @@ pip install "code2schema[dev]"     # pytest + ruff + black
 ## Szybki start
 
 ```bash
-# Pełna analiza projektu
-code2schema ./moj_projekt \
-  --out schema.json \
-  --proto api.proto \
-  --md report.md \
-  --graphml graph.graphml \
-  --dot graph.dot \
-  --graph-summary \
-  --events \
-  --cycles
+# Analiza z auto-generowanymi nazwami plików (w katalogu bieżącym)
+code2schema /home/tom/github/maskservice/c2004/backend
+# → c2004_schema.json
+
+# Pełna analiza ze wszystkimi formatami wyjściowymi
+code2schema ./backend --proto --md --html
+# → backend_schema.json
+# → backend_api.proto
+# → backend_report.md
+# → backend_viz.html
+
+# Pełna analiza ze szczegółami
+code2schema ./backend --proto --md --html --graph-summary --events --cycles
 ```
 
 Przykładowy output:
 
 ```
-✅ Gotowe (1.2s)
-   Modules  : 87
-   Functions: 883
-   Queries  : 612
-   Commands : 184
-   Orchest. : 87
-   Workflows: 87
-   Rules    : 43
-   Graph    : 883N / 1204E
-   → schema.json
+✅ Gotowe (1.8s)
+   Modules  : 607
+   Functions: 3142
+   Queries  : 1518
+   Commands : 505
+   Orchest. : 1119
+   Workflows: 1118
+   Rules    : 320
+   Graph    : 2922N / 5612E
+   → c2004_schema.json
+   → c2004_api.proto
+   → c2004_report.md
+```
+
+## Test na dużym projekcie (c2004 backend)
+
+Analiza produkcyjnego projektu IoT (607 modułów, 3142 funkcje):
+
+```bash
+code2schema /home/tom/github/maskservice/c2004/backend --proto --md --html
+# Pliki generowane w /home/tom/github/maskservice/c2004/ (katalog projektu)
+```
+
+**Wyniki:**
+```
+✅ Gotowe (1.8s)
+   Modules  : 607
+   Functions: 3142
+   Queries  : 1518
+   Commands : 505
+   Orchest. : 1119
+   Workflows: 1118
+   Rules    : 320
+   Graph    : 2922N / 5612E
+   → c2004_schema.json
+   → c2004_api.proto
+   → c2004_report.md
+   → c2004_viz.html
 ```
 
+## Dokumentacja i przykłady
+
+- **[Dokumentacja](docs/)** — przykłady użycia CLI i Python API
+  - [CLI examples](docs/examples/cli/basic.sh)
+  - [Python API — basic](docs/examples/api/basic.py)
+  - [Python API — advanced](docs/examples/api/advanced.py)
+  - [Sample outputs](docs/examples/outputs/)
+
+Wykryte cykle w architekturze CQRS (do refaktoryzacji):
+- `handle → publish → _execute → publish → handle`
+
+**Wygenerowane artefakty:**
+- `c2004_schema.json` (2.9MB) — pełny model
+- `c2004_api.proto` (188KB) — gRPC contracts
+- `c2004_report.md` (49KB) — podsumowanie jakości
+- `c2004_viz.html` (1.1MB) — **interaktywny graf D3.js** z wyszukiwaniem i filtrowaniem
+
 ## Użycie w kodzie
 
 ```python
@@ -138,6 +184,21 @@ print(to_proto(schema))
 print(to_markdown(schema))
 ```
 
+## Wizualizacja HTML (`--html`)
+
+Interaktywny graf D3.js z funkcjami:
+- **Kolory ról**: 🟢 Query, 🟠 Command, 🟣 Orchestrator
+- **Wyszukiwanie** — filtruje węzły w czasie rzeczywistym
+- **Hover** — podświetla połączenia (call graph)
+- **Klik** — szczegóły funkcji (fan-out, side effects, reguły jakości)
+- **Filtry** — pokazuj/ukrywaj kategorie ról
+- **Force layout** — przeciąganie węzłów
+
+```bash
+code2schema ./backend --html viz.html
+# Otwórz w przeglądarce: open viz.html
+```
+
 ## Architektura paczki
 
 ```

{code2schema-0.1.1 → code2schema-0.1.4}/README.md

@@ -3,18 +3,16 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.1-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-$0.15-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-1.0h-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.1.4-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-$0.45-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-3.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $0.1500 (1 commits)
-- 👤 **Human dev:** ~$100 (1.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $0.4500 (3 commits)
+- 👤 **Human dev:** ~$350 (3.5h @ $100/h, 30min dedup)
 
-Generated on 2026-05-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-07 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-
-
 **Semantic Compiler for Software Systems**
 
 Przekształca kod Python w model semantyczny CQRS → kontrakty API → graf architektury.
@@ -49,33 +47,81 @@ pip install "code2schema[dev]"     # pytest + ruff + black
 ## Szybki start
 
 ```bash
-# Pełna analiza projektu
-code2schema ./moj_projekt \
-  --out schema.json \
-  --proto api.proto \
-  --md report.md \
-  --graphml graph.graphml \
-  --dot graph.dot \
-  --graph-summary \
-  --events \
-  --cycles
+# Analiza z auto-generowanymi nazwami plików (w katalogu bieżącym)
+code2schema /home/tom/github/maskservice/c2004/backend
+# → c2004_schema.json
+
+# Pełna analiza ze wszystkimi formatami wyjściowymi
+code2schema ./backend --proto --md --html
+# → backend_schema.json
+# → backend_api.proto
+# → backend_report.md
+# → backend_viz.html
+
+# Pełna analiza ze szczegółami
+code2schema ./backend --proto --md --html --graph-summary --events --cycles
 ```
 
 Przykładowy output:
 
 ```
-✅ Gotowe (1.2s)
-   Modules  : 87
-   Functions: 883
-   Queries  : 612
-   Commands : 184
-   Orchest. : 87
-   Workflows: 87
-   Rules    : 43
-   Graph    : 883N / 1204E
-   → schema.json
+✅ Gotowe (1.8s)
+   Modules  : 607
+   Functions: 3142
+   Queries  : 1518
+   Commands : 505
+   Orchest. : 1119
+   Workflows: 1118
+   Rules    : 320
+   Graph    : 2922N / 5612E
+   → c2004_schema.json
+   → c2004_api.proto
+   → c2004_report.md
+```
+
+## Test na dużym projekcie (c2004 backend)
+
+Analiza produkcyjnego projektu IoT (607 modułów, 3142 funkcje):
+
+```bash
+code2schema /home/tom/github/maskservice/c2004/backend --proto --md --html
+# Pliki generowane w /home/tom/github/maskservice/c2004/ (katalog projektu)
+```
+
+**Wyniki:**
+```
+✅ Gotowe (1.8s)
+   Modules  : 607
+   Functions: 3142
+   Queries  : 1518
+   Commands : 505
+   Orchest. : 1119
+   Workflows: 1118
+   Rules    : 320
+   Graph    : 2922N / 5612E
+   → c2004_schema.json
+   → c2004_api.proto
+   → c2004_report.md
+   → c2004_viz.html
 ```
 
+## Dokumentacja i przykłady
+
+- **[Dokumentacja](docs/)** — przykłady użycia CLI i Python API
+  - [CLI examples](docs/examples/cli/basic.sh)
+  - [Python API — basic](docs/examples/api/basic.py)
+  - [Python API — advanced](docs/examples/api/advanced.py)
+  - [Sample outputs](docs/examples/outputs/)
+
+Wykryte cykle w architekturze CQRS (do refaktoryzacji):
+- `handle → publish → _execute → publish → handle`
+
+**Wygenerowane artefakty:**
+- `c2004_schema.json` (2.9MB) — pełny model
+- `c2004_api.proto` (188KB) — gRPC contracts
+- `c2004_report.md` (49KB) — podsumowanie jakości
+- `c2004_viz.html` (1.1MB) — **interaktywny graf D3.js** z wyszukiwaniem i filtrowaniem
+
 ## Użycie w kodzie
 
 ```python
@@ -107,6 +153,21 @@ print(to_proto(schema))
 print(to_markdown(schema))
 ```
 
+## Wizualizacja HTML (`--html`)
+
+Interaktywny graf D3.js z funkcjami:
+- **Kolory ról**: 🟢 Query, 🟠 Command, 🟣 Orchestrator
+- **Wyszukiwanie** — filtruje węzły w czasie rzeczywistym
+- **Hover** — podświetla połączenia (call graph)
+- **Klik** — szczegóły funkcji (fan-out, side effects, reguły jakości)
+- **Filtry** — pokazuj/ukrywaj kategorie ról
+- **Force layout** — przeciąganie węzłów
+
+```bash
+code2schema ./backend --html viz.html
+# Otwórz w przeglądarce: open viz.html
+```
+
 ## Architektura paczki
 
 ```

{code2schema-0.1.1 → code2schema-0.1.4}/code2schema/__init__.py

@@ -7,4 +7,4 @@ __all__ = [
     "SchemaIR", "CQRSRole", "FunctionIR", "ModuleIR",
     "extract_project", "extract_module", "analyze",
 ]
-__version__ = "0.1.1"
+__version__ = "0.1.4"

{code2schema-0.1.1 → code2schema-0.1.4}/code2schema/analyzer/events.py

@@ -72,39 +72,33 @@ class EventModel:
 
 # ── Inference ─────────────────────────────────────────────────────────────────
 
-def infer_event_model(modules: List[ModuleIR]) -> EventModel:
-    """Przechodzi po IR i buduje model zdarzeń."""
-    model = EventModel()
-
-    all_funcs: dict[str, FunctionIR] = {}
-    for mod in modules:
-        for f in mod.functions:
-            all_funcs[f.qualified_name] = f
-            all_funcs[f.name] = f  # short alias
-
-    # Krok 1: znajdź emiterów
-    emitters: dict[str, DomainEvent] = {}
+def _find_emitters(modules: List[ModuleIR]) -> List[DomainEvent]:
+    """Krok 1: znajdź funkcje emitujące zdarzenia."""
+    events: List[DomainEvent] = []
     for mod in modules:
         for f in mod.functions:
             if _EVENT_EMIT_PATTERNS.search(f.name) or any(
                 _EVENT_EMIT_PATTERNS.search(c) for c in f.calls
             ):
                 event_name = _derive_event_name(f.name)
-                ev = DomainEvent(name=event_name, emitted_by=f.qualified_name)
-                emitters[f.name] = ev
-                model.events.append(ev)
+                events.append(DomainEvent(name=event_name, emitted_by=f.qualified_name))
+    return events
 
-    # Krok 2: znajdź handlerów
+
+def _find_handlers(events: List[DomainEvent], modules: List[ModuleIR]) -> None:
+    """Krok 2: dopasuj handlery do zdarzeń (mutuje events in-place)."""
     for mod in modules:
         for f in mod.functions:
             if _EVENT_HANDLER_PATTERNS.search(f.name):
-                # sprawdź, czy handler pasuje do jakiegoś zdarzenia
-                for ev in model.events:
+                for ev in events:
                     keyword = ev.name.lower().replace("event", "").strip()
                     if keyword and keyword in f.name.lower():
                         ev.handled_by.append(f.qualified_name)
 
-    # Krok 3: command handlers
+
+def _find_command_handlers(modules: List[ModuleIR]) -> List[CommandHandler]:
+    """Krok 3: znajdź command handlery i ich emitowane zdarzenia."""
+    commands: List[CommandHandler] = []
     for mod in modules:
         for f in mod.functions:
             if f.role == CQRSRole.COMMAND or _AGGREGATE_PATTERNS.search(f.name):
@@ -114,24 +108,36 @@ def infer_event_model(modules: List[ModuleIR]) -> EventModel:
                     if _EVENT_EMIT_PATTERNS.search(c)
                 ]
                 if emits or f.role == CQRSRole.COMMAND:
-                    model.commands.append(
+                    commands.append(
                         CommandHandler(
                             name=f.qualified_name,
                             command=f.name,
                             emits=emits,
                         )
                     )
+    return commands
+
 
-    # Krok 4: agregaty — moduły z operacjami CRUD
+def _find_aggregates(modules: List[ModuleIR]) -> List[str]:
+    """Krok 4: znajdź moduły będące agregatami (CRUD score >= 2)."""
+    aggregates: List[str] = []
     for mod in modules:
         crud_score = sum(
             1 for f in mod.functions
             if _AGGREGATE_PATTERNS.search(f.name)
         )
         if crud_score >= 2:
-            model.aggregates.append(mod.name)
+            aggregates.append(mod.name)
+    return aggregates
 
-    return model
+
+def infer_event_model(modules: List[ModuleIR]) -> EventModel:
+    """Przechodzi po IR i buduje model zdarzeń."""
+    events = _find_emitters(modules)
+    _find_handlers(events, modules)
+    commands = _find_command_handlers(modules)
+    aggregates = _find_aggregates(modules)
+    return EventModel(commands=commands, events=events, aggregates=aggregates)
 
 
 def _derive_event_name(func_name: str) -> str:

code2schema-0.1.4/code2schema/cli.py

@@ -0,0 +1,207 @@
+"""
+code2schema.cli
+~~~~~~~~~~~~~~~
+CLI v3 — pełny pipeline.
+"""
+from __future__ import annotations
+
+import argparse
+import sys
+import time
+from pathlib import Path
+
+from code2schema.analyzer.cqrs import analyze
+from code2schema.analyzer.events import infer_event_model
+from code2schema.analyzer.graph import (
+    build_rich_graph, detect_cycles, graph_summary, write_dot, write_graphml,
+)
+from code2schema.codegen import write_json, write_markdown, write_proto
+from code2schema.codegen.visualizer import write_html
+from code2schema.core.extractor import extract_project
+
+
+_SPECIAL_PROJECT_DIRS = {"backend", "frontend", "src", "app", "api"}
+_GENERIC_PATH_PARTS = {"home", "github", "workspace", "projects", "src"}
+
+
+def _project_name_from_path(path: Path) -> str:
+    """Extract project name from path (e.g., /path/to/c2004/backend -> c2004)."""
+    # Try to find a meaningful name from the path
+    parts = path.parts
+    for i, part in enumerate(reversed(parts)):
+        if part in _SPECIAL_PROJECT_DIRS:
+            # Use parent directory name
+            if i < len(parts) - 1:
+                return parts[-(i + 2)]
+        # Skip common generic names
+        if part not in _GENERIC_PATH_PARTS:
+            return part
+    return path.name or "project"
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    """Build CLI argument parser."""
+    from code2schema import __version__
+    parser = argparse.ArgumentParser(prog="code2schema",
+        description="Semantic Compiler: Code → CQRS → Schema / Proto / Graph")
+    parser.add_argument("path")
+    parser.add_argument("-o", "--out", metavar="FILE", help="Output JSON schema (default: <project>_schema.json)")
+    parser.add_argument("--proto", metavar="FILE", nargs="?", const=True, default=None,
+                        help="Output .proto file (default: <project>_api.proto if flag present)")
+    parser.add_argument("--md", metavar="FILE", nargs="?", const=True, default=None,
+                        help="Output Markdown report (default: <project>_report.md if flag present)")
+    parser.add_argument("--graphml", metavar="FILE")
+    parser.add_argument("--dot", metavar="FILE")
+    parser.add_argument("--html", metavar="FILE", nargs="?", const=True, default=None,
+                        help="Interactive HTML visualization (default: <project>_viz.html if flag present)")
+    parser.add_argument("--events", action="store_true")
+    parser.add_argument("--cycles", action="store_true")
+    parser.add_argument("--graph-summary", action="store_true")
+    parser.add_argument("--no-rules", action="store_true")
+    parser.add_argument("--exclude", nargs="*", default=[])
+    parser.add_argument("-q", "--quiet", action="store_true")
+    parser.add_argument("-V", "--version", action="version",
+                        version=f"%(prog)s {__version__}")
+    return parser
+
+
+def _resolve_output_dir(root: Path) -> Path:
+    if not root.is_dir():
+        return root.parent
+    if root.name in _SPECIAL_PROJECT_DIRS:
+        return root.parent
+    return root
+
+
+def _resolve_required_path(out_dir: Path, value: str | None, default_name: str) -> Path:
+    return out_dir / (value or default_name)
+
+
+def _resolve_optional_path(
+    out_dir: Path,
+    value: str | bool | None,
+    default_name: str,
+) -> Path | None:
+    if isinstance(value, str):
+        return out_dir / value
+    if value is True:
+        return out_dir / default_name
+    return None
+
+
+def _resolve_paths(
+    args: argparse.Namespace,
+) -> tuple[Path, Path, Path | None, Path | None, Path | None]:
+    """Resolve root, project name and output file paths from CLI args."""
+    root = Path(args.path)
+    proj_name = _project_name_from_path(root)
+    out_dir = _resolve_output_dir(root)
+
+    out_path = _resolve_required_path(out_dir, args.out, f"{proj_name}_schema.json")
+    proto_path = _resolve_optional_path(out_dir, args.proto, f"{proj_name}_api.proto")
+    md_path = _resolve_optional_path(out_dir, args.md, f"{proj_name}_report.md")
+    html_path = _resolve_optional_path(out_dir, args.html, f"{proj_name}_viz.html")
+    return root, out_path, proto_path, md_path, html_path
+
+
+def _run_extraction(args, root):
+    """Parse project and run CQRS analysis. Returns (modules, schema, G) or None on failure."""
+    modules = extract_project(root, exclude=args.exclude or None)
+    if not modules:
+        print("ERROR: Brak plików .py.", file=sys.stderr)
+        return None
+    schema = analyze(modules)
+    if args.no_rules:
+        schema.rules = []
+    G = build_rich_graph(schema)
+    return modules, schema, G
+
+
+def _run_reports(args, modules, schema, G):
+    """Print optional reports: cycles, graph summary, events."""
+    if args.cycles:
+        cycles = detect_cycles(G)
+        if cycles:
+            print(f"\n⚠️  Cykle ({len(cycles)}):")
+            for c in cycles[:5]:
+                print(f"  {' → '.join(c[:5])}")
+        else:
+            print("✅ Brak cykli.")
+
+    if args.graph_summary:
+        print("\n── Graph Summary ──────────────────────")
+        print(graph_summary(G, schema))
+
+    if args.events:
+        em = infer_event_model(modules)
+        print("\n── Event Model ────────────────────────")
+        print(em.summary())
+
+
+def _write_outputs(args, schema, G, out_path, proto_path, md_path, html_path):
+    """Write all output files (JSON, proto, md, html, graphml, dot)."""
+    write_json(schema, out_path)
+    if proto_path:
+        write_proto(schema, proto_path)
+    if md_path:
+        write_markdown(schema, md_path)
+    if html_path:
+        write_html(schema, html_path)
+    if args.graphml:
+        write_graphml(G, Path(args.graphml))
+    if args.dot:
+        write_dot(G, Path(args.dot))
+
+
+def _print_summary(modules, schema, G, t0, out_path, proto_path, md_path, html_path):
+    """Print final summary with metrics and output file names."""
+    funcs = schema.all_functions()
+    outputs = [f"   → {out_path.name}"]
+    if proto_path:
+        outputs.append(f"   → {proto_path.name}")
+    if md_path:
+        outputs.append(f"   → {md_path.name}")
+    if html_path:
+        outputs.append(f"   → {html_path.name}")
+    print(
+        f"\n✅ Gotowe ({time.perf_counter()-t0:.2f}s)\n"
+        f"   Modules  : {len(modules)}\n"
+        f"   Functions: {len(funcs)}\n"
+        f"   Queries  : {len(schema.queries())}\n"
+        f"   Commands : {len(schema.commands())}\n"
+        f"   Orchest. : {len(schema.orchestrators())}\n"
+        f"   Workflows: {len(schema.workflows)}\n"
+        f"   Rules    : {len(schema.rules)}\n"
+        f"   Graph    : {G.number_of_nodes()}N / {G.number_of_edges()}E\n"
+        + "\n".join(outputs)
+    )
+
+
+def main(argv=None):
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+
+    root, out_path, proto_path, md_path, html_path = _resolve_paths(args)
+    if not root.exists():
+        print(f"ERROR: {root}", file=sys.stderr)
+        return 1
+
+    t0 = time.perf_counter()
+    if not args.quiet:
+        print(f"⏳ Parsing: {root}")
+
+    result = _run_extraction(args, root)
+    if result is None:
+        return 1
+    modules, schema, G = result
+
+    _run_reports(args, modules, schema, G)
+    _write_outputs(args, schema, G, out_path, proto_path, md_path, html_path)
+
+    if not args.quiet:
+        _print_summary(modules, schema, G, t0, out_path, proto_path, md_path, html_path)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{code2schema-0.1.1 → code2schema-0.1.4}/code2schema.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2schema
-Version: 0.1.1
+Version: 0.1.4
 Summary: Semantic compiler: Code → AST → CQRS Model → Workflow DAG → Proto/Schema
 License: Apache-2.0
 Keywords: ast,cqrs,static-analysis,code-quality,schema
@@ -34,18 +34,16 @@ Dynamic: license-file
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.1-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-$0.15-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-1.0h-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.1.4-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-$0.45-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-3.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $0.1500 (1 commits)
-- 👤 **Human dev:** ~$100 (1.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $0.4500 (3 commits)
+- 👤 **Human dev:** ~$350 (3.5h @ $100/h, 30min dedup)
 
-Generated on 2026-05-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-07 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-
-
 **Semantic Compiler for Software Systems**
 
 Przekształca kod Python w model semantyczny CQRS → kontrakty API → graf architektury.
@@ -80,33 +78,81 @@ pip install "code2schema[dev]"     # pytest + ruff + black
 ## Szybki start
 
 ```bash
-# Pełna analiza projektu
-code2schema ./moj_projekt \
-  --out schema.json \
-  --proto api.proto \
-  --md report.md \
-  --graphml graph.graphml \
-  --dot graph.dot \
-  --graph-summary \
-  --events \
-  --cycles
+# Analiza z auto-generowanymi nazwami plików (w katalogu bieżącym)
+code2schema /home/tom/github/maskservice/c2004/backend
+# → c2004_schema.json
+
+# Pełna analiza ze wszystkimi formatami wyjściowymi
+code2schema ./backend --proto --md --html
+# → backend_schema.json
+# → backend_api.proto
+# → backend_report.md
+# → backend_viz.html
+
+# Pełna analiza ze szczegółami
+code2schema ./backend --proto --md --html --graph-summary --events --cycles
 ```
 
 Przykładowy output:
 
 ```
-✅ Gotowe (1.2s)
-   Modules  : 87
-   Functions: 883
-   Queries  : 612
-   Commands : 184
-   Orchest. : 87
-   Workflows: 87
-   Rules    : 43
-   Graph    : 883N / 1204E
-   → schema.json
+✅ Gotowe (1.8s)
+   Modules  : 607
+   Functions: 3142
+   Queries  : 1518
+   Commands : 505
+   Orchest. : 1119
+   Workflows: 1118
+   Rules    : 320
+   Graph    : 2922N / 5612E
+   → c2004_schema.json
+   → c2004_api.proto
+   → c2004_report.md
+```
+
+## Test na dużym projekcie (c2004 backend)
+
+Analiza produkcyjnego projektu IoT (607 modułów, 3142 funkcje):
+
+```bash
+code2schema /home/tom/github/maskservice/c2004/backend --proto --md --html
+# Pliki generowane w /home/tom/github/maskservice/c2004/ (katalog projektu)
+```
+
+**Wyniki:**
+```
+✅ Gotowe (1.8s)
+   Modules  : 607
+   Functions: 3142
+   Queries  : 1518
+   Commands : 505
+   Orchest. : 1119
+   Workflows: 1118
+   Rules    : 320
+   Graph    : 2922N / 5612E
+   → c2004_schema.json
+   → c2004_api.proto
+   → c2004_report.md
+   → c2004_viz.html
 ```
 
+## Dokumentacja i przykłady
+
+- **[Dokumentacja](docs/)** — przykłady użycia CLI i Python API
+  - [CLI examples](docs/examples/cli/basic.sh)
+  - [Python API — basic](docs/examples/api/basic.py)
+  - [Python API — advanced](docs/examples/api/advanced.py)
+  - [Sample outputs](docs/examples/outputs/)
+
+Wykryte cykle w architekturze CQRS (do refaktoryzacji):
+- `handle → publish → _execute → publish → handle`
+
+**Wygenerowane artefakty:**
+- `c2004_schema.json` (2.9MB) — pełny model
+- `c2004_api.proto` (188KB) — gRPC contracts
+- `c2004_report.md` (49KB) — podsumowanie jakości
+- `c2004_viz.html` (1.1MB) — **interaktywny graf D3.js** z wyszukiwaniem i filtrowaniem
+
 ## Użycie w kodzie
 
 ```python
@@ -138,6 +184,21 @@ print(to_proto(schema))
 print(to_markdown(schema))
 ```
 
+## Wizualizacja HTML (`--html`)
+
+Interaktywny graf D3.js z funkcjami:
+- **Kolory ról**: 🟢 Query, 🟠 Command, 🟣 Orchestrator
+- **Wyszukiwanie** — filtruje węzły w czasie rzeczywistym
+- **Hover** — podświetla połączenia (call graph)
+- **Klik** — szczegóły funkcji (fan-out, side effects, reguły jakości)
+- **Filtry** — pokazuj/ukrywaj kategorie ról
+- **Force layout** — przeciąganie węzłów
+
+```bash
+code2schema ./backend --html viz.html
+# Otwórz w przeglądarce: open viz.html
+```
+
 ## Architektura paczki
 
 ```

{code2schema-0.1.1 → code2schema-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2schema"
-version = "0.1.1"
+version = "0.1.4"
 description = "Semantic compiler: Code → AST → CQRS Model → Workflow DAG → Proto/Schema"
 readme = "README.md"
 requires-python = ">=3.10"

{code2schema-0.1.1 → code2schema-0.1.4}/tests/test_code2schema.py

@@ -1,6 +1,7 @@
 """Testy jednostkowe code2schema."""
 from __future__ import annotations
 
+import argparse
 import ast
 import textwrap
 from pathlib import Path
@@ -10,6 +11,7 @@ import pytest
 from code2schema.core.models import CQRSRole, SideEffect
 from code2schema.core.extractor import extract_module
 from code2schema.analyzer.cqrs import _infer_role, analyze, build_call_graph
+from code2schema.cli import _resolve_paths
 from code2schema.codegen import to_json, to_proto, to_markdown
 
 
@@ -216,3 +218,48 @@ def test_event_model_summary(sample_module):
     summary = em.summary()
     assert "Commands" in summary
     assert "Domain Events" in summary
+
+
+# ── CLI Paths ─────────────────────────────────────────────────────────────────
+
+def test_resolve_paths_for_special_project_dir(tmp_path: Path):
+    backend_dir = tmp_path / "c2004" / "backend"
+    backend_dir.mkdir(parents=True)
+
+    args = argparse.Namespace(
+        path=str(backend_dir),
+        out=None,
+        proto=True,
+        md=True,
+        html=True,
+    )
+
+    root, out_path, proto_path, md_path, html_path = _resolve_paths(args)
+
+    assert root == backend_dir
+    assert out_path == backend_dir.parent / "c2004_schema.json"
+    assert proto_path == backend_dir.parent / "c2004_api.proto"
+    assert md_path == backend_dir.parent / "c2004_report.md"
+    assert html_path == backend_dir.parent / "c2004_viz.html"
+
+
+def test_resolve_paths_for_file_input_with_custom_outputs(tmp_path: Path):
+    file_path = tmp_path / "repo" / "main.py"
+    file_path.parent.mkdir(parents=True)
+    file_path.write_text("def main():\n    pass\n")
+
+    args = argparse.Namespace(
+        path=str(file_path),
+        out="schema.json",
+        proto="api.proto",
+        md=None,
+        html=None,
+    )
+
+    root, out_path, proto_path, md_path, html_path = _resolve_paths(args)
+
+    assert root == file_path
+    assert out_path == file_path.parent / "schema.json"
+    assert proto_path == file_path.parent / "api.proto"
+    assert md_path is None
+    assert html_path is None

code2schema-0.1.1/code2schema/cli.py

@@ -1,105 +0,0 @@
-"""
-code2schema.cli
-~~~~~~~~~~~~~~~
-CLI v3 — pełny pipeline.
-"""
-from __future__ import annotations
-
-import argparse
-import sys
-import time
-from pathlib import Path
-
-from code2schema.analyzer.cqrs import analyze
-from code2schema.analyzer.events import infer_event_model
-from code2schema.analyzer.graph import (
-    build_rich_graph, detect_cycles, graph_summary, write_dot, write_graphml,
-)
-from code2schema.codegen import write_json, write_markdown, write_proto
-from code2schema.core.extractor import extract_project
-
-
-def main(argv=None):
-    parser = argparse.ArgumentParser(prog="code2schema",
-        description="Semantic Compiler: Code → CQRS → Schema / Proto / Graph")
-    parser.add_argument("path")
-    parser.add_argument("-o", "--out", default="schema.json")
-    parser.add_argument("--proto", metavar="FILE")
-    parser.add_argument("--md", metavar="FILE")
-    parser.add_argument("--graphml", metavar="FILE")
-    parser.add_argument("--dot", metavar="FILE")
-    parser.add_argument("--events", action="store_true")
-    parser.add_argument("--cycles", action="store_true")
-    parser.add_argument("--graph-summary", action="store_true")
-    parser.add_argument("--no-rules", action="store_true")
-    parser.add_argument("--exclude", nargs="*", default=[])
-    parser.add_argument("-q", "--quiet", action="store_true")
-    args = parser.parse_args(argv)
-
-    root = Path(args.path)
-    if not root.exists():
-        print(f"ERROR: {root}", file=sys.stderr)
-        return 1
-
-    t0 = time.perf_counter()
-    if not args.quiet:
-        print(f"⏳ Parsing: {root}")
-
-    modules = extract_project(root, exclude=args.exclude or None)
-    if not modules:
-        print("ERROR: Brak plików .py.", file=sys.stderr)
-        return 1
-
-    schema = analyze(modules)
-    if args.no_rules:
-        schema.rules = []
-
-    G = build_rich_graph(schema)
-
-    if args.cycles:
-        cycles = detect_cycles(G)
-        if cycles:
-            print(f"\n⚠️  Cykle ({len(cycles)}):")
-            for c in cycles[:5]:
-                print(f"  {' → '.join(c[:5])}")
-        else:
-            print("✅ Brak cykli.")
-
-    if args.graph_summary:
-        print("\n── Graph Summary ──────────────────────")
-        print(graph_summary(G, schema))
-
-    if args.events:
-        em = infer_event_model(modules)
-        print("\n── Event Model ────────────────────────")
-        print(em.summary())
-
-    write_json(schema, Path(args.out))
-    if args.proto:
-        write_proto(schema, Path(args.proto))
-    if args.md:
-        write_markdown(schema, Path(args.md))
-    if args.graphml:
-        write_graphml(G, Path(args.graphml))
-    if args.dot:
-        write_dot(G, Path(args.dot))
-
-    if not args.quiet:
-        funcs = schema.all_functions()
-        print(
-            f"\n✅ Gotowe ({time.perf_counter()-t0:.2f}s)\n"
-            f"   Modules  : {len(modules)}\n"
-            f"   Functions: {len(funcs)}\n"
-            f"   Queries  : {len(schema.queries())}\n"
-            f"   Commands : {len(schema.commands())}\n"
-            f"   Orchest. : {len(schema.orchestrators())}\n"
-            f"   Workflows: {len(schema.workflows)}\n"
-            f"   Rules    : {len(schema.rules)}\n"
-            f"   Graph    : {G.number_of_nodes()}N / {G.number_of_edges()}E\n"
-            f"   → {args.out}"
-        )
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())