continuum-code 0.2.0__py3-none-any.whl

continuum/scan.py

@@ -0,0 +1,129 @@
+"""Repo scan: detect stack (dbt, airflow, node, python) and optional CODEOWNERS; produce draft continuum.yaml."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+
+def scan_repo(repo_root: str | Path) -> dict:
+    """Detect repo signals. Returns a dict with has_dbt, has_airflow, has_node, has_python, codeowners_path."""
+    repo_root = Path(repo_root)
+    has_dbt = (repo_root / "dbt_project.yml").exists() or (repo_root / "models").is_dir()
+    has_airflow = (repo_root / "dags").is_dir() or (repo_root / "airflow.cfg").exists()
+    has_node = (repo_root / "package.json").exists()
+    has_python = (repo_root / "pyproject.toml").exists() or (repo_root / "requirements.txt").exists()
+    codeowners = repo_root / "CODEOWNERS"
+    if not codeowners.exists():
+        codeowners = repo_root / ".github" / "CODEOWNERS"
+    codeowners_path = str(codeowners) if codeowners.exists() else None
+    return {
+        "has_dbt": has_dbt,
+        "has_airflow": has_airflow,
+        "has_node": has_node,
+        "has_python": has_python,
+        "codeowners_path": codeowners_path,
+    }
+
+
+def draft_yaml(signals: dict, answers: dict | None = None) -> str:
+    """Produce draft continuum.yaml from scan signals and optional wizard answers."""
+    answers = answers or {}
+    lines = ["version: 0.1", "scopes:"]
+    # Base repo scope
+    lines.append("  - id: repo")
+    lines.append('    match: ["**/*"]')
+    lines.append("    contracts:")
+    lines.append("      - type: define")
+    lines.append('        key: prod_ready')
+    lines.append('        value: "Add rules below; then run continuum check."')
+    # Wizard: banned deps
+    banned_deps = answers.get("banned_deps") or []
+    for dep in banned_deps:
+        dep = dep.strip()
+        if not dep:
+            continue
+        safe_id = dep.replace(".", "_").replace("-", "_")[:30]
+        lines.append("      - type: ban")
+        lines.append(f"        id: ban_{safe_id}")
+        lines.append("        match:")
+        lines.append(f'          deps: ["{dep}"]')
+        lines.append(f'        message: "Dependency {dep} is not allowed."')
+    # Wizard: ask_first paths
+    ask_paths = answers.get("ask_first_paths") or []
+    if ask_paths:
+        paths_str = ", ".join(f'"{p.strip()}"' for p in ask_paths if p.strip())
+        if paths_str:
+            lines.append("      - type: ask_first")
+            lines.append("        id: confirm_sensitive")
+            lines.append("        match:")
+            lines.append(f"          paths: [{paths_str}]")
+            lines.append('        prompt: "Touching sensitive paths. Confirm intent."')
+    # Wizard: banned commands
+    banned_cmds = answers.get("banned_commands") or []
+    if banned_cmds:
+        cmds_str = ", ".join(f'"{c.strip()}"' for c in banned_cmds if c.strip())
+        if cmds_str:
+            lines.append("      - type: ban")
+            lines.append("        id: ban_commands")
+            lines.append("        match:")
+            lines.append(f"          commands: [{cmds_str}]")
+            lines.append('        message: "These commands are not allowed in code."')
+    # dbt
+    if signals.get("has_dbt"):
+        lines.append("  - id: dbt")
+        lines.append('    match: ["dbt_project.yml", "models/**", "macros/**", "snapshots/**"]')
+        lines.append("    precedence: 10")
+        lines.append("    contracts:")
+        lines.append("      - type: ask_first")
+        lines.append("        id: confirm_marts")
+        lines.append('        match:')
+        lines.append('          paths: ["models/marts/**"]')
+        lines.append('        prompt: "Touching dbt marts. Confirm: (A) additive (B) breaking (C) refactor-only"')
+        lines.append("      - type: require")
+        lines.append("        id: require_tests_marts")
+        lines.append('        match:')
+        lines.append('          paths: ["models/marts/**"]')
+        lines.append("        require:")
+        lines.append("          - kind: tests")
+        lines.append('            hint: "Add or update dbt tests for changed marts."')
+    # airflow
+    if signals.get("has_airflow"):
+        lines.append("  - id: airflow")
+        lines.append('    match: ["dags/**"]')
+        lines.append("    precedence: 10")
+        lines.append("    contracts:")
+        lines.append("      - type: ask_first")
+        lines.append("        id: confirm_dag_changes")
+        lines.append('        match:')
+        lines.append('          paths: ["dags/**"]')
+        lines.append('        prompt: "Touching DAGs. Confirm you intend to change orchestration."')
+        lines.append("      - type: ban")
+        lines.append("        id: ban_risky_commands")
+        lines.append('        match:')
+        lines.append('          commands: ["*full-refresh*", "*backfill*", "*clear*"]')
+        lines.append('        message: "Risky commands (full-refresh, backfill, clear) must not be embedded in DAGs."')
+    # backend (python or node)
+    if signals.get("has_python") or signals.get("has_node"):
+        paths = ["backend/**", "src/**", "app/**"]
+        if signals.get("has_python"):
+            paths.append("**/*.py")
+        if signals.get("has_node"):
+            paths.append("lib/**")
+        match_str = ", ".join(f'"{p}"' for p in paths[:4])
+        lines.append("  - id: backend")
+        lines.append(f"    match: [{match_str}]")
+        lines.append("    precedence: 10")
+        lines.append("    contracts:")
+        lines.append("      - type: require")
+        lines.append("        id: require_tests")
+        lines.append("        match:")
+        lines.append(f"          paths: [{match_str}]")
+        lines.append("        require:")
+        lines.append("          - kind: tests")
+        lines.append('            hint: "Add or adjust tests for changed modules."')
+        severity = answers.get("require_severity") or "block"
+        if severity == "warn":
+            lines.append("        severity: warn")
+    if signals.get("codeowners_path"):
+        lines.append("  # CODEOWNERS found at " + signals["codeowners_path"] + " – consider ask_first for those paths")
+    return "\n".join(lines)

continuum_code-0.2.0.dist-info/METADATA

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: continuum-code
+Version: 0.2.0
+Summary: Rule engine so coding agents obey repo rules (block/warn/ask) with clear explanations.
+Author: Continuum
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: click>=8.0
+Requires-Dist: mcp>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+
+# Continuum
+
+Rule engine so coding agents **obey repo rules** across Cursor, Claude, and ChatGPT: they get **blocked**, **warned**, or **asked** before breaking rules, with clear explanations of which rule fired and how to fix.
+
+## v0.1 promise
+
+- Add `continuum.yaml` to your repo.
+- Run `continuum check` locally and in CI.
+- Cursor (MCP) agents are gated: **blocked** / **warned** / **clarification_required** before breaking rules.
+- The system **explains** which rule fired and how to fix it.
+
+## Install
+
+```bash
+pip install -e .   # from repo
+# or when published:
+pip install continuum-code
+```
+
+Requires Python 3.10+.
+
+### Development on Windows (WSL2)
+
+Keep the repo on the WSL filesystem (e.g. `~/repos/continuum`) for best compatibility.
+
+**One-time (PowerShell as Admin):**
+
+```powershell
+wsl --install -d Ubuntu-24.04
+```
+
+After WSL install, open Ubuntu and run:
+
+```bash
+# Base (keep repo under WSL, e.g. ~/repos/continuum)
+sudo apt update && sudo apt install -y build-essential git curl
+
+# Python via uv (fast, clean venvs)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+source ~/.local/bin/env  # or restart shell
+```
+
+**Per clone (inside WSL, in repo root):**
+
+```bash
+cd ~/repos/continuum   # or your path
+uv venv
+source .venv/bin/activate
+uv pip install -e ".[dev]"
+```
+
+**Run tests:**
+
+```bash
+pytest
+```
+
+**Run CLI:**
+
+```bash
+continuum check
+continuum init --pack python-fastapi
+```
+
+For a broader Windows + WSL2 dev setup (Terminal, Docker, Antigravity safety), see your preferred guide.
+
+## Quick start
+
+```bash
+# Create config (optional: use a pack)
+continuum init
+continuum init --pack python-fastapi   # or node-backend, typescript-monorepo
+
+# Check current changes (git diff)
+continuum check
+continuum check --staged              # only staged
+continuum check --base origin/main    # diff against branch
+
+# Explain why a rule fired
+continuum explain
+continuum explain ban_lodash
+
+# List active contracts
+continuum inspect
+```
+
+## Config: `continuum.yaml`
+
+```yaml
+version: 0.1
+scopes:
+  - id: repo
+    match: ["**/*"]
+    contracts:
+      - type: ban
+        id: ban_lodash
+        match:
+          deps: ["lodash"]
+        message: "Use native JS or approved utils."
+      - type: ask_first
+        id: confirm_migrations
+        match:
+          paths: ["**/migrations/**"]
+        prompt: "Touching migrations. Confirm: (A) add-only (B) destructive (C) refactor"
+  - id: backend
+    match: ["backend/**"]
+    precedence: 10
+    contracts:
+      - type: require
+        id: require_tests
+        match:
+          paths: ["backend/**"]
+        require:
+          - kind: tests
+            hint: "Add or adjust unit tests for changed modules."
+```
+
+Contract types: **ban** (deps/paths/commands), **require** (tests/logging/ADR), **ask_first** (confirmation gate), **define** (metadata).
+
+## Escape hatch
+
+To skip checks (e.g. emergency hotfix), set `CONTINUUM_SKIP=1`; `continuum check` will exit 0 without running contracts. Prefer adjusting rules (e.g. `severity: warn`) in `continuum.yaml` when possible. See [docs/adoption.md](docs/adoption.md).
+
+## CI (GitHub Action)
+
+```yaml
+- uses: actions/checkout@v4
+  with:
+    fetch-depth: 0
+- uses: ./actions/continuum-check
+  with:
+    base_ref: ${{ github.event.pull_request.base.sha }}
+```
+
+Or in another repo: `uses: your-org/continuum/actions/continuum-check@v0.1` (and install `continuum` via pip in the action).
+
+## Cursor / MCP
+
+Run the MCP server so the Cursor agent can call `continuum_check` before applying changes:
+
+```bash
+continuum mcp --transport stdio
+```
+
+Add to Cursor MCP config:
+
+```json
+{
+  "mcpServers": {
+    "continuum": {
+      "command": "continuum",
+      "args": ["mcp", "--transport", "stdio"]
+    }
+  }
+}
+```
+
+See [docs/cursor-mcp.md](docs/cursor-mcp.md) and [docs/demo.md](docs/demo.md) for setup and the “Refactor auth middleware” demo.
+
+**Golden demo:** Run the 3 scenarios in [demo/README.md](demo/README.md) (dbt marts require, airflow ask-first, banned command) in under 10 minutes.
+
+## Packs
+
+Starter configs:
+
+- **node-backend** – Node/JS backend (ban lodash, require tests, ask on migrations).
+- **python-fastapi** – FastAPI app (ban requests in favor of httpx, require tests, ask on migrations).
+- **typescript-monorepo** – TS monorepo (ban lodash, require tests in packages).
+- **data-dbt-airflow** – dbt + Airflow repos (ask_first on marts/DAGs, require tests on marts, ban risky commands).
+
+```bash
+continuum init --pack python-fastapi
+continuum init --pack data-dbt-airflow   # dbt + Airflow
+```
+
+### 5-minute adoption (dbt + Airflow)
+
+1. `pip install continuum-code` (or `pip install -e .` from repo).
+2. `continuum init --pack data-dbt-airflow` → writes `continuum.yaml`.
+3. `continuum validate` → confirm the file is valid.
+4. `continuum check` (or `continuum check --base origin/main` for PRs).
+5. Add the GitHub Action for CI; optionally run `continuum mcp --transport stdio` for Cursor.
+
+## Next steps (after v0.1)
+
+- Richer dependency detection (poetry, pnpm, pip-tools).
+- Pattern bans (regex on diffs).
+- Stricter “require” checks (e.g. tests touched when src touched).
+- Decision diffs / supersession (v0.2).
+
+## License
+
+MIT.

continuum_code-0.2.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+continuum/__init__.py,sha256=4DD2V2nT10peslESeuFpV1ViFbciCM_1FXkZbxSs1S8,210
+continuum/change_summary.py,sha256=pBYwyStK8KvO5OPK8VVORQ9pqQ7agEmQBmc0-WBDbcY,15609
+continuum/cli.py,sha256=MYh811DPqVgUpFnU6uTkl3IIrIIqpas8MrKraoqokl4,16264
+continuum/contracts.py,sha256=liDj_UcbsZ-TQruLQLvDebuxqph35csvMh_NhQpnv8k,5712
+continuum/engine.py,sha256=55E2i8fpQD2w2Z_812Li1GFmC5jdS8fwy-g3w_RU3C8,9088
+continuum/mcp_server.py,sha256=pH3xSHYyLMgj3e4aI2A84yR-pH0_HSJ6oJHxma5SQ5Q,4932
+continuum/recommend.py,sha256=YZeWPTmHOZFqGQ8vdtaKQJ-elxEP0NDfbNM5vu1xPLg,2416
+continuum/scan.py,sha256=4hSUG0v-vVuONrId_nYjYR_aV9eZEGWHRX-KOMeLFJA,6133
+continuum/packs/data-dbt-airflow/README.md,sha256=hNAQdHoMU-8oIxLEoTdTuk0VeJ-IRilLI5g7_hYu_jU,1805
+continuum/packs/data-dbt-airflow/continuum.yaml,sha256=DfQnCGzcmuTw_ZUrhVzbmfZMi3GtdLYlJJzZSCaf5OA,1385
+continuum/packs/node-backend/continuum.yaml,sha256=MM_lR4C6hpDhhK37EyZT9l5GwW1nsjDpykZrV1QWnp0,856
+continuum/packs/python-fastapi/continuum.yaml,sha256=WHESGlkx7L_0VgZYiZ8L-yCYISWCAUPuaoJUfAxzfpo,905
+continuum/packs/typescript-monorepo/continuum.yaml,sha256=MVFXp1-Pw03FwEUAfvtlcXZuTS63x-3Uw0KgJ8Ahlvk,841
+continuum_code-0.2.0.dist-info/METADATA,sha256=aq8YMf58-ecgQmnuXTYd-lnmu6srRO3hRdIEYiILTEA,5654
+continuum_code-0.2.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+continuum_code-0.2.0.dist-info/entry_points.txt,sha256=V8HMNBQVMiPLhcrAkCLpJYterSgesg0FjMkWa7s9YGA,49
+continuum_code-0.2.0.dist-info/top_level.txt,sha256=TXST1D1spateEmtvhXZfWhbvAkUySKPQ6pmiLzqNqRg,10
+continuum_code-0.2.0.dist-info/RECORD,,

continuum_code-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

continuum_code-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+continuum = continuum.cli:main

continuum_code-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+continuum