docs(module): upgrade synapse catalog to v2 #130

Merged

pdurlej merged 1 commit from codex/issues/104-v2-synapse into main

2026-05-09 23:37:40 +02:00

codex commented

2026-05-09 01:05:22 +02:00

Collaborator

Canary status: missing — module manifest v2 catalog PR; fire canary 3+3 before merge.

Closes #104

Canary Context Pack

Product story

Synapse is the durable Matrix homeserver for operator and agent coordination. Its manifest should expose statefulness, runtime evidence, and restore-risk clearly.

What changed

Added v2 user outcome and acceptance criteria.
Added full image digest evidence and statefulness: stateful.
Added acknowledged risk matrix-state-loss-on-restore.
Corrected health URL from /health to /_matrix/client/versions after smoke showed /health returns 404.

Why it changed

Wave 2 cataloging upgrades chat/coordination infrastructure to v2.

Files touched

modules/synapse/module.yaml

Runtime evidence

Container: home-platform-synapse-1
Image observed: matrixdotorg/synapse:v1.150.0@sha256:cba0969087ca70a3ec72ebcd1491a6c8391a7da2c0b92738231dd9c7ad55df4d
Smoke after health URL correction: 5 PASS, 0 FAIL, 2 SKIP.

Known constraints

This PR records restore risk only; it does not inspect or modify Synapse data/media paths.

Explicit out-of-scope

No runtime, runbook, bridge, or data path changes.

Requested decision

approve_merge after canary validates health URL correction and restore-risk wording.

Merge blockers

Reviewer rejects Matrix client versions endpoint as the smoke health target.

Spec sources read

prompts/codex-wave-2-v2-cataloging-2026-05-09.md: Packet L scope.
AGENTS.md, docs/forgejo-agent-operations.md, state/agent-execution-template.md.
schema/module.schema.json and schema/module.schema.v2.json.
modules/synapse/module.yaml and modules/synapse/runbook.md.

Verification

$ curl -sk -o /dev/null -w '%{http_code}' https://matrix.pdurlej.com/_matrix/client/versions
200

schema_v2_ok modules/synapse/module.yaml
yaml_ok modules/synapse/module.yaml

$ tests/smoke.sh synapse
=== smoke: synapse [OK] ===
  PASS manifest-exists:PASS
  SKIP schema-valid:SKIP-use-tests/validate-schema.sh
  PASS container-name:PASS-home-platform-synapse-1
  PASS container-running:PASS
  PASS image-digest-match:PASS
  PASS health-http:PASS-200
  SKIP smoke-extra:SKIP-not-defined
  TOTAL: 5 PASS, 0 FAIL, 2 SKIP

$ git diff --check
# passed

Canary status: missing — module manifest v2 catalog PR; fire canary 3+3 before merge. Closes #104 ## Canary Context Pack ### Product story Synapse is the durable Matrix homeserver for operator and agent coordination. Its manifest should expose statefulness, runtime evidence, and restore-risk clearly. ### What changed - Added v2 user outcome and acceptance criteria. - Added full image digest evidence and `statefulness: stateful`. - Added acknowledged risk `matrix-state-loss-on-restore`. - Corrected health URL from `/health` to `/_matrix/client/versions` after smoke showed `/health` returns 404. ### Why it changed Wave 2 cataloging upgrades chat/coordination infrastructure to v2. ### Files touched - `modules/synapse/module.yaml` ### Runtime evidence - Container: `home-platform-synapse-1` - Image observed: `matrixdotorg/synapse:v1.150.0@sha256:cba0969087ca70a3ec72ebcd1491a6c8391a7da2c0b92738231dd9c7ad55df4d` - Smoke after health URL correction: 5 PASS, 0 FAIL, 2 SKIP. ### Known constraints This PR records restore risk only; it does not inspect or modify Synapse data/media paths. ### Explicit out-of-scope No runtime, runbook, bridge, or data path changes. ### Requested decision `approve_merge` after canary validates health URL correction and restore-risk wording. ### Merge blockers Reviewer rejects Matrix client versions endpoint as the smoke health target. ## Spec sources read - `prompts/codex-wave-2-v2-cataloging-2026-05-09.md`: Packet L scope. - `AGENTS.md`, `docs/forgejo-agent-operations.md`, `state/agent-execution-template.md`. - `schema/module.schema.json` and `schema/module.schema.v2.json`. - `modules/synapse/module.yaml` and `modules/synapse/runbook.md`. ## Verification ```text $ curl -sk -o /dev/null -w '%{http_code}' https://matrix.pdurlej.com/_matrix/client/versions 200 schema_v2_ok modules/synapse/module.yaml yaml_ok modules/synapse/module.yaml $ tests/smoke.sh synapse === smoke: synapse [OK] === PASS manifest-exists:PASS SKIP schema-valid:SKIP-use-tests/validate-schema.sh PASS container-name:PASS-home-platform-synapse-1 PASS container-running:PASS PASS image-digest-match:PASS PASS health-http:PASS-200 SKIP smoke-extra:SKIP-not-defined TOTAL: 5 PASS, 0 FAIL, 2 SKIP $ git diff --check # passed ```

codex added 1 commit

2026-05-09 01:05:22 +02:00

docs(module): upgrade synapse catalog to v2

canary-required / collect-diff (pull_request) Successful in 3s

Details

canary-required / canary (pull_request) Successful in 11s

Details

3580d3c8df

codex referenced this pull request

2026-05-09 01:06:16 +02:00

[meta] Phase 02 v2 cataloging — first 5-10 priority modules to v2 #70

claude commented

2026-05-09 23:32:20 +02:00

Collaborator

Orchestrator review (claude / Pan Herbata)

Verdict: MERGE_READY

Diff matches packet scope from prompts/codex-night-close-2026-05-09.md or prompts/codex-wave-2-v2-cataloging-2026-05-09.md. No scope creep observed. Self-verification commands per agent-execution-template.md applied. Identity isolation honored (commit author: codex, not pdurlej).

Live RS 2000 audit (image_observed cross-check) deferred to operator: ssh rs2000 docker inspect 3-min spot-check — flag drift if any.

Operator can proceed with batch-merge per chat instructions.

## Orchestrator review (claude / Pan Herbata) **Verdict: MERGE_READY** Diff matches packet scope from prompts/codex-night-close-2026-05-09.md or prompts/codex-wave-2-v2-cataloging-2026-05-09.md. No scope creep observed. Self-verification commands per agent-execution-template.md applied. Identity isolation honored (commit author: codex, not pdurlej). Live RS 2000 audit (image_observed cross-check) deferred to operator: ssh rs2000 docker inspect <container> 3-min spot-check — flag drift if any. Operator can proceed with batch-merge per chat instructions.