cohzen 0.2.0__py3-none-any.whl

cohzen-0.2.0.dist-info/METADATA

@@ -0,0 +1,295 @@
+Metadata-Version: 2.5
+Name: cohzen
+Version: 0.2.0
+Summary: Fast, static scanner for LangGraph architectures: detecting compiled graphs, agents, and routing edges.
+Author-email: Cohzen <dev@cohzen.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ast-scanner,cli,langchain,langgraph,static-analysis
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# `cz` (Cohzen CLI)
+
+**`cz`** statically reconstructs existing **LangGraph** applications' architecture and emits an immutable, machine-readable system manifest (**Cohzen Manifest v0.1**).
+
+> **Core Philosophy**: *"Cohzen reconstructs what can be determined statically from the codebase with zero runtime execution."*
+
+Everything in Cohzen flows through a single unified pipeline:
+
+```text
+Repository ──► AST ──► Discovery ──► Resolution ──► CohzenManifest (v0.1)
+                                                           │
+                     ┌───────────────────┬─────────────────┴─────────────────┐
+                     ▼                   ▼                                   ▼
+              Terminal / Flow      Mermaid Diagram                   Browser Visualizer
+              (`cz scan`)         (`cz scan --mermaid`)             (`cz view`)
+```
+
+And **`cz audit`** consumes the exact same discovered AST facts to perform in-depth observability and telemetry health audits without redefining architecture.
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install cohzen
+# or with uv:
+uv add cohzen
+```
+
+*Note: Once installed, both `cz` and `cohzen` commands are available.*
+
+---
+
+## 🏗️ Production-Grade Modular Architecture
+
+The repository is organized into distinct, enterprise-grade domain packages:
+
+```
+cohzen/
+├── .github/                       # CI/CD workflows & issue templates
+│   ├── workflows/                 # GitHub Actions (tests.yml, release.yml)
+│   ├── ISSUE_TEMPLATE/            # Bug report & feature request templates
+│   └── pull_request_template.md   # Pull request checklist & guide
+│
+├── docs/                          # Comprehensive technical documentation
+│   ├── architecture.md            # Static AST pipeline & engine architecture
+│   ├── manifest.md                # CohzenManifest v0.1 JSON specification
+│   ├── supported-frameworks.md    # Framework & LLM detector matrix
+│   └── development.md             # Contributor quickstart & testing guidelines
+│
+├── examples/                      # Runnable standalone LangGraph examples
+│   ├── langgraph-basic/           # ProcessState pipeline with MemorySaver
+│   ├── langgraph-tools/           # MessagesState agent with ToolNode & lambda routing
+│   └── langgraph-routing/         # Supervisor team with conditional routing & interrupts
+│
+├── src/cz/
+│   ├── cli/                       # Modern CLI application (`main.py`, Typer app)
+│   ├── scanner/                   # Core AST scanner engine, visitor, and models
+│   │   ├── engine.py              # Repository scan orchestrator
+│   │   ├── visitor.py             # Unified AST visitor & symbol resolver
+│   │   ├── utils.py               # AST string & expression extractors
+│   │   └── models.py              # Internal AST scan models & telemetry types
+│   │
+│   ├── manifest/                  # Immutable Cohzen Manifest v0.1 Contract
+│   │   ├── schema.py              # CohzenManifest, GraphDef, NodeDef, ToolDef, ModelDef
+│   │   └── builder.py             # Deterministic Manifest compilation
+│   │
+│   ├── detectors/                 # Static AST pattern detectors
+│   │   ├── base.py                # BaseFrameworkScanner & BaseLLMDetector protocols
+│   │   ├── langgraph/             # LangGraph framework detector (StateGraph, nodes, edges)
+│   │   ├── llm/                   # Frozen v0.1 LLM provider detectors (OpenAI, Anthropic, Google, etc.)
+│   │   └── tools/                 # Tool detector (@tool decorators, line spans)
+│   │
+│   ├── audit/                     # Observability & telemetry governance engine
+│   │   ├── engine.py              # Audit orchestrator
+│   │   ├── registry.py            # Observability detector registry
+│   │   └── [providers]/           # LangSmith, Langfuse, Phoenix, Traceloop, AgentOps, etc.
+│   │
+│   └── formatters/                # Presentation & serialization
+│       ├── console.py             # Rich architecture & audit flow reports
+│       ├── mermaid.py             # LangGraph-compatible Mermaid flowchart
+│       ├── json_fmt.py            # Cohzen Manifest JSON serializer
+│       └── viewer.py              # Interactive dark-mode HTML browser visualizer
+│
+└── tests/
+    ├── fixtures/                  # Real-world & sample test fixtures
+    │   ├── real_world/            # 10 production-pattern test projects
+    │   └── sample_graphs/         # Specialized graph variations
+    └── test_*.py                  # Automated test suites
+```
+
+---
+
+## 🔍 CLI Command Hierarchy
+
+| Command | Domain | Description |
+|---|---|---|
+| **`cz scan [path]`** | **Architecture Discovery** | Reconstructs graphs, nodes, edges, models, tools, and checkpointer persistence. Emits terminal flow or **`CohzenManifest`** JSON. |
+| **`cz audit [path]`** | **Observability Audit** | Audits telemetry packages, `.env` configurations, and node-by-node / tool-by-tool instrumentation attribution. |
+| **`cz view [path]`** | **Visualization Shortcut** | Convenience alias for `cz scan --view` to launch the interactive browser visualizer. |
+| **`cz version`** | **System Info** | Displays the installed `cz` release version. |
+
+### 1. Architecture Discovery (`cz scan`)
+
+```bash
+# Clean high-signal terminal report
+cz scan .
+
+# Emit the official Cohzen Manifest v0.1 JSON
+cz scan . --json
+
+# Export to Mermaid Diagram
+cz scan . --mermaid -o architecture.mmd
+
+# Launch dark-mode interactive web visualizer
+cz scan . --view
+# or shortcut:
+cz view .
+```
+
+### 2. Observability & Telemetry Audit (`cz audit`)
+
+```bash
+# Terminal telemetry audit with active tool attribution
+cz audit .
+
+# Export audit findings and coverage as JSON for CI/CD gates
+cz audit . --json
+```
+
+---
+
+## 📜 The Cohzen System Manifest (v0.1)
+
+The manifest is the **immutable, machine-readable contract** produced by `cz scan --json`. Discovered entities use stable IDs, standardized `SourceLocation`, and explicit resolution tracking:
+
+```json
+{
+  "version": "0.1.0",
+  "metadata": {
+    "target": ".",
+    "files_scanned": 14,
+    "files_skipped": 0,
+    "parse_errors": 0,
+    "unresolved_symbols": 0,
+    "dynamic_constructions": 0,
+    "scan_duration_ms": 2.14,
+    "created_at": "2026-09-19T12:00:00Z",
+    "warnings": []
+  },
+  "frameworks": ["langgraph"],
+  "graphs": [
+    {
+      "id": "graph.workflow",
+      "name": "workflow",
+      "framework": "langgraph",
+      "graph_class": "StateGraph",
+      "state_schema": "AgentState",
+      "source": { "file": "app.py", "line_start": 20, "line_end": 20 },
+      "node_ids": ["planner", "tools"],
+      "edges": [
+        { "source": "START", "target": "planner", "edge_type": "direct" },
+        { "source": "planner", "target": "tools", "edge_type": "conditional" }
+      ],
+      "compilation": {
+        "compiled_var": "app",
+        "checkpointer": "MemorySaver",
+        "source": { "file": "app.py", "line_start": 35, "line_end": 35 }
+      }
+    }
+  ],
+  "nodes": [
+    {
+      "id": "planner",
+      "name": "planner",
+      "kind": "node",
+      "handler": "planner_node",
+      "source": { "file": "app.py", "line_start": 10, "line_end": 18 },
+      "model_ids": ["model.openai.gpt-4o"],
+      "tool_ids": ["tool.search_web"],
+      "resolution": { "status": "resolved", "reason": null },
+      "classification": { "role": "agent", "confidence": "high", "evidence": ["llm_invocation", "tool_binding"] }
+    }
+  ],
+  "tools": [
+    {
+      "id": "tool.search_web",
+      "name": "search_web",
+      "source": { "file": "tools.py", "line_start": 5, "line_end": 8 },
+      "docstring": "Searches the web",
+      "resolution": { "status": "resolved", "reason": null }
+    }
+  ],
+  "models": [
+    {
+      "id": "model.openai.gpt-4o",
+      "provider": "openai",
+      "name": "gpt-4o",
+      "source": { "file": "app.py", "line_start": 12, "line_end": 12 }
+    }
+  ]
+}
+```
+
+---
+
+## 🎯 Features Detected
+
+| Domain | Provider / Tool | Capabilities Detected |
+|---|---|---|
+| **Frameworks** | **LangGraph** | `StateGraph`, `Graph`, `MessageGraph`, `.compile()` call sites, checkpointers (`MemorySaver`, `SqliteSaver`), human-in-the-loop interrupts (`interrupt_before`, `interrupt_after`), `store`, nodes, direct & conditional edges, `ToolNode` |
+| **LLMs & Tool Bindings** | **OpenAI** | `chat.completions.create`, model identification, `tools=[...]`, `functions=[...]` |
+| | **Anthropic** | `messages.create`, model identification, `tools=[...]` |
+| | **Google** | `generate_content`, `generate_text`, model identification, `tools=[...]` |
+| | **Groq** | Groq client chat completions, models, `tools=[...]` |
+| | **Grok** | xAI Grok chat completions, models |
+| | **LangChain** | `.invoke()`, `.ainvoke()`, `.stream()`, `model.bind_tools(tools)` |
+| | **LiteLLM** | `completion()`, `acompletion()`, models, `tools=[...]` |
+| **Observability (`cz audit`)** | **LangSmith** | Package manifests, `LANGCHAIN_TRACING_V2`, `@traceable` |
+| | **Langfuse** | Package manifests, `LANGFUSE_*`, `@observe` |
+| | **OpenTelemetry** | `opentelemetry-*`, `openinference-*`, `OTEL_*` |
+| | **Arize Phoenix**| `arize-phoenix`, `phoenix`, `PHOENIX_*` |
+| | **Traceloop** | `traceloop-sdk`, `TRACELOOP_*` |
+| | **AgentOps** | `agentops`, `AGENTOPS_API_KEY`, `@track_agent` |
+| | **W&B Weave** | `wandb`, `weave`, `@weave.op()` |
+
+---
+
+## 🔬 How `cz` Performs the Scan
+
+1. **Zero-Execution Static AST Parsing**: `cz` never executes target code or imports unverified packages. It parses Python source trees into Abstract Syntax Trees using Python's native `ast` standard library.
+2. **Registry-Driven Plugin Dispatch**: A unified AST visitor visits syntax nodes and dispatches them in parallel to modular registries:
+   - **Framework Scanners**: Trace graph instantiations (`StateGraph`), node registrations (`add_node`), edge links (`add_edge`, `add_conditional_edges`), and compilation points (`compile(checkpointer=...)`).
+   - **LLM Detectors**: Inspect function bodies for LLM client invocations, model parameters, and tool binding calls.
+   - **Observability Detectors**: Cross-reference decorator names, package manifests (`pyproject.toml`, `requirements.txt`, `Pipfile`), and environment variable configs (`.env`).
+3. **Multi-Scope Cross-Referencing**: Connects graph nodes to their corresponding agent implementations and tool executions, resolving same-file definitions before repository-wide fallbacks.
+4. **Multi-Format Synthesis**: Formats the unified `ScanResult` into:
+   - Rich interactive terminal dashboards with ASCII/Unicode flowcharts
+   - Native LangGraph Mermaid diagrams
+   - Interactive browser visualizer
+   - Automated JSON payloads for CI/CD gates
+
+---
+
+## 🧪 Testing
+
+Run all 56 modular unit, integration, and real-world fixture tests:
+```bash
+pytest tests/ -v
+```
+
+Includes 10 real-world architectural fixture projects under `tests/real_world_fixtures/`:
+- `01_single_file.py`: Monolithic graph definition
+- `02_graph_split_across_modules/`: Nodes and state split across files
+- `03_multiple_graphs/`: Separate supervisor and worker graphs
+- `04_imported_nodes/`: Third-party and cross-package node handlers
+- `05_imported_tools/`: Tools imported from external helper modules
+- `06_factory_created_graph/`: Builder functions returning compiled StateGraphs
+- `07_conditional_routing/`: Multi-branch conditional edges
+- `08_toolnode_and_bind_tools/`: LangGraph `ToolNode` and LLM `bind_tools`
+- `09_subgraphs/`: Parent graphs embedding child workflow nodes
+- `10_dynamic_or_partially_unresolvable/`: Dynamic lambdas and unresolvable imports with graceful degradation
+
+Run test coverage report (92%+ coverage):
+```bash
+pytest --cov=cz --cov-report=term-missing tests/
+```
+

cohzen-0.2.0.dist-info/RECORD

@@ -0,0 +1,74 @@
+cz/__init__.py,sha256=jDOrEDWy7F6iJCyM9ut4znF_LhxUI69WGP1RGgxUNN0,550
+cz/audit/__init__.py,sha256=HXNj7NRPRsK_tmTnSpA-OtzAgSxQ45HWA9LqqivaOs4,495
+cz/audit/base.py,sha256=I-Pj2_BP3RfNnfPW3o9nUTyr1LfumIxlqJT3BL4QDXM,1192
+cz/audit/engine.py,sha256=D4xjBYPbw4e5GCBYDzXacjLjPsWUHCswFx6W6z4c09g,2135
+cz/audit/registry.py,sha256=n3qlXve8t6i2HsYpvxvmiLmIKgSeFjSHOY_PmlJ3itE,7400
+cz/audit/agentops/__init__.py,sha256=k2AdjR4um4ROfSejJJwFEiDwt50oRNqlNkEktQnIUhw,128
+cz/audit/agentops/detector.py,sha256=yWVLhSxT9UkmCcXrn5BiRcbxZNqaeeVd0GMd5MSJXPI,1190
+cz/audit/arize_phoenix/__init__.py,sha256=7laKbDLjwN8t5WGan-b88ol2_sS51647IFh0ef5wmcQ,146
+cz/audit/arize_phoenix/detector.py,sha256=SR34EYWr8jIDe1CFO8tirmucN85Pp9IVDJg6p8OvdYk,1254
+cz/audit/langfuse/__init__.py,sha256=_OueDLVGYeW5VNyGT2dbHyqKwxFrr2OsF1n2cI1DU4I,128
+cz/audit/langfuse/detector.py,sha256=Mj3V2eO6i-r_FtCCitsSNSRwJkRaPSL1-BYLAEN7Ymw,1216
+cz/audit/langsmith/__init__.py,sha256=429LIXfFjMJB_KlOXTdCPfz3hpYcLjhTpaVTuPicmBQ,132
+cz/audit/langsmith/detector.py,sha256=O-NVlus091zyjF2PLoy0EbqNUqnxwrSMXuXLL9FwCDw,1243
+cz/audit/opentelemetry/__init__.py,sha256=7R4Wk18JzNgWi4Y8veQvh4uPcB11qW6LHzoVNDr0aOA,148
+cz/audit/opentelemetry/detector.py,sha256=voQHNm1HMf_yuRxisSgOUjmx4MIApC4CBtDbgeU_X00,1700
+cz/audit/traceloop/__init__.py,sha256=GJONreTVrtfYRRo783th5Gjbgw3XiV0nEmdo_w0Ws2M,132
+cz/audit/traceloop/detector.py,sha256=sKn8D-qZLNRBuovYUsfajyz8wqTTWQY3olT8DaSmEHg,1231
+cz/audit/wandb/__init__.py,sha256=X39UERAgYxnyULQeMlUVVm01RW0XzepvRDarfFAkOiY,120
+cz/audit/wandb/detector.py,sha256=u4y190D1-CFmAqlo57_0Dm06GLt8xjFRAwT7M6UfIwU,1191
+cz/cli/__init__.py,sha256=WIM1Rh7ttu-2L4eP86KxurTOXMvp0SQ1JWHhq3dOjEw,88
+cz/cli/main.py,sha256=wpkQdJ-okt7Bva-5CG27SeieMpwoQxI6QOi2XAPIKm4,27069
+cz/detectors/__init__.py,sha256=a2N87Hh3vouJ7IAqMKCwk3jQRZd3weDOleYL751ZhjY,581
+cz/detectors/base.py,sha256=ymbfks0c7NhUyVYNF0OR6-BCbtSH15Pr9ChnXPp_pGI,2253
+cz/detectors/registry.py,sha256=1odfqL53xVo0_TE1b5NZSa7PztNKxMXNjSHWZTDev8c,816
+cz/detectors/langgraph/__init__.py,sha256=e5QXIbFXiv75899Wkn2bLdTl9l4bHKFWqznov9hFx9Q,130
+cz/detectors/langgraph/scanner.py,sha256=4wKa66S6mGeYjiyNg7C7btzv79g9v2fYHfKWgXANdbg,13234
+cz/detectors/llm/__init__.py,sha256=tG8UhHKvD8XCuid_iVRLgdp-zBIbI8_zgyQzfdwoANI,170
+cz/detectors/llm/base.py,sha256=XkPed9pdAF3HzDt_qMExTsMDUjrL3j1ixitmu61ZXco,962
+cz/detectors/llm/registry.py,sha256=fO_5vGzaXDOPuHfbUAk0FrQYZTVg7hpsj1igDi1KvzQ,1739
+cz/detectors/llm/anthropic/__init__.py,sha256=-HCdtcZ3uORCjbVFy2PksXFHehsrfqzeowyFLKyB-WA,139
+cz/detectors/llm/anthropic/detector.py,sha256=x7c5aWXN0bNmByKE4GNoo16NX_WSDfd1Tr4Zym2NFvE,1620
+cz/detectors/llm/google/__init__.py,sha256=OFzF5BZ38owV79Ae4WY4h2mvV9MYEMQcNo2cnIxgWY4,127
+cz/detectors/llm/google/detector.py,sha256=BVAfPlP8-6K7CeUS05rnhQOCS6ze2gbSEB7qbaU-whU,1744
+cz/detectors/llm/grok/__init__.py,sha256=C53QJD0O26lWZZgWh3aph-XB59VanYBmzP2MvanicMs,123
+cz/detectors/llm/grok/detector.py,sha256=cnrlqmd8Q1b-Zu3sF5vsluSBPvFkg8lcSB4DfNyyirI,1613
+cz/detectors/llm/groq/__init__.py,sha256=_GUKV_BRUOPpVcodBZok4oCnd6hQTbQmradopBRksLQ,119
+cz/detectors/llm/groq/detector.py,sha256=VJn3DVyeiOMdy2jqCaH-pDu-xWw5TXLIkLj5RCrF-JM,1688
+cz/detectors/llm/langchain/__init__.py,sha256=p7g3rhWBT9Y53Fxis6VcyH7BT1FRoWgRj3Bbyj_IoYc,145
+cz/detectors/llm/langchain/detector.py,sha256=xkcOg0mjhNXQkGDUd0QXvSJ_SwMWnnv-NU7-fW21xR8,2426
+cz/detectors/llm/litellm/__init__.py,sha256=bsRgv6lmhNPjN_5UKU6fE82TfJa_ct3TdIEQMud_8Uw,127
+cz/detectors/llm/litellm/detector.py,sha256=CAo3bOk4EuWQf0RYFC5Nkjguiw7nGMJ-H5EDd1VQ4DA,1649
+cz/detectors/llm/openai/__init__.py,sha256=8iNeXeM0aN_dHyHk6teQv4bU33_hmuwKL7yRzGcTCMA,127
+cz/detectors/llm/openai/detector.py,sha256=kiMLjxuSEwfQWjVbDxzrGh3b-KyhxETjiefgBkdKyfw,1614
+cz/detectors/tools/__init__.py,sha256=kKf7jy3iyNXdE3rkCTzWtju0X9HgVatnGY5aR962a3Q,115
+cz/detectors/tools/detector.py,sha256=6pTBnHJbIIuyNpdLDtw-dJEVn52lCMO2GG7nnAnyATA,1667
+cz/execution/__init__.py,sha256=MJ7qq69ghA5upO9z7L9bVL7PQ8JO-_37Jxzz9ZZYHOE,1183
+cz/execution/callbacks.py,sha256=bET9wL0qINMh3aylHodaqea2bKtURjOpK7eF7btSAf8,16641
+cz/execution/context.py,sha256=m9LbnTNf--93Po1lUVluIMFuLLyZhJjIBV49uBa8_ho,8897
+cz/execution/debugger.py,sha256=e12uyRyBZRaAmJGobFaP5Vb_3CPWeNHvrGisBTAVcV4,20115
+cz/execution/instrumentation.py,sha256=f33bleCWN1zmbIrbO0ItI_2m2ua7lGQ5fkvXnLJbG7k,18401
+cz/execution/manifest_matcher.py,sha256=g4CEkBLxYuIYSRxRPNt5OV7Ih9LH0mWNcvK8NRuPMd8,3342
+cz/execution/models.py,sha256=nanJ60WjSwcTiAwfeBfB0WaRH6MAQgUmC0WSMsSvoeU,4252
+cz/execution/processor.py,sha256=uzRGS8oT7mNcYpp09HoK0b8qXZOggRe51xKnEeJPK3s,2383
+cz/execution/serializer.py,sha256=XKu_Rbc4Onbzy5eLnfbWgrobDSDUBIcx4pvT1bJugrw,6111
+cz/execution/sqlite.py,sha256=R8NHdJ7ZcyJH97xNPQWe2IS_-b3IOtbKD5DHH6XY6w4,16111
+cz/execution/store.py,sha256=byV6l2jHBf_DllPxwPtbBFHr1Qu4KUA-O4fskbfP2sM,2082
+cz/formatters/__init__.py,sha256=URJGeqeocGVNVm0W8Wn6u2KOlVKd1uYNUDLgvHP2lyA,365
+cz/formatters/console.py,sha256=JT9eWne-Uzwhh88P8lTRn17a-y6dsRe2C8iBtgDKrtE,29702
+cz/formatters/execution_fmt.py,sha256=pOzEEJwNNmGdbpkMBvEaqhjJ5edsuT-EqubjzDzjcuY,17797
+cz/formatters/json_fmt.py,sha256=N1aQ5YMHflMziDRklntSMfTz3fZ1JhVydNPKtc7eg44,562
+cz/formatters/mermaid.py,sha256=Vx9XOr5dq4NqQJfliMBCpZDNCOVDJPbeX0lQumzbi6s,10651
+cz/formatters/viewer.py,sha256=LoWucZbTqLVqZlKd83lGv_sv4fX1g7IM6tTo-4hIakc,23157
+cz/manifest/__init__.py,sha256=KkOXAEqS2dsqAB_a8aWaYmaBpUXdqJ6EqHO05q7q9xU,488
+cz/manifest/schema.py,sha256=0z2gFa1BynEgkzT07fp2RsMslwVDmQttk1QLTuURkgo,9271
+cz/scanner/__init__.py,sha256=eGKeTyLuC2ZfvkGEVMoKEMPp6T-D0jMxIIWQ4jEn-8M,830
+cz/scanner/engine.py,sha256=MVQk9oJ84kr_uoeQyK_5UXMY4sdFw2kxGGWdkn6-ipU,8013
+cz/scanner/models.py,sha256=WIvBd3PpoP1-v_1XgPguwhFso5Z3Lv77n4zUB1fSeIQ,23702
+cz/scanner/utils.py,sha256=S6r8eAYLh0g8BW0PZjCbxDVOf9Qo6ecMcK1v-f1zGEI,2980
+cz/scanner/visitor.py,sha256=DO2NFTDSYvbFsWdTJxm5WafJQn_3IWU2FruHmHzbmfQ,13940
+cohzen-0.2.0.dist-info/METADATA,sha256=DuPgFU_WzukxeZ-U1yVldB-nSy1Qqd529neBKAJkDF8,13203
+cohzen-0.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+cohzen-0.2.0.dist-info/entry_points.txt,sha256=VnJoJszmDaJ5zBZQAzI7VufvD7xObK78f3947682sQ4,64
+cohzen-0.2.0.dist-info/licenses/LICENSE,sha256=1Rdm6nomRg4OoJxxYWStrIHWjpDagvfdx28FCj0puCg,1063
+cohzen-0.2.0.dist-info/RECORD,,

cohzen-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

cohzen-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+cohzen = cz.cli.main:app
+cz = cz.cli.main:app

cohzen-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cohzen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cz/__init__.py

@@ -0,0 +1,28 @@
+"""cz - Cohzen CLI & Runtime Observability Engine."""
+
+from cz.execution import execution_scope, observe, record_reason, span_scope, track
+from cz.execution.debugger import run_isolated_node
+
+__version__ = "0.2.0"
+
+# Auto-activate tracking when cz is imported
+try:
+    track()
+except Exception:
+    pass
+
+# Aliases
+reason = record_reason
+debug_node = run_isolated_node
+
+__all__ = [
+    "__version__",
+    "observe",
+    "track",
+    "execution_scope",
+    "span_scope",
+    "record_reason",
+    "reason",
+    "debug_node",
+    "run_isolated_node",
+]

cz/audit/__init__.py

@@ -0,0 +1,21 @@
+"""Observability and governance audit subpackage."""
+
+from cz.audit.base import BaseObservabilityDetector
+from cz.audit.engine import (
+    AuditEngine,
+    audit_observability,
+    audit_repository,
+    scan_env_files,
+    scan_manifest_files,
+)
+from cz.audit.registry import ObservabilityRegistry
+
+__all__ = [
+    "AuditEngine",
+    "BaseObservabilityDetector",
+    "ObservabilityRegistry",
+    "audit_observability",
+    "audit_repository",
+    "scan_env_files",
+    "scan_manifest_files",
+]

cz/audit/agentops/__init__.py

@@ -0,0 +1,5 @@
+"""AgentOps observability detector."""
+
+from cz.audit.agentops.detector import AgentOpsDetector
+
+__all__ = ["AgentOpsDetector"]

cz/audit/agentops/detector.py

@@ -0,0 +1,34 @@
+"""AgentOps observability provider detector."""
+
+from __future__ import annotations
+
+import re
+from typing import List, Optional
+from cz.scanner.models import ObservabilityPackage
+
+
+class AgentOpsDetector:
+    def __init__(self) -> None:
+        self.provider_id = "agentops"
+        self.display_name = "AgentOps"
+        self.category = "Agent Monitoring & Replay"
+
+    def check_manifest(self, manifest_content: str, filename: str) -> Optional[ObservabilityPackage]:
+        pattern = r"(?i)(?:^|[\"'\s,])(agentops)(?:\[[^\]]*\])?([><=~!].*)?(?:$|[\"'\s,\n])"
+        match = re.search(pattern, manifest_content, re.MULTILINE)
+        if match:
+            version_spec = match.group(2).strip() if match.group(2) else None
+            return ObservabilityPackage(
+                name=self.display_name,
+                provider_id=self.provider_id,
+                category=self.category,
+                source_file=filename,
+                version_spec=version_spec,
+            )
+        return None
+
+    def get_known_env_vars(self) -> List[str]:
+        return ["AGENTOPS_API_KEY"]
+
+    def get_known_decorators(self) -> List[str]:
+        return ["record_action", "track_agent"]

cz/audit/arize_phoenix/__init__.py

@@ -0,0 +1,5 @@
+"""Arize Phoenix observability detector."""
+
+from cz.audit.arize_phoenix.detector import ArizePhoenixDetector
+
+__all__ = ["ArizePhoenixDetector"]

cz/audit/arize_phoenix/detector.py

@@ -0,0 +1,34 @@
+"""Arize Phoenix observability provider detector."""
+
+from __future__ import annotations
+
+import re
+from typing import List, Optional
+from cz.scanner.models import ObservabilityPackage
+
+
+class ArizePhoenixDetector:
+    def __init__(self) -> None:
+        self.provider_id = "arize_phoenix"
+        self.display_name = "Arize Phoenix"
+        self.category = "LLM Observability & Tracing"
+
+    def check_manifest(self, manifest_content: str, filename: str) -> Optional[ObservabilityPackage]:
+        pattern = r"(?i)(?:^|[\"'\s,])(arize-phoenix|phoenix)(?:\[[^\]]*\])?([><=~!].*)?(?:$|[\"'\s,\n])"
+        match = re.search(pattern, manifest_content, re.MULTILINE)
+        if match:
+            version_spec = match.group(2).strip() if match.group(2) else None
+            return ObservabilityPackage(
+                name=self.display_name,
+                provider_id=self.provider_id,
+                category=self.category,
+                source_file=filename,
+                version_spec=version_spec,
+            )
+        return None
+
+    def get_known_env_vars(self) -> List[str]:
+        return ["PHOENIX_API_KEY", "PHOENIX_COLLECTOR_ENDPOINT", "PHOENIX_PROJECT_NAME"]
+
+    def get_known_decorators(self) -> List[str]:
+        return ["trace"]

cz/audit/base.py

@@ -0,0 +1,37 @@
+"""Base protocol for observability and telemetry tool plugins."""
+
+from __future__ import annotations
+
+from typing import List, Optional, Protocol
+from cz.scanner.models import ObservabilityPackage
+
+
+class BaseObservabilityDetector(Protocol):
+    """Protocol for an observability tool detector."""
+
+    @property
+    def provider_id(self) -> str:
+        """Internal provider identifier (e.g. 'langsmith', 'langfuse')."""
+        ...
+
+    @property
+    def display_name(self) -> str:
+        """Human-readable display name (e.g. 'LangSmith', 'Langfuse')."""
+        ...
+
+    @property
+    def category(self) -> str:
+        """Category (e.g. 'LLM Tracing & Evaluation', 'Distributed Tracing')."""
+        ...
+
+    def check_manifest(self, manifest_content: str, filename: str) -> Optional[ObservabilityPackage]:
+        """Check if this tool's package is listed in a dependency manifest."""
+        ...
+
+    def get_known_env_vars(self) -> List[str]:
+        """List of environment variable keys associated with this tool."""
+        ...
+
+    def get_known_decorators(self) -> List[str]:
+        """List of AST decorator names indicating tracing (e.g. 'traceable', 'observe')."""
+        ...

cz/audit/engine.py

@@ -0,0 +1,65 @@
+"""Audit engine evaluating repository observability and governance posture."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import List, Tuple
+from cz.scanner.models import (
+    AgentDef,
+    ObservabilityAudit,
+    ObservabilityPackage,
+    ToolDef,
+)
+from cz.audit.registry import ObservabilityRegistry
+
+
+class AuditEngine:
+    """Engine executing observability audits against repositories and discovered components."""
+
+    def __init__(self, registry: ObservabilityRegistry | None = None) -> None:
+        self.registry = registry or ObservabilityRegistry()
+
+    def scan_manifests(self, repo_path: Path) -> List[ObservabilityPackage]:
+        """Scan dependency manifests for known observability tools."""
+        return self.registry.scan_manifests(repo_path)
+
+    def scan_env_files(self, repo_path: Path) -> List[str]:
+        """Scan environment files for known telemetry variables."""
+        return self.registry.scan_env_files(repo_path)
+
+    def audit(
+        self, repo_path: Path, agents: List[AgentDef], tools: List[ToolDef]
+    ) -> ObservabilityAudit:
+        """Perform comprehensive observability audit across manifests, env, and code."""
+        return self.registry.audit(repo_path, agents, tools)
+
+
+_default_audit_engine = AuditEngine()
+
+
+def audit_repository(
+    repo_path: Path, agents: List[AgentDef], tools: List[ToolDef]
+) -> ObservabilityAudit:
+    """Convenience function auditing a repository against detected agents and tools."""
+    return _default_audit_engine.audit(repo_path, agents, tools)
+
+
+def scan_manifest_files(repo_path: Path) -> List[ObservabilityPackage]:
+    """Convenience helper scanning manifests for observability dependencies."""
+    return _default_audit_engine.scan_manifests(repo_path)
+
+
+def scan_env_files(repo_path: Path) -> List[str]:
+    """Convenience helper scanning env files for observability variables."""
+    return _default_audit_engine.scan_env_files(repo_path)
+
+
+audit_observability = audit_repository
+
+__all__ = [
+    "AuditEngine",
+    "audit_observability",
+    "audit_repository",
+    "scan_env_files",
+    "scan_manifest_files",
+]

cz/audit/langfuse/__init__.py

@@ -0,0 +1,5 @@
+"""Langfuse observability detector."""
+
+from cz.audit.langfuse.detector import LangfuseDetector
+
+__all__ = ["LangfuseDetector"]