ContextGO 0.12.4

Release Notes — ContextGO 0.12.4 / 发布说明

Highlights / 亮点

• Recall heuristics tightened for real-world prompts: agents are now guided to normalize relative dates into absolute dates, add one workspace anchor, and prefer 2-3 compact ContextGO queries before any broader fallback. / 检索启发进一步收紧，更贴近真实使用
• Skills updated to match the new policy: both contextgo-recall and contextgo-gsd now teach the same compact-query pattern. / 技能文档与新策略对齐
• Rolled back out to all connected local platforms: the refreshed smart-recall policy has been pushed through contextgo setup again. / 已重新推送到所有本机已接入平台

Breaking Changes / 破坏性变更

None. / 无。

New Features / 新增功能

• Policy-level guidance for:
  • absolute-date conversion
  • workspace-anchor query planning
  • compact exact-first ContextGO recall

Improvements / 改进

• Better default behavior for prompts like “昨天我和 Codex 的聊天”.
• Less chance of falling back too early into broad session/file scans.
• Lower token waste from oversized keyword strings.

Bug Fixes / 修复

• Fixed the policy gap where agents could still choose broad session-native searches before trying strong ContextGO anchors.

Performance / 性能

• No runtime dependency cost added.
• Lower recall token cost through tighter query planning.

Documentation / 文档

• Updated docs/skills/contextgo-recall/SKILL.md
• Updated docs/skills/contextgo-gsd/SKILL.md
• Added this release notes file and updated the changelog

Contributors / 贡献者

• Dunova
• Codex

Verification / 验证

• python3 -m py_compile src/contextgo/context_prewarm.py
• python3 -m pytest -o addopts='' tests/test_context_prewarm.py
• PYTHONPATH=src python3 -m contextgo.context_cli setup

Upgrade Path / 升级路径

pipx upgrade "contextgo[vector]"
contextgo setup

Dependency Note / 依赖说明

No dependency changes are required for this release. / 本次发布无需调整依赖。

ContextGO 0.12.3

Release Notes — ContextGO 0.12.3 / 发布说明

Highlights / 亮点

• Factory / Droid is now a first-class source: local Droid sessions under ~/.factory/sessions/** are now indexed and searchable across platforms. / Droid 会话正式接入统一索引
• Hermes is now a first-class source: Hermes session files under ~/.hermes/sessions/ are now indexed and searchable from other agents. / Hermes 会话正式接入统一索引
• Default smart recall is now wired for OpenCode, Hermes, and Factory/Droid: contextgo setup updates their real config/prompt entrypoints instead of leaving them as “search-only” platforms. / OpenCode、Hermes、Factory/Droid 默认智能召回已接通

Breaking Changes / 破坏性变更

None. This is an additive compatibility release. / 无破坏性变更。

New Features / 新增功能

• factory_session adapter for local Factory/Droid JSONL conversations.
• hermes_session adapter for local Hermes JSONL conversations.
• source_inventory() and contextgo sources now expose factory and hermes.
• contextgo setup now configures:
  • OpenCode via ~/.opencode/opencode.json / ~/.config/opencode/opencode.json
  • Hermes via ~/.hermes/SOUL.md
  • Factory/Droid via ~/.factory/AGENTS.md and ~/.factory/droids/*.md

Improvements / 改进

• Session index search types now include factory and hermes.
• Source weights now rank Factory and Hermes sessions as adapter-backed primary sessions rather than miscellaneous history.
• README and CLI help now match the real supported platform surface.

Bug Fixes / 修复

• Fixed the gap where Factory/Droid conversations existed locally but were invisible to ContextGO search.
• Fixed the gap where Hermes conversations existed locally but were invisible to ContextGO search.
• Fixed the gap where OpenCode / Hermes / Factory/Droid had no built-in smart-recall setup path despite being active platforms.

Performance / 性能

• No algorithmic slowdown added to the recall path; new platform adapters normalize to cached JSONL mirrors like existing adapters. / 新增平台沿用统一镜像缓存，不引入额外热路径开销

Documentation / 文档

• Updated README and README.zh support lists and instruction-entrypoint table.
• Updated CLI setup --help copy.
• Added these release notes and refreshed docs index.

Contributors / 贡献者

• Dunova
• Codex

Verification / 验证

• python3 -m py_compile src/contextgo/context_prewarm.py src/contextgo/source_adapters.py src/contextgo/session_index.py src/contextgo/context_cli.py
• python3 -m pytest -o addopts='' tests/test_context_prewarm.py tests/test_source_adapters.py
• PYTHONPATH=src python3 -m contextgo.context_cli setup
• PYTHONPATH=src python3 -m contextgo.context_cli sources

Upgrade Path / 升级路径

pipx upgrade "contextgo[vector]"
contextgo setup
contextgo sources
contextgo health

Re-run contextgo setup after upgrading so OpenCode, Hermes, and Factory/Droid receive the new smart-recall policy wiring. / 升级后请重新运行 contextgo setup，让 OpenCode、Hermes、Factory/Droid 写入新的 smart-recall 配置。

ContextGO 0.12.2

Release Notes — ContextGO 0.12.2 / 发布说明

Highlights / 亮点

• Smart recall instead of noisy recall: automatic prewarm now runs only on cold starts, continuations, topic shifts, and structural prompts. Same-topic back-and-forth stays silent to reduce token waste. / 自动召回从“逢问必查”升级为“按需触发”
• Higher hit rate on real prompts: prewarm no longer pushes long keyword strings into strict search paths. It now plans short anchor queries and single-term fallbacks, which materially improves recall on natural-language prompts. / 长关键词串导致零命中的问题已修正
• Graph-first structural workflow: architecture, dependency, call-chain, and blast-radius questions now steer users toward code graph tools first, then ContextGO for historical decisions. / 结构类问题优先 graph，再补历史记忆
• Cursor coverage improvement: adapter extraction now recognizes newer Cursor generation/composer fields so recent sessions are easier to recall. / Cursor 新版字段提取增强

Breaking Changes / 破坏性变更

None. Existing contextgo setup users can upgrade in place. The new policy block replaces the old one automatically on re-run. / 无破坏性变更，重新执行 contextgo setup 即可升级策略块。

New Features / 新增功能

• Smart recall trigger classification in context_prewarm.py:
  • cold start / new window
  • continuation / handoff
  • new topic detection
  • structural-question graph hint
• Compact recall state persisted per workspace so same-topic follow-ups can stay silent.
• Short-query planning for prewarm recall:
  • 2-term anchor query first
  • single-term fallback queries next
  • de-duplicated aggregation across candidates

Improvements / 改进

• contextgo prewarm --help and contextgo setup --help now describe the actual smart-recall behavior instead of the old always-search framing.
• Injected policy blocks now align across Claude Code, Codex, Cursor, Accio, Antigravity, Copilot, and OpenClaw.
• Session fallback output is trimmed to a compact form for lower hook token cost.
• Cursor adapter extraction now reads composer, generation, textDescription, and related fields from newer workspace storage records.

Bug Fixes / 修复

• Fixed low-hit recall behavior caused by concatenating too many keywords into a single strict query.
• Fixed stale policy persistence: setup now replaces older SCF policy blocks with the new smart-recall policy instead of leaving outdated instructions in place.

Performance / 性能

• Lower token overhead for hook output by capping recall to a concise summary and up to 3 hits.
• Reduced wasted searches by suppressing same-topic repeated recalls inside a short workspace-local TTL window.

Documentation / 文档

• Updated README AI-agent behavior sections to explain selective recall.
• Added this release notes file and refreshed the docs index release table.
• Updated shell policy injector copy to the new smart-recall wording.

Contributors / 贡献者

• Dunova
• Codex

Verification / 验证

• python3 -m py_compile src/contextgo/context_prewarm.py src/contextgo/context_cli.py src/contextgo/source_adapters.py
• python3 -m pytest -o addopts='' tests/test_context_prewarm.py
• python3 -m pytest -o addopts='' tests/test_source_adapters.py
• bash -n scripts/apply_context_first_policy.sh
• PYTHONPATH=src python3 -m contextgo.context_cli setup --help
• PYTHONPATH=src python3 -m contextgo.context_cli prewarm --help

Upgrade Path / 升级路径

pipx upgrade "contextgo[vector]"
contextgo setup
contextgo health

If you manage instructions manually, copy the refreshed smart-recall policy into your tool entrypoint and re-run your normal smoke checks. / 若你手工维护指令文件，请同步新版 smart-recall 策略后再执行常规冒烟验证。

v0.12.1

v0.12.1 — 全平台 AI 编程工具支持

新增 7 个平台适配器

平台	source_type	格式
Cline (60k stars)	cline_session	JSON (VS Code globalStorage)
Roo Code (23k stars)	roo_session	JSON (VS Code globalStorage)
Continue.dev (32k stars)	continue_session	JSON (~/.continue/sessions/)
Zed (78k stars)	zed_session	JSON (conversations/)
Aider (43k stars)	aider_session	Markdown (.aider.chat.history.md)
Cursor	cursor_session	SQLite (state.vscdb)
Windsurf	windsurf_session	SQLite (state.vscdb)

安全与健壮性改进

• Extension ID 白名单验证 (Cline/Roo)
• App name 白名单验证 (Cursor/Windsurf)
• _extract_text_fragments 递归深度限制 (max 20)
• _aider_walk_limited 深度限制替代 rglob，防符号链接循环
• vscdb 10MB value / 200MB file 上限保护
• _iso_or_none UTC 时区安全
• source_freshness_snapshot TOCTOU 防护
• tempfile.mkstemp 替代 open() 防 adapter 写入碰撞

测试

• 新增 93 个单元测试覆盖全部新适配器
• CI 全绿: Lint + Py3.10-3.13 + Go + Rust + Quality Gate + CodeQL

升级

pipx install contextgo --force
# 或
pip install --upgrade contextgo

Full Changelog: v0.12.0...v0.12.1

v0.12.0 — Security Hardening & Commercial-Grade Polish

Highlights

Security & Reliability

• Export path containment — prevents directory traversal in _export()
• Unified redaction markers — all 32 secret patterns now use ***REDACTED***
• Fast-path sanitization — _FAST_MARKERS frozenset pre-screens text before 26 regex patterns
• Database integrity check — context_maintenance validates DB before writes
• Thread-safe session sync — threading.Lock prevents concurrent index corruption

Testing & Quality

• 50+ new secret_redaction tests covering all token types
• 92 ruff lint violations fixed (SIM117, SIM105, F401)
• Test cache isolation via conftest autouse fixture

CI Pipeline

• Fixed Verify workflow (broken scripts/context_cli.py reference, safety 3.x compatibility)
• Aligned tool versions with requirements-dev.txt
• Merged 5 dependency bumps (ruff 0.15.8, safety 3.7.0, httpx 0.28.1, pytest 9.0.2, actions group)

Packaging

• context_smoke.py and memory_viewer.py excluded from wheel
• noise_markers.json explicitly force-included
• cache_dir.mkdir uses mode=0o700 for secure permissions

Documentation

• Pain-point-driven README rewrite with updated comparison table
• Daemon mode docs in both EN and CN sections
• Fixed TROUBLESHOOTING command references (context_cli → contextgo)

---

Full Changelog: v0.11.11...v0.12.0

Install / Upgrade

pipx upgrade contextgo || pipx install "contextgo[vector]"

v0.11.5

v0.11.5 — 全维度优化

Security

• 新增 12 种密钥清洗模式

UX

• CLI 帮助文本全面重写

Performance

• SQLite PRAGMA 优化

CI/CD

• release.yml 添加 Go/Rust 验证
• 新增 CodeQL 安全分析

Repo Clean

• 删除 scripts/ 下 21 个符号链接

Code Quality

• 异常窄化

Coverage: 97.07% (2111 tests passed)

v0.11.4 — Read-only Support + Security Hardening

See CHANGELOG.md and docs/RELEASE_NOTES_0.11.4.md for details.

• Read-only environment support
• Security hardening (0600 perms, 3 new secret patterns)
• Exception observability improvements
• API.md fixes
• 2041 tests passed

v0.11.3 — Code Quality + Repo Cleanliness + CI Hardening

Changes

Added

• __init__.py with __all__ exports and __version__
• Module docstrings for core modules
• CI wheel build + install validation
• docs/RELEASE_NOTES_0.11.1.md

Fixed

• CI smoke test with --sandbox
• .gitignore completeness

Tests: 2041 passed, 0 failed

v0.11.2 — Native Performance + Packaging Hardening

Changes

Native Performance

• Go P0: sync.Pool buffer aliasing fixed — pool reuse now effective
• Rust P1: active_workdir computed once per scan (not per file)
• Rust P1: ASCII fast-path zero-alloc comparison
• Go P1: Deferred lineStr allocation, IsNoiseLower optimization

Packaging & CI

• Removed duplicate scripts package from wheel
• Safety scan now covers all installed dependencies
• Release workflow concurrency protection
• Filtered db_name from health API responses

Tests: 2041 passed, 0 failed | Go vet clean | Rust cargo check clean

v0.11.1 — Codex Audit Fixes Round 1

Changes

Fixed

• Adapter fault isolation: per-source try/except in sync_all_adapters
• Search/sync decoupling: sync_all_adapters moved after throttle check
• Smoke test path resolution for symlinked installations
• CI release gate: Go/Rust verification + blocking safety check
• Test adapter dirty marker compatibility

Changed

• Documentation path alignment (scripts/ → src/contextgo/)

Added

• CHANGELOG v0.11.0 entry
• docs/RELEASE_NOTES_0.11.0.md

Full test suite: 2041 passed, 0 failed