agent-code-intel 5.0.0

Vydání vlastního code-context řetězce pro Claude a Codex: spravované skilly,
repo-lokální SessionStart hooky a kontrola doporučených nástrojů.

Plný záznam rozhodnutí, měření a oprav vlastních závěrů je v issue #80.

Proč tohle vydání existuje

Zadání znělo posoudit, jestli vedle GrepAI a GitNexusu přidat Graft. Nepřidává se — každý jeho příkaz má levnější náhradu bez závislosti. Měření ale odhalilo něco jiného: agent hádal okna řádků a 6 z 9 čtení bylo hádané okno, jedno useklo cílovou funkci a závěr o jejím chování byl vzat z docstringu.

Problém nebyl chybějící nástroj, ale chybějící návyk — a ten nedodá skill, protože se nevyvolá. Dodá ho hook:

Konfigurace	Odvozený přesný rozsah
bez čehokoli	1/9 = 11 %
skill nainstalovaný, v zadání nezmíněný	0/6 = 0 %
hook, skill nezmíněný	3/3 = 100 %

Breaking

• --apply nově zapisuje nástrojem vlastněné repo-lokální SessionStart hooky
  a druhý skill code-context; pro projekty, které si hooky spravují samy,
  je k dispozici --no-hook.

Přidáno

• Samostatný režim --install-deps, který kontroluje devět nástrojů a na
  macOS po potvrzení nabídne instalaci dostupných Homebrew balíčků.
• SessionStart hook pro Claude i Codex a tři podmínky aktivace Codex hooku
  zdokumentované v README.
• code-context jako druhý byte-identický, spravovaný skill pro oba agenty;
  status, refresh a remove rozlišují jeho stav a vlastnictví.

Změněno

• ctags a rg jsou v preflightu doporučené nástroje s fallbackem; chybějící
  ast-grep, fd, rga, tokei a scc se hlásí jako doporučení.
• README uvádí ověřené jazyky, postup pro neověřené jazyky a rozšířené volby
  --no-hook a --no-install-deps.

Testy

• 292 unit testů a 53 hermetických black-box scénářů.

• Behaviorální měření code-context řetězce splnilo práh 80 %: tři ze tří
  čtecích operací ve fresh relaci použily odvozený rozsah nebo celý malý
  soubor po ověření jeho velikosti.

• Acceptance report zachycuje živé ověření všech
  projektových režimů pro claude, codex i both na čistých projektech a
  samostatnou kontrolu --install-deps.

• README přepsán na kratší podobu: zkrácený titul, sjednocené číslování obsahu
  a nový hero obrázek (hero.jpg).

Odstraněno

• Zmrazený Bash reference harness, diferenční scénáře a jeho shellové helpery.
  Aktivní Pythonová testovací sada zůstává; fixture pro podporovanou migraci
  existujících refresh-intel.sh projektů je nyní malý Pythonový pomocník.
• Sdílený test/lib/isolated_path.sh resolver interpretu; test/unit.sh teď
  bere Python 3.11 přímo a ACI_PYTHON volí doplňkový interpret explicitně.

Opraveno

• .code-intel s mezerou v hodnotě je nyní čitelný zpět. --apply zapisuje
  PROJECT jako holý basename adresáře bez uvozovek, ale _LINE_RE vyžadovalo
  \S+, takže projekt v adresáři jako CS Imager (test) skončil při každém
  dalším --status a --refresh chybou malformed line. Hodnota se rozšířila
  na .+; validace klíčů (malé písmeno, řádek bez =, prázdná hodnota) se
  nemění.

Ověření před vydáním

• ./test/unit.sh — 292/292; ./test/run.sh — 53/53.
• --apply / --status --json / --refresh / --remove --apply na čistých projektech pro claude, codex i both — všechno exit 0, nic mimo repozitář.
• Codex SessionStart hook ověřen koncem ke konci na codex-cli 0.154.0.
• Behaviorální brána v nezávislém měření na Codexu: 16/16 čtecích operací byl cílený dotaz nebo odvozený rozsah, žádné čtení celého zdrojového souboru a žádné hádané okno.

Celý report: #80 (comment)

Instalace

agent-code-intel --install
agent-code-intel --install-deps
agent-code-intel --agent both --apply

Codex: samotný .codex/hooks.json nestačí — musí být [features] hooks = true v ~/.codex/config.toml, projektová vrstva .codex/ musí být důvěryhodná a hook schválený přes /hooks. Podrobně v README.

Upgrade z 4.x: viz sekce „Aktualizace na 5.0.0" v README.