doubled-graph 1.0.0__tar.gz

doubled_graph-1.0.0/.gitignore

@@ -0,0 +1,2 @@
+.gitnexus
+extra/

doubled_graph-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 doubled-graph methodology authors
+
+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.

doubled_graph-1.0.0/PKG-INFO

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: doubled-graph
+Version: 1.0.0
+Summary: MCP facade over CodeGraphContext + grace-marketplace: impact, context, drift-detect for LLM-driven codebases.
+Project-URL: Homepage, https://github.com/osovv/doubled-graph
+Project-URL: Repository, https://github.com/osovv/doubled-graph
+Project-URL: Issues, https://github.com/osovv/doubled-graph/issues
+Project-URL: Documentation, https://github.com/osovv/doubled-graph/blob/main/SPEC.md
+Author: doubled-graph methodology authors
+License: MIT
+License-File: LICENSE
+Keywords: ast,claude,codebase,continue,cursor,graph,llm,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.11
+Requires-Dist: anyio>=4.0
+Requires-Dist: codegraphcontext>=0.1
+Requires-Dist: mcp>=0.9.0
+Requires-Dist: pydantic>=2.6
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# doubled-graph
+
+**MCP facade for LLM-driven codebases.** Four tools — `analyze`, `impact`, `context`, `detect_changes` — that combine a computed AST graph (via [CodeGraphContext](https://github.com/Shashankss1205/CodeGraphContext)) with a declared methodology graph (via [grace-marketplace](https://github.com/osovv/grace)) so your agent can reason about blast radius and drift before it edits code.
+
+License: MIT.
+
+---
+
+## What it does
+
+Large codebases break LLM agents two ways:
+1. They edit without knowing who calls the function → regression.
+2. They edit without knowing the declared contract → silent drift.
+
+`doubled-graph` gives the agent one gateway over two graphs:
+
+| Graph | Source | Answers |
+|-------|--------|---------|
+| **Computed** | CodeGraphContext (tree-sitter AST → graph DB) | who calls X, what X calls, where X is defined |
+| **Declared** | grace-marketplace artifacts (`docs/*.xml`) | which module owns X, its contract, its verification entries |
+
+Four MCP tools expose the cross-reference:
+
+| Tool | Use | When |
+|------|-----|------|
+| `analyze` | build/update the computed graph | after commit, on CI, at onboarding |
+| `impact` | blast radius + risk for a symbol | **before** editing |
+| `context` | 360° view (symbol + contract + module + callers/callees) | before non-trivial edits |
+| `detect_changes` | drift between code and artifacts | **before** commit |
+
+Plus 11 gateway tools that thin-wrap grace-marketplace operations (`lint`, `module_show`, `file_show`, `refresh`, skills like `init`/`plan`/`execute`/`fix`/...) so your agent talks to a single namespace.
+
+---
+
+## Install
+
+```bash
+pip install doubled-graph
+```
+
+Requires Python 3.11+. On first use, CGC will pick an embedded graph backend (FalkorDB Lite on Linux, KuzuDB on Windows; or Neo4j if configured via `NEO4J_URI`).
+
+---
+
+## Onboard a repo
+
+One command sets everything up:
+
+```bash
+doubled-graph setup
+```
+
+That will:
+1. install `@osovv/grace-cli` globally via `bun add -g` (skipped if Bun is not present),
+2. copy bundled `prompts/` and `methodology/` into the repo,
+3. register doubled-graph as an MCP server for the detected IDE (Claude Code / Cursor / Continue),
+4. install a `git post-commit` hook that keeps the computed graph fresh,
+5. run the first full `analyze` pass.
+
+Preview what it will do without touching anything:
+
+```bash
+doubled-graph setup --dry-run
+```
+
+Pick the IDE explicitly if auto-detect misses:
+
+```bash
+doubled-graph setup --ide claude-code
+```
+
+---
+
+## Day-to-day CLI
+
+```bash
+# Compute or refresh the graph (hooks call this automatically).
+doubled-graph analyze --mode auto
+
+# Blast radius for a symbol — run BEFORE editing.
+doubled-graph impact validateUser
+doubled-graph impact validateUser --direction both --depth 3
+
+# 360° view — contract + module + callers + callees.
+doubled-graph context validateUser
+
+# Drift between code and declared artifacts — run BEFORE committing.
+doubled-graph detect-changes --scope staged
+
+# Current methodology phase (migration | post_migration).
+doubled-graph phase get
+doubled-graph phase set post_migration --reason "migration complete"
+
+# Serve as an MCP server over stdio (IDE calls this).
+doubled-graph serve
+```
+
+---
+
+## MCP usage (Claude Code example)
+
+`.mcp.json` at the repo root:
+
+```json
+{
+  "mcpServers": {
+    "doubled-graph": {
+      "command": "doubled-graph",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+Then in your agent system prompt / `CLAUDE.md`:
+
+> - **MUST run `impact` before editing any symbol.**
+> - **MUST run `detect_changes` before committing.**
+
+---
+
+## The four core tools — input/output shape
+
+Full schemas in [TOOLS.md](TOOLS.md). Summary:
+
+```jsonc
+// impact
+{ "target": "validateUser", "direction": "upstream", "depth": 3 }
+→ {
+    "target_resolved": { "name": "...", "file": "...", "module_id": "M-AUTH-VALIDATE" },
+    "direct": [ { "name": "...", "file": "...", "depth": 1 } ],
+    "transitive": [ ... ],
+    "affected_modules": [ ... ],
+    "affected_verification": [ ... ],
+    "risk": { "level": "HIGH", "reasons": [ ... ] },
+    "meta": { "phase": "post_migration", ... }
+  }
+```
+
+Risk levels: `NONE`, `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`. Any `HIGH`/`CRITICAL` result means the methodology expects the agent to stop and surface the radius before editing.
+
+---
+
+## Layout
+
+- [SPEC.md](SPEC.md) — architecture, storage layout (`.doubled-graph/`), wire format
+- [TOOLS.md](TOOLS.md) — detailed tool spec (schemas, CGC mapping, use-cases)
+- [HOOKS.md](HOOKS.md) — git + Claude Code hook contracts
+- [CHANGELOG.md](CHANGELOG.md) — release notes
+
+---
+
+## Phase switch
+
+The methodology has two modes — `migration` (code is ground-truth) and `post_migration` (artifacts are ground-truth). doubled-graph reads the phase from an HTML-comment block in `AGENTS.md`:
+
+```markdown
+<!-- doubled-graph:phase:start -->
+## doubled-graph phase
+phase: post_migration
+<!-- doubled-graph:phase:end -->
+```
+
+Switch atomically:
+
+```bash
+doubled-graph phase set migration --reason "starting migration of legacy module"
+```
+
+`impact` risk rules and `detect_changes` resolution hints branch on this phase.
+
+---
+
+## Project status
+
+- Smoke-tested (29/29 passing).
+- Real CGC integration wired; stubs removed.
+- Ships with bundled `prompts/` and `methodology/` assets (loaded via `importlib.resources`).
+
+Upstream versions pinned: `codegraphcontext >= 0.1`, `mcp >= 0.9`.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Upstream components retain their own licenses (CodeGraphContext: MIT; grace-marketplace: MIT). GitNexus is **not** a dependency (PolyForm NC incompatibility).

doubled_graph-1.0.0/README.md

@@ -0,0 +1,188 @@
+# doubled-graph
+
+**MCP facade for LLM-driven codebases.** Four tools — `analyze`, `impact`, `context`, `detect_changes` — that combine a computed AST graph (via [CodeGraphContext](https://github.com/Shashankss1205/CodeGraphContext)) with a declared methodology graph (via [grace-marketplace](https://github.com/osovv/grace)) so your agent can reason about blast radius and drift before it edits code.
+
+License: MIT.
+
+---
+
+## What it does
+
+Large codebases break LLM agents two ways:
+1. They edit without knowing who calls the function → regression.
+2. They edit without knowing the declared contract → silent drift.
+
+`doubled-graph` gives the agent one gateway over two graphs:
+
+| Graph | Source | Answers |
+|-------|--------|---------|
+| **Computed** | CodeGraphContext (tree-sitter AST → graph DB) | who calls X, what X calls, where X is defined |
+| **Declared** | grace-marketplace artifacts (`docs/*.xml`) | which module owns X, its contract, its verification entries |
+
+Four MCP tools expose the cross-reference:
+
+| Tool | Use | When |
+|------|-----|------|
+| `analyze` | build/update the computed graph | after commit, on CI, at onboarding |
+| `impact` | blast radius + risk for a symbol | **before** editing |
+| `context` | 360° view (symbol + contract + module + callers/callees) | before non-trivial edits |
+| `detect_changes` | drift between code and artifacts | **before** commit |
+
+Plus 11 gateway tools that thin-wrap grace-marketplace operations (`lint`, `module_show`, `file_show`, `refresh`, skills like `init`/`plan`/`execute`/`fix`/...) so your agent talks to a single namespace.
+
+---
+
+## Install
+
+```bash
+pip install doubled-graph
+```
+
+Requires Python 3.11+. On first use, CGC will pick an embedded graph backend (FalkorDB Lite on Linux, KuzuDB on Windows; or Neo4j if configured via `NEO4J_URI`).
+
+---
+
+## Onboard a repo
+
+One command sets everything up:
+
+```bash
+doubled-graph setup
+```
+
+That will:
+1. install `@osovv/grace-cli` globally via `bun add -g` (skipped if Bun is not present),
+2. copy bundled `prompts/` and `methodology/` into the repo,
+3. register doubled-graph as an MCP server for the detected IDE (Claude Code / Cursor / Continue),
+4. install a `git post-commit` hook that keeps the computed graph fresh,
+5. run the first full `analyze` pass.
+
+Preview what it will do without touching anything:
+
+```bash
+doubled-graph setup --dry-run
+```
+
+Pick the IDE explicitly if auto-detect misses:
+
+```bash
+doubled-graph setup --ide claude-code
+```
+
+---
+
+## Day-to-day CLI
+
+```bash
+# Compute or refresh the graph (hooks call this automatically).
+doubled-graph analyze --mode auto
+
+# Blast radius for a symbol — run BEFORE editing.
+doubled-graph impact validateUser
+doubled-graph impact validateUser --direction both --depth 3
+
+# 360° view — contract + module + callers + callees.
+doubled-graph context validateUser
+
+# Drift between code and declared artifacts — run BEFORE committing.
+doubled-graph detect-changes --scope staged
+
+# Current methodology phase (migration | post_migration).
+doubled-graph phase get
+doubled-graph phase set post_migration --reason "migration complete"
+
+# Serve as an MCP server over stdio (IDE calls this).
+doubled-graph serve
+```
+
+---
+
+## MCP usage (Claude Code example)
+
+`.mcp.json` at the repo root:
+
+```json
+{
+  "mcpServers": {
+    "doubled-graph": {
+      "command": "doubled-graph",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+Then in your agent system prompt / `CLAUDE.md`:
+
+> - **MUST run `impact` before editing any symbol.**
+> - **MUST run `detect_changes` before committing.**
+
+---
+
+## The four core tools — input/output shape
+
+Full schemas in [TOOLS.md](TOOLS.md). Summary:
+
+```jsonc
+// impact
+{ "target": "validateUser", "direction": "upstream", "depth": 3 }
+→ {
+    "target_resolved": { "name": "...", "file": "...", "module_id": "M-AUTH-VALIDATE" },
+    "direct": [ { "name": "...", "file": "...", "depth": 1 } ],
+    "transitive": [ ... ],
+    "affected_modules": [ ... ],
+    "affected_verification": [ ... ],
+    "risk": { "level": "HIGH", "reasons": [ ... ] },
+    "meta": { "phase": "post_migration", ... }
+  }
+```
+
+Risk levels: `NONE`, `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`. Any `HIGH`/`CRITICAL` result means the methodology expects the agent to stop and surface the radius before editing.
+
+---
+
+## Layout
+
+- [SPEC.md](SPEC.md) — architecture, storage layout (`.doubled-graph/`), wire format
+- [TOOLS.md](TOOLS.md) — detailed tool spec (schemas, CGC mapping, use-cases)
+- [HOOKS.md](HOOKS.md) — git + Claude Code hook contracts
+- [CHANGELOG.md](CHANGELOG.md) — release notes
+
+---
+
+## Phase switch
+
+The methodology has two modes — `migration` (code is ground-truth) and `post_migration` (artifacts are ground-truth). doubled-graph reads the phase from an HTML-comment block in `AGENTS.md`:
+
+```markdown
+<!-- doubled-graph:phase:start -->
+## doubled-graph phase
+phase: post_migration
+<!-- doubled-graph:phase:end -->
+```
+
+Switch atomically:
+
+```bash
+doubled-graph phase set migration --reason "starting migration of legacy module"
+```
+
+`impact` risk rules and `detect_changes` resolution hints branch on this phase.
+
+---
+
+## Project status
+
+- Smoke-tested (29/29 passing).
+- Real CGC integration wired; stubs removed.
+- Ships with bundled `prompts/` and `methodology/` assets (loaded via `importlib.resources`).
+
+Upstream versions pinned: `codegraphcontext >= 0.1`, `mcp >= 0.9`.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Upstream components retain their own licenses (CodeGraphContext: MIT; grace-marketplace: MIT). GitNexus is **not** a dependency (PolyForm NC incompatibility).

doubled_graph-1.0.0/docs/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+All notable changes to doubled-graph. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [SemVer](https://semver.org/).
+
+## [0.1.0] — 2026-04-18
+
+Initial public release.
+
+### Added
+- `doubled-graph setup` — single-shot onboarding: installs `@osovv/grace-cli`,
+  copies bundled prompts + methodology into the repo, registers MCP for the
+  detected IDE (Claude Code / Cursor / Continue), installs the git post-commit
+  hook, runs the first full analyze. Supports `--dry-run` and `--ide` override.
+- Real CGC integration in `integrations/cgc.py`:
+  - `analyze_full`, `analyze_incremental` wired to `GraphBuilder`
+    (`add_repository_to_graph` / `delete_file_from_graph` / `parse_file` /
+    `link_function_calls` / `link_inheritance`)
+  - `find_callers`, `find_callees` wired to
+    `CodeFinder.analyze_code_relationships(find_all_callers / find_all_callees)`
+  - `find_symbol` wired to `CodeFinder.find_by_function_name`
+  - `symbols_in_file` via Cypher fallback
+- `impact` now returns populated `direct` / `transitive` / `affected_modules` /
+  `affected_verification`. Risk classification uses real caller counts +
+  phase + verification-touch.
+- `context` fully implemented — joins CGC symbol, declared module, and
+  extracts `MODULE_CONTRACT` / `CONTRACT:fn` blocks from source.
+- `detect_changes` fully implemented — `code_without_module`,
+  `module_without_code`, `stale_crosslinks`, `missing_verification`,
+  `markup_missing`. Resolution hint branches on `migration` vs
+  `post_migration`.
+- `analyze` now persists `.doubled-graph/cache/code-fingerprint.json` on
+  every successful run (enables `mode=auto` incremental detection).
+- CLI subcommands `impact`, `context`, `detect-changes` are no longer stubs —
+  they dispatch into the tools package.
+- Bundled `prompts/` and `methodology/` shipped inside the wheel via
+  `hatch force-include`; loaded with `importlib.resources` by `setup.py`.
+- 29 smoke tests covering CGC stubs, impact risk escalation, context joins,
+  drift detection, CLI wiring, setup dry-run + MCP registration.
+
+### Changed
+- Bumped version 0.1.0.dev0 → 0.1.0.
+- pyproject: added classifiers, keywords, URLs, `anyio` runtime dep, sdist
+  manifest.
+- `README.md` replaces `SPEC.md` as the PyPI long description.
+
+### Removed
+- `NotImplementedError` stubs in `integrations/cgc.py`.
+- `NOT_IMPLEMENTED_MVP` stub classes for `context` and `detect_changes`.
+- CLI `NOT_IMPLEMENTED_MVP` fallback for `impact` / `context` /
+  `detect-changes`.