Repository navigation
📖 docs(design): drain CLI auto-memory into draft knowledge beads - #17061
Conversation
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com> Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
Open PR overlap checkBase branch: Conflicts are checked with every PR merged onto the current tip of
|
|
Hive status — updated in place; edits do not notify. Full history is in the Activity Monitor. hive/awaiting-ci: CI pending — sweep will merge when green. 🐝 Hive Agent: — hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88 Evidence bundle `#17061bb90d62` sha256:30497b1d0ad5c98765abd3bae1bd4448a5c5706b18ea02b83a5c4da8f81f5a12 — download from the dashboard or `hivectl review evidence #17061`. |
There was a problem hiding this comment.
Spot-checked ~20 of the file:line citations against 7a929356 (the commit the doc pins) — lifecycle.go:16-21/88-98, primer.go:144, knowledge_config.go:43-46/269, kick_priming.go:256, api.go:389, api_knowledge.go:577, knowledge/api.go:293-300/335-344, manager_kick.go:242/271, manager_homes.go:582/624, claude_remote_control.go:44-46, promote.go:127, curator_schedule.go:31, beads-cli.md:11 — all resolve to the symbols the doc names. The two write-side gaps it identifies are real: CreateFactRequest has no state field, and bd create has no knowledge type. Design reads sound to me; nothing blocking.
One currency note, since the doc will outlive the queue: #17039 merged to v5 as 943d807 after this was written. src/docs/design/cli-memory-drain.md says (lines 8-11, 24-27) that #17039 is an open PR and that "v5 bridges ~/.claude, ~/.gemini and ~/.codex whole into the shared home (interactive_home.go:68-71)". On current v5, interactiveHomeBridgeDirs (src/crux/agent/interactive_home.go:73-76) is .config, .codex, .cache — .claude/.gemini are no longer bridged. The pinned-commit framing keeps the citations honest, but a one-line "#17039 has since landed" would stop a reader from concluding the sharing problem is still live. #17040 is still open, so that half stands.
— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88
|
Needs a decision, not a merge: the lane reported Head: verdict approved @bb90d62, 70/70 checks green, DCO yes, soak 10m0s elapsed. How to release it:
Clear the cause and the hive re-evaluates on its next pass; the stage moves to |
|
Thank you for your contribution! Your PR has been merged. We'd love to hear how your experience was: share feedback |
Why
Each coding CLI keeps a hidden, per-agent memory store: Claude Code
projects/*/memory/MEMORY.md, Codex$CODEX_HOME/memories, GeminiGEMINI.md. Nothing in those stores is reviewed or scoped, and none of it goes through the knowledge lifecycle. As raised at the 2026-11-05 community meeting, much of it should have been beads. Hive already has the destination: knowledge facts withdraft/approved/deprecated/supersededstates,knowledge.agent_scopes, the kick primer, and the curator. This PR adds the design for the missing drain, which moves memory-store entries intodraftknowledge facts and then empties the store.What's in the PR
src/docs/design/cli-memory-drain.md(design only), covering:SessionEndhook, withPostToolUseas an option; a manager-side drain for Codex and Gemini indeliverKickLocked, before ✨ agents: disable CLI auto-memory by default and add cli_memory.clear_on_kick #17040'sclearCLIMemoryLocked. Copilot CLI has no local store, so there is nothing to drain.--type knowledge --state draft --tag auto-memory --tag agent:<name>, pluscli:andmemhash:tags.bd createhas noknowledgetype, andCreateFactRequesthas nostate.knowledge-system.mdopen question 5 is answered and linked to the new doc.src/docs/design/README.md.Decisions on #17033's open questions (the maintainer can override any of them)
agent:<name>tag on the existing fact instead of a new bead. A discarded fact is never revived. Semantic merge is left to the reviewer (superseded_by).knowledge.curatorand the state API remain the only path toapproved; there is no second curator.include_statesadmitsdraft, until a fact is approved.Implementation (child sub-issues of #17033)
bd create --type knowledge, andstateon create.SessionEnd/PostToolUsehook seeded into settings.json (blocked by [scanner] ✨ knowledge: CLI memory drain library + manager-side drain for Codex/Gemini (phase 1 of #17033) #17056).Docs only, so there is no changelog fragment.
Fixes #17033 (design delivered here; implementation tracked in child issues #17056, #17057, #17058)
— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88 requested_by=@clubanderson