release: 0.3.5 — codemap recall <query> CLI (P3-1, half 1)

[qxbyte]

Summary

• New codemap recall '<query>' CLI in codemap-aimemory that token-matches the user's request against <project>/.ai-memory/knowledge/*.yml and returns the top-K most relevant knowledge.
• Designed to be called by specode at the start of the requirements phase so the spec author sees prior rules / cases / pitfalls before writing.
• Lockstep version bump 0.3.4 → 0.3.5 across all 20 packages.

Why

AI-Enterprise-Delivery-System roadmap P3-1: "Agent terminally becomes like an old employee." Until now .ai-memory/knowledge/ was write-only — the data was there but no one queried it. This PR adds the query CLI. The pluginhub-side companion PR wires specode to actually call it.

This is P3-1 half 1. Half 2 (the specode SKILL.md change to invoke this CLI) lands in pluginhub next.

Usage

codemap recall '新增优惠券互斥规则' --top-k 3 --types rules,pitfalls

Output (yaml default):

query: 新增优惠券互斥规则
tokens: [优惠, 互斥, 券规, 惠券, 新增, 规则]
matched_entities:
  - rule-coupon-mutex
knowledge:
  - knowledge_id: rule-coupon-mutex
    type: business_rule
    category: rules
    title: 优惠券和积分不能同时使用
    summary: 避免用户双重优惠导致亏损
    score: 7
    file: .ai-memory/knowledge/rules/rule-coupon-mutex.yml

Algorithm (v1, no embeddings)

• Tokenize: English/digit words ≥ 2 chars + Chinese char-bigrams (zero external deps).
• Score = sum of token hits in searchable fields (title / tags / statement / related_code / fix / symptom / …); title hits weighted ×2.
• Sort by score desc, secondary by knowledge_id (stable).
• Malformed yml silently skipped — a hand-edited knowledge file never crashes the build.

Embeddings + freshness reranking land in P1-3 / P4-1 respectively.

Test plan

• pytest plugins/codemap-aimemory/tests/ — 115 passed (97 → 115; 18 new in test_recall.py)
• root pytest tests/ — 297 passed
• codemap recall --help shows the new subcommand after pip install -e
• ruff check + ruff format --check + mypy clean
• CI green → merge → tag v0.3.5 → publish workflow uploads 20 packages

Roadmap progress

After this PR: P0-1/P0-2/P0-3/P0-3-follow-up/P1-2/P3-1 half 1 shipped. Next: pluginhub PR wires specode requirements phase to call codemap recall.

🤖 Generated with Claude Code

[pronto-qxbyte]

PRonto 评审

PR: #16 release: 0.3.5 — codemap recall CLI (P3-1, half 1)
作者: @qxbyte
分支: feat/recall-cli -> main

概览

新 recall.py 实现 token-based 知识召回，代码清晰，无明显问题。

问题清单

• ✅ 未发现明显问题

建议改进

• 建议补充 recall 函数的单元测试覆盖核心评分逻辑

本评审由 PRonto 经 DeepSeek 生成