Skip to content

docs(map): describe the authority-owned Solmara Lab - #796

Merged
jeremi merged 1 commit into
mainfrom
agent/solmara-lab-docs
Aug 20, 2026
Merged

docs(map): describe the authority-owned Solmara Lab#796
jeremi merged 1 commit into
mainfrom
agent/solmara-lab-docs

Conversation

@jeremi

@jeremi jeremi commented Aug 20, 2026

Copy link
Copy Markdown
Member

Pull Request

Summary

Owning area: docs/site/.

Solmara Lab is built around six authority-owned Evidence cells that sign
independently, five purpose-limited Relay projects, and one lab Mint. The
project map still described the topology that came before it.

  • src/data/projects.yaml (and the regenerated src/data/generated/projects.json):
    the role describes the authority cells, the Relay projects, the lab Mint,
    the programme portal, the Visitor's Center, and the two evidence cadences.
    owns drops workload identity agents and Postgres, which the lab no longer
    runs, renames the citizen portal to the programme portal, and adds the
    publisher lifecycle. does_not_own drops "Evidence Gateway deployment or
    integration", which is now the opposite of what the lab demonstrates; the
    remaining three entries match the bullets map/boundaries-and-map.mdx
    already states.
  • The pinned Solmara Lab README moves to 3d5c492, in projects.yaml and in
    the boundaries-and-map.mdx ownership table.
  • explanation/architecture.mdx fenced Relay-as-a-source off as a retired
    workflow. It is the standing arrangement for the requirements that read a
    named Relay lookup, so the page states that, with an evidence comment naming
    which requirements read a Relay lookup and which read an immutable extract.
  • The unpublished historical tutorial and solmara-lab-topology.svg both
    asserted that Evidence Gateway no longer uses Relay as a source. Both now
    state that it does not require one, which is true of the current product and
    of the retired topology the page documents. The retired five-hop description
    is unchanged.

Every other Solmara reference in the repo was checked and is still accurate:
AGENTS.md, ROADMAP.md, SUPPORT.md, products/identifiers/README.md, and
the Manifest READMEs whose fixture path still exists on lab main.

Checks

From docs/site/:

  • npm run check:source (generate, frontmatter, markdownlint, Vale, evidence
    links, docset, release manifests, archive lock, cutover, notary surface,
    OpenAPI, config vocabulary, all three tutorial dry-runs, SVG a11y): passed.
  • npm test: 364 passed, 0 failed.
  • npm run build then npm run check:built:current: passed, 18,439 internal
    links and 561 llms entries checked.

No test is added: this is a documentation correction with no new functionality.
src/data/generated/projects.json is regenerated by node scripts/generate-data.mjs, never hand-edited.

Notes

No release, security, migration, or compatibility impact. last_reviewed is
not bumped on the two published pages: the style guide reserves that for a
human reading the whole page against source, and this change checked only the
Solmara claims.

DCO

  • Every commit includes a Signed-off-by trailer.
  • I reviewed the submitted changes and am responsible for the contribution.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 207340a0b0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/site/src/content/docs/explanation/architecture.mdx
Comment thread docs/site/src/content/docs/explanation/architecture.mdx Outdated
@jeremi

jeremi commented Aug 20, 2026

Copy link
Copy Markdown
Member Author

Addressed the Codex review.

P1, README-only evidence anchor: fixed. The per-requirement enumeration was the strong claim and it is gone. The visible prose keeps the weak form ("some of its requirements"), and the note is now a TODO[evidence] marker recording that the mapping lives with the deployment configuration in registrystack/solmara-lab and cannot be anchored from this repository. That matches the precedent spec/rs-arc-g.mdx already sets for Solmara Lab topology claims.

P2, SQLite in the Evidence source model: correct, and deferred as out of scope. The finding is right on the facts: products/evidence/CONCEPT.md:27 defines a fixed HTTP JSON request and one reviewed SQL statement against a read-only SQLite extract as two coequal transports, and bundle.schema.yaml carries sqlite-extract-source, so this page describing only "authoritative HTTP sources" at lines 36 and 52 is incomplete. That wording predates this change, and correcting it also means changing registry-architecture-flow.svg and its alt text, which is a product-description change with its own review rather than part of a Solmara Lab correction. The local contradiction is gone with the P1 fix, since the note no longer asserts the SQLite half. Filing it separately.

@jeremi
jeremi force-pushed the agent/solmara-lab-docs branch from 207340a to 127646e Compare August 20, 2026 19:50

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 127646e6de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/site/src/content/docs/tutorials/first-run-with-solmara-lab.mdx Outdated
@jeremi
jeremi force-pushed the agent/solmara-lab-docs branch from 127646e to 6c17e60 Compare August 20, 2026 20:01

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6c17e60017

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/site/src/data/projects.yaml
@jeremi
jeremi force-pushed the agent/solmara-lab-docs branch from 6c17e60 to 7040514 Compare August 20, 2026 20:09

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7040514056

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/site/src/data/projects.yaml
Solmara Lab is built around six authority-owned Evidence cells that sign
independently, five purpose-limited Relay projects, and one lab Mint. The
project map still described the topology that came before it: it claimed the
lab does not own Evidence Gateway deployment, listed workload identity agents
and Postgres among the services it runs, and pinned a README from before the
reset. The map now pins the lab's compose file, cell definitions, Relay
projects, and publisher scripts beside that README, so each claim about the
topology and the publisher lifecycle rests on configuration and code rather
than prose.

The architecture page fenced Relay-as-a-source off as a retired workflow. It is
the standing arrangement for the requirements that read a named Relay lookup,
so the page says that without naming them; which requirement reads which
cadence lives with the deployment configuration in the lab's own repository and
carries a TODO[evidence] marker until it is citable from here.

The historical tutorial and its diagram state that Evidence Gateway does not
require Relay rather than claiming no deployment uses one.

Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
@jeremi
jeremi force-pushed the agent/solmara-lab-docs branch from 7040514 to ba501a2 Compare August 20, 2026 20:18
@jeremi
jeremi merged commit 2f9ff25 into main Aug 20, 2026
33 checks passed
@jeremi
jeremi deleted the agent/solmara-lab-docs branch August 20, 2026 20:23
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