Architecture documentation structure per sdd_process phase 1: - README index (doc table, ADR table, lifecycle), overview with crate map, dependency rules, and security invariants - Component specs: storage, transport, http, ssh, alkgitd (all draft) - ADRs 001-009: crate decomposition, front-door-blind core, V2-first protocol, pack pipeline (data::output generation / data::input ingestion), session substrate types, http adapter composition (proposed, OQ-01), ACL-before-advertisement, registry-resolved repo identity, bounded-resources budgets - open-questions.md: OQ-01..08 with two deferred(scope), one deferred(unclear), door-type definitions, blocker tracker tasks in tasks/architecture/ - v1 ssh-door decision recorded: russh terminates wire SSH in alkgitd; alkcall channels stay the internal substrate (OQ-03 partially resolved) Two review rounds (fresh-context subagent): 4 critical + 17 warnings fixed in round one; zero critical + 4 warnings + 5 suggestions fixed in round two. All ADR/OQ cross-references verified resolving.
35 lines
759 B
Markdown
35 lines
759 B
Markdown
---
|
|
id: architecture/oq-03-embedder
|
|
name: OQ-03 unblock — downstream embedder use case arrives
|
|
status: pending
|
|
depends_on: []
|
|
scope: narrow
|
|
risk: trivial
|
|
impact: component
|
|
level: research
|
|
tags: [external-trigger, deferred-oq]
|
|
---
|
|
|
|
## Description
|
|
|
|
Tracker for OQ-03 (`deferred(scope)`): downstream embedding surface. Not
|
|
actionable work — tracks whether a concrete downstream embedder use case
|
|
has arrived (a real app or harness wanting to embed core + transport, or
|
|
ask for a russh-flavored ssh adapter). On trigger: mark completed, OQ-03
|
|
transitions to `open`.
|
|
|
|
## Work
|
|
|
|
None by default.
|
|
|
|
## Verification
|
|
|
|
- OQ-03 status matches `docs/architecture/open-questions.md`.
|
|
|
|
## Out of scope
|
|
|
|
- Designing the embedding seam.
|
|
|
|
## Summary
|
|
|
|
> Filled on completion. |