Repository navigation
docs: add authority and trust glossary - #20
Merged
Matrix-Engage merged 2 commits intoOct 12, 2026
Merged
Conversation
Matrix-Engage
marked this pull request as ready for review
October 12, 2026 12:29
Contributor
|
Thank you, @xiaoyu607, for your contribution to Menog OS. I have reviewed the changes in Review findings:
The contributor's licensing and provenance responsibility has been confirmed in accordance with the repository's contribution requirements. Decision: APPROVED FOR MERGE INTO This approval is limited to the documentation changes in this PR and does not constitute production-readiness or security certification. Thank you for helping make Menog OS more accessible, transparent, and understandable to new contributors. — Menog OS Maintainer |
kaveh8866
approved these changes
Oct 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add the fourteen terms requested in #17 to
docs/GLOSSARY.md, with links to the public source contracts, and add an entry under README Architecture.The glossary preserves
reachability ≠ identity ≠ admission ≠ authority ≠ executionand distinguishes proposals, capability advertisements, peer admission, evidence, and GETIG frames from execution authority. It describes implementation boundaries without making security or production-readiness guarantees.The closing guidance labels the Phase-0 boundaries document as historical and directs readers to README for current capabilities and limitations, so its old no-federation/no-mesh scope is not read as a current limit.
Addresses #17. Prepared against
2a977fe34c427ce3f544963b505d887fc890df1e.Scope
Only
docs/GLOSSARY.mdandREADME.mdchange.Verification
AI agent checks: source definitions and all relative links; fourteen requested terms; README entry;
git diff --check; isolated patch application check.pnpm typecheckpnpm buildpnpm test— 108 files passed, 2 skipped; 3,006 tests passed, 25 skippedLocal environment: macOS, Node 22.23.2, pnpm 10.11.1. Dependencies installed from the official npm registry with frozen lockfile and lifecycle scripts disabled. Initial sandbox run failed because of temporary-directory symlink/path handling and blocked local listeners. Retried with a canonical temporary root and local listener permission; the suite passed. No assertions or runtime source were changed. Test-generated evidence fixtures were restored and are excluded from the commit. Platform-specific skipped tests were not treated as passes.
Authority and security impact
Documentation only. No runtime behavior, policy, capability, isolation, cryptography, network trust, secret handling, or evidence contract changes. An approval requirement is distinguished from completed human approval.
AI assistance
Tool/model: OpenAI Codex, GPT-6 family; exact backend variant was not exposed to this session. The glossary, README addition, source analysis, verification, and PR description were materially AI-assisted.
Human verification: the contributor reviewed all fourteen definitions against their sources and reported no misunderstandings or exaggerated security guarantees. They confirmed that approval requirements, communication trust, routing and visual projection are not conflated with execution authority. Their review requested the historical Phase-0/current README distinction in the closing guidance; this revision implements that request. AI checks and automated tests are separate from this reported human review. This PR remains a draft; no reviewer request is being made.
Provenance
Prepared using public repository source only; no private customer/chat data, secrets, or additional third-party material was included. Existing documentation licensing metadata applies; no licensing files were changed. Human contributor confirmation of licensing/provenance responsibility remains pending.
Known limitations
Experimental implementation, not a security proof or production readiness claim. GETIG's current entity projection leaves event/proposal-flow collections empty. The fourteen definitions have contributor-reported human source review. The closing guidance now distinguishes historical Phase-0 boundaries from current README limits. This PR's CI/Security review remains pending.