Skip to content

v0.1.2 — Candidate Admission Maintenance

Latest

Choose a tag to compare

@github-actions github-actions released this 06 Nov 12:40

v0.1.2 — Candidate Admission Maintenance

Status: released 2026-11-06.

Cairn is a local-first, deterministic experience retrieval layer. v0.1.2 is a
maintenance patch for the v0.1.1 baseline. It fixes one candidate-selection defect
and publishes the sanitized research records that motivated the change.

Try it

python3 cairn.py --version
python3 -m unittest discover -s tests -q

What changed

  • The hook, recall and explain paths now pass the full scored candidate pool to
    the gate. Contract-ineligible and scope-mismatched entries no longer consume the
    candidate budget before eligible entries are considered.
  • Added regression tests for hook, recall and explain, covering unverified peers
    and declared-scope mismatches.
  • Published two sanitized research notes: retrieval boundaries and long-task
    prompt length.

What did not change

  • The Experience Contract, three score gates, declared-scope semantics and hook
    output format are unchanged.
  • No new command, field, dependency, network path or host adapter.
  • The research notes are observations, not roadmap commitments.

Verification

  • Unit tests: 230 passing (127 core + 103 research fixtures).
  • Retrieval eval: 80 positive / 60 negative; recall@1 93.8%, recall@3 100%,
    injection@1/@3 72.5%, false injection 3.3%.
  • Contract admission eval: 3/3.
  • Trust & applicability eval: 13 cases; hard failures 0; four known gaps remain.
  • Hook cold-start p95: 74.2 ms at 12 entries and 98.5 ms at 1,000 synthetic
    entries (30 runs each, single-machine sample).
  • Core: 1,200 lines; zero new dependencies; Python 3.9 AST parse passes.

Known limitations

The v0.1.1 limitations remain unless explicitly fixed here. In particular,
long task prompts can dilute query-term coverage, the fixed margin threshold is
calibrated on a small library, cards are retrieval hints rather than full text,
verified is self-declared, scope gates only when declared, verified_at does not
expire automatically, and conflict detection is not implemented.

中文摘要

2026-11-06 已发布。

v0.1.2 是 v0.1.1 的维护补丁,修复候选池在准入前被截断的问题:
hook、recall、explain 现在把完整评分候选池交给 gate,不合格或 scope 不匹配的
候选不会挤掉合格目标。新增 hook/recall/explain 的候选池回归测试,
并发布两篇去敏后的研究记录(检索边界、长任务 Prompt 长度)。

验证结果:230 项测试通过(127 核心 + 103 研究夹具);80/60 评测指标保持
93.8% / 100% / 72.5% / 3.3%;12 条库 p95 74.2ms,1,000 条合成库 p95 98.5ms。
未改变 Experience Contract、三道门和 scope 语义。