Skip to content

docs(context): replace Bus cluster with Spine + add Agent Core missing terms#5

Closed
0xKT wants to merge 1 commit into
docs/glossary_baseline_and_init_docstringfrom
docs/glossary_huangjie_spine_agent_terms
Closed

docs(context): replace Bus cluster with Spine + add Agent Core missing terms#5
0xKT wants to merge 1 commit into
docs/glossary_baseline_and_init_docstringfrom
docs/glossary_huangjie_spine_agent_terms

Conversation

@0xKT

@0xKT 0xKT commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Change description

Owner review for assigned terms in CONTEXT.md, branching off
docs/glossary_baseline_and_init_docstring per the gap-scan review workflow.

What changed

### Bus cluster → ### Spine (highest priority, §1 in gap-scan):
The Bus cluster (Message Bus / Event Bus) was flagged stale and the definitions
referenced types that no longer exist in code (InboundMessage, OutboundMessage,
BusEvent). Replaced with the current Spine vocabulary, verified against
raven/spine/ (7 live files):

  • Spine — the submit→lane→emit backbone (replaces both Bus planes)
  • Lane — per-conversation serial+cancel domain (from scheduler.py docstring)
  • TurnRequest — replaces InboundMessage
  • Deliverable (= RunnerEvent) — replaces OutboundMessage
  • OriginPools — USER pool + system pool, no borrowing

Agent Core: 4 missing terms added (§3.2 / §3.3 / §3.6 / §3.7 in gap-scan):

  • Agent Loop (agent/loop/main.py:AgentLoop)
  • Turn Runner (spine/runner.py:TurnRunner Protocol + agent/spine_runner.py:AgentTurnRunner)
  • Agent Hook (agent/hook/base.py:AgentHook — 5-phase ABC, CompositeHook)
  • Subagent (agent/subagent/manager.py:SubagentManager)

Minor stale-reference fixes (§13):

  • Channel: removed "Message Bus" reference → "Runtime"
  • Routing Tag: "bus message" → "TurnRequest"
  • TUI-RPC avoid note: "bus planes" → "Spine events"
  • EvalEngine: expanded to mention the three AgentHook implementations

AUTH / SECURITY: verified accurate, no change needed.

Type of change

  • Document

Checklists

Development

  • Lint rules pass locally
  • Automated tests covering modified code pass

Docs-only; no runtime or test impact.

Security

  • Security impact of change has been considered

No security impact (glossary only).

Code review

  • Pull request has a descriptive title and context useful to a reviewer

…g terms

Replace the stale Bus section (Message Bus / Event Bus) with the current
Spine vocabulary, verified against raven/spine/ (7 live files). The old
types (InboundMessage, OutboundMessage, BusEvent) no longer exist in code.

New Spine terms: Spine, Lane, TurnRequest, Deliverable (= RunnerEvent),
OriginPools.

Add 4 missing Agent Core terms: Agent Loop, Turn Runner, Agent Hook,
Subagent — all verified against live module entry points.

Minor stale-reference fixes: Channel / Routing Tag / TUI-RPC avoid note
(Bus → Spine references); EvalEngine expanded to name the three AgentHook
implementations.

Co-authored-by: Claude (claude-sonnet-4-6) <noreply@anthropic.com>
@0xKT 0xKT closed this Jun 29, 2026
@0xKT
0xKT deleted the docs/glossary_huangjie_spine_agent_terms branch June 29, 2026 12:54
Kendrick-Song added a commit that referenced this pull request Jul 22, 2026
- Move _everos_server.py from raven/cli/ to raven/plugin/memory/everos/
  _server.py to fix plugin->cli layering violation (CR #1)
- Split HTTP timeout: client default 60s (recall/health), memorize
  add/flush per-request 360s (CR #2)
- Defer backend.start() to post-handshake background task in TUI so
  first render is not blocked by server startup (CR #3)
- Remove unused app_id/project_id from ImportSession and scanner
  (CR #4)
- Add note on per-source-unit checkpoint granularity (CR #5)
- Add fcntl file lock to prevent concurrent server spawn race (CR #6)
- Fix loguru %s format to {} in state.py (CR #7)
- Fix docstring step numbering (CR #8)
- Remove redundant Table import in status_cmd (CR #9)

Co-authored-by: Claude (claude-opus-4-6) <noreply@anthropic.com>
Kendrick-Song added a commit that referenced this pull request Jul 22, 2026
- Move _everos_server.py from raven/cli/ to raven/plugin/memory/everos/
  _server.py to fix plugin->cli layering violation (CR #1)
- Split HTTP timeout: client default 60s (recall/health), memorize
  add/flush per-request 360s (CR #2)
- Defer backend.start() to post-handshake background task in TUI so
  first render is not blocked by server startup (CR #3)
- Remove unused app_id/project_id from ImportSession and scanner
  (CR #4)
- Add note on per-source-unit checkpoint granularity (CR #5)
- Add fcntl file lock to prevent concurrent server spawn race (CR #6)
- Fix loguru %s format to {} in state.py (CR #7)
- Fix docstring step numbering (CR #8)
- Remove redundant Table import in status_cmd (CR #9)

Co-authored-by: Claude (claude-opus-4-6) <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