attocode-code-intel 0.1.13__tar.gz → 0.1.14__tar.gz

{attocode_code_intel-0.1.13 → attocode_code_intel-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: attocode-code-intel
-Version: 0.1.13
+Version: 0.1.14
 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
@@ -130,6 +130,8 @@ 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.
+Development builds also report the executable and server version returned by
+that new probe. An already running client session must be checked separately.
 
 For other clients (VS Code, Zed, Windsurf, Claude Desktop and more), run `attocode-code-intel install <target>`. `attocode-code-intel commands` lists the targets.
 
@@ -149,7 +151,9 @@ tests, such as `_test.dart` and Perl `.t` scripts and `t/` modules. Version
 0.1.12 makes `doctor --client claude` read the local-scope entry that
 `claude mcp add` writes to `~/.claude.json`. Version 0.1.13 fills compact search
 pages within their budget, offers bounded deeper searches, and repairs stale
-navigation indexes after successful restart parsing. See the [change investigation guide](https://github.com/eren23/attocode/blob/main/docs/guides/change-investigation.md).
+navigation indexes after successful restart parsing. Version 0.1.14 adds bounded
+selected-file recovery, safe navigation publication, guarded Elixir definitions
+and doctor probe identity. 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):
 
@@ -206,6 +210,11 @@ also found no demonstrated benefit; its reviewed decision is to stop expansion.
 - **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.
+- **Degraded parsing (development builds).** Selecting a missing definition in
+  a file with a recorded native parse failure permits one bounded retry for
+  that source/parser generation. A failed retry reports partial evidence and
+  an `attocode-code-intel notify` command to queue a file refresh. Empty results
+  and ordinary syntax errors do not trigger this recovery.
 - **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.

{attocode_code_intel-0.1.13 → attocode_code_intel-0.1.14}/README.md

@@ -17,6 +17,8 @@ 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.
+Development builds also report the executable and server version returned by
+that new probe. An already running client session must be checked separately.
 
 For other clients (VS Code, Zed, Windsurf, Claude Desktop and more), run `attocode-code-intel install <target>`. `attocode-code-intel commands` lists the targets.
 
@@ -36,7 +38,9 @@ tests, such as `_test.dart` and Perl `.t` scripts and `t/` modules. Version
 0.1.12 makes `doctor --client claude` read the local-scope entry that
 `claude mcp add` writes to `~/.claude.json`. Version 0.1.13 fills compact search
 pages within their budget, offers bounded deeper searches, and repairs stale
-navigation indexes after successful restart parsing. See the [change investigation guide](https://github.com/eren23/attocode/blob/main/docs/guides/change-investigation.md).
+navigation indexes after successful restart parsing. Version 0.1.14 adds bounded
+selected-file recovery, safe navigation publication, guarded Elixir definitions
+and doctor probe identity. 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):
 
@@ -93,6 +97,11 @@ also found no demonstrated benefit; its reviewed decision is to stop expansion.
 - **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.
+- **Degraded parsing (development builds).** Selecting a missing definition in
+  a file with a recorded native parse failure permits one bounded retry for
+  that source/parser generation. A failed retry reports partial evidence and
+  an `attocode-code-intel notify` command to queue a file refresh. Empty results
+  and ordinary syntax errors do not trigger this recovery.
 - **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.

attocode_code_intel-0.1.14/evals/results/2026-10-21-test-case-spans-decision.json

@@ -0,0 +1,140 @@
+{
+  "status": "rejected",
+  "checks": {
+    "two_new_first_page_matches_every_round": false,
+    "gains_in_both_repositories_every_round": false,
+    "no_file_or_excerpt_loss": false,
+    "controls_identical": true,
+    "warm_p95_each_round": true,
+    "cleanup_verified": true
+  },
+  "gains": [],
+  "losses": [
+    {
+      "id": "express:fresh-test-spans-01",
+      "round": 0,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/res.status.js"
+    },
+    {
+      "id": "express:fresh-test-spans-01",
+      "round": 1,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/res.status.js"
+    },
+    {
+      "id": "express:fresh-test-spans-01",
+      "round": 2,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/res.status.js"
+    },
+    {
+      "id": "express:fresh-test-spans-04",
+      "round": 0,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/req.get.js"
+    },
+    {
+      "id": "express:fresh-test-spans-04",
+      "round": 1,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/req.get.js"
+    },
+    {
+      "id": "express:fresh-test-spans-04",
+      "round": 2,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/req.get.js"
+    },
+    {
+      "id": "express:fresh-test-spans-11",
+      "round": 0,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/res.sendStatus.js"
+    },
+    {
+      "id": "express:fresh-test-spans-11",
+      "round": 1,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/res.sendStatus.js"
+    },
+    {
+      "id": "express:fresh-test-spans-11",
+      "round": 2,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/res.sendStatus.js"
+    },
+    {
+      "id": "express:fresh-test-spans-12",
+      "round": 0,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/app.head.js"
+    },
+    {
+      "id": "express:fresh-test-spans-12",
+      "round": 1,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/app.head.js"
+    },
+    {
+      "id": "express:fresh-test-spans-12",
+      "round": 2,
+      "depth": 5,
+      "kind": "files",
+      "label": "test/app.head.js"
+    }
+  ],
+  "p95_seconds": {
+    "0": {
+      "baseline": 0.0862042079679668,
+      "candidate": 0.07823979202657938
+    },
+    "1": {
+      "baseline": 0.08303270791657269,
+      "candidate": 0.08827808301430196
+    },
+    "2": {
+      "baseline": 0.07845087500754744,
+      "candidate": 0.07912220794241875
+    }
+  },
+  "counts": {
+    "5": {
+      "baseline": {
+        "files": 15,
+        "excerpts": 4
+      },
+      "candidate": {
+        "files": 11,
+        "excerpts": 6
+      }
+    },
+    "24": {
+      "baseline": {
+        "files": 15,
+        "excerpts": 4
+      },
+      "candidate": {
+        "files": 16,
+        "excerpts": 11
+      }
+    }
+  },
+  "evidence_scope": "consumed_development",
+  "fresh_validation_performed": false,
+  "initial_attempt": "operator_invalid; zero callback units; not relevance evidence",
+  "candidate_rule_unchanged": true,
+  "archive_sha256": "c2bc98099fe2e66b7815c75ecf5395ba436ac73ade2088507d79630987df79b4",
+  "questions_sha256": "c09fd7845c4cd0477b64d60debd4ff7c523f837123f71f992557022432c3b370"
+}

attocode_code_intel-0.1.14/evals/results/2026-10-21-test-case-spans.md

@@ -0,0 +1,78 @@
+# JavaScript/TypeScript test-case spans — rejected on development
+
+The initial comparison is **operator-invalid**, not a test of the intended
+callback-span hypothesis. macOS workspace aliases (`/var` versus `/private/var`)
+caused the adapter to fail before extraction. The index caught that exception
+and used file windows. All 2,088 candidate hit occurrences were file windows;
+there were zero callback units. The earlier arithmetic rejection must not be
+interpreted as evidence that correctly indexed callback spans are ineffective.
+
+An independent author and reviewer grounded 24 new questions in pinned Express
+and Prisma sources before that attempt. The questions are now consumed. Any
+corrected comparison on them is development evidence, not fresh validation.
+The initial failed source-copy attempt, fallback-only comparison, raw pages,
+operators and earlier uncommitted report/archive are retained privately.
+
+The technical correction canonicalizes workspace and AST paths. An alias-path
+regression fails before the fix and passes afterward. Before any query, the
+operator requires actual indexed callback windows, identical keyword-document
+hashes, and identical full function/method-window hashes. Class fallback window
+counts can legitimately change when a callback owner replaces that source span;
+an earlier overly strict admission check stopped Prisma before querying and is
+also retained. The extraction rule, scoring configuration and questions did not
+change. **No search ranking change is enabled in product.**
+
+## Corrected, admitted development comparison
+
+The rule recognizes literal `it`/`test` callbacks and single `.only`/`.skip`
+forms in JavaScript/TypeScript test paths. Dynamic titles, arbitrary receivers
+and parameterized DSLs are not inferred. It adds search-only body units, without
+creating navigation definitions. Only short explicit test queries use the
+alternate index; ordinary queries use the original index.
+
+The corrected comparison ran three alternating rounds through actual compact
+MCP delivery, requesting depths 5 and 24 with 2,000 and 8,000 token budgets.
+Admission found 1,127 test-case windows from 1,119 distinct owners in Express,
+and 4,809 windows from 3,935 owners in Prisma. Keyword and function/method-window
+hashes match their baseline in each repository. The delivered results include
+1,167 test-case hit occurrences, unlike the invalid initial attempt.
+
+| Delivered evidence | Baseline | Candidate |
+|---|---:|---:|
+| Labeled query/file matches at 5 | 15 | 11 |
+| Labeled query/file matches at 24 | 15 | 16 |
+| Labeled excerpts at 5 | 4 | 6 |
+| Labeled excerpts at 24 | 4 | 11 |
+
+Counts are identical in all three rounds. There are zero new first-page file
+matches. Express status validation, referrer lookup, `sendStatus`, and HEAD
+fallback each lose a labeled file at five in every round: 12 loss observations
+over four questions. Extra excerpt matches do not satisfy the frozen no-loss
+rule. **Reject on consumed development; skip new fresh validation and do not
+retune this rule.** This is not a held-out relevance gain or general search-quality
+claim.
+
+Warm p95 was 86.2/83.0/78.5 ms for baseline and 78.2/88.3/79.1 ms for candidate.
+All three latency checks pass. All six ordinary-query raw control pairs match.
+The two admitted workers took 27.609 seconds, with peak sampled RSS 188.3 MiB
+and peak managed storage 135.3 MiB. Child cleanup and owned scratch removal pass.
+No model, source download or cloud worker was used for this comparison.
+
+## Replay and limits
+
+The [decision](2026-10-21-test-case-spans-decision.json) binds the
+[archive](2026-10-21-test-case-spans.tar.gz). Extract it outside the checkout and
+run its `replay.py` with this repository and `packages/code-intel/src` on
+`PYTHONPATH`. It verifies file hashes, recomputes all 288 admitted page judgments,
+checks controls and representation admissions, and reproduces every gate without
+retrieval or network access. The earlier invalid attempt is explicitly segregated
+inside the archive and does not contribute to the development decision.
+
+Public envelopes retain result data; private workspace metadata is omitted and
+control follow-up roots use `$SOURCE_ROOT`. Source snippets, coordinates, ordering,
+timings and judgments are unchanged; original response hashes are recorded.
+Independent review checked 39 pinned label files, all request/order bindings,
+835 coordinate-bearing delivered windows including controls, and all admitted
+test-case hit identities. One metadata preview has no source coordinates and
+never earns excerpt credit. Labels are source-bound and non-exhaustive; no agent
+completion benefit is established.