Skip to content

v1.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 24 Jul 07:12

Release Notes

Stability release. No new features; the public contract is now frozen and covered by
contract tests (tests/contract_test.rs). Breaking changes to anything listed under
"Frozen" now require a 2.0 release. See the README "Stability" section for the full
covered/not-covered list.

Frozen

  • CLI surface: init, daemon, generate, serve; --focus/-f, --depth/-d,
    --verbose/-v; optional path argument on init/daemon; exit codes 0/1
  • MCP tools: exactly amdb_get_context, amdb_focus, amdb_get_symbol with their
    current input parameters; amdb_get_symbol response fields file, name, kind,
    line, signature, is_public, callers[] {name, file},
    callees[] {name, file, resolution} (additive evolution only)
  • Config: amdb.toml keys db_path and ignore_patterns; AMDB_DB_PATH override
  • Database upgrades: automatic migration via PRAGMA user_version from any 0.6+ index;
    deleting .database/ is never a required upgrade step
  • Generated Markdown anchors: the ### <relative/path> per-file heading and the single
    fenced mermaid block with --> edges; all other layout details remain unstable

Added

  • callees[].resolution in amdb_get_symbol responses, exposing how each callee's file
    was attributed by the current resolver: same-file, global-unique, or unresolved.
    Added now so that future language-specific resolution strategies extend the value set
    additively instead of changing the response shape
  • Contract tests guarding the CLI surface, MCP tool names, the amdb_get_symbol
    response schema, the documented config keys, and the migration chain from each prior
    PRAGMA user_version (0, 1, 2)

Fixed

  • Legacy-schema migration purged symbols and relationships but left file_hashes
    intact, so the next amdb init skipped every unchanged file and left the index empty.
    The migration now purges file_hashes too, forcing the next init to rebuild fully.
    No released version could hit this (hash-based indexing shipped after the last schema
    bump), but the chain would have broken at the next user_version increase

Benchmarks

  • Re-measured on the v1.0.0 source with the corrected harness introduced in v0.9.0:
    precision targeting 100% (28/28), global efficiency 91.5%, noise reduction 81.7%
    (was 81.6% at v0.9.0), graph presence 100% (28/28). Baseline grew to 21,887 raw
    tokens; grep-baseline average moved to 4,180 tokens. No headline figure moved
    materially in the audit — the corrections themselves landed in v0.9.0, where noise
    reduction fell from a reported 95.1% to 81.6% and global efficiency from 97.8% to
    91.5%

Download amdb 1.0.0

File Platform Checksum
amdb-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
amdb-x86_64-apple-darwin.tar.xz Intel macOS checksum
amdb-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
amdb-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum