attocode-code-intel 0.1.5__tar.gz → 0.1.7__tar.gz

attocode_code_intel-0.1.7/.gitignore

@@ -0,0 +1,88 @@
+# Python
+dist/
+__pycache__/
+.venv/
+*.egg-info/
+*.db
+*.db-shm
+*.db-wal
+*.jsonl
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+# Node (lessons/)
+node_modules/
+
+# Environment
+.env
+
+# Claude/Agent
+.claude/
+.agent/
+.traces/
+.production-agent-sessions/
+.test-sandbox/
+
+# Attocode runtime
+.attocode/traces/
+.attocode/sessions/
+.attocode/recordings/
+.attocode/cache/
+.attocode/reports/
+.attocode/rule_feedback.json
+.attocode/packs/python/
+.attocode/.attocode/
+.attocode/dev-state.json
+.attocode/config.toml
+.attocode/vectors
+attocode/attocode_py/.attocode/
+tests/unit/tui/__snapshots__/
+.attocode/exports/
+.attocode/index/
+.attocode/meta_harness/
+tests/fixtures/sample_project/
+docs/superpowers/
+eval/charts/
+eval/*.md
+eval/*.log
+eval/*.json
+# Legacy TS runtime artifacts
+legacy/.attocode/traces/
+legacy/.attocode/sessions/
+legacy/.attocode/recordings/
+
+# attocode snapshots
+tests/unit/tui/__snapshots__/
+
+
+# Build outputs
+*.vsix
+site/
+snapshot_report.html
+.internal
+
+# scripts
+scripts/*
+!scripts/validate_release_version.py
+!scripts/check_pack_licenses.py
+.DS_Store
+
+#playwright
+.playwright-mcp
+
+#gsd
+.gsd/
+.bg-shell/
+
+#cursor
+.cursor/
+
+# search-quality sweep scratch output
+eval/sweep_out/
+
+# Bounded validation workspaces, reports and cloud ledger
+.attocode/quality/
+
+# Local outputs left by the archived TypeScript checkout stay private.
+/legacy/

attocode_code_intel-0.1.7/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.5
+Name: attocode-code-intel
+Version: 0.1.7
+Summary: Local code search and navigation for coding agents and people
+Project-URL: Homepage, https://github.com/eren23/attocode
+Project-URL: Repository, https://github.com/eren23/attocode
+Project-URL: Bug Tracker, https://github.com/eren23/attocode/issues
+Project-URL: Changelog, https://github.com/eren23/attocode/blob/main/CHANGELOG.md
+License-Expression: MIT
+License-File: LICENSE
+Keywords: code-navigation,code-search,coding-agents,mcp,tree-sitter
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: click>=8.1
+Requires-Dist: filelock>=3.16
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2,>=1.26
+Requires-Dist: numpy>=2
+Requires-Dist: pathspec>=0.12
+Requires-Dist: psutil>=6
+Requires-Dist: pydantic>=2
+Requires-Dist: python-dotenv>=1
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Requires-Dist: structlog>=24.1
+Requires-Dist: tenacity>=9
+Requires-Dist: tiktoken>=0.7
+Requires-Dist: tomli-w>=1
+Requires-Dist: tomlkit>=0.13
+Requires-Dist: tree-sitter-bash
+Requires-Dist: tree-sitter-c
+Requires-Dist: tree-sitter-c-sharp
+Requires-Dist: tree-sitter-cpp
+Requires-Dist: tree-sitter-css
+Requires-Dist: tree-sitter-elixir
+Requires-Dist: tree-sitter-go
+Requires-Dist: tree-sitter-hcl
+Requires-Dist: tree-sitter-html
+Requires-Dist: tree-sitter-java
+Requires-Dist: tree-sitter-javascript
+Requires-Dist: tree-sitter-json
+Requires-Dist: tree-sitter-kotlin
+Requires-Dist: tree-sitter-lua
+Requires-Dist: tree-sitter-php
+Requires-Dist: tree-sitter-python
+Requires-Dist: tree-sitter-ruby
+Requires-Dist: tree-sitter-rust
+Requires-Dist: tree-sitter-scala
+Requires-Dist: tree-sitter-swift
+Requires-Dist: tree-sitter-toml
+Requires-Dist: tree-sitter-typescript
+Requires-Dist: tree-sitter-yaml
+Requires-Dist: tree-sitter-zig
+Requires-Dist: tree-sitter<0.26,>=0.23
+Requires-Dist: watchfiles>=1
+Provides-Extra: dev
+Requires-Dist: ast-grep-cli>=0.42; extra == 'dev'
+Requires-Dist: bcrypt>=4.0; extra == 'dev'
+Requires-Dist: bump-my-version>=0.28; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: python-jose[cryptography]>=3.3; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: sqlalchemy[asyncio]>=2.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Requires-Dist: mkdocs>=1.6; extra == 'docs'
+Requires-Dist: pymdown-extensions>=10.0; extra == 'docs'
+Provides-Extra: graph
+Requires-Dist: networkx>=3.0; extra == 'graph'
+Provides-Extra: http
+Requires-Dist: fastapi>=0.115; extra == 'http'
+Requires-Dist: networkx>=3.0; extra == 'http'
+Requires-Dist: python-multipart>=0.0.18; extra == 'http'
+Requires-Dist: uvicorn[standard]>=0.34; extra == 'http'
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=3.0; extra == 'semantic'
+Provides-Extra: semantic-nomic
+Requires-Dist: einops; extra == 'semantic-nomic'
+Requires-Dist: sentence-transformers>=3.0; extra == 'semantic-nomic'
+Provides-Extra: service
+Requires-Dist: alembic>=1.14; extra == 'service'
+Requires-Dist: arq>=0.26; extra == 'service'
+Requires-Dist: asyncpg>=0.30; extra == 'service'
+Requires-Dist: bcrypt>=4.0; extra == 'service'
+Requires-Dist: cryptography>=41.0; extra == 'service'
+Requires-Dist: fastapi>=0.115; extra == 'service'
+Requires-Dist: httpx-oauth>=0.15; extra == 'service'
+Requires-Dist: networkx>=3.0; extra == 'service'
+Requires-Dist: pgvector>=0.3; extra == 'service'
+Requires-Dist: pydantic-settings>=2.0; extra == 'service'
+Requires-Dist: pygit2>=1.14; extra == 'service'
+Requires-Dist: python-jose[cryptography]>=3.3; extra == 'service'
+Requires-Dist: python-multipart>=0.0.18; extra == 'service'
+Requires-Dist: redis[hiredis]>=5.0; extra == 'service'
+Requires-Dist: sqlalchemy[asyncio]>=2.0; extra == 'service'
+Requires-Dist: uvicorn[standard]>=0.34; extra == 'service'
+Provides-Extra: tree-sitter-all
+Requires-Dist: tree-sitter-language-pack>=0.6; extra == 'tree-sitter-all'
+Description-Content-Type: text/markdown
+
+# attocode-code-intel
+
+Local code search and navigation for coding agents and for people. It runs as an MCP server for Codex, Claude Code, Cursor and other MCP clients, and as a command in your terminal. It needs no model, no API key and no network.
+
+**Status: beta.** We measured the search quality (see [What we measured](#what-we-measured)). We have not shown that it makes agents faster or more accurate.
+
+## Quickstart
+
+You need Python 3.12 or later and Git.
+
+```sh
+uv tool install attocode-code-intel
+cd /path/to/your/project
+attocode-code-intel init
+```
+
+Then restart your agent. `init` configures Codex, Claude Code and Cursor. Use `--client claude`, `--client codex` or `--client cursor` for one client. Codex needs a trusted project for a project configuration. Claude Code can ask you to enable the project MCP server.
+
+To check the setup, run `attocode-code-intel doctor`. It starts the configured server, calls two tools and shows the result for each client.
+
+For other clients (VS Code, Zed, Windsurf, Claude Desktop and more), run `attocode-code-intel install <target>`. `attocode-code-intel commands` lists the targets.
+
+To use the latest source, install from a clone of this repository: `uv tool install /path/to/attocode/packages/code-intel`.
+
+## What your agent gets
+
+Version 0.1.7 also provides `changes` and `trace` commands: investigate a diff,
+follow source-backed caller paths, export JSON/Markdown, and check or refresh saved
+evidence. MCP equivalents `change_context` and `trace_flow` are local full-profile
+tools. See the [change investigation guide](https://github.com/eren23/attocode/blob/main/docs/guides/change-investigation.md).
+
+The agent sees 16 tools (the `daily` profile):
+
+| Use | Tools |
+|---|---|
+| Find code | `semantic_search`, `fast_search`, `search_symbols`, `bootstrap`, `relevant_context` |
+| Read a symbol | `inspect_symbol`, `symbols`, `cross_references`, `call_graph` |
+| See structure | `dependencies`, `explore_codebase`, `project_summary` |
+| Plan a change | `impact_analysis`, `suggest_tests`, `review_change` |
+| Check the server | `capabilities` |
+
+- When the agent knows a symbol, `inspect_symbol(symbol_name="...", task_hint="...")` gives the definition, the source, the references and candidate tests in one call.
+- In an unfamiliar repository, `bootstrap(task_hint="...")` finds the relevant code and gives a map.
+- `impact_analysis` and `suggest_tests` help plan the checks for a change.
+
+For all tools (about 140: rules, security scans, history, snapshots and more), add `--profile full` to `init`. The [tool catalog](https://github.com/eren23/attocode/blob/main/docs/intelligence-tools.md) lists them. The [search details](https://github.com/eren23/attocode/blob/main/docs/intelligence-search.md) page describes ranking, the response format and the experimental rerankers.
+
+For an experimental local seven-tool surface (0.1.5 or later), use
+`init --profile lean` and restart your client. It advertises `bootstrap`,
+`search_symbols`, `inspect_symbol`, `semantic_search`, `impact_analysis`,
+`suggest_tests` and `capabilities`, with conditional routing instructions
+and 2,000-token responses. Without file watching, `notify_file_changed`
+is an eighth tool. Advanced tools require a full-profile session.
+This opt-in profile has no demonstrated completion benefit; see the
+[completed pilot](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-14-r7-completion-pilot.md).
+
+## Commands for people
+
+Run these in your project:
+
+```sh
+attocode-code-intel query "parse config"      # search the code with its own words
+attocode-code-intel symbols src/app.py        # the symbols of a file
+attocode-code-intel symbols --search greet    # find a symbol by name
+attocode-code-intel impact src/app.py         # the files that a change can affect
+attocode-code-intel deps src/app.py           # what a file imports, and what imports it
+attocode-code-intel hotspots                  # the files with the most risk or complexity
+```
+
+Search matches the words of the code and its paths. It does not use embeddings unless you install the `semantic` extra.
+
+## What we measured
+
+- **Search.** We ran the 560 issues of Loc-Bench V1, with the full issue as the query. For 53.2% of them, the first five files held all files of the fix (file Acc@5 0.532). On a mix of 10 public benchmarks, file Acc@5 was 0.425. See the [first-stage results](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-09-locbench-560-first-stage.md) and the [matrix results](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-10-matrix-r1.md).
+- **Agents.** In four studies, Claude Code (Sonnet 5.5) named the files to edit for an issue. The server did not raise file Acc@5. Each run with the server cost 1.4 to 2.1 times as much. When the agent could choose, it seldom called the server. See the [agent pilot](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-10-agent-pilot.md) and [study R3](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-10-agent-r3.md).
+
+The [R6 review study](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-13-r6-review-test-note.md)
+found no demonstrated review benefit. The [completed R7 repair pilot](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-14-r7-completion-pilot.md)
+also found no demonstrated benefit; its reviewed decision is to stop expansion.
+
+## Limits and troubleshooting
+
+- **First search.** The first tool call starts the index build. A search waits up to 15 seconds for the index. On a large repository, a search can report that the index is warming. Then search again. An empty result during warm-up does not prove that the code is absent.
+- **Index location.** The index is in `.attocode/` in your project. When the server makes that folder, it adds a `.gitignore`, so the index stays out of commits.
+- **What the index reads.** The server reads at most 50,000 files and skips files over 1 MB. It skips files that `.gitignore` ignores, and folders that start with a dot. It also skips folders named `dist`, `build`, `out`, `output`, `target`, `env`, `tmp`, `vendor` or `coverage`, and binary, media and lock files. If a build-named folder contains real source, explicitly re-include it with a root `.gitignore` entry such as `!dist/`; discovery and edit refresh honor that override.
+- **Languages.** The base install parses Bash, C, C#, C++, CSS, Elixir, Go, HCL, HTML, Java, JavaScript, JSON, Kotlin, Lua, PHP, Python, Ruby, Rust, Scala, Swift, TOML, TypeScript, YAML and Zig. Optional grammars are loaded only when already installed or cached; installing the `tree-sitter-all` extra does not trigger grammar downloads during navigation. A slow grammar falls back after a 100 ms parse budget. Static imports and references are partial evidence, not compiler/type resolution.
+- **Test paths.** Search and test suggestions recognize conventional test folders and filenames, plus supported Kotlin/Android source sets directly under `src` (for example `commonTest`, `jvmTest`, `androidHostTest` and `androidDeviceTest`). Helpers in those sets count as test code even without a test filename. Custom target or flavor names are not inferred from a `Test` suffix alone. Short queries explicitly asking for tests put recognized test files first, preserving order within each group; longer issue descriptions keep source-first behavior. Suggestions can include helpers; verify the actual runnable tests.
+- **Remove the setup.** Run `attocode-code-intel init --remove`. It restores an entry that existed before `init`.
+- **Server does not answer.** Run `attocode-code-intel doctor`. If a client shows "not configured", run `init` for it. After a change, restart the agent. In Claude Code, `/mcp` shows the server state.
+- **HTTP server.** `attocode-code-intel --transport http` needs the `http` extra. It serves only this computer unless you set `ATTOCODE_API_KEY`.
+
+For one installation for all repositories, use `init --global`. A global server works on the repository of its working directory, or on the `workspace` that a tool call names.
+
+## Teams and remote agents
+
+[Self-hosting and migration](https://github.com/eren23/attocode/blob/main/docs/intelligence.md) covers PostgreSQL, Redis, workers, authentication, and the dashboard. The service serves native Streamable HTTP MCP at `/mcp/`. The dashboard provides connection snippets and knowledge editing.
+
+```sh
+attocode-code-intel init --client all --server https://intel.example.com --repo REPOSITORY_UUID
+attocode-code-intel doctor --client codex --remote
+```
+
+Set `ATTOCODE_API_KEY` in the agent's environment. Use `intelligence:read` for analysis and add `intelligence:write` for knowledge changes. Every repository operation checks membership and scope before using cached analysis. Results identify repository, source, commit, index coverage, and truncation. PostgreSQL stores shared knowledge with authorship, revision, and file anchors.
+
+Local and remote entries coexist. Remote calls analyze committed branches or explicit revisions. Local edits remain local. To copy a particular learning to your team, review and run an explicit share:
+
+```sh
+attocode-code-intel share --project . --learning 12 --server https://intel.example.com --repo REPOSITORY_UUID --dry-run
+attocode-code-intel share --project . --learning 12 --server https://intel.example.com --repo REPOSITORY_UUID
+```
+
+`cross_repo_search` searches explicitly selected authorized repositories and retains provenance on each result.
+
+## Development
+
+The package is in `packages/code-intel` of the [attocode repository](https://github.com/eren23/attocode).
+
+```sh
+uv sync --extra dev --extra code-intel
+uv run pytest -c packages/code-intel/pyproject.toml --confcutdir=packages/code-intel/tests packages/code-intel/tests
+uv build --package attocode-code-intel
+```
+
+For routine work, use `.venv/bin/python -m eval.quality quick` (two minutes)
+or `local` (ten minutes). They isolate scratch and caches in a monitored 5 GiB
+workspace and report incomplete runs separately from passes. The
+[quality guide](https://github.com/eren23/attocode/blob/main/docs/intelligence-quality.md) covers pinned multi-language
+workflow checks, storage inventory, cleanup and optional CPU cloud batches.
+
+Releases use `intel-v*` tags ([release guide](https://github.com/eren23/attocode/blob/main/docs/intelligence-release.md)).
+
+[Product and operations guide](https://github.com/eren23/attocode/blob/main/docs/intelligence.md) · [Tool catalog](https://github.com/eren23/attocode/blob/main/docs/intelligence-tools.md) · [Search details](https://github.com/eren23/attocode/blob/main/docs/intelligence-search.md) · [Changelog](https://github.com/eren23/attocode/blob/main/CHANGELOG.md) · [MIT license](https://github.com/eren23/attocode/blob/main/packages/code-intel/LICENSE)

attocode_code_intel-0.1.7/README.md

@@ -0,0 +1,132 @@
+# attocode-code-intel
+
+Local code search and navigation for coding agents and for people. It runs as an MCP server for Codex, Claude Code, Cursor and other MCP clients, and as a command in your terminal. It needs no model, no API key and no network.
+
+**Status: beta.** We measured the search quality (see [What we measured](#what-we-measured)). We have not shown that it makes agents faster or more accurate.
+
+## Quickstart
+
+You need Python 3.12 or later and Git.
+
+```sh
+uv tool install attocode-code-intel
+cd /path/to/your/project
+attocode-code-intel init
+```
+
+Then restart your agent. `init` configures Codex, Claude Code and Cursor. Use `--client claude`, `--client codex` or `--client cursor` for one client. Codex needs a trusted project for a project configuration. Claude Code can ask you to enable the project MCP server.
+
+To check the setup, run `attocode-code-intel doctor`. It starts the configured server, calls two tools and shows the result for each client.
+
+For other clients (VS Code, Zed, Windsurf, Claude Desktop and more), run `attocode-code-intel install <target>`. `attocode-code-intel commands` lists the targets.
+
+To use the latest source, install from a clone of this repository: `uv tool install /path/to/attocode/packages/code-intel`.
+
+## What your agent gets
+
+Version 0.1.7 also provides `changes` and `trace` commands: investigate a diff,
+follow source-backed caller paths, export JSON/Markdown, and check or refresh saved
+evidence. MCP equivalents `change_context` and `trace_flow` are local full-profile
+tools. See the [change investigation guide](https://github.com/eren23/attocode/blob/main/docs/guides/change-investigation.md).
+
+The agent sees 16 tools (the `daily` profile):
+
+| Use | Tools |
+|---|---|
+| Find code | `semantic_search`, `fast_search`, `search_symbols`, `bootstrap`, `relevant_context` |
+| Read a symbol | `inspect_symbol`, `symbols`, `cross_references`, `call_graph` |
+| See structure | `dependencies`, `explore_codebase`, `project_summary` |
+| Plan a change | `impact_analysis`, `suggest_tests`, `review_change` |
+| Check the server | `capabilities` |
+
+- When the agent knows a symbol, `inspect_symbol(symbol_name="...", task_hint="...")` gives the definition, the source, the references and candidate tests in one call.
+- In an unfamiliar repository, `bootstrap(task_hint="...")` finds the relevant code and gives a map.
+- `impact_analysis` and `suggest_tests` help plan the checks for a change.
+
+For all tools (about 140: rules, security scans, history, snapshots and more), add `--profile full` to `init`. The [tool catalog](https://github.com/eren23/attocode/blob/main/docs/intelligence-tools.md) lists them. The [search details](https://github.com/eren23/attocode/blob/main/docs/intelligence-search.md) page describes ranking, the response format and the experimental rerankers.
+
+For an experimental local seven-tool surface (0.1.5 or later), use
+`init --profile lean` and restart your client. It advertises `bootstrap`,
+`search_symbols`, `inspect_symbol`, `semantic_search`, `impact_analysis`,
+`suggest_tests` and `capabilities`, with conditional routing instructions
+and 2,000-token responses. Without file watching, `notify_file_changed`
+is an eighth tool. Advanced tools require a full-profile session.
+This opt-in profile has no demonstrated completion benefit; see the
+[completed pilot](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-14-r7-completion-pilot.md).
+
+## Commands for people
+
+Run these in your project:
+
+```sh
+attocode-code-intel query "parse config"      # search the code with its own words
+attocode-code-intel symbols src/app.py        # the symbols of a file
+attocode-code-intel symbols --search greet    # find a symbol by name
+attocode-code-intel impact src/app.py         # the files that a change can affect
+attocode-code-intel deps src/app.py           # what a file imports, and what imports it
+attocode-code-intel hotspots                  # the files with the most risk or complexity
+```
+
+Search matches the words of the code and its paths. It does not use embeddings unless you install the `semantic` extra.
+
+## What we measured
+
+- **Search.** We ran the 560 issues of Loc-Bench V1, with the full issue as the query. For 53.2% of them, the first five files held all files of the fix (file Acc@5 0.532). On a mix of 10 public benchmarks, file Acc@5 was 0.425. See the [first-stage results](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-09-locbench-560-first-stage.md) and the [matrix results](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-10-matrix-r1.md).
+- **Agents.** In four studies, Claude Code (Sonnet 5.5) named the files to edit for an issue. The server did not raise file Acc@5. Each run with the server cost 1.4 to 2.1 times as much. When the agent could choose, it seldom called the server. See the [agent pilot](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-10-agent-pilot.md) and [study R3](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-10-agent-r3.md).
+
+The [R6 review study](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-13-r6-review-test-note.md)
+found no demonstrated review benefit. The [completed R7 repair pilot](https://github.com/eren23/attocode/blob/main/packages/code-intel/evals/results/2026-10-14-r7-completion-pilot.md)
+also found no demonstrated benefit; its reviewed decision is to stop expansion.
+
+## Limits and troubleshooting
+
+- **First search.** The first tool call starts the index build. A search waits up to 15 seconds for the index. On a large repository, a search can report that the index is warming. Then search again. An empty result during warm-up does not prove that the code is absent.
+- **Index location.** The index is in `.attocode/` in your project. When the server makes that folder, it adds a `.gitignore`, so the index stays out of commits.
+- **What the index reads.** The server reads at most 50,000 files and skips files over 1 MB. It skips files that `.gitignore` ignores, and folders that start with a dot. It also skips folders named `dist`, `build`, `out`, `output`, `target`, `env`, `tmp`, `vendor` or `coverage`, and binary, media and lock files. If a build-named folder contains real source, explicitly re-include it with a root `.gitignore` entry such as `!dist/`; discovery and edit refresh honor that override.
+- **Languages.** The base install parses Bash, C, C#, C++, CSS, Elixir, Go, HCL, HTML, Java, JavaScript, JSON, Kotlin, Lua, PHP, Python, Ruby, Rust, Scala, Swift, TOML, TypeScript, YAML and Zig. Optional grammars are loaded only when already installed or cached; installing the `tree-sitter-all` extra does not trigger grammar downloads during navigation. A slow grammar falls back after a 100 ms parse budget. Static imports and references are partial evidence, not compiler/type resolution.
+- **Test paths.** Search and test suggestions recognize conventional test folders and filenames, plus supported Kotlin/Android source sets directly under `src` (for example `commonTest`, `jvmTest`, `androidHostTest` and `androidDeviceTest`). Helpers in those sets count as test code even without a test filename. Custom target or flavor names are not inferred from a `Test` suffix alone. Short queries explicitly asking for tests put recognized test files first, preserving order within each group; longer issue descriptions keep source-first behavior. Suggestions can include helpers; verify the actual runnable tests.
+- **Remove the setup.** Run `attocode-code-intel init --remove`. It restores an entry that existed before `init`.
+- **Server does not answer.** Run `attocode-code-intel doctor`. If a client shows "not configured", run `init` for it. After a change, restart the agent. In Claude Code, `/mcp` shows the server state.
+- **HTTP server.** `attocode-code-intel --transport http` needs the `http` extra. It serves only this computer unless you set `ATTOCODE_API_KEY`.
+
+For one installation for all repositories, use `init --global`. A global server works on the repository of its working directory, or on the `workspace` that a tool call names.
+
+## Teams and remote agents
+
+[Self-hosting and migration](https://github.com/eren23/attocode/blob/main/docs/intelligence.md) covers PostgreSQL, Redis, workers, authentication, and the dashboard. The service serves native Streamable HTTP MCP at `/mcp/`. The dashboard provides connection snippets and knowledge editing.
+
+```sh
+attocode-code-intel init --client all --server https://intel.example.com --repo REPOSITORY_UUID
+attocode-code-intel doctor --client codex --remote
+```
+
+Set `ATTOCODE_API_KEY` in the agent's environment. Use `intelligence:read` for analysis and add `intelligence:write` for knowledge changes. Every repository operation checks membership and scope before using cached analysis. Results identify repository, source, commit, index coverage, and truncation. PostgreSQL stores shared knowledge with authorship, revision, and file anchors.
+
+Local and remote entries coexist. Remote calls analyze committed branches or explicit revisions. Local edits remain local. To copy a particular learning to your team, review and run an explicit share:
+
+```sh
+attocode-code-intel share --project . --learning 12 --server https://intel.example.com --repo REPOSITORY_UUID --dry-run
+attocode-code-intel share --project . --learning 12 --server https://intel.example.com --repo REPOSITORY_UUID
+```
+
+`cross_repo_search` searches explicitly selected authorized repositories and retains provenance on each result.
+
+## Development
+
+The package is in `packages/code-intel` of the [attocode repository](https://github.com/eren23/attocode).
+
+```sh
+uv sync --extra dev --extra code-intel
+uv run pytest -c packages/code-intel/pyproject.toml --confcutdir=packages/code-intel/tests packages/code-intel/tests
+uv build --package attocode-code-intel
+```
+
+For routine work, use `.venv/bin/python -m eval.quality quick` (two minutes)
+or `local` (ten minutes). They isolate scratch and caches in a monitored 5 GiB
+workspace and report incomplete runs separately from passes. The
+[quality guide](https://github.com/eren23/attocode/blob/main/docs/intelligence-quality.md) covers pinned multi-language
+workflow checks, storage inventory, cleanup and optional CPU cloud batches.
+
+Releases use `intel-v*` tags ([release guide](https://github.com/eren23/attocode/blob/main/docs/intelligence-release.md)).
+
+[Product and operations guide](https://github.com/eren23/attocode/blob/main/docs/intelligence.md) · [Tool catalog](https://github.com/eren23/attocode/blob/main/docs/intelligence-tools.md) · [Search details](https://github.com/eren23/attocode/blob/main/docs/intelligence-search.md) · [Changelog](https://github.com/eren23/attocode/blob/main/CHANGELOG.md) · [MIT license](https://github.com/eren23/attocode/blob/main/packages/code-intel/LICENSE)

attocode_code_intel-0.1.7/evals/ast_restart_probe.py

@@ -0,0 +1,101 @@
+"""Generated Go cold+restart comparison with exact AST/index parity and cleanup."""
+from __future__ import annotations
+
+import ast
+import hashlib
+import json
+import platform
+import subprocess
+import tempfile
+import time
+from dataclasses import asdict
+from pathlib import Path
+from unittest.mock import patch
+
+from attocode_intel._internal.integrations.context import ast_service, ast_snapshot, codebase_ast
+from attocode_intel._internal.integrations.context.index_store import AST_SNAPSHOT_KEY
+
+BASELINE = 'b3501b9d7ae016572d77ceae1289026d23719694'
+SOURCE = 'packages/code-intel/src/attocode_intel/_internal/integrations/context/ast_service.py'
+
+
+def run():
+    source = subprocess.check_output(['git', 'show', f'{BASELINE}:{SOURCE}'], timeout=10)
+    cls = next(n for n in ast.parse(source).body if isinstance(n, ast.ClassDef) and n.name == 'ASTService')
+    methods, scopes = {}, []
+    for name in ('initialize_skeleton', '_save_snapshot', '_restore_snapshot'):
+        method = next(n for n in cls.body if isinstance(n, ast.FunctionDef) and n.name == name)
+        scope = dict(vars(ast_service))
+        exec(compile(ast.Module(body=[method], type_ignores=[]), '<frozen restart>', 'exec'), scope)
+        methods[name] = scope[name]
+        scopes.append(scope)
+    original = {name: getattr(ast_service.ASTService, name) for name in methods}
+    observations = []
+    with tempfile.TemporaryDirectory(prefix='attocode-restart-probe-') as tmp:
+        root = Path(tmp)
+        workloads = ['short_body', 'long_body']
+        source_sizes = {}
+        for number, (workload, mode) in enumerate((w, m) for w in workloads
+                for m in ['baseline', 'candidate', 'candidate', 'baseline']):
+            for scope in scopes:
+                scope['parse_file'] = ast_service.parse_file
+            project = root / str(number)
+            project.mkdir()
+            for i in range(160):
+                (project / f'file{i:04d}.go').write_text('package example\n' + ''.join(
+                    f'// Helper{i}_{j} returns an adjusted value.\nfunc Helper{i}_{j}(value int) int {{\n'
+                    + '    if value < 0 { return 0 }\n' * (1 if workload == 'short_body' else 12)
+                    + '    return value + 1\n}\n' for j in range(32)))
+            source_sizes[workload] = sum(p.stat().st_size for p in project.iterdir())
+            assert source_sizes[workload] < 8 * 2**20
+            with patch.multiple(ast_service.ASTService, **(methods if mode == 'baseline' else original)):
+                first = ast_service.ASTService(str(project))
+                start = time.monotonic()
+                try:
+                    first.initialize_skeleton(indexing_depth='eager')
+                    cold = time.monotonic() - start
+                    payload_bytes = len((first._store.get_meta(AST_SNAPSHOT_KEY) or '').encode())
+                finally:
+                    first.stop_hydration()
+                    first._store.close()
+                second = ast_service.ASTService(str(project))
+                try:
+                    with (patch.object(ast_service, 'parse_file', wraps=ast_service.parse_file) as parse,
+                          patch.object(codebase_ast, 'parse_file', parse)):
+                        for scope in scopes:
+                            scope['parse_file'] = parse
+                        wall, cpu = time.monotonic(), time.thread_time()
+                        state = second.initialize_skeleton()
+                        restart, thread_cpu = time.monotonic()-wall, time.thread_time()-cpu
+                        calls = parse.call_count
+                    assert state.phase == 'ready' and state.parsed_files == 160
+                    assert calls == (320 if mode == 'baseline' else 0)
+                    summaries = {key: {**asdict(value), 'path': key} for key, value in second._ast_cache.items()}
+                    evidence = {'asts': summaries, 'definitions': {
+                        key: [asdict(v) for v in value] for key, value in second._index.definitions.items()},
+                        'stats': second._store.stats(), 'dependencies': {
+                            key: sorted(value) for key, value in second._index.file_dependencies.items()}}
+                    digest = hashlib.sha256(json.dumps(evidence, sort_keys=True).encode()).hexdigest()
+                    observations.append({'mode': mode, 'workload': workload, 'cold_seconds': cold, 'restart_seconds': restart,
+                                         'cold_plus_restart_seconds': cold+restart, 'restart_thread_cpu_seconds': thread_cpu,
+                                         'restart_parse_calls': calls, 'cache_payload_bytes': payload_bytes,
+                                         'evidence_sha256': digest})
+                finally:
+                    second.stop_hydration()
+                    second._store.close()
+        for workload in workloads:
+            assert len({row['evidence_sha256'] for row in observations if row['workload'] == workload}) == 1
+        disk_bytes = sum(p.stat().st_size for p in root.rglob('*') if p.is_file())
+        assert disk_bytes < 100 * 2**20
+    return {'scope': 'Generated 160-file/5120-function Go cold+restart; no Cockroach or cloud speed claim',
+            'baseline_commit': BASELINE, 'baseline_source_sha256': hashlib.sha256(source).hexdigest(),
+            'candidate_source_sha256': hashlib.sha256(Path(ast_service.__file__).read_bytes()).hexdigest(),
+            'cache_source_sha256': hashlib.sha256(Path(ast_snapshot.__file__).read_bytes()).hexdigest(),
+            'probe_sha256': hashlib.sha256(Path(__file__).read_bytes()).hexdigest(),
+            'python': platform.python_version(), 'platform': platform.platform(),
+            'source_bytes': source_sizes, 'final_owned_disk_bytes': disk_bytes,
+            'observations': observations, 'cleanup_verified': not root.exists()}
+
+
+if __name__ == '__main__':
+    print(json.dumps(run(), indent=2))