spillwavesolutions/second-brain-core
v0.3.8MIT
Shared foundation for Spillwave ContentPack plugins: OKF schemas, typed edges, deterministic write helpers, progressive-disclosure packing, and write isolation.
Changelog
0.3.8
- Query-time retrieval contract:
docs/RETRIEVAL.mdplus parent skill/sbc-retrieve. Parent spawns a child for Q&A; search and pack stay off the parent context. sbc_common.py pack --tiny --summary: 1 hop / 8 nodes, compact card-friendly stdout, bodies off, fail-closed token budget.- Foundation retrievers stay in PKC / SAC / DEKC / RKC. Core does not absorb those agents.
0.3.7
- WikiTicket SDD (worklog) is the tracking system for this plugin.
0.3.6
- Three-host hooks: Codex + Cursor-native when Claude hooks exist.
0.3.5 — 2026-08-17
- Cursor host.
.cursor-plugin/plugin.json(Cursor Plugins) plus.cursor/rules/second-brain.mdc. Docs:docs/CURSOR.md.docs/GROK_BOT.mdnow covers Grok Bot spawning Cursor cloud agents.
0.3.4 — 2026-08-17
- Fleet actor registry. If the operator
actors.jsonlistsactors,brain_session.py openfails closed on an unknown actor. No registry keeps the old behavior. - Type allowlist.
restrictmaps a type to allowed actors. Pack + operator lists intersect. DailyDigest / WeeklyDigest are CoS-only. - Pack roots are packing hints, not access control (
docs/ISOLATION.md). - Sample:
actors.sample.json. Paths only.
0.3.3 — 2026-08-16
- ContextPack has a token budget: default 1/4 of the model window
(
SECOND_BRAIN_WINDOW_TOKENS, default 128000 → 32000 tokens). Override with--max-tokensorSECOND_BRAIN_PACK_MAX_TOKENS. - Pack is fail-closed when the rendered subgraph exceeds the budget. Node
clip (
--max-nodes) is not a token budget and does not write a truncated pack. - Bodies off unless that node is the pack root. Neighbors keep title, type,
path, and frontmatter
descriptiononly. - Token estimate is chars/4. Success JSON reports
tokens,budget,window.
0.3.2 — 2026-08-16
- Codex / Claude PostToolUse hook is fail-closed:
sbc-hook-validate.shrunssbc_common.py validateafterapply_patch/ Write / Edit and exits non-zero on a broken bundle. - Removed the SessionStart print reminder (a reminder is not a harness).
- Writes outside a knowledge bundle stay a silent no-op.
0.3.1 — 2026-08-16
- Privacy: isolation tests and docs use only fictional lumenfield-detector / northstar-console actors.
scripts/brain_session.pymarked as the canonical isolation helper; foundation packs vendor this copy.
0.3.0 — 2026-08-15
- Grok Bot onboarding:
docs/ONBOARDING.md(LLM-wiki history, destination state, public repo list) - Full type ownership in
docs/GROK_BOT.md(every registry noun, not a subset) - Registry folders filled so writes land in the right catalog
- Linked Northstar sample graph (typed edges, packable in 2 hops)
- Version stamps aligned across plugin.json, marketplace, and package.json
- README related-plugins list now covers the whole suite plus foundations
0.2.0 — 2026-08-15
- Write isolation:
scripts/brain_session.py(worktree + branch + PR) - Required
--author/SECOND_BRAIN_IDENTITY; emitWriteEventon write - Agent Plugins 1.0 root
plugin.json docs/GROK_BOT.md,docs/LANG_CHAIN_DEEP_AGENTS.md,docs/ISOLATION.md- Codex hooks (
.codex-plugin+hooks/hooks.json) - Skill
sbc-session
0.1.0 — 2026-08-14
- Initial public release
- Nouns: Concept, ContextPack, TypedEdge, AgentIdentity, WriteEvent
- Skills: sbc-init, sbc-capture, sbc-pack, sbc-validate, sbc-doctor
- Dual-host plugin manifests (Claude Code + Grok Build)