• v0.41.49 a7ce9603e6

    code-index v0.41.49
    All checks were successful
    Pilot plugin compatibility / Pilot scope (push) Successful in 13s
    CI / changes (what this run must test) (push) Successful in 16s
    CI (Windows) / changes (what this run must test) (push) Successful in 16s
    CI (Windows) / fmt + clippy + build + test (windows) (push) Has been skipped
    Package CI / changes (which packages this run must test) (push) Successful in 17s
    Package CI / package suites (clippy) (push) Has been skipped
    Package CI / package (javascript) (push) Successful in 1s
    Package CI / package (php) (push) Successful in 1s
    Package CI / package (csharp) (push) Successful in 2s
    CI / cargo fmt (push) Successful in 24s
    Package CI / package (python) (push) Successful in 1s
    CI / cargo clippy (push) Has been skipped
    CI / cargo check (MSRV 1.99.1) (push) Has been skipped
    CI / cargo check (windows-gnu) (push) Has been skipped
    CI / cargo test (abi, 32-bit + wasm32) (push) Has been skipped
    CI / cargo deny (push) Has been skipped
    CI / CI lane wall-clock headroom (push) Has been skipped
    Package CI / package (ruby) (push) Successful in 1s
    CI / guest crates (fmt, clippy, doc) (push) Has been skipped
    CI / cargo doc (intra-doc links) (push) Has been skipped
    CI / OSS corpus (tier 1) (push) Has been skipped
    CI / OSS corpus tier-3 scale (nightly) (push) Has been skipped
    CI / Grammar rebuild from source (nightly) (push) Has been skipped
    CI / cargo test (push) Has been skipped
    Package CI / package (rust) (push) Successful in 2s
    CI / cargo test (daemon transport) (push) Has been skipped
    CI / Plugin path cost + pool throughput (nightly) (push) Has been skipped
    Package CI / package (svelte) (push) Successful in 1s
    Package CI / package (timeline) (push) Successful in 2s
    Package CI / package-corpus (csharp) (push) Successful in 2s
    Package CI / package (xaml) (push) Successful in 2s
    Package CI / package (vue) (push) Successful in 3s
    Package CI / package (typescript) (push) Successful in 3s
    Package CI / package-corpus (ruby) (push) Successful in 2s
    Package CI / package-corpus (javascript) (push) Successful in 3s
    Package CI / package-corpus (python) (push) Successful in 3s
    Package CI / package-corpus (php) (push) Successful in 3s
    Package CI / package-corpus (typescript) (push) Successful in 2s
    Package CI / package-corpus (rust) (push) Successful in 3s
    Package CI / package-corpus (vue) (push) Successful in 3s
    Package CI / package overhead budgets (nightly, one package at a time) (push) Has been skipped
    Package CI / package-corpus (svelte) (push) Successful in 3s
    Package CI / package-corpus (timeline) (push) Successful in 3s
    Package CI / package-corpus (xaml) (push) Successful in 2s
    Pilot plugin compatibility / Fetch the pinned runtime once (push) Successful in 15s
    Pilot plugin compatibility / Pilot compatibility (csharp) (push) Successful in 9s
    Pilot plugin compatibility / Pilot compatibility (timeline) (push) Successful in 10s
    Pilot plugin compatibility / Pilot compatibility result (push) Successful in 1s
    Release Build / Generate Version (push) Successful in 8s
    Release Build / Required CI green (push) Successful in 26s
    Release Build / Build linux-aarch64 (push) Successful in 11m58s
    Release Build / Build linux-x86_64-musl (push) Successful in 16m21s
    Release Build / Build linux-x86_64 (push) Successful in 18m4s
    Release Build / Build windows-x86_64 (push) Successful in 25m31s
    Release Build / Assemble the release archives (push) Successful in 41s
    Release Build / Windows archive smoke (msvc) (push) Successful in 1m17s
    Release Build / Create Forgejo Release (push) Successful in 21s
    Release Build / Seed the package channel (push) Has been skipped
    Package Release / The package grades its own bytes (push) Successful in 2m48s
    Package Release / Pack, sign and verify one package (push) Successful in 15s
    Package Release / Publish the package release (push) Successful in 11s
    Package Release / Update the package channel (push) Successful in 15s
    Stable

    buildagent released this 2026-11-11 16:44:00 +01:00 | 280 commits to master since this release

    code-index v0.41.49

    Build: pkg/de.h-dv.php/v0.1.6+2559

    Installer: install.sh and checksum. Both come from this release commit. To pin the installed binaries too, run it with --tag v0.41.49.

    Windows installer: install.ps1 and checksum, from the same release commit. It installs AND updates — the same code does both — verifies the archive against its published .sha256 before unpacking, refuses hostile archive members (absolute paths, .. escapes, symlinks and reparse points, which Expand-Archive does not protect you from), and grants nothing when it installs a package: the bytes go into the machine's store and the approving line is PRINTED for you to run from inside a project. -Help lists the flags; -Tag v0.41.49 pins the binaries.

    Four-binary release: code-index-mcp (MCP stdio bridge — the usual entry), code-index-daemon (long-lived watcher + RPC server, auto-spawned), code-index-plugin-host (bounded worker for plugin packages, spawned by the daemon), and code-index (CLI: init, index, watch, doctor, link, plugin).

    Breaking changes

    • The rules-file feature is removed. code-index init writes .code-index.toml and nothing else; the code-index rules command, init --no-rules and the hook installer (rules --hooks) no longer exist. Instruction blocks that earlier versions wrote into AGENTS.md, CLAUDE.md, .cursorrules, .windsurfrules, .clinerules, .github/copilot-instructions.md, .cursor/rules/code-index.mdc and .gemini/rules/code-index.md stay where they are; delete them by hand if you no longer want them (shared files carry the markers <!-- code-index:start --> and <!-- code-index:end -->). Already installed hooks keep working.
    • Agent guidance now comes from the MCP server instructions and the skill only. The skill is served over MCP as before; code-index skill install [--force] writes an on-disk copy to .claude/skills/code-index/SKILL.md on request. It refuses to write through a symlink or over a differing copy without --force, and doctor warns when an installed copy differs from the binary's skill. Nothing installs it implicitly.
    • An invalid .code-index.toml is refused at daemon start, indexing, the walker and watch through one shared loader. The diagnostic names the file and the accepted keys, with line and column for TOML syntax errors. Previously the daemon warned and used defaults, which could widen the walk past the configured ignores.

    Fixes

    • PHP resolution (#531, #566): qualified calls and constructors follow the written namespace path, imported class identity and the namespace\ marker; parent:: binds to the superclass declaration instead of the overriding method; a name written with a leading backslash binds only to the global symbol it names. In the bind account against v0.41.48 on all nine pinned repositories only php-guzzle moved: 55 binds removed, all audited wrong; 57 added and 5 retargeted, all audited correct; no correct bind lost. 1,632 unchanged targets move from the same-file relative rule to the fully qualified rule.
    • Script importers (#543): get_dependencies importers resolve relative and module paths by the importing row's language, including embedded scripts and imports of non-script files, and share their path candidates with binding. importers.total counts proven import rows; with total_is_lower_bound: true, unresolved_target_imports counts unresolved script rows that could name the target. Named imports bind exported constants and statics as well as functions. Other languages keep their previous module matching.
    • Conformance (#563): recorded derived-name and fact-role coverage is checked before the outcome. A failed verdict measured under a narrower grant answers conformance_not_run with the flags to run; only a covering failed verdict answers conformance_failed. Bridge authority is reported as not_graded: a verdict does not record or compare it.
    • State directory (#514): language state reads, first-start marker and state writes, the doctor probes and the workspace identity go through the state-directory guard, so a committed dangling symlink no longer creates its target outside the state directory.
    • stats no longer holds a pooled database reader while it surveys installed packages. A client polling it during startup could exhaust the readers and receive errors; this was already present in v0.41.48.

    Index state and reads

    • First contact and reconciliation (#562, #546 item 3): a negative answer is authoritative only once the index and language eligibility have settled. Until then populations carry measurement_basis: "floor" and misses answer index_incomplete; measured walk and size refusals stay valid. Refusals carry coverage_reason. The lifecycle state eligibility_pending means parsing is ready while grant discovery can still change routing.
    • One-shot calls wait for startup, bounded by CODE_INDEX_ONE_SHOT_WAIT_MS, and then dispatch once; read retryable and reconcile_pending.converges_on_retry, and reconcile_pending.wait_budget_ms when the wait was exhausted. A --no-daemon session can be reconciling, eligibility_pending or degraded; a degraded session answers non-retryable with the repair instruction from state_detail.
    • When .code-index.toml becomes invalid during a session, tools are refused with index_unavailable and reason invalid_configuration instead of answering empty results. The daemon stays alive, and after the file is repaired the session recovers without a restart and picks up the edits made in between.

    Configuration and arguments

    • watch --debounce-ms wins over the configured value, including when it equals the default.
    • logging.level, logging.format, workspace.name and plugins[].file have no runtime effect. They are no longer generated or documented; a config that still contains them loads and reports each as ineffective, at load and in doctor.
    • index.extra_ignores patterns are validated; an invalid pattern is refused with its list position and value. A malformed language-state file is disclosed instead of being read as "no decision".
    • languages.enabled entries are checked for form only: a malformed entry (for example "Ruby") is refused with the accepted form and, where one exists, the name that was probably meant. A well-formed name that no builtin and no installed package declares is accepted, so a config can name a language before its package is installed; the name is reported at load, in doctor and as a project_overview.language_ownership row with the repair, and the other languages are indexed. code-index languages enable <name> still refuses an unknown name and leaves the file untouched.
    • Configuration diagnostics print the same user-facing path form as the rest of the CLI (no \\?\ prefix on Windows).
    • MCP schemas state the ranges their handlers enforce (for example change_impact.max_depth 1–20, context_pack.token_budget 256–16000).
    • resolution_gaps with limit: 0 is count-only, like its sibling tools.
    • An unknown CODE_INDEX_ENVELOPE value is reported on stderr at startup and disclosed on tool replies (envelope_configuration) instead of silently selecting another mode. Precedence is per call, then environment, then default; the accepted values and aliases are listed in the envelope reference.

    Replies

    • code-index query (#561) prints one JSON document on stdout. Every content_in pointer is re-inlined, including batch entries; items no pointer names are kept in unreferenced_content_items.

    Documentation

    Server instructions and the skill state the benchmark precision as measured, on its task set, and add that a resolved target can still be wrong and how to check it. docs/operations.md defines the settlement fields, the retry contract and the configuration cases; docs/package-profiles.md is the complete reference for package-profile keys, including the new global_root and php_path_semantics, checked against the registry by a test.

    Compatibility and package updates

    The index schema is unchanged (93); existing indexes are not rebuilt.

    rustix is updated to 1.1.6 for RUSTSEC-2026-0486.

    PHP package 0.1.6 carries the extractor side of the namespace fix and requires this host (requires_host >=0.41.49); in the lane's measurement the previous host with the new package lost 1,694 binds, so the floor is enforced. This core release is therefore published first as a prerelease, the package is released against it, and the core is then promoted with the package bundled. No other package changed.

    Cold-index SQLite work on php-guzzle: sorts fall from 2,561 to 919; VM steps rise 4.6 %, of which about 91 % belongs to statements of the two new resolver passes (compared per statement before and after, on logged SQL prefixes). The six other repositories the cost gate measures move by less than 0.1 %. Time to ready for a small script project on two cores, cold state, three runs each: 6.2 s median on v0.41.48, 3.9 s on this release; host load varied, so no speed-up is claimed.

    Remaining scope

    • #566: Ruby ::Logger still binds to the namespaced logger at three audited sites, and the receiver-less member binds of the audit remain. The file-isolation rules built on positive contradictions are deferred: they removed 19 wrong binds without losing a correct one, but their additions and two integration checks are not yet qualified.
    • #563: verdicts do not record bridge authority, and enable does not re-run conformance for a wider grant.
    • #543: only script importer lookup and named-import binding are covered; the other languages' import routes in that issue remain open.
    • #521: one invalid seed refuses a whole change_impact call, and a dropped diff hunk is disclosed in aggregate, not per row. Both are documented in the tool descriptions.
    • #570: common arguments are not yet accepted uniformly across tools, and enum choices and effective defaults are not yet published consistently in the tool schemas.
    • #571: how agents are brought to use code-index is being rethought; none of the remaining channels has been measured against the removed rules files.

    Qualification

    • CI on the final branch head: all 44 jobs green, on Linux (tests, daemon transport leg, corpus tier 1, MSRV, dependency audit, all eleven package suites with their corpus legs, pilot compatibility) and on Windows. Earlier rounds on this branch were red and are fixed: a test helper that exhausted the database readers by polling stats, a Windows file-replace collision in a fixture, three tests that depended on which packages the machine has installed, a Windows path-form mismatch in configuration diagnostics, and a one-shot test that depended on machine speed.
    • Local full gate run (42 steps, including the nightly-only cost jobs) on 37c76ee2: 39 steps green. The workspace and daemon-leg steps failed in the same two tests (a documentation size reserve and a pinned test population, both where lanes met at the merge), and the packages-only acceptance showed that a configuration naming a language whose package is not installed was refused. All three are fixed; the last one is the languages.enabled change above.
    • Partial local re-run on f73682d5 with an empty user package store, as on a CI runner: formatting, lints for both targets, docs, timing, doctests, fast gates, packages-only and shipped-build acceptance green; workspace 5,570 of 5,571 and daemon leg 1,049 of 1,050. The one failure was a harness rule about how a new test starts the CLI; it is fixed in the final commit, and that rule and the affected suite were re-run on both legs.
    • Not repeated locally after 37c76ee2: the corpus, precision and package suites. The later commits change configuration loading, ownership reporting, one dependency and tests, not resolution; CI ran the corpus and package jobs on the final head.
    • The Windows behaviour of the last fixes was verified by CI only; there was no local Windows run.

    Downloads

    Four platforms are built for every release. The table below says which ones THIS release published.

    Platform Archive
    Linux x86_64 (glibc) code-index-v0.41.49-linux-x86_64.tar.gz
    Linux x86_64 (static/musl) code-index-v0.41.49-linux-x86_64-musl.tar.gz
    Linux ARM64 code-index-v0.41.49-linux-aarch64.tar.gz
    Windows x64 code-index-v0.41.49-windows-x86_64.zip

    First-party language packages

    Every archive carries code-index-packages/: the first-party language packages at the versions the package channel had published when this release was cut — de.h-dv.csharp-0.1.11 de.h-dv.javascript-0.1.6 de.h-dv.php-0.1.6 de.h-dv.python-0.1.5 de.h-dv.ruby-0.10.2 de.h-dv.rust-0.1.8 de.h-dv.typescript-0.1.7 — each signed by the key below and verified at the install door. code-index languages enable <lang> adopts the bundled package offline. A package is released by its own pkg/<id>/v<version> tag, whose release carries its .cip, .cips and digest, and code-index plugin update <id> reads the package channel, so a package fix reaches you without a new core release.

    These release binaries contain no native language parsers. Under auto, enabled languages use their approved packages. First start adopts bundled packages verified against this build's own publisher keys; existing approvals and enablement remain authoritative. If your project explicitly pins a language to builtin, switch it with code-index languages owner <lang> auto; an unavailable builtin is refused rather than silently ignored. To enable languages explicitly:

    code-index languages enable csharp
    code-index languages enable javascript
    code-index languages enable php
    code-index languages enable python
    code-index languages enable ruby
    code-index languages enable rust
    code-index languages enable typescript
    

    About that key

    sha256:1cb03259a8c870b6db02360abd9351e17e67724d1f8c3509d85c4bf6b06fa72c is a long-lived Ed25519 key held as a secret in this project's CI, used to sign released packages automatically, and it is compiled into the binaries in this release. It signs every first-party package. That trusts this project's release pipeline, not only its maintainers: anyone who can run a release workflow here can produce a package that verifies under it. It adds nothing you had not already granted — the bytes are inside the program you are running, so forging that anchor means forging the binary — but you are entitled to know it is there before a package installs rather than after.

    There is no expiry — deliberately, because offline installations must not break on a timer — and withdrawal is on your side and works: code-index plugin trust remove sha256:1cb03259a8c870b6db02360abd9351e17e67724d1f8c3509d85c4bf6b06fa72c. A compiled-in key has no file to delete, so that writes one instead, carrying denied = true; the key stops verifying at the next load, plugin trust list shows it marked [DENIED], and deleting that file (the command prints its path) is the only undo. If the key is ever rotated, the new fingerprint is published here and in tests/packages/first-party.fingerprint, and a build that predates the rotation will not trust it.

    macOS is not currently built. No x86_64-apple-darwin or aarch64-apple-darwin archive is published — macOS users should build from source (cargo build --release). This is a deliberate deferral, tracked in #59; no date is promised.

    Wire into Claude Code

    { "mcpServers": { "code-index": { "command": "/usr/local/bin/code-index-mcp", "args": ["--root", "/path/to/your/project"] } } }
    

    SHA256 checksums (.sha256 files) available for every archive.

    Downloads