Metadata-Version: 2.4
Name: dotscope
Version: 1.2.2
Summary: Agents see files. You see architecture. dotscope gives agents the architecture.
Author: Supremum
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,coding,context,mcp,scope
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: tree-sitter-go>=0.23.0
Requires-Dist: tree-sitter-javascript>=0.23.0
Requires-Dist: tree-sitter-typescript>=0.23.0
Requires-Dist: tree-sitter>=0.23.0
Provides-Extra: all
Requires-Dist: mcp>=1.2.0; extra == 'all'
Requires-Dist: numpy; extra == 'all'
Requires-Dist: sentence-transformers; extra == 'all'
Requires-Dist: tiktoken; extra == 'all'
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: embeddings
Requires-Dist: sentence-transformers; extra == 'embeddings'
Provides-Extra: mcp
Requires-Dist: mcp>=1.2.0; extra == 'mcp'
Provides-Extra: search
Requires-Dist: numpy; extra == 'search'
Requires-Dist: sentence-transformers; extra == 'search'
Provides-Extra: tokens
Requires-Dist: tiktoken; extra == 'tokens'
Description-Content-Type: text/markdown

<p align="center">
  <img src="logo.png" alt="dotscope" width="400">
</p>

Your agent writes code that compiles, passes tests, and breaks production.

It changed a backend endpoint without touching the frontend that calls it.
It put a file in `src/helpers/` instead of next to the module that uses it.
It ignored the convention every other file follows. Two agents working at
the same time silently overwrote each other.

The agent sees files. You see architecture. dotscope closes that gap.

```
$ dotscope ingest

  Analyzing dependency graph...
  Mining git history...
  Discovering conventions...

  Discoveries:
  - version.py and environment.prod.ts always change together
  - workflow-edit-dialog.component.ts and models.py are tightly coupled

  Validation (49 commits backtested):
  - Overall recall: 78%
  - Token reduction: 67% (1.3M → 437K avg)

  Output: 3 .scope files written.
```

One MCP tool call. The agent gets the relevant code, its dependency
neighborhood, implicit contracts from git history, convention rules,
swarm lock status, and action hints. One call, not five.

dotscope learns from every commit. Files agents consistently need get
ranked higher. Conventions that hold get enforced harder. Rules that
get overridden get quieter. Recall starts at 78% and climbs past 91%.

```
pip install dotscope && dotscope init
```

Zero dependencies. Python 3.9+ stdlib only. MIT.

[How It Works](docs/how-it-works.md) · [Scope Files](docs/scope-file.md) · [Agent Instructions](AGENT_INSTRUCTIONS.md) · [MIT](LICENSE)
