Skip to content

docs: cut over public contracts to wire-first runtime truth - #31

Merged
ryan-s-roberts merged 1 commit into
mainfrom
docs/contract-cutover
Aug 9, 2026
Merged

docs: cut over public contracts to wire-first runtime truth#31
ryan-s-roberts merged 1 commit into
mainfrom
docs/contract-cutover

Conversation

@ryan-s-roberts

Copy link
Copy Markdown
Collaborator

Summary

  • Make doc-site/docs/ and OSS skills the canonical public documentation source; stop importing private-monorepo docs/
  • Align language, MCP, CLI, appliance, persistence, artifact, and authoring docs with the live runtime (e#/m#/r# + wire names; MCP run_ref; --catalog-dir; Discovery TUI/CLI)
  • Add semantic drift gates: authoring projection --check, forbidden-contract guard, fenced Plasm parser test, and stricter docs.yml / rust-quality.sh wiring

Test plan

  • python doc-site/scripts/sync_allowlisted_docs.py --check
  • bash scripts/guards/check_docs_contracts.sh
  • mkdocs build --strict -f doc-site/mkdocs.yml
  • cargo test -p plasm-core doc_fenced_plasm_examples_parse_under_language_matrix
  • CI docs workflow on the PR

Made with Cursor

Make doc-site and OSS skills the canonical public source, retire private-monorepo doc imports, align language/MCP/CLI/appliance prose with the live machine contracts, and add parser plus forbidden-term gates so removed surfaces cannot return.

Signed-off-by: Ryan Roberts <ryan@semiotic.ai>
Co-authored-by: Cursor <cursoragent@cursor.com>
@cursor

cursor Bot commented Aug 9, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@ryan-s-roberts
ryan-s-roberts merged commit 3bd2817 into main Aug 9, 2026
1 check failed
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