opencode-arch 1.0.0__py3-none-any.whl

opencode_arch-1.0.0.dist-info/METADATA

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: opencode-arch
+Version: 1.0.0
+Summary: Architecture-aware development tools — extract, validate, and maintain architectural models with token-efficient AI integration
+Project-URL: Homepage, https://github.com/opn-arch/opencode-arch
+Project-URL: Repository, https://github.com/opn-arch/opencode-arch
+Project-URL: Documentation, https://github.com/opn-arch/opencode-arch#readme
+Project-URL: Bug Tracker, https://github.com/opn-arch/opencode-arch/issues
+Author: Anomaly Contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: architecture,ast,code-analysis,llm,mcp,opencode,token-compression
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: architecture-model-standard>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# opencode-arch
+
+**Architecture extraction and validation for Python codebases.**
+
+Mechanically verify that your architecture model matches your code. Compress entire repositories into ~430 tokens for AI agents. Produce training data for LLM fine-tuning.
+
+![PyPI](https://img.shields.io/pypi/v/opencode-arch)
+![Python](https://img.shields.io/pypi/pyversions/opencode-arch)
+![Tests](https://img.shields.io/badge/tests-278%20passing-brightgreen)
+![License](https://img.shields.io/badge/license-MIT-blue)
+
+---
+
+## Why
+
+| Problem | Solution |
+|---------|----------|
+| Architecture docs drift from code | Mechanical representativeness scoring — know exactly when your model is wrong |
+| AI agents burn tokens reading every file | Token arbitrage — full repo AST compressed to ~430 tokens of dense context |
+| No structured architecture data for training | Produces (code, model, metrics) triples ready for fine-tuning |
+| Manual component boundary decisions | Auto-groups modules by import affinity, name prefix, and subdirectory |
+
+## Features
+
+- **Representativeness Scoring** — File coverage, relationship accuracy, boundary coherence, behavioral coverage. Four mechanical sub-scores that tell you if your model is accurate.
+- **Token Arbitrage** — Compress a full repository's AST into a dense context string within any token budget. Agents reason about the whole codebase without reading every file.
+- **Living Documentation** — Components, relationships, behaviors, and event chains extracted directly from code and stored as `.architecture-model.yaml`.
+- **Training Data Export** — Structured triples in `.architecture/` for LLM fine-tuning pipelines.
+
+## Installation
+
+```bash
+pip install opencode-arch
+```
+
+With MCP server support (for AI agent integration):
+
+```bash
+pip install opencode-arch[mcp]
+```
+
+Requires Python 3.11+.
+
+## Quick Start
+
+```bash
+# Launch interactive architecture-aware development
+opencode-arch
+
+# Or target a specific repo
+opencode-arch /path/to/your/repo
+```
+
+This scans the codebase (<1s), loads/bootstraps the architecture model, injects compressed context into your session, and launches OpenCode with full architecture awareness.
+
+```bash
+# One-shot commands also available:
+opencode-arch extract /path/to/repo    # Extract architecture
+opencode-arch export-data              # Export training data
+```
+
+After extraction, your repo contains:
+
+```
+.architecture-model.yaml     # Component model (YAML)
+.architecture/
+├── manifest.json            # Full AST scan (modules, functions, imports)
+└── metrics.json             # Representativeness scores + telemetry
+```
+
+## CLI
+
+| Command | Purpose |
+|---------|---------|
+| `opencode-arch` | **Launch interactive session** (default — scans, injects context, opens OpenCode) |
+| `opencode-arch extract <repo>` | Extract architecture model from a repository |
+| `opencode-arch generate <repo>` | Generate code with test-guided verification |
+| `opencode-arch bench <repo1> <repo2> ...` | Benchmark extraction across multiple repos |
+| `opencode-arch metrics` | View extraction history and scores |
+| `opencode-arch export-data` | Export training corpus (JSONL) |
+
+Options for `extract`:
+
+```bash
+opencode-arch extract /path/to/repo \
+  --budget=4000 \        # Token budget for context compression
+  --focus=all \          # Focus: "all", F-block ID, layer name
+  --target-score=80      # Minimum validation score to accept
+```
+
+## MCP Integration
+
+Register as an MCP server for use with AI coding agents:
+
+```bash
+opencode mcp add
+```
+
+### 9 Tools
+
+| Tool | Purpose |
+|------|---------|
+| `architect_scan` | AST scanning — returns modules, functions, classes, imports |
+| `architect_slice` | Token-compressed context (the core innovation) |
+| `architect_validate` | Structural validation, returns score 0–100 |
+| `architect_extract` | Store validated model + record telemetry |
+| `architect_generate` | Run test suite against generated code |
+| `architect_group` | Auto-group modules into logical components |
+| `architect_check` | Verify representativeness (4 sub-scores) |
+| `architect_require` | Capture functional requirements from conversation |
+| `architect_feedback` | Record corrections, ratings, and training data |
+
+### Typical Agent Workflow
+
+```
+scan → slice → (agent produces YAML) → validate → check → extract
+```
+
+The agent calls `scan` to understand the repo, `slice` to get compressed context, produces an architecture model, then `validate` + `check` gate quality before `extract` persists it.
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────┐
+│  AI Agent (frontier model)                      │
+│  Receives ~430 tokens of compressed context     │
+│  Produces architecture YAML                     │
+└────────────────────┬────────────────────────────┘
+                     │ MCP Protocol
+┌────────────────────▼────────────────────────────┐
+│  opencode-arch (FastMCP server)                 │
+│  scan → slice → validate → check → extract     │
+└────────────────────┬────────────────────────────┘
+                     │
+┌────────────────────▼────────────────────────────┐
+│  architecture-model-standard (library)          │
+│  AST scanning │ YAML parsing │ Validation       │
+│  Context formatting │ Model slicing             │
+└─────────────────────────────────────────────────┘
+```
+
+**Key design decision:** The agent IS the oracle. Tools never call external models — they provide compressed context to the frontier model already in the conversation.
+
+## Benchmarks
+
+Achieved automatically with no human tuning:
+
+| Repository | Modules | Components | Overall Score |
+|------------|---------|------------|---------------|
+| FastAPI | 25 | 9 | 98.1% |
+| Pydantic | 69 | 40 | 98.0% |
+| httpx | 23 | 10 | 96.0% |
+| Requests | 19 | 9 | 94.2% |
+| Flask | 6 | 6 | 100.0% |
+| Celery | 161 | 23 | 84.0% |
+
+Scores are composite representativeness: file coverage × relationship accuracy × boundary coherence × behavioral coverage.
+
+## Training Data
+
+Each extraction produces a structured triple:
+
+```
+(.architecture-model.yaml, manifest.json, metrics.json)
+```
+
+This enables:
+- Fine-tuning models on architecture extraction tasks
+- Evaluating model quality with mechanical ground truth
+- Building datasets across many repositories with `bench`
+
+Export with:
+
+```bash
+opencode-arch export-data --format=jsonl
+```
+
+## Architecture Model Schema
+
+```yaml
+meta:
+  project: my-project
+  schema_version: '1.3'
+entities:
+  components:
+    - id: COMP-1
+      name: APILayer
+      status: ACTIVE
+  capabilities:
+    - id: CAP-F1
+      name: RequestHandling
+      status: ACTIVE
+relationships:
+  - from: COMP-1
+    to: CAP-F1
+    type: realizes
+```
+
+Relationship types: `realizes`, `uses`, `constrains`, `contains`, `triggers`, `depends_on`, `implements`, `exposes`.
+
+## Development
+
+```bash
+git clone https://github.com/anomalyco/opencode-arch
+cd opencode-arch
+pip install -e ".[dev]"
+pytest tests/ -v  # 278 tests, ~20s
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT

opencode_arch-1.0.0.dist-info/RECORD

@@ -0,0 +1,65 @@
+opencode_arch/__init__.py,sha256=rwL_T7LJN36rru7FDlZ5KhoKoMLrVPKbxk5yi4apas8,110
+opencode_arch/artifacts/__init__.py,sha256=137hqiGyGgGPbe58U-PI_ttvkeBc4ro01NT2zDL2tE0,1443
+opencode_arch/artifacts/context.py,sha256=NI69ZrvW2NWaAx_UU8faXb-ePgpSdT5ET4jLltZqBsQ,16517
+opencode_arch/artifacts/diagrams.py,sha256=rdrDfrPpFrHQcsJf3JjhduuP26UTLMnRi2PqdT3KZCY,15973
+opencode_arch/artifacts/selector.py,sha256=n40_n8_XrATI1RIBtrDYwEyWBqbdZ7xdcP76tVvDfWo,10246
+opencode_arch/artifacts/templates.py,sha256=wEFuB3LhtLS4Jb6E3ZmogArzQ97sNeaXIzCP_LyyQLo,16462
+opencode_arch/cli/__init__.py,sha256=CX2aEL7PXFBgMlUZ_7_3ij6C9PqhUxHT9-U0D4IGww8,29
+opencode_arch/cli/bench.py,sha256=DUJ3-Ahopeppd6AsNE--neQFK64gbXwhKTh9KITbTHg,714
+opencode_arch/cli/calibrate.py,sha256=-mGFKduDmUptmsBcx115vkfjKk96hpMDK9ctAZzHI_c,7848
+opencode_arch/cli/confidence.py,sha256=wtPypVPtA1At184VxmJNMPj7qMzKGxLPL6G6iVGAtZI,2482
+opencode_arch/cli/docs.py,sha256=gfUEpBY2JSaZBzc0Ef78oLpUb2p7d3R8FaThoH46qo4,10822
+opencode_arch/cli/docs_validator.py,sha256=A_jrAdcEDUu2DUCfUkYp6Mwb-Lt4RpDmqULPrJQk0k0,10157
+opencode_arch/cli/export_data.py,sha256=sVV50K0pKMzGFW8o4z_f2TnIpRncyPekXLXMqCcO6vY,4872
+opencode_arch/cli/extract.py,sha256=6OKHUY5JM41oQbYbqJi89HrNKC_5xFy6SC2HSpSBjSY,2620
+opencode_arch/cli/gap_analyzer.py,sha256=JQvvwDATJd4qgUILVXL3gUTvwDX_ULAC2A-IiWAzrww,4204
+opencode_arch/cli/generate.py,sha256=cn5P-4ZWwiGDJoYdSjXgm6BHt14r24NJxnknsJdLXe8,2292
+opencode_arch/cli/launch.py,sha256=7zQ-EVMTh3CRNZ0vUigqaUFnpQ7oy8wUMLcT0icipZ4,10019
+opencode_arch/cli/main.py,sha256=xjcnptqaiMj9bj_nhvMb-LKf4wdie4HwQ8U-lsrxtA4,17168
+opencode_arch/cli/metrics.py,sha256=5T_5sgCt-lk-ROGNxWUDLbNbEQCe1YhsiIUKzcGGd9A,6861
+opencode_arch/cli/prompts.py,sha256=qzmuiaTjTdcAd-i3n6lcIbipCH0DGaB-FHPJMEIobQ8,672
+opencode_arch/cli/regen_loop.py,sha256=ldxE8h055MChRv4wkEeBHPEf2M9GdaVkxYMUTdJZD3g,38060
+opencode_arch/context/__init__.py,sha256=tXOcYETE5tcVFoj9m0MuagjzK60iksfXfHxQPG0f6z0,655
+opencode_arch/context/formatter.py,sha256=yjlH4uLE7c7hMlhSPDNIMyJWcLrOdUBkgBcmv4b-6Io,17951
+opencode_arch/context/pipeline_bridge.py,sha256=3RnJlRXHQTr-pp01RhtZ9DEoSqJhW5yEjSvGyfS75fs,6742
+opencode_arch/extract/__init__.py,sha256=dLtkUn6fPcqxGBX9H660j7Bne8hcdt4xcDgxTPRAqBQ,226
+opencode_arch/extract/constraint_detector.py,sha256=TJLGg1YhDCg140qnyrb3kYyYUYg_3aTaLBpuYMRgP8Y,12477
+opencode_arch/extract/from_artifacts.py,sha256=E122lUj8aOC88TvTpvosnrAp8dLU-M1lNLfScvxpa54,27888
+opencode_arch/extract/from_code.py,sha256=8Ch2POLeh85_w-HdBXYI8Dx5CAAhV_t0nwsw499CwzI,22027
+opencode_arch/extract/route_detector.py,sha256=zobq8Q22-mj10o0MnxT3pkHs_D_c-C8SUZZCeJQWBi0,13454
+opencode_arch/extract/table_parser.py,sha256=h8k4l2h0EnwrAghgCD5cHPxEV1koOT4WRnj5sawZcLo,5932
+opencode_arch/learning/__init__.py,sha256=73VgSlFoKGjmWLlbORZ6eSsU85GsU4avUa0AaHG0jRE,688
+opencode_arch/learning/adapter.py,sha256=kV-R8odtC20B0TPUtuqCRPpo4jUUx4EkLztMPvvf_RQ,6397
+opencode_arch/learning/assessor.py,sha256=9WSF5k1hLiv4GJJ1jVEaCnLOabS1szBsNuDAyImrJ4M,5765
+opencode_arch/learning/classifier.py,sha256=b3YZi_svO6_gQWGw7IsOqgmBtuWa-TcV02wcf2CMpIM,5795
+opencode_arch/learning/lessons.py,sha256=xabq9MuvI03W5qVE-2h-LIWnCEMH7Vn70Kr-YIBXPgA,5335
+opencode_arch/learning/maintainer.py,sha256=SYQjsv2cwfCoG-vNEeorIFiysblXnbu2QeaUoEgcn44,10402
+opencode_arch/learning/patterns.py,sha256=lxE5Zyx99lSjXBxzaE8OSPWq9-dOBGzc45DN9WGrXQY,2480
+opencode_arch/mcp/__init__.py,sha256=uVqMFWDM_XgiNGNpKVuwGV5DuWxBIRq68n_Mpk7bbm4,41
+opencode_arch/mcp/__main__.py,sha256=kXtbEmog7XsEiNHTlFK9BSTHwL1n0d1Ge6i8gkLa_NE,252
+opencode_arch/mcp/server.py,sha256=3z59-qZGVaZTxHZpEmHoxV4p30py6mmBTx2W-SEYV64,7369
+opencode_arch/mcp/tools/__init__.py,sha256=fg4O3SwAivyWG4uxkVbD3mv89bnC9JXzmbiu_CFx18w,32
+opencode_arch/mcp/tools/check.py,sha256=ECqVRThM1bjNXmMik0pRUM0Q-7iLMGz9IpX9oGcUsQk,6127
+opencode_arch/mcp/tools/extract.py,sha256=-o5o6NQVXa3cwjX_-erxMUIgP3zXDUofaKNZVEmk6Mw,3673
+opencode_arch/mcp/tools/feedback.py,sha256=9Z4n6IBHc2FZmxeUkhPQviN91potJytj8ZOQeqCqgqk,1969
+opencode_arch/mcp/tools/generate.py,sha256=78l8a8UAtiAuzSg15IkLSom41WF5NeiepFTQ-7JL-M4,3373
+opencode_arch/mcp/tools/group.py,sha256=8cxjD-vOB3m5zNp-vh4_iqUAgLF20PZtmYshS9V18-o,2102
+opencode_arch/mcp/tools/ingest.py,sha256=t7rtri4v8la_ZsI2qZv4Z3BUf--Qebe5_SbVyQPJqDg,3554
+opencode_arch/mcp/tools/require.py,sha256=s5FHe3sj5coVExbI4Ae_3lAbx_1XExozset-rWvjtGg,2163
+opencode_arch/mcp/tools/scan.py,sha256=KQ9XI5s9gMqzExX5TcJMAqHwLFLXlbzhVjO6f7M4_OU,1794
+opencode_arch/mcp/tools/slice.py,sha256=ai-hjJgnDSJQOz4kpMkNyZZ913onYTL5JhCPU75bQ70,9533
+opencode_arch/mcp/tools/validate.py,sha256=mFYofkkXSrVo-o1M3DF2-OLFUtF3W2ybnIHn6Xi1O4I,1777
+opencode_arch/prompts/__init__.py,sha256=4ZGaFaRVSvlngdrTzOVhZJyCok5nJ4PGj_frzWE4HOI,61
+opencode_arch/prompts/regen.py,sha256=HRkNvLLwZ8h0CAvoKqSuS9uoWJeSOztBcgOgoOhdFK0,739
+opencode_arch/runner/__init__.py,sha256=Nk9Y6VQftEfZwQ3draL-juC6wwHZvCOWhHDTIYZUBtQ,224
+opencode_arch/runner/base.py,sha256=Vj7GY0j8x2XtedRWzcvePExkOpMOSQ50K6VXZ6JrT-A,479
+opencode_arch/runner/opencode.py,sha256=6Uh5CMVUwZ4N_yiY8ZnJFXInJkpdy4fbdDhIBVSN_fU,2119
+opencode_arch/telemetry/__init__.py,sha256=Skg6l-Vv01pldSlAs-vW34-UCeFUIGm8_W-5Zrhvsu0,239
+opencode_arch/telemetry/collector.py,sha256=3168ChrW3_utUWq8l68XodENE90LuuiPOe4yqawmbyE,1372
+opencode_arch/telemetry/recorder.py,sha256=HaqHbJOkIHDDhaeJhQAsWL7sheku2fuOIKTrIV63jdk,575
+opencode_arch/telemetry/store.py,sha256=BTIHqSx01oXXQOJ8GCsuhiE-sA-B_ec8pzR0jwoxIXE,21432
+opencode_arch-1.0.0.dist-info/METADATA,sha256=x5jH-2uQyG43dFaiK_NonR-5oGPepHfPPZdhh8KRuDA,9141
+opencode_arch-1.0.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+opencode_arch-1.0.0.dist-info/entry_points.txt,sha256=x0z-EUD-pg4-UH0x8Ww_P-KIbJXHSaRvdlm15MYPRWU,62
+opencode_arch-1.0.0.dist-info/licenses/LICENSE,sha256=ors_Qa2YCQ2Sc_Xlv0un1pw8FkxWv8nI61oO2CJorXQ,1077
+opencode_arch-1.0.0.dist-info/RECORD,,

opencode_arch-1.0.0.dist-info/WHEEL

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

opencode_arch-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+opencode-arch = opencode_arch.cli.main:main

opencode_arch-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anomaly Contributors
+
+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.