|
|
19b3d3a078
|
docs: write Phase 0 architecture foundation — ADRs 026-034, spec docs, and task updates
Phase 0a — ADRs (9 new):
- ADR-026: Transport/interface separation (three-layer model)
- ADR-027: Crate decomposition (core, secret, storage, flowgraph, napi, CLI)
- ADR-028: Auth as irpc service (AuthProtocol behind feature flag)
- ADR-029: Identity as core type (Identity + IdentityProvider in alknet-core)
- ADR-030: Static/dynamic config split (ArcSwap, ConfigReloadHandle)
- ADR-031: Forwarding policy (rule-based allow/deny, TransportKind-aware)
- ADR-032: Event boundary discipline (domain, irpc, call protocol boundaries)
- ADR-033: OperationEnv universal composition (three dispatch paths)
- ADR-034: Head/worker terminology (replace hub/spoke)
Phase 0b — New spec documents (7):
- identity.md, services.md, interface.md, configuration.md,
storage.md, flowgraph.md, secret-service.md
Updated existing docs:
- auth.md: reference identity.md for canonical definitions, add AuthProtocol
- open-questions.md: resolve OQ-12, OQ-16, OQ-18, OQ-22, OQ-23-25
- README.md: add all new docs, ADRs 026-034
Marked 19 architecture tasks as completed.
|
2026-06-07 09:32:58 +00:00 |
|
|
|
84f16d66e7
|
tasks: decompose Phase 0b spec documents and Phase 0c review
Add 15 new tasks under tasks/architecture/ for Phase 0b (spec writing)
and Phase 0c (review):
Phase 0b — New specs (6):
- spec-configuration: promote from research, cleanup, align with ADRs
- spec-identity: carry from auth.md + services.md, canonical Identity
- spec-secret-service: from research/services.md SecretProtocol
- spec-storage: from research/storage.md, contract-level
- spec-flowgraph: from research/flow.md, pure computation crate
- spec-interface: new Layer 2 spec (highest risk new spec)
- spec-services: irpc service layer + OperationEnv (broadest scope)
Phase 0b — Spec updates (6):
- spec-update-overview: add crate structure, Layer 3, services
- spec-update-auth: IdentityProvider vs AuthService relationship
- spec-update-call-protocol: OperationEnv dispatch paths
- spec-update-server: DynamicConfig, ForwardingPolicy, IdentityProvider
- spec-update-napi: reload API, call protocol references
- spec-update-open-questions: resolve OQs per ADR decisions
Phase 0b — Assembly (1):
- spec-update-readme: add new docs and ADRs to tables
Phase 0c — Review (1):
- review-spec-foundation: validate consistency checklist
Generation structure (6 total):
Gen 1: 6 independent ADRs (parallel)
Gen 2: adr-027, adr-028 (depend on adr-029)
Gen 3: adr-033 + 6 spec docs + open-questions update (parallel)
Gen 4: adr review + interface/services specs + 4 spec updates
Gen 5: call-protocol update + readme update
Gen 6: spec review
|
2026-06-07 09:01:01 +00:00 |
|
