decompose-mcp 0.1.0__tar.gz

decompose_mcp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly

decompose_mcp-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,24 @@
+name-template: 'v$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+template: |
+  ## What's Changed
+
+  $CHANGES
+
+  **Full Changelog**: https://github.com/echology-io/decompose/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION
+categories:
+  - title: 'Features'
+    labels: ['feature', 'enhancement']
+  - title: 'Bug Fixes'
+    labels: ['fix', 'bug']
+  - title: 'Maintenance'
+    labels: ['chore', 'deps', 'ci']
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+version-resolver:
+  major:
+    labels: ['major']
+  minor:
+    labels: ['minor', 'feature']
+  patch:
+    labels: ['patch', 'fix', 'bug']
+  default: patch

decompose_mcp-0.1.0/.github/workflows/benchmark.yml

@@ -0,0 +1,29 @@
+name: Benchmark
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install
+        run: pip install -e .
+
+      - name: Run benchmarks
+        run: python benchmarks/run.py | tee benchmark.json
+
+      - name: Upload results
+        uses: actions/upload-artifact@v4
+        with:
+          name: benchmark-results
+          path: benchmark.json

decompose_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Test
+        run: pytest -v

decompose_mcp-0.1.0/.github/workflows/pages.yml

@@ -0,0 +1,35 @@
+name: Deploy Pages
+
+on:
+  push:
+    branches: [main]
+    paths: [docs/**]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/configure-pages@v5
+        with:
+          enablement: true
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs
+
+      - id: deployment
+        uses: actions/deploy-pages@v4

decompose_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build
+        run: |
+          pip install hatchling
+          python -m hatchling build
+
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

decompose_mcp-0.1.0/.github/workflows/release-drafter.yml

@@ -0,0 +1,17 @@
+name: Release Drafter
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: read
+
+jobs:
+  draft:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

decompose_mcp-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+env/
+.env
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+htmlcov/
+.coverage
+*.so
+.DS_Store
+*.swp
+*.swo
+*~

decompose_mcp-0.1.0/LAUNCH.md

@@ -0,0 +1,33 @@
+# Decompose — Launch Plan
+
+**"Stop prompting. Start decomposing."**
+
+**Repo:** `echology-io/decompose`
+**Site:** echology.io
+
+---
+
+## What Decompose Is
+
+The missing cognitive primitive for AI agents.
+
+Agents fail on complex input because they receive unstructured chaos. Decompose gives any agent the ability to break any input into structured, composable intelligence — instantly. No LLM. No setup. One function call.
+
+**Positioning:** Decompose is not a parser. It's a stability layer for agent reasoning.
+
+**Philosophy:** All intelligence begins with decomposition.
+
+---
+
+## What We're NOT Building
+
+| Temptation | Why No |
+|---|---|
+| Web service / API | MCP runs locally. Zero ops. |
+| Database | Pure function. Stateless. |
+| LLM dependency | Kills adoption. Pure Python. Works offline. |
+| Config files | Sensible defaults. Env vars for power users. |
+| Docker | `pip install decompose`. Done. |
+| Auth / accounts | Local tool. No signup. |
+| Plugin system | Premature. Hardcode extractors. |
+| Multiple formats | JSON only. Agents consume JSON. |

decompose_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: decompose-mcp
+Version: 0.1.0
+Summary: The missing cognitive primitive for AI agents. Structured intelligence from any text.
+Project-URL: Homepage, https://echology.io/decompose
+Project-URL: Repository, https://github.com/echology-io/decompose
+Project-URL: Issues, https://github.com/echology-io/decompose/issues
+Author-email: Kyle Vines <kyle@echology.io>
+License: Proprietary
+Keywords: agents,ai,decompose,intelligence,mcp,semantic,structured
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary 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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Decompose
+
+[![CI](https://github.com/echology-io/decompose/actions/workflows/ci.yml/badge.svg)](https://github.com/echology-io/decompose/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/decompose-mcp)](https://pypi.org/project/decompose-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/decompose-mcp)](https://pypi.org/project/decompose-mcp/)
+
+<!-- mcp-name: io.github.echology-io/decompose -->
+
+**Stop prompting. Start decomposing.**
+
+The missing cognitive primitive for AI agents. Decompose turns any text into classified, structured semantic units — instantly. No LLM. No setup. One function call.
+
+---
+
+### Before: your agent reads this
+
+```
+The contractor shall provide all materials per ASTM C150-20. Maximum load
+shall not exceed 500 psf per ASCE 7-22. Notice to proceed within 14 calendar
+days of contract execution. Retainage of 10% applies to all payments.
+For general background, the project is located in Denver, CO...
+```
+
+### After: your agent reads this
+
+```json
+[
+  {
+    "text": "The contractor shall provide all materials per ASTM C150-20.",
+    "authority": "mandatory",
+    "risk": "compliance",
+    "type": "requirement",
+    "irreducible": true,
+    "attention": 8.0,
+    "entities": ["ASTM C150-20"]
+  },
+  {
+    "text": "Maximum load shall not exceed 500 psf per ASCE 7-22.",
+    "authority": "prohibitive",
+    "risk": "safety_critical",
+    "type": "constraint",
+    "irreducible": true,
+    "attention": 10.0,
+    "entities": ["ASCE 7-22"]
+  }
+]
+```
+
+Every unit classified. Every standard extracted. Every risk scored. Your agent knows what matters.
+
+---
+
+## Install
+
+```bash
+pip install decompose-mcp
+```
+
+## Use as MCP Server
+
+Add to your agent's MCP config (Claude Code, OpenClaw, Cursor, etc.):
+
+```json
+{
+  "mcpServers": {
+    "decompose": {
+      "command": "uvx",
+      "args": ["decompose-mcp", "--serve"]
+    }
+  }
+}
+```
+
+Your agent gets two tools:
+- **`decompose_text`** — decompose any text
+- **`decompose_url`** — fetch a URL and decompose its content
+
+## Use as CLI
+
+```bash
+# Pipe text
+cat spec.txt | decompose --pretty
+
+# Inline
+decompose --text "The contractor shall provide all materials per ASTM C150-20."
+
+# Compact output (smaller JSON)
+cat document.md | decompose --compact
+```
+
+## Use as Library
+
+```python
+from decompose import decompose
+
+result = decompose("The contractor shall provide all materials per ASTM C150-20.")
+
+for unit in result["units"]:
+    print(f"[{unit['authority']}] [{unit['risk']}] {unit['text'][:60]}...")
+```
+
+---
+
+## What Each Field Means
+
+| Field | Values | What It Tells Your Agent |
+|-------|--------|--------------------------|
+| `authority` | mandatory, prohibitive, directive, permissive, conditional, informational | Is this a hard requirement or background? |
+| `risk` | safety_critical, compliance, financial, contractual, advisory, informational | How much does this matter? |
+| `type` | requirement, definition, reference, constraint, narrative, data | What kind of content is this? |
+| `irreducible` | true/false | Must this be preserved verbatim? |
+| `attention` | 0.0 - 10.0 | How much compute should the agent spend here? |
+| `entities` | standards, codes, regulations | What formal references are cited? |
+| `actionable` | true/false | Does someone need to do something? |
+
+---
+
+## Why No LLM?
+
+Decompose runs on pure regex and heuristics. No Ollama, no API key, no GPU, no inference cost.
+
+This is intentional:
+- **Fast**: <500ms for a 50-page spec
+- **Deterministic**: Same input always produces same output
+- **Offline**: Works air-gapped, on a plane, on CI
+- **Composable**: Your agent's LLM reasons over the structured output — decompose handles the preprocessing
+
+The LLM is what *your agent* uses. Decompose makes whatever model you're running work better.
+
+---
+
+## Built by Echology
+
+Decompose is extracted from [AECai](https://aecai.io), a document intelligence platform for Architecture, Engineering, and Construction firms. The classification patterns, entity extraction, and irreducibility detection are battle-tested against thousands of real AEC documents — specs, contracts, RFIs, inspection reports, pay applications.
+
+**License:** Proprietary — Copyright (c) 2025-2026 Echology, Inc.
+
+**Philosophy:** All intelligence begins with decomposition.

decompose_mcp-0.1.0/README.md

@@ -0,0 +1,138 @@
+# Decompose
+
+[![CI](https://github.com/echology-io/decompose/actions/workflows/ci.yml/badge.svg)](https://github.com/echology-io/decompose/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/decompose-mcp)](https://pypi.org/project/decompose-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/decompose-mcp)](https://pypi.org/project/decompose-mcp/)
+
+<!-- mcp-name: io.github.echology-io/decompose -->
+
+**Stop prompting. Start decomposing.**
+
+The missing cognitive primitive for AI agents. Decompose turns any text into classified, structured semantic units — instantly. No LLM. No setup. One function call.
+
+---
+
+### Before: your agent reads this
+
+```
+The contractor shall provide all materials per ASTM C150-20. Maximum load
+shall not exceed 500 psf per ASCE 7-22. Notice to proceed within 14 calendar
+days of contract execution. Retainage of 10% applies to all payments.
+For general background, the project is located in Denver, CO...
+```
+
+### After: your agent reads this
+
+```json
+[
+  {
+    "text": "The contractor shall provide all materials per ASTM C150-20.",
+    "authority": "mandatory",
+    "risk": "compliance",
+    "type": "requirement",
+    "irreducible": true,
+    "attention": 8.0,
+    "entities": ["ASTM C150-20"]
+  },
+  {
+    "text": "Maximum load shall not exceed 500 psf per ASCE 7-22.",
+    "authority": "prohibitive",
+    "risk": "safety_critical",
+    "type": "constraint",
+    "irreducible": true,
+    "attention": 10.0,
+    "entities": ["ASCE 7-22"]
+  }
+]
+```
+
+Every unit classified. Every standard extracted. Every risk scored. Your agent knows what matters.
+
+---
+
+## Install
+
+```bash
+pip install decompose-mcp
+```
+
+## Use as MCP Server
+
+Add to your agent's MCP config (Claude Code, OpenClaw, Cursor, etc.):
+
+```json
+{
+  "mcpServers": {
+    "decompose": {
+      "command": "uvx",
+      "args": ["decompose-mcp", "--serve"]
+    }
+  }
+}
+```
+
+Your agent gets two tools:
+- **`decompose_text`** — decompose any text
+- **`decompose_url`** — fetch a URL and decompose its content
+
+## Use as CLI
+
+```bash
+# Pipe text
+cat spec.txt | decompose --pretty
+
+# Inline
+decompose --text "The contractor shall provide all materials per ASTM C150-20."
+
+# Compact output (smaller JSON)
+cat document.md | decompose --compact
+```
+
+## Use as Library
+
+```python
+from decompose import decompose
+
+result = decompose("The contractor shall provide all materials per ASTM C150-20.")
+
+for unit in result["units"]:
+    print(f"[{unit['authority']}] [{unit['risk']}] {unit['text'][:60]}...")
+```
+
+---
+
+## What Each Field Means
+
+| Field | Values | What It Tells Your Agent |
+|-------|--------|--------------------------|
+| `authority` | mandatory, prohibitive, directive, permissive, conditional, informational | Is this a hard requirement or background? |
+| `risk` | safety_critical, compliance, financial, contractual, advisory, informational | How much does this matter? |
+| `type` | requirement, definition, reference, constraint, narrative, data | What kind of content is this? |
+| `irreducible` | true/false | Must this be preserved verbatim? |
+| `attention` | 0.0 - 10.0 | How much compute should the agent spend here? |
+| `entities` | standards, codes, regulations | What formal references are cited? |
+| `actionable` | true/false | Does someone need to do something? |
+
+---
+
+## Why No LLM?
+
+Decompose runs on pure regex and heuristics. No Ollama, no API key, no GPU, no inference cost.
+
+This is intentional:
+- **Fast**: <500ms for a 50-page spec
+- **Deterministic**: Same input always produces same output
+- **Offline**: Works air-gapped, on a plane, on CI
+- **Composable**: Your agent's LLM reasons over the structured output — decompose handles the preprocessing
+
+The LLM is what *your agent* uses. Decompose makes whatever model you're running work better.
+
+---
+
+## Built by Echology
+
+Decompose is extracted from [AECai](https://aecai.io), a document intelligence platform for Architecture, Engineering, and Construction firms. The classification patterns, entity extraction, and irreducibility detection are battle-tested against thousands of real AEC documents — specs, contracts, RFIs, inspection reports, pay applications.
+
+**License:** Proprietary — Copyright (c) 2025-2026 Echology, Inc.
+
+**Philosophy:** All intelligence begins with decomposition.

decompose_mcp-0.1.0/benchmarks/latest.json

@@ -0,0 +1,61 @@
+{
+  "docs": 5,
+  "total_chars": 15683,
+  "total_units": 34,
+  "total_ms": 13.8,
+  "chars_per_ms": 1132,
+  "total_standards": 22,
+  "total_irreducible": 19,
+  "benchmarks": [
+    {
+      "file": "agent_policy.txt",
+      "chars": 2679,
+      "words": 404,
+      "units": 8,
+      "ms": 2.12,
+      "standards": 0,
+      "irreducible": 6,
+      "actionable": 7
+    },
+    {
+      "file": "contract_excerpt.txt",
+      "chars": 3693,
+      "words": 580,
+      "units": 2,
+      "ms": 3.51,
+      "standards": 1,
+      "irreducible": 2,
+      "actionable": 2
+    },
+    {
+      "file": "model_card.txt",
+      "chars": 2266,
+      "words": 339,
+      "units": 7,
+      "ms": 1.76,
+      "standards": 0,
+      "irreducible": 2,
+      "actionable": 2
+    },
+    {
+      "file": "report_geotechnical.txt",
+      "chars": 3242,
+      "words": 499,
+      "units": 14,
+      "ms": 2.65,
+      "standards": 6,
+      "irreducible": 6,
+      "actionable": 8
+    },
+    {
+      "file": "spec_structural.txt",
+      "chars": 3803,
+      "words": 580,
+      "units": 3,
+      "ms": 3.81,
+      "standards": 15,
+      "irreducible": 3,
+      "actionable": 3
+    }
+  ]
+}

decompose_mcp-0.1.0/benchmarks/run.py

@@ -0,0 +1,79 @@
+#!/usr/bin/env python3
+"""Benchmark decompose against reference fixtures. Outputs JSON."""
+
+import json
+import sys
+import time
+from pathlib import Path
+
+from decompose.core import decompose_text
+
+FIXTURES = Path(__file__).parent.parent / "tests" / "fixtures"
+
+
+def bench_file(path: Path) -> dict:
+    text = path.read_text()
+    start = time.monotonic()
+    result = decompose_text(text)
+    elapsed = round((time.monotonic() - start) * 1000, 1)
+
+    meta = result["meta"]
+    units = result["units"]
+
+    safety = sum(1 for u in units if u["risk"] == "safety_critical")
+    mandatory = sum(1 for u in units if u["authority"] == "mandatory")
+    irreducible = sum(1 for u in units if u["irreducible"])
+
+    return {
+        "file": path.name,
+        "input_chars": len(text),
+        "input_words": len(text.split()),
+        "total_units": meta["total_units"],
+        "processing_ms": elapsed,
+        "standards_found": len(meta["standards_found"]),
+        "dates_found": len(meta["dates_found"]),
+        "token_estimate": meta["token_estimate"],
+        "mandatory_units": mandatory,
+        "safety_critical_units": safety,
+        "irreducible_units": irreducible,
+    }
+
+
+def main():
+    if not FIXTURES.exists():
+        print(f"No fixtures at {FIXTURES}", file=sys.stderr)
+        sys.exit(1)
+
+    files = sorted(FIXTURES.glob("*.txt"))
+    if not files:
+        print("No .txt fixtures found", file=sys.stderr)
+        sys.exit(1)
+
+    results = []
+    for f in files:
+        results.append(bench_file(f))
+
+    # Summary
+    total_chars = sum(r["input_chars"] for r in results)
+    total_ms = sum(r["processing_ms"] for r in results)
+    total_units = sum(r["total_units"] for r in results)
+    total_standards = sum(r["standards_found"] for r in results)
+
+    output = {
+        "benchmarks": results,
+        "summary": {
+            "files": len(results),
+            "total_chars": total_chars,
+            "total_units": total_units,
+            "total_standards": total_standards,
+            "total_ms": round(total_ms, 1),
+            "chars_per_ms": round(total_chars / max(total_ms, 0.1)),
+        },
+    }
+
+    json.dump(output, sys.stdout, indent=2)
+    print()
+
+
+if __name__ == "__main__":
+    main()

decompose_mcp-0.1.0/docs/CNAME

@@ -0,0 +1 @@
+echology.io