Skip to content

docs(adr): ADR-0078 — first-class knowledge layer (design for #1175)#1264

Open
ohdearquant wants to merge 1 commit into
mainfrom
show/lionagi-sweep/knowledge-substrate
Open

docs(adr): ADR-0078 — first-class knowledge layer (design for #1175)#1264
ohdearquant wants to merge 1 commit into
mainfrom
show/lionagi-sweep/knowledge-substrate

Conversation

@ohdearquant

Copy link
Copy Markdown
Owner

Design play from the lionagi-sweep show — an ADR proposing a first-class knowledge substrate for review, NOT an implementation. Critic APPROVE (CRIT:0 MAJ:0 MIN:2): every cited primitive verified against live source; OSS/commercial boundary confirmed clean (zero khive/commercial references — the claim/evidence vocabulary is OSS prior art from the existing ADR-0039, referenced and deferred).

ADR-0078 covers

  • Problem — knowledge today is ephemeral (Branch history) or external; no persistent, queryable, cross-session substrate.
  • Proposed Knowledge protocol — interface grounded in real lionagi primitives (Element/Node/Graph/Pile + Observable structural typing), with verified method signatures (Graph.get_predecessors/get_successors/find_node_edge/find_path, ID.Ref).
  • Reference backends — in-memory + sqlite sketches; the plug-point where an external backend satisfies the protocol (generic — no proprietary internals).
  • Integration — how operate/ReAct read/write knowledge; relationship to Graph/Node; serialization.
  • Alternatives + open questions for Ocean; status: Proposed.

This is the seam, not the implementation — for your design sign-off before any build. Leaving #1175 open pending that approval.

Refs #1175 (design ADR for review)

🤖 Generated with Claude Code

ohdearquant added a commit that referenced this pull request Jun 3, 2026
…ollision)

The play numbered its 4 ADRs 0077-0080, but on sibling open PRs ADR-0077 is
taken by orch-emissions (lifecycle-signal-contract) and ADR-0078 by #1264
(first-class-knowledge-layer). Shift the whole cluster +2 so it merges without
colliding:

- ADR-0079 substrate-executor-provider-interface (#1196)
- ADR-0080 remote-sandbox-substrate-execution (#1195)
- ADR-0081 configurable-flow-planning (#1197)
- ADR-0082 role-substrate-routing-policy (#1210)

All inter-ADR cross-references updated; ADR-0074/0072/0057 (on main) unchanged.
The #1210 routing slice (flow/fanout --pack routing display + tests) is carried
from the prior commit; tests/cli/orchestrate/test_flow_planning.py → 16 passed.

Refs #1195 #1196 #1197 #1210

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant