mptyl/ThothII
1
0
Fork 0
Code Issues 25 Pull Requests Actions Packages Projects Releases 1 Wiki Activity

test: retarget schema v3 documentation gate

Browse Source
This commit is contained in:
Codex
2026-08-31 16:07:01 +02:00
parent 74d5a3c0c8
commit 64fbe642ef
2 changed files with 14 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/operations/workspaces.md
+11 -4
View File
@@ -11,10 +11,17 @@ boundary between what can be published and what can be used by an installation.
| Installation operator | Git source, selected workspace, write-only runtime secrets, validation, connectivity, and preprocessing | commits or pushes to the workspace repository |
| Reviewer | NL→SQL decisions in a pinned session | workspace publication or preprocessing |
The root catalog has `schema_version: 1` and an ordered list of workspace identities. Each entry
must have a matching schema-v3 descriptor at `<id>/workspace.yaml` in the same Git commit. The
application validates a complete candidate revision and activates it atomically; invalid content
leaves the preceding active revision in place.
<!-- non-workspace-migration:start -->
The root catalog has `schema_version: 1` and an ordered list of workspace identities.
<!-- non-workspace-migration:end -->
<!-- workspace-descriptor-contract:start -->
Schema v3 is the only accepted workspace descriptor. Schema v1 and v2 workspace descriptors are
rejected before activation. Each catalog entry must have a matching descriptor at
`<id>/workspace.yaml` in the same Git commit. The application validates a complete candidate
revision and activates it atomically; invalid content leaves the preceding active revision in
place.
<!-- workspace-descriptor-contract:end -->
## Operator sequence
scripts/verify-schema-v3-only.sh
+3 -6
View File
@@ -266,13 +266,10 @@ check_dist_tree() {
if [[ $runtime_only -eq 0 ]]; then
require_trusted_files_at "$root" \
scripts/workspace_descriptor_doc_contract.py README.md PROJECT_STATE.md \
docs/install/local-workspace-registry.md docs/install/server-workspace-registry.md \
docs/workspace-diagnostic-protocol.md
docs/install/first-start.md docs/operations/workspaces.md
"$root/scripts/workspace_descriptor_doc_contract.py" \
--document "$root/README.md" --project-state "$root/PROJECT_STATE.md" \
--document "$root/docs/install/local-workspace-registry.md" \
--document "$root/docs/install/server-workspace-registry.md" \
--document "$root/docs/workspace-diagnostic-protocol.md"
--document "$root/README.md" \
--document "$root/docs/operations/workspaces.md"
fi
echo "schema-v3-only absence gate passed"