40 lines
2 KiB
Markdown
40 lines
2 KiB
Markdown
# Scope
|
|
|
|
## In scope
|
|
|
|
- Repository registration, identity, classification, and lifecycle.
|
|
- Local checkout, host-path, remote, revision, and synchronization awareness.
|
|
- Discovery, parsing, validation, and indexing of repository-owned records.
|
|
- Workplan, task, decision, capability, service, policy, and relationship
|
|
declarations when their authoritative form is stored in a repository.
|
|
- Consistency reconciliation between files and replaceable projections.
|
|
- Controlled repository mutation through explicit commands and policy checks.
|
|
- Repository event emission, idempotency, audit evidence, and recovery.
|
|
- Repository-specific coach, lead, and director agent assignments.
|
|
- APIs and adapters through which hub-core addresses repositories.
|
|
|
|
## Out of scope
|
|
|
|
- Cross-domain inboxes, conversations, and message routing: `hub-core`.
|
|
- General work or issues without a repository authority: work/issue component.
|
|
- Recurring scheduling and workflow execution: `activity-core`.
|
|
- Authentication, user directories, and identity proofing: identity authorities.
|
|
- Authorization policy decisions: `flex-auth` or its successor.
|
|
- Credential custody: OpenBao/platform credential services.
|
|
- Git hosting: Forgejo or another source-code forge.
|
|
- Domain-specific operational, financial, security, or governance truth.
|
|
- A universal knowledge store or search engine.
|
|
|
|
## Initial extraction source
|
|
|
|
The first implementation may reuse proven State Hub behavior for repository
|
|
registration, host paths, workplan parsing, consistency reconciliation, and
|
|
file-backed status changes. Extraction must preserve behavior with compatibility
|
|
tests while removing assumptions that Repo Manager owns cross-domain state.
|
|
|
|
## API boundary
|
|
|
|
External consumers use versioned contracts. They must not depend on Repo
|
|
Manager's persistence schema. Commands distinguish requested action from
|
|
confirmed repository state; a successful command is not complete until the
|
|
resulting repository revision and normalized event are recorded.
|