Commit 8b88bd07 authored by Dimitrios Gogos's avatar Dimitrios Gogos
Browse files

docs(srm): harmonise the SRM spec into four parts and repoint links

parent 7178ae3b

README.md

+1 −1
Changes for README.md: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -12,7 +12,7 @@ This repository is an [Open Knowledge Format (OKF) v0.1](https://github.com/Goog 
|-------------|--------------|

| **Frontmatter** | Every concept document carries YAML metadata: `type`, `title`, `description`, `tags`, `timestamp`, plus `component`, `version`, and `status`. |

| **Index files** | Each folder has an `index.md` that lists its documents with one-line descriptions — progressive disclosure from platform down to component detail. |

| **Link graph** | Cross-references in the body use bundle-absolute paths (e.g. `/srm/persistence-model.md`). Companion lists at the top of each doc form the navigable graph. |

| **Link graph** | Cross-references in the body use bundle-absolute paths (e.g. `/srm/requirements-and-design.md`). Companion lists at the top of each doc form the navigable graph. |

| **Records** | [decisions/](decisions/) holds numbered ADRs (reasoning); [external-specs/](external-specs/) holds vendored API snapshots with commit pinning. |

decisions/0001-srm-command-event-subject-scheme.md

+1 −1
Changes for decisions/0001-srm-command-event-subject-scheme.md: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -11,7 +11,7 @@ status: "accepted" 


**Status:** accepted

**Date:** 2026-06-19

**Affects:** [srm/interface-contract.md](/srm/interface-contract.md), [srm/architecture.md](/srm/architecture.md), [oeg/overview-and-architecture.md](/oeg/overview-and-architecture.md), [oeg/interface-contract.md](/oeg/interface-contract.md), [oeg/interface-contract.md §9](/oeg/interface-contract.md#9-data-dictionary), [platform/architecture.md](/platform/architecture.md)

**Affects:** [srm/interface-contract.md](/srm/interface-contract.md), [srm/overview-and-architecture.md](/srm/overview-and-architecture.md), [oeg/overview-and-architecture.md](/oeg/overview-and-architecture.md), [oeg/interface-contract.md](/oeg/interface-contract.md), [oeg/interface-contract.md §9](/oeg/interface-contract.md#9-data-dictionary), [platform/architecture.md](/platform/architecture.md)



## Context

decisions/0002-no-stored-capacity.md

+1 −1
Changes for decisions/0002-no-stored-capacity.md: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -11,7 +11,7 @@ status: "accepted" 


**Status:** accepted

**Date:** 2026-06-19

**Affects:** [srm/persistence-model.md](/srm/persistence-model.md), [srm/architecture.md](/srm/architecture.md), [platform/architecture.md](/platform/architecture.md), [oeg/overview-and-architecture.md](/oeg/overview-and-architecture.md), [platform/glossary.md](/platform/glossary.md)

**Affects:** [srm/requirements-and-design.md §L](/srm/requirements-and-design.md#l-data-model-and-identity), [srm/overview-and-architecture.md](/srm/overview-and-architecture.md), [platform/architecture.md](/platform/architecture.md), [oeg/overview-and-architecture.md](/oeg/overview-and-architecture.md), [platform/glossary.md](/platform/glossary.md)



## Context

decisions/0003-canonical-jsonb-parameter-shapes.md

+1 −1
Changes for decisions/0003-canonical-jsonb-parameter-shapes.md: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -11,7 +11,7 @@ status: "accepted" 


**Status:** accepted

**Date:** 2026-06-19

**Affects:** [srm/canonical-parameters-schema.md](/srm/canonical-parameters-schema.md), [srm/persistence-model.md](/srm/persistence-model.md), [oeg/overview-and-architecture.md](/oeg/overview-and-architecture.md), [platform/architecture.md](/platform/architecture.md)

**Affects:** [srm/interface-contract.md §G](/srm/interface-contract.md#g-canonical-parameter-shapes), [srm/requirements-and-design.md §L](/srm/requirements-and-design.md#l-data-model-and-identity), [oeg/overview-and-architecture.md](/oeg/overview-and-architecture.md), [platform/architecture.md](/platform/architecture.md)



## Context

decisions/0004-capability-surface-topology.md

+2 −2
Changes for decisions/0004-capability-surface-topology.md: 2 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -11,7 +11,7 @@ status: "accepted" 


**Status:** accepted

**Date:** 2026-06-19

**Affects:** [srm/persistence-model.md](/srm/persistence-model.md), [srm/architecture.md](/srm/architecture.md), [platform/architecture.md](/platform/architecture.md), [platform/glossary.md](/platform/glossary.md)

**Affects:** [srm/requirements-and-design.md §L](/srm/requirements-and-design.md#l-data-model-and-identity), [srm/overview-and-architecture.md](/srm/overview-and-architecture.md), [platform/architecture.md](/platform/architecture.md), [platform/glossary.md](/platform/glossary.md)



## Context
@@ -41,4 +41,4 @@ data; the model generalizes beyond compute/network. Cost: a runtime registry mus 
healthy (`/readyz` checks it), and `control_path_ref` values must stay stable across

registry and database. The unique constraint on `zone(ref)` becomes

`UNIQUE(platform_ref, ref)` when multi-platform scoping is needed

([srm/architecture.md](/srm/architecture.md) §F open question **F3**).
 
([srm/overview-and-architecture.md §F](/srm/overview-and-architecture.md#f-open-questions) open question **F3**).