From c1696e0695b22461c1b89770cf60aa673f3c66d2 Mon Sep 17 00:00:00 2001 From: Jason Wang Date: Tue, 9 Jun 2026 17:44:08 +0800 Subject: [PATCH 1/2] projection: publish clean MPLP public OSS candidate --- .../skills/cross-repo-boundary-guard/SKILL.md | 69 --- .../docs-minimalism-governance/SKILL.md | 39 -- .../mplp-schema-v2-invariant-intake/SKILL.md | 85 --- .../release-gate-and-seal-discipline/SKILL.md | 52 -- .../skills/repo-truth-first-audit/SKILL.md | 57 -- .codex/agents/package_surface_auditor.toml | 27 - .codex/agents/product_boundary_reviewer.toml | 28 - .codex/agents/protocol_schema_reviewer.toml | 25 - .codex/agents/publication_claim_reviewer.toml | 26 - .../agents/release_governance_reviewer.toml | 24 - .codex/agents/runtime_binding_reviewer.toml | 21 - .codex/config.toml | 16 - .../skills/cross-repo-boundary-guard/SKILL.md | 69 --- .../docs-minimalism-governance/SKILL.md | 39 -- .../mplp-schema-v2-invariant-intake/SKILL.md | 85 --- .../release-gate-and-seal-discipline/SKILL.md | 52 -- .codex/skills/repo-truth-first-audit/SKILL.md | 57 -- .editorconfig | 9 + .github/workflows/codeql.yml | 1 + .github/workflows/deploy-docs.yml | 92 +-- .gitignore | 1 - .gitmodules | 3 - AGENTS.md | 84 --- CHANGELOG.md | 215 +------ GOVERNANCE.md | 32 +- MPLP_website | 1 - README.md | 48 +- RELEASE_MANIFEST.json | 14 +- artifacts/release/publish-gate-report.json | 78 --- artifacts/release/publish-set.json | 67 --- artifacts/release/pypi-gate-report.json | 29 - artifacts/release/pypi-set.json | 11 - .../governance/license-governance.md | 2 +- .../reference/audit-route/v1.0-route-a.md | 4 + .../uiux-projections/UIUX-DIFF-v0.17.md | 4 + .../uiux-projections/UIUX-DIFF-v0.9-v0.17.md | 4 + .../uiux-projections/UIUX-MAP-v0.9-v0.17.md | 4 + .../how-to-use-projection-map.md | 4 + .../architecture/l1-core-protocol.md | 11 +- docs/docs/validation-lab/index.md | 4 + docs/docusaurus.config.ts | 2 +- docs/ops/PACKAGE_METADATA_BASELINE.yaml | 52 -- docs/ops/README_CANONICAL_TEMPLATE_v1.0.md | 86 --- docs/ops/RELEASE_WORKFLOW_v1.0.md | 35 -- docs/ops/TERMINOLOGY_STANDARD_v1.0.md | 108 ---- .../gates/docs-nonnormative-pointer-only.mjs | 105 ---- docs/src/css/custom.css.clean_backup | 127 ----- docs/src/pages/index.module.css | 92 ++- docs/src/pages/index.tsx | 94 ++- docs/static/mermaid/03f6a1c4ea3ae71b.dark.svg | 1 - .../static/mermaid/03f6a1c4ea3ae71b.light.svg | 1 - docs/static/mermaid/0b027f043a41dd74.dark.svg | 1 - .../static/mermaid/0b027f043a41dd74.light.svg | 1 - docs/static/mermaid/13d010945f38b1b8.dark.svg | 1 - .../static/mermaid/13d010945f38b1b8.light.svg | 1 - docs/static/mermaid/17d435b8a51f9f7a.dark.svg | 1 - .../static/mermaid/17d435b8a51f9f7a.light.svg | 1 - docs/static/mermaid/1dee506904af5221.dark.svg | 1 - .../static/mermaid/1dee506904af5221.light.svg | 1 - docs/static/mermaid/203e3ff10debbc59.dark.svg | 1 - .../static/mermaid/203e3ff10debbc59.light.svg | 1 - docs/static/mermaid/25e4b645ffd43def.dark.svg | 1 - .../static/mermaid/25e4b645ffd43def.light.svg | 1 - docs/static/mermaid/2d4ae71db41b70f6.dark.svg | 1 - .../static/mermaid/2d4ae71db41b70f6.light.svg | 1 - docs/static/mermaid/372f3dfcf3e186ce.dark.svg | 1 - .../static/mermaid/372f3dfcf3e186ce.light.svg | 1 - docs/static/mermaid/381d99f56ab5380b.dark.svg | 1 - .../static/mermaid/381d99f56ab5380b.light.svg | 1 - docs/static/mermaid/3823eeb044d6f498.dark.svg | 1 - .../static/mermaid/3823eeb044d6f498.light.svg | 1 - docs/static/mermaid/384e45a09987bbdc.dark.svg | 1 - .../static/mermaid/384e45a09987bbdc.light.svg | 1 - docs/static/mermaid/46eb8cc753f5fa48.dark.svg | 1 - .../static/mermaid/46eb8cc753f5fa48.light.svg | 1 - docs/static/mermaid/50c478d3011a0924.dark.svg | 1 - .../static/mermaid/50c478d3011a0924.light.svg | 1 - docs/static/mermaid/53381ce57a40fa2d.dark.svg | 1 - .../static/mermaid/53381ce57a40fa2d.light.svg | 1 - docs/static/mermaid/5968b52d0c6e020d.dark.svg | 1 - .../static/mermaid/5968b52d0c6e020d.light.svg | 1 - docs/static/mermaid/5cd6cf2e8cb9f239.dark.svg | 1 - .../static/mermaid/5cd6cf2e8cb9f239.light.svg | 1 - docs/static/mermaid/6246257eb1ed66f2.dark.svg | 1 - .../static/mermaid/6246257eb1ed66f2.light.svg | 1 - docs/static/mermaid/6a6ea3139e594005.dark.svg | 1 - .../static/mermaid/6a6ea3139e594005.light.svg | 1 - docs/static/mermaid/6b3b207bb2aff734.dark.svg | 1 - .../static/mermaid/6b3b207bb2aff734.light.svg | 1 - docs/static/mermaid/6cdd6464bbfb3830.dark.svg | 1 - .../static/mermaid/6cdd6464bbfb3830.light.svg | 1 - docs/static/mermaid/6fa8ed6a705962cd.dark.svg | 1 - .../static/mermaid/6fa8ed6a705962cd.light.svg | 1 - docs/static/mermaid/7109580d1f77ebfc.dark.svg | 1 - .../static/mermaid/7109580d1f77ebfc.light.svg | 1 - docs/static/mermaid/760030f7572a6f27.dark.svg | 1 - .../static/mermaid/760030f7572a6f27.light.svg | 1 - docs/static/mermaid/7b45b30fac58fcf1.dark.svg | 1 - .../static/mermaid/7b45b30fac58fcf1.light.svg | 1 - docs/static/mermaid/7cbc7eb0aad8c11b.dark.svg | 1 - .../static/mermaid/7cbc7eb0aad8c11b.light.svg | 1 - docs/static/mermaid/7ff3e2ed31e8415f.dark.svg | 1 - .../static/mermaid/7ff3e2ed31e8415f.light.svg | 1 - docs/static/mermaid/813af8a6e20c87ca.dark.svg | 1 - .../static/mermaid/813af8a6e20c87ca.light.svg | 1 - docs/static/mermaid/8344e7078a03df0d.dark.svg | 1 - .../static/mermaid/8344e7078a03df0d.light.svg | 1 - docs/static/mermaid/83fa0e9e559b8ea2.dark.svg | 1 - .../static/mermaid/83fa0e9e559b8ea2.light.svg | 1 - docs/static/mermaid/852eba31132f70ba.dark.svg | 1 - .../static/mermaid/852eba31132f70ba.light.svg | 1 - docs/static/mermaid/88f38ec5e2bf4512.dark.svg | 1 - .../static/mermaid/88f38ec5e2bf4512.light.svg | 1 - docs/static/mermaid/8a9b79cb83661ebe.dark.svg | 1 - .../static/mermaid/8a9b79cb83661ebe.light.svg | 1 - docs/static/mermaid/9a730e3846503302.dark.svg | 1 - .../static/mermaid/9a730e3846503302.light.svg | 1 - docs/static/mermaid/9d16c09133c9e02b.dark.svg | 1 - .../static/mermaid/9d16c09133c9e02b.light.svg | 1 - docs/static/mermaid/9d1da9da1f786fc7.dark.svg | 1 - .../static/mermaid/9d1da9da1f786fc7.light.svg | 1 - docs/static/mermaid/9d97c50127e4ff52.dark.svg | 1 - .../static/mermaid/9d97c50127e4ff52.light.svg | 1 - docs/static/mermaid/9df2eaa43052bdf9.dark.svg | 1 - .../static/mermaid/9df2eaa43052bdf9.light.svg | 1 - docs/static/mermaid/a3553a40a5e0cef2.dark.svg | 1 - .../static/mermaid/a3553a40a5e0cef2.light.svg | 1 - docs/static/mermaid/a82ad6d1de57acb9.dark.svg | 1 - .../static/mermaid/a82ad6d1de57acb9.light.svg | 1 - docs/static/mermaid/a91d9bc3493e7f5a.dark.svg | 1 - .../static/mermaid/a91d9bc3493e7f5a.light.svg | 1 - docs/static/mermaid/ab48cd9eb15944b2.dark.svg | 1 - .../static/mermaid/ab48cd9eb15944b2.light.svg | 1 - docs/static/mermaid/ac41416d7498f164.dark.svg | 1 - .../static/mermaid/ac41416d7498f164.light.svg | 1 - docs/static/mermaid/add665e10c0bdbf5.dark.svg | 1 - .../static/mermaid/add665e10c0bdbf5.light.svg | 1 - docs/static/mermaid/b985fd791fbcb213.dark.svg | 1 - .../static/mermaid/b985fd791fbcb213.light.svg | 1 - docs/static/mermaid/bbea2c23ef5c7672.dark.svg | 1 - .../static/mermaid/bbea2c23ef5c7672.light.svg | 1 - docs/static/mermaid/bc65d25db4e24586.dark.svg | 1 - .../static/mermaid/bc65d25db4e24586.light.svg | 1 - docs/static/mermaid/beaf633e2a40766b.dark.svg | 1 - .../static/mermaid/beaf633e2a40766b.light.svg | 1 - docs/static/mermaid/c3da52705df75d92.dark.svg | 1 - .../static/mermaid/c3da52705df75d92.light.svg | 1 - docs/static/mermaid/cfad987f3eb3f443.dark.svg | 1 - .../static/mermaid/cfad987f3eb3f443.light.svg | 1 - docs/static/mermaid/d03a6dea7f89f987.dark.svg | 1 - .../static/mermaid/d03a6dea7f89f987.light.svg | 1 - docs/static/mermaid/d24923eeabd17e96.dark.svg | 1 - .../static/mermaid/d24923eeabd17e96.light.svg | 1 - docs/static/mermaid/d460de40c79a91ba.dark.svg | 1 - .../static/mermaid/d460de40c79a91ba.light.svg | 1 - docs/static/mermaid/d7ebb8b48e29e83b.dark.svg | 1 - .../static/mermaid/d7ebb8b48e29e83b.light.svg | 1 - docs/static/mermaid/d99a12c6ff5589fb.dark.svg | 1 - .../static/mermaid/d99a12c6ff5589fb.light.svg | 1 - docs/static/mermaid/f676ffe4e91ae2bd.dark.svg | 1 - .../static/mermaid/f676ffe4e91ae2bd.light.svg | 1 - docs/static/mermaid/f67a3e73ee3b214d.dark.svg | 1 - .../static/mermaid/f67a3e73ee3b214d.light.svg | 1 - docs/static/mermaid/fe61fa5dc7c27657.dark.svg | 1 - .../static/mermaid/fe61fa5dc7c27657.light.svg | 1 - docs/static/mermaid/fe7aff159efce728.dark.svg | 1 - .../static/mermaid/fe7aff159efce728.light.svg | 1 - docs/static/mermaid/ff768c08ae1fcb6d.dark.svg | 1 - .../static/mermaid/ff768c08ae1fcb6d.light.svg | 1 - .../01-constitutional/legal/LEGAL_NOTICE.md | 8 +- .../sdk/CHECKLIST-SDK-RELEASE.md | 219 ------- .../sdk/METHOD-SDKR-01_RELEASE_PIPELINE.md | 121 ---- .../sdk/METHOD-SDKR-05_RELEASE_MANIFEST.md | 142 ----- ...DKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md | 536 ------------------ .../sdk/METHOD-SDKR-09_RELEASE_READINESS.md | 337 ----------- ...MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0.md | 402 ------------- ...0-PUBLICATION-CLOSURE-RECORD-2026-04-06.md | 196 ------- ...PUBLIC-PROMOTION-BRANCH-SEAL-2026-04-06.md | 173 ------ ...ERIFICATION-SUBSTRATE-ADJUDICATION-v0.1.md | 236 -------- ...ROTOCOL-TAG-ALIGNMENT-ADJUDICATION-v0.1.md | 270 --------- ...EASE-CHECKLIST-2026-04-05-public-oss-01.md | 121 ---- .../MPLP-RELEASE-CHECKLIST-TEMPLATE-v1.0.md | 125 ---- .../MPLP-RELEASE-READINESS-BASELINE-v1.0.md | 303 ---------- ...-PRESERVATION-CLOSURE-RECORD-2026-04-07.md | 137 ----- ...ASE-BATCH-STATUS-OPEN-RECORD-2026-04-06.md | 194 ------- ...ASE-BATCH-STATUS-OPEN-RECORD-2026-04-07.md | 172 ------ .../templates/DEPENDENCY_CHECK_TEMPLATE.md | 73 --- .../templates/DERIVATION_PROOF_TEMPLATE.yaml | 83 --- .../ISOLATED_VERIFICATION_REPORT_TEMPLATE.md | 114 ---- .../RELEASE_BUNDLE_MANIFEST_TEMPLATE.json | 166 ------ .../sdk/templates/RELEASE_INTENT_TEMPLATE.md | 65 --- .../VERSION_CHANGE_JUSTIFICATION_TEMPLATE.md | 59 -- ...-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-SEAL.md | 149 ----- ...CROSS-SURFACE-CLOSURE-RECORD-2026-04-08.md | 200 ------- ...EPRECATED-CONTENT-SEPARATION-2026-04-02.md | 9 +- .../MPGC-DESIGNATE-LAB-AUTHORITY-HOME.md | 65 ++- .../MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT.md | 10 +- .../04-records/SEAL-SDKR-08-GOVERNANCE-v1.md | 174 ------ .../UNIFIED-RECTIFICATION-MAINLINE-CLOSURE.md | 13 +- ...TION_LAB_V2-TAIL-DISPOSITION-2026-04-01.md | 4 +- governance/EXECUTION_ORDER.md | 40 +- governance/README.md | 216 +++---- ...CANDIDATE-BACKLOG-REVIEW-INVENTORY-v0.1.md | 35 -- ...IRTY-WORKTREE-RECONCILIATION-AUDIT-v0.1.md | 40 -- .../MPLP-DIST-TARGET-REALITY-MATRIX-v0.1.md | 47 -- ...M-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1.md | 110 ---- ...NAMING-BOUNDARY-EXCEPTION-REGISTER-v0.1.md | 33 -- ...P-LEGACY-NAMING-BOUNDARY-INVENTORY-v0.1.md | 49 -- ...NDIDATE-INTAKE-NON-PROMOTION-AUDIT-v0.1.md | 32 -- ...EW-PREPARATION-NON-PROMOTION-AUDIT-v0.1.md | 42 -- ...P-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1.md | 144 ----- ...-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md | 48 -- .../MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md | 172 ------ ...NDIDATE-BACKLOG-CONSOLIDATION-PLAN-v0.1.md | 41 -- .../MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md | 51 -- .../backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md | 132 ----- .../MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1.md | 36 -- ...ARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md | 36 -- ...P-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md | 138 ----- ...ION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md | 186 ------ ...IFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md | 73 --- ...-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md | 47 -- ...E-NO-CHANGE-AND-CANDIDATE-DECISION-v0.1.md | 101 ---- ...IDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md | 48 -- ...IFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md | 56 -- ...-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md | 46 -- ...OWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md | 85 --- .../candidates/MPGC-CANDIDATE-BACKLOG-v0.1.md | 351 ------------ governance/codex-goals/CODEX-GOAL-TEMPLATE.md | 151 ----- ...MPLP-CANDIDATE-BACKLOG-REVIEW-GATE-v0.1.md | 40 -- .../MPLP-CANDIDATE-CONSOLIDATION-GATE-v0.1.md | 41 -- ...DOWNSTREAM-EVIDENCE-ANONYMITY-GATE-v0.1.md | 40 -- .../MPLP-MPGC-CANDIDATE-INTAKE-GATE-v0.1.md | 30 - ...-CANDIDATE-REVIEW-PREPARATION-GATE-v0.1.md | 40 -- governance/global-alignment-baseline.yaml | 64 +++ governance/global-alignment-current.yaml | 13 + ...C-CANDIDATE-DECISION-NEEDED-MATRIX-v0.1.md | 26 - .../MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md | 32 -- ...TAKE-EVIDENCE-VOCABULARY-CANDIDATE-v0.1.md | 73 --- ...AKE-LIFECYCLE-GOVERNANCE-CANDIDATE-v0.1.md | 64 --- ...STOP-ESCALATION-REVISION-CANDIDATE-v0.1.md | 65 --- ...CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1.md | 33 -- ...-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md | 38 -- .../MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md | 41 -- ...CANDIDATE-REVIEW-PREPARATION-INDEX-v0.1.md | 36 -- .../MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1.md | 40 -- .../MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md | 37 -- ...GY-POINTER-MANIFEST-DECISION-2026-05-29.md | 120 ---- governance/release/MPLP-RELEASE-SOP.md | 393 ------------- ...PLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1.md | 75 --- ...MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD.md | 95 ---- .../MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md | 177 ------ .../research/MPLP-CANDIDATE-BACKLOG-v0.1.md | 160 ------ ...ION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md | 134 ----- package.json | 8 +- packages/npm/compliance/CHANGELOG.md | 5 - packages/npm/compliance/DERIVATION_PROOF.yaml | 33 -- packages/npm/compliance/LICENSE | 17 - packages/npm/compliance/README.md | 56 -- packages/npm/compliance/dist/index.d.ts | 22 - packages/npm/compliance/dist/index.js | 13 - packages/npm/compliance/package.json | 66 --- packages/npm/compliance/tsconfig.json | 23 - .../npm/conformance/DERIVATION_PROOF.yaml | 51 +- packages/npm/conformance/README.md | 84 ++- packages/npm/conformance/dist/index.d.ts | 22 - packages/npm/conformance/dist/index.js | 13 - packages/npm/conformance/package-lock.json | 138 ----- packages/npm/conformance/package.json | 20 +- packages/npm/conformance/src/index.ts | 76 ++- .../npm/coordination/DERIVATION_PROOF.yaml | 26 +- packages/npm/coordination/README.md | 71 +-- packages/npm/coordination/dist/index.d.ts | 22 - packages/npm/coordination/dist/index.js | 13 - packages/npm/coordination/package.json | 2 +- packages/npm/core/DERIVATION_PROOF.yaml | 26 +- packages/npm/core/README.md | 74 +-- packages/npm/core/dist/index.d.ts | 22 - packages/npm/core/dist/index.js | 13 - packages/npm/core/package.json | 7 +- packages/npm/devtools/DERIVATION_PROOF.yaml | 31 +- packages/npm/devtools/README.md | 10 +- packages/npm/devtools/dist/index.d.ts | 22 - packages/npm/devtools/dist/index.js | 13 - packages/npm/devtools/package.json | 8 +- .../DERIVATION_PROOF.yaml | 26 +- packages/npm/integration-llm-http/README.md | 70 ++- .../npm/integration-llm-http/dist/index.d.ts | 22 - .../npm/integration-llm-http/dist/index.js | 13 - .../npm/integration-llm-http/package.json | 7 +- .../DERIVATION_PROOF.yaml | 26 +- packages/npm/integration-storage-fs/README.md | 70 ++- .../integration-storage-fs/dist/index.d.ts | 22 - .../npm/integration-storage-fs/dist/index.js | 13 - .../npm/integration-storage-fs/package.json | 7 +- .../DERIVATION_PROOF.yaml | 26 +- packages/npm/integration-storage-kv/README.md | 71 ++- .../integration-storage-kv/dist/index.d.ts | 22 - .../npm/integration-storage-kv/dist/index.js | 13 - .../npm/integration-storage-kv/package.json | 7 +- .../DERIVATION_PROOF.yaml | 26 +- .../npm/integration-tools-generic/README.md | 70 ++- .../integration-tools-generic/dist/index.d.ts | 22 - .../integration-tools-generic/dist/index.js | 13 - .../integration-tools-generic/package.json | 7 +- packages/npm/modules/DERIVATION_PROOF.yaml | 26 +- packages/npm/modules/README.md | 71 +-- packages/npm/modules/dist/index.d.ts | 22 - packages/npm/modules/dist/index.js | 13 - packages/npm/modules/package.json | 7 +- .../npm/runtime-minimal/DERIVATION_PROOF.yaml | 27 +- packages/npm/runtime-minimal/README.md | 90 ++- packages/npm/runtime-minimal/dist/index.d.ts | 22 - packages/npm/runtime-minimal/dist/index.js | 13 - packages/npm/runtime-minimal/package.json | 7 +- packages/npm/schema/README.md | 87 ++- packages/npm/schema/dist/index.d.ts | 24 - packages/npm/schema/dist/index.js | 20 - packages/npm/schema/dist/kernel-duties.d.ts | 19 - packages/npm/schema/dist/kernel-duties.js | 14 - packages/npm/schema/package.json | 5 +- .../schema/schemas/profiles/map-profile.yaml | 123 ---- .../schema/schemas/profiles/sa-profile.yaml | 109 ---- .../schemas/taxonomy/event-taxonomy.yaml | 112 ---- .../taxonomy/integration-event-taxonomy.yaml | 436 -------------- .../schemas/taxonomy/learning-taxonomy.yaml | 291 ---------- .../schemas/taxonomy/module-event-matrix.yaml | 253 --------- packages/npm/sdk-ts/DERIVATION_PROOF.yaml | 27 +- packages/npm/sdk-ts/README.md | 115 ++-- packages/npm/sdk-ts/dist/index.d.ts | 24 - packages/npm/sdk-ts/dist/index.js | 20 - packages/npm/sdk-ts/dist/kernel-duties.d.ts | 19 - packages/npm/sdk-ts/dist/kernel-duties.js | 14 - packages/npm/sdk-ts/package.json | 5 +- .../sdk-ts/schemas/profiles/map-profile.yaml | 123 ---- .../sdk-ts/schemas/profiles/sa-profile.yaml | 109 ---- .../schemas/taxonomy/event-taxonomy.yaml | 112 ---- .../taxonomy/integration-event-taxonomy.yaml | 436 -------------- .../schemas/taxonomy/learning-taxonomy.yaml | 291 ---------- .../schemas/taxonomy/module-event-matrix.yaml | 253 --------- packages/npm/validator/LICENSE.txt | Bin 22950 -> 0 bytes packages/npm/validator/README.md | Bin 4819 -> 0 bytes packages/npm/validator/bin/mplp.js | Bin 100 -> 0 bytes packages/npm/validator/package.json | 70 --- .../schemas/events/mplp-map-event.schema.json | Bin 8378 -> 0 bytes .../schemas/events/mplp-sa-event.schema.json | Bin 5748 -> 0 bytes .../validator/schemas/mplp-collab.schema.json | Bin 16244 -> 0 bytes .../schemas/mplp-confirm.schema.json | Bin 16324 -> 0 bytes .../schemas/mplp-context.schema.json | Bin 18484 -> 0 bytes .../validator/schemas/mplp-core.schema.json | Bin 11974 -> 0 bytes .../validator/schemas/mplp-dialog.schema.json | Bin 13436 -> 0 bytes .../schemas/mplp-extension.schema.json | Bin 12966 -> 0 bytes .../schemas/mplp-network.schema.json | Bin 14730 -> 0 bytes .../validator/schemas/mplp-plan.schema.json | Bin 13310 -> 0 bytes .../validator/schemas/mplp-role.schema.json | Bin 10922 -> 0 bytes .../validator/schemas/mplp-trace.schema.json | Bin 15792 -> 0 bytes packages/pypi/mplp-sdk/DERIVATION_PROOF.yaml | 65 ++- packages/pypi/mplp-sdk/LICENSE | 17 - packages/pypi/mplp-sdk/README.md | 109 ++-- .../dist/mplp_sdk-1.0.5-py3-none-any.whl | Bin 3436 -> 0 bytes .../pypi/mplp-sdk/dist/mplp_sdk-1.0.5.tar.gz | Bin 3316 -> 0 bytes packages/pypi/mplp-sdk/pyproject.toml | 3 +- packages/pypi/mplp-sdk/src/mplp/__init__.py | 6 +- .../pypi/mplp-sdk/src/mplp/kernel_duties.py | 2 +- .../mplp-sdk/src/mplp_sdk.egg-info/PKG-INFO | 133 ----- .../src/mplp_sdk.egg-info/SOURCES.txt | 9 - .../mplp_sdk.egg-info/dependency_links.txt | 1 - .../src/mplp_sdk.egg-info/top_level.txt | 1 - packages/sources/sdk-py/README.md | 1 - packages/sources/sdk-py/pyproject.toml | 4 +- packages/sources/sdk-py/src/mplp/__init__.py | 2 +- .../sdk-py/src/mplp_sdk.egg-info/PKG-INFO | 120 ---- .../sdk-py/src/mplp_sdk.egg-info/SOURCES.txt | 8 - .../mplp_sdk.egg-info/dependency_links.txt | 1 - .../sdk-py/src/mplp_sdk.egg-info/requires.txt | 1 - .../src/mplp_sdk.egg-info/top_level.txt | 1 - packages/sources/sdk-ts/DERIVATION_PROOF.yaml | 2 +- packages/sources/sdk-ts/README.md | 3 +- packages/sources/sdk-ts/package.json | 6 +- .../sdk-ts/scripts/verify-dist-surface.mjs | 36 ++ packages/sources/validator/LICENSE.txt | Bin 22950 -> 0 bytes packages/sources/validator/README.md | Bin 4826 -> 0 bytes packages/sources/validator/package.json | 30 - .../validator/scripts/sync-schemas.mjs | Bin 2576 -> 0 bytes packages/sources/validator/src/cli.ts | Bin 2840 -> 0 bytes .../validator/src/commands/validate.ts | Bin 9754 -> 0 bytes .../sources/validator/src/commands/version.ts | Bin 1302 -> 0 bytes .../sources/validator/src/engine/flow01.ts | Bin 7158 -> 0 bytes .../sources/validator/src/engine/schema.ts | Bin 10012 -> 0 bytes packages/sources/validator/src/index.ts | Bin 1122 -> 0 bytes packages/sources/validator/tsconfig.json | 26 - release-config.yaml | 190 ++++++- .../mplp-public-manifest.example.json | 190 ------- .../mplp-public-manifest.schema.json | 499 ---------------- scripts/03-docs/semantic/mapping-health.mjs | 156 ----- scripts/03-docs/semantic/semantic-lint.mjs | 427 -------------- scripts/03-docs/verify-governance-styling.mjs | 102 ---- scripts/04-build/pre-release-check.mjs | 154 ----- scripts/04-build/root-verification.mjs | 164 ------ scripts/04-build/update-frozen-headers.mjs | 288 ---------- scripts/codex/repo-truth-first.sh | 63 -- .../packages/validate-public-npm-package.mjs | 279 --------- scripts/semantic/gate-publish-set.mjs | 189 ------ scripts/semantic/gate_pypi_set/__init__.py | 14 - scripts/semantic/gate_pypi_set/checks.py | 156 ----- scripts/semantic/gate_pypi_set/loader.py | 54 -- scripts/semantic/gate_pypi_set/main.py | 223 -------- scripts/semantic/gate_pypi_set/model.py | 89 --- scripts/semantic/gate_pypi_set/report.py | 29 - scripts/semantic/validate-public-manifest.mjs | 150 ----- 410 files changed, 1594 insertions(+), 19061 deletions(-) delete mode 100644 .agents/skills/cross-repo-boundary-guard/SKILL.md delete mode 100644 .agents/skills/docs-minimalism-governance/SKILL.md delete mode 100644 .agents/skills/mplp-schema-v2-invariant-intake/SKILL.md delete mode 100644 .agents/skills/release-gate-and-seal-discipline/SKILL.md delete mode 100644 .agents/skills/repo-truth-first-audit/SKILL.md delete mode 100644 .codex/agents/package_surface_auditor.toml delete mode 100644 .codex/agents/product_boundary_reviewer.toml delete mode 100644 .codex/agents/protocol_schema_reviewer.toml delete mode 100644 .codex/agents/publication_claim_reviewer.toml delete mode 100644 .codex/agents/release_governance_reviewer.toml delete mode 100644 .codex/agents/runtime_binding_reviewer.toml delete mode 100644 .codex/config.toml delete mode 100644 .codex/skills/cross-repo-boundary-guard/SKILL.md delete mode 100644 .codex/skills/docs-minimalism-governance/SKILL.md delete mode 100644 .codex/skills/mplp-schema-v2-invariant-intake/SKILL.md delete mode 100644 .codex/skills/release-gate-and-seal-discipline/SKILL.md delete mode 100644 .codex/skills/repo-truth-first-audit/SKILL.md create mode 100644 .editorconfig delete mode 100644 .gitignore delete mode 100644 .gitmodules delete mode 100644 AGENTS.md delete mode 160000 MPLP_website delete mode 100644 artifacts/release/publish-gate-report.json delete mode 100644 artifacts/release/publish-set.json delete mode 100644 artifacts/release/pypi-gate-report.json delete mode 100644 artifacts/release/pypi-set.json delete mode 100644 docs/ops/PACKAGE_METADATA_BASELINE.yaml delete mode 100644 docs/ops/README_CANONICAL_TEMPLATE_v1.0.md delete mode 100644 docs/ops/RELEASE_WORKFLOW_v1.0.md delete mode 100644 docs/ops/TERMINOLOGY_STANDARD_v1.0.md delete mode 100644 docs/scripts/gates/docs-nonnormative-pointer-only.mjs delete mode 100644 docs/src/css/custom.css.clean_backup delete mode 100644 docs/static/mermaid/03f6a1c4ea3ae71b.dark.svg delete mode 100644 docs/static/mermaid/03f6a1c4ea3ae71b.light.svg delete mode 100644 docs/static/mermaid/0b027f043a41dd74.dark.svg delete mode 100644 docs/static/mermaid/0b027f043a41dd74.light.svg delete mode 100644 docs/static/mermaid/13d010945f38b1b8.dark.svg delete mode 100644 docs/static/mermaid/13d010945f38b1b8.light.svg delete mode 100644 docs/static/mermaid/17d435b8a51f9f7a.dark.svg delete mode 100644 docs/static/mermaid/17d435b8a51f9f7a.light.svg delete mode 100644 docs/static/mermaid/1dee506904af5221.dark.svg delete mode 100644 docs/static/mermaid/1dee506904af5221.light.svg delete mode 100644 docs/static/mermaid/203e3ff10debbc59.dark.svg delete mode 100644 docs/static/mermaid/203e3ff10debbc59.light.svg delete mode 100644 docs/static/mermaid/25e4b645ffd43def.dark.svg delete mode 100644 docs/static/mermaid/25e4b645ffd43def.light.svg delete mode 100644 docs/static/mermaid/2d4ae71db41b70f6.dark.svg delete mode 100644 docs/static/mermaid/2d4ae71db41b70f6.light.svg delete mode 100644 docs/static/mermaid/372f3dfcf3e186ce.dark.svg delete mode 100644 docs/static/mermaid/372f3dfcf3e186ce.light.svg delete mode 100644 docs/static/mermaid/381d99f56ab5380b.dark.svg delete mode 100644 docs/static/mermaid/381d99f56ab5380b.light.svg delete mode 100644 docs/static/mermaid/3823eeb044d6f498.dark.svg delete mode 100644 docs/static/mermaid/3823eeb044d6f498.light.svg delete mode 100644 docs/static/mermaid/384e45a09987bbdc.dark.svg delete mode 100644 docs/static/mermaid/384e45a09987bbdc.light.svg delete mode 100644 docs/static/mermaid/46eb8cc753f5fa48.dark.svg delete mode 100644 docs/static/mermaid/46eb8cc753f5fa48.light.svg delete mode 100644 docs/static/mermaid/50c478d3011a0924.dark.svg delete mode 100644 docs/static/mermaid/50c478d3011a0924.light.svg delete mode 100644 docs/static/mermaid/53381ce57a40fa2d.dark.svg delete mode 100644 docs/static/mermaid/53381ce57a40fa2d.light.svg delete mode 100644 docs/static/mermaid/5968b52d0c6e020d.dark.svg delete mode 100644 docs/static/mermaid/5968b52d0c6e020d.light.svg delete mode 100644 docs/static/mermaid/5cd6cf2e8cb9f239.dark.svg delete mode 100644 docs/static/mermaid/5cd6cf2e8cb9f239.light.svg delete mode 100644 docs/static/mermaid/6246257eb1ed66f2.dark.svg delete mode 100644 docs/static/mermaid/6246257eb1ed66f2.light.svg delete mode 100644 docs/static/mermaid/6a6ea3139e594005.dark.svg delete mode 100644 docs/static/mermaid/6a6ea3139e594005.light.svg delete mode 100644 docs/static/mermaid/6b3b207bb2aff734.dark.svg delete mode 100644 docs/static/mermaid/6b3b207bb2aff734.light.svg delete mode 100644 docs/static/mermaid/6cdd6464bbfb3830.dark.svg delete mode 100644 docs/static/mermaid/6cdd6464bbfb3830.light.svg delete mode 100644 docs/static/mermaid/6fa8ed6a705962cd.dark.svg delete mode 100644 docs/static/mermaid/6fa8ed6a705962cd.light.svg delete mode 100644 docs/static/mermaid/7109580d1f77ebfc.dark.svg delete mode 100644 docs/static/mermaid/7109580d1f77ebfc.light.svg delete mode 100644 docs/static/mermaid/760030f7572a6f27.dark.svg delete mode 100644 docs/static/mermaid/760030f7572a6f27.light.svg delete mode 100644 docs/static/mermaid/7b45b30fac58fcf1.dark.svg delete mode 100644 docs/static/mermaid/7b45b30fac58fcf1.light.svg delete mode 100644 docs/static/mermaid/7cbc7eb0aad8c11b.dark.svg delete mode 100644 docs/static/mermaid/7cbc7eb0aad8c11b.light.svg delete mode 100644 docs/static/mermaid/7ff3e2ed31e8415f.dark.svg delete mode 100644 docs/static/mermaid/7ff3e2ed31e8415f.light.svg delete mode 100644 docs/static/mermaid/813af8a6e20c87ca.dark.svg delete mode 100644 docs/static/mermaid/813af8a6e20c87ca.light.svg delete mode 100644 docs/static/mermaid/8344e7078a03df0d.dark.svg delete mode 100644 docs/static/mermaid/8344e7078a03df0d.light.svg delete mode 100644 docs/static/mermaid/83fa0e9e559b8ea2.dark.svg delete mode 100644 docs/static/mermaid/83fa0e9e559b8ea2.light.svg delete mode 100644 docs/static/mermaid/852eba31132f70ba.dark.svg delete mode 100644 docs/static/mermaid/852eba31132f70ba.light.svg delete mode 100644 docs/static/mermaid/88f38ec5e2bf4512.dark.svg delete mode 100644 docs/static/mermaid/88f38ec5e2bf4512.light.svg delete mode 100644 docs/static/mermaid/8a9b79cb83661ebe.dark.svg delete mode 100644 docs/static/mermaid/8a9b79cb83661ebe.light.svg delete mode 100644 docs/static/mermaid/9a730e3846503302.dark.svg delete mode 100644 docs/static/mermaid/9a730e3846503302.light.svg delete mode 100644 docs/static/mermaid/9d16c09133c9e02b.dark.svg delete mode 100644 docs/static/mermaid/9d16c09133c9e02b.light.svg delete mode 100644 docs/static/mermaid/9d1da9da1f786fc7.dark.svg delete mode 100644 docs/static/mermaid/9d1da9da1f786fc7.light.svg delete mode 100644 docs/static/mermaid/9d97c50127e4ff52.dark.svg delete mode 100644 docs/static/mermaid/9d97c50127e4ff52.light.svg delete mode 100644 docs/static/mermaid/9df2eaa43052bdf9.dark.svg delete mode 100644 docs/static/mermaid/9df2eaa43052bdf9.light.svg delete mode 100644 docs/static/mermaid/a3553a40a5e0cef2.dark.svg delete mode 100644 docs/static/mermaid/a3553a40a5e0cef2.light.svg delete mode 100644 docs/static/mermaid/a82ad6d1de57acb9.dark.svg delete mode 100644 docs/static/mermaid/a82ad6d1de57acb9.light.svg delete mode 100644 docs/static/mermaid/a91d9bc3493e7f5a.dark.svg delete mode 100644 docs/static/mermaid/a91d9bc3493e7f5a.light.svg delete mode 100644 docs/static/mermaid/ab48cd9eb15944b2.dark.svg delete mode 100644 docs/static/mermaid/ab48cd9eb15944b2.light.svg delete mode 100644 docs/static/mermaid/ac41416d7498f164.dark.svg delete mode 100644 docs/static/mermaid/ac41416d7498f164.light.svg delete mode 100644 docs/static/mermaid/add665e10c0bdbf5.dark.svg delete mode 100644 docs/static/mermaid/add665e10c0bdbf5.light.svg delete mode 100644 docs/static/mermaid/b985fd791fbcb213.dark.svg delete mode 100644 docs/static/mermaid/b985fd791fbcb213.light.svg delete mode 100644 docs/static/mermaid/bbea2c23ef5c7672.dark.svg delete mode 100644 docs/static/mermaid/bbea2c23ef5c7672.light.svg delete mode 100644 docs/static/mermaid/bc65d25db4e24586.dark.svg delete mode 100644 docs/static/mermaid/bc65d25db4e24586.light.svg delete mode 100644 docs/static/mermaid/beaf633e2a40766b.dark.svg delete mode 100644 docs/static/mermaid/beaf633e2a40766b.light.svg delete mode 100644 docs/static/mermaid/c3da52705df75d92.dark.svg delete mode 100644 docs/static/mermaid/c3da52705df75d92.light.svg delete mode 100644 docs/static/mermaid/cfad987f3eb3f443.dark.svg delete mode 100644 docs/static/mermaid/cfad987f3eb3f443.light.svg delete mode 100644 docs/static/mermaid/d03a6dea7f89f987.dark.svg delete mode 100644 docs/static/mermaid/d03a6dea7f89f987.light.svg delete mode 100644 docs/static/mermaid/d24923eeabd17e96.dark.svg delete mode 100644 docs/static/mermaid/d24923eeabd17e96.light.svg delete mode 100644 docs/static/mermaid/d460de40c79a91ba.dark.svg delete mode 100644 docs/static/mermaid/d460de40c79a91ba.light.svg delete mode 100644 docs/static/mermaid/d7ebb8b48e29e83b.dark.svg delete mode 100644 docs/static/mermaid/d7ebb8b48e29e83b.light.svg delete mode 100644 docs/static/mermaid/d99a12c6ff5589fb.dark.svg delete mode 100644 docs/static/mermaid/d99a12c6ff5589fb.light.svg delete mode 100644 docs/static/mermaid/f676ffe4e91ae2bd.dark.svg delete mode 100644 docs/static/mermaid/f676ffe4e91ae2bd.light.svg delete mode 100644 docs/static/mermaid/f67a3e73ee3b214d.dark.svg delete mode 100644 docs/static/mermaid/f67a3e73ee3b214d.light.svg delete mode 100644 docs/static/mermaid/fe61fa5dc7c27657.dark.svg delete mode 100644 docs/static/mermaid/fe61fa5dc7c27657.light.svg delete mode 100644 docs/static/mermaid/fe7aff159efce728.dark.svg delete mode 100644 docs/static/mermaid/fe7aff159efce728.light.svg delete mode 100644 docs/static/mermaid/ff768c08ae1fcb6d.dark.svg delete mode 100644 docs/static/mermaid/ff768c08ae1fcb6d.light.svg delete mode 100644 governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md delete mode 100644 governance/03-distribution/sdk/METHOD-SDKR-01_RELEASE_PIPELINE.md delete mode 100644 governance/03-distribution/sdk/METHOD-SDKR-05_RELEASE_MANIFEST.md delete mode 100644 governance/03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md delete mode 100644 governance/03-distribution/sdk/METHOD-SDKR-09_RELEASE_READINESS.md delete mode 100644 governance/03-distribution/sdk/MPLP-MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0.md delete mode 100644 governance/03-distribution/sdk/MPLP-PROTOCOL-v1.0.0-PUBLICATION-CLOSURE-RECORD-2026-04-06.md delete mode 100644 governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-BRANCH-SEAL-2026-04-06.md delete mode 100644 governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-VERIFICATION-SUBSTRATE-ADJUDICATION-v0.1.md delete mode 100644 governance/03-distribution/sdk/MPLP-PUBLIC-PROTOCOL-TAG-ALIGNMENT-ADJUDICATION-v0.1.md delete mode 100644 governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-2026-04-05-public-oss-01.md delete mode 100644 governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-TEMPLATE-v1.0.md delete mode 100644 governance/03-distribution/sdk/MPLP-RELEASE-READINESS-BASELINE-v1.0.md delete mode 100644 governance/03-distribution/sdk/MPLP-v1.0.0-APRIL-CROSS-REPO-PRESERVATION-CLOSURE-RECORD-2026-04-07.md delete mode 100644 governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-06.md delete mode 100644 governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-07.md delete mode 100644 governance/03-distribution/sdk/templates/DEPENDENCY_CHECK_TEMPLATE.md delete mode 100644 governance/03-distribution/sdk/templates/DERIVATION_PROOF_TEMPLATE.yaml delete mode 100644 governance/03-distribution/sdk/templates/ISOLATED_VERIFICATION_REPORT_TEMPLATE.md delete mode 100644 governance/03-distribution/sdk/templates/RELEASE_BUNDLE_MANIFEST_TEMPLATE.json delete mode 100644 governance/03-distribution/sdk/templates/RELEASE_INTENT_TEMPLATE.md delete mode 100644 governance/03-distribution/sdk/templates/VERSION_CHANGE_JUSTIFICATION_TEMPLATE.md delete mode 100644 governance/04-records/AUDIT-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-SEAL.md delete mode 100644 governance/04-records/CONST-007-CROSS-SURFACE-CLOSURE-RECORD-2026-04-08.md delete mode 100644 governance/04-records/SEAL-SDKR-08-GOVERNANCE-v1.md delete mode 100644 governance/audits/MPLP-CANDIDATE-BACKLOG-REVIEW-INVENTORY-v0.1.md delete mode 100644 governance/audits/MPLP-DIRTY-WORKTREE-RECONCILIATION-AUDIT-v0.1.md delete mode 100644 governance/audits/MPLP-DIST-TARGET-REALITY-MATRIX-v0.1.md delete mode 100644 governance/audits/MPLP-DOWNSTREAM-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1.md delete mode 100644 governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-EXCEPTION-REGISTER-v0.1.md delete mode 100644 governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-INVENTORY-v0.1.md delete mode 100644 governance/audits/MPLP-MPGC-CANDIDATE-INTAKE-NON-PROMOTION-AUDIT-v0.1.md delete mode 100644 governance/audits/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-NON-PROMOTION-AUDIT-v0.1.md delete mode 100644 governance/audits/MPLP-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1.md delete mode 100644 governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md delete mode 100644 governance/backlog/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md delete mode 100644 governance/backlog/MPLP-CANDIDATE-BACKLOG-CONSOLIDATION-PLAN-v0.1.md delete mode 100644 governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md delete mode 100644 governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md delete mode 100644 governance/backlog/MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1.md delete mode 100644 governance/backlog/MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md delete mode 100644 governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md delete mode 100644 governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md delete mode 100644 governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md delete mode 100644 governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md delete mode 100644 governance/backlog/MPLP-DOWNSTREAM-REVIEW-LOOP-EVIDENCE-NO-CHANGE-AND-CANDIDATE-DECISION-v0.1.md delete mode 100644 governance/backlog/MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md delete mode 100644 governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md delete mode 100644 governance/backlog/MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md delete mode 100644 governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md delete mode 100644 governance/candidates/MPGC-CANDIDATE-BACKLOG-v0.1.md delete mode 100644 governance/codex-goals/CODEX-GOAL-TEMPLATE.md delete mode 100644 governance/gates/MPLP-CANDIDATE-BACKLOG-REVIEW-GATE-v0.1.md delete mode 100644 governance/gates/MPLP-CANDIDATE-CONSOLIDATION-GATE-v0.1.md delete mode 100644 governance/gates/MPLP-DOWNSTREAM-EVIDENCE-ANONYMITY-GATE-v0.1.md delete mode 100644 governance/gates/MPLP-MPGC-CANDIDATE-INTAKE-GATE-v0.1.md delete mode 100644 governance/gates/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-GATE-v0.1.md create mode 100644 governance/global-alignment-baseline.yaml create mode 100644 governance/global-alignment-current.yaml delete mode 100644 governance/mpgc-intake/MPLP-MPGC-CANDIDATE-DECISION-NEEDED-MATRIX-v0.1.md delete mode 100644 governance/mpgc-intake/MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md delete mode 100644 governance/mpgc-intake/MPLP-MPGC-INTAKE-EVIDENCE-VOCABULARY-CANDIDATE-v0.1.md delete mode 100644 governance/mpgc-intake/MPLP-MPGC-INTAKE-LIFECYCLE-GOVERNANCE-CANDIDATE-v0.1.md delete mode 100644 governance/mpgc-intake/MPLP-MPGC-INTAKE-STOP-ESCALATION-REVISION-CANDIDATE-v0.1.md delete mode 100644 governance/mpgc-review/MPLP-MPGC-CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1.md delete mode 100644 governance/mpgc-review/MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md delete mode 100644 governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md delete mode 100644 governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-INDEX-v0.1.md delete mode 100644 governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1.md delete mode 100644 governance/mpgc-review/MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md delete mode 100644 governance/records/REPO-TOPOLOGY-POINTER-MANIFEST-DECISION-2026-05-29.md delete mode 100644 governance/release/MPLP-RELEASE-SOP.md delete mode 100644 governance/releases/MPLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1.md delete mode 100644 governance/releases/MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD.md delete mode 100644 governance/research/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md delete mode 100644 governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md delete mode 100644 governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md delete mode 100644 packages/npm/compliance/CHANGELOG.md delete mode 100644 packages/npm/compliance/DERIVATION_PROOF.yaml delete mode 100644 packages/npm/compliance/LICENSE delete mode 100644 packages/npm/compliance/README.md delete mode 100644 packages/npm/compliance/dist/index.d.ts delete mode 100644 packages/npm/compliance/dist/index.js delete mode 100644 packages/npm/compliance/package.json delete mode 100644 packages/npm/compliance/tsconfig.json delete mode 100644 packages/npm/conformance/dist/index.d.ts delete mode 100644 packages/npm/conformance/dist/index.js delete mode 100644 packages/npm/conformance/package-lock.json delete mode 100644 packages/npm/coordination/dist/index.d.ts delete mode 100644 packages/npm/coordination/dist/index.js delete mode 100644 packages/npm/core/dist/index.d.ts delete mode 100644 packages/npm/core/dist/index.js delete mode 100644 packages/npm/devtools/dist/index.d.ts delete mode 100644 packages/npm/devtools/dist/index.js delete mode 100644 packages/npm/integration-llm-http/dist/index.d.ts delete mode 100644 packages/npm/integration-llm-http/dist/index.js delete mode 100644 packages/npm/integration-storage-fs/dist/index.d.ts delete mode 100644 packages/npm/integration-storage-fs/dist/index.js delete mode 100644 packages/npm/integration-storage-kv/dist/index.d.ts delete mode 100644 packages/npm/integration-storage-kv/dist/index.js delete mode 100644 packages/npm/integration-tools-generic/dist/index.d.ts delete mode 100644 packages/npm/integration-tools-generic/dist/index.js delete mode 100644 packages/npm/modules/dist/index.d.ts delete mode 100644 packages/npm/modules/dist/index.js delete mode 100644 packages/npm/runtime-minimal/dist/index.d.ts delete mode 100644 packages/npm/runtime-minimal/dist/index.js delete mode 100644 packages/npm/schema/dist/index.d.ts delete mode 100644 packages/npm/schema/dist/index.js delete mode 100644 packages/npm/schema/dist/kernel-duties.d.ts delete mode 100644 packages/npm/schema/dist/kernel-duties.js delete mode 100644 packages/npm/schema/schemas/profiles/map-profile.yaml delete mode 100644 packages/npm/schema/schemas/profiles/sa-profile.yaml delete mode 100644 packages/npm/schema/schemas/taxonomy/event-taxonomy.yaml delete mode 100644 packages/npm/schema/schemas/taxonomy/integration-event-taxonomy.yaml delete mode 100644 packages/npm/schema/schemas/taxonomy/learning-taxonomy.yaml delete mode 100644 packages/npm/schema/schemas/taxonomy/module-event-matrix.yaml delete mode 100644 packages/npm/sdk-ts/dist/index.d.ts delete mode 100644 packages/npm/sdk-ts/dist/index.js delete mode 100644 packages/npm/sdk-ts/dist/kernel-duties.d.ts delete mode 100644 packages/npm/sdk-ts/dist/kernel-duties.js delete mode 100644 packages/npm/sdk-ts/schemas/profiles/map-profile.yaml delete mode 100644 packages/npm/sdk-ts/schemas/profiles/sa-profile.yaml delete mode 100644 packages/npm/sdk-ts/schemas/taxonomy/event-taxonomy.yaml delete mode 100644 packages/npm/sdk-ts/schemas/taxonomy/integration-event-taxonomy.yaml delete mode 100644 packages/npm/sdk-ts/schemas/taxonomy/learning-taxonomy.yaml delete mode 100644 packages/npm/sdk-ts/schemas/taxonomy/module-event-matrix.yaml delete mode 100644 packages/npm/validator/LICENSE.txt delete mode 100644 packages/npm/validator/README.md delete mode 100644 packages/npm/validator/bin/mplp.js delete mode 100644 packages/npm/validator/package.json delete mode 100644 packages/npm/validator/schemas/events/mplp-map-event.schema.json delete mode 100644 packages/npm/validator/schemas/events/mplp-sa-event.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-collab.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-confirm.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-context.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-core.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-dialog.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-extension.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-network.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-plan.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-role.schema.json delete mode 100644 packages/npm/validator/schemas/mplp-trace.schema.json delete mode 100644 packages/pypi/mplp-sdk/LICENSE delete mode 100644 packages/pypi/mplp-sdk/dist/mplp_sdk-1.0.5-py3-none-any.whl delete mode 100644 packages/pypi/mplp-sdk/dist/mplp_sdk-1.0.5.tar.gz delete mode 100644 packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/PKG-INFO delete mode 100644 packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/SOURCES.txt delete mode 100644 packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/dependency_links.txt delete mode 100644 packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/top_level.txt delete mode 100644 packages/sources/sdk-py/src/mplp_sdk.egg-info/PKG-INFO delete mode 100644 packages/sources/sdk-py/src/mplp_sdk.egg-info/SOURCES.txt delete mode 100644 packages/sources/sdk-py/src/mplp_sdk.egg-info/dependency_links.txt delete mode 100644 packages/sources/sdk-py/src/mplp_sdk.egg-info/requires.txt delete mode 100644 packages/sources/sdk-py/src/mplp_sdk.egg-info/top_level.txt create mode 100644 packages/sources/sdk-ts/scripts/verify-dist-surface.mjs delete mode 100644 packages/sources/validator/LICENSE.txt delete mode 100644 packages/sources/validator/README.md delete mode 100644 packages/sources/validator/package.json delete mode 100644 packages/sources/validator/scripts/sync-schemas.mjs delete mode 100644 packages/sources/validator/src/cli.ts delete mode 100644 packages/sources/validator/src/commands/validate.ts delete mode 100644 packages/sources/validator/src/commands/version.ts delete mode 100644 packages/sources/validator/src/engine/flow01.ts delete mode 100644 packages/sources/validator/src/engine/schema.ts delete mode 100644 packages/sources/validator/src/index.ts delete mode 100644 packages/sources/validator/tsconfig.json delete mode 100644 release-manifests/mplp-public-manifest.example.json delete mode 100644 release-manifests/mplp-public-manifest.schema.json delete mode 100644 scripts/03-docs/semantic/mapping-health.mjs delete mode 100644 scripts/03-docs/semantic/semantic-lint.mjs delete mode 100644 scripts/03-docs/verify-governance-styling.mjs delete mode 100644 scripts/04-build/pre-release-check.mjs delete mode 100644 scripts/04-build/root-verification.mjs delete mode 100644 scripts/04-build/update-frozen-headers.mjs delete mode 100755 scripts/codex/repo-truth-first.sh delete mode 100644 scripts/packages/validate-public-npm-package.mjs delete mode 100644 scripts/semantic/gate-publish-set.mjs delete mode 100644 scripts/semantic/gate_pypi_set/__init__.py delete mode 100644 scripts/semantic/gate_pypi_set/checks.py delete mode 100644 scripts/semantic/gate_pypi_set/loader.py delete mode 100644 scripts/semantic/gate_pypi_set/main.py delete mode 100644 scripts/semantic/gate_pypi_set/model.py delete mode 100644 scripts/semantic/gate_pypi_set/report.py delete mode 100644 scripts/semantic/validate-public-manifest.mjs diff --git a/.agents/skills/cross-repo-boundary-guard/SKILL.md b/.agents/skills/cross-repo-boundary-guard/SKILL.md deleted file mode 100644 index bef500a7e..000000000 --- a/.agents/skills/cross-repo-boundary-guard/SKILL.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -name: cross-repo-boundary-guard -description: Use when a task touches MPLP, Cognitive OS, SoloCrew, Validation Lab, website, docs, runtime, protocol, evidence, publication, or brand surfaces. Prevents boundary drift. ---- - -# Cross-Repo Boundary Guard - -## Authority Map - -MPLP owns: - -- protocol objects -- schemas -- invariants -- conformance vocabulary -- protocol docs - -Cognitive OS owns: - -- runtime substrate -- execution semantics -- DTOs -- evidence pipeline -- protocol bindings - -SoloCrew owns: - -- product UX -- founder console -- secretary/cell interaction -- projection-safe workflow views - -Validation Lab owns: - -- evidence packs -- deterministic adjudication -- pointer resolution -- failure cases -- public validation UI - -JearonWong.com owns: - -- articles -- essays -- white papers -- brand narrative -- publication pages -- social distribution assets - -## Required Boundary Check - -Before implementation, classify every changed file: - -```yaml -boundary_check: - file: - repo_layer: - allowed_semantics: - forbidden_semantics: - risk: -``` - -## Forbidden Drift - -- MPLP must not contain product UI language. -- SoloCrew must not claim protocol authority. -- Cognitive OS must not redefine MPLP semantics. -- Validation Lab must not become certification authority. -- Website must not claim regulator approval or official standard status. diff --git a/.agents/skills/docs-minimalism-governance/SKILL.md b/.agents/skills/docs-minimalism-governance/SKILL.md deleted file mode 100644 index 30f4b2036..000000000 --- a/.agents/skills/docs-minimalism-governance/SKILL.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -name: docs-minimalism-governance -description: Use when creating, editing, or reviewing governance docs, release records, audit records, baselines, checklists, README files, or protocol documentation. Prevents document sprawl. ---- - -# Documentation Minimalism Governance - -## Rule - -Do not create new governance documents unless existing documents cannot be reused. - -## Required Before New Docs - -Codex must report: - -```yaml -doc_reuse_check: - existing_candidate_docs: - can_update_existing: - why_not_reuse: - new_doc_needed: - proposed_doc_path: - document_budget_impact: -``` - -## Preferred Actions - -1. Update existing baseline. -2. Append to existing audit record. -3. Add one index entry. -4. Only then create a new document. - -## Forbidden - -- Duplicate release records. -- Duplicate governance baselines. -- New checklist if an existing checklist can be extended. -- Marketing language in protocol docs. -- Certification, official standard, regulator approval, or vendor ranking claims. diff --git a/.agents/skills/mplp-schema-v2-invariant-intake/SKILL.md b/.agents/skills/mplp-schema-v2-invariant-intake/SKILL.md deleted file mode 100644 index 563044c69..000000000 --- a/.agents/skills/mplp-schema-v2-invariant-intake/SKILL.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -name: mplp-schema-v2-invariant-intake -description: Use for MPLP schemas/v2 primitive intake, invariants, negative fixtures, object schemas, profiles, conformance manifests, and validator gates. ---- - -# MPLP Schema v2 Invariant Intake - -This skill governs schemas/v2 work. - -## Hard Order - -Codex must follow this order: - -1. Inspect existing schemas/v2 assets. -2. Inspect existing validators and fixtures. -3. Define or update invariants. -4. Add negative fixtures bound to invariant IDs. -5. Add kernel object schemas. -6. Add positive fixtures. -7. Add validator tests. -8. Update conformance manifest or inventory. -9. Update governance record only if necessary. - -## Required Principle - -Invariant -> Negative Fixture -> Object Schema -> Positive Fixture -> Validator -> Governance Record - -## v1.0 Frozen Boundary - -v1.0 module schemas may reference v2 objects only through pointer-only refs. - -Allowed: - -```yaml -active_context_version_ref: - ref_id: "ctxv-..." - ref_type: "ActiveContextVersion" - protocol_version: "2.0.0" - schema_version: "2.x" - profile_marker: "required" -``` - -Forbidden: - -```yaml -active_context_version: - context_id: "..." - validity_state: "active" - superseded_by: "..." -``` - -## Forbidden Imports Into Protocol Core - -Do not add these to MPLP protocol core: - -- RCCS-M -- ALCS -- AARM -- audit score -- insurance score -- procurement score -- certification -- legal compliance proof -- regulator approval -- vendor ranking -- SoloCrew UI objects -- Cognitive OS runtime internals -- Coregentis commercial validation service language - -## Required Output - -For every schema primitive, report: - -```yaml -primitive: - name: - module_mapping: - invariant_mapping: - positive_fixture: - negative_fixture: - validator_rule: - conformance_profile: - v1_pointer_refs_if_any: - files_changed: -``` diff --git a/.agents/skills/release-gate-and-seal-discipline/SKILL.md b/.agents/skills/release-gate-and-seal-discipline/SKILL.md deleted file mode 100644 index d95b12d28..000000000 --- a/.agents/skills/release-gate-and-seal-discipline/SKILL.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -name: release-gate-and-seal-discipline -description: Use before declaring any task, PR, release, RC, seal, deployment, or merge complete. Requires commands run, pass/fail evidence, remote truth, and remaining risk. ---- - -# Release Gate and Seal Discipline - -Codex must not declare completion without verification. - -## Required Report - -```yaml -completion_report: - branch: - starting_head: - final_head: - files_changed: - commands_run: - pass_fail_results: - tests_added_or_updated: - governance_records_changed: - remote_truth_checked: - final_git_status: - remaining_risks: - exact_verdict: -``` - -## Common Checks - -Use repo-specific commands if available. Otherwise inspect package scripts first: - -```bash -cat package.json | sed -n '1,160p' -``` - -Then run available gates: - -```bash -git diff --check -pnpm run build -pnpm run lint -pnpm run test -``` - -If commands differ, explain why. - -## Forbidden - -- Do not say "done" without command output summary. -- Do not tag release without owner approval. -- Do not create seal record without owner approval. -- Do not claim live deployment unless repo truth, build truth, remote truth, and live truth are checked. diff --git a/.agents/skills/repo-truth-first-audit/SKILL.md b/.agents/skills/repo-truth-first-audit/SKILL.md deleted file mode 100644 index 8fc00ba0d..000000000 --- a/.agents/skills/repo-truth-first-audit/SKILL.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -name: repo-truth-first-audit -description: Use before any implementation, refactor, release, schema, docs, or governance task. Inspect branch, HEAD, remote, dirty status, existing files, reusable assets, and why new files are needed. ---- - -# Repo Truth First Audit - -Before making changes, Codex must inspect repository truth. - -## Required Commands - -Run or equivalent: - -```bash -git branch --show-current -git status --short -git rev-parse HEAD -git rev-parse --verify origin/main || true -git log --oneline -5 -``` - -## Required Investigation - -Identify: - -- current branch -- current local HEAD -- remote HEAD if available -- dirty files -- relevant existing directories -- relevant existing tests -- reusable assets -- missing assets -- why new files are necessary - -## Output Format - -Before implementation, report: - -```yaml -repo_truth: - branch: - local_head: - origin_main_head: - dirty_status: - relevant_existing_files: - reusable_assets: - missing_assets: - why_new_files_needed: - proposed_change_surface: -``` - -## Rules - -- Do not create new files before this audit. -- Do not rewrite existing architecture without explaining why extension is insufficient. -- Prefer update over new document. diff --git a/.codex/agents/package_surface_auditor.toml b/.codex/agents/package_surface_auditor.toml deleted file mode 100644 index c2c8a9ecc..000000000 --- a/.codex/agents/package_surface_auditor.toml +++ /dev/null @@ -1,27 +0,0 @@ -name = "package_surface_auditor" -description = "Audits npm/PyPI package publication surfaces, package metadata, README footers, LICENSE/NOTICE files, owner statements, and registry-readiness blockers." -model_reasoning_effort = "high" -sandbox_mode = "workspace-write" - -developer_instructions = """ -You are a package publication surface auditor. - -Inspect package-facing files only: -- packages/npm/** -- packages/pypi/** -- package.json -- README.md -- LICENSE -- NOTICE -- governance/release/** when package release readiness is relevant - -You must not publish, upload, deprecate, yank, tag, or bump versions. - -Return: -- files inspected -- exact problematic strings -- active publication surface vs historical record classification -- recommended replacement -- post-edit verification command -- blocker verdict -""" diff --git a/.codex/agents/product_boundary_reviewer.toml b/.codex/agents/product_boundary_reviewer.toml deleted file mode 100644 index 3e023f143..000000000 --- a/.codex/agents/product_boundary_reviewer.toml +++ /dev/null @@ -1,28 +0,0 @@ -name = "product_boundary_reviewer" -description = "Reviews SoloCrew product UX changes for user-facing clarity and prevents protocol/runtime jargon leaking into founder-facing UI." -model_reasoning_effort = "high" -sandbox_mode = "workspace-write" - -developer_instructions = """ -You are a SoloCrew product boundary reviewer. - -User-facing UI should express: -- what needs your decision -- company status -- secretary brief -- continue from here -- evidence behind this -- system details only when necessary - -Block: -- internal protocol jargon as primary UI copy -- direct approve/reject/dispatch/execute unless explicitly scoped -- runtime authority in product UI -- provider/channel send behavior unless explicitly authorized - -Return: -- UI files inspected -- copy issues -- authority boundary risks -- recommended user-facing wording -""" diff --git a/.codex/agents/protocol_schema_reviewer.toml b/.codex/agents/protocol_schema_reviewer.toml deleted file mode 100644 index dd80d0e32..000000000 --- a/.codex/agents/protocol_schema_reviewer.toml +++ /dev/null @@ -1,25 +0,0 @@ -name = "protocol_schema_reviewer" -description = "Reviews MPLP schemas/v2 invariants, negative fixtures, object schemas, conformance profiles, and v1 pointer-only refs." -model_reasoning_effort = "xhigh" -sandbox_mode = "workspace-write" - -developer_instructions = """ -You are an MPLP protocol schema reviewer. - -Rules: -- invariant-first -- negative fixture second -- object schema third -- positive fixture fourth -- validator/conformance last -- v1 module refs must be pointer-only -- no RCCS-M, ALCS, AARM, certification, vendor ranking, product UI, runtime-private, or commercial validation service language in protocol core - -Return: -- schema files inspected -- invariant mapping -- fixture mapping -- missing negative tests -- v1/v2 boundary risks -- blocking findings -""" diff --git a/.codex/agents/publication_claim_reviewer.toml b/.codex/agents/publication_claim_reviewer.toml deleted file mode 100644 index 24bbbf07a..000000000 --- a/.codex/agents/publication_claim_reviewer.toml +++ /dev/null @@ -1,26 +0,0 @@ -name = "publication_claim_reviewer" -description = "Reviews website, white paper, docs, metadata, and public writing surfaces for claim-boundary discipline." -model_reasoning_effort = "high" -sandbox_mode = "workspace-write" - -developer_instructions = """ -You are a public publication and claim-boundary reviewer. - -Review for: -- no certification claim -- no regulator approval claim -- no legal compliance proof claim -- no vendor ranking claim -- no unsupported world-first claim -- citation metadata consistency -- canonical URL consistency -- publication boundary language -- visible copy vs metadata consistency - -Return: -- files inspected -- unsafe claims found -- required boundary corrections -- metadata/canonical issues -- blocking findings -""" diff --git a/.codex/agents/release_governance_reviewer.toml b/.codex/agents/release_governance_reviewer.toml deleted file mode 100644 index 89be2f163..000000000 --- a/.codex/agents/release_governance_reviewer.toml +++ /dev/null @@ -1,24 +0,0 @@ -name = "release_governance_reviewer" -description = "Reviews release plans, owner approval records, seal boundaries, registry conflict status, and forbidden release mutations." -model_reasoning_effort = "high" -sandbox_mode = "workspace-write" - -developer_instructions = """ -You are a release governance reviewer. - -Your job is to prevent unsafe release readiness claims. - -Block if: -- exact package versions already exist in registry -- owner/copyright statements are unresolved -- publish/upload/deprecate/yank/tag actions are implied without owner approval -- final verdict uses READY_TO_PUBLISH prematurely -- release/seal claims are made without owner approval - -Return: -- release document reviewed -- unsafe language found -- required corrected verdict -- owner approval boundary -- no-mutation confirmation -""" diff --git a/.codex/agents/runtime_binding_reviewer.toml b/.codex/agents/runtime_binding_reviewer.toml deleted file mode 100644 index b13c8c92f..000000000 --- a/.codex/agents/runtime_binding_reviewer.toml +++ /dev/null @@ -1,21 +0,0 @@ -name = "runtime_binding_reviewer" -description = "Reviews Cognitive OS runtime binding changes for public/private boundary, DTO exposure, and MPLP semantic alignment." -model_reasoning_effort = "high" -sandbox_mode = "workspace-write" - -developer_instructions = """ -You are a Cognitive OS runtime binding reviewer. - -Rules: -- public DTOs may expose projection-safe lifecycle summaries -- runtime-private internals must not leak into public DTOs or SoloCrew -- Cognitive OS may bind to MPLP semantics but must not redefine MPLP protocol authority -- runtime implementation details must not become MPLP protocol claims - -Return: -- files inspected -- public/private boundary risks -- DTO exposure issues -- MPLP binding alignment -- blocking findings -""" diff --git a/.codex/config.toml b/.codex/config.toml deleted file mode 100644 index ec0d2986c..000000000 --- a/.codex/config.toml +++ /dev/null @@ -1,16 +0,0 @@ -# Codex operating foundation for this repository. -# This repository uses Codex through an API-key connected IDE workflow, -# so local repo configuration must not assume app-only/cloud-only features. -# Repository-scoped skills are mirrored under .agents/skills for Codex -# discovery. .codex/skills is retained as the project-internal ops source. - -approval_policy = "on-request" -sandbox_mode = "workspace-write" - -[features] -goals = true - -# Subagent policy guidance, not enforced by this config parser: -# max_threads = 4 -# max_depth = 1 -# job_max_runtime_seconds = 1800 diff --git a/.codex/skills/cross-repo-boundary-guard/SKILL.md b/.codex/skills/cross-repo-boundary-guard/SKILL.md deleted file mode 100644 index bef500a7e..000000000 --- a/.codex/skills/cross-repo-boundary-guard/SKILL.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -name: cross-repo-boundary-guard -description: Use when a task touches MPLP, Cognitive OS, SoloCrew, Validation Lab, website, docs, runtime, protocol, evidence, publication, or brand surfaces. Prevents boundary drift. ---- - -# Cross-Repo Boundary Guard - -## Authority Map - -MPLP owns: - -- protocol objects -- schemas -- invariants -- conformance vocabulary -- protocol docs - -Cognitive OS owns: - -- runtime substrate -- execution semantics -- DTOs -- evidence pipeline -- protocol bindings - -SoloCrew owns: - -- product UX -- founder console -- secretary/cell interaction -- projection-safe workflow views - -Validation Lab owns: - -- evidence packs -- deterministic adjudication -- pointer resolution -- failure cases -- public validation UI - -JearonWong.com owns: - -- articles -- essays -- white papers -- brand narrative -- publication pages -- social distribution assets - -## Required Boundary Check - -Before implementation, classify every changed file: - -```yaml -boundary_check: - file: - repo_layer: - allowed_semantics: - forbidden_semantics: - risk: -``` - -## Forbidden Drift - -- MPLP must not contain product UI language. -- SoloCrew must not claim protocol authority. -- Cognitive OS must not redefine MPLP semantics. -- Validation Lab must not become certification authority. -- Website must not claim regulator approval or official standard status. diff --git a/.codex/skills/docs-minimalism-governance/SKILL.md b/.codex/skills/docs-minimalism-governance/SKILL.md deleted file mode 100644 index 30f4b2036..000000000 --- a/.codex/skills/docs-minimalism-governance/SKILL.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -name: docs-minimalism-governance -description: Use when creating, editing, or reviewing governance docs, release records, audit records, baselines, checklists, README files, or protocol documentation. Prevents document sprawl. ---- - -# Documentation Minimalism Governance - -## Rule - -Do not create new governance documents unless existing documents cannot be reused. - -## Required Before New Docs - -Codex must report: - -```yaml -doc_reuse_check: - existing_candidate_docs: - can_update_existing: - why_not_reuse: - new_doc_needed: - proposed_doc_path: - document_budget_impact: -``` - -## Preferred Actions - -1. Update existing baseline. -2. Append to existing audit record. -3. Add one index entry. -4. Only then create a new document. - -## Forbidden - -- Duplicate release records. -- Duplicate governance baselines. -- New checklist if an existing checklist can be extended. -- Marketing language in protocol docs. -- Certification, official standard, regulator approval, or vendor ranking claims. diff --git a/.codex/skills/mplp-schema-v2-invariant-intake/SKILL.md b/.codex/skills/mplp-schema-v2-invariant-intake/SKILL.md deleted file mode 100644 index 563044c69..000000000 --- a/.codex/skills/mplp-schema-v2-invariant-intake/SKILL.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -name: mplp-schema-v2-invariant-intake -description: Use for MPLP schemas/v2 primitive intake, invariants, negative fixtures, object schemas, profiles, conformance manifests, and validator gates. ---- - -# MPLP Schema v2 Invariant Intake - -This skill governs schemas/v2 work. - -## Hard Order - -Codex must follow this order: - -1. Inspect existing schemas/v2 assets. -2. Inspect existing validators and fixtures. -3. Define or update invariants. -4. Add negative fixtures bound to invariant IDs. -5. Add kernel object schemas. -6. Add positive fixtures. -7. Add validator tests. -8. Update conformance manifest or inventory. -9. Update governance record only if necessary. - -## Required Principle - -Invariant -> Negative Fixture -> Object Schema -> Positive Fixture -> Validator -> Governance Record - -## v1.0 Frozen Boundary - -v1.0 module schemas may reference v2 objects only through pointer-only refs. - -Allowed: - -```yaml -active_context_version_ref: - ref_id: "ctxv-..." - ref_type: "ActiveContextVersion" - protocol_version: "2.0.0" - schema_version: "2.x" - profile_marker: "required" -``` - -Forbidden: - -```yaml -active_context_version: - context_id: "..." - validity_state: "active" - superseded_by: "..." -``` - -## Forbidden Imports Into Protocol Core - -Do not add these to MPLP protocol core: - -- RCCS-M -- ALCS -- AARM -- audit score -- insurance score -- procurement score -- certification -- legal compliance proof -- regulator approval -- vendor ranking -- SoloCrew UI objects -- Cognitive OS runtime internals -- Coregentis commercial validation service language - -## Required Output - -For every schema primitive, report: - -```yaml -primitive: - name: - module_mapping: - invariant_mapping: - positive_fixture: - negative_fixture: - validator_rule: - conformance_profile: - v1_pointer_refs_if_any: - files_changed: -``` diff --git a/.codex/skills/release-gate-and-seal-discipline/SKILL.md b/.codex/skills/release-gate-and-seal-discipline/SKILL.md deleted file mode 100644 index d95b12d28..000000000 --- a/.codex/skills/release-gate-and-seal-discipline/SKILL.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -name: release-gate-and-seal-discipline -description: Use before declaring any task, PR, release, RC, seal, deployment, or merge complete. Requires commands run, pass/fail evidence, remote truth, and remaining risk. ---- - -# Release Gate and Seal Discipline - -Codex must not declare completion without verification. - -## Required Report - -```yaml -completion_report: - branch: - starting_head: - final_head: - files_changed: - commands_run: - pass_fail_results: - tests_added_or_updated: - governance_records_changed: - remote_truth_checked: - final_git_status: - remaining_risks: - exact_verdict: -``` - -## Common Checks - -Use repo-specific commands if available. Otherwise inspect package scripts first: - -```bash -cat package.json | sed -n '1,160p' -``` - -Then run available gates: - -```bash -git diff --check -pnpm run build -pnpm run lint -pnpm run test -``` - -If commands differ, explain why. - -## Forbidden - -- Do not say "done" without command output summary. -- Do not tag release without owner approval. -- Do not create seal record without owner approval. -- Do not claim live deployment unless repo truth, build truth, remote truth, and live truth are checked. diff --git a/.codex/skills/repo-truth-first-audit/SKILL.md b/.codex/skills/repo-truth-first-audit/SKILL.md deleted file mode 100644 index 8fc00ba0d..000000000 --- a/.codex/skills/repo-truth-first-audit/SKILL.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -name: repo-truth-first-audit -description: Use before any implementation, refactor, release, schema, docs, or governance task. Inspect branch, HEAD, remote, dirty status, existing files, reusable assets, and why new files are needed. ---- - -# Repo Truth First Audit - -Before making changes, Codex must inspect repository truth. - -## Required Commands - -Run or equivalent: - -```bash -git branch --show-current -git status --short -git rev-parse HEAD -git rev-parse --verify origin/main || true -git log --oneline -5 -``` - -## Required Investigation - -Identify: - -- current branch -- current local HEAD -- remote HEAD if available -- dirty files -- relevant existing directories -- relevant existing tests -- reusable assets -- missing assets -- why new files are necessary - -## Output Format - -Before implementation, report: - -```yaml -repo_truth: - branch: - local_head: - origin_main_head: - dirty_status: - relevant_existing_files: - reusable_assets: - missing_assets: - why_new_files_needed: - proposed_change_surface: -``` - -## Rules - -- Do not create new files before this audit. -- Do not rewrite existing architecture without explaining why extension is insufficient. -- Prefer update over new document. diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 000000000..dcd1cf154 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,9 @@ +root = false + +[*] +charset = utf-8 +end_of_line = lf +indent_style = space +indent_size = 2 +insert_final_newline = true +trim_trailing_whitespace = true diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index 00083a5d6..4bd4106f9 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -12,6 +12,7 @@ on: jobs: analyze: name: Analyze (${{ matrix.language }}) + if: ${{ !github.event.repository.private || vars.CODEQL_PRIVATE_ENABLED == 'true' }} runs-on: ubuntu-latest permissions: security-events: write diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml index b09a68f24..8f5ed4d0d 100644 --- a/.github/workflows/deploy-docs.yml +++ b/.github/workflows/deploy-docs.yml @@ -3,8 +3,6 @@ name: Deploy Docusaurus to GitHub Pages on: push: branches: ["main"] - pull_request: - branches: ["main"] workflow_dispatch: permissions: @@ -16,9 +14,6 @@ concurrency: group: "pages" cancel-in-progress: false -env: - FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true" - jobs: build: name: Build Docusaurus @@ -28,12 +23,12 @@ jobs: working-directory: ./docs steps: - name: Checkout - uses: actions/checkout@v5 + uses: actions/checkout@v4 with: fetch-depth: 0 - name: Setup Node.js - uses: actions/setup-node@v5 + uses: actions/setup-node@v4 with: node-version: 20 cache: npm @@ -42,99 +37,22 @@ jobs: - name: Install dependencies run: npm ci - - name: Normalize git context - run: | - git config --global --add safe.directory "$GITHUB_WORKSPACE" - git -C "$GITHUB_WORKSPACE" fetch --force --tags origin - - - name: Prepare git trace shim - run: | - trace_bin="$RUNNER_TEMP/docs-git-trace-bin" - trace_file="$GITHUB_WORKSPACE/docs-git-trace.log" - real_git="$(command -v git)" - - mkdir -p "$trace_bin" - : > "$trace_file" - - cat > "$trace_bin/git" </dev/null || true - } >> "$trace_file" - "$real_git" "\$@" - status=\$? - echo "[\$stamp] EXIT: \$status" >> "$trace_file" - echo "---" >> "$trace_file" - exit \$status - EOF - - chmod +x "$trace_bin/git" - echo "DOCS_GIT_TRACE_BIN=$trace_bin" >> "$GITHUB_ENV" - echo "DOCS_GIT_TRACE_FILE=$trace_file" >> "$GITHUB_ENV" - echo "DOCS_REAL_GIT=$real_git" >> "$GITHUB_ENV" - - name: Build Docusaurus - run: | - PATH="$DOCS_GIT_TRACE_BIN:$PATH" REAL_GIT="$DOCS_REAL_GIT" GIT_TRACE_CAPTURE="$DOCS_GIT_TRACE_FILE" npm run build + run: npm run build env: NODE_OPTIONS: --max-old-space-size=4096 - - name: Print git trace summary - if: always() - run: | - if [ -s "$DOCS_GIT_TRACE_FILE" ]; then - echo "::group::docs-git-trace" - cat "$DOCS_GIT_TRACE_FILE" - echo "::endgroup::" - python3 - <<'PY' - import os - from pathlib import Path - - trace_path = Path(os.environ["DOCS_GIT_TRACE_FILE"]) - content = trace_path.read_text().split('---\n') - - def esc(value: str) -> str: - return value.replace('%', '%25').replace('\r', '%0D').replace('\n', '%0A') - - for block in content: - block = [line for line in block.strip().splitlines() if line.strip()] - if not block: - continue - cmd = next((line.split('CMD: ', 1)[1] for line in block if 'CMD: ' in line), 'UNKNOWN') - pwd = next((line.split('PWD: ', 1)[1] for line in block if 'PWD: ' in line), 'UNKNOWN') - exit_code = next((line.split('EXIT: ', 1)[1] for line in block if 'EXIT: ' in line), 'UNKNOWN') - parent_index = next((i for i, line in enumerate(block) if 'PARENT_PID: ' in line), None) - parent = block[parent_index + 1].strip() if parent_index is not None and parent_index + 1 < len(block) else 'UNKNOWN' - message = esc(f"{cmd} | cwd={pwd} | exit={exit_code} | parent={parent}") - if exit_code != '0': - print(f"::warning title=docs-git-trace::{message}") - else: - print(f"::notice title=docs-git-trace::{message}") - PY - else - echo "::group::docs-git-trace" - echo "NO_GIT_TRACE_RECORDED" - echo "::endgroup::" - echo "::notice title=docs-git-trace::NO_GIT_TRACE_RECORDED" - fi - - name: Create CNAME run: echo "docs.mplp.io" > build/CNAME - name: Upload artifact - uses: actions/upload-pages-artifact@v4 + uses: actions/upload-pages-artifact@v3 with: path: ./docs/build deploy: name: Deploy to GitHub Pages needs: build - if: github.event_name == 'push' permissions: pages: write id-token: write @@ -145,4 +63,4 @@ jobs: steps: - name: Deploy to GitHub Pages id: deployment - uses: actions/deploy-pages@v5 + uses: actions/deploy-pages@v4 diff --git a/.gitignore b/.gitignore deleted file mode 100644 index b8f9bf24d..000000000 --- a/.gitignore +++ /dev/null @@ -1 +0,0 @@ -.!* diff --git a/.gitmodules b/.gitmodules deleted file mode 100644 index 5483d117c..000000000 --- a/.gitmodules +++ /dev/null @@ -1,3 +0,0 @@ -[submodule "MPLP_website"] - path = MPLP_website - url = https://github.com/Coregentis/MPLP-Official-Website diff --git a/AGENTS.md b/AGENTS.md deleted file mode 100644 index 40348af1e..000000000 --- a/AGENTS.md +++ /dev/null @@ -1,84 +0,0 @@ -# Repository Operating Rules for Codex - -This repository is part of the Coregentis MPLP / Cognitive OS / SoloCrew / Validation Lab project family. Codex work here must preserve project boundaries and produce verifiable engineering evidence. - -## Repository Layer - -MPLP owns protocol objects, schemas, invariants, conformance vocabulary, and protocol documentation. The 10-module v1 baseline remains the protocol anchor. Protocol core must stay product-neutral, runtime-neutral, vendor-neutral, and free of product, commercial validation, certification, regulator-approval, legal-compliance proof, or vendor-ranking claims. v1 references to v2 objects must remain pointer-only; do not inline product, runtime, or commercial semantics into protocol core. - -## Repo Truth First - -Before implementation, inspect repository truth: - -- `git branch --show-current` -- `git status --short` -- `git rev-parse HEAD` -- `git rev-parse --verify origin/main || true` -- `git log --oneline -5` - -Reuse existing assets before creating new files. Prefer updating an existing rule, skill, script, audit, or governance record over creating a duplicate document. - -## Codex Skill Discovery - -- `.agents/skills/*/SKILL.md` is the repository-scoped Codex skill discovery path. -- `.codex/skills/*/SKILL.md` is retained as the project-internal ops source and compatibility copy. -- Keep mirrored skills same-named and content-equivalent; do not create divergent SOPs. - -## Hard Boundaries - -- Preserve protocol, runtime, product, validation, and publication boundaries. -- Normal task-authorized changes may modify files within the explicitly scoped repository layer, including low-risk code or docs that the current task asks for. -- Owner approval is required for high-risk or irreversible changes, including release mutation, registry mutation, public legal/compliance claims, package version changes, schema primitive intake, provider-send behavior, auth/payment/data-deletion flows, runtime authority changes, and merge/tag/seal actions. -- Forbidden without explicit owner approval: - - `npm publish` - - `npm deprecate` - - npm dist-tag add/remove - - PyPI upload - - PyPI yank/delete - - `git tag` - - release seal creation - - package version bump - - schema object intake - - external registry mutation -- Do not make public certification, regulator-approval, vendor-ranking, official-standard, or legal-compliance proof claims without owner approval. -- Do not over-block normal task-authorized development. - -## MPLP Schema v2 Discipline - -For MPLP `schemas/v2` work, use this order: - -1. Invariant first. -2. Negative fixture second. -3. Object schema third. -4. Positive fixture fourth. -5. Validator and conformance gates last. - -v1.0 module references to v2 objects must be pointer-only. Do not inline v2 object fields into v1 module schemas. - -## Boundary Language - -- No product, runtime, commercial, certification, legal-compliance, regulator-approval, or vendor-ranking language may leak into MPLP protocol core. -- No protocol authority may leak into product UI. -- Cognitive OS may bind to MPLP semantics but must not redefine MPLP protocol authority. -- Validation Lab may present deterministic evidence and adjudication but must not become a certification authority. -- SoloCrew UI must not expose internal protocol/runtime jargon as primary user-facing copy. - -## Standard Subagent Lanes - -Use `.codex/agents/*.toml` reviewers only when the parent task explicitly requests them. Relevant lanes include `package_surface_auditor`, `release_governance_reviewer`, `protocol_schema_reviewer`, `product_boundary_reviewer`, `runtime_binding_reviewer`, and `publication_claim_reviewer`. - -Default lane policy: use no subagent for trivial docs typos, one subagent for isolated repo-specific review, and multiple subagents for release, schema, runtime, publication, or cross-repo tasks. MPLP-Protocol defaults to `protocol_schema_reviewer`, with `release_governance_reviewer` and `package_surface_auditor` as secondary lanes when the task touches package surfaces, schema intake, conformance, or release planning. - -Subagents run review lanes only unless edits are explicitly authorized. They inherit sandbox and approval boundaries, must not publish, upload, tag, seal, bump versions, mutate registries, intake schema primitives, merge PRs, or change public claims, and must return P0/P1/P2 findings to the parent with files inspected and commands run. - -## Completion Discipline - -Do not declare completion without reporting: - -- files changed -- commands run -- pass/fail evidence -- final git status -- remaining risk - -If a verification command is unavailable or inappropriate, state why instead of silently skipping it. diff --git a/CHANGELOG.md b/CHANGELOG.md index b7a89b947..76b1dacc3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,217 +1,4 @@ -## [mpgc-candidate-backlog-registration-2026-05-05] - 2026-05-05 - -### MPGC Candidate Backlog Registration - -#### Added -- registered MPGC non-normative candidate backlog from SoloCrew/Cognitive_OS - downstream evidence - -#### Notes -- no schema/spec/core-law change -- no profile/binding implementation -- no conformance/certification/endorsement claim - ---- - -## [downstream-review-loop-no-change-candidate-2026-04-30] — 2026-04-30 - -### Downstream Review-Loop Evidence No-Change Decision - -#### Added -- recorded downstream review-loop evidence no-change/candidate decision; - non-normative, no schema/spec/core law change - -#### Notes -- no certification claim -- no endorsement claim -- no runtime endorsement -- no product endorsement - ---- - -## [root-verification-entry-2026-04-26] — 2026-04-26 - -### Root Verification Entry Maintenance - -#### Changed -- replaced empty root `npm test` / `npm run lint` echo scripts with a - dependency-free, read-only root verification gate under - `scripts/04-build/root-verification.mjs` - -#### Notes -- no schema change -- no protocol law change -- no MPGC acceptance or RFC decision -- no runtime endorsement -- no product endorsement -- no certification claim - ---- - -## [mpgc-candidate-review-preparation-2026-04-21] — 2026-04-21 - -### MPGC Candidate Review Preparation - -#### Added -- review preparation index under `governance/mpgc-review/` -- review agenda under `governance/mpgc-review/` -- evidence summary packet under `governance/mpgc-review/` -- review rubric under `governance/mpgc-review/` -- risk matrix under `governance/mpgc-review/` -- decision ballot template under `governance/mpgc-review/` -- non-promotion audit under `governance/audits/` -- review preparation gate under `governance/gates/` - -#### Notes -- no MPGC decision -- no RFC is opened in this wave -- no candidate is accepted in this wave -- no guide/profile/binding draft -- no schema change -- no protocol law change -- no certification claim - ---- - -## [mpgc-candidate-intake-2026-04-21] — 2026-04-21 - -### MPGC Candidate Intake Dossiers - -#### Added -- MPGC candidate intake index under `governance/mpgc-intake/` -- MPGC candidate intake dossiers for lifecycle governance, stop/escalation/revision posture, and evidence vocabulary consideration under `governance/mpgc-intake/` -- MPGC candidate decision-needed matrix under `governance/mpgc-intake/` -- MPGC candidate intake non-promotion audit under `governance/audits/` -- MPGC candidate intake gate under `governance/gates/` - -#### Notes -- added MPGC candidate intake dossiers for lifecycle governance, - stop/escalation/revision posture, and evidence vocabulary consideration as - pre-RFC, non-normative, not-accepted review materials only -- no schema change -- no protocol law change -- no normative promotion -- no guide/profile/binding draft -- no MPGC acceptance -- no certification claim - ---- - -## [candidate-consolidation-2026-04-21] — 2026-04-21 - -### Candidate Consolidation - -#### Added -- canonical candidate backlog index under `governance/backlog/` -- guide/profile/binding holding notes under `governance/backlog/` -- research archive / duplicate closure note under `governance/backlog/` -- candidate consolidation gate under `governance/gates/` - -#### Notes -- no schema change -- no protocol law change -- no normative promotion -- no runtime endorsement -- no product endorsement -- no implementation endorsement -- no certification claim - ---- - -## [candidate-backlog-review-2026-04-21] — 2026-04-21 - -### Candidate Backlog Review - -#### Added -- candidate backlog review inventory under `governance/audits/` -- candidate disposition matrix under `governance/backlog/` -- non-executing lifecycle revision candidate review under - `governance/backlog/` -- candidate backlog consolidation plan under `governance/backlog/` -- candidate backlog review gate under `governance/gates/` - -#### Notes -- no schema change -- no protocol law change -- no normative promotion -- no runtime endorsement -- no product endorsement -- no implementation endorsement -- no certification claim - ---- - -## [downstream-evidence-lifecycle-governance-candidate-note-2026-04-20] — 2026-04-20 - -### Downstream Evidence Lifecycle Governance Candidate Note - -#### Added -- downstream evidence lifecycle-governance candidate note under `governance/backlog/` - -#### Notes -- no schema change -- no protocol law change -- no new MPLP object -- no runtime endorsement -- no implementation dependency -- records guide/profile/binding candidates only - ---- - -## [tooling-posture-closure-2026-04-17] — 2026-04-17 - -### 📋 Package Truth and Tooling Posture Hardening - -#### Added -- package-truth and tooling review records under `governance/audits/` -- package-by-package `dist` target reality matrix under `governance/audits/` -- formal tooling posture closure record under `governance/releases/` - -#### Changed -- README wording to clarify current repo-local package/tooling posture -- validator source `tsconfig.json` normalized to ordinary UTF-8 JSON -- tracked empty `.!*` tooling artifacts removed and future recurrence ignored - -#### Notes -- no schemas, invariants, packages, SDK semantics, or protocol-law change -- this wave clarifies current package/tooling truth only - ---- - -## [downstream-candidate-closure-2026-04-16] — 2026-04-16 - -### 📋 Downstream Candidate-Only Closure Wave - -#### Added -- downstream candidate-only closure matrix under `governance/backlog/` -- cross-repo non-promotion closure record for the current downstream runtime/product line -- formal candidate-only closure record under `governance/releases/` - -#### Notes -- no schemas, invariants, packages, SDKs, or protocol-law change -- this wave closes the current downstream candidate-only line only - ---- - -## [downstream-candidate-backlog-2026-04-15] — 2026-04-15 - -### 📋 Downstream Candidate Backlog Governance Wave - -#### Added -- downstream-driven candidate backlog governance pack under `governance/backlog/` -- bounded candidate tracking for: - - `Delegation Envelope` - - `Delivery / Acceptance Contract Envelope` - - `Constraint / Stop Condition / Escalation Envelope` -- explicit boundary and promotion-rule framing to keep downstream product/runtime pressure out of frozen protocol law by default - -#### Notes -- no protocol schemas, invariants, or packages changed -- no new protocol law is claimed by this wave - ---- - -## [sdk-kernel-duty-propagation-2026-04-01] — 2026-04-01 +## [sdk-kernel-duty-propagation-2026-04-01] — 2026-04-01 ### 📦 SDK Kernel Duty Propagation Release diff --git a/GOVERNANCE.md b/GOVERNANCE.md index 32fcb32c1..b609b05bd 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -6,30 +6,12 @@ wrapperClassName: governance-page The MPLP Protocol is governed by the **MPLP Protocol Governance Committee (MPGC)** to ensure stability, neutrality, and long-term evolution. -This repository is the **Source of Truth** surface within MPLP's 3+1 constitutional entry model. - -Within that model: -- the **Repository** is authoritative for protocol truth, schema truth, invariant truth, and governance source records -- **Documentation** is the specification and reference projection surface -- **Website** is the discovery and positioning surface -- **Validation Lab** is the auxiliary evidence-adjudication surface - ## Governance Clarification Record (2025-12-27) The v1.1.0 release has been formally reclassified as an **Artifact Alignment Release**. No protocol semantics beyond MPLP v1.0.0 were introduced. The MPLP protocol specification remains at **v1.0.0 (FROZEN)**. -Repository-facing version meaning follows the explicit version-domain model defined in: -- `governance/05-versioning/VERSION-TAXONOMY-MANIFEST.md` -- `governance/05-versioning/version-taxonomy-manifest.json` - -In this repository: -- `protocol_version` identifies the frozen MPLP protocol semantic version -- schema and invariant bundles are versioned separately from `protocol_version` -- docs, website, Validation Lab, and SDK release identities are versioned independently of the protocol truth line -- bare version labels must not be treated as authoritative release meaning without an explicit version-domain mapping - ## Governance Structure ### MPLP Protocol Governance Committee (MPGC) @@ -51,14 +33,10 @@ All normative changes must start as an RFC. * **Implementation**: Merged into `draft` or `next` branch. ### 2. Versioning Policy -MPLP governance uses explicit version domains rather than a single undifferentiated version label. -* **`protocol_version`**: frozen MPLP protocol semantic version. -* **`schema_bundle_version` / `invariant_bundle_version`**: canonical schema/invariant bundle versions. -* **`validation_ruleset_version` / `validation_lab_release_version`**: Validation Lab ruleset and release-line versions. -* **`docs_release_version` / `website_release_version`**: docs and website release-line versions. -* **`sdk_version`**: package-scoped SDK release version. - -Where Semantic Versioning applies, it applies within the relevant version domain rather than as one repository-wide public version meaning. +MPLP follows [Semantic Versioning 2.0.0](https://semver.org/). +* **Major (X.y.z)**: Breaking changes to schemas or flow contracts. +* **Minor (x.Y.z)**: Backward-compatible additions (e.g., new optional fields). +* **Patch (x.y.Z)**: Non-normative fixes (typos, clarifications) or critical security patches. ## Frozen Specification Once a version is tagged as **FROZEN** (e.g., v1.0.0), no normative changes are permitted. Any required change triggers a new version number. @@ -66,4 +44,4 @@ Once a version is tagged as **FROZEN** (e.g., v1.0.0), no normative changes are ## Release Cycle * **Major Versions**: Driven by industry needs, typically 12-24 months. * **Minor Versions**: As needed for feature additions. -* **Patch Versions**: As needed for maintenance. +* **Patch Versions**: As needed for maintenance. \ No newline at end of file diff --git a/MPLP_website b/MPLP_website deleted file mode 160000 index da5d4618c..000000000 --- a/MPLP_website +++ /dev/null @@ -1 +0,0 @@ -Subproject commit da5d4618cecf4e1ceec2866f33f8b9f0453a4a71 diff --git a/README.md b/README.md index 299fd6f5e..bc58f3bb5 100644 --- a/README.md +++ b/README.md @@ -57,13 +57,6 @@ records. It is also not the primary place for package-specific implementation guidance or current release walkthroughs. -Downstream-driven candidate tracking, when present, lives under -`governance/backlog/` as non-normative governance only. -Those backlog files do not alter frozen protocol core truth. -Downstream candidate-only closure records may also be recorded under -`governance/backlog/` and `governance/releases/` as non-normative governance -only; they do not imply schema change, package change, or protocol promotion. - ## Version Semantics MPLP uses version domains rather than a single undifferentiated version label. @@ -97,8 +90,8 @@ MPLP uses a **3+1 constitutional entry model** and exposes **four public-facing |---------|----------------------|------|---------| | **Website** | Primary | Discovery & Positioning | Establish MPLP's public framing and discovery path | | **Documentation** | Primary | Specification & Reference | Explain how the protocol works and project normative requirements | -| **Validation Lab** | Auxiliary | Evidence Adjudication | Evidence-based verdicts under versioned Lab rulesets | | **Repository (this)** | Primary | Source of Truth | Schemas, code, tests, governance sources | +| **Validation Lab** | Auxiliary | Evidence Adjudication | Evidence-based verdicts under versioned Lab rulesets | Validation Lab is a public-facing surface, but it is **not** a protocol-defining primary surface. The Repository alone remains authoritative for protocol truth; the other three @@ -125,15 +118,15 @@ Each public-facing surface has stable anchors for cross-referencing: - [Specification](https://docs.mplp.io/docs/specification) — Normative requirements - [Validation Lab Reference](https://docs.mplp.io/docs/evaluation/validation-lab) — Lab overview & terminology -**Validation Lab Anchors**: -- [Lab Site](https://lab.mplp.io) — Evidence adjudication UI -- [Coregentis/MPLP-Validation-Lab](https://github.com/Coregentis/MPLP-Validation-Lab) — Separate Validation Lab release-line repository - **Repository Anchors**: - [Schemas](./schemas/v2/) — Repository truth-source anchor for JSON Schema definitions - [Tests](./tests/golden/flows/) — Golden flows & validators - [Entity Definition](./governance/05-specialized/entity.json) — Canonical machine-readable entity package +**Validation Lab Anchors**: +- [Lab Site](https://lab.mplp.io) — Evidence adjudication UI +- [Validation_Lab](./Validation_Lab/) — In-repository Lab source and governance surface + **Disambiguation**: MPLP = Multi-Agent Lifecycle Protocol (not a license). MPLP is not POSIX (conceptual lens only). --- @@ -149,7 +142,7 @@ Validation Lab does not define protocol truth; protocol truth remains anchored i | **Constitutional Class** | Auxiliary | | **Role** | Evidence-based adjudication under versioned Lab rulesets | | **Lab Site** | [https://lab.mplp.io](https://lab.mplp.io) | -| **Lab Repository** | [Coregentis/MPLP-Validation-Lab](https://github.com/Coregentis/MPLP-Validation-Lab) | +| **Lab Source Surface** | [Validation_Lab/](./Validation_Lab/) | ### Four Boundaries (Non-Negotiable) @@ -161,12 +154,11 @@ Validation Lab does not define protocol truth; protocol truth remains anchored i ### Bounded Governance Chain > **Bounded Role**: Validation Lab rulesets, contract surfaces, and evidence -> adjudication assets are governed in the separate release-line repository -> [Coregentis/MPLP-Validation-Lab](https://github.com/Coregentis/MPLP-Validation-Lab) -> and exposed publicly via [https://lab.mplp.io](https://lab.mplp.io). The root -> MPLP protocol repository links to that Lab surface but does not host it as an -> in-repository public source surface. This bounded Lab role does not supersede -> repository authority on protocol truth, schema truth, or invariant truth. +> adjudication assets are governed in the in-repository +> [Validation_Lab/](./Validation_Lab/) surface and exposed publicly via +> [https://lab.mplp.io](https://lab.mplp.io). This bounded Lab role does not +> supersede repository authority on protocol truth, schema truth, or invariant +> truth. ### Terminology Partition @@ -313,24 +305,6 @@ Primary packages include: - Public package mirror artifacts include: - [`packages/npm/schema/schemas/kernel-duties.json`](./packages/npm/schema/schemas/kernel-duties.json) -### Current Package/Tooling Posture (Repo-Local) - -Current checked-in package/tooling posture is intentionally bounded: - -- this repository does **not** currently expose one unified root type/build gate -- many `packages/npm/*` manifests are publish-oriented and point to `dist/` - targets that are not present in checked-in repo contents -- `packages/sources/*` are not one uniform family of locally buildable source - packages; some are clearer source-side packages than others -- package/tooling posture should therefore be read from current repo contents and - governance records, not inferred from publish-oriented manifest targets alone - -For the bounded package/tooling closure records, see: - -- [`governance/audits/MPLP-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1.md`](./governance/audits/MPLP-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1.md) -- [`governance/audits/MPLP-DIST-TARGET-REALITY-MATRIX-v0.1.md`](./governance/audits/MPLP-DIST-TARGET-REALITY-MATRIX-v0.1.md) -- [`governance/releases/MPLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1.md`](./governance/releases/MPLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1.md) - --- ## What This Repository Does NOT Do diff --git a/RELEASE_MANIFEST.json b/RELEASE_MANIFEST.json index 7da020264..625d2e7f2 100644 --- a/RELEASE_MANIFEST.json +++ b/RELEASE_MANIFEST.json @@ -1,14 +1,12 @@ { - "version_domain": "protocol_version", "version": "1.0.0", - "protocol_version": "1.0.0", - "generated": "2026-01-23T04:11:27.508Z", - "fileCount": 822, - "totalSizeBytes": 5237838, - "totalSizeMB": "5.00", + "generated": "2026-06-09T09:42:27.703Z", + "fileCount": 767, + "totalSizeBytes": 4828823, + "totalSizeMB": "4.61", "buildInfo": { - "node": "v25.2.1", + "node": "v22.22.2", "platform": "darwin", "arch": "arm64" } -} +} \ No newline at end of file diff --git a/artifacts/release/publish-gate-report.json b/artifacts/release/publish-gate-report.json deleted file mode 100644 index f5d85e238..000000000 --- a/artifacts/release/publish-gate-report.json +++ /dev/null @@ -1,78 +0,0 @@ -{ - "timestamp": "2026-04-06T09:13:24.139Z", - "gate": "METHOD-SDKR-08-6.4", - "summary": { - "totalPackages": 14, - "publishableCount": 13, - "blockedCount": 1, - "errorCount": 0, - "violationCount": 0 - }, - "publishSet": [ - { - "name": "@mplp/compliance", - "version": "1.0.5" - }, - { - "name": "@mplp/conformance", - "version": "1.0.0" - }, - { - "name": "@mplp/coordination", - "version": "1.0.6" - }, - { - "name": "@mplp/core", - "version": "1.0.6" - }, - { - "name": "@mplp/devtools", - "version": "1.0.5" - }, - { - "name": "@mplp/integration-llm-http", - "version": "1.0.5" - }, - { - "name": "@mplp/integration-storage-fs", - "version": "1.0.5" - }, - { - "name": "@mplp/integration-storage-kv", - "version": "1.0.5" - }, - { - "name": "@mplp/integration-tools-generic", - "version": "1.0.5" - }, - { - "name": "@mplp/modules", - "version": "1.0.5" - }, - { - "name": "@mplp/runtime-minimal", - "version": "1.0.5" - }, - { - "name": "@mplp/schema", - "version": "1.0.6" - }, - { - "name": "@mplp/sdk-ts", - "version": "1.0.7" - } - ], - "blocked": [ - { - "name": "@mplp/validator", - "reason": { - "isPrivate": true, - "isCiOnly": true, - "isPublishBlocked": true - } - } - ], - "violations": [], - "errors": [], - "status": "PASS" -} \ No newline at end of file diff --git a/artifacts/release/publish-set.json b/artifacts/release/publish-set.json deleted file mode 100644 index e0b2a70d6..000000000 --- a/artifacts/release/publish-set.json +++ /dev/null @@ -1,67 +0,0 @@ -[ - { - "name": "@mplp/compliance", - "version": "1.0.5", - "path": "compliance" - }, - { - "name": "@mplp/conformance", - "version": "1.0.0", - "path": "conformance" - }, - { - "name": "@mplp/coordination", - "version": "1.0.6", - "path": "coordination" - }, - { - "name": "@mplp/core", - "version": "1.0.6", - "path": "core" - }, - { - "name": "@mplp/devtools", - "version": "1.0.5", - "path": "devtools" - }, - { - "name": "@mplp/integration-llm-http", - "version": "1.0.5", - "path": "integration-llm-http" - }, - { - "name": "@mplp/integration-storage-fs", - "version": "1.0.5", - "path": "integration-storage-fs" - }, - { - "name": "@mplp/integration-storage-kv", - "version": "1.0.5", - "path": "integration-storage-kv" - }, - { - "name": "@mplp/integration-tools-generic", - "version": "1.0.5", - "path": "integration-tools-generic" - }, - { - "name": "@mplp/modules", - "version": "1.0.5", - "path": "modules" - }, - { - "name": "@mplp/runtime-minimal", - "version": "1.0.5", - "path": "runtime-minimal" - }, - { - "name": "@mplp/schema", - "version": "1.0.6", - "path": "schema" - }, - { - "name": "@mplp/sdk-ts", - "version": "1.0.7", - "path": "sdk-ts" - } -] \ No newline at end of file diff --git a/artifacts/release/pypi-gate-report.json b/artifacts/release/pypi-gate-report.json deleted file mode 100644 index c86b5608f..000000000 --- a/artifacts/release/pypi-gate-report.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "gate": "pypi-publish-gate", - "timestamp": "2026-04-06T09:13:24.282270+00:00", - "bundleVersion": "1.0.0", - "status": "PASS", - "checks": [ - { - "id": "CLASSIFICATION", - "result": "PASS", - "message": "mplp-sdk is PUBLIC" - }, - { - "id": "DERIVATION_PROOF", - "result": "PASS", - "message": "Found /Users/jasonwang/Documents/AI_Dev/V1.0_release/packages/pypi/mplp-sdk/DERIVATION_PROOF.yaml" - }, - { - "id": "ARTIFACTS", - "result": "PASS", - "message": "Both wheel and sdist found" - }, - { - "id": "VERSION_SYNC", - "result": "PASS", - "message": "Version 1.0.5 matches bundle 1.0.0" - } - ], - "violations": [] -} \ No newline at end of file diff --git a/artifacts/release/pypi-set.json b/artifacts/release/pypi-set.json deleted file mode 100644 index 17d749568..000000000 --- a/artifacts/release/pypi-set.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "ecosystem": "pypi", - "packages": [ - { - "name": "mplp-sdk", - "version": "1.0.5", - "path": "/Users/jasonwang/Documents/AI_Dev/V1.0_release/packages/pypi/mplp-sdk", - "category": "PUBLIC" - } - ] -} \ No newline at end of file diff --git a/docs/docs/evaluation/governance/license-governance.md b/docs/docs/evaluation/governance/license-governance.md index eae858017..dd804c18a 100644 --- a/docs/docs/evaluation/governance/license-governance.md +++ b/docs/docs/evaluation/governance/license-governance.md @@ -51,7 +51,7 @@ Under Apache-2.0, you are free to: ## 5. Trademark Notice -"MPLP" and "Multi-Agent Lifecycle Protocol" are marks associated with Jearon Wong. Trademark registration and ownership notices may be updated as application or registration status changes. +"MPLP" and "Multi-Agent Lifecycle Protocol" are trademarks of Jearon Wong. Use of these marks does NOT imply endorsement. See [External Trust Overview](./EXTERNAL_TRUST_OVERVIEW) for permitted claims. diff --git a/docs/docs/reference/audit-route/v1.0-route-a.md b/docs/docs/reference/audit-route/v1.0-route-a.md index d530f7ccb..3113d3e72 100644 --- a/docs/docs/reference/audit-route/v1.0-route-a.md +++ b/docs/docs/reference/audit-route/v1.0-route-a.md @@ -1,3 +1,7 @@ +--- +normativity: informative +--- + # v1.0 Institutional Audit Route A: Official Guide This guide defines **Route A**, the authoritative path for verifying the institutional integrity and biting-identical state of the Validation Lab v1.0 release. diff --git a/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.17.md b/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.17.md index f853b21c4..31f284e8f 100644 --- a/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.17.md +++ b/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.17.md @@ -1,3 +1,7 @@ +--- +normativity: non-normative +--- + # UI/UX Evolution Report (v0.9 → v0.17) This report documents the structural evolution of the Validation Lab's user interface and its relationship to the underlying protocol SSOT. diff --git a/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.9-v0.17.md b/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.9-v0.17.md index 24348a195..84c20eda9 100644 --- a/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.9-v0.17.md +++ b/docs/docs/reference/uiux-projections/UIUX-DIFF-v0.9-v0.17.md @@ -1,3 +1,7 @@ +--- +normativity: non-normative +--- + # UI/UX Evolution Report: v0.9 -> v0.17 (Non-Normative) This report details the major UI/UX shifts and navigational evolution of the Validation Lab. These changes are "Projections" and do not affect the stationary adjudication logic or bit-identical evidence. diff --git a/docs/docs/reference/uiux-projections/UIUX-MAP-v0.9-v0.17.md b/docs/docs/reference/uiux-projections/UIUX-MAP-v0.9-v0.17.md index 43c13b4da..859c0f3d8 100644 --- a/docs/docs/reference/uiux-projections/UIUX-MAP-v0.9-v0.17.md +++ b/docs/docs/reference/uiux-projections/UIUX-MAP-v0.9-v0.17.md @@ -1,3 +1,7 @@ +--- +normativity: non-normative +--- + # UI/UX SSOT Projection Map (v0.9–v0.17) This table provides the human-readable mapping between Validation Lab routes and their authoritative manifest anchors. diff --git a/docs/docs/reference/uiux-projections/how-to-use-projection-map.md b/docs/docs/reference/uiux-projections/how-to-use-projection-map.md index 10598c8c8..30ec125f3 100644 --- a/docs/docs/reference/uiux-projections/how-to-use-projection-map.md +++ b/docs/docs/reference/uiux-projections/how-to-use-projection-map.md @@ -1,3 +1,7 @@ +--- +normativity: informative +--- + # How to Use the UI/UX SSOT Projection Map The [UI/UX SSOT Projection Map](/docs/reference/uiux-projections/UIUX-MAP-v0.9-v0.17.md) is a non-normative tool designed to help auditors navigate the Validation Lab's evolution and locate key evidence pointers. diff --git a/docs/docs/specification/architecture/l1-core-protocol.md b/docs/docs/specification/architecture/l1-core-protocol.md index ff073034f..bcd8df78a 100644 --- a/docs/docs/specification/architecture/l1-core-protocol.md +++ b/docs/docs/specification/architecture/l1-core-protocol.md @@ -2,7 +2,7 @@ entry_surface: documentation doc_type: normative normativity: normative -status: frozen +status: draft authority: protocol protocol_version: "1.0.0" doc_id: "DOC-ARCH-L1-001" @@ -21,15 +21,6 @@ sidebar_position: 1 description: "MPLP architecture documentation: L1 Core Protocol — Specification (v1.0.0 Frozen). Defines structural requirements and layer responsibilities." --- -> **Frozen Specification** -> -> Protocol Version: 1.0.0 -> Freeze Date: 2025-12-03 -> Authority: MPGC -> -> This document is normative and frozen. -> Changes require MPGC governance process. - # L1 Core Protocol ## Scope diff --git a/docs/docs/validation-lab/index.md b/docs/docs/validation-lab/index.md index 753c2b40d..389ac5d4d 100644 --- a/docs/docs/validation-lab/index.md +++ b/docs/docs/validation-lab/index.md @@ -1,3 +1,7 @@ +--- +normativity: non-normative +--- + # Validation Lab (Route Helper) This path is a **legacy helper route** only. diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts index b9453c68a..bfb7f2e4d 100644 --- a/docs/docusaurus.config.ts +++ b/docs/docusaurus.config.ts @@ -53,7 +53,7 @@ const config: Config = { editUrl: 'https://github.com/Coregentis/MPLP-Protocol/tree/main/docs/', // Docs at /docs/ to allow Landing Page at / routeBasePath: 'docs', - showLastUpdateTime: false, + showLastUpdateTime: true, // Enable breadcrumbs breadcrumbs: true, // Preserve numeric prefixes in URLs/DocIDs diff --git a/docs/ops/PACKAGE_METADATA_BASELINE.yaml b/docs/ops/PACKAGE_METADATA_BASELINE.yaml deleted file mode 100644 index 162a92d62..000000000 --- a/docs/ops/PACKAGE_METADATA_BASELINE.yaml +++ /dev/null @@ -1,52 +0,0 @@ -# MPLP Package Metadata Baseline -# Canonical source of truth for all NPM and PyPI packages -# All publish sources MUST align to this baseline - -license: Apache-2.0 -author: Coregentis AI -copyright_line: "© 2026 Jearon Wong" - -urls: - homepage: https://www.mplp.io - docs: https://docs.mplp.io - repo: https://github.com/Coregentis/MPLP-Protocol - issues: https://github.com/Coregentis/MPLP-Protocol/issues - -keywords: - - mplp - - multi-agent - - lifecycle - - protocol - - agent-os - - agent-os-protocol - -# NPM-specific mappings -npm: - license: Apache-2.0 - author: Coregentis AI - homepage: https://www.mplp.io - repository: - type: git - url: https://github.com/Coregentis/MPLP-Protocol.git - bugs: - url: https://github.com/Coregentis/MPLP-Protocol/issues - keywords: - - mplp - - multi-agent - - lifecycle - - protocol - - agent-os - - agent-os-protocol - -# PyPI-specific mappings -pypi: - license: Apache-2.0 - author: Coregentis AI - urls: - Homepage: https://www.mplp.io - Documentation: https://docs.mplp.io - Repository: https://github.com/Coregentis/MPLP-Protocol - Issues: https://github.com/Coregentis/MPLP-Protocol/issues - classifiers: - - "License :: OSI Approved :: Apache Software License" - - "Development Status :: 5 - Production/Stable" diff --git a/docs/ops/README_CANONICAL_TEMPLATE_v1.0.md b/docs/ops/README_CANONICAL_TEMPLATE_v1.0.md deleted file mode 100644 index dac83ed97..000000000 --- a/docs/ops/README_CANONICAL_TEMPLATE_v1.0.md +++ /dev/null @@ -1,86 +0,0 @@ -# MPLP Canonical README Template - -**Version:** v1.0.0 (Frozen) -**Governance:** MPGC -**Enforcement:** Mandatory for all `@mplp/*` and `mplp-sdk` packages. - ---- - -## Template Structure - -```markdown -# [Package Name] - -**Protocol:** MPLP v1.0.0 (Frozen) -**License:** Apache-2.0 - -The **[Package Name]** package provides **[Description]** for the -**Multi-Agent Lifecycle Protocol (MPLP)** — the Agent OS Protocol for AI agent systems. - -[Optional: Context/Details about this specific package] - ---- - -## Scope & Guarantees (Important) - -### ✅ What this package provides - -* **Protocol-compliant interfaces** aligned with MPLP v1.0.0 -* **Strict version alignment** with the frozen MPLP protocol specification -* **Type-safe integration surface** for higher-level runtimes and tools -* [Package-specific guarantees] - -### ❌ What this package does NOT provide - -* ❌ Full execution runtime (LLM orchestration, tool execution) -* ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -* ❌ Observability pipelines or distributed tracing backends -* ❌ Production agent orchestration - -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- - -## Installation - -\`\`\`bash -npm install [package-name] -# or -pip install [package-name] -\`\`\` - ---- - -## Protocol Documentation (Authoritative) - -* **Homepage:** [https://www.mplp.io](https://www.mplp.io) -* **Specification & Docs:** [https://docs.mplp.io](https://docs.mplp.io) -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) - ---- - -## Versioning & Compatibility - -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. - ---- - -## License - -Apache License, Version 2.0 - -© 2026 **Jearon Wong** -Coregentis AI -``` - -## Terminology Rules - -1. **Protocol Definition**: Must use "**Agent OS Protocol**". - * ❌ "Agent OS-level lifecycle specification" - * ❌ "Agent OS" (ambiguous) -2. **Copyright**: Must include full legal entity name. -3. **Links**: Must point to `mplp.io` and `docs.mplp.io`. \ No newline at end of file diff --git a/docs/ops/RELEASE_WORKFLOW_v1.0.md b/docs/ops/RELEASE_WORKFLOW_v1.0.md deleted file mode 100644 index 678842997..000000000 --- a/docs/ops/RELEASE_WORKFLOW_v1.0.md +++ /dev/null @@ -1,35 +0,0 @@ -# MPLP Release Workflow (v1.0) - -**Status**: Active -**Governance**: Project Governance (DGP) - ---- - -## Overview - -MPLP employs a **governed release process** that strictly separates **Protocol Semantics** from **Project Artifacts**. This ensures that updates to documentation, tooling, or the website do not inadvertently imply changes to the normative protocol specification. - -## Release Identity - -Every MPLP release is defined by three distinct version axes: - -1. **Protocol Version**: The semantic version of the normative specification (e.g., `v1.0.0`). This is **FROZEN** and only changes with MPGC approval. -2. **Repository Version**: The internal state identifier of the codebase. -3. **Release Version**: The public identifier for a specific distribution (e.g., GitHub Release `v1.1.0`). - -## Release Types - -To maintain semantic clarity, releases are classified into two types: - -* **Semantic Release**: Introduces new or modified protocol semantics. Requires a Protocol Version bump. -* **Artifact Alignment Release**: Updates documentation, tooling, SDKs, or infrastructure. **No protocol semantic changes.** - -## Governance Process - -All releases undergo a strict governance gate before publication: - -1. **Separation of Concerns**: The website and protocol artifacts are built and released independently to prevent coupling. -2. **Artifact Purity**: Protocol release artifacts are built from a "pure" state, excluding website code and internal tooling. -3. **Governance Sign-off**: Every release must be explicitly authorized with a declared Release Type and scope. - -> **Note**: This document provides a high-level overview of the release policy. Detailed operational procedures are maintained internally under `project-governance/`. \ No newline at end of file diff --git a/docs/ops/TERMINOLOGY_STANDARD_v1.0.md b/docs/ops/TERMINOLOGY_STANDARD_v1.0.md deleted file mode 100644 index 44ec31635..000000000 --- a/docs/ops/TERMINOLOGY_STANDARD_v1.0.md +++ /dev/null @@ -1,108 +0,0 @@ -# MPLP Canonical Terminology Standard - -**Version:** v1.0 -**Status:** FROZEN -**Governance:** MPGC -**Date:** 2025-12-21 - ---- - -## Purpose - -This document defines the **canonical terminology** for all MPLP publications, including: -- NPM package READMEs -- PyPI package READMEs -- Documentation (docs.mplp.io) -- Marketing materials -- GitHub descriptions - -All future package updates MUST conform to this standard. - ---- - -## Canonical Definitions - -### Core Protocol Identity - -| Term | Canonical Form | ❌ Incorrect Forms | -|:---|:---|:---| -| Protocol Name | **Multi-Agent Lifecycle Protocol (MPLP)** | MPLP Protocol (redundant) | -| Protocol Positioning | **Agent OS Protocol** | ~~Agent OS~~ (incomplete) | -| Full Description | **Agent OS Protocol for AI Agent Systems** | — | - -### Standard Tagline - -> **MPLP — The Agent OS Protocol for AI Agent Systems** - -Or in longer form: - -> **The Multi-Agent Lifecycle Protocol (MPLP) is the Agent OS Protocol that defines the lifecycle specification for AI agent systems.** - ---- - -## README Template (Canonical) - -All package READMEs must use this exact phrasing in the introduction: - -```markdown -**Protocol:** MPLP v1.0.0 (Frozen) -**License:** Apache-2.0 - -The **@mplp/[package-name]** package provides **[description]** for the -**Multi-Agent Lifecycle Protocol (MPLP)** — the Agent OS Protocol for AI agent systems. -``` - -### ❌ Incorrect (Must Not Use) - -```markdown -# Wrong: "Agent OS–level lifecycle specification" -# Wrong: "Agent OS for AI agents" -# Wrong: "the Agent OS–level lifecycle specification for AI agent systems" -``` - -### ✅ Correct (Must Use) - -```markdown -# Correct: "the Agent OS Protocol for AI agent systems" -``` - ---- - -## Semantic Correction Queue - -The following packages were published with incorrect terminology and require update in the next release: - -| Package | Current Wording | Required Fix | -|:---|:---|:---| -| @mplp/core | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/coordination | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/schema | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/devtools | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/compliance | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/modules | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/runtime-minimal | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/sdk-ts | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| @mplp/integration-* | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | -| mplp-sdk (PyPI) | "Agent OS–level lifecycle specification" | → "Agent OS Protocol" | - -**Action Required:** Next patch release must fix this terminology across all packages. - ---- - -## Enforcement - -1. All sync scripts (`batch-update-packages.js`) must use the canonical template -2. README generation must pull from this standard -3. PR reviews must check for terminology compliance - ---- - -## Version History - -| Version | Date | Change | -|:---|:---|:---| -| v1.0 | 2025-12-21 | Initial standard: "Agent OS Protocol" established | - ---- - -**MPGC 2025-12-21** \ No newline at end of file diff --git a/docs/scripts/gates/docs-nonnormative-pointer-only.mjs b/docs/scripts/gates/docs-nonnormative-pointer-only.mjs deleted file mode 100644 index f28b5e1eb..000000000 --- a/docs/scripts/gates/docs-nonnormative-pointer-only.mjs +++ /dev/null @@ -1,105 +0,0 @@ -#!/usr/bin/env node -/** - * Docs Non-Normative Pointer-Only Gate - * - * Enforces DOC-PTR rules: - * 1. Must contain "Non-Normative" disclaimer for Lab-related docs. - * 2. No restatement of adjudication/coverage facts (PASS/FAIL counts). - * 3. Enforce Lab links. - */ - -import * as fs from 'fs'; -import * as path from 'path'; -import { fileURLToPath } from 'url'; - -const __dirname = path.dirname(fileURLToPath(import.meta.url)); -const PROJECT_ROOT = path.resolve(__dirname, '../..'); - -const VALIDATION_LAB_DOC_PATH = 'docs/validation-lab'; -const FORBIDDEN_PATTERNS = [ - /\d+ PASSED/i, - /\d+ FAILED/i, - /Coverage: \d+%/i, - /\|.*\|.*\|/ // Table mirroring -]; - -const REQUIRED_DISCLAIMER = /Non-Normative/i; -const ALLOWED_LAB_LINK = /lab\.mplp\.io/; - -async function main() { - console.log('═══════════════════════════════════════════════════════════'); - console.log(' Docs Non-Normative Gate (DOC-PTR)'); - console.log('═══════════════════════════════════════════════════════════\n'); - - const labDocsDir = path.join(PROJECT_ROOT, VALIDATION_LAB_DOC_PATH); - if (!fs.existsSync(labDocsDir)) { - console.log(`ℹ️ No Validation Lab docs found at ${VALIDATION_LAB_DOC_PATH}. Skipping.`); - process.exit(0); - } - - let issues = []; - let files = []; - findFiles(labDocsDir, files); - - console.log(`🔍 Scanning ${files.length} files in ${VALIDATION_LAB_DOC_PATH}...\n`); - - for (const file of files) { - const content = fs.readFileSync(file, 'utf-8'); - const relativePath = path.relative(PROJECT_ROOT, file); - - // 1. Check for Disclaimer - if (!REQUIRED_DISCLAIMER.test(content)) { - issues.push({ - file: relativePath, - code: 'DOC-PTR-01-MISSING_NON_NORMATIVE_DECLARATION', - msg: 'Validation Lab content must be explicitly marked as "Non-Normative".' - }); - } - - // 2. Check for Data Mirroring - for (const pattern of FORBIDDEN_PATTERNS) { - if (pattern.test(content)) { - issues.push({ - file: relativePath, - code: 'DOC-PTR-02-DATA_MIRRORING', - msg: `Forbidden data mirror pattern detected: ${pattern}` - }); - } - } - - // 3. Check for Lab link - if (!ALLOWED_LAB_LINK.test(content)) { - issues.push({ - file: relativePath, - code: 'DOC-PTR-03-MISSING_LAB_LINK', - msg: 'Validation Lab content must contain a direct link to lab.mplp.io.' - }); - } - } - - if (issues.length > 0) { - console.log('❌ Issues detected:\n'); - issues.forEach(i => console.log(` [${i.code}] ${i.file}: ${i.msg}`)); - process.exit(1); - } else { - console.log('✅ PASS: Docs meet non-normative pointer-only requirements.'); - process.exit(0); - } -} - -function findFiles(dir, fileList) { - const files = fs.readdirSync(dir); - for (const file of files) { - const fullPath = path.join(dir, file); - if (fs.statSync(fullPath).isDirectory()) { - findFiles(fullPath, fileList); - } else if (file.endsWith('.md') || file.endsWith('.mdx')) { - fileList.push(fullPath); - } - } -} - -main().catch(err => { - console.error(err); - process.exit(1); -}); diff --git a/docs/src/css/custom.css.clean_backup b/docs/src/css/custom.css.clean_backup deleted file mode 100644 index 2bff876c7..000000000 --- a/docs/src/css/custom.css.clean_backup +++ /dev/null @@ -1,127 +0,0 @@ -/* - * MPLP Protocol Documentation - Standard Theme - * Based on Docusaurus Classic Preset - */ - -/* 1. Typography Imports */ -@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap'); - -/* 2. Global Variables & Branding */ -:root { - /* Brand Colors - Professional & Clean */ - --ifm-color-primary: #3b82f6; - /* Standard Blue */ - --ifm-color-primary-dark: #2563eb; - --ifm-color-primary-darker: #1d4ed8; - --ifm-color-primary-darkest: #1e40af; - --ifm-color-primary-light: #60a5fa; - --ifm-color-primary-lighter: #93c5fd; - --ifm-color-primary-lightest: #dbeafe; - - /* Typography */ - --ifm-font-family-base: 'Inter', system-ui, -apple-system, sans-serif; - --ifm-font-family-monospace: 'JetBrains Mono', monospace; - --ifm-heading-font-weight: 600; - --ifm-font-size-base: 16px; - - /* Layout Dimensions (Standard Docusaurus) */ - --ifm-container-width: 1280px; - /* Comfortable reading width */ - --ifm-navbar-height: 64px; -} - -/* 3. Dark Mode Overrides */ -[data-theme='dark'] { - --ifm-color-primary: #60a5fa; - --ifm-color-primary-dark: #3b82f6; - --ifm-color-primary-darker: #2563eb; - --ifm-color-primary-darkest: #1d4ed8; - --ifm-color-primary-light: #93c5fd; - --ifm-color-primary-lighter: #bfdbfe; - --ifm-color-primary-lightest: #dbeafe; - --ifm-background-color: #0f172a; - /* Slate 900 */ -} - -/* 4. Navbar Styling */ -.navbar { - box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05); - border-bottom: 1px solid var(--ifm-color-emphasis-200); -} - -.navbar__title { - font-weight: 700; - font-size: 1.1rem; -} - -/* 5. Sidebar Styling */ -.theme-doc-sidebar-container { - border-right: 1px solid var(--ifm-color-emphasis-200) !important; -} - -.menu__link { - border-radius: 0.375rem; - font-size: 0.9rem; - padding: 0.5rem 0.75rem; -} - -.menu__link--active { - background-color: var(--ifm-color-primary-lightest); - color: var(--ifm-color-primary-dark); -} - -[data-theme='dark'] .menu__link--active { - background-color: rgba(59, 130, 246, 0.15); - color: var(--ifm-color-primary-light); -} - -/* 6. Content & Typography */ -.markdown h1 { - font-size: 2.25rem; - margin-bottom: 1.5rem; -} - -.markdown h2 { - font-size: 1.75rem; - margin-top: 2.5rem; - margin-bottom: 1rem; -} - -.markdown h3 { - font-size: 1.25rem; - margin-top: 2rem; - margin-bottom: 0.75rem; -} - -.markdown p { - line-height: 1.7; - margin-bottom: 1.25rem; -} - -/* 7. Code Blocks */ -.theme-code-block { - border-radius: 0.5rem; - box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05); -} - -/* 8. Buttons */ -.button--soft-primary { - background-color: var(--ifm-color-primary-lightest); - color: var(--ifm-color-primary-darker); - border: 1px solid transparent; - transition: all 0.2s ease; -} - -.button--soft-primary:hover { - background-color: var(--ifm-color-primary-lighter); - text-decoration: none; -} - -[data-theme='dark'] .button--soft-primary { - background-color: rgba(59, 130, 246, 0.15); - color: var(--ifm-color-primary-light); -} - -[data-theme='dark'] .button--soft-primary:hover { - background-color: rgba(59, 130, 246, 0.25); -} \ No newline at end of file diff --git a/docs/src/pages/index.module.css b/docs/src/pages/index.module.css index a9f4cac78..6e27d7f29 100644 --- a/docs/src/pages/index.module.css +++ b/docs/src/pages/index.module.css @@ -42,70 +42,60 @@ } .heroSubtitle { - font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; - font-size: 1.35rem; - font-weight: 400; - color: #374151; - /* Slate 700 */ - margin-bottom: 2rem; - max-width: 760px; - margin-left: auto; - margin-right: auto; - line-height: 1.5; - text-align: center !important; - /* Force centering */ + font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; + font-size: 1.5rem; + font-weight: 400; + color: #374151; + /* Slate 700 */ + margin-bottom: 2.5rem; + max-width: 800px; + margin-left: auto; + margin-right: auto; + line-height: 1.5; + text-align: center !important; + /* Force centering */ } [data-theme='dark'] .heroSubtitle { color: #94A3B8; } -.noticeBlock { - max-width: 720px; - margin: 0 auto 1rem auto; - padding: 0.9rem 1rem; - border-radius: 0.5rem; - border: 1px solid #E5E7EB; - background: #F9FAFB; - text-align: left; -} - -[data-theme='dark'] .noticeBlock { - border-color: #1F2937; - background: #111827; -} - -.noticeLabel { - margin: 0 0 0.35rem 0; - font-size: 0.75rem; - font-weight: 700; - letter-spacing: 0.08em; - text-transform: uppercase; - color: #475569; +/* Badges */ +.badges { + display: flex; + gap: 0.75rem; + margin-bottom: 3rem; + flex-wrap: wrap; + justify-content: center; + align-items: center; } -[data-theme='dark'] .noticeLabel { - color: #CBD5E1; +.badges img { + height: 24px; + /* Standardize */ + /* border-radius: 2px; */ + /* Slight ease */ + /* box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1); */ + /* Slight shadow for badges */ } -.noticeText { - margin: 0; - font-size: 0.92rem; - line-height: 1.6; - color: #4B5563; +.badges a { + display: flex; + align-items: center; + transition: transform 0.2s ease; } -[data-theme='dark'] .noticeText { - color: #94A3B8; +.badges a:hover { + transform: translateY(-1px); } -.linkRow { - display: flex; - gap: 0.75rem; - margin-top: 2rem; - flex-wrap: wrap; - justify-content: center; - align-items: center; +/* Buttons */ +.buttons { + display: flex; + align-items: center; + justify-content: center; + margin-top: 1.5rem; + gap: 1rem; } /* Feature Section */ @@ -185,4 +175,4 @@ [data-theme='dark'] .featureDescription { color: #9CA3AF; -} +} \ No newline at end of file diff --git a/docs/src/pages/index.tsx b/docs/src/pages/index.tsx index 3381cb271..66897be79 100644 --- a/docs/src/pages/index.tsx +++ b/docs/src/pages/index.tsx @@ -12,43 +12,89 @@ function HomepageHeader() { return (
+ {/* Primary Title - Protocol Name */} MPLP Specification v1.0.0 (Frozen) + {/* Hero Definition - Specification Entry (elevated to main sentence) */}

Authoritative definitions live in the Schemas (Source of Truth).
This site provides structured specification navigation, references, and evaluation guidance for MPLP v1.0.0 (Frozen).

-
-

Documentation Scope

-

- Docs is the specification and reference surface. It organizes repository-backed protocol material for reading, citation, and implementation guidance. + {/* Non-Goals Block (formal governance section) */} +

+ Non-Goals: MPLP is not a framework, not a runtime, and not a platform. +

+ + {/* Positioning Analogy - Explicitly Non-Normative */} +
+

+ Positioning Analogy (Non-Normative) +

+

+ Often described as "The Agent OS Protocol" — a conceptual analogy for lifecycle governance. + This does not imply an execution runtime, operating system, or vendor platform.

-
-

Non-Goals

-

- MPLP is not a framework, runtime, or platform. This homepage orients readers into the documentation set; it does not replace repository truth sources. -

+ {/* Badges Section */} +
+ Protocol + Governance + License + Schemas + + Validation Lab (External) +
-
-

Reading Order

-

- Start with the protocol overview, then move into architecture, modules, profiles, observability, and evaluation material as needed. -

+ {/* Governance Statement */} +

+ Governed by MPGC. The specification is frozen at v1.0.0 — no breaking changes permitted. + Published SDK package surfaces and Golden Flows support protocol conformance without vendor certification. + Governance processes and constitutional records are maintained in the Repository governance/ directory; this site provides pointers only. +

+ +
+ + Start Reading (Protocol Overview) + + + Schemas (Source of Truth) + + + Golden Flows (Evaluation) +
-
- - - - - - + {/* Start Here - Reading Path */} +
+

Start Here

+
+ + + + + + +
@@ -129,11 +175,11 @@ const FeatureList = [ function ReadPathItem({ label, link }) { return ( diff --git a/docs/static/mermaid/03f6a1c4ea3ae71b.dark.svg b/docs/static/mermaid/03f6a1c4ea3ae71b.dark.svg deleted file mode 100644 index 49d129073..000000000 --- a/docs/static/mermaid/03f6a1c4ea3ae71b.dark.svg +++ /dev/null @@ -1 +0,0 @@ -Agent CAgent BAgent AOrchestratorAgent CAgent BAgent AOrchestratorpar[Fan-out]par[Fan-in]MAPBroadcastSentTaskTaskTaskMAPBroadcastReceivedMAPBroadcastReceivedMAPBroadcastReceivedAggregate results \ No newline at end of file diff --git a/docs/static/mermaid/03f6a1c4ea3ae71b.light.svg b/docs/static/mermaid/03f6a1c4ea3ae71b.light.svg deleted file mode 100644 index 98887f1f7..000000000 --- a/docs/static/mermaid/03f6a1c4ea3ae71b.light.svg +++ /dev/null @@ -1 +0,0 @@ -Agent CAgent BAgent AOrchestratorAgent CAgent BAgent AOrchestratorpar[Fan-out]par[Fan-in]MAPBroadcastSentTaskTaskTaskMAPBroadcastReceivedMAPBroadcastReceivedMAPBroadcastReceivedAggregate results \ No newline at end of file diff --git a/docs/static/mermaid/0b027f043a41dd74.dark.svg b/docs/static/mermaid/0b027f043a41dd74.dark.svg deleted file mode 100644 index d20a863a8..000000000 --- a/docs/static/mermaid/0b027f043a41dd74.dark.svg +++ /dev/null @@ -1 +0,0 @@ -Agent BAgent AEvent BusOrchestratorAgent BAgent AEvent BusOrchestratorTurn 1Turn 2MAPSessionStartedMAPRolesAssignedMAPTurnDispatched(A)Execute taskMAPTurnCompleted(A)MAPTurnDispatched(B)Execute taskMAPTurnCompleted(B)MAPSessionCompleted \ No newline at end of file diff --git a/docs/static/mermaid/0b027f043a41dd74.light.svg b/docs/static/mermaid/0b027f043a41dd74.light.svg deleted file mode 100644 index 8c5857267..000000000 --- a/docs/static/mermaid/0b027f043a41dd74.light.svg +++ /dev/null @@ -1 +0,0 @@ -Agent BAgent AEvent BusOrchestratorAgent BAgent AEvent BusOrchestratorTurn 1Turn 2MAPSessionStartedMAPRolesAssignedMAPTurnDispatched(A)Execute taskMAPTurnCompleted(A)MAPTurnDispatched(B)Execute taskMAPTurnCompleted(B)MAPSessionCompleted \ No newline at end of file diff --git a/docs/static/mermaid/13d010945f38b1b8.dark.svg b/docs/static/mermaid/13d010945f38b1b8.dark.svg deleted file mode 100644 index 3ad6f24db..000000000 --- a/docs/static/mermaid/13d010945f38b1b8.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Native Event

MPLP Integration Event

Validated Event

External System
e.g., VS Code

MPLP Adapter
e.g., vscode-plugin

L3 Event Bus

PSG Update Logic

 \ No newline at end of file diff --git a/docs/static/mermaid/13d010945f38b1b8.light.svg b/docs/static/mermaid/13d010945f38b1b8.light.svg deleted file mode 100644 index a3efa95ab..000000000 --- a/docs/static/mermaid/13d010945f38b1b8.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Native Event

MPLP Integration Event

Validated Event

External System
e.g., VS Code

MPLP Adapter
e.g., vscode-plugin

L3 Event Bus

PSG Update Logic

 \ No newline at end of file diff --git a/docs/static/mermaid/17d435b8a51f9f7a.dark.svg b/docs/static/mermaid/17d435b8a51f9f7a.dark.svg deleted file mode 100644 index 960ed4ba0..000000000 --- a/docs/static/mermaid/17d435b8a51f9f7a.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

VSL

Transaction

Rollback

Compensation

PSG

 \ No newline at end of file diff --git a/docs/static/mermaid/17d435b8a51f9f7a.light.svg b/docs/static/mermaid/17d435b8a51f9f7a.light.svg deleted file mode 100644 index f6f5d500f..000000000 --- a/docs/static/mermaid/17d435b8a51f9f7a.light.svg +++ /dev/null @@ -1 +0,0 @@ -

VSL

Transaction

Rollback

Compensation

PSG

 \ No newline at end of file diff --git a/docs/static/mermaid/1dee506904af5221.dark.svg b/docs/static/mermaid/1dee506904af5221.dark.svg deleted file mode 100644 index 5bdbb8964..000000000 --- a/docs/static/mermaid/1dee506904af5221.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Plan

Orchestration

Context

Confirm

PSG

EventBus

Trace

 \ No newline at end of file diff --git a/docs/static/mermaid/1dee506904af5221.light.svg b/docs/static/mermaid/1dee506904af5221.light.svg deleted file mode 100644 index a5f3e4fd4..000000000 --- a/docs/static/mermaid/1dee506904af5221.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Plan

Orchestration

Context

Confirm

PSG

EventBus

Trace

 \ No newline at end of file diff --git a/docs/static/mermaid/203e3ff10debbc59.dark.svg b/docs/static/mermaid/203e3ff10debbc59.dark.svg deleted file mode 100644 index 794769315..000000000 --- a/docs/static/mermaid/203e3ff10debbc59.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Extension Layer

Coordination Layer

Execution Layer

Core Layer (Required)

Core Module

Context Module

Role Module

Plan Module

Trace Module

Collab Module

Confirm Module

Dialog Module

Extension Module

Network Module

 \ No newline at end of file diff --git a/docs/static/mermaid/203e3ff10debbc59.light.svg b/docs/static/mermaid/203e3ff10debbc59.light.svg deleted file mode 100644 index f5e2767f0..000000000 --- a/docs/static/mermaid/203e3ff10debbc59.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Extension Layer

Coordination Layer

Execution Layer

Core Layer (Required)

Core Module

Context Module

Role Module

Plan Module

Trace Module

Collab Module

Confirm Module

Dialog Module

Extension Module

Network Module

 \ No newline at end of file diff --git a/docs/static/mermaid/25e4b645ffd43def.dark.svg b/docs/static/mermaid/25e4b645ffd43def.dark.svg deleted file mode 100644 index 95851b6f1..000000000 --- a/docs/static/mermaid/25e4b645ffd43def.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

VSL

StateSync

PSG

DriftDetection

Snapshot

 \ No newline at end of file diff --git a/docs/static/mermaid/25e4b645ffd43def.light.svg b/docs/static/mermaid/25e4b645ffd43def.light.svg deleted file mode 100644 index bd76b208b..000000000 --- a/docs/static/mermaid/25e4b645ffd43def.light.svg +++ /dev/null @@ -1 +0,0 @@ -

VSL

StateSync

PSG

DriftDetection

Snapshot

 \ No newline at end of file diff --git a/docs/static/mermaid/2d4ae71db41b70f6.dark.svg b/docs/static/mermaid/2d4ae71db41b70f6.dark.svg deleted file mode 100644 index 8b92b706f..000000000 --- a/docs/static/mermaid/2d4ae71db41b70f6.dark.svg +++ /dev/null @@ -1 +0,0 @@ -PSGL3 RuntimeEvent BusL4 AdapterVS CodePSGL3 RuntimeEvent BusL4 AdapterVS Codealt[Drift Detected][No Drift]File saved (native event)file_update_event {file_path, timestamp}Dispatch eventGet file metadata{last_modified, content_hash}Compare timestampsEmit drift_eventUpdate metadataEmit graph_updateUpdate timestamp only \ No newline at end of file diff --git a/docs/static/mermaid/2d4ae71db41b70f6.light.svg b/docs/static/mermaid/2d4ae71db41b70f6.light.svg deleted file mode 100644 index 8efd199c3..000000000 --- a/docs/static/mermaid/2d4ae71db41b70f6.light.svg +++ /dev/null @@ -1 +0,0 @@ -PSGL3 RuntimeEvent BusL4 AdapterVS CodePSGL3 RuntimeEvent BusL4 AdapterVS Codealt[Drift Detected][No Drift]File saved (native event)file_update_event {file_path, timestamp}Dispatch eventGet file metadata{last_modified, content_hash}Compare timestampsEmit drift_eventUpdate metadataEmit graph_updateUpdate timestamp only \ No newline at end of file diff --git a/docs/static/mermaid/372f3dfcf3e186ce.dark.svg b/docs/static/mermaid/372f3dfcf3e186ce.dark.svg deleted file mode 100644 index c1d524c61..000000000 --- a/docs/static/mermaid/372f3dfcf3e186ce.dark.svg +++ /dev/null @@ -1 +0,0 @@ -EventBusSA RuntimeEventBusSA RuntimeExecute stepalt[Success][Failure]loop[For each step]SAInitializedSAContextLoadedSAPlanEvaluatedSAStepStartedSAStepCompletedSAStepFailedSATraceEmittedSACompleted \ No newline at end of file diff --git a/docs/static/mermaid/372f3dfcf3e186ce.light.svg b/docs/static/mermaid/372f3dfcf3e186ce.light.svg deleted file mode 100644 index 58b5d6f24..000000000 --- a/docs/static/mermaid/372f3dfcf3e186ce.light.svg +++ /dev/null @@ -1 +0,0 @@ -EventBusSA RuntimeEventBusSA RuntimeExecute stepalt[Success][Failure]loop[For each step]SAInitializedSAContextLoadedSAPlanEvaluatedSAStepStartedSAStepCompletedSAStepFailedSATraceEmittedSACompleted \ No newline at end of file diff --git a/docs/static/mermaid/381d99f56ab5380b.dark.svg b/docs/static/mermaid/381d99f56ab5380b.dark.svg deleted file mode 100644 index a2c4b790b..000000000 --- a/docs/static/mermaid/381d99f56ab5380b.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

edge

Context (root)
context_id = ctx-123

Plan (child)
plan_id = plan-456
context_id = ctx-123

Trace (child)
trace_id = trace-789
context_id = ctx-123
plan_id = plan-456

Step 1
dependencies: []

Step 2
dependencies: [step-1]

 \ No newline at end of file diff --git a/docs/static/mermaid/381d99f56ab5380b.light.svg b/docs/static/mermaid/381d99f56ab5380b.light.svg deleted file mode 100644 index d6a243edc..000000000 --- a/docs/static/mermaid/381d99f56ab5380b.light.svg +++ /dev/null @@ -1 +0,0 @@ -

edge

Context (root)
context_id = ctx-123

Plan (child)
plan_id = plan-456
context_id = ctx-123

Trace (child)
trace_id = trace-789
context_id = ctx-123
plan_id = plan-456

Step 1
dependencies: []

Step 2
dependencies: [step-1]

 \ No newline at end of file diff --git a/docs/static/mermaid/3823eeb044d6f498.dark.svg b/docs/static/mermaid/3823eeb044d6f498.dark.svg deleted file mode 100644 index 81cc5d371..000000000 --- a/docs/static/mermaid/3823eeb044d6f498.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

s1: Analyze Requirements

s2: Design Architecture

s3: Setup Testing

s4: Implement Core

s5: Integration Test

 \ No newline at end of file diff --git a/docs/static/mermaid/3823eeb044d6f498.light.svg b/docs/static/mermaid/3823eeb044d6f498.light.svg deleted file mode 100644 index ced3b7395..000000000 --- a/docs/static/mermaid/3823eeb044d6f498.light.svg +++ /dev/null @@ -1 +0,0 @@ -

s1: Analyze Requirements

s2: Design Architecture

s3: Setup Testing

s4: Implement Core

s5: Integration Test

 \ No newline at end of file diff --git a/docs/static/mermaid/384e45a09987bbdc.dark.svg b/docs/static/mermaid/384e45a09987bbdc.dark.svg deleted file mode 100644 index dd6dd633a..000000000 --- a/docs/static/mermaid/384e45a09987bbdc.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Observability

PSG Layer

Module Layer

WRITE

READ-WRITE

WRITE

GraphUpdateEvent

Context

Plan

Trace

Protocol State Graph

Event Emitter

 \ No newline at end of file diff --git a/docs/static/mermaid/384e45a09987bbdc.light.svg b/docs/static/mermaid/384e45a09987bbdc.light.svg deleted file mode 100644 index a28371d86..000000000 --- a/docs/static/mermaid/384e45a09987bbdc.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Observability

PSG Layer

Module Layer

WRITE

READ-WRITE

WRITE

GraphUpdateEvent

Context

Plan

Trace

Protocol State Graph

Event Emitter

 \ No newline at end of file diff --git a/docs/static/mermaid/46eb8cc753f5fa48.dark.svg b/docs/static/mermaid/46eb8cc753f5fa48.dark.svg deleted file mode 100644 index 2792cdc1e..000000000 --- a/docs/static/mermaid/46eb8cc753f5fa48.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create Request

User Approves

User Rejects

User/System Cancels

pending

approved

rejected

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/46eb8cc753f5fa48.light.svg b/docs/static/mermaid/46eb8cc753f5fa48.light.svg deleted file mode 100644 index 9c59a6b5e..000000000 --- a/docs/static/mermaid/46eb8cc753f5fa48.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create Request

User Approves

User Rejects

User/System Cancels

pending

approved

rejected

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/50c478d3011a0924.dark.svg b/docs/static/mermaid/50c478d3011a0924.dark.svg deleted file mode 100644 index ccc63c85b..000000000 --- a/docs/static/mermaid/50c478d3011a0924.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Event Families

Specific Schemas (extends Core)

Base Schema

mplp-event-core.schema.json

mplp-graph-update-event.schema.json

mplp-pipeline-stage-event.schema.json

mplp-runtime-execution-event.schema.json

graph_update
REQUIRED

pipeline_stage
REQUIRED

runtime_execution
RECOMMENDED

intent, cost_budget,
etc. - use Core

 \ No newline at end of file diff --git a/docs/static/mermaid/50c478d3011a0924.light.svg b/docs/static/mermaid/50c478d3011a0924.light.svg deleted file mode 100644 index 2e5efc1a9..000000000 --- a/docs/static/mermaid/50c478d3011a0924.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Event Families

Specific Schemas (extends Core)

Base Schema

mplp-event-core.schema.json

mplp-graph-update-event.schema.json

mplp-pipeline-stage-event.schema.json

mplp-runtime-execution-event.schema.json

graph_update
REQUIRED

pipeline_stage
REQUIRED

runtime_execution
RECOMMENDED

intent, cost_budget,
etc. - use Core

 \ No newline at end of file diff --git a/docs/static/mermaid/53381ce57a40fa2d.dark.svg b/docs/static/mermaid/53381ce57a40fa2d.dark.svg deleted file mode 100644 index 87465db92..000000000 --- a/docs/static/mermaid/53381ce57a40fa2d.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Role

Security

Confirm

Trace

L4Integration

PSG

 \ No newline at end of file diff --git a/docs/static/mermaid/53381ce57a40fa2d.light.svg b/docs/static/mermaid/53381ce57a40fa2d.light.svg deleted file mode 100644 index 5ea698441..000000000 --- a/docs/static/mermaid/53381ce57a40fa2d.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Role

Security

Confirm

Trace

L4Integration

PSG

 \ No newline at end of file diff --git a/docs/static/mermaid/5968b52d0c6e020d.dark.svg b/docs/static/mermaid/5968b52d0c6e020d.dark.svg deleted file mode 100644 index 1517c694d..000000000 --- a/docs/static/mermaid/5968b52d0c6e020d.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Recommended Events

Required Events

Modules

Context

Plan

Trace

Role

Confirm

Dialog

Collab

Extension

Network

Core

graph_update

pipeline_stage

runtime_execution

import_process

intent

cost_budget

 \ No newline at end of file diff --git a/docs/static/mermaid/5968b52d0c6e020d.light.svg b/docs/static/mermaid/5968b52d0c6e020d.light.svg deleted file mode 100644 index 83be04924..000000000 --- a/docs/static/mermaid/5968b52d0c6e020d.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Recommended Events

Required Events

Modules

Context

Plan

Trace

Role

Confirm

Dialog

Collab

Extension

Network

Core

graph_update

pipeline_stage

runtime_execution

import_process

intent

cost_budget

 \ No newline at end of file diff --git a/docs/static/mermaid/5cd6cf2e8cb9f239.dark.svg b/docs/static/mermaid/5cd6cf2e8cb9f239.dark.svg deleted file mode 100644 index eac2a1d76..000000000 --- a/docs/static/mermaid/5cd6cf2e8cb9f239.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id MUST reference

proposed→approved requires Confirm.approved=true

Each step execution emits Trace Span

step.agent_role references role_id

Plan Module

Context Module

Confirm Module

Trace Module

Role Module

 \ No newline at end of file diff --git a/docs/static/mermaid/5cd6cf2e8cb9f239.light.svg b/docs/static/mermaid/5cd6cf2e8cb9f239.light.svg deleted file mode 100644 index 5c45e785b..000000000 --- a/docs/static/mermaid/5cd6cf2e8cb9f239.light.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id MUST reference

proposed→approved requires Confirm.approved=true

Each step execution emits Trace Span

step.agent_role references role_id

Plan Module

Context Module

Confirm Module

Trace Module

Role Module

 \ No newline at end of file diff --git a/docs/static/mermaid/6246257eb1ed66f2.dark.svg b/docs/static/mermaid/6246257eb1ed66f2.dark.svg deleted file mode 100644 index aeaa364a4..000000000 --- a/docs/static/mermaid/6246257eb1ed66f2.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

2

3+

Yes

No

Yes

No

Yes

No

Collaboration Need

How many participants?

pair

Need central control?

orchestrated

Independent work?

swarm

Sequential turns?

round_robin

broadcast

 \ No newline at end of file diff --git a/docs/static/mermaid/6246257eb1ed66f2.light.svg b/docs/static/mermaid/6246257eb1ed66f2.light.svg deleted file mode 100644 index 35a8ce106..000000000 --- a/docs/static/mermaid/6246257eb1ed66f2.light.svg +++ /dev/null @@ -1 +0,0 @@ -

2

3+

Yes

No

Yes

No

Yes

No

Collaboration Need

How many participants?

pair

Need central control?

orchestrated

Independent work?

swarm

Sequential turns?

round_robin

broadcast

 \ No newline at end of file diff --git a/docs/static/mermaid/6a6ea3139e594005.dark.svg b/docs/static/mermaid/6a6ea3139e594005.dark.svg deleted file mode 100644 index 03289fc43..000000000 --- a/docs/static/mermaid/6a6ea3139e594005.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Register

Activate

Deactivate

Reactivate

Deprecate

Disable

registered

active

inactive

deprecated

 \ No newline at end of file diff --git a/docs/static/mermaid/6a6ea3139e594005.light.svg b/docs/static/mermaid/6a6ea3139e594005.light.svg deleted file mode 100644 index 1d7277e00..000000000 --- a/docs/static/mermaid/6a6ea3139e594005.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Register

Activate

Deactivate

Reactivate

Deprecate

Disable

registered

active

inactive

deprecated

 \ No newline at end of file diff --git a/docs/static/mermaid/6b3b207bb2aff734.dark.svg b/docs/static/mermaid/6b3b207bb2aff734.dark.svg deleted file mode 100644 index a6e59e09f..000000000 --- a/docs/static/mermaid/6b3b207bb2aff734.dark.svg +++ /dev/null @@ -1 +0,0 @@ -TraceAgent BAgent AOrchestratorTraceAgent BAgent AOrchestratorTurn 1Turn 2MAPSessionStartedMAPRolesAssignedMAPTurnDispatchedExecute (SA sub-loop)MAPTurnCompletedRecord resultMAPTurnDispatchedExecute (SA sub-loop)MAPTurnCompletedRecord resultMAPSessionCompleted \ No newline at end of file diff --git a/docs/static/mermaid/6b3b207bb2aff734.light.svg b/docs/static/mermaid/6b3b207bb2aff734.light.svg deleted file mode 100644 index 5f20f4467..000000000 --- a/docs/static/mermaid/6b3b207bb2aff734.light.svg +++ /dev/null @@ -1 +0,0 @@ -TraceAgent BAgent AOrchestratorTraceAgent BAgent AOrchestratorTurn 1Turn 2MAPSessionStartedMAPRolesAssignedMAPTurnDispatchedExecute (SA sub-loop)MAPTurnCompletedRecord resultMAPTurnDispatchedExecute (SA sub-loop)MAPTurnCompletedRecord resultMAPSessionCompleted \ No newline at end of file diff --git a/docs/static/mermaid/6cdd6464bbfb3830.dark.svg b/docs/static/mermaid/6cdd6464bbfb3830.dark.svg deleted file mode 100644 index d1d7b7fbe..000000000 --- a/docs/static/mermaid/6cdd6464bbfb3830.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Group C: State & Safety (L3)

graph_update
REQUIRED

impact_analysis

compensation_plan

import_process

Group B: Execution & Lifecycle (L3)

pipeline_stage
REQUIRED

runtime_execution

external_integration

cost_budget

Group A: Intent & Planning (L2)

intent

delta_intent

methodology

reasoning_graph

 \ No newline at end of file diff --git a/docs/static/mermaid/6cdd6464bbfb3830.light.svg b/docs/static/mermaid/6cdd6464bbfb3830.light.svg deleted file mode 100644 index 09bc9700b..000000000 --- a/docs/static/mermaid/6cdd6464bbfb3830.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Group C: State & Safety (L3)

graph_update
REQUIRED

impact_analysis

compensation_plan

import_process

Group B: Execution & Lifecycle (L3)

pipeline_stage
REQUIRED

runtime_execution

external_integration

cost_budget

Group A: Intent & Planning (L2)

intent

delta_intent

methodology

reasoning_graph

 \ No newline at end of file diff --git a/docs/static/mermaid/6fa8ed6a705962cd.dark.svg b/docs/static/mermaid/6fa8ed6a705962cd.dark.svg deleted file mode 100644 index 67bd6d304..000000000 --- a/docs/static/mermaid/6fa8ed6a705962cd.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Deploy

Ready

Partial Failure

Recover

Planned Downtime

Resume

Decommission

draft

provisioning

active

degraded

maintenance

retired

 \ No newline at end of file diff --git a/docs/static/mermaid/6fa8ed6a705962cd.light.svg b/docs/static/mermaid/6fa8ed6a705962cd.light.svg deleted file mode 100644 index ee32dcf5d..000000000 --- a/docs/static/mermaid/6fa8ed6a705962cd.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Deploy

Ready

Partial Failure

Recover

Planned Downtime

Resume

Decommission

draft

provisioning

active

degraded

maintenance

retired

 \ No newline at end of file diff --git a/docs/static/mermaid/7109580d1f77ebfc.dark.svg b/docs/static/mermaid/7109580d1f77ebfc.dark.svg deleted file mode 100644 index 93b69c430..000000000 --- a/docs/static/mermaid/7109580d1f77ebfc.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Committee

Vote

Vote

Vote

Member 1

Member 2

Member 3

Decision

Action

 \ No newline at end of file diff --git a/docs/static/mermaid/7109580d1f77ebfc.light.svg b/docs/static/mermaid/7109580d1f77ebfc.light.svg deleted file mode 100644 index 858b4f117..000000000 --- a/docs/static/mermaid/7109580d1f77ebfc.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Committee

Vote

Vote

Vote

Member 1

Member 2

Member 3

Decision

Action

 \ No newline at end of file diff --git a/docs/static/mermaid/760030f7572a6f27.dark.svg b/docs/static/mermaid/760030f7572a6f27.dark.svg deleted file mode 100644 index f9b787269..000000000 --- a/docs/static/mermaid/760030f7572a6f27.dark.svg +++ /dev/null @@ -1 +0,0 @@ -TraceConfirmPlanContextDialogUserTraceConfirmPlanContextDialogUserloop[Each Step]"Fix the login bug"Load project contextCreate Plan (draft)Add stepsSubmit for approvalRequest approvalApprovestatus=approvedStart execution traceExecute step create segmentAll completedDone! \ No newline at end of file diff --git a/docs/static/mermaid/760030f7572a6f27.light.svg b/docs/static/mermaid/760030f7572a6f27.light.svg deleted file mode 100644 index f3388297c..000000000 --- a/docs/static/mermaid/760030f7572a6f27.light.svg +++ /dev/null @@ -1 +0,0 @@ -TraceConfirmPlanContextDialogUserTraceConfirmPlanContextDialogUserloop[Each Step]"Fix the login bug"Load project contextCreate Plan (draft)Add stepsSubmit for approvalRequest approvalApprovestatus=approvedStart execution traceExecute step create segmentAll completedDone! \ No newline at end of file diff --git a/docs/static/mermaid/7b45b30fac58fcf1.dark.svg b/docs/static/mermaid/7b45b30fac58fcf1.dark.svg deleted file mode 100644 index a56df8cbc..000000000 --- a/docs/static/mermaid/7b45b30fac58fcf1.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id MUST reference valid Context

plan_id references associated Plan

Receives all observability events

Completed traces → learning sample extraction

Trace Module

Context Module

Plan Module

Observability

Learning Module

 \ No newline at end of file diff --git a/docs/static/mermaid/7b45b30fac58fcf1.light.svg b/docs/static/mermaid/7b45b30fac58fcf1.light.svg deleted file mode 100644 index 6a616ef65..000000000 --- a/docs/static/mermaid/7b45b30fac58fcf1.light.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id MUST reference valid Context

plan_id references associated Plan

Receives all observability events

Completed traces → learning sample extraction

Trace Module

Context Module

Plan Module

Observability

Learning Module

 \ No newline at end of file diff --git a/docs/static/mermaid/7cbc7eb0aad8c11b.dark.svg b/docs/static/mermaid/7cbc7eb0aad8c11b.dark.svg deleted file mode 100644 index 993528f56..000000000 --- a/docs/static/mermaid/7cbc7eb0aad8c11b.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Begin

Success

Error

Conditional Skip

Abort

pending

running

completed

failed

skipped

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/7cbc7eb0aad8c11b.light.svg b/docs/static/mermaid/7cbc7eb0aad8c11b.light.svg deleted file mode 100644 index 97d555141..000000000 --- a/docs/static/mermaid/7cbc7eb0aad8c11b.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Begin

Success

Error

Conditional Skip

Abort

pending

running

completed

failed

skipped

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/7ff3e2ed31e8415f.dark.svg b/docs/static/mermaid/7ff3e2ed31e8415f.dark.svg deleted file mode 100644 index 39d30e77f..000000000 --- a/docs/static/mermaid/7ff3e2ed31e8415f.dark.svg +++ /dev/null @@ -1 +0,0 @@ -File SystemTracePSGRuntimeFile SystemTracePSGRuntimeEmit RollbackInitiatedLoad snapshot stateRevert nodes (project_root, plans, context)Restore file backups (if applicable)Attempt compensation for side-effectsEmit RollbackCompletedCreate new Trace Span for re-execution \ No newline at end of file diff --git a/docs/static/mermaid/7ff3e2ed31e8415f.light.svg b/docs/static/mermaid/7ff3e2ed31e8415f.light.svg deleted file mode 100644 index f1fc35957..000000000 --- a/docs/static/mermaid/7ff3e2ed31e8415f.light.svg +++ /dev/null @@ -1 +0,0 @@ -File SystemTracePSGRuntimeFile SystemTracePSGRuntimeEmit RollbackInitiatedLoad snapshot stateRevert nodes (project_root, plans, context)Restore file backups (if applicable)Attempt compensation for side-effectsEmit RollbackCompletedCreate new Trace Span for re-execution \ No newline at end of file diff --git a/docs/static/mermaid/813af8a6e20c87ca.dark.svg b/docs/static/mermaid/813af8a6e20c87ca.dark.svg deleted file mode 100644 index 8fd178326..000000000 --- a/docs/static/mermaid/813af8a6e20c87ca.dark.svg +++ /dev/null @@ -1 +0,0 @@ -PlanUserConfirmRuntimeAgentPlanUserConfirmRuntimeAgentalt[User Approves][User Rejects]Create Plan (status=draft)Submit (status=proposed)Create Confirm RequestNotify: Approval RequiredApprovestatus=approvedExecuteReject (with feedback)status=draftModify based on feedback \ No newline at end of file diff --git a/docs/static/mermaid/813af8a6e20c87ca.light.svg b/docs/static/mermaid/813af8a6e20c87ca.light.svg deleted file mode 100644 index d3cdce420..000000000 --- a/docs/static/mermaid/813af8a6e20c87ca.light.svg +++ /dev/null @@ -1 +0,0 @@ -PlanUserConfirmRuntimeAgentPlanUserConfirmRuntimeAgentalt[User Approves][User Rejects]Create Plan (status=draft)Submit (status=proposed)Create Confirm RequestNotify: Approval RequiredApprovestatus=approvedExecuteReject (with feedback)status=draftModify based on feedback \ No newline at end of file diff --git a/docs/static/mermaid/8344e7078a03df0d.dark.svg b/docs/static/mermaid/8344e7078a03df0d.dark.svg deleted file mode 100644 index 7fee75b9c..000000000 --- a/docs/static/mermaid/8344e7078a03df0d.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create Session

Start Session

Complete Turn

Pause

Resume

All Done

Abort

draft

active

suspended

completed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/8344e7078a03df0d.light.svg b/docs/static/mermaid/8344e7078a03df0d.light.svg deleted file mode 100644 index 65d638191..000000000 --- a/docs/static/mermaid/8344e7078a03df0d.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create Session

Start Session

Complete Turn

Pause

Resume

All Done

Abort

draft

active

suspended

completed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/83fa0e9e559b8ea2.dark.svg b/docs/static/mermaid/83fa0e9e559b8ea2.dark.svg deleted file mode 100644 index 2d6d9e4ed..000000000 --- a/docs/static/mermaid/83fa0e9e559b8ea2.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Dependencies Met

Success

Error

Dependency Failed

Conditional Skip

Dependency Resolved

pending

in_progress

completed

failed

blocked

skipped

 \ No newline at end of file diff --git a/docs/static/mermaid/83fa0e9e559b8ea2.light.svg b/docs/static/mermaid/83fa0e9e559b8ea2.light.svg deleted file mode 100644 index dc53e4551..000000000 --- a/docs/static/mermaid/83fa0e9e559b8ea2.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Dependencies Met

Success

Error

Dependency Failed

Conditional Skip

Dependency Resolved

pending

in_progress

completed

failed

blocked

skipped

 \ No newline at end of file diff --git a/docs/static/mermaid/852eba31132f70ba.dark.svg b/docs/static/mermaid/852eba31132f70ba.dark.svg deleted file mode 100644 index ab1fb6ae0..000000000 --- a/docs/static/mermaid/852eba31132f70ba.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Plan

ErrorHandling

Trace

Compensation

Rollback

 \ No newline at end of file diff --git a/docs/static/mermaid/852eba31132f70ba.light.svg b/docs/static/mermaid/852eba31132f70ba.light.svg deleted file mode 100644 index cfb41c893..000000000 --- a/docs/static/mermaid/852eba31132f70ba.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Plan

ErrorHandling

Trace

Compensation

Rollback

 \ No newline at end of file diff --git a/docs/static/mermaid/88f38ec5e2bf4512.dark.svg b/docs/static/mermaid/88f38ec5e2bf4512.dark.svg deleted file mode 100644 index 812432752..000000000 --- a/docs/static/mermaid/88f38ec5e2bf4512.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

L4Adapters

EventBus

Orchestration

PSG

Trace

ExternalMonitors

 \ No newline at end of file diff --git a/docs/static/mermaid/88f38ec5e2bf4512.light.svg b/docs/static/mermaid/88f38ec5e2bf4512.light.svg deleted file mode 100644 index cda08d9ad..000000000 --- a/docs/static/mermaid/88f38ec5e2bf4512.light.svg +++ /dev/null @@ -1 +0,0 @@ -

L4Adapters

EventBus

Orchestration

PSG

Trace

ExternalMonitors

 \ No newline at end of file diff --git a/docs/static/mermaid/8a9b79cb83661ebe.dark.svg b/docs/static/mermaid/8a9b79cb83661ebe.dark.svg deleted file mode 100644 index b78b11f2f..000000000 --- a/docs/static/mermaid/8a9b79cb83661ebe.dark.svg +++ /dev/null @@ -1 +0,0 @@ -Event BusAction Execution LayerProject Semantic GraphValue State LayerRuntimeEvent BusAction Execution LayerProject Semantic GraphValue State LayerRuntimeloop[For each Step]Load ContextContext (status: active)Register Context nodegraph_update (node_add)Load PlanPlan (status: approved)Register Plan node + edgesgraph_update (node_add, edge_add)pipeline_stage (Plan: approved in_progress)Check dependenciesDependencies satisfiedpipeline_stage (Step: pending in_progress)Execute step actionAction resultUpdate step statusgraph_update (node_update)pipeline_stage (Step: in_progress completed)pipeline_stage (Plan: in_progress completed)Persist final state \ No newline at end of file diff --git a/docs/static/mermaid/8a9b79cb83661ebe.light.svg b/docs/static/mermaid/8a9b79cb83661ebe.light.svg deleted file mode 100644 index 987a9ac4d..000000000 --- a/docs/static/mermaid/8a9b79cb83661ebe.light.svg +++ /dev/null @@ -1 +0,0 @@ -Event BusAction Execution LayerProject Semantic GraphValue State LayerRuntimeEvent BusAction Execution LayerProject Semantic GraphValue State LayerRuntimeloop[For each Step]Load ContextContext (status: active)Register Context nodegraph_update (node_add)Load PlanPlan (status: approved)Register Plan node + edgesgraph_update (node_add, edge_add)pipeline_stage (Plan: approved in_progress)Check dependenciesDependencies satisfiedpipeline_stage (Step: pending in_progress)Execute step actionAction resultUpdate step statusgraph_update (node_update)pipeline_stage (Step: in_progress completed)pipeline_stage (Plan: in_progress completed)Persist final state \ No newline at end of file diff --git a/docs/static/mermaid/9a730e3846503302.dark.svg b/docs/static/mermaid/9a730e3846503302.dark.svg deleted file mode 100644 index 0c38e090b..000000000 --- a/docs/static/mermaid/9a730e3846503302.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id binding: Every Plan MUST reference valid context_id

owner_role links to role_id

Global trace for project-level observability

governance.lastConfirmRef: Last approval decision reference

Context Module

Plan Module

Role Module

Trace Module

Confirm Module

 \ No newline at end of file diff --git a/docs/static/mermaid/9a730e3846503302.light.svg b/docs/static/mermaid/9a730e3846503302.light.svg deleted file mode 100644 index cbf5371b4..000000000 --- a/docs/static/mermaid/9a730e3846503302.light.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id binding: Every Plan MUST reference valid context_id

owner_role links to role_id

Global trace for project-level observability

governance.lastConfirmRef: Last approval decision reference

Context Module

Plan Module

Role Module

Trace Module

Confirm Module

 \ No newline at end of file diff --git a/docs/static/mermaid/9d16c09133c9e02b.dark.svg b/docs/static/mermaid/9d16c09133c9e02b.dark.svg deleted file mode 100644 index 8bae2298e..000000000 --- a/docs/static/mermaid/9d16c09133c9e02b.dark.svg +++ /dev/null @@ -1 +0,0 @@ -Agents A,B,CEvent BusOrchestratorAgents A,B,CEvent BusOrchestratorpar[Fan-out]par[Fan-in]MAPSessionStartedMAPBroadcastSentDistribute taskMAPBroadcastReceived (A)MAPBroadcastReceived (B)MAPBroadcastReceived (C)MAPSessionCompleted \ No newline at end of file diff --git a/docs/static/mermaid/9d16c09133c9e02b.light.svg b/docs/static/mermaid/9d16c09133c9e02b.light.svg deleted file mode 100644 index 9e324e2bd..000000000 --- a/docs/static/mermaid/9d16c09133c9e02b.light.svg +++ /dev/null @@ -1 +0,0 @@ -Agents A,B,CEvent BusOrchestratorAgents A,B,CEvent BusOrchestratorpar[Fan-out]par[Fan-in]MAPSessionStartedMAPBroadcastSentDistribute taskMAPBroadcastReceived (A)MAPBroadcastReceived (B)MAPBroadcastReceived (C)MAPSessionCompleted \ No newline at end of file diff --git a/docs/static/mermaid/9d1da9da1f786fc7.dark.svg b/docs/static/mermaid/9d1da9da1f786fc7.dark.svg deleted file mode 100644 index bd3feb13c..000000000 --- a/docs/static/mermaid/9d1da9da1f786fc7.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Hub

Node A

Node B

Node C

 \ No newline at end of file diff --git a/docs/static/mermaid/9d1da9da1f786fc7.light.svg b/docs/static/mermaid/9d1da9da1f786fc7.light.svg deleted file mode 100644 index 3edda50a3..000000000 --- a/docs/static/mermaid/9d1da9da1f786fc7.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Hub

Node A

Node B

Node C

 \ No newline at end of file diff --git a/docs/static/mermaid/9d97c50127e4ff52.dark.svg b/docs/static/mermaid/9d97c50127e4ff52.dark.svg deleted file mode 100644 index 6d68232cc..000000000 --- a/docs/static/mermaid/9d97c50127e4ff52.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Start

Pause

Resume

Finish

Abort

Abandon

draft

active

suspended

completed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/9d97c50127e4ff52.light.svg b/docs/static/mermaid/9d97c50127e4ff52.light.svg deleted file mode 100644 index 829e31bba..000000000 --- a/docs/static/mermaid/9d97c50127e4ff52.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Start

Pause

Resume

Finish

Abort

Abandon

draft

active

suspended

completed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/9df2eaa43052bdf9.dark.svg b/docs/static/mermaid/9df2eaa43052bdf9.dark.svg deleted file mode 100644 index f0c7c38a7..000000000 --- a/docs/static/mermaid/9df2eaa43052bdf9.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Start Execution

All Segments Done

Critical Failure

User Cancels

Abort Before Start

pending

running

completed

failed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/9df2eaa43052bdf9.light.svg b/docs/static/mermaid/9df2eaa43052bdf9.light.svg deleted file mode 100644 index 5b9cc5c91..000000000 --- a/docs/static/mermaid/9df2eaa43052bdf9.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Start Execution

All Segments Done

Critical Failure

User Cancels

Abort Before Start

pending

running

completed

failed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/a3553a40a5e0cef2.dark.svg b/docs/static/mermaid/a3553a40a5e0cef2.dark.svg deleted file mode 100644 index b69d02bd6..000000000 --- a/docs/static/mermaid/a3553a40a5e0cef2.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Plan: proposed

Confirm: create request

User: approve/reject

Confirm: decided

Plan: status update

Trace: record decision

Learning: capture sample

 \ No newline at end of file diff --git a/docs/static/mermaid/a3553a40a5e0cef2.light.svg b/docs/static/mermaid/a3553a40a5e0cef2.light.svg deleted file mode 100644 index 9de79bf46..000000000 --- a/docs/static/mermaid/a3553a40a5e0cef2.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Plan: proposed

Confirm: create request

User: approve/reject

Confirm: decided

Plan: status update

Trace: record decision

Learning: capture sample

 \ No newline at end of file diff --git a/docs/static/mermaid/a82ad6d1de57acb9.dark.svg b/docs/static/mermaid/a82ad6d1de57acb9.dark.svg deleted file mode 100644 index 943e7eab0..000000000 --- a/docs/static/mermaid/a82ad6d1de57acb9.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id

context_id

plan_id

plan_id

approval decision

role_id

tool references

Context
Root Scope

Plan
Executable Steps

Dialog
Conversations

Confirm
Approvals

Trace
Audit Log

Role
Capabilities

Extension
Tools

 \ No newline at end of file diff --git a/docs/static/mermaid/a82ad6d1de57acb9.light.svg b/docs/static/mermaid/a82ad6d1de57acb9.light.svg deleted file mode 100644 index 7c66e9e46..000000000 --- a/docs/static/mermaid/a82ad6d1de57acb9.light.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id

context_id

plan_id

plan_id

approval decision

role_id

tool references

Context
Root Scope

Plan
Executable Steps

Dialog
Conversations

Confirm
Approvals

Trace
Audit Log

Role
Capabilities

Extension
Tools

 \ No newline at end of file diff --git a/docs/static/mermaid/a91d9bc3493e7f5a.dark.svg b/docs/static/mermaid/a91d9bc3493e7f5a.dark.svg deleted file mode 100644 index 2f873857d..000000000 --- a/docs/static/mermaid/a91d9bc3493e7f5a.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Collab

Coordination

Dialog

Network

Role

MAPProfile

 \ No newline at end of file diff --git a/docs/static/mermaid/a91d9bc3493e7f5a.light.svg b/docs/static/mermaid/a91d9bc3493e7f5a.light.svg deleted file mode 100644 index ea7d9a2fb..000000000 --- a/docs/static/mermaid/a91d9bc3493e7f5a.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Collab

Coordination

Dialog

Network

Role

MAPProfile

 \ No newline at end of file diff --git a/docs/static/mermaid/ab48cd9eb15944b2.dark.svg b/docs/static/mermaid/ab48cd9eb15944b2.dark.svg deleted file mode 100644 index 9ac7ec7c0..000000000 --- a/docs/static/mermaid/ab48cd9eb15944b2.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Generic Schema

Specific Schemas

graph-update-event

pipeline-stage-event

runtime-execution-event

event-core

graph_update

pipeline_stage

runtime_execution

intent

delta_intent

methodology

reasoning_graph

impact_analysis

compensation_plan

import_process

cost_budget

external_integration

 \ No newline at end of file diff --git a/docs/static/mermaid/ab48cd9eb15944b2.light.svg b/docs/static/mermaid/ab48cd9eb15944b2.light.svg deleted file mode 100644 index 29dc29d50..000000000 --- a/docs/static/mermaid/ab48cd9eb15944b2.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Generic Schema

Specific Schemas

graph-update-event

pipeline-stage-event

runtime-execution-event

event-core

graph_update

pipeline_stage

runtime_execution

intent

delta_intent

methodology

reasoning_graph

impact_analysis

compensation_plan

import_process

cost_budget

external_integration

 \ No newline at end of file diff --git a/docs/static/mermaid/ac41416d7498f164.dark.svg b/docs/static/mermaid/ac41416d7498f164.dark.svg deleted file mode 100644 index 60ab785c7..000000000 --- a/docs/static/mermaid/ac41416d7498f164.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Trace

Observability

EventFamilies

W3CTraceContext

ExternalSystems

 \ No newline at end of file diff --git a/docs/static/mermaid/ac41416d7498f164.light.svg b/docs/static/mermaid/ac41416d7498f164.light.svg deleted file mode 100644 index 22bb46ab5..000000000 --- a/docs/static/mermaid/ac41416d7498f164.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Trace

Observability

EventFamilies

W3CTraceContext

ExternalSystems

 \ No newline at end of file diff --git a/docs/static/mermaid/add665e10c0bdbf5.dark.svg b/docs/static/mermaid/add665e10c0bdbf5.dark.svg deleted file mode 100644 index 11e78561f..000000000 --- a/docs/static/mermaid/add665e10c0bdbf5.dark.svg +++ /dev/null @@ -1 +0,0 @@ -EventBusTracePlanEventBusTracePlanPlan createdPlan approvedStep executionloop[For each step]Plan completedgraph_update (plan_created)Persist eventpipeline_stage (plan_approved)Persist eventpipeline_stage (step_started)Persist eventruntime_execution (llm_call)Persist eventpipeline_stage (step_completed)Persist eventgraph_update (step_status_changed)Persist eventpipeline_stage (plan_completed)Persist event \ No newline at end of file diff --git a/docs/static/mermaid/add665e10c0bdbf5.light.svg b/docs/static/mermaid/add665e10c0bdbf5.light.svg deleted file mode 100644 index ed5b8cd06..000000000 --- a/docs/static/mermaid/add665e10c0bdbf5.light.svg +++ /dev/null @@ -1 +0,0 @@ -EventBusTracePlanEventBusTracePlanPlan createdPlan approvedStep executionloop[For each step]Plan completedgraph_update (plan_created)Persist eventpipeline_stage (plan_approved)Persist eventpipeline_stage (step_started)Persist eventruntime_execution (llm_call)Persist eventpipeline_stage (step_completed)Persist eventgraph_update (step_status_changed)Persist eventpipeline_stage (plan_completed)Persist event \ No newline at end of file diff --git a/docs/static/mermaid/b985fd791fbcb213.dark.svg b/docs/static/mermaid/b985fd791fbcb213.dark.svg deleted file mode 100644 index 290f543f2..000000000 --- a/docs/static/mermaid/b985fd791fbcb213.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Root Agent / Human

Agent A

Agent B

Agent C

 \ No newline at end of file diff --git a/docs/static/mermaid/b985fd791fbcb213.light.svg b/docs/static/mermaid/b985fd791fbcb213.light.svg deleted file mode 100644 index f6bd9e111..000000000 --- a/docs/static/mermaid/b985fd791fbcb213.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Root Agent / Human

Agent A

Agent B

Agent C

 \ No newline at end of file diff --git a/docs/static/mermaid/bbea2c23ef5c7672.dark.svg b/docs/static/mermaid/bbea2c23ef5c7672.dark.svg deleted file mode 100644 index cd81ccbe8..000000000 --- a/docs/static/mermaid/bbea2c23ef5c7672.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Node A

Node B

Node C

Node D

 \ No newline at end of file diff --git a/docs/static/mermaid/bbea2c23ef5c7672.light.svg b/docs/static/mermaid/bbea2c23ef5c7672.light.svg deleted file mode 100644 index 7d70a80cf..000000000 --- a/docs/static/mermaid/bbea2c23ef5c7672.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Node A

Node B

Node C

Node D

 \ No newline at end of file diff --git a/docs/static/mermaid/bc65d25db4e24586.dark.svg b/docs/static/mermaid/bc65d25db4e24586.dark.svg deleted file mode 100644 index d3f0b4cfd..000000000 --- a/docs/static/mermaid/bc65d25db4e24586.dark.svg +++ /dev/null @@ -1 +0,0 @@ -TracePlanAgent2Agent1CollabOrchestratorTracePlanAgent2Agent1CollabOrchestratorpar[Parallel Execution]Create sessionJoin sessionJoin sessionCreate collaborative planAssign step 1Assign step 2Execute step 1Execute step 2Report completionEnd session \ No newline at end of file diff --git a/docs/static/mermaid/bc65d25db4e24586.light.svg b/docs/static/mermaid/bc65d25db4e24586.light.svg deleted file mode 100644 index 4169ff7f1..000000000 --- a/docs/static/mermaid/bc65d25db4e24586.light.svg +++ /dev/null @@ -1 +0,0 @@ -TracePlanAgent2Agent1CollabOrchestratorTracePlanAgent2Agent1CollabOrchestratorpar[Parallel Execution]Create sessionJoin sessionJoin sessionCreate collaborative planAssign step 1Assign step 2Execute step 1Execute step 2Report completionEnd session \ No newline at end of file diff --git a/docs/static/mermaid/beaf633e2a40766b.dark.svg b/docs/static/mermaid/beaf633e2a40766b.dark.svg deleted file mode 100644 index e2f9d1048..000000000 --- a/docs/static/mermaid/beaf633e2a40766b.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Start Dialog

Pause

Resume

End Normally

Abort

Abort

active

paused

completed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/beaf633e2a40766b.light.svg b/docs/static/mermaid/beaf633e2a40766b.light.svg deleted file mode 100644 index c15408407..000000000 --- a/docs/static/mermaid/beaf633e2a40766b.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Start Dialog

Pause

Resume

End Normally

Abort

Abort

active

paused

completed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/c3da52705df75d92.dark.svg b/docs/static/mermaid/c3da52705df75d92.dark.svg deleted file mode 100644 index 311b08526..000000000 --- a/docs/static/mermaid/c3da52705df75d92.dark.svg +++ /dev/null @@ -1 +0,0 @@ -HumanConfirmPolicyAgentHumanConfirmPolicyAgentalt[Approved][Rejected]Request actionCheck rulesRequires approvalCreate requestNotifyApprove/RejectDecisionExecute actionAbort action \ No newline at end of file diff --git a/docs/static/mermaid/c3da52705df75d92.light.svg b/docs/static/mermaid/c3da52705df75d92.light.svg deleted file mode 100644 index 40f20dbab..000000000 --- a/docs/static/mermaid/c3da52705df75d92.light.svg +++ /dev/null @@ -1 +0,0 @@ -HumanConfirmPolicyAgentHumanConfirmPolicyAgentalt[Approved][Rejected]Request actionCheck rulesRequires approvalCreate requestNotifyApprove/RejectDecisionExecute actionAbort action \ No newline at end of file diff --git a/docs/static/mermaid/cfad987f3eb3f443.dark.svg b/docs/static/mermaid/cfad987f3eb3f443.dark.svg deleted file mode 100644 index 82a165229..000000000 --- a/docs/static/mermaid/cfad987f3eb3f443.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id MUST reference valid Context

participant.role_id references Role

Collaboration produces coordinated Plans

Session execution captured in Trace

Collab Module

Context Module

Role Module

Plan Module

Trace Module

 \ No newline at end of file diff --git a/docs/static/mermaid/cfad987f3eb3f443.light.svg b/docs/static/mermaid/cfad987f3eb3f443.light.svg deleted file mode 100644 index ae422a1bb..000000000 --- a/docs/static/mermaid/cfad987f3eb3f443.light.svg +++ /dev/null @@ -1 +0,0 @@ -

context_id MUST reference valid Context

participant.role_id references Role

Collaboration produces coordinated Plans

Session execution captured in Trace

Collab Module

Context Module

Role Module

Plan Module

Trace Module

 \ No newline at end of file diff --git a/docs/static/mermaid/d03a6dea7f89f987.dark.svg b/docs/static/mermaid/d03a6dea7f89f987.dark.svg deleted file mode 100644 index 9d85979c6..000000000 --- a/docs/static/mermaid/d03a6dea7f89f987.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Activate

Suspend

Resume

Archive

Close

Force Close

Abandon

draft

active

suspended

archived

closed

 \ No newline at end of file diff --git a/docs/static/mermaid/d03a6dea7f89f987.light.svg b/docs/static/mermaid/d03a6dea7f89f987.light.svg deleted file mode 100644 index 566c076ab..000000000 --- a/docs/static/mermaid/d03a6dea7f89f987.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Activate

Suspend

Resume

Archive

Close

Force Close

Abandon

draft

active

suspended

archived

closed

 \ No newline at end of file diff --git a/docs/static/mermaid/d24923eeabd17e96.dark.svg b/docs/static/mermaid/d24923eeabd17e96.dark.svg deleted file mode 100644 index c05f11fc2..000000000 --- a/docs/static/mermaid/d24923eeabd17e96.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Confirm.approved

Confirm.rejected

All steps completed

Critical step failed

User abort

draft

proposed

approved

in_progress

completed

failed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/d24923eeabd17e96.light.svg b/docs/static/mermaid/d24923eeabd17e96.light.svg deleted file mode 100644 index a52d08d61..000000000 --- a/docs/static/mermaid/d24923eeabd17e96.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Confirm.approved

Confirm.rejected

All steps completed

Critical step failed

User abort

draft

proposed

approved

in_progress

completed

failed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/d460de40c79a91ba.dark.svg b/docs/static/mermaid/d460de40c79a91ba.dark.svg deleted file mode 100644 index 48b9bc380..000000000 --- a/docs/static/mermaid/d460de40c79a91ba.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Draft

Review

Accepted

Rejected

Final

Deferred

Replaced

 \ No newline at end of file diff --git a/docs/static/mermaid/d460de40c79a91ba.light.svg b/docs/static/mermaid/d460de40c79a91ba.light.svg deleted file mode 100644 index 2f4d75d4d..000000000 --- a/docs/static/mermaid/d460de40c79a91ba.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Draft

Review

Accepted

Rejected

Final

Deferred

Replaced

 \ No newline at end of file diff --git a/docs/static/mermaid/d7ebb8b48e29e83b.dark.svg b/docs/static/mermaid/d7ebb8b48e29e83b.dark.svg deleted file mode 100644 index dfc40d852..000000000 --- a/docs/static/mermaid/d7ebb8b48e29e83b.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Trace root

root_span

segment_1: Step 1 execution

segment_2: Step 2 execution

segment_3: Step 3 execution

sub_segment_1a: LLM call

sub_segment_1b: Tool call

sub_segment_2a: File write

 \ No newline at end of file diff --git a/docs/static/mermaid/d7ebb8b48e29e83b.light.svg b/docs/static/mermaid/d7ebb8b48e29e83b.light.svg deleted file mode 100644 index 4d56bdcac..000000000 --- a/docs/static/mermaid/d7ebb8b48e29e83b.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Trace root

root_span

segment_1: Step 1 execution

segment_2: Step 2 execution

segment_3: Step 3 execution

sub_segment_1a: LLM call

sub_segment_1b: Tool call

sub_segment_2a: File write

 \ No newline at end of file diff --git a/docs/static/mermaid/d99a12c6ff5589fb.dark.svg b/docs/static/mermaid/d99a12c6ff5589fb.dark.svg deleted file mode 100644 index ebca92368..000000000 --- a/docs/static/mermaid/d99a12c6ff5589fb.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

No

Yes

Yes

No

Yes

No

Yes

Tie

Conflict Detected

Same Rank?

Higher Rank Wins

Policy Allows Voting?

Voting

LWW Enabled?

Latest Timestamp Wins

Escalate to Human

Majority?

Apply Winner

 \ No newline at end of file diff --git a/docs/static/mermaid/d99a12c6ff5589fb.light.svg b/docs/static/mermaid/d99a12c6ff5589fb.light.svg deleted file mode 100644 index 85beec0ed..000000000 --- a/docs/static/mermaid/d99a12c6ff5589fb.light.svg +++ /dev/null @@ -1 +0,0 @@ -

No

Yes

Yes

No

Yes

No

Yes

Tie

Conflict Detected

Same Rank?

Higher Rank Wins

Policy Allows Voting?

Voting

LWW Enabled?

Latest Timestamp Wins

Escalate to Human

Majority?

Apply Winner

 \ No newline at end of file diff --git a/docs/static/mermaid/f676ffe4e91ae2bd.dark.svg b/docs/static/mermaid/f676ffe4e91ae2bd.dark.svg deleted file mode 100644 index dc6aab4ef..000000000 --- a/docs/static/mermaid/f676ffe4e91ae2bd.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Level 1: Architect

Level 2: Coder A

Level 2: Coder B

Level 3: Tester

 \ No newline at end of file diff --git a/docs/static/mermaid/f676ffe4e91ae2bd.light.svg b/docs/static/mermaid/f676ffe4e91ae2bd.light.svg deleted file mode 100644 index 806d9b6ba..000000000 --- a/docs/static/mermaid/f676ffe4e91ae2bd.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Level 1: Architect

Level 2: Coder A

Level 2: Coder B

Level 3: Tester

 \ No newline at end of file diff --git a/docs/static/mermaid/f67a3e73ee3b214d.dark.svg b/docs/static/mermaid/f67a3e73ee3b214d.dark.svg deleted file mode 100644 index 7038c533f..000000000 --- a/docs/static/mermaid/f67a3e73ee3b214d.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Authority Hierarchy

Defines Truth

Defines Truth

Explains

Layer 1: Protocol Gov

Layer 2: Docs Projection

Layer 3: Website Projection

 \ No newline at end of file diff --git a/docs/static/mermaid/f67a3e73ee3b214d.light.svg b/docs/static/mermaid/f67a3e73ee3b214d.light.svg deleted file mode 100644 index 347b4c640..000000000 --- a/docs/static/mermaid/f67a3e73ee3b214d.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Authority Hierarchy

Defines Truth

Defines Truth

Explains

Layer 1: Protocol Gov

Layer 2: Docs Projection

Layer 3: Website Projection

 \ No newline at end of file diff --git a/docs/static/mermaid/fe61fa5dc7c27657.dark.svg b/docs/static/mermaid/fe61fa5dc7c27657.dark.svg deleted file mode 100644 index d9da6a3c9..000000000 --- a/docs/static/mermaid/fe61fa5dc7c27657.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Submit for Review

User Approves (Confirm)

User Requests Changes

Start Execution

All Steps Done

Critical Step Failed

User Cancels

Abandon

draft

proposed

approved

in_progress

completed

failed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/fe61fa5dc7c27657.light.svg b/docs/static/mermaid/fe61fa5dc7c27657.light.svg deleted file mode 100644 index dd3c8dbed..000000000 --- a/docs/static/mermaid/fe61fa5dc7c27657.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Create

Submit for Review

User Approves (Confirm)

User Requests Changes

Start Execution

All Steps Done

Critical Step Failed

User Cancels

Abandon

draft

proposed

approved

in_progress

completed

failed

cancelled

 \ No newline at end of file diff --git a/docs/static/mermaid/fe7aff159efce728.dark.svg b/docs/static/mermaid/fe7aff159efce728.dark.svg deleted file mode 100644 index 6302132f5..000000000 --- a/docs/static/mermaid/fe7aff159efce728.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Sequential pipeline

Peer review

Voting/consensus

Independent parallel

Fan-out announcement

Multi-Agent Task

Task Structure?

orchestrated

pair

round_robin

swarm

broadcast

 \ No newline at end of file diff --git a/docs/static/mermaid/fe7aff159efce728.light.svg b/docs/static/mermaid/fe7aff159efce728.light.svg deleted file mode 100644 index fae00c5fd..000000000 --- a/docs/static/mermaid/fe7aff159efce728.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Sequential pipeline

Peer review

Voting/consensus

Independent parallel

Fan-out announcement

Multi-Agent Task

Task Structure?

orchestrated

pair

round_robin

swarm

broadcast

 \ No newline at end of file diff --git a/docs/static/mermaid/ff768c08ae1fcb6d.dark.svg b/docs/static/mermaid/ff768c08ae1fcb6d.dark.svg deleted file mode 100644 index 648c2ba78..000000000 --- a/docs/static/mermaid/ff768c08ae1fcb6d.dark.svg +++ /dev/null @@ -1 +0,0 @@ -

Confirm

LearningFeedback

Trace

LearningSamples

MLPipelines

 \ No newline at end of file diff --git a/docs/static/mermaid/ff768c08ae1fcb6d.light.svg b/docs/static/mermaid/ff768c08ae1fcb6d.light.svg deleted file mode 100644 index aac2900da..000000000 --- a/docs/static/mermaid/ff768c08ae1fcb6d.light.svg +++ /dev/null @@ -1 +0,0 @@ -

Confirm

LearningFeedback

Trace

LearningSamples

MLPipelines

 \ No newline at end of file diff --git a/governance/01-constitutional/legal/LEGAL_NOTICE.md b/governance/01-constitutional/legal/LEGAL_NOTICE.md index 3d8a30f69..fe398cb7f 100644 --- a/governance/01-constitutional/legal/LEGAL_NOTICE.md +++ b/governance/01-constitutional/legal/LEGAL_NOTICE.md @@ -2,11 +2,11 @@ ## Footer Short (EN) -© 2026 Jearon Wong. Licensed under the Apache License, Version 2.0. Governed by MPGC. +© 2026 Jearon Wong Licensed under the Apache License, Version 2.0. Governed by MPGC. ## Footer Long (EN) -© 2026 Jearon Wong. +© 2026 Jearon Wong This project is licensed under the Apache License, Version 2.0. Governance: MPLP Protocol Governance Committee (MPGC). No certification, endorsement, or ranking is provided. @@ -25,7 +25,3 @@ No execution hosting. No certification. Evidence adjudication only. Any changes to legal text require governance review. Version changes logged in governance/04-records/ directory. - -## Migration Notice - -Historical records may reference Bangshi Beijing Network Technology Co., Ltd. as a prior project/legal identity. Active MPLP copyright notices are maintained under Jearon Wong from this notice forward. diff --git a/governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md b/governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md deleted file mode 100644 index 31a9f5e91..000000000 --- a/governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "CHECKLIST-SDK-RELEASE" ---- - -# SDK Release Checklist - -**Document ID**: CHECKLIST-SDK-RELEASE -**Status**: Frozen (v1.0) -**Authority**: MPGC -**Reference**: METHOD-SDKR-09 - ---- - -## Usage - -This checklist follows the **8-Stage Release Readiness Framework** defined in METHOD-SDKR-09. - -- All items MUST be YES -- Any NO = **Release Blocked** -- Stage 4 has **NO EXCEPTIONS** regardless of change size - ---- - -## Stage 0: Release Intent Declaration - -**Reference**: [METHOD-SDKR-09 §5.1](./METHOD-SDKR-09_RELEASE_READINESS.md) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 0.1 | `RELEASE_INTENT.md` created? | [ ] | -| 0.2 | All packages to release listed? | [ ] | -| 0.3 | Version change declared for each package (from → to)? | [ ] | -| 0.4 | Bump reason stated for each package? | [ ] | - -**Evidence**: `artifacts/release/RELEASE_INTENT.md` - ---- - -## Stage 1: Version Legitimacy Validation - -**Reference**: [METHOD-SDKR-09 §5.2](./METHOD-SDKR-09_RELEASE_READINESS.md), [METHOD-SDKR-03](./METHOD-SDKR-03_VERSIONING_LAW.md) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 1.1 | Each package's bump type declared (PATCH/MINOR)? | [ ] | -| 1.2 | MINOR bumps have explicit capability description? | [ ] | -| 1.3 | No "error correction" bumps to MINOR? | [ ] | -| 1.4 | Registry versions fetched to confirm bump target? | [ ] | -| 1.5 | All versions bumped to (registry_latest + 1)? | [ ] | - -**Evidence**: `artifacts/release/VERSION_CHANGE_JUSTIFICATION.md` - ---- - -## Stage 2: Dependency Integrity Check - -**Reference**: [METHOD-SDKR-09 §5.3](./METHOD-SDKR-09_RELEASE_READINESS.md) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 2.1 | All package dependencies verified? | [ ] | -| 2.2 | No implicit cross-package breakage? | [ ] | -| 2.3 | Internal `file:` dependencies resolved for publish? | [ ] | - -**Evidence**: `artifacts/release/DEPENDENCY_CHECK.md` - ---- - -## Stage 3: Derivation & Content Verification - -**Reference**: [METHOD-SDKR-02](./METHOD-SDKR-02_DERIVATION_RULES.md), [METHOD-SDKR-04](./METHOD-SDKR-04_PACKAGE_CONTENT_SPEC.md) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 3.1 | `DERIVATION_PROOF.yaml` present for each package? | [ ] | -| 3.2 | Schema derivation traceable? | [ ] | -| 3.3 | Forbidden content scan PASS? | [ ] | -| 3.4 | Required files present (dist/, README.md, LICENSE)? | [ ] | -| 3.5 | No governance/internal files in package? | [ ] | - ---- - -## Stage 4: Pre-Publish Isolated Verification (MANDATORY) - -**Reference**: [METHOD-SDKR-09 §5.5](./METHOD-SDKR-09_RELEASE_READINESS.md) - -> ⚠️ **No release may bypass this stage, regardless of change size or bump type.** - -### npm Packages - -| # | Check | YES/NO | -|:---|:---|:---:| -| 4.1 | `npm pack` executed for each package? | [ ] | -| 4.2 | Tarball installed in clean temp directory? | [ ] | -| 4.3 | `require('@mplp/pkg')` succeeds? | [ ] | -| 4.4 | Type definitions present (.d.ts)? | [ ] | -| 4.5 | Exports verified? | [ ] | - -### PyPI Packages - -| # | Check | YES/NO | -|:---|:---|:---:| -| 4.6 | `python -m build` executed? | [ ] | -| 4.7 | Wheel installed locally? | [ ] | -| 4.8 | `import mplp` succeeds? | [ ] | -| 4.9 | Version matches expected? | [ ] | - -**Evidence**: `artifacts/release/ISOLATED_VERIFICATION_REPORT.md` - ---- - -## Stage 5: Documentation Linkage - -**Reference**: [METHOD-SDKR-09 §5.6](./METHOD-SDKR-09_RELEASE_READINESS.md) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 5.1 | `CHANGELOG.md` updated with new versions? | [ ] | -| 5.2 | Package README updated (if behavior changed)? | [ ] | -| 5.3 | `RELEASE_BUNDLE_MANIFEST.json` updated? | [ ] | -| 5.4 | Copyright year current (© 2026)? | [ ] | -| 5.5 | DERIVATION_PROOF.yaml versions aligned? | [ ] | - ---- - -## Stage 6: Release Gate (Final Approval) - -**Reference**: [METHOD-SDKR-09 §5.7](./METHOD-SDKR-09_RELEASE_READINESS.md) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 6.1 | All Stages 0-5 PASS? | [ ] | -| 6.2 | All evidence artifacts present? | [ ] | -| 6.3 | No unexplained version jumps? | [ ] | -| 6.4 | Release approved by responsible party? | [ ] | - -**Decision**: [ ] APPROVED / [ ] REJECTED - -If REJECTED, return to failed stage and restart. - ---- - -## Stage 7: Publish Execution - -**Reference**: [METHOD-SDKR-09 §5.8](./METHOD-SDKR-09_RELEASE_READINESS.md) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 7.1 | Stage 6 approved? | [ ] | -| 7.2 | npm login authenticated? | [ ] | -| 7.3 | All npm PUBLIC packages published? | [ ] | -| 7.4 | PyPI authentication configured? | [ ] | -| 7.5 | All PyPI PUBLIC packages published? | [ ] | -| 7.6 | Publish log recorded? | [ ] | - ---- - -## Stage 8: Post-Publish Verification - -**Reference**: [METHOD-SDKR-06](./METHOD-SDKR-06_POST_INSTALL_VERIFICATION.md) - -### npm Verification (from registry) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 8.1 | Clean `npm install @mplp/*` succeeds? | [ ] | -| 8.2 | Import succeeds for each package? | [ ] | -| 8.3 | Published version matches expected? | [ ] | - -### PyPI Verification (from registry) - -| # | Check | YES/NO | -|:---|:---|:---:| -| 8.4 | Clean `pip install mplp-sdk` succeeds? | [ ] | -| 8.5 | Import succeeds? | [ ] | -| 8.6 | Published version matches expected? | [ ] | - ---- - -## Post-Publish Actions - -| # | Check | YES/NO | -|:---|:---|:---:| -| 9.1 | `npm deprecate` executed for deprecated packages? | [ ] | -| 9.2 | VERSION_REGISTRY.yaml updated? | [ ] | -| 9.3 | Release artifacts archived? | [ ] | - ---- - -## Sign-off - -| Role | Name | Date | Signature | -|:---|:---|:---|:---| -| Release Engineer | | | | -| MPGC Representative | | | | - ---- - -## Automatic Rejection Conditions - -| Condition | Reference | Ruling | -|:---|:---|:---:| -| Missing RELEASE_INTENT.md | SDKR-09 §5.1 | **REJECT** | -| Illegitimate version bump | SDKR-09 §5.2 | **REJECT** | -| MINOR bump for error correction | SDKR-03, SDKR-09 | **REJECT** | -| Stage 4 verification failure | SDKR-09 §5.5 | **REJECT** | -| Stage 4 bypass attempt | SDKR-09 §3 | **REJECT** | -| Missing evidence artifacts | SDKR-09 §6 | **REJECT** | -| Stage 6 not approved | SDKR-09 §5.7 | **REJECT** | - ---- - -**Document Status**: Governance Checklist -**References**: METHOD-SDKR-01 through SDKR-09 diff --git a/governance/03-distribution/sdk/METHOD-SDKR-01_RELEASE_PIPELINE.md b/governance/03-distribution/sdk/METHOD-SDKR-01_RELEASE_PIPELINE.md deleted file mode 100644 index 5e5753a72..000000000 --- a/governance/03-distribution/sdk/METHOD-SDKR-01_RELEASE_PIPELINE.md +++ /dev/null @@ -1,121 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "METHOD-SDKR-01_RELEASE_PIPELINE" ---- - -# METHOD-SDKR-01: Release Pipeline - -**Document ID**: METHOD-SDKR-01 -**Status**: Draft -**Authority**: MPGC -**Effective**: v1.0.0 - ---- - -## 1. Purpose - -This method defines the mandatory pipeline stages for SDK release. - -All stages MUST be executed in order. No stage may be skipped. - ---- - -## 2. Pipeline Stages - -### Stage 1: Precondition Check - -**Input**: Evidence Baseline freeze record -**Output**: Precondition verification report -**Failure Condition**: Any Phase 0-7 prerequisite not met -**Skip Allowed**: NO - -### Stage 2: Derivation Build - -**Input**: Truth Source schemas, verified code generators -**Output**: Generated SDK artifacts -**Failure Condition**: Generator fails or produces non-deterministic output -**Skip Allowed**: NO - -### Stage 3: Package Assembly - -**Input**: Generated artifacts, package configuration -**Output**: Assembled package (npm tarball / Python wheel) -**Failure Condition**: Package validation fails -**Skip Allowed**: NO - -### Stage 4: Manifest Binding - -**Input**: Package, Evidence Baseline metadata -**Output**: Package with embedded Release Manifest -**Failure Condition**: Manifest incomplete or hash mismatch -**Skip Allowed**: NO - -### Stage 4.5: Multi-Package Gate (METHOD-SDKR-08) - -**Input**: All packages in workspace -**Output**: Publish Set, Gate Report, Bundle Manifest -**Failure Condition**: Any gate check fails (see METHOD-SDKR-08 §6) -**Skip Allowed**: NO - -This stage MUST execute: -- npm Publish Gate (`gate-publish-set.mjs`) -- PyPI Publish Gate (`gate_pypi_set`) -- Generate `RELEASE_BUNDLE_MANIFEST.json` - -**Hash Evidence (§6.6)**: This stage MUST compute and record SHA-256 hashes for all Python artifacts (wheel + sdist) in DERIVATION_PROOF.yaml. - -### Stage 5: Registry Publish - -**Input**: Signed package with manifest -**Output**: Published package on npm/PyPI -**Failure Condition**: Registry rejection or network failure -**Skip Allowed**: NO - -### Stage 6: Post-Install Verification - -**Input**: Published package registry URL -**Output**: Verification report from clean environment -**Failure Condition**: Import fails or enum mismatch -**Skip Allowed**: NO - -### Stage 7: Release Seal - -**Input**: All stage reports -**Output**: Release record in governance -**Failure Condition**: Any previous stage not PASS -**Skip Allowed**: NO - ---- - -## 3. Required Artifacts per Pipeline Stage - -Each stage MUST produce the following artifacts. Missing artifact = Stage FAIL. - -| Stage | Required Artifacts | Missing = | -|:---|:---|:---:| -| Precondition Check | Phase verification report, Evidence Baseline reference | FAIL | -| Derivation Build | Generated types (.ts/.py), enum literals, validators | FAIL | -| Package Assembly | package.json/pyproject.toml, versioned README, LICENSE | FAIL | -| Manifest Binding | RELEASE_MANIFEST.json with all mandatory fields | FAIL | -| Registry Publish | Published package URL, registry confirmation | FAIL | -| Post-Install Verification | Clean environment install report, enum count verification | FAIL | -| Release Seal | Signed release record with all stage references | FAIL | - ---- - -## 4. Gate Enforcement - -If any stage fails: -- Pipeline MUST halt -- Incident record MUST be created -- Release MUST NOT proceed - ---- - -**Document Status**: Governance Method -**Supersedes**: None -**References**: README.md, METHOD-SDKR-05 diff --git a/governance/03-distribution/sdk/METHOD-SDKR-05_RELEASE_MANIFEST.md b/governance/03-distribution/sdk/METHOD-SDKR-05_RELEASE_MANIFEST.md deleted file mode 100644 index ea081ee2d..000000000 --- a/governance/03-distribution/sdk/METHOD-SDKR-05_RELEASE_MANIFEST.md +++ /dev/null @@ -1,142 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "METHOD-SDKR-05_RELEASE_MANIFEST" ---- - -# METHOD-SDKR-05: Release Manifest - -**Document ID**: METHOD-SDKR-05 -**Status**: Draft -**Authority**: MPGC -**Effective**: v1.0.0 - ---- - -## 1. Purpose - -This method defines the mandatory Release Manifest that MUST be included in every SDK package. - ---- - -## 2. Manifest Requirement - -- SDK release WITHOUT manifest = **INVALID** -- Manifest MUST be part of the released package -- Manifest MUST NOT be generated post-release - ---- - -## 3. Manifest Location - -| SDK | Path | -|:---|:---| -| TypeScript | `RELEASE_MANIFEST.json` (package root) | -| Python | `RELEASE_MANIFEST.json` (package root) | - -### 3.1 Bundle-Level Manifest (METHOD-SDKR-08) - -In multi-package mode, a **Release Bundle Manifest** is also required: - -| Artifact | Location | -|:---|:---| -| `RELEASE_BUNDLE_MANIFEST.json` | `artifacts/release/` | - -The Bundle Manifest records all packages in a coordinated release and references each package's individual proof. See METHOD-SDKR-08 §4 (V-SYNC-03) for details. - ---- - -## 4. Mandatory Fields - -| Field | Type | Description | -|:---|:---|:---| -| `protocol_version` | string | MPLP protocol version | -| `evidence_baseline_tag` | string | Git tag of frozen baseline | -| `truth_source_bundle_hash` | string | SHA256 of Truth Source bundle | -| `sdk_package_name` | string | Package name (e.g., `@mplp/sdk-ts` or `mplp-sdk`) | -| `sdk_package_version` | string | Semantic version | -| `generated_at` | string | ISO 8601 timestamp | -| `generator_version` | string | Codegen tool version | - ---- - -## 5. Example Manifest - -```json -{ - "protocol_version": "1.0.0", - "evidence_baseline_tag": "evidence-baseline-v1.0", - "truth_source_bundle_hash": "sha256:78ea3511...", - "sdk_package_name": "@mplp/sdk-ts", - "sdk_package_version": "1.0.0", - "generated_at": "2026-01-04T12:00:00Z", - "generator_version": "1.0.0" -} -``` - ---- - -## 6. Manifest Validation - -Before release, the following MUST be verified: - -| Check | Failure Action | -|:---|:---| -| Manifest exists | HALT | -| All fields present | HALT | -| Bundle hash matches current Evidence Baseline | HALT | -| Protocol version matches | HALT | - ---- - -## 7. Non-Semantic Declaration - -The manifest is **evidence**, not protocol definition. - -It does not participate in protocol semantics. - ---- - -## 8. Derivation Verification Field (Recommended) - -To prove derivation integrity, the manifest SHOULD include: - -| Field | Type | Description | -|:---|:---|:---| -| `derived_surfaces_checksum` | string | SHA256 of concatenated generated file hashes | -| `derived_schema_refs` | array | List of schema files used for derivation | - -### 8.1 Example with Derivation Fields - -```json -{ - "protocol_version": "1.0.0", - "evidence_baseline_tag": "evidence-baseline-v1.0", - "truth_source_bundle_hash": "sha256:78ea3511...", - "sdk_package_name": "@mplp/sdk-ts", - "sdk_package_version": "1.0.0", - "generated_at": "2026-01-04T12:00:00Z", - "generator_version": "1.0.0", - "derived_surfaces_checksum": "sha256:abc123...", - "derived_schema_refs": [ - "common/metadata.schema.json", - "mplp-context.schema.json", - "mplp-plan.schema.json" - ] -} -``` - -This enables post-publish verification that the SDK was derived from stated schemas. - -Source package mirrors in `packages/sources/*` are not Release Manifest units; only -public publish surfaces in `packages/npm/*` and `packages/pypi/*` receive release -manifests. - ---- - -**Document Status**: Governance Method -**Supersedes**: None -**References**: README.md, METHOD-SDKR-01 diff --git a/governance/03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md b/governance/03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md deleted file mode 100644 index ee2b50611..000000000 --- a/governance/03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md +++ /dev/null @@ -1,536 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE" ---- - -# METHOD-SDKR-08: Multi-Package Release Governance - -**Document ID**: METHOD-SDKR-08 -**Status**: Draft -**Authority**: MPGC -**Effective**: v1.0.0 - ---- - -## 1. Purpose - -This method defines governance rules for releasing multiple packages under the `@mplp/*` namespace, together with the corresponding PyPI SDK surface, as a coordinated bundle. - -It extends METHOD-SDKR-01~07 to support the multi-package monorepo release model, including the source-package mirror -> publish-surface split used in `packages/sources/*`, `packages/npm/*`, and `packages/pypi/*`. - ---- - -## 2. Package Classification - -All packages under `@mplp/*` MUST be classified into one of the following categories: - -| Category | Definition | Publish Allowed | -|:---|:---|:---:| -| `PUBLIC` | External distribution package | YES | -| `INTERNAL` | Development-time dependency | NO | -| `CI-ONLY` | CI gate tool, never published | NO | - -### 2.1 Category Enforcement - -| Category | package.json Requirements | -|:---|:---| -| `PUBLIC` | `"private": false` or absent | -| `INTERNAL` | `"private": true` | -| `CI-ONLY` | `"private": true` + `"mplp.ci_only": true` + `"mplp.publishBlocked": true` | - -### 2.2 Source Package Mirrors - -Source package mirrors are **not** Publish Set units. - -They exist to support build, workspace linking, or release preparation, and MUST NOT -be treated as public publish targets even if they share a package name with a public -surface. - -| Mirror | Role | Publish Allowed | Expected Target | -|:---|:---|:---:|:---| -| `packages/sources/sdk-ts` | Source workspace mirror | NO | `packages/npm/sdk-ts` | -| `packages/sources/sdk-py` | Source-side PyPI mirror | NO | `packages/pypi/mplp-sdk` | - ---- - -## 3. Current Package Registry - -| Package | Category | Layer | -|:---|:---|:---| -| `@mplp/core` | PUBLIC | L1 | -| `@mplp/schema` | PUBLIC | L1 | -| `@mplp/modules` | PUBLIC | L2 | -| `@mplp/coordination` | PUBLIC | L2 | -| `@mplp/conformance` | PUBLIC | L2 (Conformance Kit) | -| `@mplp/runtime-minimal` | PUBLIC | L3 | -| `@mplp/devtools` | PUBLIC | Tool | -| `@mplp/sdk-ts` | PUBLIC | Facade | -| `@mplp/integration-storage-kv` | PUBLIC | L4 | -| `@mplp/integration-storage-fs` | PUBLIC | L4 | -| `@mplp/integration-llm-http` | PUBLIC | L4 | -| `@mplp/validator` | CI-ONLY | Tool | - -### 3.1 Legacy Package - -| Package | Status | Migration | -|:---|:---|:---| -| `@mplp/compliance` | DEPRECATED | Use `@mplp/conformance` | - ---- - -## 4. Version Synchronization Rules - -### V-SYNC-01: Bundle Version Consistency - -All `@mplp/*` packages in a release bundle MUST share the same **major.minor** version. - -``` -VALID: @mplp/core@1.0.5, @mplp/schema@1.0.5, @mplp/sdk-ts@1.0.5 -INVALID: @mplp/core@1.0.5, @mplp/schema@1.1.0 -``` - -### V-SYNC-02: Facade Dependency Alignment - -The `@mplp/sdk-ts` facade package MUST depend on core packages with **exact** or **caret** version matching its own version. - -### V-SYNC-03: Bundle Manifest Required - -Every release MUST include a `RELEASE_BUNDLE_MANIFEST.json` that records: -- All packages included in the release -- Version of each package -- Dependency graph snapshot -- Evidence baseline reference - ---- - -## 5. Release Unit Definitions - -### 5.1 Package Unit - -A single `@mplp/*` package that: -- Has its own `package.json` -- Has its own `DERIVATION_PROOF.yaml` -- Passes individual package content spec (METHOD-SDKR-04) - -### 5.2 Release Bundle - -A coordinated set of Package Units that: -- Share the same major.minor version -- Reference the same Evidence Baseline -- Are released together in a single CI run - ---- - -## 6. Publish Gate Requirements - -### 6.0 Set Definitions - -| Set | Definition | -|:---|:---| -| **Workspace Set** | All packages in monorepo | -| **Source Package Set** | Source/workspace mirrors used for build and release preparation; NEVER a publish target | -| **Release Bundle Set** | Packages coordinated for this version (may include INTERNAL/CI-ONLY for verification) | -| **Publish Set** | Packages to be published to npm/PyPI (MUST be PUBLIC only) | - -Before any package publish: - -### 6.1 Package-level check (MANDATORY) - -For each package in **Publish Set**: - -| Check | Missing = | -|:---|:---:| -| `DERIVATION_PROOF.yaml` exists and validates | **FAIL** | -| Content spec (METHOD-SDKR-04) passes | **FAIL** | - -### 6.2 Bundle-level check (MANDATORY) - -| Check | Missing = | -|:---|:---:| -| Version sync rules (V-SYNC-01/02/03) pass | **FAIL** | -| `RELEASE_BUNDLE_MANIFEST.json` generated | **FAIL** | -| All packages in Publish Set are PUBLIC category | **FAIL** | - -### 6.3 Denylist check (HARD BLOCK - NO WAIVER) - -The following conditions on **Publish Set** cause immediate failure: - -| Condition | Result | -|:---|:---:| -| Any `mplp.ci_only === true` package in Publish Set | **IMMEDIATE FAIL** | -| Any `mplp.publishBlocked === true` package in Publish Set | **IMMEDIATE FAIL** | -| Any `private: true` package in Publish Set | **IMMEDIATE FAIL** | -| Any CI-ONLY or INTERNAL category package in Publish Set | **IMMEDIATE FAIL** | - -> **Note:** CI-ONLY, INTERNAL, and SOURCE-MIRROR package surfaces MAY exist in the monorepo or Release Bundle Set, but MUST NOT enter Publish Set. - -### 6.4 Automated Gate Script (REQUIRED) - -The publish pipeline MUST include an automated gate script at `scripts/semantic/gate-publish-set.mjs`: - -```javascript -// Gate: Verify Publish Set contains only PUBLIC packages -// Output: artifacts/release/publish-gate-report.json - -import { readFileSync, readdirSync, writeFileSync, mkdirSync } from 'fs'; -import { join } from 'path'; - -const PACKAGES_DIR = 'packages/npm'; -const OUTPUT_DIR = 'artifacts/release'; - -function gatePublishSet() { - const packages = readdirSync(PACKAGES_DIR, { withFileTypes: true }) - .filter(d => d.isDirectory()) - .map(d => d.name); - - const publishSet = []; - const blocked = []; - - for (const pkg of packages) { - const pkgJsonPath = join(PACKAGES_DIR, pkg, 'package.json'); - const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf8')); - - const isPrivate = pkgJson.private === true; - const isCiOnly = pkgJson.mplp?.ci_only === true; - const isPublishBlocked = pkgJson.mplp?.publishBlocked === true; - - if (isPrivate || isCiOnly || isPublishBlocked) { - blocked.push({ name: pkgJson.name, reason: { isPrivate, isCiOnly, isPublishBlocked } }); - } else { - publishSet.push({ name: pkgJson.name, version: pkgJson.version }); - } - } - - // Check for violations: blocked packages should not be in publish flow - const violations = blocked.filter(b => - process.argv.includes('--publish-all') || - process.argv.includes(b.name) - ); - - mkdirSync(OUTPUT_DIR, { recursive: true }); - - const report = { - timestamp: new Date().toISOString(), - publishSet, - blocked, - violations, - status: violations.length === 0 ? 'PASS' : 'FAIL' - }; - - writeFileSync(join(OUTPUT_DIR, 'publish-gate-report.json'), JSON.stringify(report, null, 2)); - writeFileSync(join(OUTPUT_DIR, 'publish-set.json'), JSON.stringify(publishSet, null, 2)); - - if (violations.length > 0) { - console.error('FATAL: Blocked packages in publish flow:', violations); - process.exit(1); - } - - console.log('Gate PASS. Publish Set:', publishSet.map(p => p.name).join(', ')); -} - -gatePublishSet(); -``` - -**This gate is NOT waivable. Violation = Release blocked + Incident record required.** - -### 6.5 Evidence Artifacts - -Each release MUST produce: - -| Artifact | Location | Required | -|:---|:---|:---:| -| `RELEASE_BUNDLE_MANIFEST.json` | `artifacts/release/` | YES | -| `publish-set.json` | `artifacts/release/` | YES | -| `publish-gate-report.json` | `artifacts/release/` | YES | - -### 6.6 Hash Evidence Strategy - -MPLP SDK releases produce a **cryptographically verifiable evidence bundle before publication**. - -#### 6.6.1 Pre-Publish Hash Requirements (MANDATORY) - -| Artifact Type | Hash Algorithm | Recording Location | -|:---|:---|:---| -| Python wheel (.whl) | SHA-256 | `DERIVATION_PROOF.yaml` | -| Python sdist (.tar.gz) | SHA-256 | `DERIVATION_PROOF.yaml` | -| npm tarball | Registry SSRI | Implicit (registry contract) | - -#### 6.6.2 Hash Verification Points - -| Phase | Verification | Required | -|:---|:---|:---:| -| Build | Compute artifact hash | **YES** | -| Gate | Verify hash recorded | **YES** | -| Bundle | Include in manifest | **YES** | -| Post-Publish | Re-validate from registry | **NO** | - -#### 6.6.3 Registry Immutability Contract - -Once published, packages are **immutable by registry contract**: - -- npm: Cannot overwrite published version -- PyPI: Cannot overwrite published version - -Post-publish hash re-validation is **explicitly not required** in v1.0. - -#### 6.6.4 Out of Scope (v1.0) - -The following are **NOT required** in v1.0: - -- GPG signing -- Sigstore / SLSA attestations -- npm provenance -- PyPI attestations -- Post-publish registry API hash verification - -These belong to **future Supply Chain Security RFC**, not SDK Release Governance. - -### 6.7 Version Verification (MANDATORY) - -Before every publish, package versions MUST be verified against registry. - -#### 6.7.1 npm Version Check - -```bash -# For each package in Publish Set: -npm view @mplp/ version 2>/dev/null || echo "NEW" -``` - -If current version ≤ published version → **FAIL** (must bump) - -#### 6.7.2 PyPI Version Check - -```bash -pip index versions mplp-sdk 2>/dev/null || echo "NEW" -``` - -If current version ≤ published version → **FAIL** (must bump) - -#### 6.7.3 Version Bump Rules - -| Condition | Required Action | -|:---|:---| -| Package already published at this version | **MUST bump patch+** | -| Package is new (never published) | Use initial version | -| Version mismatch with bundle | **FAIL gate** | - -### 6.8 Version Alignment Procedure (MANDATORY) - -Before any release, version alignment MUST be performed: - -#### 6.8.1 Fetch Registry Versions - -For each package in Publish Set, query the registry for current latest version: - -```bash -# npm -curl -s "https://registry.npmjs.org/@mplp%2F" | grep -o '"latest":"[^"]*"' - -# PyPI -curl -s "https://pypi.org/pypi//json" | grep -o '"version":"[^"]*"' -``` - -#### 6.8.2 Version Bump Calculation - -| Registry Status | Action | -|:---|:---| -| NOT FOUND | Use initial version (1.0.0 for new packages) | -| Version exists | Bump to (current_patch + 1), e.g., 1.0.5 → 1.0.6 | - -**MINOR/MAJOR bumps require protocol change or new functionality.** - -#### 6.8.3 Required Document Updates - -When version changes, the following MUST be updated: - -| Document | Location | Update Content | -|:---|:---|:---| -| `package.json` | `packages/npm//` | `version` field | -| `pyproject.toml` | `packages/pypi//` | `version` field | -| `DERIVATION_PROOF.yaml` | Each package | `package.version` field | -| `CHANGELOG.md` | Repository root | New release entry with all package versions | -| `RELEASE_BUNDLE_MANIFEST.json` | `artifacts/release/` | Package versions and hashes | - -#### 6.8.4 Copyright Year Alignment - -All copyright notices MUST reflect the current year (e.g., `© 2026`). - -### 6.9 Pre-Publish Local Verification (MANDATORY) - -**All packages MUST be verified locally BEFORE registry publication.** - -Post-publish verification (Phase 7) confirms registry deployment only. - -#### 6.9.1 npm Local Verification - -```bash -# Step 1: Pack -cd packages/npm/ -npm pack - -# Step 2: Install in clean temp directory -mkdir /tmp/verify-npm && cd /tmp/verify-npm -npm init -y -npm install /path/to/-.tgz - -# Step 3: Verify import -node -e "const pkg = require('@mplp/'); console.log('Import OK');" -``` - -#### 6.9.2 PyPI Local Verification - -```bash -# Install wheel -pip install /path/to/mplp_sdk--py3-none-any.whl --force-reinstall - -# Verify import and version -python3 -c "import mplp; print(f'Version: {mplp.__version__}')" -``` - -#### 6.9.3 Local Verification Failure = Release Blocked - -If ANY local verification fails: -- **DO NOT PROCEED** to Registry Publish -- Fix the issue, rebuild, and re-verify - ---- - -## 7. Deprecation Procedure - -To deprecate a package: - -1. Update package README with migration instructions -2. Update package description to include "Legacy" -3. After publish, execute: `npm deprecate @mplp/@"" ""` -4. Record deprecation in this document (Section 3.1) - ---- - -## 8. Language Profiles - -### 8.1 Python Profile (PyPI Release Governance) - -#### 8.1.1 Scope - -This section defines the **Python (PyPI) release governance profile** under METHOD-SDKR-08. - -It specifies the mandatory governance requirements for releasing Python SDK artifacts that are part of an MPLP Release Bundle. - -This profile **does not introduce a separate governance method**. -All Python releases remain subject to the same authority, versioning, and evidence principles defined in METHOD-SDKR-08. - ---- - -#### 8.1.2 Python Package Classification - -All Python packages included in a Release Bundle MUST be classified using the same conceptual categories defined in Section 2: - -| Category | Definition | PyPI Upload Allowed | -|:---|:---|:---:| -| `PUBLIC` | External Python SDK or runtime package | YES | -| `INTERNAL` | Development-only or tooling package | NO | -| `CI-ONLY` | CI or validation tooling | NO | - -Python packages in the `INTERNAL` or `CI-ONLY` categories MUST NOT be uploaded to PyPI under any circumstance. - -**Current Python Package Registry:** - -| Package | Category | Layer | PyPI Name | -|:---|:---|:---|:---| -| `mplp-sdk` | PUBLIC | Published placeholder Python package | `mplp-sdk` | - ---- - -#### 8.1.3 Python Package Unit Requirements - -Each Python Package Unit included in a Release Bundle MUST satisfy all of the following: - -1. A valid `pyproject.toml` defining: - - package name - - version - - license - - build backend - -2. A corresponding `DERIVATION_PROOF.yaml` documenting: - - truth source paths - - build inputs - - artifact hashes (sdist and wheel) - -3. A `[tool.mplp]` section in `pyproject.toml` with: - - `protocolVersion` - - `frozen` - - `governance` - - `publishSurface` or `sourcePackage` - -4. Successful build of at least: - - one source distribution (`sdist`) - - one wheel distribution (`wheel`) - -Failure to meet any requirement SHALL block the release. - ---- - -#### 8.1.4 Python Version Synchronization - -All Python packages included in a Release Bundle MUST: - -- Use the **same major.minor version** as the Release Bundle -- Match the version recorded in `RELEASE_BUNDLE_MANIFEST.json` - -Any mismatch between Python package version and Release Bundle version SHALL result in an immediate release failure. - ---- - -#### 8.1.5 Python Publish Set and Gate (REQUIRED) - -A Python Publish Set MUST be computed automatically by CI. - -Manual specification of publish targets is NOT permitted. - -Before any PyPI upload occurs, an automated gate MUST verify: - -| Condition | Violation Result | -|:---|:---:| -| Package not classified as `PUBLIC` | **FAIL** | -| Missing `DERIVATION_PROOF.yaml` | **FAIL** | -| Version mismatch with Release Bundle | **FAIL** | -| Missing sdist or wheel artifact | **FAIL** | -| Artifact hash not recorded | **FAIL** | - -This gate is **NOT waivable**. - ---- - -#### 8.1.6 Python Evidence Artifacts - -Each Python release MUST generate the following artifacts: - -| Artifact | Location | Required | -|:---|:---|:---:| -| `pypi-set.json` | `artifacts/release/` | YES | -| `pypi-gate-report.json` | `artifacts/release/` | YES | -| Python entries in `RELEASE_BUNDLE_MANIFEST.json` | — | YES | - -These artifacts form part of the Evidence Chain for the Release Bundle. - ---- - -#### 8.1.7 Deprecation and Yank Policy (Python) - -Deprecation or yank actions on PyPI are governed as follows: - -- Any deprecation MUST be documented in release notes and governance records -- Yank operations are classified as **high-impact actions** and REQUIRE: - - explicit incident record - - governance approval - - evidence annotation - ---- - -**Document Status**: Governance Method -**Supersedes**: None -**References**: METHOD-SDKR-01, METHOD-SDKR-04, METHOD-SDKR-05 diff --git a/governance/03-distribution/sdk/METHOD-SDKR-09_RELEASE_READINESS.md b/governance/03-distribution/sdk/METHOD-SDKR-09_RELEASE_READINESS.md deleted file mode 100644 index 5878c1f40..000000000 --- a/governance/03-distribution/sdk/METHOD-SDKR-09_RELEASE_READINESS.md +++ /dev/null @@ -1,337 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "METHOD-SDKR-09_RELEASE_READINESS" ---- - -# METHOD-SDKR-09: Release Readiness Governance - -**Document ID**: METHOD-SDKR-09 -**Status**: Frozen (v1.0) -**Authority**: MPGC -**Effective**: 2026-01-04 -**Supersedes**: None - ---- - -## 1. Purpose - -This document defines **the conditions under which an MPLP SDK package is eligible for publication**. - -This is not a pipeline definition (SDKR-01) nor a content specification (SDKR-04). -This is the **Release Eligibility Gate** — the answer to: - -> **"When is a package ready to be published?"** - ---- - -## 2. Scope - -This METHOD applies to: -- All `@mplp/*` npm packages -- All MPLP PyPI packages (e.g., `mplp-sdk`) -- Any future SDK packages in any ecosystem - -This METHOD does NOT apply to: -- Protocol specification documents -- Website or documentation deployments -- Internal CI tooling - ---- - -## 3. Core Principle (NON-NEGOTIABLE) - -> **No release may bypass Stage 4 Isolated Verification, regardless of change size or version bump type.** - -This principle has no exceptions. A "tiny fix" and a "major feature" undergo the same verification. - -**Rationale**: Once exceptions are allowed, the gate becomes meaningless within months. - ---- - -## 4. 8-Stage Release Readiness Framework - -Every release MUST pass through all 8 stages **in order**. -Stage failure = **Release blocked**. - -``` -┌─────────────────────────────────────────────────────┐ -│ Stage 0 │ Release Intent Declaration │ -├─────────────────────────────────────────────────────┤ -│ Stage 1 │ Version Legitimacy Validation │ -├─────────────────────────────────────────────────────┤ -│ Stage 2 │ Dependency Integrity Check │ -├─────────────────────────────────────────────────────┤ -│ Stage 3 │ Derivation & Content Verification │ -├─────────────────────────────────────────────────────┤ -│ Stage 4 │ Pre-Publish Isolated Verification ← MANDATORY -├─────────────────────────────────────────────────────┤ -│ Stage 5 │ Documentation Linkage │ -├─────────────────────────────────────────────────────┤ -│ Stage 6 │ Release Gate (Final Approval) │ -├─────────────────────────────────────────────────────┤ -│ Stage 7 │ Publish Execution │ -└─────────────────────────────────────────────────────┘ - ↓ - Stage 8: Post-Publish Verification (SDKR-06) -``` - ---- - -## 5. Stage Definitions - -### 5.1 Stage 0: Release Intent Declaration - -**Purpose**: Prevent "accidental" or "drive-by" releases. - -**Requirements**: -1. Explicitly list all packages to be released -2. Declare version change for each package (from → to) -3. State the reason for each version bump - -**Evidence**: `RELEASE_INTENT.md` - -**Checklist**: -- [ ] Package list declared -- [ ] Version changes declared (e.g., `@mplp/core 1.0.5 → 1.0.6`) -- [ ] Bump reason stated for each package - ---- - -### 5.2 Stage 1: Version Legitimacy Validation - -**Purpose**: Ensure version numbers are semantically justified. - -**Rules**: - -| Bump Type | Allowed For | Prohibited For | -|:---|:---|:---| -| PATCH | Bugfix, internal improvement, governance compliance | N/A | -| MINOR | New user-facing capability, new API surface | Fixing release mistakes | -| MAJOR | Breaking changes | N/A (requires protocol update) | - -**Critical Rule**: -> **MINOR bumps to "fix a bad release" are PROHIBITED.** -> If a release was wrong, bump PATCH and fix it properly. - -**Evidence**: `VERSION_CHANGE_JUSTIFICATION.md` - -**Checklist**: -- [ ] Each package's bump type declared (PATCH/MINOR) -- [ ] MINOR bumps have explicit capability description -- [ ] No "error correction" bumps to MINOR - ---- - -### 5.3 Stage 2: Dependency Integrity Check - -**Purpose**: Prevent silent coupling and cross-package drift. - -**Requirements**: -1. Verify all `dependencies` in package.json/pyproject.toml -2. Confirm dependent packages satisfy semver constraints -3. Check for implicit dependency drift - -**Evidence**: `DEPENDENCY_CHECK.md` - -**Checklist**: -- [ ] Dependency versions checked -- [ ] No implicit cross-package breakage -- [ ] Internal dependencies (`file:../`) resolved for publish - ---- - -### 5.4 Stage 3: Derivation & Content Verification - -**Purpose**: Ensure package contents are governance-compliant. - -**References**: -- METHOD-SDKR-02 (Derivation Rules) -- METHOD-SDKR-04 (Package Content Specification) - -**Requirements**: -1. `DERIVATION_PROOF.yaml` present -2. Schema derivation traceable -3. Forbidden content scan PASS -4. Required files present: `dist/`, `README.md`, `LICENSE` - -**Checklist**: -- [ ] DERIVATION_PROOF.yaml exists -- [ ] Forbidden content scan PASS -- [ ] Package structure compliant - ---- - -### 5.5 Stage 4: Pre-Publish Isolated Verification (MANDATORY) - -**Purpose**: Verify the exact artifact that will be published, in a clean environment. - -> ⚠️ **THIS STAGE HAS NO EXCEPTIONS.** - -**npm Verification**: -```bash -# 1. Pack the package -cd packages/npm/ -npm pack - -# 2. Create isolated test environment -mkdir /tmp/verify- && cd /tmp/verify- -npm init -y - -# 3. Install the tarball -npm install /path/to/-.tgz - -# 4. Verify import -node -e "const pkg = require('@mplp/'); console.log(Object.keys(pkg));" - -# 5. Verify types (if TypeScript) -npx tsc --noEmit -p tsconfig.json # with types imported -``` - -**PyPI Verification**: -```bash -# 1. Build -python3 -m build - -# 2. Install wheel in isolation -pip install dist/--py3-none-any.whl --force-reinstall - -# 3. Verify import and version -python3 -c "import mplp; print(mplp.__version__)" -``` - -**Evidence**: `ISOLATED_VERIFICATION_REPORT.md` - -**Checklist**: -- [ ] `npm pack` / `python -m build` executed -- [ ] Tarball/wheel installed in clean environment -- [ ] Import succeeds -- [ ] Types available (npm) -- [ ] Version matches expected - ---- - -### 5.6 Stage 5: Documentation Linkage - -**Purpose**: Prevent "publish first, document later". - -**Requirements**: -1. `CHANGELOG.md` updated with new versions -2. Package `README.md` updated if behavior changed -3. `RELEASE_BUNDLE_MANIFEST.json` updated - -**Rule**: Documentation updates MUST occur BEFORE publish, not after. - -**Checklist**: -- [ ] CHANGELOG updated -- [ ] README updated (if applicable) -- [ ] Manifest updated - ---- - -### 5.7 Stage 6: Release Gate (Final Approval) - -**Purpose**: Human final review before irreversible publish. - -**Requirements**: -1. All Stages 0-5 PASS -2. All evidence artifacts present -3. No unexplained version jumps (e.g., 1.0.5 → 1.1.0 without reason) - -**Decision**: APPROVE or REJECT - -**If REJECT**: Return to failed stage, fix, and restart from there. - -**Checklist**: -- [ ] All previous stages PASS -- [ ] Evidence artifacts complete -- [ ] Release approved by responsible party - ---- - -### 5.8 Stage 7: Publish Execution - -**Purpose**: Execute the publish command. - -**Rules**: -1. Only execute after Stage 6 approval -2. Command must be logged (CI or manual record) -3. Multi-package publishes follow order defined in SDKR-08 - -**Commands**: -```bash -# npm -npm publish --access public - -# PyPI -twine upload dist/* -``` - -**Checklist**: -- [ ] Stage 6 approved -- [ ] Publish command executed -- [ ] Publish log recorded - ---- - -## 6. Required Evidence Artifacts - -| Stage | Artifact | Location | -|:---|:---|:---| -| 0 | `RELEASE_INTENT.md` | `artifacts/release/` | -| 1 | `VERSION_CHANGE_JUSTIFICATION.md` | `artifacts/release/` | -| 2 | `DEPENDENCY_CHECK.md` | `artifacts/release/` | -| 4 | `ISOLATED_VERIFICATION_REPORT.md` | `artifacts/release/` | -| 5 | `CHANGELOG.md` (diff) | Repository root | -| 6 | Release approval record | Git commit or PR | - ---- - -## 7. Stage Failure Handling - -| Failure | Action | -|:---|:---| -| Stage 0 incomplete | Cannot proceed | -| Stage 1 illegitimate version | Fix version, restart Stage 1 | -| Stage 2 dependency issue | Fix deps, restart Stage 2 | -| Stage 3 content issue | Fix content, restart Stage 3 | -| **Stage 4 verification fail** | **FIX AND RESTART. NO BYPASS.** | -| Stage 5 doc missing | Add docs, restart Stage 5 | -| Stage 6 rejected | Return to failed stage | - ---- - -## 8. Integration with Existing METHODs - -| METHOD | Relationship | -|:---|:---| -| SDKR-01 Pipeline | SDKR-09 executes between SDKR-01 Stage 4 and Stage 5 | -| SDKR-02 Derivation | Referenced in Stage 3 | -| SDKR-03 Versioning | Extended by Stage 1 | -| SDKR-04 Content | Referenced in Stage 3 | -| SDKR-06 Post-Install | Becomes Stage 8 (post-publish confirmation) | -| SDKR-08 Multi-Package | Stage 7 follows SDKR-08 publish order | - ---- - -## 9. Non-Goals - -This document does NOT define: -- How to write code -- API design guidelines -- Testing strategies -- CI/CD infrastructure - ---- - -## 10. Amendment - -Changes to this document require MPGC approval and a new frozen version. - ---- - -**Document Status**: Governance Method -**References**: METHOD-SDKR-01 through SDKR-08, CHECKLIST-SDK-RELEASE diff --git a/governance/03-distribution/sdk/MPLP-MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0.md b/governance/03-distribution/sdk/MPLP-MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0.md deleted file mode 100644 index dc3a879dd..000000000 --- a/governance/03-distribution/sdk/MPLP-MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0.md +++ /dev/null @@ -1,402 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0" ---- - -# MPLP Multi-Repo Release Operation Sheet v1.0 - -## 1. Purpose - -This operation sheet defines the practical release flow for MPLP across: - -- the private development trunk -- the prerelease staging repository -- the clean public repository -- the website release line -- the Validation Lab release line -- the public npm and PyPI SDK surfaces - -It operationalizes the already-approved governance and version-domain model. - -It does not create a new release doctrine. -It applies the existing distribution and versioning rules to the current -repository topology. - -## 2. Governing Baseline - -This sheet must be interpreted together with: - -- `governance/05-versioning/version-taxonomy-manifest.json` -- `governance/03-distribution/sdk/METHOD-SDKR-01_RELEASE_PIPELINE.md` -- `governance/03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md` -- `governance/03-distribution/sdk/METHOD-SDKR-09_RELEASE_READINESS.md` -- `governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md` -- `release-config.yaml` - -### 2.1 Version-Domain Rule - -Authoritative outward-facing release meaning MUST use explicit version domains. - -Current canonical version domains are: - -- `protocol_version` -- `schema_bundle_version` -- `invariant_bundle_version` -- `validation_ruleset_version` -- `validation_lab_release_version` -- `docs_release_version` -- `website_release_version` -- `sdk_version` - -The root repository `package.json.version` is not the outward-facing release -meaning for MPLP. - -## 3. Five-Repository Role Model - -### 3.1 Repository Roles - -| Repository | Role | Release Function | -|:---|:---|:---| -| `Coregentis/MPLP-Protocol-Dev` | Private development trunk | Authoritative integration and release-source candidate | -| `Coregentis/mplp_prerelease` | Prerelease staging repository | Cleanliness and export-preview validation | -| `Coregentis/MPLP-Protocol` | Clean public repository | Official open-source release repository | -| `Coregentis/MPLP-Official-Website` | Website release line | Official website deploy surface | -| `Coregentis/MPLP-Validation-Lab` | Validation Lab release line | Official Validation Lab deploy surface | - -### 3.2 Excluded Line - -`Coregentis/MPLP-Validation-Lab-V2` is excluded from the formal release path -defined in this sheet unless future governance explicitly promotes it into the -official release topology. - -### 3.3 Documentation Line Clarification - -`docs` is not a sixth repository in the release topology. - -It is source-included in `MPLP-Protocol` but deploy-separated as an independent -documentation release line. - -## 4. Hard Release Decisions - -The following execution decisions are fixed by this sheet. - -### 4.1 Candidate Continuity - -One authoritative source candidate from `MPLP-Protocol-Dev` MUST flow through: - -`MPLP-Protocol-Dev` -> `mplp_prerelease` -> `MPLP-Protocol` - -This means: - -- no semantic rework is allowed after the candidate is frozen -- prerelease is a cleanliness and export validation step, not a second authoring step -- public promotion must be traceable back to one frozen source candidate - -### 4.2 Commit Recording Rule - -Because the clean public repository may be mechanically exported and therefore -may not preserve the identical Git commit hash, every release record MUST carry: - -- `source_commit` = authoritative candidate commit from `MPLP-Protocol-Dev` -- `prerelease_validation_commit` = validated staging commit in `mplp_prerelease` -- `public_export_commit` = actual published commit in `MPLP-Protocol` - -### 4.3 Main Repository Tag Rule - -The main repository tag MUST use an explicit domain-qualified form. - -Required pattern: - -- `protocol-vX.Y.Z` - -Example: - -- `protocol-v1.0.0` - -Bare tags like `v1.0.0` must not be used as the authoritative main repository -release tag. - -### 4.4 SDK Publish Ordering Rule - -SDK registry publication MUST occur only after promotion to -`Coregentis/MPLP-Protocol` is complete. - -Public packages must not precede the public protocol baseline they refer to. - -### 4.5 SDK Publish Scope Rule - -Public SDK publication is change-based, not automatically full-bundle by default. - -Release only: - -- public packages whose publish surface changed -- required downstream package surfaces that must move with them - -Do not republish the entire public package set by default. - -### 4.6 Surface Deploy Synchronization Rule - -Website, Documentation, and Validation Lab do not require atomic simultaneous -deployment. - -They must instead satisfy: - -- deployment within the same release window when changed -- release notes record the pinned SHA or release version for each surface -- unchanged surfaces may remain on their prior deployed release - -### 4.7 Release Note Recording Rule - -Every main repository release note MUST record at minimum: - -- `protocol_version` -- `schema_bundle_version` -- `invariant_bundle_version` -- `validation_ruleset_version` -- `docs_release_version` -- `website_release_version` -- `validation_lab_release_version` -- `sdk_version` matrix -- `website_pinned_sha` -- `validation_lab_pinned_sha` -- `source_commit` -- `public_export_commit` - -## 5. Publish-Surface Rules - -### 5.1 Source Mirrors Must Not Publish - -The following are source mirrors and must not be published directly: - -- `packages/sources/sdk-ts` -- `packages/sources/sdk-py` - -They exist only as build/release preparation surfaces for: - -- `packages/npm/sdk-ts` -- `packages/pypi/mplp-sdk` - -### 5.2 Public SDK Publish Surfaces - -Registry publication is allowed only from: - -- `packages/npm/*` public package surfaces -- `packages/pypi/*` public package surfaces - -### 5.3 CI-Only Package Block - -`@mplp/validator` is CI-only and must never enter the publish set. - -## 6. Current Public SDK Surfaces - -### 6.1 npm Public Surfaces - -Current public npm surfaces include: - -- `@mplp/core` -- `@mplp/schema` -- `@mplp/modules` -- `@mplp/coordination` -- `@mplp/runtime-minimal` -- `@mplp/integration-llm-http` -- `@mplp/integration-storage-fs` -- `@mplp/integration-storage-kv` -- `@mplp/integration-tools-generic` -- `@mplp/devtools` -- `@mplp/sdk-ts` -- `@mplp/conformance` -- `@mplp/compliance` (deprecated compatibility alias) - -### 6.2 PyPI Public Surface - -Current public PyPI surface: - -- `mplp-sdk` - -### 6.3 Current Canonical SDK Versions - -Use the version registry and version taxonomy manifest as authority. - -Current published SDK anchors: - -- `@mplp/sdk-ts = 1.0.7` -- `mplp-sdk = 1.0.5` - -## 7. Release Sequence - -### Stage 0 — Freeze Candidate In Dev - -In `MPLP-Protocol-Dev`: - -- freeze the release candidate commit -- confirm all version domains -- confirm website and Validation Lab pinned SHAs -- identify the exact SDK publish set -- prepare release intent and evidence artifacts - -Output: - -- `source_commit` -- candidate release evidence - -### Stage 1 — Run Dev-Side Release Gates - -Run the required release and publish gates in the dev repository. - -Minimum: - -- root prerelease check -- npm publish-set gate -- PyPI publish-set gate -- SDK release readiness checklist -- isolated pre-publish verification - -Any gate failure blocks advancement. - -### Stage 2 — Export To `mplp_prerelease` - -Export the frozen candidate into `mplp_prerelease`. - -Rules: - -- export must be mechanical -- no semantic editing is allowed at this stage -- the staging repo exists only to verify clean public export properties - -Output: - -- `prerelease_validation_commit` - -### Stage 3 — Validate Cleanliness In `mplp_prerelease` - -Verify that the prerelease export: - -- contains only intended OSS content -- excludes website and Validation Lab subrepo content from the main release bundle -- contains the correct submodule pointers -- contains no internal-only or blocked package surfaces -- preserves the frozen candidate meaning - -If this stage fails, return to `MPLP-Protocol-Dev`. - -### Stage 4 — Promote To `MPLP-Protocol` - -Promote the validated export into `Coregentis/MPLP-Protocol`. - -Rules: - -- this is the official open-source repository release -- record `source_commit`, `prerelease_validation_commit`, and `public_export_commit` -- create the official protocol-domain tag (`protocol-vX.Y.Z`) -- publish the clean source release bundle from this repository - -### Stage 5 — Publish SDK Registry Surfaces - -Only after Stage 4 passes: - -- publish changed npm public surfaces -- publish changed PyPI public surfaces -- run post-publish verification from the registries - -### Stage 6 — Deploy Surface Repositories - -Deploy the changed release lines as needed: - -- website -- docs -- Validation Lab - -Deployment is release-window coordinated, but not required to be atomic if a -surface did not change. - -### Stage 7 — Record Final Release State - -Update the governance/release records: - -- `governance/03-distribution/sdk/VERSION_REGISTRY.yaml` -- `artifacts/release/RELEASE_BUNDLE_MANIFEST.json` -- `artifacts/release/publish-set.json` -- `artifacts/release/publish-gate-report.json` -- `artifacts/release/pypi-set.json` -- `artifacts/release/pypi-gate-report.json` -- final main repository release note / release card -- recorded pinned website and Validation Lab SHAs in that release note - -## 8. SDK Publish Order - -When the dependency graph requires ordered publication, use this sequence: - -1. `@mplp/core` -2. `@mplp/schema` -3. `@mplp/modules` -4. `@mplp/coordination` -5. `@mplp/runtime-minimal` -6. `@mplp/integration-*` -7. `@mplp/compliance` if changed and still intentionally maintained -8. `@mplp/conformance` if changed -9. `@mplp/devtools` -10. `@mplp/sdk-ts` -11. `mplp-sdk` - -This order ensures facade and alias layers never publish ahead of their lower -dependencies. - -## 9. Mandatory Gate Set - -### 9.1 npm - -- `node scripts/semantic/gate-publish-set.mjs` -- `node scripts/semantic/verify-publish-only.mjs` - -### 9.2 PyPI - -- `python scripts/semantic/gate_pypi_set/main.py` - -### 9.3 Release - -- `npm run pre-release` -- `governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md` - -## 10. Release Notes Minimum Schema - -Each official release note must contain: - -- release title -- `protocol_version` -- `source_commit` -- `prerelease_validation_commit` -- `public_export_commit` -- `website_pinned_sha` -- `validation_lab_pinned_sha` -- `docs_release_version` -- `website_release_version` -- `validation_lab_release_version` -- `sdk_version` matrix -- publish-set summary -- changed surfaces summary -- unchanged surfaces summary - -## 11. Non-Goals - -This sheet does not: - -- promote `Validation_Lab_V2` into the official release line -- collapse all repositories into one version number -- replace SDK governance methods -- override version taxonomy governance -- authorize source mirrors as publish targets - -## 12. Operational Summary - -In short: - -- develop in `MPLP-Protocol-Dev` -- validate cleanliness in `mplp_prerelease` -- promote only verified clean exports into `MPLP-Protocol` -- publish SDKs only after public promotion -- deploy website/docs/Lab as independent release lines -- record explicit version domains and pinned SHAs in the final release note diff --git a/governance/03-distribution/sdk/MPLP-PROTOCOL-v1.0.0-PUBLICATION-CLOSURE-RECORD-2026-04-06.md b/governance/03-distribution/sdk/MPLP-PROTOCOL-v1.0.0-PUBLICATION-CLOSURE-RECORD-2026-04-06.md deleted file mode 100644 index a9f4e9920..000000000 --- a/governance/03-distribution/sdk/MPLP-PROTOCOL-v1.0.0-PUBLICATION-CLOSURE-RECORD-2026-04-06.md +++ /dev/null @@ -1,196 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: frozen -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-PROTOCOL-v1.0.0-PUBLICATION-CLOSURE-RECORD-2026-04-06" -title: "MPLP Protocol v1.0.0 Publication Closure Record 2026-04-06" ---- - -# MPLP Protocol v1.0.0 Publication Closure Record 2026-04-06 - -## 1. Executive Closure Decision - -本记录封存的是： - -- root protocol line 的 public publication closure - -本记录确认： - -- `origin` (`mplp_prerelease`) 已完成 root protocol public branch update -- `origin-oss` (`MPLP-Protocol`) 已完成 root protocol public branch update -- `protocol-v1.0.0` 已完成在两个 public remotes 上的 publication -- legacy bare `v1.0.0` 在全部 public remotes 上保持不动 - -本记录不确认： - -- `MPLP_website` public push / deploy 已完成 -- `Validation_Lab` public push / deploy 已完成 -- npm publish 已完成 -- PyPI publish 已完成 -- docs / website / lab public deployment 已完成 - -因此，本记录是： - -- root protocol publication closure record - -而不是： - -- whole-ecosystem publication closure record - -## 2. Governing Chain Summary - -本轮 root protocol public publication 由以下治理链支撑： - -- public promotion policy baseline - - `616c8db528e6b79fbf43e53b169485d0fe5ead59` -- public promotion branch execution spec - - `361867886fed1beea6cf9f69e46388b675ee3d97` -- public promotion import/exclude adjudication matrix - - `d2caf84573d1e51df829741cd2a686a58d17c41b` -- public promotion branch execution review - - `043a87914fe3c7e8f87d9111f67e260fb81ea89a` -- public promotion branch execution approval - - `749c2a4243ee8c60bcfa49fd6666d7f7e9cb208c` -- public promotion verification substrate adjudication - - `dac08149fe595dc8063cd7cbfcaa885e424614d0` -- public promotion branch seal - - `2f4fc2584173708189654ffab91d2fdf00ed7951` -- public protocol tag alignment adjudication - - `f7e19c68ec19a2d649b525e4b7c1114e0fb1a166` - -上述对象共同定义了： - -- public branch truth -- protocol tag alignment legality -- public branch update / tag update separation -- legacy tag isolation - -## 3. Release Line and Remote State - -### 3.1 protocol-dev - -- `main` - - `fef2370d59dee062bdfb17aff14a0166792334ce` -- `protocol-v1.0.0` - - `a695c66444260e0fe185193d276d54263fd474bf` - -### 3.2 origin (`mplp_prerelease`) - -- `main` - - `a695c66444260e0fe185193d276d54263fd474bf` -- `protocol-v1.0.0` - - `a695c66444260e0fe185193d276d54263fd474bf` - -### 3.3 origin-oss (`MPLP-Protocol`) - -- `main` - - `a695c66444260e0fe185193d276d54263fd474bf` -- `protocol-v1.0.0` - - `a695c66444260e0fe185193d276d54263fd474bf` - -### 3.4 Public Protocol Truth - -当前 root protocol line 的 public truth object 为： - -- `a695c66444260e0fe185193d276d54263fd474bf` - -它同时被： - -- `origin/main` -- `origin-oss/main` -- `origin` 上的 `protocol-v1.0.0` -- `origin-oss` 上的 `protocol-v1.0.0` - -共同绑定。 - -## 4. Public Branch Update Result - -public branch update 已按分离执行原则完成： - -1. 先更新 `origin/main` -2. 再单独审理并更新 `origin-oss/main` - -两次更新均满足： - -- fast-forward only -- no force push -- no history replacement -- no tag touch during branch update - -最终结果： - -- `origin/main == a695c66444260e0fe185193d276d54263fd474bf` -- `origin-oss/main == a695c66444260e0fe185193d276d54263fd474bf` - -## 5. Public Tag Publication Result - -`protocol-v1.0.0` 的 public publication 已在 branch truth 与 tag alignment 完成后， -作为独立动作完成。 - -完成结果： - -- `origin` 上已存在： - - `protocol-v1.0.0 -> a695c66444260e0fe185193d276d54263fd474bf` -- `origin-oss` 上已存在： - - `protocol-v1.0.0 -> a695c66444260e0fe185193d276d54263fd474bf` - -publication 动作满足： - -- no branch push -- no extra tag push -- no legacy bare tag mutation - -## 6. Legacy Tag Isolation Confirmation - -legacy bare `v1.0.0` 在本轮始终保持： - -- untouched -- immutable -- historical-only - -本轮没有发生： - -- `v1.0.0` rewrite -- `v1.0.0` deletion -- `v1.0.0` reinterpretation - -因此： - -- future protocol-line public tag policy 继续由 `protocol-vX.Y.Z` 承担 -- legacy bare tag 与 forward protocol tag namespace 保持隔离 - -## 7. Scope Limit and Out-of-Scope Items - -本轮未纳入并不得在本记录中误写为已完成的事项： - -- `MPLP_website` public push -- `MPLP_website` public deploy -- `Validation_Lab` public push -- `Validation_Lab` public deploy -- npm publish -- PyPI publish -- docs public deploy -- website public deploy -- lab public deploy - -若这些事项后续完成，必须进入独立的外延 release/deploy 记录，而不能 retroactively -并入本 root protocol publication closure。 - -## 8. Final Closure Verdict - -- `ROOT_PROTOCOL_PUBLICATION_CLOSED` - -这意味着： - -- root protocol public publication across `origin` and `origin-oss` 已完成 -- `protocol-v1.0.0` 已完成 public publication -- legacy `v1.0.0` 保持完全不动 -- 本条主线的 protocol publication closure 已形成 terminal record - -## 9. Next Exact Action - -- 若需要继续推进外延 surface，单独启动 website / Validation Lab / registry / - deploy publication status adjudication；否则 root protocol publication line - may be treated as closed diff --git a/governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-BRANCH-SEAL-2026-04-06.md b/governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-BRANCH-SEAL-2026-04-06.md deleted file mode 100644 index 87aee07e0..000000000 --- a/governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-BRANCH-SEAL-2026-04-06.md +++ /dev/null @@ -1,173 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: approved -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-PUBLIC-PROMOTION-BRANCH-SEAL-2026-04-06" -title: "MPLP Public Promotion Branch Seal 2026-04-06" ---- - -# MPLP Public Promotion Branch Seal 2026-04-06 - -## 1. Executive Seal Decision - -本文件封存的是当前 `public promotion branch` 的本地 truth state。 - -本次 seal 的对象仅为： - -- branch-local execution result -- branch-local verification result -- branch-local boundary integrity result - -本次 seal 不等于： - -- public remotes 已更新 -- public tag 已发布 -- public branch update 已获单独裁决 -- public promotion 已完成 - -## 2. Governing Inputs - -本次 seal 依赖的 frozen governance objects 如下： - -- policy baseline: - - `MPLP-PUBLIC-PROMOTION-POLICY-BASELINE-v0.1.md` - - commit `616c8db528e6b79fbf43e53b169485d0fe5ead59` -- execution spec: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-SPEC-v0.1.md` - - commit `361867886fed1beea6cf9f69e46388b675ee3d97` -- import/exclude adjudication matrix: - - `MPLP-PUBLIC-PROMOTION-IMPORT-EXCLUDE-ADJUDICATION-MATRIX-v0.1.md` - - commit `d2caf84573d1e51df829741cd2a686a58d17c41b` -- execution review: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-REVIEW-2026-04-06.md` - - commit `043a87914fe3c7e8f87d9111f67e260fb81ea89a` -- execution approval: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-APPROVAL-2026-04-06.md` - - commit `749c2a4243ee8c60bcfa49fd6666d7f7e9cb208c` -- verification substrate adjudication: - - `MPLP-PUBLIC-PROMOTION-VERIFICATION-SUBSTRATE-ADJUDICATION-v0.1.md` - - commit `dac08149fe595dc8063cd7cbfcaa885e424614d0` - -## 3. Branch Identity and Lineage - -- branch name: - - `public-promotion/protocol-v1.0.0-rc1` -- current sealed branch head: - - `a695c66444260e0fe185193d276d54263fd474bf` -- canonical public base: - - `52719b884a395ab1579588e03e6a6cac9a797ccf` -- sealed payload input: - - `fef2370d59dee062bdfb17aff14a0166792334ce` - -authoritative execution head progression: - -- Phase 1–3 checkpoint: - - `b080e5abc97eab1c7924987c379b42fb85bb6198` -- execution-enabling governance head: - - `dac08149fe595dc8063cd7cbfcaa885e424614d0` -- verification substrate import: - - `356ec3930e7a59bf2351ff884c9512c4a7140421` -- verification evidence freeze: - - `a695c66444260e0fe185193d276d54263fd474bf` - -adjudicated meaning: - -- `b080e5a...` remains the valid Phase 1–3 checkpoint -- `dac08149f...` lawfully superseded it as authoritative execution head because - it added execution-enabling governance only -- `a695c6644...` is the current sealed local branch truth head - -## 4. Execution Chain Summary - -Execution chain status at seal time: - -1. Phase 1–3 completed - - promotion branch created from public canonical base - - approved surfaces imported - - excluded/deferred surfaces kept out -2. authorized verification substrate imported - - commit `356ec3930e7a59bf2351ff884c9512c4a7140421` - - message: - - `promotion: import authorized verification substrate for phase4` -3. Phase 4 verified - - `pre-release-check.mjs`: PASS - - `gate-publish-set.mjs`: PASS - - `gate_pypi_set.main`: PASS -4. verification evidence outputs frozen - - commit `a695c66444260e0fe185193d276d54263fd474bf` - - message: - - `promotion: freeze phase4 verification evidence outputs` -5. worktree clean at seal time - -## 5. Boundary Integrity Confirmation - -At seal time, the branch satisfies the frozen boundary constraints: - -- no `EXCLUDE` surface carried in -- no unauthorized `DEFER` surface imported -- no `PROJECTION_ONLY` surface treated as general payload -- `packages/pypi/mplp-sdk/dist/*` remained verification-only where applicable - -Specific confirmations: - -- not present as carried payload: - - `governance/06-operations/**` - - `governance/audits/**` - - `Validation_Lab/**` - - `governance/05-specialized/website/**` -- no unauthorized dist artifact expansion: - - only the adjudicated verification-only `packages/pypi/mplp-sdk/dist/*.whl` - and `*.tar.gz` were used - -## 6. Verification Summary - -Phase 4 verification summary: - -- `node scripts/04-build/pre-release-check.mjs` - - PASS -- `node scripts/semantic/gate-publish-set.mjs` - - PASS -- `python3 -m scripts.semantic.gate_pypi_set.main` - - PASS - -Evidence closure: - -- updated verification evidence outputs were frozen by: - - commit `a695c66444260e0fe185193d276d54263fd474bf` - -At seal time: - -- no unexplained dirty verification outputs remain -- branch worktree is clean - -## 7. Seal Scope Limit - -This seal does not approve: - -- public branch update -- public tag update -- any push to public remotes -- any tag publication - -This seal does not itself perform public promotion. - -This seal only prepares the current local branch state for the next adjudication -step. - -## 8. Final Seal Verdict - -- `PROMOTION_BRANCH_TRUTH_SEALED` - -This means: - -- the current local promotion branch truth is now sealed and auditable -- the branch is prepared for the next adjudication layer -- no public remote state has been changed by this seal - -## 9. Next Exact Action - -- start the separate adjudication step for public branch update and public tag - update using the sealed local promotion branch truth as the sole execution - input diff --git a/governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-VERIFICATION-SUBSTRATE-ADJUDICATION-v0.1.md b/governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-VERIFICATION-SUBSTRATE-ADJUDICATION-v0.1.md deleted file mode 100644 index 2ff5aadb6..000000000 --- a/governance/03-distribution/sdk/MPLP-PUBLIC-PROMOTION-VERIFICATION-SUBSTRATE-ADJUDICATION-v0.1.md +++ /dev/null @@ -1,236 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: approved -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-PUBLIC-PROMOTION-VERIFICATION-SUBSTRATE-ADJUDICATION-v0.1" -title: "MPLP Public Promotion Verification Substrate Adjudication v0.1" ---- - -# MPLP Public Promotion Verification Substrate Adjudication v0.1 - -## 1. Executive Decision - -本文件用于补齐当前 frozen governance objects 中关于 `Phase 4` branch 内 -verification substrate 的最小治理缺口。 - -它只裁决： - -- branch 内 `Phase 4` verification 所需 gate scripts -- gate helpers / outputs -- verification-only dist artifact handling - -它不裁决： - -- general payload import -- public promotion branch update -- public tag publication -- release identity authority change -- public tag namespace change - -本文件是： - -- a minimal phase-scoped governance adjudication -- subordinate to: - - `MPLP-PUBLIC-PROMOTION-POLICY-BASELINE-v0.1.md` - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-SPEC-v0.1.md` - - `MPLP-PUBLIC-PROMOTION-IMPORT-EXCLUDE-ADJUDICATION-MATRIX-v0.1.md` - -本文件创建的唯一目的，是合法解锁 branch 内 `Phase 4` verification substrate。 - -## 2. Governing Inputs - -本裁决建立在以下 frozen objects 之上： - -- policy baseline: - - `MPLP-PUBLIC-PROMOTION-POLICY-BASELINE-v0.1.md` - - commit `616c8db52` -- execution spec: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-SPEC-v0.1.md` - - commit `361867886` -- import/exclude adjudication matrix: - - `MPLP-PUBLIC-PROMOTION-IMPORT-EXCLUDE-ADJUDICATION-MATRIX-v0.1.md` - - commit `d2caf8457` -- execution review: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-REVIEW-2026-04-06.md` - - commit `043a87914` -- execution approval: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-APPROVAL-2026-04-06.md` - - commit `749c2a424` - -已知 blocker adjudication: - -- blocker type: - - `verification substrate governance gap` -- high-level path verdict: - - `missing_governance_layer` - -## 3. Verification Substrate Adjudication Scope - -本文件只处理以下三类 surface： - -1. `gate_script` -2. `helper_surface` -3. `verification_output_surface` -4. `verification_only_artifact` - -注意： - -- 本文件不重新裁决一般 payload import -- 本文件不推翻 matrix 对 `public_defer` 的语义 -- 它只为 `Phase 4` 创建一个受限、显式、不可外推的 verification substrate 例外层 - -## 4. Gate Script Authorization Matrix - -| surface_path | substrate_role | phase_scope | execution_decision | payload_status | rationale | stop_condition_if_misused | -|:---|:---|:---|:---|:---|:---|:---| -| `scripts/04-build/pre-release-check.mjs` | `gate_script` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Approved execution sequence explicitly requires in-branch public-line verification; this script is the top-level gate runner | If used outside `Phase 4`, or treated as general payload import, stop execution immediately | -| `scripts/semantic/gate-publish-set.mjs` | `gate_script` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Approved Phase 4 requires rerunning publish-set verification on the promotion branch | If used to justify general script import beyond Phase 4, stop execution immediately | -| `scripts/semantic/gate_pypi_set/main.py` | `gate_script` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Approved Phase 4 requires rerunning the PyPI publish gate in-branch | If used outside `Phase 4`, or to bypass dist-artifact limits defined below, stop execution immediately | - -## 5. Helper and Output Surface Authorization Matrix - -| surface_path | substrate_role | phase_scope | execution_decision | payload_status | rationale | stop_condition_if_misused | -|:---|:---|:---|:---|:---|:---|:---| -| `scripts/04-build/update-frozen-headers.mjs` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct helper invoked by `pre-release-check.mjs` in `--check` mode | If imported as general payload or executed in apply/mutating mode outside approved verification context, stop execution | -| `scripts/03-docs/semantic/semantic-lint.mjs` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct helper invoked by `pre-release-check.mjs` | If imported outside verification substrate scope, stop execution | -| `scripts/03-docs/semantic/mapping-health.mjs` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct helper invoked by `pre-release-check.mjs` | If used to expand promotion payload, stop execution | -| `scripts/03-docs/verify-governance-styling.mjs` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct helper invoked by `pre-release-check.mjs` | If imported outside verification-only scope, stop execution | -| `scripts/semantic/gate_pypi_set/__init__.py` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Required package entry for `python3 -m scripts.semantic.gate_pypi_set.main` | If omitted or treated as general payload, Phase 4 becomes invalid | -| `scripts/semantic/gate_pypi_set/checks.py` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct relative import from `main.py`; contains normative gate checks | If imported outside Phase 4 scope, stop execution | -| `scripts/semantic/gate_pypi_set/loader.py` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct relative import from `main.py`; required for `pyproject` and manifest loading | If omitted or expanded into general payload, stop execution | -| `scripts/semantic/gate_pypi_set/model.py` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct relative import from `main.py`; required for gate model objects | If omitted or repurposed outside verification scope, stop execution | -| `scripts/semantic/gate_pypi_set/report.py` | `helper_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `not_general_payload` | Direct relative import from `main.py`; required to emit gate evidence outputs | If omitted or treated as payload source, stop execution | -| `artifacts/release/publish-set.json` | `verification_output_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `verification_only` | Expected output target of `gate-publish-set.mjs`; must be part of the verification substrate so gate output is attributable and not unexplained drift | If treated as general promotion payload, stop execution | -| `artifacts/release/publish-gate-report.json` | `verification_output_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `verification_only` | Expected gate evidence output for publish-set verification | If retained beyond verification role without separate release-truth citation, stop execution | -| `artifacts/release/pypi-set.json` | `verification_output_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `verification_only` | Expected output target of the PyPI gate | If used as general payload, stop execution | -| `artifacts/release/pypi-gate-report.json` | `verification_output_surface` | `Phase 4 only` | `AUTHORIZE_IMPORT_FOR_PHASE4` | `verification_only` | Expected gate evidence output for the PyPI gate | If used outside verification/evidence role, stop execution | - -## 6. Verification-Only Artifact Adjudication - -### 6.1 Dist Artifact Verdict - -`packages/pypi/mplp-sdk/dist/*` is adjudicated as: - -- `verification_only_artifact` -- `phase_scope`: `Phase 4 only` -- `execution_decision`: `AUTHORIZE_VERIFICATION_ONLY_ARTIFACT_IMPORT` -- `payload_status`: `verification_only` - -### 6.2 Authorized Range - -The authorized verification-only artifact range is strictly limited to: - -- `packages/pypi/mplp-sdk/dist/*.whl` -- `packages/pypi/mplp-sdk/dist/*.tar.gz` - -This authorization exists only because the frozen PyPI gate directly checks: - -- existence of wheel artifacts -- existence of sdist artifacts - -and branch-internal Phase 4 verification has already been approved as the -required execution model. - -### 6.3 Limited Exception Rule - -This authorization is a narrow exception to the matrix’s existing defer meaning. - -It does not cancel the matrix. -It refines it for one phase-scoped purpose only: - -- branch-internal `Phase 4` verification - -Therefore: - -- these dist artifacts remain `not general payload` -- they remain unusable as release payload precedent -- they do not become generally importable surfaces - -### 6.4 Stop Condition If Misused - -Execution must stop immediately if: - -- any dist artifact outside the authorized `packages/pypi/mplp-sdk/dist/*` range - is imported under this adjudication -- authorized dist artifacts are carried forward as general promotion payload -- authorized dist artifacts are used to justify public publish or branch/tag - update in this pass - -## 7. Cross-Cut Guardrails - -### Rule 1 — Verification Substrate Is Not General Payload - -All verification substrate imports authorized by this document are: - -- phase-scoped -- verification-scoped -- not general promotion payload - -They must not be reinterpreted as a broader import right. - -### Rule 2 — Phase-Limited Authorization - -This authorization applies only to: - -- branch-internal `Phase 4` verification - -It does not automatically extend to: - -- `Phase 5` promotion branch truth sealing -- public branch update -- public tag publication - -### Rule 3 — Verification-Only Artifact Guard - -Authorized `dist` artifacts are allowed only in a verification-only role. - -They must not: - -- override matrix defer semantics for other phases -- become general payload -- become publish authorization - -### Rule 4 — No Silent Expansion - -Execution may not silently expand this adjudication to: - -- scripts not listed here -- helpers not listed here -- artifacts not listed here -- output families not listed here - -Any such expansion requires a separate adjudication. - -## 8. Final Adjudication Verdict - -- `APPROVED_AND_FROZEN` - -This adjudication closes the minimal governance gap identified by the Phase 4 -blocker adjudication: - -- gate scripts and helpers are now explicitly authorized as branch-internal - verification substrate -- required verification output surfaces are now explicitly authorized -- `packages/pypi/mplp-sdk/dist/*` now has a narrow verification-only import - authorization - -This verdict does not rerun Phase 4. -It only makes Phase 4 legally executable under frozen governance constraints. - -## 9. Approval Effect - -Once frozen, this adjudication becomes the governing source for: - -- what verification substrate may be imported into the promotion branch for - `Phase 4` -- what verification outputs may be written/retained during `Phase 4` -- how `packages/pypi/mplp-sdk/dist/*` may be used in verification-only form - -It does not authorize: - -- general payload expansion -- public push -- public tag update -- execution beyond the approved verification role defined here diff --git a/governance/03-distribution/sdk/MPLP-PUBLIC-PROTOCOL-TAG-ALIGNMENT-ADJUDICATION-v0.1.md b/governance/03-distribution/sdk/MPLP-PUBLIC-PROTOCOL-TAG-ALIGNMENT-ADJUDICATION-v0.1.md deleted file mode 100644 index 54d375193..000000000 --- a/governance/03-distribution/sdk/MPLP-PUBLIC-PROTOCOL-TAG-ALIGNMENT-ADJUDICATION-v0.1.md +++ /dev/null @@ -1,270 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: approved -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-PUBLIC-PROTOCOL-TAG-ALIGNMENT-ADJUDICATION-v0.1" -title: "MPLP Public Protocol Tag Alignment Adjudication v0.1" ---- - -# MPLP Public Protocol Tag Alignment Adjudication v0.1 - -## 1. Executive Decision - -本文件用于关闭当前 frozen governance chain 中关于 -`protocol-v1.0.0` target alignment 的狭义治理缺口。 - -当前必须被显式裁决的问题是： - -- `protocol-v1.0.0` 当前仍指向 dev-line sealed payload milestone -- current public branch truth 已经成立于 - `a695c66444260e0fe185193d276d54263fd474bf` -- 若要 future public publish `protocol-v1.0.0`，是否允许先做 target alignment - -本文件只裁决： - -- protocol tag semantic alignment legality -- same-name cross-remote semantics rule -- alignment 与 publication 的分离关系 - -本文件不执行： - -- tag mutation -- tag publication -- public tag push - -## 2. Governing Inputs - -本裁决建立在以下 frozen governance chain 之上： - -- policy baseline: - - `MPLP-PUBLIC-PROMOTION-POLICY-BASELINE-v0.1.md` - - commit `616c8db52` -- execution spec: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-SPEC-v0.1.md` - - commit `361867886` -- import/exclude adjudication matrix: - - `MPLP-PUBLIC-PROMOTION-IMPORT-EXCLUDE-ADJUDICATION-MATRIX-v0.1.md` - - commit `d2caf8457` -- execution review: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-REVIEW-2026-04-06.md` - - commit `043a87914` -- execution approval: - - `MPLP-PUBLIC-PROMOTION-BRANCH-EXECUTION-APPROVAL-2026-04-06.md` - - commit `749c2a424` -- verification substrate adjudication: - - `MPLP-PUBLIC-PROMOTION-VERIFICATION-SUBSTRATE-ADJUDICATION-v0.1.md` - - commit `dac08149f` -- promotion branch seal: - - `MPLP-PUBLIC-PROMOTION-BRANCH-SEAL-2026-04-06.md` - - commit `2f4fc2584` - -当前 truth split: - -- current tag name: - - `protocol-v1.0.0` -- current dev target: - - `fef2370d59dee062bdfb17aff14a0166792334ce` -- current public truth target: - - `a695c66444260e0fe185193d276d54263fd474bf` - -## 3. Current Tag Semantics and Truth Split - -Current adjudicated meaning: - -- `protocol-v1.0.0` currently represents: - - a dev-line sealed payload milestone on `protocol-dev` -- it does **not** currently represent: - - the current public branch truth release tag - -Current semantic relation between the two targets: - -- `fef2370d59...` and `a695c66444...` are not the same truth object -- the current public truth includes post-`fef...` public-history reconciliation - and branch-sealed verification state - -Therefore: - -- current same-name semantics are split -- current public publication is not admissible without an explicit alignment rule - -Required judgment fields: - -- current tag name: `protocol-v1.0.0` -- current dev target: `fef2370d59...` -- current public truth target: `a695c66444...` -- same-name cross-remote divergence acceptable: `NO` -- target migration governance-legal: `YES` -- migration must precede publication: `YES` -- publication still needs a later separate adjudication: `YES` - -## 4. Cross-Remote Same-Name Semantics Rule - -### Rule 1 — Same-Name Cross-Remote Ambiguity Is Not Silent - -同名 `protocol-v1.0.0` 如果在不同 remotes 上指向不同 truth，不能被默认视为 -可接受状态。 - -必须显式裁决。 - -### Rule 2 — Same-Name Cross-Remote Divergence Acceptability - -裁决： - -- same-name cross-remote divergence acceptable: `NO` - -理由： - -- `protocol-v1.0.0` 作为 protocol-line public tag 时，必须能绑定单一、 - 可审计、可解释的 protocol truth -- 若 `protocol-dev` 与 public remotes 上同名 tag 指向不同 truth，会直接造成 - cross-remote ambiguity - -### Rule 3 — Same-Name Cross-Remote Alignment Requirement - -若 future public publication 要使用同名 `protocol-v1.0.0`，则： - -- `protocol-dev` 与 public remotes 上该 tag 必须最终保持同一语义 -- 且应保持同一 target - -这意味着： - -- 若当前 target 不一致，必须先完成显式 alignment -- alignment 完成前，不得进入 public publication - -## 5. Tag Alignment Mutation Adjudication - -### Core Adjudication - -本文件裁决： - -- target migration governance-legal: `YES` - -但 legal basis 仅限于： - -- governance-approved semantic re-binding under frozen governance - -而不是： - -- silent semantic lift -- informal reuse -- automatic dev-to-public carryover - -### Alignment Action Nature - -alignment 动作的法律性质是： - -- `tag retarget requiring explicit approval` -- simultaneously serving as a governance-approved semantic re-binding - -原因： - -- 当前 `protocol-v1.0.0` 在 `protocol-dev` 上承载的是 dev milestone 语义 -- 若要让它承载 public protocol truth，必须显式迁移其语义绑定 -- 这种迁移不能静默发生 - -### Allowed Future Alignment Path - -允许的未来 alignment path 为： - -- `protocol-v1.0.0` - from: - - `fef2370d59dee062bdfb17aff14a0166792334ce` - to: - - `a695c66444260e0fe185193d276d54263fd474bf` - -但该动作： - -- 只能作为一个单独、后续的 execution step -- 不能与 public publication 混成同一步 -- 不能借此改变 legacy bare `v1.0.0` - -### No Silent Dev-to-Public Semantic Lift - -`protocol-dev` 上的 dev milestone 语义不得静默提升为 public truth 语义。 - -若允许迁移，只能基于本文件的显式 adjudication。 - -## 6. Publication Prerequisite Rule - -裁决： - -- migration must precede publication: `YES` -- publication still needs a later separate adjudication: `YES` - -这意味着： - -1. 先有 alignment -2. 再有单独 public tag publication adjudication -3. 然后才可能有任何 public tag push - -当前不允许： - -- 先 publish 再解释 alignment -- 用 current dev target 直接进入 public remotes - -## 7. Guardrails and Stop Conditions - -### Rule 1 — Alignment Is Not Publication - -即便 alignment 被批准，也不等于 public publication 被批准。 - -### Rule 2 — Legacy Bare Tag Isolation - -任何 alignment 或 publication decision 都不得： - -- 修改 `v1.0.0` -- 删除 `v1.0.0` -- 替代 `v1.0.0` -- 重释义 `v1.0.0` - -### Rule 3 — No Namespace Rewrite - -本文件不修改 frozen namespace policy： - -- future protocol-line public tags still use `protocol-vX.Y.Z` - -### Rule 4 — No Silent Cross-Remote Split - -若 alignment 未完成，则： - -- `protocol-v1.0.0` 不得进入 public remotes - -### Stop Conditions - -若后续 alignment execution 出现以下任一情况，必须停止： - -- 需要借 alignment 改写 legacy `v1.0.0` -- 需要在未单独 adjudicate publication 前直接 push `protocol-v1.0.0` -- 需要让同名 `protocol-v1.0.0` 在不同 remotes 上长期保持不同语义/target -- 需要修改 namespace policy 才能成立 - -## 8. Final Adjudication Verdict - -- `APPROVED_AND_FROZEN` -- path verdict: - - `ALIGNMENT_MUTATION_APPROVED_UNDER_GOVERNANCE` - -This means: - -- `protocol-v1.0.0` is allowed to undergo a future explicitly approved target - alignment from dev milestone truth to public truth -- that alignment remains a separate execution step -- public publication remains separately adjudicated and is not approved by this - document - -## 9. Approval Effect - -Once frozen, this adjudication becomes the governing source for: - -- whether `protocol-v1.0.0` may legally migrate from current dev target - `fef2370d59...` to current public truth target `a695c66444...` -- whether same-name cross-remote divergence is acceptable -- whether migration must precede publication - -It does not authorize: - -- immediate tag mutation -- immediate tag publication -- public tag push diff --git a/governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-2026-04-05-public-oss-01.md b/governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-2026-04-05-public-oss-01.md deleted file mode 100644 index c47a856f0..000000000 --- a/governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-2026-04-05-public-oss-01.md +++ /dev/null @@ -1,121 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-RELEASE-CHECKLIST-2026-04-05-public-oss-01" -title: "MPLP Release Checklist 2026-04-05 Public OSS 01" ---- - -# MPLP Release Checklist 2026-04-05 Public OSS 01 - -Derived from: - -- `governance/03-distribution/sdk/MPLP-MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0.md` -- `governance/03-distribution/sdk/MPLP-RELEASE-READINESS-BASELINE-v1.0.md` -- `governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-TEMPLATE-v1.0.md` - -## Release Record Header - -- `release_window_id`: `2026-04-05-public-oss-01` -- `release_date_target`: `2026-04-05` -- `release_operator`: `jasonwang` -- `protocol_tag_target`: `protocol-v1.0.0` -- `source_commit`: `` -- `prerelease_validation_commit`: `` -- `public_export_commit`: `` -- `website_pinned_sha`: `da5d4618cecf4e1ceec2866f33f8b9f0453a4a71` - note: frozen website candidate `W1` -- `validation_lab_pinned_sha`: `8010b74b854b1128d89632c474a8844c924a43a2` - note: frozen Validation_Lab candidate `L1` -- `sdk_publish_set`: candidate publish set pending gate validation: - - `@mplp/compliance@1.0.5` - - `@mplp/conformance@1.0.0` - - `@mplp/coordination@1.0.6` - - `@mplp/core@1.0.6` - - `@mplp/devtools@1.0.5` - - `@mplp/integration-llm-http@1.0.5` - - `@mplp/integration-storage-fs@1.0.5` - - `@mplp/integration-storage-kv@1.0.5` - - `@mplp/integration-tools-generic@1.0.5` - - `@mplp/modules@1.0.5` - - `@mplp/runtime-minimal@1.0.5` - - `@mplp/schema@1.0.6` - - `@mplp/sdk-ts@1.0.7` - - `mplp-sdk@1.0.5` - -## 1. Candidate Freeze In `MPLP-Protocol-Dev` - -| Item | Content | -|:---|:---| -| Required Inputs | `MPLP-RELEASE-READINESS-BASELINE-v1.0.md`, current version-domain snapshot, intended release window scope | -| Command / Check | Executed: `git status --short`; `git rev-parse HEAD`; `git branch --show-current`; `git submodule status MPLP_website Validation_Lab`; `git ls-files --stage MPLP_website Validation_Lab`; `git -C Validation_Lab rev-parse HEAD`; `git -C Validation_Lab status --short`; package-change scan across `packages/npm` and `packages/pypi` | -| Pass Criterion | One authoritative candidate is frozen; release scope is explicit; `source_commit`, `website_pinned_sha`, and `validation_lab_pinned_sha` are captured as facts | -| Record To Fill | `source_commit`, `website_pinned_sha`, `validation_lab_pinned_sha`, `sdk_publish_set`, release-scope note | -| Blocker / Stop Rule | If candidate freeze is not explicit, if pinned SHAs are unknown, or if publish/deploy scope is ambiguous, stop and do not advance | - -### 1.1 Findings - -- Current root branch: `main` -- Current root freeze commit: `` -- Remote topology present: - - `protocol-dev` -> `Coregentis/MPLP-Protocol-Dev` - - `origin` -> `Coregentis/mplp_prerelease` - - `origin-oss` -> `Coregentis/MPLP-Protocol` -- Website frozen candidate `W1`: - - `da5d4618cecf4e1ceec2866f33f8b9f0453a4a71` -- Validation Lab frozen candidate `L1`: - - `8010b74b854b1128d89632c474a8844c924a43a2` -- Candidate publish set has changed public publish surfaces in both `packages/npm/*` - and `packages/pypi/*` - -### 1.2 Stage 1 Integrity Judgment - -`Stage 1 = BLOCKED` - -Reason: - -- root worktree is dirty -- root has not yet been aligned to frozen `W1` -- root tracked `Validation_Lab/**` has not yet been aligned to frozen `L1` - -This means the final `source_commit` does not yet exist for the current root -workspace state. - -### 1.3 Immediate Stop Rule Triggered - -Do not start Stage 2 yet. - -Stage 1 must be completed first by producing a real frozen candidate state such -that: - -- root release candidate changes are committed or otherwise reduced to one frozen - authoritative candidate commit -- root gitlink for `MPLP_website` is updated to frozen `W1` -- root tracked `Validation_Lab/**` is aligned to frozen `L1` -- the `sdk_publish_set` is explicitly approved for this release window - -## 2. Dev-Side Gates - -Status: `PENDING — DO NOT START BEFORE STAGE 1 PASS` - -## 3. `mplp_prerelease` Cleanliness / Export Validation - -Status: `PENDING — DO NOT START BEFORE STAGE 1 AND 2 PASS` - -## 4. Promote To `MPLP-Protocol` - -Status: `PENDING — DO NOT START BEFORE PRERELEASE VALIDATION PASS` - -## 5. SDK Publish Set Execution - -Status: `PENDING — DO NOT START BEFORE PUBLIC PROMOTION PASS` - -## 6. Docs / Website / Validation Lab Deploy Window - -Status: `PENDING — DO NOT START BEFORE RELEASE WINDOW FACTS ARE APPROVED` - -## 7. Backfill Of Commits, SHAs, Manifests, And Notes - -Status: `PENDING — DO NOT START BEFORE PRIOR STAGES COMPLETE` diff --git a/governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-TEMPLATE-v1.0.md b/governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-TEMPLATE-v1.0.md deleted file mode 100644 index 089de4e26..000000000 --- a/governance/03-distribution/sdk/MPLP-RELEASE-CHECKLIST-TEMPLATE-v1.0.md +++ /dev/null @@ -1,125 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-RELEASE-CHECKLIST-TEMPLATE-v1.0" -title: "MPLP Release Checklist Template v1.0" ---- - -# MPLP Release Checklist Template v1.0 - -## Purpose - -This checklist template operationalizes: - -- `governance/03-distribution/sdk/MPLP-MULTI-REPO-RELEASE-OPERATION-SHEET-v1.0.md` -- `governance/03-distribution/sdk/MPLP-RELEASE-READINESS-BASELINE-v1.0.md` -- `governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md` - -Use this file for one real release candidate at a time. - -Do not start public promotion, SDK publication, or surface deployment until the -required records for the current stage are filled and the stage pass criteria -are satisfied. - -## Release Record Header - -Fill these fields for the current release candidate: - -- `release_window_id`: `` -- `release_date_target`: `` -- `release_operator`: `` -- `protocol_tag_target`: `` -- `source_commit`: `` -- `prerelease_validation_commit`: `` -- `public_export_commit`: `` -- `website_pinned_sha`: `` -- `validation_lab_pinned_sha`: `` -- `sdk_publish_set`: `` - -## 1. Candidate Freeze In `MPLP-Protocol-Dev` - -| Item | Content | -|:---|:---| -| Required Inputs | `MPLP-RELEASE-READINESS-BASELINE-v1.0.md`, current version-domain snapshot, intended release window scope | -| Command / Check | Freeze one candidate in `MPLP-Protocol-Dev`; record current commit with `git rev-parse HEAD`; record submodule SHAs with `git submodule status MPLP_website Validation_Lab`; confirm actual release-window inclusion for SDK / docs / website / Validation Lab | -| Pass Criterion | One authoritative candidate is frozen; release scope is explicit; `source_commit`, `website_pinned_sha`, and `validation_lab_pinned_sha` are captured as facts | -| Record To Fill | `source_commit`; `website_pinned_sha`; `validation_lab_pinned_sha`; `sdk_publish_set`; release-scope note | -| Blocker / Stop Rule | If candidate freeze is not explicit, if pinned SHAs are unknown, or if publish/deploy scope is ambiguous, stop and do not advance | - -## 2. Dev-Side Gates - -| Item | Content | -|:---|:---| -| Required Inputs | Frozen candidate commit, release baseline, approved version-domain snapshot | -| Command / Check | Run `node scripts/04-build/pre-release-check.mjs`; run `node scripts/semantic/gate-publish-set.mjs`; run `python scripts/semantic/gate_pypi_set/main.py`; complete the applicable stages in `CHECKLIST-SDK-RELEASE.md`; generate required artifacts under `artifacts/release/` | -| Pass Criterion | All required dev-side gates exit PASS; no blocked publish surfaces appear in publish sets; required release evidence artifacts exist | -| Record To Fill | Pre-release check result; `publish-set.json`; `publish-gate-report.json`; `pypi-set.json`; `pypi-gate-report.json`; SDK checklist status | -| Blocker / Stop Rule | Any gate FAIL, missing artifact, or unresolved version-domain mismatch blocks advancement | - -## 3. `mplp_prerelease` Cleanliness / Export Validation - -| Item | Content | -|:---|:---| -| Required Inputs | Frozen `source_commit`; `release-config.yaml`; clean export candidate from `MPLP-Protocol-Dev` | -| Command / Check | Export the same frozen candidate to `mplp_prerelease` using the approved clean-export process; verify include/exclude scope against `release-config.yaml`; confirm excluded surfaces are absent from the clean public export; confirm no semantic rework occurred after freeze | -| Pass Criterion | `mplp_prerelease` contains a clean export traceable to `source_commit`; excluded surfaces remain excluded; export cleanliness validation passes | -| Record To Fill | `prerelease_validation_commit`; export validation note; cleanliness verdict | -| Blocker / Stop Rule | If prerelease differs semantically from the frozen candidate, or if excluded/internal surfaces leak into the clean export, stop and do not promote | - -## 4. Promote To `MPLP-Protocol` - -| Item | Content | -|:---|:---| -| Required Inputs | Passing `prerelease_validation_commit`; frozen candidate lineage; approved tag target | -| Command / Check | Promote the validated clean export to `Coregentis/MPLP-Protocol`; create the main repository tag using the required pattern `protocol-vX.Y.Z`; create the public release entry using the same validated candidate lineage | -| Pass Criterion | `public_export_commit` is recorded; public repository state is traceable to `source_commit`; domain-qualified tag is applied; no bare `vX.Y.Z` tag is used as authoritative release meaning | -| Record To Fill | `public_export_commit`; `protocol_tag_target`; public release URL | -| Blocker / Stop Rule | If lineage to `source_commit` cannot be shown, or if a bare tag is used, or if promote occurs before prerelease validation is complete, stop | - -## 5. SDK Publish Set Execution - -| Item | Content | -|:---|:---| -| Required Inputs | Public repo promotion complete; approved `sdk_publish_set`; current `VERSION_REGISTRY.yaml`; required SDK release artifacts | -| Command / Check | Re-run `node scripts/semantic/gate-publish-set.mjs`; re-run `python scripts/semantic/gate_pypi_set/main.py`; run isolated verification for each npm package with `npm pack`; run isolated verification for each PyPI package with `python -m build`; publish only approved public surfaces after Stage 6 approval in `CHECKLIST-SDK-RELEASE.md` | -| Pass Criterion | Only approved public publish surfaces are published; isolated verification succeeds; published versions match intended values; no source mirrors or CI-only packages enter the publish set | -| Record To Fill | Actual published npm package list; actual published PyPI package list; isolated verification report; registry URLs; deprecation actions if any | -| Blocker / Stop Rule | If `MPLP-Protocol` promotion is incomplete, if any publish-set gate fails, if Stage 4 isolated verification fails, or if a blocked package enters the publish flow, stop | - -## 6. Docs / Website / Validation Lab Deploy Window - -| Item | Content | -|:---|:---| -| Required Inputs | Release-window scope decision; `docs_release_version`; `website_release_version`; `validation_lab_release_version`; pinned SHAs for changed surfaces | -| Command / Check | Deploy only the surfaces changed in this release window; deploy docs from the approved docs line; deploy website at `website_pinned_sha`; deploy Validation Lab at `validation_lab_pinned_sha`; verify public URLs after deploy | -| Pass Criterion | Each changed public surface is deployed within the same release window; unchanged surfaces are explicitly recorded as unchanged; release-note facts match deployed SHAs / version domains | -| Record To Fill | Docs deploy reference; website deploy reference; Validation Lab deploy reference; changed vs unchanged surface matrix | -| Blocker / Stop Rule | If a changed surface cannot be deployed or verified, do not mark release complete | - -## 7. Backfill Of Commits, SHAs, Manifests, And Notes - -| Item | Content | -|:---|:---| -| Required Inputs | Final public release facts from all completed prior stages | -| Command / Check | Fill `source_commit`, `prerelease_validation_commit`, `public_export_commit`, `website_pinned_sha`, and `validation_lab_pinned_sha`; update `artifacts/release/RELEASE_BUNDLE_MANIFEST.json`; confirm `publish-set.json`, `publish-gate-report.json`, `pypi-set.json`, and `pypi-gate-report.json`; update `governance/03-distribution/sdk/VERSION_REGISTRY.yaml` if SDK publication occurred; write the final release note with version-domain matrix and pinned SHAs | -| Pass Criterion | All required release facts are recorded; manifests and registry files are aligned; release notes contain the required version-domain and pinned-SHA fields; completion can be audited without guessing | -| Record To Fill | Final commit-chain facts; final release note URL/path; manifest backfill confirmation; version-registry backfill confirmation | -| Blocker / Stop Rule | If any required release fact remains guessed, omitted, or unrecorded, the release is not complete | - -## Final Release Completion Check - -All of the following must be true: - -- [ ] Candidate frozen in `MPLP-Protocol-Dev` -- [ ] Dev-side gates passed -- [ ] `mplp_prerelease` cleanliness/export validation passed -- [ ] `MPLP-Protocol` promotion complete -- [ ] SDK publish completed only for approved public surfaces, if in scope -- [ ] docs / website / Validation Lab deploy window completed for changed surfaces -- [ ] commit chain and pinned SHAs backfilled -- [ ] manifests, registry records, and release notes backfilled - -If any box remains unchecked, the release is not complete. diff --git a/governance/03-distribution/sdk/MPLP-RELEASE-READINESS-BASELINE-v1.0.md b/governance/03-distribution/sdk/MPLP-RELEASE-READINESS-BASELINE-v1.0.md deleted file mode 100644 index 2e7cdd426..000000000 --- a/governance/03-distribution/sdk/MPLP-RELEASE-READINESS-BASELINE-v1.0.md +++ /dev/null @@ -1,303 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-RELEASE-READINESS-BASELINE-v1.0" -title: "MPLP Release Readiness Baseline v1.0" ---- - -# MPLP Release Readiness Baseline v1.0 - -## 1. Release Intent - -This document establishes the single release-readiness baseline for the next MPLP -public release window. - -This baseline is for: - -- a clean public OSS release window for the frozen `protocol_version: 1.0.0` -- promotion of one frozen source candidate from the private development trunk to - the clean public repository -- coordinated release-window preparation for SDK, docs, website, and Validation - Lab surfaces under their own version domains - -This release is: - -- `protocol/public OSS release`: YES -- `patch release`: only for downstream independently versioned surfaces if they - changed; not assumed for `protocol_version` -- `clean publication release`: YES - -Release-window inclusion: - -- `SDK`: included in the release window, publish only if the approved public - publish surfaces changed -- `docs`: included in the release window as an independent deploy line if changed -- `website`: included in the release window as an independent deploy line if changed -- `Validation Lab`: included in the release window as an independent deploy line - if changed - -This baseline does not create a new release doctrine. -It applies the already-approved multi-repo release model to the next public -release candidate. - -## 2. Version Domain Snapshot - -Canonical version domains captured from -`governance/05-versioning/version-taxonomy-manifest.json`: - -- `protocol_version`: `1.0.0` -- `schema_bundle_version`: `2.0.0` -- `invariant_bundle_version`: `2.0.0` -- `validation_ruleset_version`: `ruleset-1.0` -- `validation_lab_release_version`: `1.0.1` -- `docs_release_version`: `1.0.0` -- `website_release_version`: `1.0.0` -- `sdk_version` matrix: - - `@mplp/sdk-ts`: `1.0.7` - - `mplp-sdk`: `1.0.5` - -Current public npm publish-surface versions captured from `packages/npm/*`: - -- `@mplp/core`: `1.0.6` -- `@mplp/schema`: `1.0.6` -- `@mplp/modules`: `1.0.5` -- `@mplp/coordination`: `1.0.6` -- `@mplp/runtime-minimal`: `1.0.5` -- `@mplp/integration-llm-http`: `1.0.5` -- `@mplp/integration-storage-fs`: `1.0.5` -- `@mplp/integration-storage-kv`: `1.0.5` -- `@mplp/integration-tools-generic`: `1.0.5` -- `@mplp/devtools`: `1.0.5` -- `@mplp/conformance`: `1.0.0` -- `@mplp/compliance`: `1.0.5` -- `@mplp/sdk-ts`: `1.0.7` - -Current public PyPI publish-surface version: - -- `mplp-sdk`: `1.0.5` - -This section is a snapshot only. -It does not guess or pre-authorize new version values. - -## 3. Repo Topology For This Release - -The release topology for this baseline is the approved five-repository model: - -| Repository | Role | Release Function In This Window | -|:---|:---|:---| -| `Coregentis/MPLP-Protocol-Dev` | Private development trunk | Authoritative frozen source candidate | -| `Coregentis/mplp_prerelease` | Prerelease staging repository | Cleanliness and export validation | -| `Coregentis/MPLP-Protocol` | Clean public repository | Official public OSS release target | -| `Coregentis/MPLP-Official-Website` | Website release line | Website deploy target | -| `Coregentis/MPLP-Validation-Lab` | Validation Lab release line | Validation Lab deploy target | - -Additional clarification: - -- `docs` is source-included in `MPLP-Protocol` but deploy-separated as an - independent documentation release line -- `Validation_Lab_V2` is outside the current outward release line and is not - part of this baseline - -## 4. Candidate Commit Chain - -The following fields are required and must remain explicit placeholders until -the release candidate is frozen and validated: - -| Field | Required Value | -|:---|:---| -| `source_commit` | `` | -| `prerelease_validation_commit` | `` | -| `public_export_commit` | `` | -| `website_pinned_sha` | `` | -| `validation_lab_pinned_sha` | `` | - -Rules: - -- these fields must not be guessed -- `source_commit` must anchor the whole release candidate -- `prerelease_validation_commit` must record the staging state that passed - cleanliness/export validation -- `public_export_commit` must record the actual public clean repository state - -## 5. Publish Surface Decision - -### 5.1 Main Repo Release Surface - -Main repository release surface for this window: - -- `Coregentis/MPLP-Protocol` -- release tag pattern: `protocol-vX.Y.Z` -- public source bundle built from the root repository using `release-config.yaml` - -The main repository is not a registry package surface. - -### 5.2 Actual SDK Publish Surfaces - -Actual public SDK publish surfaces for this release window are limited to: - -- npm public surfaces in `packages/npm/*` - - `@mplp/core` - - `@mplp/schema` - - `@mplp/modules` - - `@mplp/coordination` - - `@mplp/runtime-minimal` - - `@mplp/integration-llm-http` - - `@mplp/integration-storage-fs` - - `@mplp/integration-storage-kv` - - `@mplp/integration-tools-generic` - - `@mplp/devtools` - - `@mplp/sdk-ts` - - `@mplp/conformance` - - `@mplp/compliance` as deprecated compatibility alias -- PyPI public surface in `packages/pypi/*` - - `mplp-sdk` - -Publication remains change-based. -This baseline does not assume all public packages will be republished. - -### 5.3 Docs Deploy Line - -Docs release surface: - -- source-included in `MPLP-Protocol` -- deploy-separated as the documentation line -- versioned by `docs_release_version` - -### 5.4 Website Deploy Line - -Website release surface: - -- `Coregentis/MPLP-Official-Website` -- pinned through `website_pinned_sha` -- versioned by `website_release_version` - -### 5.5 Validation Lab Deploy Line - -Validation Lab release surface: - -- `Coregentis/MPLP-Validation-Lab` -- pinned through `validation_lab_pinned_sha` -- versioned by `validation_lab_release_version` - -### 5.6 Excluded Surfaces - -Excluded from this release baseline: - -- `Coregentis/MPLP-Validation-Lab-V2` -- `packages/sources/sdk-ts` -- `packages/sources/sdk-py` -- `@mplp/validator` -- `mplp_prerelease` as a public release surface -- submodule contents `MPLP_website/**` and `Validation_Lab/**` from the root OSS - bundle built via `release-config.yaml` -- the root workspace `package.json.version` as public release meaning - -## 6. Gate Inventory - -The following gates/checks must pass before promotion or publish. - -### 6.1 Dev-Side Baseline Gates - -- root prerelease check: - - `node scripts/04-build/pre-release-check.mjs` -- release bundle eligibility against `release-config.yaml` -- explicit version-domain review against: - - `governance/05-versioning/version-taxonomy-manifest.json` - - `governance/03-distribution/sdk/VERSION_REGISTRY.yaml` - -### 6.2 SDK Publish Gates - -- npm publish-set gate: - - `node scripts/semantic/gate-publish-set.mjs` -- PyPI publish-set gate: - - `python scripts/semantic/gate_pypi_set/main.py` -- SDK release-readiness framework: - - `governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md` - - Stages 0-8 remain mandatory -- Stage 4 isolated verification remains non-negotiable - -### 6.3 Candidate Promotion Gates - -- `MPLP-Protocol-Dev -> mplp_prerelease` - - source candidate frozen - - baseline fields prepared - - release gates passing -- `mplp_prerelease -> MPLP-Protocol` - - prerelease cleanliness/export validation passing - - no semantic rework after candidate freeze - - clean public export traceable to one frozen source candidate - -### 6.4 Surface Release Checks - -For any changed release line in the window: - -- docs build/deploy verification -- website build/deploy verification -- Validation Lab build/deploy verification - -### 6.5 Post-Publish Verification - -- npm registry install/import verification -- PyPI registry install/import verification -- release note and registry backfill verification - -## 7. Exclusion / Non-Release Scope - -The following are not part of this release: - -- any new semantic or governance baseline -- Validation_Lab_V2 outward promotion -- source mirror publication -- CI-only package publication -- implicit republish of every public package by default -- atomic simultaneous deploy requirement for docs, website, and Validation Lab -- any guessed commit, SHA, or unpublished version value - -## 8. Release Decision Rule - -### 8.1 Dev -> prerelease - -Promotion from `MPLP-Protocol-Dev` to `mplp_prerelease` is allowed only when: - -- one source candidate is frozen -- version-domain snapshot is confirmed -- candidate commit chain fields remain explicit and unresolved only where - freeze/promotion has not yet occurred -- dev-side gates listed in Section 6 pass - -### 8.2 prerelease -> MPLP-Protocol - -Promotion from `mplp_prerelease` to `MPLP-Protocol` is allowed only when: - -- prerelease validation confirms clean export suitability -- no blocked/forbidden surfaces remain in the public export set -- `prerelease_validation_commit` is recorded -- the public export remains traceable to the frozen `source_commit` - -### 8.3 SDK Publish - -SDK publish is allowed only when: - -- `MPLP-Protocol` public promotion is complete -- npm and PyPI publish-set gates pass -- SDK release-readiness checklist is complete -- isolated verification passes -- the publish set contains only approved public publish surfaces - -### 8.4 Release Completion - -This release is complete only when: - -- `MPLP-Protocol` public OSS release is published -- required changed release lines in docs / website / Validation Lab are deployed - within the same release window -- registry publication, if any, is complete and verified -- `source_commit`, `prerelease_validation_commit`, `public_export_commit`, - `website_pinned_sha`, and `validation_lab_pinned_sha` are filled -- release notes and registry / manifest records are backfilled - -This document is the authoritative preparation baseline for the next release -window until superseded by an updated baseline or a finalized execution record. diff --git a/governance/03-distribution/sdk/MPLP-v1.0.0-APRIL-CROSS-REPO-PRESERVATION-CLOSURE-RECORD-2026-04-07.md b/governance/03-distribution/sdk/MPLP-v1.0.0-APRIL-CROSS-REPO-PRESERVATION-CLOSURE-RECORD-2026-04-07.md deleted file mode 100644 index 3a382e921..000000000 --- a/governance/03-distribution/sdk/MPLP-v1.0.0-APRIL-CROSS-REPO-PRESERVATION-CLOSURE-RECORD-2026-04-07.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: frozen -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-v1.0.0-APRIL-CROSS-REPO-PRESERVATION-CLOSURE-RECORD-2026-04-07" -title: "MPLP v1.0.0 April Cross-Repo Preservation Closure Record 2026-04-07" ---- - -# MPLP v1.0.0 April Cross-Repo Preservation Closure Record 2026-04-07 - -## 1. Executive Decision - -This record freezes the preservation conclusion for the April 2026 cross-repo -work line across the in-scope repositories. - -This record confirms: - -- root repo April work is effectively preserved -- `MPLP_website` April work is preserved -- `Validation_Lab` April work is preserved - -This record does not reopen or mix in: - -- Registry publication-credentials blockers -- downstream route-level UI/UX follow-up work -- new deployment or remediation analysis - -## 2. Scope of Preservation Audit - -This preservation audit is limited to: - -- root repo: `V1.0_release` -- `MPLP_website` -- `Validation_Lab` - -The audit question is narrow: - -- whether the important April update line for each in-scope repo is already - preserved in that repo's authoritative remote truth - -## 3. Repo-by-Repo Preservation Result - -### 3.1 Root Repo - -Authoritative preservation result: - -- local `HEAD` - - `880b11b74e2394258011242b79801bc5039a9bf5` -- `origin/main` - - `880b11b74e2394258011242b79801bc5039a9bf5` -- `origin-oss/main` - - `880b11b74e2394258011242b79801bc5039a9bf5` - -Conclusion: - -- April root-repo governance and publication-record updates are preserved on - both authoritative remote lines checked in this audit pass - -### 3.2 MPLP_website - -Authoritative preservation result: - -- local `HEAD` - - `78b91a5099ae697fe0fccc3ab1044a8fce9a8e1e` -- `origin/main` - - `78b91a5099ae697fe0fccc3ab1044a8fce9a8e1e` - -Conclusion: - -- April website release-line work is preserved in authoritative remote truth, - including the dependency-restoration line required for successful production - deployment - -### 3.3 Validation_Lab - -Authoritative preservation result: - -- local `HEAD` - - `18686bbb4145f06a5c8150a4c79af362bedcaf04` -- `origin/main` - - `18686bbb4145f06a5c8150a4c79af362bedcaf04` - -Conclusion: - -- April Validation Lab work is preserved in authoritative remote truth, - including the deploy-chain proof update and the build-restoration fix - -## 4. Residual Drift Classification - -### 4.1 Root `MPLP_website` Worktree Drift - -Residual local root worktree state: - -- root gitlink recorded in `HEAD` - - `da5d4618cecf4e1ceec2866f33f8b9f0453a4a71` -- nested `MPLP_website` repo local `HEAD` - - `78b91a5099ae697fe0fccc3ab1044a8fce9a8e1e` - -Classification: - -- separate repo pointer drift only - -Reason: - -- this does not indicate unpreserved April work in the root repo itself -- the Website April work is already preserved in the authoritative Website - remote truth -- the residual root worktree difference is only a local gitlink/pointer - mismatch in the root workspace - -### 4.2 Untracked Checklist File - -Residual local file: - -- `governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-ACCESS-PREREQUISITES-CHECKLIST-2026-04-07.md` - -Classification: - -- non-blocking local noise - -Reason: - -- the file remains untracked -- the file is explicitly draft-only -- it is not referenced by the frozen governance chain used for this - preservation conclusion -- it does not represent lost April work in authoritative remote truth - -## 5. Final Preservation Verdict - -- `APRIL_WORK_IS_EFFECTIVELY_PRESERVED_ACROSS_ALL_IN_SCOPE_REPOS` - -## 6. Closure Statement - -- `No further repo-side preservation action is required in this pass.` diff --git a/governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-06.md b/governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-06.md deleted file mode 100644 index 1ddd08493..000000000 --- a/governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-06.md +++ /dev/null @@ -1,194 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: frozen -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-06" -title: "MPLP v1.0.0 External 3+1 Release Batch Status Open Record 2026-04-06" ---- - -# MPLP v1.0.0 External 3+1 Release Batch Status Open Record 2026-04-06 - -## 1. Executive Decision - -This record freezes the current status of the external 3+1 release batch for -MPLP v1.0.0. - -Current truth: - -- `root protocol publication line`: closed -- `external 3+1 release batch`: open - -This record confirms that repository-level protocol publication is complete, but -the user-facing 3+1 external release batch is not yet closed. - -## 2. Governing Basis - -This record is based on: - -- the already-closed root protocol publication line -- the frozen public promotion governance chain -- live surface inventory performed for: - - Website - - Docs - - Validation Lab - - Registry publication - -This record does not revise prior frozen governance. -It only freezes the current external batch status. - -## 3. Phase A Inventory Summary - -### Repository - -Repository truth is already aligned and closed: - -- `origin/main` - - `a695c66444260e0fe185193d276d54263fd474bf` -- `origin-oss/main` - - `a695c66444260e0fe185193d276d54263fd474bf` -- `protocol-v1.0.0` - - published on both `origin` and `origin-oss` -- legacy `v1.0.0` - - untouched - -### Website - -- local repo status: - - clean -- local `HEAD` - - `da5d4618cecf4e1ceec2866f33f8b9f0453a4a71` -- remote `origin/main` - - updated to `da5d4618cecf4e1ceec2866f33f8b9f0453a4a71` - -Current assessment: - -- push completed -- live deploy alignment not yet confirmed as complete -- current live site still presents stale homepage reading order/runtime-heavy - wording, indicating external deploy is not yet aligned to the pushed repo - state - -### Docs - -- docs source exists inside the root publication line -- existing deploy workflow exists: - - `.github/workflows/deploy-docs.yml` -- built artifact exists: - - `docs/build/` - -Current assessment: - -- docs source aligned -- live docs surface appears aligned to current release truth -- docs deployment may be treated as complete for this batch status review - -### Validation Lab - -- local repo `HEAD` - - `8010b74b854b1128d89632c474a8844c924a43a2` -- remote `origin/main` - - `e04d386e9dfbdf4ffa050babfe2e616265f4f363` -- local worktree: - - not clean - - large dirty deletion/untracked state observed - -Current assessment: - -- push blocked -- deploy blocked -- live lab surface still shows stale public-entry / strip state and therefore is - not aligned to current root public truth - -### Registry - -Observed assets: - -- npm / PyPI package manifests present -- release artifacts present under `artifacts/release` -- publish gates present - -Credential / execution state: - -- `npm whoami` failed -- `twine` installed, but no publication credential evidence was confirmed - -Current assessment: - -- npm publication blocked -- PyPI publication blocked - -## 4. Website Alignment Result - -- push: `DONE` -- deploy: `BLOCKED` - -Blocker: - -- current live website does not yet reflect the pushed website repo state, so - external discovery/positioning truth is still stale from the user-facing - perspective - -## 5. Docs Alignment Result - -- source aligned: `YES` -- deploy: `DONE` - -Blocker if any: - -- none material enough to keep docs marked incomplete in this batch status - record - -## 6. Validation Lab Alignment Result - -- push: `BLOCKED` -- deploy: `BLOCKED` - -Blocker: - -- Validation Lab repo worktree is not in a clean, pushable state -- no safe push/deploy action was authorized without separate cleanup or residue - adjudication - -## 7. Registry Alignment Result - -- npm: `BLOCKED` -- pypi: `BLOCKED` - -Blocker: - -- registry publication credentials were not available / not verified in the - current execution environment - -## 8. Final 3+1 Consistency Audit - -Final consistency audit result: - -- `EXTERNAL_3PLUS1_INCONSISTENT` - -Why: - -- repository truth is complete -- docs appear aligned -- website external surface is not yet aligned in live deployment -- Validation Lab external surface is not yet aligned -- registry publication is not yet aligned - -Therefore, the user-facing 3+1 batch still presents inconsistent external truth. - -## 9. Final Batch Verdict - -- `EXTERNAL_3PLUS1_RELEASE_BATCH_STILL_OPEN` - -This means: - -- the root protocol publication line is closed -- the full external 3+1 release batch is not yet closed -- it must not be described as “fully released everywhere” - -## 10. Next Exact Action - -- start a dedicated Website/Validation-Lab/Registry external alignment closure - pass, beginning with website deploy verification/remediation, then Validation - Lab push/deploy resolution, then registry publication resolution diff --git a/governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-07.md b/governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-07.md deleted file mode 100644 index 004e4109a..000000000 --- a/governance/03-distribution/sdk/MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-07.md +++ /dev/null @@ -1,172 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: frozen -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-v1.0.0-EXTERNAL-3PLUS1-RELEASE-BATCH-STATUS-OPEN-RECORD-2026-04-07" -title: "MPLP v1.0.0 External 3+1 Release Batch Status Open Record 2026-04-07" ---- - -# MPLP v1.0.0 External 3+1 Release Batch Status Open Record 2026-04-07 - -## 1. Executive Decision - -This record freezes the updated status of the external 3+1 release batch after -the Website deploy verification/remediation pass and Validation Lab -cleanup/pushability restoration pass. - -Current truth: - -- `root protocol publication line`: closed -- `external 3+1 release batch`: still open - -This record supersedes the prior open-status understanding only as a status -refresh. It does not revise the already-frozen root protocol publication truth. - -## 2. Governing Basis - -This record is based on: - -- the frozen root protocol publication closure record -- the frozen external 3+1 batch status open record dated 2026-04-06 -- the current pass results for: - - Website external alignment - - Validation Lab cleanup / pushability restoration - - Registry publication readiness - -## 3. Updated Surface Status - -### Repository - -Repository/public protocol truth remains complete: - -- `origin/main` - - `a695c66444260e0fe185193d276d54263fd474bf` -- `origin-oss/main` - - `a695c66444260e0fe185193d276d54263fd474bf` -- `protocol-v1.0.0` - - published on both `origin` and `origin-oss` -- legacy `v1.0.0` - - untouched - -### Website - -- repo truth: `YES` -- remote truth: `YES` -- formal build truth: `YES` -- deploy-chain-proof: `YES` -- live truth aligned: `YES` -- final classification: - - `CHAIN_PROVEN_AND_LIVE_ALIGNED` - -Interpretation: - -- Website is closed at repo/build/deploy-chain-proof level and live alignment - level - -### Docs - -- repo/source truth: `YES` -- formal build/deploy-chain truth: `YES` -- live truth aligned: `YES` -- final classification: - - `CHAIN_PROVEN_AND_LIVE_ALIGNED` - -Interpretation: - -- Docs is closed at repo/source truth, build/deploy-chain truth, and live - alignment level - -### Validation Lab - -- repo truth: `YES` -- remote truth: `YES` -- deploy-chain-proof: `YES` -- live truth aligned: `YES` -- final classification: - - `CHAIN_PROVEN_AND_LIVE_ALIGNED` - -Interpretation: - -- Validation Lab is closed at repo/deploy-chain-proof level and live alignment - level - -### Registry - -- npm: `BLOCKED` -- pypi: `BLOCKED` -- final classification: - - `CREDENTIALS_BLOCKED` - -Current blocker: - -- publication credentials are absent in the current environment: - - `NPM_TOKEN` missing - - `NODE_AUTH_TOKEN` missing - - `TWINE_USERNAME` missing - - `TWINE_PASSWORD` missing - - `PYPI_TOKEN` missing - -Interpretation: - -- Registry is blocked strictly at publication-credentials level - -## 4. Final External Consistency Audit - -Final consistency audit result: - -- `EXTERNAL_3PLUS1_INCONSISTENT` - -Why: - -- repository truth is complete -- Website = `CHAIN_PROVEN_AND_LIVE_ALIGNED` -- Docs = `CHAIN_PROVEN_AND_LIVE_ALIGNED` -- Validation Lab = `CHAIN_PROVEN_AND_LIVE_ALIGNED` -- Registry = `CREDENTIALS_BLOCKED` - -Therefore the user-facing 3+1 batch is still not externally coherent. - -## 5. Final Batch Verdict - -- `EXTERNAL_3PLUS1_RELEASE_BATCH_STILL_OPEN` - -This means: - -- root protocol publication closure remains valid -- the external 3+1 release batch still cannot be truthfully described as fully - complete -- Registry credentials are now the sole remaining blocker - -## 6. Next Exact Action - -- keep Website, Docs, and Validation_Lab frozen as - CHAIN_PROVEN_AND_LIVE_ALIGNED; keep Registry in CREDENTIALS_BLOCKED status; - external 3+1 batch closure remains forbidden until the Registry publication - credentials blocker is resolved. - -## 7. Final Recheck After Refreeze - -After the open-record refreeze was absorbed into authoritative remote truth, a -final read-only external 3+1 recheck was performed. - -Surface results: - -- Website = `CHAIN_PROVEN_AND_LIVE_ALIGNED` -- Docs = `CHAIN_PROVEN_AND_LIVE_ALIGNED` -- Validation Lab = `CHAIN_PROVEN_AND_LIVE_ALIGNED` -- Registry = `CREDENTIALS_BLOCKED` - -Audit result: - -- `EXTERNAL_3PLUS1_INCONSISTENT` - -Batch verdict: - -- `EXTERNAL_3PLUS1_RELEASE_BATCH_STILL_OPEN` - -Stop condition: - -- No further repo-side work is justified in this pass; remaining blockers are - publication-credentials blockers for Registry only. diff --git a/governance/03-distribution/sdk/templates/DEPENDENCY_CHECK_TEMPLATE.md b/governance/03-distribution/sdk/templates/DEPENDENCY_CHECK_TEMPLATE.md deleted file mode 100644 index 81606b7c8..000000000 --- a/governance/03-distribution/sdk/templates/DEPENDENCY_CHECK_TEMPLATE.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "DEPENDENCY_CHECK_TEMPLATE" ---- - -# Dependency Integrity Check - -**Document ID**: DEPENDENCY_CHECK -**Release Date**: YYYY-MM-DD -**Reference**: METHOD-SDKR-09 §5.3 - ---- - -## 1. Packages Checked - -| Package | Ecosystem | -|:---|:---| -| @mplp/core | npm | -| ... | ... | - ---- - -## 2. Dependency Matrix - -### @mplp/[package-name] - -| Dependency | Declared Version | Resolved Version | Status | -|:---|:---|:---|:---| -| @mplp/core | ^1.0.0 | 1.0.6 | ✅ OK | -| pydantic | >=2.0,<3.0 | 2.12.5 | ✅ OK | - ---- - -## 3. Internal Dependency Resolution - -For packages using `file:../` dependencies: - -| Package | Internal Dep | Resolved For Publish | -|:---|:---|:---| -| @mplp/sdk-ts | @mplp/core (file:../core) | ^1.0.6 | - -- [ ] All `file:` dependencies converted to version ranges before publish - ---- - -## 4. Cross-Package Drift Check - -- [ ] No implicit breaking changes between packages -- [ ] All packages compatible at declared versions - ---- - -## 5. Confirmation - -- [ ] All dependencies verified -- [ ] No unresolved `file:` dependencies for publish -- [ ] No cross-package drift detected - ---- - -## Sign-off - -| Role | Name | Date | -|:---|:---|:---| -| Release Engineer | | | - ---- - -**Reference**: METHOD-SDKR-09 §5.3 diff --git a/governance/03-distribution/sdk/templates/DERIVATION_PROOF_TEMPLATE.yaml b/governance/03-distribution/sdk/templates/DERIVATION_PROOF_TEMPLATE.yaml deleted file mode 100644 index 71be5aa4b..000000000 --- a/governance/03-distribution/sdk/templates/DERIVATION_PROOF_TEMPLATE.yaml +++ /dev/null @@ -1,83 +0,0 @@ -# DERIVATION_PROOF.yaml Template -# -# This file proves that all package content is derived from MPLP Truth Sources. -# Every SDK package MUST include a completed version of this file. -# -# Reference: METHOD-SDKR-02 (Derivation Rules) - -protocol_version: "1.0.0" - -# Truth Source Bundle Reference -schema_bundle: - path: "schemas/v2" - digest: "sha256:PENDING" # Hash of the schema bundle at derivation time - -evidence_baseline: - reference: "governance/freeze/FREEZE_EVIDENCE_BASELINE_v1.0.md" - version: "v1.0" - -# Derivation Process -derivation: - generator: - name: "scripts/derive.ts" # Path to generation script - version: "git:PENDING" # Git commit hash of generator - timestamp: "PENDING" # ISO 8601 timestamp - - # Input schemas used for derivation - inputs: - - path: "schemas/v2/mplp-core.schema.json" - digest: "sha256:PENDING" - - path: "schemas/v2/mplp-context.schema.json" - digest: "sha256:PENDING" - # Add all schemas used... - - # Overlay templates (non-schema sources) - overlays: - - path: "packages/sources/sdk-ts/templates/*" - description: "TypeScript boilerplate templates" - -# Package Identity -package: - name: "@mplp/PACKAGE_NAME" - version: "PENDING" - -# Generated Outputs -outputs: - - path: "dist/index.js" - digest: "sha256:PENDING" - - path: "dist/index.d.ts" - digest: "sha256:PENDING" - # Add all generated files... - -# Python Distribution Artifacts (for PyPI packages only) -# Reference: METHOD-SDKR-08 §6.6 -python_dist: - - type: sdist - filename: "package-x.y.z.tar.gz" - sha256: "PENDING" # Compute with: shasum -a 256 - - type: wheel - filename: "package-x.y.z-py3-none-any.whl" - sha256: "PENDING" # Compute with: shasum -a 256 - -# Manual Declared Files (requires explicit approval) -manual_declared_files: - - path: "src/builders.ts" - declaration: "Schema-compatible builder pattern" - review_status: "PENDING" # APPROVED | PENDING | REJECTED - -# Forbidden Patterns (MUST be empty in package) -forbidden_patterns: - - "dist/helpers/*" - - "src/utils/*" - -# Verification Results -verification: - schema_validation: "PENDING" # PASS | FAIL - api_surface_check: "PENDING" # PASS | FAIL - forbidden_content_scan: "PENDING" # PASS | FAIL - golden_flows_covered: - - "GF-01" - - "GF-02" - - "GF-03" - - "GF-04" - - "GF-05" diff --git a/governance/03-distribution/sdk/templates/ISOLATED_VERIFICATION_REPORT_TEMPLATE.md b/governance/03-distribution/sdk/templates/ISOLATED_VERIFICATION_REPORT_TEMPLATE.md deleted file mode 100644 index 712453e34..000000000 --- a/governance/03-distribution/sdk/templates/ISOLATED_VERIFICATION_REPORT_TEMPLATE.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "ISOLATED_VERIFICATION_REPORT_TEMPLATE" ---- - -# Isolated Verification Report - -**Document ID**: ISOLATED_VERIFICATION_REPORT -**Release Date**: YYYY-MM-DD -**Reference**: METHOD-SDKR-09 §5.5 - ---- - -> ⚠️ **No release may bypass this verification, regardless of change size.** - ---- - -## 1. Environment Information - -| Property | Value | -|:---|:---| -| Verification Date | YYYY-MM-DD HH:MM | -| Node.js Version | vX.Y.Z | -| Python Version | 3.X.Y | -| npm Version | X.Y.Z | -| pip Version | X.Y.Z | -| OS | macOS / Linux | -| Verification Directory | /tmp/verify-... | - ---- - -## 2. npm Package Verification - -### @mplp/[package-name] - -| Step | Command | Result | -|:---|:---|:---| -| Pack | `npm pack` | ✅ / ❌ | -| Install | `npm install ./pkg-x.y.z.tgz` | ✅ / ❌ | -| Import (CJS) | `node -e "require('@mplp/pkg')"` | ✅ / ❌ | -| Import (ESM) | `node --experimental-vm-modules -e "import('@mplp/pkg')"` | ✅ / ❌ | -| Types | `.d.ts` files present | ✅ / ❌ | - -**Tarball Info**: -- Filename: `mplp-pkg-x.y.z.tgz` -- SHA: `sha512-...` -- Size: X.X kB - -**Export Verification**: -``` -Exports: function1, function2, CONSTANT_1, ... -``` - ---- - -## 3. PyPI Package Verification - -### mplp-sdk - -| Step | Command | Result | -|:---|:---|:---| -| Build | `python -m build` | ✅ / ❌ | -| Install wheel | `pip install ./dist/*.whl` | ✅ / ❌ | -| Import | `python -c "import mplp"` | ✅ / ❌ | -| Version | `mplp.__version__` | X.Y.Z | - -**Artifact Info**: -- Wheel: `mplp_sdk-x.y.z-py3-none-any.whl` -- SHA256: `...` - ---- - -## 4. Verification Summary - -| Package | Pack/Build | Install | Import | Types | Overall | -|:---|:---:|:---:|:---:|:---:|:---:| -| @mplp/core | ✅ | ✅ | ✅ | ✅ | **PASS** | -| @mplp/schema | ✅ | ✅ | ✅ | ✅ | **PASS** | -| mplp-sdk | ✅ | ✅ | ✅ | N/A | **PASS** | - ---- - -## 5. Issues Found & Resolution - -| Issue | Package | Resolution | -|:---|:---|:---| -| [None / Description] | | | - ---- - -## 6. Final Verification Status - -- [ ] All packages verified in isolated environment -- [ ] All imports succeed -- [ ] All versions match expected -- [ ] No issues blocking release - -**VERIFICATION STATUS**: ✅ PASS / ❌ FAIL - ---- - -## Sign-off - -| Role | Name | Date | -|:---|:---|:---| -| Verification Engineer | | | - ---- - -**Reference**: METHOD-SDKR-09 §5.5 diff --git a/governance/03-distribution/sdk/templates/RELEASE_BUNDLE_MANIFEST_TEMPLATE.json b/governance/03-distribution/sdk/templates/RELEASE_BUNDLE_MANIFEST_TEMPLATE.json deleted file mode 100644 index c28055865..000000000 --- a/governance/03-distribution/sdk/templates/RELEASE_BUNDLE_MANIFEST_TEMPLATE.json +++ /dev/null @@ -1,166 +0,0 @@ -{ - "$comment": "RELEASE_BUNDLE_MANIFEST.json Template - Records all packages in a coordinated release", - "bundle_version": "1.0.0", - "protocol_version": "1.0.0", - "release_timestamp": "PENDING", - "evidence_baseline": { - "reference": "governance/freeze/FREEZE_EVIDENCE_BASELINE_v1.0.md", - "version": "v1.0", - "digest": "sha256:PENDING" - }, - "artifacts": { - "npm": { - "public": [ - { - "name": "@mplp/core", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L1", - "derivation_proof": "packages/npm/core/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/schema", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L1", - "derivation_proof": "packages/npm/schema/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/modules", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L2", - "derivation_proof": "packages/npm/modules/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/coordination", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L2", - "derivation_proof": "packages/npm/coordination/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/conformance", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L2", - "derivation_proof": "packages/npm/conformance/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/runtime-minimal", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L3", - "derivation_proof": "packages/npm/runtime-minimal/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/devtools", - "version": "PENDING", - "category": "PUBLIC", - "layer": "Tool", - "derivation_proof": "packages/npm/devtools/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/sdk-ts", - "version": "PENDING", - "category": "PUBLIC", - "layer": "Facade", - "derivation_proof": "packages/npm/sdk-ts/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/integration-storage-kv", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L4", - "derivation_proof": "packages/npm/integration-storage-kv/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/integration-storage-fs", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L4", - "derivation_proof": "packages/npm/integration-storage-fs/DERIVATION_PROOF.yaml" - }, - { - "name": "@mplp/integration-llm-http", - "version": "PENDING", - "category": "PUBLIC", - "layer": "L4", - "derivation_proof": "packages/npm/integration-llm-http/DERIVATION_PROOF.yaml" - } - ], - "ci_only": [ - { - "name": "@mplp/validator", - "version": "PENDING", - "category": "CI-ONLY", - "layer": "Tool", - "publish_blocked": true - } - ], - "deprecated": [ - { - "name": "@mplp/compliance", - "version": "1.0.4", - "category": "DEPRECATED", - "migration": "@mplp/conformance", - "deprecation_message": "Legacy name. Use @mplp/conformance (Conformance Kit)." - } - ] - }, - "pypi": { - "public": [ - { - "name": "mplp-sdk", - "version": "PENDING", - "category": "PUBLIC", - "layer": "SDK + Runtime", - "derivation_proof": "packages/pypi/mplp-sdk/DERIVATION_PROOF.yaml", - "dist": { - "sdist": "mplp_sdk-PENDING.tar.gz", - "wheel": "mplp_sdk-PENDING-py3-none-any.whl", - "sdist_sha256": "PENDING", - "wheel_sha256": "PENDING" - } - } - ], - "ci_only": [], - "deprecated": [] - } - }, - "version_sync": { - "rule": "V-SYNC-01", - "major_minor_consistent": true, - "target_version": "PENDING" - }, - "dependency_graph": { - "$comment": "Simplified dependency graph snapshot", - "@mplp/sdk-ts": [ - "@mplp/core", - "@mplp/schema", - "@mplp/modules" - ], - "@mplp/runtime-minimal": [ - "@mplp/core", - "@mplp/schema", - "@mplp/coordination" - ], - "@mplp/conformance": [ - "@mplp/core", - "@mplp/schema", - "@mplp/modules", - "@mplp/coordination" - ], - "@mplp/devtools": [ - "@mplp/core", - "@mplp/schema", - "@mplp/validator" - ] - }, - "verification": { - "all_proofs_valid": "PENDING", - "version_sync_passed": "PENDING", - "forbidden_packages_blocked": "PENDING", - "bundle_integrity": "PENDING" - } -} \ No newline at end of file diff --git a/governance/03-distribution/sdk/templates/RELEASE_INTENT_TEMPLATE.md b/governance/03-distribution/sdk/templates/RELEASE_INTENT_TEMPLATE.md deleted file mode 100644 index 3dbc7500d..000000000 --- a/governance/03-distribution/sdk/templates/RELEASE_INTENT_TEMPLATE.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "RELEASE_INTENT_TEMPLATE" ---- - -# Release Intent Declaration - -**Document ID**: RELEASE_INTENT -**Release Date**: YYYY-MM-DD -**Prepared By**: [Name] - ---- - -## 1. Packages to Release - -| Package | Current Version | Target Version | Ecosystem | -|:---|:---|:---|:---| -| @mplp/core | x.y.z | x.y.z+1 | npm | -| @mplp/schema | x.y.z | x.y.z+1 | npm | -| ... | ... | ... | ... | - ---- - -## 2. Version Change Summary - -| Package | Bump Type | Reason | -|:---|:---|:---| -| @mplp/core | PATCH | [Brief reason] | -| @mplp/schema | PATCH | [Brief reason] | -| ... | ... | ... | - ---- - -## 3. Release Scope - -### Included -- [ ] npm packages -- [ ] PyPI packages - -### Excluded -- [ ] [Any packages intentionally excluded this release] - ---- - -## 4. Prerequisites Verified - -- [ ] Evidence Baseline frozen -- [ ] All derivation phases PASS -- [ ] No blocking governance issues - ---- - -## 5. Sign-off - -| Role | Name | Date | -|:---|:---|:---| -| Release Engineer | | | - ---- - -**Reference**: METHOD-SDKR-09 §5.1 diff --git a/governance/03-distribution/sdk/templates/VERSION_CHANGE_JUSTIFICATION_TEMPLATE.md b/governance/03-distribution/sdk/templates/VERSION_CHANGE_JUSTIFICATION_TEMPLATE.md deleted file mode 100644 index 4196c4fd2..000000000 --- a/governance/03-distribution/sdk/templates/VERSION_CHANGE_JUSTIFICATION_TEMPLATE.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "VERSION_CHANGE_JUSTIFICATION_TEMPLATE" ---- - -# Version Change Justification - -**Document ID**: VERSION_CHANGE_JUSTIFICATION -**Release Date**: YYYY-MM-DD -**Reference**: METHOD-SDKR-09 §5.2, METHOD-SDKR-03 - ---- - -## Version Changes - -### @mplp/[package-name] - -| Field | Value | -|:---|:---| -| Previous Version | x.y.z | -| New Version | x.y.z+1 | -| Bump Type | PATCH / MINOR | - -#### Justification - -**If PATCH**: -- [ ] Bugfix: [description] -- [ ] Internal improvement: [description] -- [ ] Governance compliance: [description] - -**If MINOR**: -- [ ] New user-facing capability: [description] -- [ ] New API surface: [description] - -> ⚠️ MINOR bumps for "fixing release mistakes" are PROHIBITED. - ---- - -## Legitimacy Confirmation - -- [ ] This version change follows METHOD-SDKR-03 Versioning Law -- [ ] This is NOT a MINOR bump to fix a previous release error -- [ ] The stated justification is accurate and complete - ---- - -## Sign-off - -| Role | Name | Date | -|:---|:---|:---| -| Release Engineer | | | - ---- - -**Reference**: METHOD-SDKR-09 §5.2 diff --git a/governance/04-records/AUDIT-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-SEAL.md b/governance/04-records/AUDIT-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-SEAL.md deleted file mode 100644 index 3b262c09a..000000000 --- a/governance/04-records/AUDIT-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-SEAL.md +++ /dev/null @@ -1,149 +0,0 @@ -# Audit Record: Four-Entry SEO/GEO/LINKMAP Remediation - -**Audit ID:** `AUDIT-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-SEAL` -**Runbook:** `RUN-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-v1.2.2.2` -**Status:** ✅ **SEALED** -**Date:** 2026-01-21 -**Authority:** MPLP Protocol Governance Committee (MPGC) -**Sealed By:** Antigravity (Advanced Agentic Coding) -**Seal Timestamp:** 2026-01-21T21:40:00+08:00 - ---- - -## 1. Scope - -This audit verifies the remediation of the MPLP Four-Entry Model across all ecosystem surfaces: -- **Website** (mplp.io) -- **Documentation** (docs.mplp.io) -- **Validation Lab** (lab.mplp.io) -- **Repository** (github.com/Coregentis/MPLP-Protocol) - ---- - -## 2. Definition of Done (DoD) — Verification Evidence - -### DoD-01: No "Three-Entry" Remnants (source-only) -```bash -rg -c "Three-Entry|three-entry" docs/ MPLP_website/ Validation_Lab/ governance/ schemas/ tests/ README.md -``` -**Result:** `DoD-01: 0 matches` -**Status:** ✅ PASS - -### DoD-02: Legal Name Unified (source-only) -```bash -rg -c "Bangshi Beijing Network Technology Limited Company" docs/ MPLP_website/ Validation_Lab/ governance/ -``` -**Result:** `DoD-02: 0 matches` -**Status:** ✅ PASS - -### DoD-03: Docs JSON-LD Removed -```bash -grep -n "application/ld+json" docs/docusaurus.config.ts -``` -**Result:** `NO JSON-LD FOUND` -**Status:** ✅ PASS - -### DoD-04: Gate-LINK-03 PASS -```bash -node governance/tools/linkmap/gate-linkmap.mjs --scope docs/docs -``` -**Result:** -``` -Gate-LINK-01: PASS — Build SUCCESS, 0 broken links -Gate-LINK-03: PASS — 105 pattern hits (all negated boundary language), 0 violations -✅ ALL GATES PASS -``` -**Status:** ✅ PASS - -### DoD-05: ECOSYSTEM_ANCHORS.json Exists -```bash -ls -la governance/entity/ECOSYSTEM_ANCHORS.json -``` -**Result:** File exists with golden_flows and validation_lab anchors -**Status:** ✅ PASS - ---- - -## 3. Files Changed - -| File | Action | -|:---|:---| -| `governance/entity/ECOSYSTEM_ANCHORS.json` | **NEW** — Four-Entry anchor SSOT | -| `governance/entity/entity.json` | Added `lab` entry | -| `README.md` | Anchor fix: `what-is-mplp` → `definition` | -| `docs/docusaurus.config.ts` | Removed JSON-LD script block | -| `docs/static/robots.txt` | **NEW** | -| `Validation_Lab/app/robots.ts` | Added `/methodology` | -| `MPLP_website/app/sitemapindex.xml/route.ts` | **NEW** | -| `MPLP_website/app/robots.ts` | Multi-sitemap array | -| `MPLP_website/components/seo/site-json-ld.tsx` | Added Lab to sameAs | -| `governance/rules/LINKMAP_FALSE_POSITIVE_CONTAINS.txt` | Added disclaimer patterns | - ---- - -## 4. Immutable Constraints (Post-Seal) - -The following constraints are now governance invariants: - -1. **JSON-LD SSOT**: Only Website may emit `application/ld+json`. Docs and Lab are prohibited. -2. **Anchor Source**: All cross-domain links must derive from `ECOSYSTEM_ANCHORS.json`. -3. **Legal Name**: Source files must use `Bangshi Beijing Network Technology Co., Ltd.` -4. **Four-Entry Model**: No regression to "Three-Entry" terminology in normative content. - -### Invariant-LINKMAP-01: FP File Governance - -> **`LINKMAP_FALSE_POSITIVE_CONTAINS.txt` (or successor files) MUST only contain:** -> - Explicit negation disclaimer phrases (e.g., "not a certification", "does not endorse") -> - Technical field names for code/schema contexts -> -> **MUST NOT contain:** -> - Section headers or structural patterns (e.g., `### 2.1`) -> - Table row fragments (e.g., `| **Certified** |`) -> - Generic context words (e.g., `Out-of-scope`, `Vendor-neutral`) -> - Partial sentences or broad negation verbs alone -> -> **Any new pattern MUST pass regression verification** against the 8-case test suite (4 should PASS as DISCLAIMED, 4 should FAIL as VIOLATION). - -> [!WARNING] -> **Current v1.2.2.2 contains structural bypass patterns** — This is acknowledged technical debt. -> PS-01/PS-02 post-seal patches are recommended to split the FP file and implement graded verdicts. - ---- - -## 5. Post-Deployment Verification (Required) - -After deployment, execute the following curl commands: - -```bash -# Website -curl -s https://www.mplp.io/robots.txt -curl -s https://www.mplp.io/sitemapindex.xml - -# Docs -curl -s https://docs.mplp.io/robots.txt - -# Lab -curl -s https://lab.mplp.io/robots.txt -``` - -**Criteria:** -- Website robots.txt contains 4 sitemap entries -- Docs robots.txt exists with correct sitemap pointer -- Lab robots.txt allows `/methodology` - ---- - -## 6. Recommended Future Gates - -### Gate-A: Anchor Drift Gate -- Verify all external links in README/site-config match `ECOSYSTEM_ANCHORS.json` -- CI FAIL on drift - -### Gate-B: Structured Data Authority Gate -- Docs/Lab: Reject `application/ld+json` -- Website: Require `id=jsonld-site-graph` - ---- - -**Sealed by:** Antigravity (Advanced Agentic Coding) -**Timestamp:** 2026-01-21T17:46:30+08:00 diff --git a/governance/04-records/CONST-007-CROSS-SURFACE-CLOSURE-RECORD-2026-04-08.md b/governance/04-records/CONST-007-CROSS-SURFACE-CLOSURE-RECORD-2026-04-08.md deleted file mode 100644 index b65f47157..000000000 --- a/governance/04-records/CONST-007-CROSS-SURFACE-CLOSURE-RECORD-2026-04-08.md +++ /dev/null @@ -1,200 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: attestation -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "CONST-007-CROSS-SURFACE-CLOSURE-RECORD-2026-04-08" -title: "CONST-007 Cross-Surface Closure Record — 2026-04-08" -authority_scope: - - governance_source -authority_basis: - - governance_record -surface_role: canonical -active_governance_class: active_record -record_state: final ---- - -# CONST-007 Cross-Surface Closure Record — 2026-04-08 - -> [!NOTE] -> `status: draft` reflects repository lifecycle semantics for governance -> records. -> This file is the draft final closure record for the current CONST-007 -> cross-surface remediation round. - -## 1. Purpose - -This record freezes the closure judgment for the current cross-surface -remediation round executed against the `CONST-007_CROSS_SURFACE_BRAND_UX_CONSTITUTION` -baseline. - -It records: - -- the four in-scope public surfaces for this round -- the constitutional/semantic basis used for remediation -- the final per-surface closure judgment -- the conclusion that no material repo-side remediation remains for this round - -## 2. Constitutional Basis - -This remediation round was executed against: - -- `governance/01-constitutional/CONST-007_CROSS_SURFACE_BRAND_UX_CONSTITUTION.md` - -Closure basis for the round: - -- Website assessed as the Public Brand Shell discovery/positioning surface -- Documentation assessed as the Documentation Shell -- Validation Lab assessed as the Public Brand Shell evidence-adjudication surface -- Repository assessed as the semantic source-of-truth surface - -Historical accuracy caveat: - -- this record freezes the remediation round executed against the current - `CONST-007` baseline as an alignment target -- this record does not itself ratify `CONST-007` or convert that constitutional - draft into a new protocol-authority class - -## 3. Scope of This Closure Record - -This closure record is limited to the current remediation round across: - -- `MPLP_website` -- `docs` -- `Validation_Lab` -- root `Repository` - -It does not reopen: - -- unrelated local workspace residue outside this remediation cluster -- unrelated release/distribution work -- historical closure disputes already settled in earlier records -- new remediation outside the four-surface CONST-007 round - -## 4. Surface-by-Surface Closure Result - -### 4.1 Website - -Closure judgment: - -- `CONFORMANT` -- issue classification: `NONE_MATERIAL` - -Role outcome: - -- Website is operating as the Public Brand Shell discovery/positioning surface - -Round evidence basis: - -- local website release-line repository aligned to `origin/main` -- public website surface remained materially aligned with the expected MPLP - discovery/boundary language during the closure audit - -### 4.2 Documentation - -Closure judgment: - -- `CONFORMANT` -- issue classification: `NONE_MATERIAL` - -Role outcome: - -- Documentation is operating as the Documentation Shell specification/reference - surface - -Round evidence basis: - -- `docs/README.md` remained aligned to the documentation-shell role -- the current docs workflow line completed successfully on the preserved root - repository semantic-baseline commit for this round - -### 4.3 Validation Lab - -Closure judgment: - -- `CONFORMANT` -- issue classification: `NONE_MATERIAL` - -Role outcome: - -- Validation Lab is operating as the Public Brand Shell evidence-adjudication - surface - -Round evidence basis: - -- local Validation Lab release-line repository aligned to `origin/main` -- Validation Lab README/boundary language remained aligned to non-normative, - non-certification, evidence-adjudication semantics - -### 4.4 Repository - -Closure judgment: - -- `CONFORMANT` -- issue classification: `NONE_MATERIAL` - -Role outcome: - -- Repository is operating as the semantic source-of-truth surface - -Round evidence basis: - -- root repository semantic remediation cluster preserved in authoritative remote - truth -- repository-facing README, package metadata, release manifest, governance - summary, and targeted governance records were brought into semantic alignment - for this round - -## 5. Closure Anchors - -Authoritative root-repository closure anchor for the semantic remediation cluster: - -- root `HEAD` - - `fd94e4906e627538c0692a27857284e8bd5b4fcc` -- `origin/main` - - `fd94e4906e627538c0692a27857284e8bd5b4fcc` -- `origin-oss/main` - - `fd94e4906e627538c0692a27857284e8bd5b4fcc` - -Surface release-line anchors observed in this closure pass: - -- `MPLP_website origin/main` - - `385fccec376862293b48088419879a22dc2a2d2a` -- `Validation_Lab origin/main` - - `a0767aa1157bd1f5d8f99f442baded21359f2ad6` - -Documentation workflow closure anchor observed in this pass: - -- `Deploy Docusaurus to GitHub Pages` - - run `24124926020` - - status `completed` - - conclusion `success` - - head SHA `fd94e4906e627538c0692a27857284e8bd5b4fcc` - -## 6. Final Round Judgment - -The current CONST-007 cross-surface remediation round is hereby judged: - -- `READY_FOR_FROZEN_CLOSURE` - -More specifically: - -- all four in-scope public surfaces are materially conformant for this round -- no material repo-side remediation remains in this round -- no remaining issue in the closure audit was classified as - `REPO_SIDE_REMEDIABLE` -- any future semantic or surface work should be treated as a new workstream - rather than continuation of this remediation round - -## 7. Effect - -From issuance of this closure record draft forward: - -- the current CONST-007 remediation round should be treated as closed in - substance pending preservation of this record -- the Website / Docs / Validation Lab / Repository role alignment achieved in - this pass should be treated as the frozen closure baseline for this round -- future drift, if any, should be evaluated as new drift against this closure - baseline rather than as unfinished carryover from the current round diff --git a/governance/04-records/DEPRECATED-CONTENT-SEPARATION-2026-04-02.md b/governance/04-records/DEPRECATED-CONTENT-SEPARATION-2026-04-02.md index 09e35ef96..0f7dc87e3 100644 --- a/governance/04-records/DEPRECATED-CONTENT-SEPARATION-2026-04-02.md +++ b/governance/04-records/DEPRECATED-CONTENT-SEPARATION-2026-04-02.md @@ -32,7 +32,7 @@ The active baseline for current MPLP guidance is: - repository root active documents - `docs/` active documentation source -- `Coregentis/MPLP-Validation-Lab` separate Validation Lab release-line repository +- `Validation_Lab/` authoritative in-repository Lab surface - `MPLP_website/` active website source - current governance, release, and closure records outside archive scopes @@ -45,7 +45,8 @@ The following material classes are historical-only unless explicitly re-promoted by later governance: - `governance/99-archive/**` -- Validation Lab historical/archive materials retained in the separate `Coregentis/MPLP-Validation-Lab` repository +- `Validation_Lab/releases/archive/**` +- `Validation_Lab/releases/v2/archive/**` - archived release reproduction notes that still mention `mplp_prerelease` - `Validation_Lab_V2/**` as a non-authoritative archived `engineering_track` @@ -63,7 +64,7 @@ The following references are now deprecated in active guidance: Active guidance should instead bind to: - `https://github.com/Coregentis/MPLP-Protocol` -- `https://github.com/Coregentis/MPLP-Validation-Lab` +- `Validation_Lab/` in-repository source surface - `governance/05-specialized/entity.json` - `governance/05-specialized/ENTITY_CANONICAL.yaml` - `docs/static/assets/geo/mplp-entity.json` @@ -76,7 +77,7 @@ As part of this separation pass: prerelease references - historical `mplp_prerelease` usage was downgraded to historical-only where it remains in archive-oriented materials -- active gates/scripts were pointed at current repository and release-line references +- active gates/scripts were pointed at current in-repository paths ## Effect diff --git a/governance/04-records/MPGC-DESIGNATE-LAB-AUTHORITY-HOME.md b/governance/04-records/MPGC-DESIGNATE-LAB-AUTHORITY-HOME.md index 2aa704f8c..a22846abb 100644 --- a/governance/04-records/MPGC-DESIGNATE-LAB-AUTHORITY-HOME.md +++ b/governance/04-records/MPGC-DESIGNATE-LAB-AUTHORITY-HOME.md @@ -2,8 +2,8 @@ entry_surface: repository entry_model_class: primary doc_type: attestation -status: draft # repository attestation lifecycle status per CONST-002 -authority: none # protocol authority only; governance authority is expressed below +status: draft +authority: none protocol_version: "1.0.0" doc_id: "MPGC-DESIGNATE-LAB-AUTHORITY-HOME" title: "MPGC Designation Record — Validation Lab Authority Home" @@ -19,10 +19,8 @@ record_state: effective # MPGC Designation Record — Validation Lab Authority Home **Record ID**: MPGC-DESIGNATE-LAB-AUTHORITY-HOME -**Status**: Draft Repository Attestation -**Record State**: Effective -**Authority**: None (protocol authority) -**Governance Authority Basis**: MPGC designation record +**Status**: Active Governance Record +**Authority**: MPGC **Effective Governance Revision**: v1.2.0 **Applicable Protocol Version**: 1.0.0 **Depends on**: @@ -34,7 +32,7 @@ record_state: effective ## 1. Purpose -This record designates the authoritative Validation Lab home for MPLP's public-facing release topology from the root repository governance surface and defines the non-authoritative reduction of `Validation_Lab_V2`. +This record designates the authoritative Validation Lab home within the current repository governance scope and defines the non-authoritative reduction of `Validation_Lab_V2`. This record also documents the validation basis used to determine that the published Validation Lab repository has absorbed the core V2 governance, release, schema, projection, and gate assets needed for public-facing operation. @@ -42,16 +40,13 @@ This record also documents the validation basis used to determine that the publi ## 2. Authority Home Designation -Within the current MPLP repository-governance scope: +Within this repository governance scope: -- **Authoritative public-facing Lab home**: `Coregentis/MPLP-Validation-Lab` -- **Root-repo representation mode**: link-only reference from `MPLP-Protocol` +- **Authoritative Lab home**: `Validation_Lab` - **Non-authoritative line**: `Validation_Lab_V2` - **Reduction mode for `Validation_Lab_V2`**: `engineering_track` -`Coregentis/MPLP-Validation-Lab` is the only authoritative public-facing Validation Lab home for MPLP. - -The root `MPLP-Protocol` repository MUST reference that Lab surface by link/pointer only and MUST NOT present `Validation_Lab` as an in-repository public source surface. +`Validation_Lab` is the only authoritative Lab home within this repository governance scope. `Validation_Lab_V2` is not an independent MPLP surface and must not be treated as a second authoritative Lab home. @@ -63,22 +58,37 @@ The following validation basis was used to support this designation. ### 3.1 Governance and Release Assets -The published Validation Lab release-line repository and site provide the public-facing Lab home required for ongoing MPLP operation: - -- repository: `https://github.com/Coregentis/MPLP-Validation-Lab` -- site: `https://lab.mplp.io` +The published repository already contains the V2 governance and release asset sets required for ongoing public-facing and operational use: -Repository-facing references in `MPLP-Protocol` therefore do not need to present `Validation_Lab` as an in-repository public source surface. +- `Validation_Lab/governance/v2/` +- `Validation_Lab/releases/v2/` +- top-level V2 governance artifacts such as: + - `Validation_Lab/governance/v2-seal.md` + - `Validation_Lab/governance/v2-seal-rc2.md` + - `Validation_Lab/governance/v2-seal-rc3.md` + - `Validation_Lab/governance/scope-freeze-v2.md` + - `Validation_Lab/governance/dispute-freeze-v2.md` + - `Validation_Lab/governance/linkmap.v2.yaml` + - `Validation_Lab/governance/gates/gate-registry-v2.json` ### 3.2 Schema and Projection Assets -The published Validation Lab repository already absorbs the governance, release, schema, projection, and gate asset classes needed for public-facing operation. +The published repository already contains the V2 schema and projection assets needed for public-facing use: + +- `Validation_Lab/schemas/v2/` +- `Validation_Lab/public/_data/v2/` -Those asset classes therefore do not require `Validation_Lab_V2` to remain a second authoritative surface, and they do not justify treating the root repository as the public source host for Validation Lab. +These assets are present in the published Lab home and therefore do not require `Validation_Lab_V2` to remain a second authoritative surface. ### 3.3 V2 Gate and Engineering Assets -The published Validation Lab repository already contains the gate and engineering entrypoints needed to continue V2-related work without relying on `Validation_Lab_V2` as a public-facing authority home. +The published repository already contains the V2 gate and engineering entrypoints under: + +- `Validation_Lab/scripts/gates/v2/` +- `Validation_Lab/app/v2/` +- `Validation_Lab/lib/v2/` + +The published Lab home therefore already contains the in-repo engineering and projection structures necessary to continue V2-related work without relying on `Validation_Lab_V2` as a public-facing authority home. ### 3.4 Route-Layer Absorption @@ -90,6 +100,10 @@ V2 route-layer functionality has been absorbed into the published Lab home in tw - `/releases` - `/coverage` - `/policies` +- retained internal V2 implementation assets under: + - `Validation_Lab/app/v2/` + - `Validation_Lab/public/_data/v2/` + This means the published Validation Lab repository is the correct public-facing home even where V2 route concepts were renamed, merged, or internally retained rather than preserved as one-to-one public routes. --- @@ -98,9 +112,9 @@ This means the published Validation Lab repository is the correct public-facing The following duplication rules now apply: -1. `Coregentis/MPLP-Validation-Lab` remains authoritative as the Validation Lab release-line repository. +1. `Validation_Lab` remains authoritative. 2. `Validation_Lab_V2` is non-authoritative and may only operate as an `engineering_track`. -3. Duplicate V2 governance texts must not remain simultaneously authoritative when the release-line Validation Lab repository already carries the authoritative public-facing home. +3. Duplicate V2 governance texts inside `Validation_Lab` must not remain simultaneously authoritative when a top-level authoritative file already exists. 4. Duplicate or legacy mirrors must be reduced to one of: - pointer-only - non-authoritative mirror @@ -125,8 +139,7 @@ This designation applies to the following duplicated or overlapping V2 asset cla From the effective date of this record forward: -- all public-facing or governance-facing references must treat `Coregentis/MPLP-Validation-Lab` as the authoritative Lab home; -- root-repository references to Validation Lab must remain link-only and must not present `Validation_Lab` as an in-repository public source surface; +- all public-facing or governance-facing references must treat `Validation_Lab` as the authoritative Lab home; - `Validation_Lab_V2` must be described only as a non-authoritative `engineering_track` unless superseded by future MPGC action; - no document may present `Validation_Lab_V2` as: - a new MPLP surface, @@ -150,7 +163,7 @@ This designation record does NOT: | Version | Date | Description | |:---|:---|:---| -| v1.2.0 | 2026-03-28 | Designated `Coregentis/MPLP-Validation-Lab` as the authoritative public-facing Lab home and reduced `Validation_Lab_V2` to non-authoritative `engineering_track` status | +| v1.2.0 | 2026-03-28 | Designated `Validation_Lab` as the only authoritative Lab home and reduced `Validation_Lab_V2` to non-authoritative `engineering_track` status | --- diff --git a/governance/04-records/MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT.md b/governance/04-records/MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT.md index 2c0c1e586..1b3903f58 100644 --- a/governance/04-records/MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT.md +++ b/governance/04-records/MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT.md @@ -2,8 +2,8 @@ entry_surface: repository entry_model_class: primary doc_type: attestation -status: draft # repository attestation lifecycle status per CONST-002 -authority: none # protocol authority only; governance authority is expressed below +status: draft +authority: none protocol_version: "1.0.0" doc_id: "MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT" title: "MPGC Ratification Record — Entry Model Realignment" @@ -19,10 +19,8 @@ record_state: ratified # MPGC Ratification Record — Entry Model Realignment **Record ID**: MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT -**Status**: Draft Repository Attestation -**Record State**: Ratified -**Authority**: None (protocol authority) -**Governance Authority Basis**: MPGC ratification record +**Status**: Ratified Record +**Authority**: MPGC **Governance Revision**: v1.2.0 **Applicable Protocol Version**: 1.0.0 **Related Constitutional Documents**: diff --git a/governance/04-records/SEAL-SDKR-08-GOVERNANCE-v1.md b/governance/04-records/SEAL-SDKR-08-GOVERNANCE-v1.md deleted file mode 100644 index 62b52f38d..000000000 --- a/governance/04-records/SEAL-SDKR-08-GOVERNANCE-v1.md +++ /dev/null @@ -1,174 +0,0 @@ -# GOVERNANCE FREEZE RECORD: METHOD-SDKR-08 v1.0 - -**Document ID**: FREEZE-SDKR-08-V1 -**Status**: FROZEN -**Effective Date**: 2026-01-04 -**Authority**: MPGC (MPLP Protocol Governance Committee) - ---- - -## 1. Freeze Declaration - -This document formally records the **governance freeze** of METHOD-SDKR-08 (Multi-Package Release Governance) at version 1.0. - -Once frozen, the artifacts listed in this document become **immutable** from a governance perspective. Any modifications require a formal RFC process as defined in Section 5. - -> **This freeze establishes METHOD-SDKR-08 as the authoritative, multi-language SDK release governance method for MPLP v1.0.** - ---- - -## 2. Sealed Scope - -The following artifacts are included in this freeze: - -### 2.1 Governance Method - -| Artifact | Path | Status | -|:---|:---|:---:| -| METHOD-SDKR-08 (Main) | `governance/03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md` | **FROZEN** | -| Section 8.1 (Python Profile) | Included in METHOD-SDKR-08 | **FROZEN** | - -### 2.2 Reference Implementations (Gates) - -| Artifact | Path | Language | Status | -|:---|:---|:---|:---:| -| npm Publish Gate | `scripts/semantic/gate-publish-set.mjs` | JavaScript | **FROZEN** | -| PyPI Publish Gate | `scripts/semantic/gate_pypi_set/` | Python | **FROZEN** | - -### 2.3 Templates - -| Artifact | Path | Status | -|:---|:---|:---:| -| DERIVATION_PROOF Template | `governance/06-operations/artifacts/DERIVATION_PROOF_TEMPLATE.yaml` | **FROZEN** | -| RELEASE_BUNDLE_MANIFEST Template | `governance/06-operations/artifacts/RELEASE_BUNDLE_MANIFEST_TEMPLATE.json` | **FROZEN** | - -### 2.4 Structural Contracts - -The following **structural contracts** are frozen: - -| Contract | Description | -|:---|:---| -| Publish Set Definition | Automatic computation, manual specification forbidden | -| Hard-Fail Semantics | No waiver, no override | -| Evidence Artifacts | `publish-set.json`, `publish-gate-report.json`, `pypi-set.json`, `pypi-gate-report.json` | -| Bundle Manifest Structure | `artifacts.npm[]`, `artifacts.pypi[]` | - ---- - -## 3. Non-Goals (Explicitly Out of Scope) - -The following are **explicitly NOT part of this freeze** and may evolve independently: - -| Item | Rationale | -|:---|:---| -| CI Platform Implementation | GitHub Actions / GitLab CI / etc. are implementation details | -| Go / Rust Gate Implementations | Future language support via RFC, not method change | -| Partial Publish Workflow | Not supported in v1.0 | -| Waiver / Override Mechanism | Explicitly forbidden by design | -| Package Manager Alternatives | pip/poetry/uv are implementation details | - ---- - -## 4. Governance Invariants (Non-Negotiable) - -The following invariants are **locked** and cannot be changed without a new VERSION: - -### 4.1 Classification System - -``` -PUBLIC → May be published -INTERNAL → Must not be published -CI-ONLY → Must not be published, may exist in Bundle for verification -``` - -### 4.2 Hard-Fail Conditions - -Any of the following triggers **immediate release block**: - -- Non-PUBLIC package in Publish Set -- Missing `DERIVATION_PROOF.yaml` -- Missing distribution artifacts (wheel/sdist for Python, dist for npm) -- Version mismatch with Release Bundle - -### 4.3 Evidence Chain - -Every release MUST produce: - -- Computed Publish Set (JSON) -- Gate Report (JSON) -- Bundle Manifest (JSON) - -### 4.4 Language Parity - -npm and PyPI gates MUST maintain **structural equivalence**: - -| Dimension | npm | PyPI | -|:---|:---|:---| -| Set Computation | Automatic | Automatic | -| Classification | mplp.ci_only / private | tool.mplp.ci_only / category | -| Proof | DERIVATION_PROOF.yaml | DERIVATION_PROOF.yaml | -| Version Sync | major.minor | major.minor | -| Waiver | ❌ | ❌ | - ---- - -## 5. Post-Freeze Change Control - -### 5.1 Allowed Without RFC - -- Bug fixes that do not change semantics -- Documentation clarifications -- CI integration improvements - -### 5.2 Requires RFC - -Any change that: - -- Modifies Hard-Fail conditions -- Adds new evidence artifacts -- Changes Publish Set computation logic -- Introduces language-specific exceptions - -### 5.3 Requires New Version - -Any change that: - -- Removes an invariant -- Breaks backward compatibility -- Changes Bundle Manifest structure - ---- - -## 6. Compliance Statement - -This freeze record certifies that: - -1. **METHOD-SDKR-08** is complete and internally consistent -2. **npm and PyPI gates** are structurally equivalent -3. **Evidence chain** is fully specified -4. **No known gaps** exist in the governance coverage - -> This governance method is now suitable for external reference and regulatory citation. - ---- - -## 7. Signatories - -| Role | Entity | Date | -|:---|:---|:---| -| Protocol Authority | MPGC | 2026-01-04 | -| Technical Implementation | Coregentis AI | 2026-01-04 | - ---- - -## 8. References - -- [METHOD-SDKR-08](../03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md) -- [MPLP Entry Model Specification](../01-constitutional/CONST-001_ENTRY_MODEL_SPEC.md) -- [EXECUTION_ORDER](../EXECUTION_ORDER.md) - ---- - -**Document Status**: Governance Freeze Record -**Classification**: Public -**Version**: 1.0.0 diff --git a/governance/04-records/UNIFIED-RECTIFICATION-MAINLINE-CLOSURE.md b/governance/04-records/UNIFIED-RECTIFICATION-MAINLINE-CLOSURE.md index 8ce0b42fc..eb75dc35b 100644 --- a/governance/04-records/UNIFIED-RECTIFICATION-MAINLINE-CLOSURE.md +++ b/governance/04-records/UNIFIED-RECTIFICATION-MAINLINE-CLOSURE.md @@ -2,8 +2,8 @@ entry_surface: repository entry_model_class: primary doc_type: attestation -status: draft # repository attestation lifecycle status per CONST-002 -authority: none # protocol authority only; governance authority is expressed through record basis +status: draft +authority: none protocol_version: "1.0.0" doc_id: "UNIFIED-RECTIFICATION-MAINLINE-CLOSURE" title: "Unified Rectification Mainline Closure" @@ -18,10 +18,7 @@ record_state: final # Unified Rectification Mainline Closure -**Status**: Draft Repository Attestation -**Record State**: Final -**Authority**: None (protocol authority) -**Governance Authority Basis**: repository governance closure record +**Status**: CLOSED **Closure State**: BASELINE ESTABLISHED **Closure Date**: 2026-03-28 **Scope**: Repository governance realignment baseline @@ -58,7 +55,7 @@ This means future work MUST treat the following as baseline rather than open des - `4 public-facing surfaces` - scoped authority model - Validation Lab truth source = root protocol truth source for invariants -- `Coregentis/MPLP-Validation-Lab` as the authoritative Validation Lab release-line repository linked from the root repository +- `Validation_Lab` as the only authoritative Lab home in this repository governance scope - `Validation_Lab_V2` as non-authoritative `engineering_track` - explicit version-domain taxonomy - executable cleanup and governance gates @@ -115,7 +112,7 @@ This means future work MUST treat the following as baseline rather than open des - `gate:v2-ownership-collapse` **Effect**: -- `Coregentis/MPLP-Validation-Lab` is now the authoritative public-facing Validation Lab home linked from the root repository +- `Validation_Lab` is now the only authoritative Lab home in this repository governance scope - `Validation_Lab_V2` is explicitly reduced to non-authoritative `engineering_track` ### 3.4 P1 Version Taxonomy Manifest diff --git a/governance/04-records/VALIDATION_LAB_V2-TAIL-DISPOSITION-2026-04-01.md b/governance/04-records/VALIDATION_LAB_V2-TAIL-DISPOSITION-2026-04-01.md index cfca43cb2..b6a5c8690 100644 --- a/governance/04-records/VALIDATION_LAB_V2-TAIL-DISPOSITION-2026-04-01.md +++ b/governance/04-records/VALIDATION_LAB_V2-TAIL-DISPOSITION-2026-04-01.md @@ -34,7 +34,7 @@ mainline. The archived status of `Validation_Lab_V2` is already established by the active governance baseline: -- `Coregentis/MPLP-Validation-Lab` is the authoritative public-facing Validation Lab home. +- `Validation_Lab` is the only authoritative Lab home in this repository scope. - `Validation_Lab_V2` is not an independent MPLP surface. - `Validation_Lab_V2` has already been reduced to the non-authoritative role `engineering_track`. @@ -75,7 +75,7 @@ This change is local archived-line dirt only. It does not alter: -- the authoritative `Coregentis/MPLP-Validation-Lab` home +- the authoritative `Validation_Lab` home - any A-line remediated docs or website surface - package publish reality - closure interpretation of the authoritative mainline diff --git a/governance/EXECUTION_ORDER.md b/governance/EXECUTION_ORDER.md index a47142da5..68fcec545 100644 --- a/governance/EXECUTION_ORDER.md +++ b/governance/EXECUTION_ORDER.md @@ -1,3 +1,20 @@ +--- +entry_surface: repository +entry_model_class: primary +doc_type: governance +status: draft +authority: none +protocol_version: "1.0.0" +doc_id: "GOV-EXEC-ORDER" +title: "Governance Execution Order" +authority_scope: + - governance_source +authority_basis: + - projection_only +surface_role: canonical +active_governance_class: active_index_or_router +--- + # Governance Execution Order **Document ID**: GOV-EXEC-ORDER @@ -7,6 +24,10 @@ --- +> [!NOTE] +> `status: draft` in frontmatter reflects repository lifecycle only. +> This file remains the active execution-routing guide for governance work. + ## 1. Purpose This document defines the **execution sequence** for MPLP governance activities. @@ -26,30 +47,30 @@ Phase 0: Constitutional Reference (01-constitutional/) Read foundation rules. Do not modify. │ ▼ -Phase 1-3: Truth Source Verification (02-methods/verification/) +Phase 1-3: Truth Source Verification (02-methods/schema/) ├── TSV-01: $ref Closure Verification ├── XCV-01: Cross-Consistency Verification ├── SCV-01: Schema Surface Completeness └── SUC-01: Schema Usage Conformance │ ▼ -Phase 4-7: Evolution Verification (02-methods/evolution/) +Phase 4-7: Evolution Verification (02-methods/schema/) ├── DIV-01: Derivation Integrity Verification └── EVC-01: Evolution Compatibility Verification │ ▼ -Phase 8: Freeze Evidence Baseline (04-records/baselines/) - Create FREEZE_EVIDENCE_BASELINE_v*.md +Phase 8: Freeze Evidence Baseline (04-records/) + Create the current freeze baseline and addendum records │ ▼ Phase 9+: SDK Release (03-distribution/sdk/) - ├── Execute SDKR-01 through SDKR-07 + ├── Execute SDKR-01 through SDKR-09 ├── Complete CHECKLIST-SDK-RELEASE.md └── Obtain MPGC approval │ ▼ -Record: Phase Completion (04-records/phases/) - Document phase exit criteria and results +Record: Closure / Source Records (04-records/) + Document baseline, closure, and release governance outcomes ``` --- @@ -96,8 +117,8 @@ Record: Phase Completion (04-records/phases/) | Action | Location | |:---|:---| -| Create freeze record | `04-records/baselines/FREEZE_*.md` | -| Create governance addendum | `04-records/baselines/GOV-ADDENDUM-*.md` | +| Create freeze record | `04-records/FREEZE_*.md` | +| Create governance addendum | `04-records/GOV-ADDENDUM-*.md` | | Tag in Git | `evidence-baseline-v*` | **Output**: Frozen baseline with evidence artifacts @@ -116,6 +137,7 @@ Record: Phase Completion (04-records/phases/) | Verification | `03-distribution/sdk/METHOD-SDKR-06_*.md` | | Incident | `03-distribution/sdk/METHOD-SDKR-07_*.md` | | Multi-Package | `03-distribution/sdk/METHOD-SDKR-08_*.md` | +| Readiness | `03-distribution/sdk/METHOD-SDKR-09_*.md` | | Checklist | `03-distribution/sdk/CHECKLIST-SDK-RELEASE.md` | | Approval | `03-distribution/sdk/MPGC_APPROVAL_*.md` | diff --git a/governance/README.md b/governance/README.md index e446dd25c..667a5225e 100644 --- a/governance/README.md +++ b/governance/README.md @@ -1,114 +1,126 @@ --- entry_surface: repository +entry_model_class: primary doc_type: governance status: draft authority: none protocol_version: "1.0.0" doc_id: "GOV-README" +title: "MPLP Governance Index" +authority_scope: + - governance_source +authority_basis: + - projection_only +surface_role: canonical +active_governance_class: active_index_or_router --- -# MPLP Governance - -> [!NOTE] -> This directory is governed by **MPGC** (MPLP Protocol Governance Committee). -> **Governance Scheme Version**: v1.1.0 (Reflected in 7-layer restructuring). +# MPLP Governance Index > [!IMPORTANT] -> **This governance directory contains both Public Protocol Governance and Internal Operational Support.** -> Only the **Public Governance set (Layers 01–04)** is considered part of MPLP's public governance contract. -> Operational layers (Layer 06 and selected parts of Layer 05) are **non-normative implementation support** and may change without notice. - ---- - -## 1. Purpose - -This directory contains all governance documents for the MPLP protocol. - -Governance documents define **who may do what, when, how, and with what evidence**. - ---- - -## 2. Directory Structure - -``` -governance/ -├── README.md # Unified Governance Index -├── EXECUTION_ORDER.md # Governance execution sequence -│ -├── 01-constitutional/ # L1: Foundation (PUBLIC - Governance Contract) -├── 02-methods/ # L2: Methods (PUBLIC - Governance Contract) -├── 03-distribution/ # L3: Distribution (PUBLIC - Governance Contract) -├── 04-records/ # L4: Records (PUBLIC - Governance Contract) -├── 05-specialized/ # L5: Domain (PARTIAL PUBLIC - projection/erc only) -├── 06-operations/ # L6: Operations (INTERNAL - may change) -└── 99-archive/ # L99: Archive (INTERNAL - deprecated) -``` - ---- - -## 3. Layer Descriptions - -### 01-constitutional (Foundation) - -Canonical documents defining the fundamental rules. Immutable foundation (Seal-protected). -- **CONST-001**: Entry Model Specification (v1.1 - 3+1 entries) -- **CONST-002**: Document Format Specification (v1.1 - 6 doc_types, 4 surfaces) - -### 02-methods (Verification & Audit) - -Verification methods and SOPs (Standard Operating Procedures). -- **schema/**: TSV, XCV, SCV, SUC methods for truth sources. -- **docs/**: DGA, DTAA, DTV methods for documentation alignment. - -### 03-distribution (SDK & Release) - -Governance for distributing artifacts to registries. -- **sdk/**: SDK release pipeline (SDKR-01 through 09). - -### 04-records (Evidence & Accountability) +> **Minimal Canonical Governance Index** +> +> This file is the active governance index for repository classification and +> change routing. +> It classifies governance materials by active status and handling rule. +> It does **not** replace constitutional doctrine, version taxonomy, or source +> records. -Immutable records of governance actions. -- **Seals**: Evidence anchors for specific builds/syncs. -- **Freeze Records**: Baselines for semantic/entity alignment. -- **Ratifications**: Formal MPGC motions and adoption records. - -### 05-specialized (Domain Governance) - -Governance for specific facets of the ecosystem. -- **website/**: Website-specific constraints and audits. -- **entity/**: Canonical entity and disambiguation policies. -- **script-audit/**: Repository script governance. - -### 06-operations (Support & Execution) - -Operational data and tools supporting governance execution. -- **tools/**: Linkmap runners and audit scripts. -- **rules/**: Validation regex, patterns, and allowlists. -- **artifacts/**: Audit outputs and reports. - -### 99-archive - -Historical or superseded schemes kept for narrative integrity. - ---- - -## 4. Authority - -All governance documents are governed by **MPGC** (MPLP Protocol Governance Committee). - -Amendments require MPGC approval. - ---- - -## 5. Quick Start - -1. Read `EXECUTION_ORDER.md` to understand the governance sequence -2. Review `01-constitutional/` for foundation rules -3. Follow `02-methods/` for verification -4. Use `03-distribution/sdk/` for SDK publication - ---- - -**Document Status**: Governance Entry Point -**Supersedes**: None -**References**: EXECUTION_ORDER.md +> [!NOTE] +> `status: draft` is the repository lifecycle value required for governance +> documents under `CONST-002`. +> This file is still the active canonical routing and classification layer for +> governance handling. + +## Canonical Sources + +Use these first when a governance question affects semantic authority: + +- `01-constitutional/` +- `05-versioning/` +- `global-alignment-baseline.yaml` +- active authority records in `04-records/` +- `EXECUTION_ORDER.md` for execution sequencing only + +## Buckets + +| Bucket | Meaning | Use Rule | +|:---|:---|:---| +| `canonical-active` | Current active governance source or bounded runtime-consumed governance support | May guide active work within declared scope | +| `frozen-historical` | Retained historical governance line or archive set | Keep for provenance only; do not treat as current guidance | +| `release-evidence` | Attestation, seal, closure, audit, or release proof | Evidence only; do not treat as current doctrine | +| `generated-derived` | Machine-generated report, export, or regenerated artifact | Regenerate from sources; not semantic authority | +| `unknown-quarantine` | Unsafe, stale, broken-pointer, or conflicting residue | Do not use as active guidance until normalized | + +## Active Governance Classes + +| Class | Meaning | +|:---|:---| +| `constitutional_doctrine` | Constitutional doctrine that defines repository governance meaning | +| `semantic_doctrine` | Active semantic governance outside the constitutional layer | +| `active_index_or_router` | Active routing, indexing, or classification layer | +| `active_record` | Active repository record whose conclusion or disposition remains in force | +| `operational_support` | Active operational/gate support material | +| `pointer_only` | Active or retained pointer with no standalone doctrine authority | + +### Metadata Convention + +- `active_governance_class` identifies how an active governance file should be interpreted. +- `record_state` is used only on `active_record` files when record finality or + effectivity needs to be explicit. +- `status` remains the repository lifecycle field required by `CONST-002`; it is + not the sole indicator of whether a record is currently in force. +- `authority: none` may still appear on active routing, record, and operational + files when they do not define doctrine directly. + +## Path Classification + +| Path / File Family | Bucket | Authority Class | Notes | +|:---|:---|:---|:---| +| `01-constitutional/**` | `canonical-active` | semantic authority | Constitutional baseline | +| `02-methods/**` | `canonical-active` | semantic authority | Verification and audit methods | +| `03-distribution/sdk/**` except approval-only records | `canonical-active` | semantic authority | Active SDK governance | +| `04-records/MPGC-RATIFY-*` | `canonical-active` | semantic authority | Ratified source records | +| `04-records/MPGC-RECORD-2026-01-22-CROSS-ENTRY-PROJECTION-ALIGNMENT.md` | `canonical-active` | semantic authority | Cross-entry governance record | +| `04-records/MPGC-DESIGNATE-LAB-AUTHORITY-HOME.md` | `canonical-active` | semantic authority | Active Lab-home designation | +| `04-records/UNIFIED-RECTIFICATION-MAINLINE-CLOSURE.md` | `canonical-active` | semantic authority | Mainline closure baseline | +| `04-records/A-LINE-CLOSURE-RECORD-2026-04-01.md` | `canonical-active` | semantic authority | A-line closure record | +| `04-records/VALIDATION_LAB_V2-TAIL-DISPOSITION-2026-04-01.md` | `canonical-active` | semantic authority | Archived-tail handling rule | +| `04-records/DEPRECATED-CONTENT-SEPARATION-2026-04-02.md` | `canonical-active` | semantic authority | Active deprecated-content separation rule | +| `04-records/AUDIT-ARTIFACT-ARCHIVE-2026-04-01.md` | `canonical-active` | semantic authority | Active archive demotion record | +| `05-versioning/**` | `canonical-active` | semantic authority | Canonical version-domain baseline | +| `global-alignment-baseline.yaml`, `global-alignment-current.yaml` | `canonical-active` | runtime-consumed active file | Machine-readable cross-surface baseline | +| `05-specialized/entity.json`, `05-specialized/ENTITY_CANONICAL.yaml`, `05-specialized/ENTITY_DISAMBIGUATION_POLICY.md`, `05-specialized/ECOSYSTEM_ANCHORS.json` | `canonical-active` | semantic authority | Identity and disambiguation support | +| `05-specialized/DEPRECATION_PLAN.md`, `05-specialized/SCRIPT_*.md` | `canonical-active` | semantic authority | Internal governance support | +| `06-operations/gates/**`, `06-operations/linkmap/**`, `06-operations/schemas/**`, `06-operations/ALLOW-LINKMAP-01.yaml`, `06-operations/DEPENDENCY-GOVERNANCE-NOTE.md`, `06-operations/LINKMAP_*.txt` | `canonical-active` | runtime-consumed active file | Internal execution support; not doctrine | +| `README.md`, `EXECUTION_ORDER.md` | `canonical-active` | semantic authority | Index and routing only | +| `04-records/SEAL-*`, `04-records/AUDIT-*`, `04-records/PHASE-*`, `04-records/FREEZE_*`, `04-records/GOV-ADDENDUM-*`, `04-records/FR-ENTITY-ALIGNMENT-*` | `release-evidence` | historical evidence | Do not use as current doctrine | +| `03-distribution/sdk/MPGC_APPROVAL_SDKR_v1.0.md` | `release-evidence` | historical evidence | Approval evidence | +| `governance/audits/**` | `release-evidence` | historical evidence | Audit and drift evidence | +| `06-operations/artifacts/release/**` | `release-evidence` | historical evidence | Release packet evidence | +| `06-operations/artifacts/**` excluding release packets already listed | `generated-derived` | generated | Regenerate from source tools | +| `06-operations/docs-link-map*.json`, `06-operations/docs-banner-gate.report.json`, `06-operations/docs-sensitive-terms.report.*`, `06-operations/docs-audit/**` | `generated-derived` | generated | Generated reports | +| `99-archive/**` | `frozen-historical` | historical evidence | Archive line | +| `GOVERNANCE.md` | `unknown-quarantine` | quarantined unsafe residue | Non-canonical root pointer only | +| `../MPLP_website/governance/**` | `unknown-quarantine` | quarantined unsafe residue | Broken/stale website governance residue | +| `../MPLP_website/website-governance/**` | `unknown-quarantine` | quarantined unsafe residue | Historical website governance residue | +| `../Validation_Lab/governance/v2/**` | `unknown-quarantine` | quarantined unsafe residue | Non-authoritative mirror subtree | +| `../Validation_Lab_V2/**` | `frozen-historical` | historical evidence | Archived engineering track; not active guidance | + +## Handling Rules + +- Preserve semantic authority first. If a file conflicts with `01-constitutional/`, + `05-versioning/`, or current source records, those sources prevail. +- Treat runtime-consumed active files as bounded support assets, not as doctrine. +- Retain release evidence and frozen historical files, but keep them visibly + non-active. +- Do not use unknown-quarantine files as active guidance until their status is + normalized. + +## Quick Start + +1. Read `01-constitutional/CONST-001_ENTRY_MODEL_SPEC.md` +2. Read `01-constitutional/CONST-002_DOCUMENT_FORMAT_SPEC.md` +3. Read `05-versioning/VERSION-TAXONOMY-MANIFEST.md` +4. Use active `04-records/` source records for boundary and closure questions +5. Use `06-operations/` only for execution support, not doctrine diff --git a/governance/audits/MPLP-CANDIDATE-BACKLOG-REVIEW-INVENTORY-v0.1.md b/governance/audits/MPLP-CANDIDATE-BACKLOG-REVIEW-INVENTORY-v0.1.md deleted file mode 100644 index 91b4e7ff0..000000000 --- a/governance/audits/MPLP-CANDIDATE-BACKLOG-REVIEW-INVENTORY-v0.1.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-BACKLOG-REVIEW-INVENTORY-v0.1" -title: "MPLP Candidate Backlog Review Inventory v0.1" -surface_role: canonical ---- - -# MPLP Candidate Backlog Review Inventory v0.1 - -## A. Purpose - -Inventory current MPLP candidate backlog / research / downstream evidence -candidate materials after boundary reconciliation. - -## B. Candidate Inventory - -| Candidate source | Candidate theme | Current status | Boundary posture | Review action | -| --- | --- | --- | --- | --- | -| `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md` | non-executing lifecycle revision | `active_backlog` | `anonymous_downstream_evidence` | `keep` | -| `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md` plus `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md` | evidence insufficiency / stale context / clarification-driven revision | `active_backlog` | `binding_consideration` | `split` | -| `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md` | lifecycle governance from downstream evidence | `active_backlog` | `guide_candidate` | `split` | -| `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md` plus `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | delegation / delivery constraint candidates | `active_backlog` | `backlog_only` | `keep` | -| `governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md` plus `governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md` | cross-repo non-promotion posture | `closed_or_superseded` | `closed_no_action` | `keep` | -| `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md` plus `governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md` | candidate backlog consolidation | `duplicate_or_overlapping` | `backlog_only` | `merge` | -| `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md` plus `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md` | evidence vocabulary consideration | `active_backlog` | `binding_consideration` | `defer` | -| `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md` plus `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md` plus `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | guide/profile/binding consideration | `duplicate_or_overlapping` | `backlog_only` | `split` | - -## C. Decision - -`MPLP_CANDIDATE_BACKLOG_REVIEW_INVENTORY_COMPLETE` diff --git a/governance/audits/MPLP-DIRTY-WORKTREE-RECONCILIATION-AUDIT-v0.1.md b/governance/audits/MPLP-DIRTY-WORKTREE-RECONCILIATION-AUDIT-v0.1.md deleted file mode 100644 index 836429ed3..000000000 --- a/governance/audits/MPLP-DIRTY-WORKTREE-RECONCILIATION-AUDIT-v0.1.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DIRTY-WORKTREE-RECONCILIATION-AUDIT-v0.1" -title: "MPLP Dirty Worktree Reconciliation Audit v0.1" -surface_role: canonical ---- - -# MPLP Dirty Worktree Reconciliation Audit v0.1 - -## A. Purpose - -Record and classify the dirty MPLP-Protocol worktree before continuing any -correction patch. - -## B. Dirty File Matrix - -| File | Git status | Content class | Boundary risk | Reconciliation decision | Reason | -| --- | --- | --- | --- | --- | --- | -| `governance/audits/MPLP-DOWNSTREAM-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1.md` | `M` | `legacy_research_asset` | `medium` | `sanitize_then_include` | existing audit is being anonymized from downstream product/runtime naming to neutral downstream references without changing protocol law | -| `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md` | `M` | `legacy_backlog_candidate_asset` | `medium` | `sanitize_then_include` | backlog wording is being neutralized from product/runtime-specific names to anonymous downstream pressure language | -| `governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md` | `M` | `legacy_backlog_candidate_asset` | `medium` | `sanitize_then_include` | cross-repo closure wording is being rewritten to downstream product / downstream runtime substrate language while preserving non-promotion meaning | -| `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | `M` | `legacy_backlog_candidate_asset` | `medium` | `sanitize_then_include` | candidate-family discussion is being detached from named downstream product/runtime examples and role-specific product vocabulary | -| `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md` | `M` | `legacy_backlog_candidate_asset` | `low` | `sanitize_then_include` | endorsement-risk and certification-risk wording is already being tightened into explicit non-endorsement / not-certified posture | -| `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md` | `M` | `intended_boundary_correction_draft` | `low` | `include_in_this_patch` | current dirty delta is a small wording correction that keeps the new anonymous candidate note inside the allowed neutral boundary | -| `governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md` | `M` | `legacy_backlog_candidate_asset` | `medium` | `sanitize_then_include` | legacy matrix labels are being anonymized from concrete downstream names to neutral downstream product/runtime substrate terms | -| `governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md` | `M` | `legacy_research_asset` | `low` | `sanitize_then_include` | research backlog evidence language is being generalized away from named downstream runtime/product references | - -## C. Stop / Continue Decision - -`MPLP_DIRTY_WORKTREE_RECONCILED_CONTINUE_CORRECTION` - -All dirty files are relevant to boundary/backlog correction, were read before -any overwrite, and can be safely included as governance-only anonymization or -boundary-tightening work. No unrelated dirty edit, schema change, protocol-law -change, package change, or source-code change was found in the dirty set. diff --git a/governance/audits/MPLP-DIST-TARGET-REALITY-MATRIX-v0.1.md b/governance/audits/MPLP-DIST-TARGET-REALITY-MATRIX-v0.1.md deleted file mode 100644 index 386a7deb3..000000000 --- a/governance/audits/MPLP-DIST-TARGET-REALITY-MATRIX-v0.1.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DIST-TARGET-REALITY-MATRIX-v0.1" -title: "MPLP Dist Target Reality Matrix v0.1" -surface_role: canonical ---- - -# MPLP Dist Target Reality Matrix v0.1 - -> **Repo-Local Reality Matrix Only** -> -> This matrix records checked-in repo truth. It does not adjudicate whether a -> package may be publishable in another release context. - -| Package Path | Declared `main` | Declared `types` | Target Exists In Repo | Repo-Local Manifest Truth | Current Posture | Recommended Bounded Treatment | -| --- | --- | --- | --- | --- | --- | --- | -| `packages/npm/compliance` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented legacy package surface | keep as-is but document as publish-oriented | -| `packages/npm/conformance` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented alias package with checked-in `src/` residue | keep as-is but document as publish-oriented | -| `packages/npm/coordination` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/core` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/devtools` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/integration-llm-http` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/integration-storage-fs` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/integration-storage-kv` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/integration-tools-generic` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/modules` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public package surface | keep as-is but document as publish-oriented | -| `packages/npm/runtime-minimal` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public runtime helper surface | keep as-is but document as publish-oriented | -| `packages/npm/schema` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public schema/data mirror surface | keep as-is but document as publish-oriented | -| `packages/npm/sdk-ts` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | publish-oriented public facade package | keep as-is but document as publish-oriented | -| `packages/npm/validator` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful for repo-local consumption | CI-only/package-target surface with absent checked-in build outputs | keep as-is but document as publish/CI oriented | -| `packages/sources/sdk-ts` | `dist/index.js` | `dist/index.d.ts` | No / No | not truthful as a checked-in locally buildable source package | source-mirror / release-prep package, publish-blocked | mark source-mirror posture explicitly and defer manifest tightening | -| `packages/sources/validator` | `src/index.ts` | none declared | `src/index.ts` exists | truthful as a checked-in source package | source-side build package for validator tooling | keep as source-side package and normalize tooling posture | - -## Notes - -- "Target Exists In Repo" means the exact `main` / `types` target path is - present in checked-in repository contents. -- "Repo-Local Manifest Truth" evaluates whether the manifest is truthful for - direct repo-local consumption without assuming an external publish/build - context. -- This matrix is intentionally package-truth-focused. It does not change - package publication semantics or protocol semantics. diff --git a/governance/audits/MPLP-DOWNSTREAM-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1.md b/governance/audits/MPLP-DOWNSTREAM-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1.md deleted file mode 100644 index a7efbd06f..000000000 --- a/governance/audits/MPLP-DOWNSTREAM-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DOWNSTREAM-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1" -title: "MPLP Downstream Boundary Posture Note 2026-04-18 v0.1" -surface_role: canonical ---- - -# MPLP Downstream Boundary Posture Note 2026-04-18 v0.1 - -> **Non-Normative Boundary Freeze Only** -> -> This note freezes current downstream-boundary reading. -> It does **not** amend schemas, invariants, package surfaces, SDKs, or frozen -> protocol law. - -## 1. Purpose - -This note records the current bounded MPLP posture toward active downstream -runtime/product pressure visible through: - -- a downstream runtime substrate -- a downstream product - -Its purpose is narrow: - -- restate that MPLP remains protocol/schema/invariant authority only -- restate that candidate backlog governance does not equal promotion -- freeze the current non-promotion boundary for downstream runtime/product - concepts - -## 2. Current MPLP Authority Posture - -Current MPLP authority remains limited to: - -- protocol definitions -- schema truth -- invariant truth -- governance source records -- bounded candidate-backlog tracking where explicitly recorded - -Current MPLP does **not** become authoritative over: - -- downstream runtime realization choices -- downstream product operating-model choices -- mother-runtime-private object families in a downstream runtime substrate -- product projection surfaces in a downstream product - -## 3. Frozen Downstream Boundary Read - -The following remain outside active MPLP law now: - -- `Cell` / multi-cell semantics -- collection semantics -- role-specific workflow semantics -- `Business Pack` semantics -- `Metrics Pack` semantics -- product summary cards and product review packets -- downstream runtime substrate runtime-private management-object families as - protocol object - law - -Current correct read: - -- some abstraction pressure remains visible as candidate-only material -- other downstream concepts remain explicitly out of MPLP scope -- concrete runtime-private downstream runtime substrate objects do not become - protocol law by downstream usage - -## 4. Candidate-Only Reminder - -Current candidate-only tracking remains bounded to the already recorded -candidate families such as: - -- `Delegation Envelope` -- `Delivery / Acceptance Contract Envelope` -- `Constraint / Stop Condition / Escalation Envelope` - -Even those remain: - -- candidate-only -- not promoted -- not sufficient to widen frozen core protocol truth - -## 5. Net Rule - -The current downstream-boundary rule is: - -- downstream pressure may inform backlog visibility -- downstream pressure may not widen protocol law by convenience -- repeated local usefulness alone is not promotion evidence -- runtime/product semantics must stay runtime/product semantics unless a future - separately governed promotion wave proves otherwise - -## 6. Frozen Conclusion - -As of `2026-04-18`, MPLP should still be read as: - -- protocol/schema/invariant/candidate-backlog authority only - -It should not be read as: - -- the owner of current downstream runtime semantics -- the owner of current downstream product semantics -- already widened to absorb `Cell`, collection, role-specific workflow, - `Business Pack`, or `Metrics Pack` into active protocol law diff --git a/governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-EXCEPTION-REGISTER-v0.1.md b/governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-EXCEPTION-REGISTER-v0.1.md deleted file mode 100644 index 4acba872e..000000000 --- a/governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-EXCEPTION-REGISTER-v0.1.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-LEGACY-NAMING-BOUNDARY-EXCEPTION-REGISTER-v0.1" -title: "MPLP Legacy Naming Boundary Exception Register v0.1" -surface_role: canonical ---- - -# MPLP Legacy Naming Boundary Exception Register v0.1 - -## A. Purpose - -Record remaining historical product/runtime references intentionally not -rewritten. - -## B. Exceptions Table - -| File | Term | Reason retained | Boundary mitigation | Future action | -| --- | --- | --- | --- | --- | -| `governance/releases/MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD.md` | `SoloCrew`, `Secretary` | `sealed_historical_record` | preserved as historical closure wording only; not protocol law, not normative promotion, and not present as a new anonymous candidate note | revisit only in a dedicated archival-neutralization wave if historical fidelity can be preserved | - -## C. Boundary Mitigation - -Retained legacy references are not normative, not endorsement, not -certification, not schema/protocol law, and not implementation dependency. - -## D. Decision - -`MPLP_LEGACY_NAMING_BOUNDARY_EXCEPTIONS_REGISTERED` diff --git a/governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-INVENTORY-v0.1.md b/governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-INVENTORY-v0.1.md deleted file mode 100644 index 04bb5bbad..000000000 --- a/governance/audits/MPLP-LEGACY-NAMING-BOUNDARY-INVENTORY-v0.1.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-LEGACY-NAMING-BOUNDARY-INVENTORY-v0.1" -title: "MPLP Legacy Naming Boundary Inventory v0.1" -surface_role: canonical ---- - -# MPLP Legacy Naming Boundary Inventory v0.1 - -## A. Purpose - -Inventory legacy product/runtime naming or endorsement-risk terms in MPLP -governance space. - -## B. Match Inventory - -| File | Term | Context class | Correction decision | Reason | -| --- | --- | --- | --- | --- | -| `governance/05-specialized/ENTITY_DISAMBIGUATION_POLICY.md` | `certified`, `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | specialized disambiguation policy intentionally lists authority-claim patterns to reject | -| `governance/releases/MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD.md` | `SoloCrew`, `Secretary` | `sealed_or_historical_record` | `keep_with_legacy_exception` | historical closure record preserves contemporaneous downstream wording and should not be silently rewritten | -| `governance/04-records/AUDIT-LINKMAP-2026-01-20.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | record contains grep examples and a negated boundary summary about non-certification language | -| `governance/01-constitutional/CONST-001_ENTRY_MODEL_SPEC.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | constitutional entry model uses non-certification and prohibited-claim wording as boundary control | -| `governance/01-constitutional/CONST-006_DOC_TYPE_OUTLINES_AND_DEPTH_RULES.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | doc-type rules describe endorsement/certification drift as a failure pattern, not a positive claim | -| `governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | freeze baseline enumerates prohibited claim surfaces | -| `governance/01-constitutional/legal/LEGAL_NOTICE.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | legal notice explicitly disclaims certification, endorsement, and ranking | -| `governance/02-methods/schema/CONSISTENCY-STACK.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | schema-method guidance uses certification language only to deny authority and keep scope bounded | -| `governance/04-records/CONST-007-CROSS-SURFACE-CLOSURE-RECORD-2026-04-08.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | closure record uses non-certification wording as a boundary disclosure | -| `governance/03-distribution/sdk/MPGC_APPROVAL_SDKR_v1.0.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | approval SDKR record flags certification claims as out of scope | -| `governance/04-records/AUDIT-4ENTRY-SEO-GEO-LINKMAP-2026-01-21-SEAL.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | audit seal record documents explicit negation patterns such as not-certification and does-not-endorse | -| `governance/04-records/FR-ENTITY-ALIGNMENT-2026-01-08.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | entity-alignment record explicitly states that no certification program exists | -| `governance/02-methods/docs/METHOD-DGA-01_DOCS_NARRATIVE_ENTRY_ALIGNMENT_AUDIT.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | audit checklist uses no-endorsement / no-certification wording as a guardrail | -| `governance/04-records/AUDIT-LINKMAP-2026-01-21-LINK-03-DETAILS.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | audit details file inventories certification-related phrases to keep them bounded and negated | -| `governance/04-records/AUDIT-LINKMAP-2026-01-20-PHASE2B.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | phase-2 audit record documents negated certification wording and grep coverage | -| `governance/04-records/SEAL-SSOT-ALIGNMENT-2026-01-20.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | alignment record notes zero problematic certification matches as boundary evidence | -| `governance/04-records/MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | ratify record uses certification only as a prohibited authority claim | -| `governance/02-methods/docs/HIGH_RISK_PAGES_REGISTRY.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | registry warns about perceived certification risk on public-facing docs | -| `governance/02-methods/docs/METHOD-ECCA-01_EDITORIAL_CLARITY_AUDIT.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | editorial audit clarifies evaluation rules are not certification claims | -| `governance/02-methods/docs/CHECKLIST-DOCS-GOV-01.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | governance checklist bans certification/endorsement narratives | -| `governance/02-methods/docs/METHOD-LINKMAP-01_FOUR_ENTRY_LINK_INTEGRITY_AUDIT.md` | `certified`, `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | link-integrity audit treats certification vocabulary as a non-certifying boundary pattern | -| `governance/02-methods/docs/PATTERN-LIBRARY-DOCS-01.md` | `certification` | `false_positive_negative_boundary` | `false_positive_no_change` | pattern library uses the term only in a direct negation boundary example | - -## C. Decision - -`MPLP_LEGACY_NAMING_BOUNDARY_INVENTORY_COMPLETE` diff --git a/governance/audits/MPLP-MPGC-CANDIDATE-INTAKE-NON-PROMOTION-AUDIT-v0.1.md b/governance/audits/MPLP-MPGC-CANDIDATE-INTAKE-NON-PROMOTION-AUDIT-v0.1.md deleted file mode 100644 index 7077302f2..000000000 --- a/governance/audits/MPLP-MPGC-CANDIDATE-INTAKE-NON-PROMOTION-AUDIT-v0.1.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-INTAKE-NON-PROMOTION-AUDIT-v0.1" -title: "MPLP MPGC Candidate Intake Non Promotion Audit v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Intake Non Promotion Audit v0.1 - -This audit verifies: - -- no schema change -- no protocol law change -- no normative promotion -- no guide draft -- no profile draft -- no binding draft -- no accepted candidate -- no conformance obligation -- no runtime endorsement -- no product endorsement -- no implementation endorsement -- no certification claim - -## Decision - -`MPLP_MPGC_CANDIDATE_INTAKE_NON_PROMOTION_AUDIT_PASS` diff --git a/governance/audits/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-NON-PROMOTION-AUDIT-v0.1.md b/governance/audits/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-NON-PROMOTION-AUDIT-v0.1.md deleted file mode 100644 index dc29591b1..000000000 --- a/governance/audits/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-NON-PROMOTION-AUDIT-v0.1.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-NON-PROMOTION-AUDIT-v0.1" -title: "MPLP MPGC Candidate Review Preparation Non Promotion Audit v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Review Preparation Non Promotion Audit v0.1 - -## A. Purpose - -Audit that review preparation did not become MPGC decision or protocol -promotion. - -## B. Non-Promotion Matrix - -| Boundary | Required | Observed | Result | -| --- | --- | --- | --- | -| no schema change | review preparation must not modify schemas | no schema change recorded | `PASS` | -| no protocol law change | review preparation must remain below MPLP law change | no protocol law change recorded | `PASS` | -| no normative promotion | review preparation must stay pre-RFC and non-normative | materials remain pre-RFC and non-normative | `PASS` | -| no MPGC acceptance | review preparation must not record acceptance | no MPGC acceptance recorded | `PASS` | -| RFC not opened | review preparation must not open an RFC | no RFC is opened in this wave | `PASS` | -| no guide draft | review preparation must not create a guide draft | no guide draft created | `PASS` | -| no profile draft | review preparation must not create a profile draft | no profile draft created | `PASS` | -| no binding draft | review preparation must not create a binding draft | no binding draft created | `PASS` | -| no conformance obligation | review preparation must not create obligations | no conformance obligation recorded | `PASS` | -| no runtime endorsement | review preparation must not endorse a runtime substrate | no runtime endorsement recorded | `PASS` | -| no product endorsement | review preparation must not endorse a downstream product | no product endorsement recorded | `PASS` | -| no implementation endorsement | review preparation must not endorse an implementation substrate | no implementation endorsement recorded | `PASS` | -| no certification claim | review preparation must not make certification-like claims | no certification claim recorded | `PASS` | -| no source code change | review preparation must remain governance-only | no source code changed | `PASS` | -| no release/tag | review preparation must not create release artifacts | no tag or release created | `PASS` | - -## C. Decision - -`MPLP_MPGC_CANDIDATE_REVIEW_PREPARATION_NON_PROMOTION_AUDIT_PASS` diff --git a/governance/audits/MPLP-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1.md b/governance/audits/MPLP-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1.md deleted file mode 100644 index fd7b5cc4e..000000000 --- a/governance/audits/MPLP-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1.md +++ /dev/null @@ -1,144 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-PACKAGE-TRUTH-AND-TOOLING-REVIEW-v0.1" -title: "MPLP Package Truth and Tooling Review v0.1" -surface_role: canonical ---- - -# MPLP Package Truth and Tooling Review v0.1 - -> **Non-Normative Tooling Closure Only** -> -> This document records current package/tooling truth in the checked-in -> repository. It does not change schemas, invariants, packages, or protocol law. - -## 1. Purpose - -This review exists to make current repo-local package truth less ambiguous. - -The main question is not whether packages may be published in other contexts. -The main question is what this repository currently and truthfully provides as a -checked-in package/tooling surface today. - -## 2. Root-Level Tooling Posture - -Current root truth is bounded: - -- the root repository has no truthful unified workspace type gate -- the root repository has no truthful unified workspace build gate -- root `npm test` is currently a no-op placeholder, not a protocol/package test - gate -- package-level `tsconfig.json` files exist in multiple subtrees, but that does - not add up to one verified root build posture -- checked-in package manifests often describe publish-oriented outputs rather - than repo-local guaranteed artifacts - -This means the current repository should not be read as a monorepo with a fully -executable root package/tooling contract. - -## 3. Package Family Classification - -### 3.1 `packages/npm/*` - -The `packages/npm/*` tree is best read today as a publish-surface-oriented -package line, not as a uniformly locally consumable checked-in package line. - -In the current checked-in repo: - -- most package manifests declare `main` and `types` under `dist/` -- those `dist/` targets are not present in checked-in repo truth -- some packages still contain bounded source-side residue such as local - `tsconfig.json`, tests, or `src/` -- that residue does not by itself make the package manifest truthful for - repo-local consumption - -### 3.2 `packages/sources/*` - -The `packages/sources/*` tree is not one uniform source-package family. - -Current checked-in truth is mixed: - -- `packages/sources/validator/` is the clearest checked-in source package - because it contains `src/` and a direct source-side build posture -- `packages/sources/sdk-ts/` identifies itself as a source mirror, but current - checked-in contents are mirror/release-prep oriented and do not include a - checked-in `src/` or `dist/` - -So "`packages/sources/*` equals locally buildable source packages" is also not a -truthful blanket reading. - -## 4. Safe vs Misleading Assumptions - -### 4.1 Safe Current Assumptions - -The following assumptions are currently safe: - -- frozen protocol truth still lives in schemas, governance, and repository - source records -- package metadata may still be meaningful for publish/release posture even when - repo-local build artifacts are absent -- source/build/package posture is currently uneven across package families -- package/tooling posture needs explicit reading rather than inference - -### 4.2 Misleading Current Assumptions - -The following assumptions are misleading and should be rejected: - -- "all `packages/npm/*` are locally consumable as checked-in packages" -- "declared `main` and `types` imply checked-in `dist/` reality" -- "the root repository already provides a truthful root type/build gate" -- "all `packages/sources/*` are equivalent locally buildable source packages" -- "tracked empty AppleDouble-style files are meaningful repo assets" - -## 5. Tooling Irregularities Confirmed - -This review confirmed several bounded tooling irregularities: - -- multiple tracked empty `.!*` files were present in the repo and did not carry - package or protocol meaning -- `packages/sources/validator/tsconfig.json` was encoded as UTF-16 LE with CRLF, - unlike the repo's otherwise normal JSON/ASCII tooling posture -- package-level `dist/` expectations are often publish-oriented rather than - checked-in truth - -These are tooling/package-truth issues, not protocol-law issues. - -## 6. Bounded Judgment - -The current repo truth is best described as: - -- frozen protocol repository first -- publish-surface metadata second -- uneven checked-in local package/tooling consumability - -That is acceptable as long as it is stated explicitly and not over-read as a -fully unified root package workspace. - -## 7. Bounded Hardening From This Wave - -This wave hardens the repo by: - -- recording a package-truth review under governance -- recording a package-by-package `dist/` reality matrix -- clarifying README/CHANGELOG wording around current tooling posture -- normalizing the validator source `tsconfig.json` into ordinary UTF-8 JSON -- removing tracked empty `.!*` files and ignoring future reintroduction - -## 8. Residual Future Work - -This wave does **not** solve all future tooling work. - -Still-deferred work includes: - -- deciding whether a truthful root-level type/build gate should exist -- deciding whether selected `packages/npm/*` should become locally consumable in - checked-in form -- deciding whether selected source mirrors should be tightened further to avoid - mixed publish/mirror expectations - -Those would require separate, explicitly bounded tooling work. diff --git a/governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md b/governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md deleted file mode 100644 index 708fa005f..000000000 --- a/governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1" -title: "MPLP Binding Consideration Evidence Vocabulary v0.1" -surface_role: canonical ---- - -# MPLP Binding Consideration Evidence Vocabulary v0.1 - -## A. Purpose - -Hold non-normative future binding consideration material for evidence -vocabulary / lifecycle revision relations. - -## B. Candidate Scope - -Binding consideration for how implementation substrates may map evidence -insufficiency, stale context, clarification, and revision references into -MPLP-aligned evidence records without changing protocol schemas. - -## C. Candidate Mapping Questions - -| Mapping question | Candidate treatment | Current decision | -| --- | --- | --- | -| evidence insufficiency relation | treat as future binding-consideration vocabulary rather than schema law | `binding_consideration_holding` | -| stale context relation | treat as a relation-mapping question, not a new protocol object | `binding_consideration_holding` | -| prior artifact reference | treat as a reference-linking consideration only | `binding_consideration_holding` | -| revised artifact reference | treat as a reference-linking consideration only | `binding_consideration_holding` | -| non-executing posture reference | treat as a posture vocabulary consideration, not a normative field | `binding_consideration_holding` | -| safe evidence references | treat as bounded evidence-reference wording only | `binding_consideration_holding` | -| blocked / contract-blocked relation | treat as a relation and posture mapping question only | `binding_consideration_holding` | - -## D. Non-Decisions - -- no schema change -- no binding spec change now -- no runtime endorsement -- no implementation dependency -- no certification claim - -## E. Decision - -`MPLP_BINDING_CONSIDERATION_EVIDENCE_VOCABULARY_HOLDING_READY` diff --git a/governance/backlog/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md b/governance/backlog/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md deleted file mode 100644 index 125719e03..000000000 --- a/governance/backlog/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md +++ /dev/null @@ -1,172 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1" -title: "MPLP Boundary and Promotion Rules v0.1" -surface_role: canonical ---- - -# MPLP Boundary and Promotion Rules v0.1 - -> **Non-Normative Governance Frame** -> -> This document defines a candidate-triage and promotion frame only. -> It does **not** create accepted protocol content and does **not** override the -> frozen MPLP core. - -## 1. Purpose - -This document defines the explicit ladder for deciding whether a concept should -remain: - -- product convenience -- mother-runtime family abstraction -- cross-runtime reusable abstraction -- protocol-candidate -- protocol-law - -Its purpose is to stop accidental protocol bloat from downstream usage pressure. - -## 2. Promotion Ladder - -### 2.1 Product Convenience - -A concept stays at product level when it mainly packages: - -- UI structure -- business-facing language -- product summaries, cards, consoles, or workflows -- product-specific management or operating semantics - -Product convenience does **not** create MPLP authority. - -### 2.2 Mother-Runtime Family Abstraction - -A concept belongs at runtime-family level when it is needed to realize: - -- orchestration -- state -- evidence handling -- policy -- bounded coordination - -inside a runtime family, but is not yet proven as a universal interface -obligation. - -Runtime-family abstraction does **not** create MPLP authority. - -### 2.3 Cross-Runtime Reusable Abstraction - -A concept reaches this stage when it has: - -- pressure from more than one runtime family -- meaning that is no longer product-specific -- plausible reuse across implementations - -This still does **not** make it protocol law. -It only makes protocol-candidate consideration plausible. - -### 2.4 Protocol-Candidate - -A concept is a protocol candidate only when it: - -- looks implementation-independent -- looks vendor-neutral -- has plausible schema-level or invariant-level expression -- shows repeated pressure beyond one downstream product or one runtime - -Even at this stage, it remains non-normative until a later explicit promotion -decision. - -### 2.5 Protocol-Law - -A concept becomes protocol law only when it is explicitly adopted into: - -- schemas -- invariants -- normative documentation -- or other frozen protocol-core assets - -No candidate becomes protocol law implicitly. - -## 3. Required Evidence Before Promotion - -Before any concept moves upward toward protocol-candidate status, the evidence -package must include all of the following: - -### 3.1 Repeated Downstream Pressure - -The concept must show repeated pressure in more than one bounded downstream -context. - -### 3.2 Cross-Implementation Plausibility - -The concept must remain meaningful across multiple implementation approaches, -not only one runtime or one product architecture. - -### 3.3 Vendor-Neutral Semantics - -The concept must be expressible without relying on: - -- one vendor -- one provider -- one framework -- one runtime style - -### 3.4 Schema-Shape Stability - -The concept must be stable enough that a schema-level or invariant-level shape -can be discussed without constant redesign. - -### 3.5 Non-Product-Specific Meaning - -The concept must remain meaningful even when stripped of: - -- product UI wording -- business-domain phrasing -- application-specific workflow packaging - -### 3.6 Non-Overlap With Frozen Core - -There must be a clear showing that current MPLP semantics cannot already host -the need. - -## 4. Promotion Stop Rules - -A concept must **not** be promoted when any of the following remain true: - -- it is mainly product convenience -- it is mainly runtime-private realization -- it is still shaped by one product’s operating model -- it is still shaped by one runtime’s orchestration design -- it is not stable enough for schema-level discussion -- it duplicates or shadows existing MPLP truth - -## 5. No Silent Promotion Rule - -No downstream repository may silently promote semantics into MPLP by: - -- usage volume alone -- repeated local implementation alone -- architectural preference alone -- convenience for one runtime or product alone - -Downstream repetition may create candidate pressure. -It does **not** create protocol-law status. - -## 6. Net Rule - -MPLP should remain a small, hard, POSIX-like protocol core. - -That means: - -- most concepts should stay out -- some concepts may become runtime-family abstractions -- a smaller subset may become cross-runtime abstractions -- only the most proven abstractions may become protocol candidates -- almost none should become protocol law without explicit evidence and explicit - governance action diff --git a/governance/backlog/MPLP-CANDIDATE-BACKLOG-CONSOLIDATION-PLAN-v0.1.md b/governance/backlog/MPLP-CANDIDATE-BACKLOG-CONSOLIDATION-PLAN-v0.1.md deleted file mode 100644 index 1f589e15f..000000000 --- a/governance/backlog/MPLP-CANDIDATE-BACKLOG-CONSOLIDATION-PLAN-v0.1.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-BACKLOG-CONSOLIDATION-PLAN-v0.1" -title: "MPLP Candidate Backlog Consolidation Plan v0.1" -surface_role: canonical ---- - -# MPLP Candidate Backlog Consolidation Plan v0.1 - -## A. Purpose - -Plan how overlapping backlog/research candidate files should be consolidated -over future waves. - -## B. Consolidation Groups - -| Group | Source files | Consolidation target | Action | Timing | -| --- | --- | --- | --- | --- | -| general candidate backlog | `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md`; `governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md` | primary backlog umbrella plus research archive note | keep backlog as primary active surface and demote research backlog to historical support | future consolidation wave | -| downstream lifecycle governance candidates | `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md`; `governance/backlog/MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1.md` | future guide-candidate umbrella | split governance/disclosure guidance from other candidate tracks before any guide-oriented follow-up | future guide-candidate wave | -| non-executing lifecycle revision candidates | `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md`; `governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md` | backlog-held lifecycle-revision umbrella | retain backlog now, then split guide/profile/binding subtracks only if more anonymous downstream evidence arrives | future candidate consolidation wave | -| delegation/delivery constraint candidates | `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md`; `governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md`; `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md` | single active backlog family set | merge research duplication into backlog references and keep one active governance expansion surface | future consolidation wave | -| cross-repo non-promotion candidates | `governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md`; `governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md`; `governance/audits/MPLP-DOWNSTREAM-BOUNDARY-POSTURE-NOTE-2026-04-18-v0.1.md` | closed boundary archive | preserve as boundary-closure evidence rather than treat as primary active candidate backlog | future boundary-archive wave | -| research backlog vs governance backlog duplication | `governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md`; `governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md`; governance backlog counterparts | research archive plus governance primary set | stop treating research duplicates as co-equal active candidate sources | future consolidation wave | - -## C. Do Not Do In This Wave - -- do not delete historical files in this wave -- do not rewrite sealed records -- do not merge all candidate files blindly -- do not create normative spec changes -- do not update schemas - -## D. Decision - -`MPLP_CANDIDATE_BACKLOG_CONSOLIDATION_PLAN_READY` diff --git a/governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md b/governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md deleted file mode 100644 index e00efb820..000000000 --- a/governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-BACKLOG-INDEX-v0.1" -title: "MPLP Candidate Backlog Index v0.1" -surface_role: canonical ---- - -# MPLP Candidate Backlog Index v0.1 - -## A. Purpose - -Define a canonical index for active MPLP candidate backlog surfaces after -review and consolidation. - -This index is: - -- non-normative -- backlog/index only -- no schema change -- no protocol law change -- no normative promotion -- no runtime/product/implementation endorsement -- no certification claim - -## B. Active Candidate Index - -| Candidate ID | Candidate theme | Status | Target surface | Source files | Next action | -| --- | --- | --- | --- | --- | --- | -| `MPLP-CAND-LIFECYCLE-REVISION-001` | non-executing lifecycle revision | `active_backlog` | `backlog` | `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md`; `governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md` | keep backlog-held and gather more anonymous downstream evidence before any drafting wave | -| `MPLP-CAND-EVIDENCE-VOCABULARY-001` | evidence vocabulary consideration for insufficiency / stale context / clarification / revision relations | `binding_consideration_holding` | `binding_consideration` | `governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md`; `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md`; `governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md` | refine non-schema mapping questions in a later binding-consideration wave | -| `MPLP-CAND-DELEGATION-DELIVERY-CONSTRAINT-001` | delegation / delivery / acceptance / constraint family | `active_backlog` | `backlog` | `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md`; `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | retain as the primary umbrella family while consolidation remains governance-only | -| `MPLP-CAND-STOP-ESCALATION-PROFILE-001` | stop / escalation / clarification / revision posture family | `profile_candidate_holding` | `profile_candidate` | `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md`; `governance/backlog/MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md` | hold as future profile-candidate material and refine posture questions only | -| `MPLP-CAND-GUIDE-LIFECYCLE-GOVERNANCE-001` | lifecycle governance explanation and boundary guidance | `guide_candidate_holding` | `guide_candidate` | `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md`; `governance/backlog/MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md` | hold as future guide-candidate material without publishing any normative guide in this wave | - -## C. Closed / Archived Surfaces - -| Source file | Closure / archive status | Reason | Replacement / parent | -| --- | --- | --- | --- | -| `governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md` | `research_archive` | overlaps the active backlog umbrella and is better treated as supporting research context | `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md` | -| `governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | `closed` | materially duplicates the active governance expansion surface for the same family set | `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | -| `governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md` | `closed` | remains boundary-closure evidence rather than an active candidate surface | `governance/backlog/MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md` | -| `governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md` | `deferred` | still useful as a classification snapshot, but no longer a primary active candidate source | `governance/backlog/MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md` | - -## D. Decision - -`MPLP_CANDIDATE_BACKLOG_INDEX_READY` diff --git a/governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md b/governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md deleted file mode 100644 index e60421e6d..000000000 --- a/governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-BACKLOG-v0.1" -title: "MPLP Candidate Backlog v0.1" -surface_role: canonical ---- - -# MPLP Candidate Backlog v0.1 - -> **Non-Normative Candidate Tracking Only** -> -> This document records downstream-driven candidate abstractions only. -> It does **not** amend `schemas/v2/`, invariants, module duties, package -> surfaces, or any other frozen MPLP core truth. - -## 1. Purpose - -This backlog captures bounded downstream pressure that has now become visible -after: - -- a downstream product multi-cell foundation line -- a downstream runtime substrate runtime blocker intake and foundation refresh - -Those downstream pressures do **not** automatically justify protocol promotion. - -The role of this backlog is therefore narrow: - -- keep candidate pressure visible -- keep it separate from frozen protocol law -- record what evidence would be required before any candidate could advance - -## 2. Intake Boundary - -Only the following candidate families are in scope for this backlog wave: - -1. `Delegation Envelope` -2. `Delivery / Acceptance Contract Envelope` -3. `Constraint / Stop Condition / Escalation Envelope` - -Everything else must stay out of MPLP for now, including: - -- `Cell` -- collection semantics -- downstream product-specific role semantics -- `Crew Compiler` -- KPI, OKR, brand, or business data families -- `Business Pack` or `Metrics Pack` -- role/model/tool policy packaging -- product cards or summary-projection objects -- downstream runtime substrate private runtime objects - -## 3. Candidate Status Scale - -Each candidate must end in exactly one of: - -- `candidate_only` -- `candidate_but_not_ready` -- `not_protocol_fit_at_this_time` - -## 4. Candidate Classification - -| Candidate Family | Downstream Pressure Present? | Cross-Implementation Plausibility | Protocol-Fit Strength | Current Maturity | Promotion Readiness | Current Status | -| --- | --- | --- | --- | --- | --- | --- | -| `Delegation Envelope` | Yes. Downstream structures increasingly need bounded delegation or handoff semantics. | Plausible, but not yet evidenced across multiple independent runtimes or products. | Medium. Delegation can be protocol-shaped, but current pressure is still entangled with runtime orchestration and product workflow. | Early. Conceptual only. | Not ready. | `candidate_only` | -| `Delivery / Acceptance Contract Envelope` | Yes. Downstream work increasingly distinguishes requested work, returned delivery posture, and acceptance posture. | Plausible, but current examples are still close to business-operating language. | Medium-low. It may become protocol-relevant, but the neutral kernel is not yet proven. | Early. Conceptual only. | Not ready. | `candidate_but_not_ready` | -| `Constraint / Stop Condition / Escalation Envelope` | Yes. Downstream pressure is strong around constraints, stop conditions, approval-like gates, and escalation posture. | Plausible. This family looks more cross-runtime than the others, but still lacks repeated independent validation. | Medium-high. It sits closest to portable execution-safety and escalation semantics. | Early-to-mid. Pressure is real, but not yet stabilized. | Not ready. | `candidate_but_not_ready` | - -## 5. Candidate Notes - -### 5.1 Delegation Envelope - -Why tracked: - -- downstream structures now need a bounded way to express delegation, handoff, - or transfer of responsibility -- that abstraction may matter beyond one product if it can stay - implementation-independent - -Why not yet protocol law: - -- current evidence is still mixed with runtime-family orchestration and product - workflow structure -- no accepted MPLP schema, invariant, or module surface exists for this family -- repeated validation across more than one runtime/product is missing - -### 5.2 Delivery / Acceptance Contract Envelope - -Why tracked: - -- downstream work increasingly separates requested work, returned delivery - posture, and acceptance posture -- that separation may eventually have protocol value if it proves portable - -Why not yet protocol law: - -- current examples remain close to business-facing operating semantics -- the vendor-neutral kernel is not yet proven -- MPLP must not absorb product-shaped delivery semantics by convenience - -### 5.3 Constraint / Stop Condition / Escalation Envelope - -Why tracked: - -- downstream pressure is now clear around constraints, stop conditions, and - escalation or approval-like posture -- this family sits closest to portable interface obligations around bounded - execution safety - -Why not yet protocol law: - -- current evidence still overlaps with runtime policy, approval handling, and - product-specific decision flow -- no accepted MPLP-level schema or invariant family exists here today -- repeated independent validation is still missing - -## 6. Net Backlog Rule - -The correct current MPLP posture is: - -- track these candidates -- keep them visible -- keep them outside frozen core law -- refuse promotion by usage volume alone - -No candidate in this backlog becomes MPLP law unless a later separate wave -provides the promotion evidence required by -`MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1`. diff --git a/governance/backlog/MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1.md b/governance/backlog/MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1.md deleted file mode 100644 index a63e9f764..000000000 --- a/governance/backlog/MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1" -title: "MPLP Candidate Disposition Matrix v0.1" -surface_role: canonical ---- - -# MPLP Candidate Disposition Matrix v0.1 - -## A. Purpose - -Define disposition decisions for current candidate backlog items. - -## B. Disposition Matrix - -| Candidate ID / Source | Disposition | Target surface | Rationale | Non-decisions | -| --- | --- | --- | --- | --- | -| `CB-01 / governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md` | `retain_backlog` | `backlog` | keep the current umbrella backlog as the primary active registry for delegation, delivery, and constraint families | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-02 / governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md` | `merge_into_parent_candidate` | `research_archive` | research backlog overlaps the active backlog and is best treated as secondary evidence rather than a co-equal active registry | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-03 / governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | `retain_backlog` | `backlog` | detailed envelope-family expansion remains useful as the active conceptual companion to the umbrella backlog | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-04 / governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | `close_as_duplicate` | `research_archive` | research expansion is now materially overlapped by the active backlog expansion and should stop acting as a primary candidate surface | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-05 / governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md` | `advance_to_guide_candidate` | `guide_candidate` | governance-facing release-evidence, closure, and disclosure patterns fit best as future guide-candidate material rather than schema or protocol-law content | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-06 / governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md` | `retain_backlog` | `backlog` | non-executing lifecycle revision remains early evidence and should stay backlog-held while its guide/profile/binding edges mature | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-07 / lifecycle evidence vocabulary consideration from governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md and governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md` | `advance_to_binding_consideration` | `binding_consideration` | evidence insufficiency, stale context, clarification posture, and related vocabulary have the clearest fit as future binding-consideration work | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-08 / stop-condition-escalation family from governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md and governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | `advance_to_profile_candidate` | `profile_candidate` | the constraint / stop condition / escalation family is the strongest portable posture family and is best held as future profile-candidate material | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-09 / governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md` | `close_as_non_mplp` | `closed` | this file is a boundary-closure posture record, not an active candidate family, and should stay outside future promotion traffic except as guardrail evidence | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | -| `CB-10 / governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md` | `defer_pending_more_evidence` | `backlog` | the closure matrix remains useful as a bounded classification snapshot, but future consolidation should treat it as a supporting status surface rather than a primary candidate source | no schema change; no protocol law change; no normative status; no runtime endorsement; no product endorsement; no certification claim | - -## C. Decision - -`MPLP_CANDIDATE_DISPOSITION_MATRIX_READY` diff --git a/governance/backlog/MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md b/governance/backlog/MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md deleted file mode 100644 index 23c1fafd9..000000000 --- a/governance/backlog/MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1" -title: "MPLP Candidate Research Archive and Duplicate Closure v0.1" -surface_role: canonical ---- - -# MPLP Candidate Research Archive and Duplicate Closure v0.1 - -## A. Purpose - -Record which candidate/research surfaces are archived or closed as duplicates -after consolidation. - -## B. Archive / Closure Matrix - -| Source file | Closure status | Parent / replacement | Reason | Future action | -| --- | --- | --- | --- | --- | -| `governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md` | `merged_into_parent_candidate` | `governance/backlog/MPLP-CANDIDATE-BACKLOG-v0.1.md` | overlaps the active backlog umbrella and is better treated as supporting research context | keep file as research archive context only | -| `governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | `closed_as_duplicate` | `governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md` | materially duplicates the active governance expansion surface for the same family set | keep file as historical context only | -| `governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md` | `closed_as_non_mplp` | `governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md` | remains a boundary-closure posture record rather than an active candidate family | preserve as closed boundary evidence | -| `governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md` | `deferred_pending_more_evidence` | `governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md` | still useful as a classification snapshot, but not a primary active candidate surface | keep as supporting backlog status evidence until a later consolidation wave | - -## C. Do Not Delete Statement - -This wave records closure/archive posture only. It does not delete historical -files. - -## D. Decision - -`MPLP_CANDIDATE_RESEARCH_ARCHIVE_DUPLICATE_CLOSURE_READY` diff --git a/governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md b/governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md deleted file mode 100644 index 2fa9587f8..000000000 --- a/governance/backlog/MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1.md +++ /dev/null @@ -1,138 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CROSS-REPO-NON-PROMOTION-CLOSURE-v0.1" -title: "MPLP Cross-Repo Non-Promotion Closure v0.1" -surface_role: canonical ---- - -# MPLP Cross-Repo Non-Promotion Closure v0.1 - -> **Non-Normative Boundary Closure Only** -> -> This document records the non-promotion judgment for the current -> downstream product / downstream runtime substrate line. -> It does **not** promote any schema, invariant, package, SDK, or protocol law. - -## 1. Purpose - -The current three-repo line is now closed enough that MPLP must state its -boundary explicitly. - -This document therefore records the net judgment that: - -- downstream product usage does not imply MPLP promotion -- downstream runtime substrate runtime-private implementation does not imply - MPLP promotion -- current downstream `v0.4` multi-cell work does not silently create MPLP law - -## 2. Current Cross-Repo Truth - -### 2.1 Downstream Product - -The downstream product currently contributes: - -- bounded product-projected surfaces -- bounded read/inspect-only management and continuity visibility -- no protocol authority ownership -- no mother-runtime authority ownership - -These product surfaces may create downstream pressure. -They are not MPLP objects. - -### 2.2 Downstream Runtime Substrate - -The downstream runtime substrate currently contributes: - -- bounded runtime-private workforce records -- bounded downstream-consumable runtime-private inputs -- non-exportable by-default runtime-private object treatment - -These runtime-private workforce objects are not MPLP objects. - -### 2.3 MPLP - -MPLP currently contributes: - -- frozen core protocol law -- non-normative candidate backlog discussion -- promotion rules that reject accidental elevation from downstream usage - -MPLP has not adopted the current downstream abstractions into protocol law. - -## 3. Explicit Non-Promotion Judgments - -The following statements are now closed as current truth: - -- downstream product usage does not imply MPLP promotion. -- downstream runtime substrate runtime-private implementation does not imply - MPLP promotion. -- runtime-private workforce objects are not MPLP objects. -- product-projected management or inspection surfaces are not MPLP objects. -- no current `v0.4` multi-cell line should be read as frozen MPLP law. -- repeated downstream usage alone is not enough to promote protocol law. - -## 4. Misreadings Explicitly Rejected - -The following readings are incorrect and must be rejected: - -### 4.1 "Cell Runtime Scope means MPLP now has Cell semantics" - -Rejected because: - -- `cell-runtime-scope` is currently a downstream runtime substrate - runtime-private object -- current Cell semantics belong to product/runtime layers, not MPLP core -- MPLP has not adopted Cell semantics into schemas or invariants - -### 4.2 "Approval Request Record means MPLP now has approval envelope law" - -Rejected because: - -- `approval-request-record` is currently a runtime-private workforce record -- current approval/escalation pressure remains only candidate material -- MPLP has no adopted approval-envelope schema family today - -### 4.3 "Downstream product inspect surfaces prove protocol-level delegation or acceptance semantics exist" - -Rejected because: - -- downstream product surfaces are product projections -- product projections can reveal downstream pressure without defining protocol - law -- inspect-only product surfaces are not evidence of adopted protocol semantics - -### 4.4 "Repeated downstream usage alone is enough to promote protocol law" - -Rejected because: - -- current MPLP promotion rules already forbid silent promotion by usage volume - alone -- downstream repetition may create candidate pressure only -- protocol promotion still requires explicit evidence and explicit governance - action - -## 5. Net Closure Rule - -The correct current three-repo reading is: - -- the downstream product remains a downstream product consumer -- the downstream runtime substrate remains a provider of runtime-private truth -- MPLP remains the frozen protocol core plus non-normative candidate backlog - -No boundary in the current line has collapsed those three roles into one. - -## 6. Consequence For Future Discussion - -If future MPLP promotion discussion ever reopens, it must begin from this -starting point: - -- current downstream abstractions are not yet MPLP law -- current runtime-private objects are not protocol objects -- current product-projected surfaces are not protocol objects -- any future promotion discussion must justify a smaller, more neutral kernel - than the current downstream forms diff --git a/governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md b/governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md deleted file mode 100644 index a107196ff..000000000 --- a/governance/backlog/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md +++ /dev/null @@ -1,186 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1" -title: "MPLP Delegation Delivery Constraint Candidates v0.1" -surface_role: canonical ---- - -# MPLP Delegation Delivery Constraint Candidates v0.1 - -> **Non-Normative Candidate Expansion Only** -> -> This document expands three candidate families conceptually. -> It does **not** define accepted schema fields, accepted invariants, or new -> protocol duties. - -## 1. Purpose - -This document expands the three candidate families that downstream `v0.4` -pressure has made visible: - -- `Delegation Envelope` -- `Delivery / Acceptance Contract Envelope` -- `Constraint / Stop Condition / Escalation Envelope` - -Its job is to make candidate discussion more precise without confusing: - -- protocol-level envelope semantics -- downstream product contracts -- downstream runtime substrate runtime-private backing objects - -## 2. Boundary Distinction - -### 2.1 Protocol-Level Envelope Semantics - -At protocol level, an envelope candidate would mean only the narrowest -vendor-neutral interface shape for portable expression and evidence. - -### 2.2 Downstream Product Contracts - -Downstream product contracts are downstream business and product structures. -They may create pressure, but they are not protocol law. - -### 2.3 Downstream Runtime-Private Backing Objects - -Downstream runtime substrate runtime-private objects and runtime-family drafts -may support a -similar concern, but they are not protocol law either. - -MPLP must not absorb either downstream product contracts or runtime-private -object families by convenience. - -## 3. Candidate: Delegation Envelope - -### Narrowest Candidate Meaning - -A delegation envelope would mean only: - -- one actor or layer delegates a bounded responsibility to another -- the delegation has a bounded scope -- the delegation has a bounded expected return posture - -### Why It Might Matter Beyond One Runtime Or Product - -If real, this could support: - -- portable delegation evidence -- portable handoff interpretation -- portable distinction between delegation and raw task description - -### Why It Is Not Yet Protocol Law - -- the minimal neutral kernel is not proven -- current examples are still entangled with runtime orchestration and product - workflow structure -- no schema-stable interface shape is agreed - -### Promotion Preconditions - -- repeated pressure beyond one runtime family -- repeated pressure beyond one product -- implementation-independent semantics -- non-overlap proof against current MPLP module semantics -- stable evidence shape suitable for protocol-level expression - -### Explicitly Out Of Scope - -- downstream product `Cell`-like or management contracts -- downstream runtime substrate orchestration internals -- runtime dispatch logic -- product UI or workflow packaging - -## 4. Candidate: Delivery / Acceptance Contract Envelope - -### Narrowest Candidate Meaning - -A delivery / acceptance contract envelope would mean only: - -- bounded expected output posture -- bounded return posture -- bounded acceptance condition posture - -### Why It Might Matter Beyond One Runtime Or Product - -If real, this could support: - -- portable description of expected delivery posture -- portable distinction between return and acceptance -- portable evidence of complete, partial, blocked, or pending acceptance states - -### Why It Is Not Yet Protocol Law - -- current pressure is still too close to business-facing operating language -- the candidate still risks importing product delivery semantics into the - protocol -- stable vendor-neutral shape is not yet demonstrated - -### Promotion Preconditions - -- repeated validation outside one product class -- evidence that the concept remains meaningful outside one business domain -- stable envelope semantics that do not rely on product DTO wording -- clear proof that current MPLP semantics cannot already express the need - -### Explicitly Out Of Scope - -- downstream delivery-return contracts -- acceptance cards, dashboards, or operator consoles -- runtime completion reports or workflow timelines -- business-pack delivery semantics - -## 5. Candidate: Constraint / Stop Condition / Escalation Envelope - -### Narrowest Candidate Meaning - -A constraint / stop condition / escalation envelope would mean only: - -- bounded execution or action constraints -- bounded stop or defer conditions -- bounded escalation or approval-trigger posture - -### Why It Might Matter Beyond One Runtime Or Product - -If real, this could support: - -- portable expression of stop or escalate posture -- portable evidence of why a process halted, deferred, or requested review -- portable distinction between raw task content and bounded execution posture - -### Why It Is Not Yet Protocol Law - -- current evidence still overlaps heavily with runtime policy and product - approval handling -- the candidate has not yet shown enough implementation independence -- MPLP has no accepted envelope family here today - -### Promotion Preconditions - -- evidence from at least two independent runtime families -- proof that the concept remains vendor-neutral and product-neutral -- stable schema-shape candidate -- clear non-overlap with current modules, events, and invariants -- repeated validation outside one downstream line - -### Explicitly Out Of Scope - -- downstream approval-request contracts -- downstream runtime substrate `confirm-gate` or policy-service internals -- downstream product-specific role queues -- business approval workflows -- channel escalation routing - -## 6. Net Candidate Position - -The correct current MPLP posture is: - -- keep these three families visible -- keep them candidate-only -- keep them separate from downstream product contracts -- keep them separate from downstream runtime-private backing objects -- refuse protocol promotion until the promotion ladder and evidence rules are - actually satisfied diff --git a/governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md b/governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md deleted file mode 100644 index ec6296b1f..000000000 --- a/governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1" -title: "MPLP Downstream Evidence Lifecycle Governance Candidate Note v0.1" -surface_role: canonical ---- - -# MPLP Downstream Evidence Lifecycle Governance Candidate Note v0.1 - -## A. Purpose - -This note records lifecycle-governance candidates observed from downstream -evidence. It does not name, endorse, require, or bind any implementation, -runtime environment, product, application, vendor, or downstream repository. - -It is: - -- no schema change -- no protocol law change -- no new MPLP object -- runtime is not endorsed -- no implementation dependency -- no product / application semantics -- non-normative downstream evidence only - -## B. Mapping Table - -| Pattern | MPLP Target | Current Support | Recommended Action | Schema Impact | Notes | -| --- | --- | --- | --- | --- | --- | -| downstream request-intake evidence | nearest surfaces would be `Context` / `Dialog` / `Role` only after heavy neutralization | no protocol object matches a downstream intake surface directly | `DO_NOT_UPSTREAM` | `NO_CHANGE` | current semantics remain downstream convenience, not protocol core | -| non-executing recommendation envelope | `Confirm` guide or runtime guide note | `Confirm` exists; generic recommendation envelope does not | `GUIDE_MAPPING_CANDIDATE` | `NO_CHANGE` | likely best handled as guide-level relation between non-executing recommendation and confirmation posture | -| evidence posture summary | `Trace`-adjacent evidence-binding guidance | strong Trace/evidence vocabulary exists, but not stale/insufficient posture summary | `BINDING_NOTE_CANDIDATE` | `NO_CHANGE` | may later become an evidence-posture-to-Trace note | -| projection-safe state exposure | L3 runtime-glue guidance | runtime-glue space exists in docs; not protocol core | `RUNTIME_GLUE_CANDIDATE` | `NO_CHANGE` | this is runtime/projection handling, not L1/L2 law | -| state evaluation / runtime glue | L3 runtime-glue or PSG/VSL/AEL guide surfaces | runtime concepts are already explicitly separated from protocol-core objects | `RUNTIME_GLUE_CANDIDATE` | `NO_CHANGE` | guide first, not schema | -| forbidden claim scan | governance guide | protocol repo already carries boundary and promotion governance | `GUIDE_MAPPING_CANDIDATE` | `NO_CHANGE` | could become a governance-facing release/evidence guard note | -| release evidence pack | governance / evidence guide | evidence-pack and conformance framing already exist | `NO_CHANGE` | `NO_CHANGE` | current MPLP evidence model is already sufficient at this level | -| seal / closure record | governance / release record guide | governance records already support closure/seal record patterns | `GUIDE_MAPPING_CANDIDATE` | `NO_CHANGE` | a guide note may help, but schema change is unwarranted | -| disclosed gaps | governance / conformance note | bounded not-certified posture and evidence posture exist | `GUIDE_MAPPING_CANDIDATE` | `NO_CHANGE` | may later become disclosed-gap governance guidance | -| runtime-private vs projection-safe boundary | protocol/runtime boundary guidance | this boundary already exists clearly in MPLP docs and backlog governance | `NO_CHANGE` | `NO_CHANGE` | no further protocol-core action needed now | -| stop condition / escalation envelope | candidate profile or guide path | backlog already tracks constraint / stop condition / escalation envelope pressure | `PROFILE_CANDIDATE` | `NO_CHANGE` now | if stabilized later, this should begin as profile/backlog work, not schema law | - -## C. Schema Decision - -MPLP schemas/v2: NO_CHANGE - -Reason: - -These patterns are runtime, downstream-projection, or governance patterns. -They are not yet stable enough or protocol-native enough for L1/L2 schema law. -The candidate path is guide, profile, or binding-note first. - -## D. Candidate Backlog Implications - -The following are appropriate future candidate tracks: - -- evidence-posture-to-Trace binding note -- non-executing recommendation / Confirm guide -- runtime-private vs projection-safe guide note -- disclosed-gap governance guide -- release evidence / closure guide -- stop-condition / escalation envelope profile candidate - -## E. Decision - -`MPLP_DOWNSTREAM_EVIDENCE_NOTE_READY_FOR_GUIDE_PROFILE_BACKLOG` - -The current evidence supports guide/profile/binding-note backlog movement only. -It does not support schema change or protocol-law widening. diff --git a/governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md b/governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md deleted file mode 100644 index 2fdf91de2..000000000 --- a/governance/backlog/MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DOWNSTREAM-LIFECYCLE-REVISION-CANDIDATE-NOTE-v0.1" -title: "MPLP Downstream Lifecycle Revision Candidate Note v0.1" -surface_role: canonical ---- - -# MPLP Downstream Lifecycle Revision Candidate Note v0.1 - -## A. Purpose - -Record an anonymous downstream evidence-derived candidate note related to -non-executing lifecycle revision. - -## B. Candidate Theme - -Non-executing lifecycle revision after evidence insufficiency, stale context, -operator clarification, or contract-blocked states. - -## C. Possible MPLP Treatment - -| Candidate area | Possible MPLP treatment | Enters protocol now? | Reason | -| --- | --- | --- | --- | -| Guide candidate | candidate guide note for non-executing lifecycle revision posture | no | current signal is downstream evidence only and remains below protocol-law promotion | -| Profile candidate | profile/backlog candidate for packet-like revision loop framing | no | the observed pattern is not yet stable enough for normative profile treatment | -| Binding consideration | future binding consideration for neutral lifecycle-revision relations | no | current evidence is too early for binding semantics and does not justify protocol law now | -| Evidence vocabulary consideration | candidate note for evidence insufficiency detail and related neutral vocabulary | no | vocabulary pressure can be tracked without widening schema or protocol law | -| Not schema/protocol law | explicit backlog-only holding posture | no | this note records consideration only and does not enter protocol-core law | - -## D. Explicit Non-Decisions - -- no schema change -- no protocol law change -- does not endorse any runtime -- does not endorse any product -- not certified -- no implementation dependency -- no normative status - -## E. Decision - -`MPLP_DOWNSTREAM_LIFECYCLE_REVISION_CANDIDATE_NOTE_RECORDED` diff --git a/governance/backlog/MPLP-DOWNSTREAM-REVIEW-LOOP-EVIDENCE-NO-CHANGE-AND-CANDIDATE-DECISION-v0.1.md b/governance/backlog/MPLP-DOWNSTREAM-REVIEW-LOOP-EVIDENCE-NO-CHANGE-AND-CANDIDATE-DECISION-v0.1.md deleted file mode 100644 index aacd4330e..000000000 --- a/governance/backlog/MPLP-DOWNSTREAM-REVIEW-LOOP-EVIDENCE-NO-CHANGE-AND-CANDIDATE-DECISION-v0.1.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DOWNSTREAM-REVIEW-LOOP-EVIDENCE-NO-CHANGE-AND-CANDIDATE-DECISION-v0.1" -title: "MPLP Downstream Review Loop Evidence No-Change And Candidate Decision v0.1" -surface_role: canonical ---- - -# MPLP Downstream Review Loop Evidence No-Change And Candidate Decision v0.1 - -## A. Document Control - -- task_id: TRI-REPO-ARCHITECTURE-DRIFT-CORRECTION-PLAN-01 -- status: non-normative no-change / candidate backlog decision -- date: 2026-04-30 -- authority_order: MPLP -> Cognitive_OS -> downstream products -- downstream evidence source: - - SoloCrew V3.0 stable local review loop evidence - - SoloCrew tri-repo architecture drift-origin audit -- path_decision: placed under `governance/backlog/` because this repository's - existing downstream candidate and no-change convention uses backlog and - intake paths rather than `governance/candidates/` -- no_schema_change: true -- no_core_law_change: true -- no_protocol_promotion: true - -## B. Decision Summary - -The downstream review-loop evidence does not justify MPLP schema change, -protocol-core law change, invariant change, profile adoption, package change, or -runtime endorsement. - -The proper decision is no-change for protocol core, with candidate backlog -tracking for guide/profile/binding-note questions that may become useful only -after more neutral evidence. - -## C. Explicit Non-Normative Status - -This record is: - -- non-normative governance; -- no schema change; -- no protocol law change; -- no new MPLP object; -- no runtime endorsement; -- no product endorsement; -- no implementation dependency; -- no certification claim; -- no endorsement claim. - -Downstream product terms are evidence labels only. They are not MPLP canonical -terms and must not be promoted into schema, invariant, profile, package, or -protocol law by this record. - -## D. Candidate / Backlog Areas - -| Candidate area | Current decision | Candidate path | -| --- | --- | --- | -| runtime-private vs projection-safe evidence guidance | no schema change | future guide note candidate | -| review-only non-executing loop posture | no schema change | Confirm / lifecycle guide candidate | -| deterministic history/export evidence posture | no schema change | Trace / evidence binding-note candidate | -| Trace / Confirm guide note | no schema change | guide candidate after more evidence | -| runtime glue guide candidate | no schema change | L3 runtime-glue guidance candidate | - -## E. Boundary Rules - -- No SoloCrew product semantics become MPLP canonical terms. -- No founder, paid pilot, commercial readiness, or case-study conversion - semantics enter MPLP canonical vocabulary. -- No downstream release identity becomes a protocol version or profile identity. -- No implementation fixture becomes a Golden Flow or protocol invariant. -- No review-loop runtime substrate becomes an MPLP object by downstream usage. -- Any future promotion requires separate evidence, MPGC review, and explicit - governance action. - -## F. Relation To Existing Backlog Records - -This decision aligns with existing backlog posture: - -- `governance/backlog/MPLP-DOWNSTREAM-EVIDENCE-LIFECYCLE-GOVERNANCE-CANDIDATE-NOTE-v0.1.md` - already classifies projection-safe state exposure, runtime glue, evidence - posture, release evidence, and runtime-private vs projection-safe boundary - topics as no-change / candidate material. -- `governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md` - already holds evidence vocabulary and non-executing posture questions as - binding-consideration material without schema change. - -This record narrows the downstream review-loop evidence into that same -candidate-only posture. - -## G. Final Decision - -`MPLP_DOWNSTREAM_REVIEW_LOOP_EVIDENCE_NO_SCHEMA_CHANGE_CANDIDATE_BACKLOG_RECORDED` - -This decision records no schema change, no spec change, no core law change, no -certification claim, no endorsement claim, and no downstream product-semantic -promotion. diff --git a/governance/backlog/MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md b/governance/backlog/MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md deleted file mode 100644 index 22321edd1..000000000 --- a/governance/backlog/MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1" -title: "MPLP Guide Candidate Lifecycle Governance v0.1" -surface_role: canonical ---- - -# MPLP Guide Candidate Lifecycle Governance v0.1 - -## A. Purpose - -Hold non-normative future guide candidate material related to lifecycle -governance patterns derived from anonymous downstream evidence. - -## B. Candidate Scope - -Guide candidate for explaining non-executing lifecycle revision, evidence -insufficiency handling, stale context handling, and operator clarification -boundaries. - -## C. Potential Guide Topics - -| Topic | Why it may belong in a guide | Current status | Non-decisions | -| --- | --- | --- | --- | -| non-executing lifecycle revision | needs explanatory boundary language more than schema change | `guide_candidate_holding` | no schema change; no protocol law change; no normative guide publication in this wave; no runtime endorsement; no product endorsement; no certification claim | -| evidence insufficiency explanation | likely benefits from explanatory examples and boundary language | `guide_candidate_holding` | no schema change; no protocol law change; no normative guide publication in this wave; no runtime endorsement; no product endorsement; no certification claim | -| stale context handling | needs readable posture guidance before any formal abstraction work | `guide_candidate_holding` | no schema change; no protocol law change; no normative guide publication in this wave; no runtime endorsement; no product endorsement; no certification claim | -| operator clarification before revision | likely belongs in a guide because it is posture and interpretation heavy | `guide_candidate_holding` | no schema change; no protocol law change; no normative guide publication in this wave; no runtime endorsement; no product endorsement; no certification claim | -| contract-blocked lifecycle posture | may need boundary-focused explanation rather than schema-level treatment | `guide_candidate_holding` | no schema change; no protocol law change; no normative guide publication in this wave; no runtime endorsement; no product endorsement; no certification claim | -| distinction between revision / approval / execution | requires explicit boundary wording to avoid semantic drift | `guide_candidate_holding` | no schema change; no protocol law change; no normative guide publication in this wave; no runtime endorsement; no product endorsement; no certification claim | - -## D. Non-Decisions - -- no schema change -- no protocol law change -- no normative guide publication in this wave -- no runtime endorsement -- no product endorsement -- no certification claim - -## E. Decision - -`MPLP_GUIDE_CANDIDATE_LIFECYCLE_GOVERNANCE_HOLDING_READY` diff --git a/governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md b/governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md deleted file mode 100644 index 568be51ed..000000000 --- a/governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1" -title: "MPLP Non-Executing Lifecycle Revision Candidate Review v0.1" -surface_role: canonical ---- - -# MPLP Non-Executing Lifecycle Revision Candidate Review v0.1 - -## A. Purpose - -Review the non-executing lifecycle revision candidate as anonymous downstream -evidence-derived backlog item. - -## B. Candidate Scope - -Non-executing lifecycle revision after evidence insufficiency, stale context, -operator clarification, or contract-blocked states. - -## C. Candidate Fit - -| Fit dimension | Assessment | Notes | -| --- | --- | --- | -| lifecycle relevance | `medium_high` | the candidate clearly concerns bounded lifecycle revision posture rather than raw task or content payload alone | -| evidence relevance | `high` | the candidate is strongly driven by evidence insufficiency, stale context, and clarification posture | -| Confirm / Trace / Plan / Context relationship | `partial_fit` | closest fit is Confirm-adjacent review posture and Trace-adjacent evidence vocabulary; Plan and Context remain surrounding surfaces rather than a direct envelope home | -| guide candidate potential | `medium` | explanatory disclosure and review-posture guidance could later emerge as a guide candidate | -| profile candidate potential | `medium` | if repeated across more downstream evidence, the lifecycle-revision posture family could become a future profile consideration | -| binding consideration potential | `medium_high` | the strongest short-term fit is vocabulary and relation binding around evidence insufficiency, clarification, and revision posture | -| schema impact | `no_change` | current evidence does not justify schema discussion | -| protocol law impact | `no_change` | the candidate remains non-normative and below protocol-law promotion | - -## D. Recommended Disposition - -Retain this candidate in backlog form and mark it as a future guide/profile/ -binding consideration candidate, with the strongest near-term fit currently in -binding consideration around evidence vocabulary and relation wording. - -## E. Explicit Non-Decisions - -- no schema change -- no protocol law change -- no normative status -- no runtime endorsement -- no product endorsement -- no implementation dependency -- no certification claim - -## F. Decision - -`MPLP_NON_EXECUTING_LIFECYCLE_REVISION_CANDIDATE_REVIEW_READY` diff --git a/governance/backlog/MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md b/governance/backlog/MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md deleted file mode 100644 index ea4776451..000000000 --- a/governance/backlog/MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1" -title: "MPLP Profile Candidate Stop Escalation Posture v0.1" -surface_role: canonical ---- - -# MPLP Profile Candidate Stop Escalation Posture v0.1 - -## A. Purpose - -Hold non-normative future profile candidate material related to stop / -escalation / revision postures. - -## B. Candidate Scope - -Profile candidate for systems that need to distinguish non-executing revision, -stop, clarification, and escalation posture without crossing into execution or -approval semantics. - -## C. Candidate Profile Questions - -| Question | Why it matters | Current posture | -| --- | --- | --- | -| when should evidence insufficiency stop execution? | clarifies whether non-executing posture should override action continuation | `profile_candidate_holding` | -| when should stale context trigger revision rather than execution? | distinguishes revision posture from stale-but-ignored continuation | `profile_candidate_holding` | -| when should operator clarification be required? | identifies when clarification posture should become explicit before any next step | `profile_candidate_holding` | -| how should contract-blocked state be represented? | helps separate blocked posture from approval, rejection, or execution claims | `profile_candidate_holding` | -| how should non-executing posture be audited? | preserves explainability and evidence-bearing boundary review without normative promotion | `profile_candidate_holding` | - -## D. Non-Decisions - -- no profile definition now -- no normative profile -- no schema/protocol law change -- no runtime/product endorsement -- no certification claim - -## E. Decision - -`MPLP_PROFILE_CANDIDATE_STOP_ESCALATION_POSTURE_HOLDING_READY` diff --git a/governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md b/governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md deleted file mode 100644 index ba9b50ba5..000000000 --- a/governance/backlog/MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-v0.4-DOWNSTREAM-CANDIDATE-CLOSURE-MATRIX-v0.1" -title: "MPLP v0.4 Downstream Candidate Closure Matrix v0.1" -surface_role: canonical ---- - -# MPLP v0.4 Downstream Candidate Closure Matrix v0.1 - -> **Non-Normative Downstream Closure Matrix Only** -> -> This document closes the current downstream candidate line conceptually. -> It does **not** amend `schemas/v2/`, invariants, package surfaces, SDKs, or -> any other frozen MPLP core truth. - -## 1. Purpose - -This matrix records how the currently closed downstream line relates to MPLP -after: - -- downstream product `v0.1` through `v0.4` -- downstream runtime substrate `v0.4` runtime-private workforce line -- the bounded downstream product <-> downstream runtime substrate integration - gate - -Its job is narrow: - -- keep current downstream abstractions classified honestly -- prevent current product/runtime usage from being over-read as protocol law -- state what future promotion would require if discussion ever reopens - -## 2. Closure Buckets - -This closure matrix uses three buckets: - -- `candidate_only` -- `not_protocol_fit_at_this_time` -- `explicitly_out_of_mplp_scope` - -Where earlier backlog documents used finer candidate labels such as -`candidate_but_not_ready`, that earlier label remains true. In this closure -matrix it simply stays inside the broader `candidate_only` bucket. - -## 3. Current Closure Matrix - -| Abstraction | Current Downstream Pressure Source | Current Maturity | Existing Backlog Status | Closure Bucket | Why It Sits Here Now | Future Promotion Would Require | -| --- | --- | --- | --- | --- | --- | --- | -| `Delegation Envelope` | downstream product bounded operator/product pressure and downstream runtime substrate bounded runtime-pressure around handoff/delegation-like concerns | Early conceptual pressure only | `candidate_only` | `candidate_only` | Still plausible as a future protocol candidate, but no stable neutral kernel or repeated cross-runtime evidence exists yet | repeated pressure beyond one downstream line; stable vendor-neutral envelope meaning; explicit non-overlap with frozen MPLP core; schema-shape stability | -| `Delivery / Acceptance Contract Envelope` | downstream product delivery/review/acceptance framing and downstream runtime substrate delivery-return-like runtime-private pressure | Early and still close to business-operating wording | `candidate_but_not_ready` | `candidate_only` | Still worth tracking as a possible abstraction family, but current downstream material remains too realization-sensitive for protocol promotion | proof that delivery/acceptance semantics remain meaningful outside one product language; multiple independent implementations; stable neutral envelope shape | -| `Constraint / Stop Condition / Escalation Envelope` | downstream product bounded review/escalation pressure and downstream runtime substrate approval/constraint-like runtime-private pressure | Early-to-mid conceptual pressure | `candidate_but_not_ready` | `candidate_only` | This is the strongest candidate family conceptually, but it still overlaps too much with runtime policy and product decision handling to become protocol law now | repeated validation across independent runtimes; vendor-neutral posture semantics; stable schema candidate; proof that current MPLP modules cannot already host the need | -| `Multi Cell` / `Cell` semantics | downstream product multi-cell foundation line and downstream runtime substrate cell-scope runtime-private preconditions | Real downstream usage, but product/runtime-specific | Not in MPLP backlog scope | `explicitly_out_of_mplp_scope` | These are product/runtime family semantics, not current MPLP protocol abstractions | a separate future argument would first need to show that any portable neutral kernel exists apart from product/runtime ownership; no such case exists now | -| `Collection` / role-specific workflow semantics | Future-facing downstream product planning only | Not protocol-shaped today | Not in MPLP backlog scope | `explicitly_out_of_mplp_scope` | These are explicitly product operating-model semantics and must not be re-read as protocol law | not applicable at this time; these concepts remain outside MPLP scope unless their meaning changes radically | -| runtime-private management-object-family semantics (`management-directive-record`, `delivery-return-record`, `approval-request-record`) | downstream runtime substrate runtime-private workforce line, consumed in bounded downstream form by a downstream product | Landed and machine-readable, but intentionally runtime-private and still partial/asymmetric as a family | Not in MPLP backlog scope as object law | `not_protocol_fit_at_this_time` | The current objects are concrete runtime-private records, not neutral MPLP envelopes; the abstract pressure they create is already tracked separately in candidate families above | strong proof that a narrower vendor-neutral envelope exists apart from these concrete runtime-private objects; cross-implementation evidence; non-product, non-runtime-private semantics | - -## 4. Net Classification Result - -The correct current MPLP reading is: - -- three abstraction families remain `candidate_only` -- current multi-cell, cell, collection, and role-specific workflow semantics remain - `explicitly_out_of_mplp_scope` -- the concrete runtime-private management-object family is - `not_protocol_fit_at_this_time` - -## 5. Closure Consequence - -No current downstream abstraction becomes MPLP law merely because: - -- the downstream product line now has multiple bounded `v0.4` surfaces -- the downstream runtime substrate now has machine-readable runtime-private - workforce records -- the current downstream product <-> downstream runtime substrate integration - gate passed - -The present closure result is therefore: - -- keep candidate families visible -- keep non-fit material out of protocol law -- keep product/runtime semantics explicitly non-promoted -- leave frozen MPLP core untouched diff --git a/governance/candidates/MPGC-CANDIDATE-BACKLOG-v0.1.md b/governance/candidates/MPGC-CANDIDATE-BACKLOG-v0.1.md deleted file mode 100644 index 7c8502941..000000000 --- a/governance/candidates/MPGC-CANDIDATE-BACKLOG-v0.1.md +++ /dev/null @@ -1,351 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPGC-CANDIDATE-BACKLOG-v0.1" -title: "MPGC Candidate Backlog v0.1" -surface_role: candidate_backlog ---- - -# MPGC Candidate Backlog v0.1 - -> **Non-Normative Candidate Backlog Only** -> -> This document records candidate pressure from downstream implementation -> evidence. It does not amend MPLP schemas, specifications, module semantics, -> core protocol law, package surfaces, profiles, bindings, or validation -> claims. - -## 1. Document Control - -- doc_id: MPGC-CANDIDATE-BACKLOG-v0.1 -- task_id: TRI-REPO-MPLP-CANDIDATE-BACKLOG-REGISTRATION-WAVE-01 -- status: non-normative candidate backlog -- date: 2026-05-05 -- authority_order: MPLP -> Cognitive_OS -> SoloCrew -- source_rebaseline_ref: SoloCrew commit 5b238ca26d2912b2a7fbf239065d6ea9932d95ea -- cgos_current_line_ref: f9f22b0f742740d8fcc3a0ad05ef56dee0a8cc0a -- mplp_repo_head_start: 2b89ee839fbf54c1fb282bca93ae1fc080aa1772 -- no_schema_change: true -- no_core_law_change: true -- no_normative_promotion: true -- no_conformance_claim: true -- no_certification_or_endorsement: true -- no_cognitive_os_canonicalization: true -- no_solocrew_product_semantics: true - -## 2. Executive Summary - -This backlog is registered because the current tri-repo line produced repeated -downstream evidence patterns across SoloCrew product pressure and Cognitive_OS -neutral runtime/public surfaces. The rebaseline at SoloCrew -`5b238ca26d2912b2a7fbf239065d6ea9932d95ea` identified candidate handling as the -remaining process gap after finding low implementation pollution and no -protocol boundary violation. - -No MPLP normative change occurs now because the evidence comes from one -downstream app line and one implementation-layer runtime package surface. That -is enough to track candidate pressure, but not enough to change schemas, core -law, module semantics, profiles, bindings, or protocol validation posture. - -This registration restores the agreed flow: SoloCrew product demand generated -implementation pressure, Cognitive_OS mapped that pressure into neutral -projection/evidence surfaces, and MPLP now records candidate-only backlog items -for later governance instead of absorbing downstream vocabulary or runtime -implementation details. - -## 3. Candidate Admission Rules - -- A candidate must come from repeated downstream evidence, not one isolated - convenience request. -- A candidate must not encode product-specific semantics as protocol - vocabulary. -- A candidate must not encode Cognitive_OS implementation law, package maps, - DTO field names, or runtime internals as MPLP law. -- A candidate must be versioned and non-normative while it is in backlog. -- A candidate requires future MPGC review before any protocol change can occur. -- A candidate may become guide, profile, or binding candidate material later, - but this backlog does not advance it automatically. - -## 4. Candidate Registry Table - -| Candidate ID | Type | Source | Related modules | Related runtime concepts | Summary | Current decision | -| --- | --- | --- | --- | --- | --- | --- | -| `MPGC-CANDIDATE-EVIDENCE-OMISSION-BOUNDARY-FLAGS-01` | `MPLP_BINDING_CANDIDATE` | CGOS first/second/third-wave DTO patterns | Trace, Confirm, Core, Context | Observability, Runtime Glue, Learning Feedback | repeated use of `safe_evidence_refs`, `omission_markers`, `runtime_private_fields_omitted`, and `boundary_flags` | non-normative backlog only | -| `MPGC-CANDIDATE-RUNTIME-SESSION-EVIDENCE-01` | `MPGC_BACKLOG_CANDIDATE` | SoloCrew bridge blocker and CGOS third-wave runtime-session DTOs | Context, Trace, Core | Runtime Glue, VSL, PSG, Observability | runtime session posture/evidence without constructor or runtime-private exposure | non-normative backlog only | -| `MPGC-CANDIDATE-WORKER-LIFECYCLE-EVIDENCE-01` | `MPGC_BACKLOG_CANDIDATE` | SoloCrew bridge blocker and CGOS third-wave worker-lifecycle DTOs | Role, Collab, Trace, Core | Runtime Glue, Observability | worker lifecycle observation/evidence without lifecycle runtime authority | non-normative backlog only | -| `MPGC-CANDIDATE-DOWNSTREAM-RUNTIME-BRIDGE-MIGRATION-01` | `NON_NORMATIVE_GUIDE_CANDIDATE` | SoloCrew legacy CGOS relative bridge debt and package-subpath migration chain | Core, Extension, Network, Trace | Runtime Glue, Observability | guidance candidate for migrating downstream apps from runtime internals to projection/evidence-safe package surfaces | non-normative backlog only | -| `MPGC-CANDIDATE-PROJECTION-SAFE-PACKAGE-SURFACE-01` | `NON_NORMATIVE_GUIDE_CANDIDATE` | CGOS private package export chain and SoloCrew import spikes | Core, Extension, Network | Runtime Glue | optional guide candidate for package/export surface hygiene, explicitly not protocol package law | non-normative backlog only | -| `MPGC-CANDIDATE-ACTION-DISPATCH-BOUNDARY-EVIDENCE-01` | `PROFILE_CANDIDATE` | CGOS runtime-action-request and dispatch-boundary evidence DTOs | Plan, Confirm, Trace, Extension, Network | AEL, Runtime Glue, Observability | evidence pattern for action request and dispatch denial without provider, channel, or tool authority | non-normative backlog only | -| `MPGC-CANDIDATE-LEARNING-CORRECTION-EVIDENCE-01` | `MPGC_BACKLOG_CANDIDATE` | CGOS learning-correction evidence DTO and SoloCrew correction/learning needs | Context, Plan, Trace | Learning Feedback, Observability | learning/correction capture evidence without training authority or mutation writeback | non-normative backlog only | - -## 5. Candidate Detail Sections - -### 5.1 MPGC-CANDIDATE-EVIDENCE-OMISSION-BOUNDARY-FLAGS-01 - -- candidate_id: MPGC-CANDIDATE-EVIDENCE-OMISSION-BOUNDARY-FLAGS-01 -- title: Evidence, omission marker, and boundary flag candidate -- type: MPLP_BINDING_CANDIDATE -- source evidence: CGOS first-wave, second-wave, and third-wave DTO patterns. -- downstream product origin: downstream needs for reviewable operating-loop - evidence, persistence continuity, learning/correction capture, action - review, runtime session continuity, and worker lifecycle visibility. -- Cognitive_OS implementation evidence: repeated DTO field families for - `safe_evidence_refs`, `omission_markers`, - `runtime_private_fields_omitted`, and explicit no-authority - `boundary_flags`. -- related MPLP modules: Trace, Confirm, Core, Context. -- related runtime concepts: Observability, Runtime Glue, Learning Feedback. -- problem statement: downstream implementations repeatedly need a way to expose - evidence posture and omitted private payload posture without creating runtime - authority or normative protocol fields. -- why candidate-only now: the current evidence is implementation-layer and has - not been validated across independent downstream runtimes. -- why no schema/core-law change now: the repeated field families are DTO - implementation evidence, not accepted MPLP object families. -- explicit non-goals: no standard field names, no required DTO shape, no - runtime-private payload access, no execution authority, and no mutation - authority. -- forbidden claims: no conformance claim, no certification claim, no - endorsement claim, no protocol acceptance claim, and no implementation - canonicalization claim. -- future governance path: collect cross-downstream evidence, compare with - existing Trace and Confirm semantics, and decide in a separate owner-approved - wave whether this remains backlog-only or becomes binding-consideration - material. - -### 5.2 MPGC-CANDIDATE-RUNTIME-SESSION-EVIDENCE-01 - -- candidate_id: MPGC-CANDIDATE-RUNTIME-SESSION-EVIDENCE-01 -- title: Runtime session evidence posture candidate -- type: MPGC_BACKLOG_CANDIDATE -- source evidence: SoloCrew bridge blocker analysis and CGOS third-wave - runtime-session summary/evidence DTOs. -- downstream product origin: downstream runtime continuity and internal - dependency cleanup needs. -- Cognitive_OS implementation evidence: non-executing runtime-session summary - and evidence surfaces that omit constructors, service instances, mutable - state, provider dispatch, channel dispatch, tool invocation, storage writes, - and mutation writeback. -- related MPLP modules: Context, Trace, Core. -- related runtime concepts: Runtime Glue, VSL, PSG, Observability. -- problem statement: downstream apps may need session posture evidence without - exposing live runtime handles or creating session lifecycle authority. -- why candidate-only now: runtime session posture remains implementation-layer - and may vary by runtime. -- why no schema/core-law change now: a single downstream app plus one runtime - implementation line is not enough evidence for protocol semantics. -- explicit non-goals: no session object model, no constructor exposure, no live - handle exposure, no package-surface requirement, and no lifecycle authority. -- forbidden claims: no conformance claim, no certification claim, no - endorsement claim, no official implementation claim, and no protocol - promotion claim. -- future governance path: reassess after downstream third-wave import evidence - and after additional runtime implementations show whether a neutral session - evidence posture recurs. - -### 5.3 MPGC-CANDIDATE-WORKER-LIFECYCLE-EVIDENCE-01 - -- candidate_id: MPGC-CANDIDATE-WORKER-LIFECYCLE-EVIDENCE-01 -- title: Worker lifecycle observation evidence candidate -- type: MPGC_BACKLOG_CANDIDATE -- source evidence: SoloCrew bridge blocker analysis and CGOS third-wave - worker-lifecycle summary/evidence DTOs. -- downstream product origin: downstream needs for worker lifecycle visibility - and internal dependency cleanup. -- Cognitive_OS implementation evidence: non-executing worker-lifecycle summary - and evidence surfaces that deny lifecycle transition authority, mutable worker - record exposure, service instance exposure, storage writes, mutation - writeback, and training authority. -- related MPLP modules: Role, Collab, Trace, Core. -- related runtime concepts: Runtime Glue, Observability. -- problem statement: downstream consumers may need worker lifecycle observation - without gaining authority to change worker state or call lifecycle methods. -- why candidate-only now: worker lifecycle posture is close to runtime - implementation behavior and must not become protocol law by convenience. -- why no schema/core-law change now: existing evidence is not yet - cross-implementation proof of a stable MPLP abstraction. -- explicit non-goals: no worker runtime class, no worker store, no lifecycle - transition method, no mutable record, and no revision mutation surface. -- forbidden claims: no conformance claim, no certification claim, no - endorsement claim, no official implementation claim, and no protocol - promotion claim. -- future governance path: keep backlog-held until multiple downstream consumers - demonstrate neutral lifecycle observation needs separate from runtime control. - -### 5.4 MPGC-CANDIDATE-DOWNSTREAM-RUNTIME-BRIDGE-MIGRATION-01 - -- candidate_id: MPGC-CANDIDATE-DOWNSTREAM-RUNTIME-BRIDGE-MIGRATION-01 -- title: Downstream runtime bridge migration governance candidate -- type: NON_NORMATIVE_GUIDE_CANDIDATE -- source evidence: SoloCrew legacy CGOS relative bridge debt, Cognitive_OS - package-subpath export sequence, and downstream import spike evidence. -- downstream product origin: downstream dependency cleanup need for replacing - fragile runtime-internal imports with projection/evidence-safe public package - surfaces. -- Cognitive_OS implementation evidence: private package exports for - runtime/public projection/evidence surfaces across operator review, first - wave, second wave, and third wave surfaces. -- related MPLP modules: Core, Extension, Network, Trace. -- related runtime concepts: Runtime Glue, Observability. -- problem statement: downstream applications may need governance guidance for - moving away from runtime internals without treating that migration as MPLP - law. -- why candidate-only now: bridge migration is downstream implementation - sequencing, not protocol semantics. -- why no schema/core-law change now: no MPLP schema can decide local package - import ownership, application bridge shape, or runtime dependency strategy. -- explicit non-goals: no package manager rule, no dependency publication rule, - no bridge replacement claim, no downstream migration claim, and no runtime - implementation mandate. -- forbidden claims: no official dependency claim, no conformance claim, no - certification claim, no endorsement claim, and no implementation - canonicalization claim. -- future governance path: gather more downstream migration evidence and decide - whether a non-normative guide note is useful without changing protocol - semantics. - -### 5.5 MPGC-CANDIDATE-PROJECTION-SAFE-PACKAGE-SURFACE-01 - -- candidate_id: MPGC-CANDIDATE-PROJECTION-SAFE-PACKAGE-SURFACE-01 -- title: Projection-safe package surface guidance candidate -- type: NON_NORMATIVE_GUIDE_CANDIDATE -- source evidence: CGOS private package export chain and SoloCrew package - import spikes. -- downstream product origin: downstream need to consume safe public surfaces - instead of runtime internals. -- Cognitive_OS implementation evidence: private package map entries for - runtime/public DTO, evidence, and handoff surfaces that avoid runtime-private - imports and authority-bearing exports. -- related MPLP modules: Core, Extension, Network. -- related runtime concepts: Runtime Glue. -- problem statement: implementation ecosystems may benefit from guidance that - package surfaces should expose projection/evidence-safe objects rather than - runtime internals, while keeping package mechanics outside protocol law. -- why candidate-only now: package export hygiene is repository and ecosystem - practice, not a protocol object or module duty. -- why no schema/core-law change now: package subpaths do not define MPLP - semantics, invariants, or validation requirements. -- explicit non-goals: no MPLP package export law, no package publication, no - official dependency posture, no runtime package mandate, and no profile - creation. -- forbidden claims: no official dependency claim, no conformance claim, no - certification claim, no endorsement claim, and no protocol promotion claim. -- future governance path: keep as optional guide-candidate material only if - multiple downstream implementation lines independently repeat the pattern. - -### 5.6 MPGC-CANDIDATE-ACTION-DISPATCH-BOUNDARY-EVIDENCE-01 - -- candidate_id: MPGC-CANDIDATE-ACTION-DISPATCH-BOUNDARY-EVIDENCE-01 -- title: Action request and dispatch boundary evidence candidate -- type: PROFILE_CANDIDATE -- source evidence: CGOS runtime-action-request summary DTO and runtime-dispatch - boundary evidence DTO. -- downstream product origin: downstream task/action review and operator review - needs. -- Cognitive_OS implementation evidence: action request and dispatch boundary - evidence surfaces that express blocked or deferred dispatch posture without - provider, channel, or tool invocation authority. -- related MPLP modules: Plan, Confirm, Trace, Extension, Network. -- related runtime concepts: AEL, Runtime Glue, Observability. -- problem statement: downstream systems may need portable evidence around - action requests and dispatch denial without granting execution or integration - authority. -- why candidate-only now: the current shape is derived from one implementation - layer and should not become a profile without additional governance. -- why no schema/core-law change now: no accepted cross-runtime action-dispatch - evidence profile exists in this wave. -- explicit non-goals: no provider dispatch, no channel dispatch, no tool - invocation, no execution authority, no integration binding, and no profile - creation in this task. -- forbidden claims: no conformance claim, no certification claim, no - endorsement claim, no official implementation claim, and no profile acceptance - claim. -- future governance path: compare with existing Plan, Confirm, Trace, - Extension, and Network semantics before any separate profile-candidate - advancement. - -### 5.7 MPGC-CANDIDATE-LEARNING-CORRECTION-EVIDENCE-01 - -- candidate_id: MPGC-CANDIDATE-LEARNING-CORRECTION-EVIDENCE-01 -- title: Learning correction evidence candidate -- type: MPGC_BACKLOG_CANDIDATE -- source evidence: CGOS learning-correction evidence DTO and SoloCrew - correction/learning needs. -- downstream product origin: downstream needs for bounded correction capture - and user-preference continuity. -- Cognitive_OS implementation evidence: learning-correction evidence surface - that records correction posture without training authority, storage write - authority, or mutation writeback authority. -- related MPLP modules: Context, Plan, Trace. -- related runtime concepts: Learning Feedback, Observability. -- problem statement: downstream systems may need a repeatable way to record - correction evidence while denying automatic training or mutable state effects. -- why candidate-only now: learning feedback semantics are sensitive and need - broader evidence before any protocol-level consideration. -- why no schema/core-law change now: the current evidence remains DTO-level and - implementation-layer only. -- explicit non-goals: no training authority, no mutation writeback, no memory - store law, no user-profile protocol object, and no automatic learning - semantics. -- forbidden claims: no conformance claim, no certification claim, no - endorsement claim, no official implementation claim, and no protocol - promotion claim. -- future governance path: gather additional downstream correction evidence and - compare it against Context, Plan, and Trace before any future MPGC review. - -## 6. Non-Goals - -- no MPLP schema change -- no MPLP core law change -- no normative promotion -- no profile creation in this task -- no binding implementation in this task -- no conformance, certification, or endorsement claim -- no Cognitive_OS canonicalization -- no SoloCrew product vocabulary in protocol -- no package publication or official dependency claim - -## 7. Relationship to SoloCrew - -SoloCrew provided downstream evidence through product/runtime needs, bridge debt, -and import-spike pressure. SoloCrew remains the product and application layer. -Its product semantics do not enter MPLP vocabulary through this backlog. - -Bridge replacement remains SoloCrew and Cognitive_OS implementation work. It is -not MPLP law, not a protocol duty, and not advanced by this document. - -## 8. Relationship to Cognitive_OS - -Cognitive_OS provided implementation evidence through neutral runtime/public DTO, -evidence, bundle, and private package export surfaces. Cognitive_OS remains a -non-binding downstream runtime implementation for purposes of this backlog. - -Cognitive_OS package exports are not MPLP exports. Cognitive_OS DTOs are not MPLP -schemas, profiles, bindings, or core protocol objects. - -## 9. Future MPGC Governance Path - -Future MPGC handling should: - -- collect more downstream evidence before considering advancement -- compare these patterns against other future downstream apps and runtime - implementations -- decide separately whether any item should become guide, profile, or binding - candidate material -- require separate owner authorization for any normative change -- preserve MPLP v1 stability unless a later authorized governance wave proves a - stronger need - -## 10. Decision - -`MPGC_CANDIDATE_BACKLOG_REGISTERED_NON_NORMATIVE_NO_PROTOCOL_CHANGE` - -## 11. Next Allowed Task - -`CGOS-THIRD-WAVE-RUNTIME-SESSION-WORKER-LIFECYCLE-PACKAGE-EXPORT-VERIFICATION-AND-DOWNSTREAM-READINESS-WAVE-01` - -The owner may also pause development. diff --git a/governance/codex-goals/CODEX-GOAL-TEMPLATE.md b/governance/codex-goals/CODEX-GOAL-TEMPLATE.md deleted file mode 100644 index 86bf864c3..000000000 --- a/governance/codex-goals/CODEX-GOAL-TEMPLATE.md +++ /dev/null @@ -1,151 +0,0 @@ -# Codex Goal Template - -Use this template for bounded Goal Mode tasks in this repository family. If `/goal` is not available in the current IDE surface, simulate Goal Mode by copying this template into the task prompt and keeping the same stopping condition, forbidden actions, and owner approval boundary. - -## Goal - -State the concrete objective and the verifiable stopping condition. - -## Repository - -Name the exact repository path and current branch. Do not assume cloud threads, marketplace features, app-only visibility, or cloud-only execution. - -## Branch - -Create or use a task branch from current `main` unless the owner instructs otherwise. Report whether the branch continues an existing Codex ops branch or is a follow-up branch. - -## PR Topology - -State the PR URL, base branch, base SHA, head branch, head SHA, whether the base is the default branch, and whether the PR is stacked. Stacked PRs must be declared. A final PR to `main` is required before merge unless the owner explicitly approves a stacked merge sequence. - -## Required Skills - -List any required `.agents/skills/*/SKILL.md` workflows. `.agents/skills` is the Codex discovery path; `.codex/skills` is retained as the project-internal ops source and compatibility copy. - -## Required Subagents Or Custom Agents - -List any required `.codex/agents/*.toml` reviewers and the lane each must cover. Standard lanes: - -- `package_surface_auditor` -- `release_governance_reviewer` -- `protocol_schema_reviewer` -- `product_boundary_reviewer` -- `runtime_binding_reviewer` -- `publication_claim_reviewer` - -Default lane policy: use no subagent for trivial docs typos, one subagent for isolated repo-specific review, and multiple subagents for release, schema, runtime, publication, or cross-repo tasks. Subagents return P0/P1/P2 findings to the parent. - -Prompt pattern: - -```text -Spawn one subagent per relevant review lane, wait for all results, then consolidate findings into a single parent report. Do not let subagents perform release mutation, version bump, schema intake, public-claim changes, or merge actions. -``` - -Subagents run review lanes only unless the task explicitly authorizes edits. They inherit sandbox and approval boundaries, must not publish, upload, tag, seal, bump versions, mutate registries, intake schema primitives, merge PRs, or change public claims, and must classify findings as P0/P1/P2 with files inspected and commands run. - -## Plan Mode Or Simulated Plan Mode - -For medium or high-risk work, write a short plan before edits. Include the intended files, commands, and stopping condition. Update the plan as gates pass or fail. - -## Scope - -Define allowed files, allowed semantics, and explicit non-goals. - -## Out-Of-Scope Surfaces - -List surfaces that must not change, including package versions, registries, tags, release seals, protocol schema primitives, product behavior, runtime behavior, Validation Lab evidence logic, public legal/compliance claims, and merge state. - -## Forbidden Actions - -State forbidden publish, upload, deprecate, yank, delete, dist-tag mutation, tag, seal, package-version, schema-intake, product-behavior, runtime-behavior, public-claim, or broad-rewrite actions. - -## Stopping Condition - -Define the exact evidence that proves the goal is complete. - -## Owner Approval Boundary - -Stop before any action requiring owner approval, including release mutation, registry mutation, public legal/compliance claim changes, schema primitive intake, package version changes, product behavior changes, runtime behavior changes, release seal creation, merge, or tag creation. - -## Merge Boundary - -Merge is forbidden by default. Merge is allowed only for an explicit `FINAL_MERGE` or `PR_FINALIZATION` task that names the PR URL, expected head SHA, passing gates, clean worktree, and owner instruction. - -## Package Release Rule - -External npm/PyPI registry validation is required before no-op closure or version-bump planning. Before publish, regenerate the publish plan, inspect dry-run artifacts, and require an explicit owner approval sentence. Do not mutate registry state from a planning task. - -## Instruction Size Guard - -Run `wc -c AGENTS.md`. Warn above 24000 bytes. Block if critical boundaries may be truncated. - -## Required Commands - -Include repo truth, existing-script inspection, and relevant non-mutating verification commands: - -```bash -git branch --show-current -git status --short -git rev-parse HEAD -git rev-parse --verify origin/main || true -git rev-parse --verify origin/codex/latest-ops-foundation-wave-01 || true -git log --oneline -5 -git diff --check -scripts/codex/repo-truth-first.sh -wc -c AGENTS.md -if [ -d .codex/skills ] && [ -d .agents/skills ]; then diff -qr .codex/skills .agents/skills; fi -``` - -## Final Report Format - -```yaml -completion_report: - task_id: - repository: - branch: - starting_head: - final_local_head: - final_origin_branch_head: - pr_url: - pr_base_branch: - pr_base_sha: - pr_head_branch: - pr_head_sha: - pr_is_stacked: - recommended_merge_topology: - files_changed: - required_skills: - required_subagents: - skill_discovery_resolution: - config_added_or_updated: - custom_agents_added_or_updated: - skills_added_or_updated: - goal_templates_added_or_updated: - scripts_added_or_updated: - commands_run: - pass_fail_results: - skill_mirror_drift_result: - agents_md_byte_size: - forbidden_actions_confirmation: - final_git_status: - remaining_risks: - exact_verdict: -``` - -## Allowed Final Verdicts - -- `_READY_FOR_REMOTE_REVIEW` -- `_NOT_READY_WITH_BLOCKERS` -- `_BLOCKED` - -## Sample Goal Mode Invocation - -```text -/goal Complete until . Stop before publish, upload, deprecate, yank, delete, dist-tag mutation, tag, release seal, version bump, schema primitive intake, product behavior change, runtime behavior change, or public legal/compliance claim change. -``` - -Package release governance example: - -```text -/goal Complete MPLP-PACKAGE-OWNER-APPROVED-VERSION-BUMP-PLANNING-WAVE-01 until a version-bump plan is ready for owner review. Stop before editing versions, publishing, uploading, tagging, deprecating, yanking, deleting, or mutating registry state. -``` diff --git a/governance/gates/MPLP-CANDIDATE-BACKLOG-REVIEW-GATE-v0.1.md b/governance/gates/MPLP-CANDIDATE-BACKLOG-REVIEW-GATE-v0.1.md deleted file mode 100644 index 4f0dcbfcf..000000000 --- a/governance/gates/MPLP-CANDIDATE-BACKLOG-REVIEW-GATE-v0.1.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-BACKLOG-REVIEW-GATE-v0.1" -title: "MPLP Candidate Backlog Review Gate v0.1" -surface_role: canonical ---- - -# MPLP Candidate Backlog Review Gate v0.1 - -## A. Purpose - -Gate the candidate backlog review before any future promotion / consolidation -work. - -## B. Gate Matrix - -| Gate | Requirement | Status | -| --- | --- | --- | -| candidate backlog inventory exists | `governance/audits/MPLP-CANDIDATE-BACKLOG-REVIEW-INVENTORY-v0.1.md` is present | `PASS` | -| disposition matrix exists | `governance/backlog/MPLP-CANDIDATE-DISPOSITION-MATRIX-v0.1.md` is present | `PASS` | -| non-executing lifecycle revision candidate review exists | `governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md` is present | `PASS` | -| consolidation plan exists | `governance/backlog/MPLP-CANDIDATE-BACKLOG-CONSOLIDATION-PLAN-v0.1.md` is present | `PASS` | -| no schema change | review wave remains governance-only | `PASS` | -| no protocol law change | review wave remains below protocol-law promotion | `PASS` | -| no normative promotion | review wave classifies candidates only | `PASS` | -| no runtime endorsement | review wave does not endorse any runtime substrate | `PASS` | -| no product endorsement | review wave does not endorse any downstream product | `PASS` | -| no implementation endorsement | review wave does not endorse any implementation substrate | `PASS` | -| no certification claim | review wave does not make certification-like claims | `PASS` | -| forbidden-term grep scoped to changed files passes | changed-file grep remains limited to negative boundary, gate, or grep-example contexts | `PASS` | -| repo-wide remaining matches are inventory/exception/negative-boundary only | remaining repo-wide matches stay in inventory, exception, negative-boundary, or gate-grep-example contexts | `PASS` | - -## C. Decision - -`MPLP_CANDIDATE_BACKLOG_REVIEW_GATE_PASS` diff --git a/governance/gates/MPLP-CANDIDATE-CONSOLIDATION-GATE-v0.1.md b/governance/gates/MPLP-CANDIDATE-CONSOLIDATION-GATE-v0.1.md deleted file mode 100644 index 9fb6ae93a..000000000 --- a/governance/gates/MPLP-CANDIDATE-CONSOLIDATION-GATE-v0.1.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-CONSOLIDATION-GATE-v0.1" -title: "MPLP Candidate Consolidation Gate v0.1" -surface_role: canonical ---- - -# MPLP Candidate Consolidation Gate v0.1 - -## A. Purpose - -Gate candidate consolidation before any future guide/profile/binding drafting. - -## B. Gate Matrix - -| Gate | Requirement | Status | -| --- | --- | --- | -| canonical candidate backlog index exists | `governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md` is present | `PASS` | -| guide candidate holding note exists | `governance/backlog/MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md` is present | `PASS` | -| profile candidate holding note exists | `governance/backlog/MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md` is present | `PASS` | -| binding consideration holding note exists | `governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md` is present | `PASS` | -| research archive / duplicate closure note exists | `governance/backlog/MPLP-CANDIDATE-RESEARCH-ARCHIVE-AND-DUPLICATE-CLOSURE-v0.1.md` is present | `PASS` | -| no historical files deleted | consolidation wave records relationships only | `PASS` | -| no schema change | consolidation remains governance-only | `PASS` | -| no protocol law change | consolidation remains below protocol-law promotion | `PASS` | -| no normative promotion | candidate organization does not promote any surface into protocol law | `PASS` | -| no runtime endorsement | consolidation does not endorse any runtime substrate | `PASS` | -| no product endorsement | consolidation does not endorse any downstream product | `PASS` | -| no implementation endorsement | consolidation does not endorse any implementation substrate | `PASS` | -| no certification claim | consolidation does not make certification-like claims | `PASS` | -| changed-file grep passes | changed-file grep remains limited to negative boundary, gate, or grep-example contexts | `PASS` | -| repo-wide matches remain inventory/exception/negative-boundary/gate-grep-example only | remaining repo-wide matches stay bounded to already-known allowed contexts | `PASS` | - -## C. Decision - -`MPLP_CANDIDATE_CONSOLIDATION_GATE_PASS` diff --git a/governance/gates/MPLP-DOWNSTREAM-EVIDENCE-ANONYMITY-GATE-v0.1.md b/governance/gates/MPLP-DOWNSTREAM-EVIDENCE-ANONYMITY-GATE-v0.1.md deleted file mode 100644 index 453babfd6..000000000 --- a/governance/gates/MPLP-DOWNSTREAM-EVIDENCE-ANONYMITY-GATE-v0.1.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DOWNSTREAM-EVIDENCE-ANONYMITY-GATE-v0.1" -title: "MPLP Downstream Evidence Anonymity Gate v0.1" -surface_role: canonical ---- - -# MPLP Downstream Evidence Anonymity Gate v0.1 - -## A. Purpose - -Define minimum gate for future downstream-evidence candidate notes. - -## B. Required Rules - -| Gate | Requirement | Status | -| --- | --- | --- | -| downstream evidence must be anonymous | future candidate notes must avoid concrete downstream product or vendor naming | `PASS` | -| no product name in MPLP candidate note | product-specific naming must not appear in candidate/backlog guidance unless explicitly registered as a legacy exception | `PASS` | -| no runtime name in MPLP candidate note | runtime-substrate naming must stay neutral in candidate/backlog guidance | `PASS` | -| no implementation endorsement | candidate notes must not endorse any implementation substrate | `PASS` | -| no product endorsement | candidate notes must not endorse any downstream product | `PASS` | -| no certification claim | candidate notes must not claim certification or certification-like authority | `PASS` | -| no schema change unless explicitly authorized | candidate notes remain governance-only unless a later wave explicitly authorizes schema work | `PASS` | -| no protocol law change unless explicitly authorized | candidate notes remain below normative promotion unless a later wave explicitly authorizes protocol-law work | `PASS` | -| candidate must state non-normative/backlog/guide/profile/binding consideration status | every future note must explicitly identify its non-normative holding posture | `PASS` | -| candidate must include explicit non-decisions | every future note must state no schema change, no protocol law change, and no silent promotion | `PASS` | - -## C. Recommended Grep - -`rg -n "SoloCrew|Coregentis Runtime|Cognitive_OS|founder|Secretary|portfolio|runtime endorsement|product endorsement|implementation endorsement|certification" governance/backlog governance/gates governance/audits` - -## D. Decision - -`MPLP_DOWNSTREAM_EVIDENCE_ANONYMITY_GATE_READY` diff --git a/governance/gates/MPLP-MPGC-CANDIDATE-INTAKE-GATE-v0.1.md b/governance/gates/MPLP-MPGC-CANDIDATE-INTAKE-GATE-v0.1.md deleted file mode 100644 index db2347944..000000000 --- a/governance/gates/MPLP-MPGC-CANDIDATE-INTAKE-GATE-v0.1.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-INTAKE-GATE-v0.1" -title: "MPLP MPGC Candidate Intake Gate v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Intake Gate v0.1 - -| Gate | Requirement | Status | -| --- | --- | --- | -| intake index exists | `governance/mpgc-intake/MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md` is present | `PASS` | -| three intake dossiers exist | lifecycle governance, stop/escalation/revision, and evidence vocabulary dossiers are present | `PASS` | -| decision-needed matrix exists | `governance/mpgc-intake/MPLP-MPGC-CANDIDATE-DECISION-NEEDED-MATRIX-v0.1.md` is present | `PASS` | -| non-promotion audit exists | `governance/audits/MPLP-MPGC-CANDIDATE-INTAKE-NON-PROMOTION-AUDIT-v0.1.md` is present | `PASS` | -| no formal guide/profile/binding draft | intake pack remains pre-RFC and non-normative | `PASS` | -| no accepted candidate | no MPGC acceptance is recorded in this wave | `PASS` | -| no schema change | intake pack does not modify schemas | `PASS` | -| no protocol law change | intake pack does not modify MPLP law | `PASS` | -| no normative promotion | intake pack remains pre-RFC and not accepted | `PASS` | -| no certification claim | intake pack makes no certification-like claim | `PASS` | - -## Decision - -`MPLP_MPGC_CANDIDATE_INTAKE_GATE_PASS` diff --git a/governance/gates/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-GATE-v0.1.md b/governance/gates/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-GATE-v0.1.md deleted file mode 100644 index e51a5193a..000000000 --- a/governance/gates/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-GATE-v0.1.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-GATE-v0.1" -title: "MPLP MPGC Candidate Review Preparation Gate v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Review Preparation Gate v0.1 - -## A. Purpose - -Gate review preparation before any future MPGC review decision. - -## B. Gate Matrix - -| Gate | Requirement | Status | -| --- | --- | --- | -| review preparation index exists | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-INDEX-v0.1.md` is present | `PASS` | -| review agenda exists | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md` is present | `PASS` | -| evidence summary packet exists | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md` is present | `PASS` | -| review rubric exists | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1.md` is present | `PASS` | -| risk matrix exists | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md` is present | `PASS` | -| decision ballot template exists | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1.md` is present | `PASS` | -| non-promotion audit exists | `governance/audits/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-NON-PROMOTION-AUDIT-v0.1.md` is present | `PASS` | -| no MPGC decision recorded | no review outcome is selected | `PASS` | -| RFC not opened | no RFC is opened in this wave | `PASS` | -| no candidate accepted | no candidate is accepted in this wave | `PASS` | -| no formal guide/profile/binding draft | review preparation does not create formal guide/profile/binding drafts | `PASS` | -| no schema change | no schema change recorded | `PASS` | -| no protocol law change | no protocol law change recorded | `PASS` | -| no certification claim | no certification claim recorded | `PASS` | - -## C. Decision - -`MPLP_MPGC_CANDIDATE_REVIEW_PREPARATION_GATE_PASS` diff --git a/governance/global-alignment-baseline.yaml b/governance/global-alignment-baseline.yaml new file mode 100644 index 000000000..0006948f7 --- /dev/null +++ b/governance/global-alignment-baseline.yaml @@ -0,0 +1,64 @@ +# Global Alignment Baseline +# SSOT for cross-entry consistency governance +# Machine-read by GLOB-GATE-01/02/03 + +version: "1.0.0" +status: "sealed" +sealed_at: "2026-01-24T20:06:53+08:00" + +# Canonical names (frozen) +canonical_names: + full: "Multi-Agent Lifecycle Protocol" + short: "MPLP" + slogan: "MPLP — The Agent OS Protocol." + technical_subtitle: "The Lifecycle Protocol for AI Agents." + enterprise_subtitle: "Observable. Governed. Vendor-neutral." + +# Canonical versions (must match across entries) +canonical_versions: + protocol: "1.0.0" + schema_bundle: "2.0.0" + lab_series: "v0.17.0" + +# Canonical anchors (tripod + lab) +canonical_anchors: + website_definition: "https://www.mplp.io/definition" + docs_entrypoints: "https://docs.mplp.io/docs/reference/entrypoints" + repo_root: "https://github.com/Coregentis/MPLP-Protocol" + lab_root: "https://lab.mplp.io" + lab_policies: "https://lab.mplp.io/policies" + +# Allowed domains for cross-link validation +allowed_domains: + - "mplp.io" + - "www.mplp.io" + - "docs.mplp.io" + - "lab.mplp.io" + - "github.com" + +# Required boundary statement IDs (ID-based, not text-based) +# Each entry must declare these in their manifest +required_boundaries: + - id: "BOUNDARY-NON-CERTIFICATION" + description: "This is not a certification or auditing service" + applies_to: ["website", "docs", "lab"] + + - id: "BOUNDARY-NON-ENDORSEMENT" + description: "MPLP does not endorse or recommend specific implementations" + applies_to: ["website", "lab"] + + - id: "BOUNDARY-VENDOR-NEUTRAL" + description: "The protocol is vendor-neutral and framework-agnostic" + applies_to: ["website", "docs", "lab"] + +# Entry definitions (for gate validation) +entries: + website: + manifest_path: "MPLP_website/public/website-seo-manifest.json" + required_fields: ["version", "pages"] + docs: + manifest_path: "docs/static/meta/docs-seo-manifest.json" + required_fields: ["protocol_version", "schema_bundle_version", "tripod"] + lab: + manifest_path: "Validation_Lab/public/_meta/lab-manifest.json" + required_fields: ["protocol_version", "lab_series", "tripod", "boundaries"] diff --git a/governance/global-alignment-current.yaml b/governance/global-alignment-current.yaml new file mode 100644 index 000000000..e2555b0b6 --- /dev/null +++ b/governance/global-alignment-current.yaml @@ -0,0 +1,13 @@ +# Current Global Alignment Pointer +# Points to the active, sealed baseline for v1.0 maintenance + +version: "1.0.0" +status: "active" +effective_baseline: "global-alignment-baseline.yaml" +current_series: "v0.17.0" +current_protocol: "1.0.0" +current_schema_bundle: "2.0.0" + +# Metadata +last_updated: "2026-01-25T23:58:00+08:00" +updated_by: "Antigravity (Audit Closure)" diff --git a/governance/mpgc-intake/MPLP-MPGC-CANDIDATE-DECISION-NEEDED-MATRIX-v0.1.md b/governance/mpgc-intake/MPLP-MPGC-CANDIDATE-DECISION-NEEDED-MATRIX-v0.1.md deleted file mode 100644 index c1bc58c53..000000000 --- a/governance/mpgc-intake/MPLP-MPGC-CANDIDATE-DECISION-NEEDED-MATRIX-v0.1.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-DECISION-NEEDED-MATRIX-v0.1" -title: "MPLP MPGC Candidate Decision Needed Matrix v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Decision Needed Matrix v0.1 - -| Candidate | Decision needed | Possible outcomes | Minimum evidence before promotion | -| --- | --- | --- | --- | -| lifecycle governance explanation candidate | should this remain backlog-only or become a future explanatory work item | `reject`; `defer`; `keep_backlog`; `open_rfc`; `request_more_evidence`; `accept_as_guide_work_item` | repeated anonymous downstream evidence, stable boundary wording, and clear proof that explanatory material is useful without implying adoption | -| stop / escalation / revision posture candidate | should this remain backlog-only or become a future posture work item | `reject`; `defer`; `keep_backlog`; `open_rfc`; `request_more_evidence`; `accept_as_profile_work_item` | repeated evidence beyond one anonymous downstream line, stable posture distinctions, and proof that the family remains non-executing and non-approval-shaped | -| evidence vocabulary / binding consideration candidate | should this remain backlog-only or become a future mapping work item | `reject`; `defer`; `keep_backlog`; `open_rfc`; `request_more_evidence`; `accept_as_binding_work_item` | repeated mapping pressure, stable neutral vocabulary questions, and proof that no schema expansion is required | -| non-executing lifecycle revision umbrella candidate | should the umbrella remain intact or be split further before any future RFC opening | `reject`; `defer`; `keep_backlog`; `open_rfc`; `request_more_evidence` | repeated evidence showing a durable umbrella relationship across lifecycle governance, posture, and vocabulary questions | - -No outcome is selected in this wave. - -## Decision - -`MPLP_MPGC_CANDIDATE_DECISION_NEEDED_MATRIX_READY` diff --git a/governance/mpgc-intake/MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md b/governance/mpgc-intake/MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md deleted file mode 100644 index 9aff1f79f..000000000 --- a/governance/mpgc-intake/MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1" -title: "MPLP MPGC Candidate Intake Index v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Intake Index v0.1 - -This is an MPGC candidate intake index. -It is pre-RFC. -It is non-normative. -It is not accepted. -It does not change MPLP protocol law. -It does not change schemas. -It does not create guide/profile/binding obligations. - -| Intake ID | Candidate theme | Source holding note | Review status | Required MPGC decision | -| --- | --- | --- | --- | --- | -| `MPLP-MPGC-INTAKE-001` | lifecycle governance explanation candidate | `governance/backlog/MPLP-GUIDE-CANDIDATE-LIFECYCLE-GOVERNANCE-v0.1.md` | `pre_rfc_intake_ready` | decide whether to reject, defer, keep backlog-held, request more evidence, or open a future work item for explanatory governance material | -| `MPLP-MPGC-INTAKE-002` | stop / escalation / revision posture candidate | `governance/backlog/MPLP-PROFILE-CANDIDATE-STOP-ESCALATION-POSTURE-v0.1.md` | `pre_rfc_intake_ready` | decide whether to reject, defer, keep backlog-held, request more evidence, or open a future work item for profile-shaped posture material | -| `MPLP-MPGC-INTAKE-003` | evidence vocabulary / binding consideration candidate | `governance/backlog/MPLP-BINDING-CONSIDERATION-EVIDENCE-VOCABULARY-v0.1.md` | `pre_rfc_intake_ready` | decide whether to reject, defer, keep backlog-held, request more evidence, or open a future work item for binding consideration vocabulary questions | -| `MPLP-MPGC-INTAKE-004` | non-executing lifecycle revision umbrella candidate | `governance/backlog/MPLP-NON-EXECUTING-LIFECYCLE-REVISION-CANDIDATE-REVIEW-v0.1.md` | `pre_rfc_intake_ready` | decide whether the umbrella candidate stays backlog-only or becomes a future review work item | - -## Decision - -`MPLP_MPGC_CANDIDATE_INTAKE_INDEX_READY` diff --git a/governance/mpgc-intake/MPLP-MPGC-INTAKE-EVIDENCE-VOCABULARY-CANDIDATE-v0.1.md b/governance/mpgc-intake/MPLP-MPGC-INTAKE-EVIDENCE-VOCABULARY-CANDIDATE-v0.1.md deleted file mode 100644 index 84962afb8..000000000 --- a/governance/mpgc-intake/MPLP-MPGC-INTAKE-EVIDENCE-VOCABULARY-CANDIDATE-v0.1.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-INTAKE-EVIDENCE-VOCABULARY-CANDIDATE-v0.1" -title: "MPLP MPGC Intake Evidence Vocabulary Candidate v0.1" -surface_role: canonical ---- - -# MPLP MPGC Intake Evidence Vocabulary Candidate v0.1 - -## Candidate Theme - -Evidence vocabulary candidate for how implementation substrates may map evidence -insufficiency, stale context, clarification, non-executing posture, and -revision references into MPLP-aligned evidence records without changing -protocol schemas. - -## Possible Future Binding Consideration - -- relation wording may later need a consistent non-schema mapping note -- reference-linking questions may eventually need bounded cross-implementation - guidance -- current pressure is still pre-RFC and non-normative - -## Open Mapping Questions - -- how evidence insufficiency relation should be expressed without a new schema - object -- how stale context relation should remain distinct from ordinary trace context -- how prior and revised artifact references should be linked -- how non-executing posture references should be carried without implying - execution outcomes -- how blocked / contract-blocked relations should remain non-approval and - non-rejection - -## Candidate Vocabulary Questions - -- what vocabulary best separates insufficiency from stale context -- what vocabulary best separates clarification from escalation -- what vocabulary best separates revision from approval and execution -- what vocabulary best preserves bounded safe evidence references - -## Schema Risk - -- premature vocabulary hardening could be mistaken for schema expansion -- relation questions could be over-read as field commitments - -## Compatibility Risk - -- inconsistent mapping language could fragment implementation substrates -- overly strong vocabulary could imply acceptance or compatibility guarantees - -## Explicit Non-Decisions - -This is not a binding spec draft. -This is not a binding change accepted by MPGC. -This does not add vocabulary to MPLP schemas. -- pre-RFC only -- non-normative only -- not protocol law -- not schema change -- no runtime endorsement -- no product endorsement -- no implementation endorsement -- no certification claim - -## Decision - -`MPLP_MPGC_INTAKE_EVIDENCE_VOCABULARY_CANDIDATE_READY` diff --git a/governance/mpgc-intake/MPLP-MPGC-INTAKE-LIFECYCLE-GOVERNANCE-CANDIDATE-v0.1.md b/governance/mpgc-intake/MPLP-MPGC-INTAKE-LIFECYCLE-GOVERNANCE-CANDIDATE-v0.1.md deleted file mode 100644 index f3645447f..000000000 --- a/governance/mpgc-intake/MPLP-MPGC-INTAKE-LIFECYCLE-GOVERNANCE-CANDIDATE-v0.1.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-INTAKE-LIFECYCLE-GOVERNANCE-CANDIDATE-v0.1" -title: "MPLP MPGC Intake Lifecycle Governance Candidate v0.1" -surface_role: canonical ---- - -# MPLP MPGC Intake Lifecycle Governance Candidate v0.1 - -## Candidate Theme - -Lifecycle governance explanation candidate derived from anonymous downstream -evidence around non-executing lifecycle revision, evidence insufficiency, -stale context handling, operator clarification boundaries, and contract-blocked -posture. - -## Source Evidence Summary - -- sourced from the lifecycle governance guide-candidate holding note -- aligned with the non-executing lifecycle revision umbrella candidate -- framed as explanatory boundary material rather than schema or protocol-law - content - -## Why This Might Become a Guide Topic - -- the strongest pressure is explanatory rather than structural -- the candidate mainly concerns boundary clarity and interpretation hygiene -- readable guidance may help keep revision, approval, and execution semantics - separated - -## What MPGC Must Decide - -- whether this candidate should remain backlog-only -- whether more anonymous downstream evidence is required before any further work -- whether a future explanatory work item is justified at all - -## Risks - -- guide-like language could be misread as accepted MPLP practice if not kept - clearly pre-RFC -- lifecycle governance wording could drift toward product semantics if not kept - neutral -- premature drafting could be mistaken for protocol adoption - -## Explicit Non-Decisions - -- pre-RFC only -- non-normative only -- not accepted -- not protocol law -- not schema change -- no runtime endorsement -- no product endorsement -- no implementation endorsement -- no certification claim - -## Decision - -`MPLP_MPGC_INTAKE_LIFECYCLE_GOVERNANCE_CANDIDATE_READY` diff --git a/governance/mpgc-intake/MPLP-MPGC-INTAKE-STOP-ESCALATION-REVISION-CANDIDATE-v0.1.md b/governance/mpgc-intake/MPLP-MPGC-INTAKE-STOP-ESCALATION-REVISION-CANDIDATE-v0.1.md deleted file mode 100644 index dea348049..000000000 --- a/governance/mpgc-intake/MPLP-MPGC-INTAKE-STOP-ESCALATION-REVISION-CANDIDATE-v0.1.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-INTAKE-STOP-ESCALATION-REVISION-CANDIDATE-v0.1" -title: "MPLP MPGC Intake Stop Escalation Revision Candidate v0.1" -surface_role: canonical ---- - -# MPLP MPGC Intake Stop Escalation Revision Candidate v0.1 - -## Candidate Theme - -Stop / escalation / revision posture candidate for systems that need to -distinguish non-executing revision, stop, clarification, and escalation -posture without crossing into execution or approval semantics. - -## Possible Future Profile Relevance - -- posture distinctions may later need a more repeatable comparison surface -- the candidate has stronger profile-shaped pressure than schema-shaped pressure -- current evidence remains too early for any MPGC-opened profile work item - -## Open Questions - -- when should evidence insufficiency force non-executing stop posture -- when should stale context trigger revision rather than continued action -- when should clarification posture become mandatory -- how should contract-blocked state be represented without implying rejection -- what evidence would show that this posture family generalizes beyond the - current anonymous downstream evidence set - -## Adoption Risks - -- posture language could be over-read as accepted lifecycle behavior -- escalation language could drift toward approval or execution semantics -- draft-like structure could be misread as profile publication if not kept - explicitly pre-RFC - -## Required MPGC Review - -- decide whether the candidate remains backlog-only -- decide whether more evidence is required before any future work item opens -- decide whether the candidate is even appropriate for MPLP-shaped review - -## Explicit Non-Decisions - -This is not a profile definition. -This is not a profile draft. -This is not profile content accepted by MPGC. -- pre-RFC only -- non-normative only -- not protocol law -- not schema change -- no runtime endorsement -- no product endorsement -- no implementation endorsement -- no certification claim - -## Decision - -`MPLP_MPGC_INTAKE_STOP_ESCALATION_REVISION_CANDIDATE_READY` diff --git a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1.md b/governance/mpgc-review/MPLP-MPGC-CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1.md deleted file mode 100644 index 572a2e9df..000000000 --- a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1" -title: "MPLP MPGC Candidate Decision Ballot Template v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Decision Ballot Template v0.1 - -## A. Purpose - -Provide a future MPGC decision recording template. - -This template records no decision in this wave. -It must not be interpreted as MPGC approval. - -## B. Candidate Decision Template - -| Candidate | Available decision options | Selected outcome | Rationale | Follow-up | -| --- | --- | --- | --- | --- | -| lifecycle governance explanation candidate | `reject`; `defer`; `keep_backlog`; `request_more_evidence`; `prepare_rfc_proposal`; `prepare_guide_work_item` | `NOT_SELECTED_IN_THIS_WAVE` | pending future MPGC review | pending future MPGC review | -| stop / escalation / revision posture candidate | `reject`; `defer`; `keep_backlog`; `request_more_evidence`; `prepare_rfc_proposal`; `prepare_profile_work_item` | `NOT_SELECTED_IN_THIS_WAVE` | pending future MPGC review | pending future MPGC review | -| evidence vocabulary / binding consideration candidate | `reject`; `defer`; `keep_backlog`; `request_more_evidence`; `prepare_rfc_proposal`; `prepare_binding_work_item` | `NOT_SELECTED_IN_THIS_WAVE` | pending future MPGC review | pending future MPGC review | -| non-executing lifecycle revision umbrella candidate | `reject`; `defer`; `keep_backlog`; `request_more_evidence`; `prepare_rfc_proposal` | `NOT_SELECTED_IN_THIS_WAVE` | pending future MPGC review | pending future MPGC review | - -## C. Decision - -`MPLP_MPGC_CANDIDATE_DECISION_BALLOT_TEMPLATE_READY` diff --git a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md b/governance/mpgc-review/MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md deleted file mode 100644 index 5c9f4b2c3..000000000 --- a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1" -title: "MPLP MPGC Candidate Evidence Summary Packet v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Evidence Summary Packet v0.1 - -## A. Purpose - -Summarize anonymous downstream evidence and candidate rationale for MPGC -review. - -## B. Evidence Summary Table - -| Candidate | Evidence signal | Current strength | Gaps | Review implication | -| --- | --- | --- | --- | --- | -| lifecycle governance explanation | repeated boundary explanation pressure around non-executing revision, insufficiency, stale context, clarification, and contract-blocked posture | `repeated_downstream_pattern` | still lacks broader cross-runtime evidence | good review candidate, but not enough for automatic standardization | -| stop / escalation / revision posture | stronger posture pressure around when work should stop, clarify, revise, or escalate without executing | `insufficient_generalization` | current pressure is still narrow and not yet shown across enough contexts | likely needs more evidence before any work-item opening | -| evidence vocabulary / binding consideration | repeated vocabulary pressure around insufficiency, stale context, prior/revised references, and non-executing posture | `single_downstream_signal` | vocabulary stability and mapping consistency remain unproven | best treated as question set, not as change proposal | -| non-executing lifecycle revision umbrella | umbrella candidate that links governance explanation, posture questions, and vocabulary questions | `needs_more_evidence` | umbrella boundaries could still be too broad for immediate next-step convergence | suitable for review discussion, not for automatic splitting into accepted work | - -## C. Evidence Quality Notes - -- anonymous downstream evidence is useful but insufficient for automatic - standardization -- downstream implementation success does not imply MPLP protocol adoption -- more evidence is required before RFC or normative consideration - -## D. Decision - -`MPLP_MPGC_CANDIDATE_EVIDENCE_SUMMARY_PACKET_READY` diff --git a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md b/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md deleted file mode 100644 index aa9b064ac..000000000 --- a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1" -title: "MPLP MPGC Candidate Review Agenda v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Review Agenda v0.1 - -## A. Purpose - -Prepare a review agenda for future MPGC discussion. - -## B. Agenda Sections - -| Agenda item | Candidate | Review question | Expected output | -| --- | --- | --- | --- | -| candidate intake scope confirmation | all intake candidates | are the review surfaces still pre-RFC and non-normative | confirmed scope and boundary read | -| downstream evidence sufficiency check | lifecycle governance candidate; stop/escalation/revision candidate; evidence vocabulary candidate | is the anonymous downstream evidence strong enough for further work or still too narrow | evidence sufficiency discussion record | -| non-promotion boundary check | all intake candidates | do the materials stay below protocol-law, schema, and acceptance thresholds | boundary confirmation for review | -| guide-topic suitability discussion | lifecycle governance candidate | is the explanatory material suited only for future guide-like work, if any | guide-suitability discussion note | -| profile-posture suitability discussion | stop / escalation / revision posture candidate | is the posture family coherent enough for future profile-shaped review work | profile-suitability discussion note | -| binding-vocabulary suitability discussion | evidence vocabulary candidate | are the vocabulary and relation questions better held as mapping guidance than schema change | binding-consideration discussion note | -| RFC readiness discussion | all intake candidates | is any candidate even close to RFC readiness or should all remain pre-RFC | RFC-readiness assessment note | -| decision deferral criteria | all intake candidates | what evidence gaps should trigger deferral or request-more-evidence outcomes | deferral criteria record | - -## C. Explicit Non-Decisions - -- no outcome selected -- no RFC is opened in this wave -- no candidate is accepted in this wave -- no formal drafts are created in this wave - -## D. Decision - -`MPLP_MPGC_CANDIDATE_REVIEW_AGENDA_READY` diff --git a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-INDEX-v0.1.md b/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-INDEX-v0.1.md deleted file mode 100644 index 46321d1ed..000000000 --- a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-INDEX-v0.1.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-REVIEW-PREPARATION-INDEX-v0.1" -title: "MPLP MPGC Candidate Review Preparation Index v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Review Preparation Index v0.1 - -## A. Purpose - -Define the review preparation package for MPGC candidate evaluation. - -This is review preparation only. -It does not record MPGC acceptance. -It does not open an RFC. -It does not create any formal guide, profile, or binding drafts. -It does not change schemas or protocol law. - -## B. Review Materials Index - -| Review item | Source intake dossier | Preparation artifact | Status | -| --- | --- | --- | --- | -| lifecycle governance candidate | `governance/mpgc-intake/MPLP-MPGC-INTAKE-LIFECYCLE-GOVERNANCE-CANDIDATE-v0.1.md` | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md` and `governance/mpgc-review/MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md` | `review_preparation_ready` | -| stop / escalation / revision posture candidate | `governance/mpgc-intake/MPLP-MPGC-INTAKE-STOP-ESCALATION-REVISION-CANDIDATE-v0.1.md` | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1.md` and `governance/mpgc-review/MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md` | `review_preparation_ready` | -| evidence vocabulary candidate | `governance/mpgc-intake/MPLP-MPGC-INTAKE-EVIDENCE-VOCABULARY-CANDIDATE-v0.1.md` | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-EVIDENCE-SUMMARY-PACKET-v0.1.md` and `governance/mpgc-review/MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md` | `review_preparation_ready` | -| non-executing lifecycle revision umbrella candidate | `governance/mpgc-intake/MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md` | `governance/mpgc-review/MPLP-MPGC-CANDIDATE-DECISION-BALLOT-TEMPLATE-v0.1.md` and `governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-AGENDA-v0.1.md` | `review_preparation_ready` | - -## C. Decision - -`MPLP_MPGC_CANDIDATE_REVIEW_PREPARATION_INDEX_READY` diff --git a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1.md b/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1.md deleted file mode 100644 index 9ebb9e44c..000000000 --- a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-REVIEW-RUBRIC-v0.1" -title: "MPLP MPGC Candidate Review Rubric v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Review Rubric v0.1 - -## A. Purpose - -Define review criteria for MPGC candidate discussion. - -## B. Rubric Matrix - -| Criterion | Question | Scoring posture | Blocking concern | -| --- | --- | --- | --- | -| protocol neutrality | does the candidate remain protocol-neutral and not product-shaped | `low / medium / high / unknown` | hidden product semantics | -| cross-runtime generality | is there evidence beyond one implementation substrate or downstream line | `low / medium / high / unknown` | overgeneralization from narrow evidence | -| lifecycle relevance | is the candidate actually about lifecycle posture rather than application convenience | `low / medium / high / unknown` | candidate theme drift | -| evidence sufficiency | is the evidence strong enough for further work-item preparation | `low / medium / high / unknown` | evidence overclaim | -| schema impact | would the candidate pressure immediately imply schema discussion | `low / medium / high / unknown` | schema creep | -| protocol law impact | would the candidate pressure immediately imply protocol-law widening | `low / medium / high / unknown` | accidental promotion | -| conformance risk | could the candidate be misread as a conformance obligation | `low / medium / high / unknown` | conformance confusion | -| endorsement risk | could the candidate be misread as endorsing a runtime or product | `low / medium / high / unknown` | endorsement leakage | -| implementation dependency risk | is the candidate still too coupled to one implementation substrate | `low / medium / high / unknown` | implementation dependence | -| adoption clarity | is it clear what future path, if any, is being discussed | `low / medium / high / unknown` | ambiguity in next-step expectations | -| backward compatibility | could future work on the candidate threaten existing interpretation surfaces | `low / medium / high / unknown` | compatibility confusion | -| documentation value | would future explanatory material add clarity without overpromoting the candidate | `low / medium / high / unknown` | documentation drift into acceptance language | - -No score is assigned in this wave. - -## C. Decision - -`MPLP_MPGC_CANDIDATE_REVIEW_RUBRIC_READY` diff --git a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md b/governance/mpgc-review/MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md deleted file mode 100644 index 29509c098..000000000 --- a/governance/mpgc-review/MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-MPGC-CANDIDATE-RISK-MATRIX-v0.1" -title: "MPLP MPGC Candidate Risk Matrix v0.1" -surface_role: canonical ---- - -# MPLP MPGC Candidate Risk Matrix v0.1 - -## A. Purpose - -Identify risks before MPGC candidate review. - -## B. Risk Matrix - -| Risk | Applies to | Why it matters | Mitigation | -| --- | --- | --- | --- | -| premature normative promotion | all intake candidates | review materials could be misread as accepted protocol direction | repeat pre-RFC, non-normative, and not-accepted boundaries across all materials | -| schema creep | evidence vocabulary candidate; stop/escalation/revision candidate | vocabulary or posture questions could drift into implicit field requests | keep all schema-impact language negative and explicitly deferred | -| profile proliferation | stop / escalation / revision posture candidate | posture discussion could multiply profile-like artifacts too early | keep the candidate in holding form and require more evidence first | -| binding vocabulary overfit | evidence vocabulary candidate | vocabulary questions could overfit one implementation substrate | frame all mappings as questions, not changes | -| downstream evidence overgeneralization | all intake candidates | one anonymous downstream success can be misread as general proof | keep evidence strengths conservative and gap-focused | -| hidden runtime endorsement | lifecycle governance candidate; evidence vocabulary candidate | candidate wording could accidentally bless one runtime style | keep vendor-neutral/runtime-neutral wording only | -| product endorsement leakage | lifecycle governance candidate; stop/escalation/revision candidate | explanation language could drift toward product semantics | keep candidate scope abstract and boundary-led | -| certification implication | all intake candidates | review materials could be mistaken for certification-like authority | repeat no-certification-claim boundaries and avoid evaluative approval wording | -| conformance confusion | all intake candidates | review packet might be misread as new obligation | keep non-promotion audit and gate attached to the packet | -| implementation dependency | evidence vocabulary candidate; delegation/delivery/constraint family context | candidate language may stay too close to one implementation substrate | require explicit evidence of broader generality before any later work item | -| ambiguity between revision / approval / execution | lifecycle governance candidate; stop/escalation/revision candidate | semantic overlap would distort future evaluation | preserve explicit distinction language in review materials | - -## C. Decision - -`MPLP_MPGC_CANDIDATE_RISK_MATRIX_READY` diff --git a/governance/records/REPO-TOPOLOGY-POINTER-MANIFEST-DECISION-2026-05-29.md b/governance/records/REPO-TOPOLOGY-POINTER-MANIFEST-DECISION-2026-05-29.md deleted file mode 100644 index bfe2d41fe..000000000 --- a/governance/records/REPO-TOPOLOGY-POINTER-MANIFEST-DECISION-2026-05-29.md +++ /dev/null @@ -1,120 +0,0 @@ ---- -entry_surface: repository -doc_type: governance_record -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "REPO-TOPOLOGY-POINTER-MANIFEST-DECISION-2026-05-29" ---- - -# Repo Topology Pointer Manifest Decision - 2026-05-29 - -**Record ID**: REPO-TOPOLOGY-POINTER-MANIFEST-DECISION-2026-05-29 -**Status**: Draft Governance Record -**Protocol Version**: 1.0.0 -**Repository**: Coregentis/MPLP-Protocol -**Decision Scope**: Protocol public manifest contract, Website pointer relation, and Validation Lab pointer relation. - -## 1. Decision - -MPLP-Protocol is the source of protocol manifest truth. Website and Validation Lab must consume Protocol release metadata through the Protocol Public Manifest rather than through source embedding or submodule-style coupling. - -This record introduces the in-repository manifest source files: - -- `release-manifests/mplp-public-manifest.schema.json` -- `release-manifests/mplp-public-manifest.example.json` - -## 2. Website Boundary - -The Website remains the standalone discovery and positioning surface for MPLP. - -The existing `MPLP_website` submodule remains temporarily attached. It must not be removed until Website manifest consumption has been implemented and verified. - -Website must not override: - -- protocol truth -- schema truth -- release truth -- package publication truth - -Website may consume manifest fields for public copy, canonical URLs, SEO/GEO metadata, package version display, documentation links, Validation Lab pointers, and copyright/trademark notices. - -## 3. Validation Lab Boundary - -Validation Lab remains standalone and is not embedded in the current MPLP-Protocol repository. - -Validation Lab consumes Protocol release metadata through manifest and pointer records. It must preserve the following boundaries: - -- non-certifying -- non-normative -- evidence-based verdicts only -- no endorsement -- no regulator approval -- no runtime authority -- no SDK authority -- no protocol truth override - -## 4. Repository Migration Boundary - -The future independent organization is reserved: - -```text -https://github.com/Multi-Agent-Lifecycle-Protocol -``` - -No repository migration is performed by this decision. Current canonical repository URLs remain under `Coregentis/*` until explicit migration authorization. - -Package repository URLs remain unchanged. - -## 5. Submodule Removal Deferral - -Submodule removal is deferred because the downstream consumption path must exist before the historical coupling is removed. - -The required sequence is: - -1. Approve the manifest contract. -2. Add Protocol manifest schema and example. -3. Update Website to consume the manifest. -4. Update Validation Lab pointer relation. -5. Verify downstream builds and boundaries. -6. Remove the Website submodule in a dedicated later PR. -7. Update release SOP to require manifest updates and pointer validation. - -## 6. Acceptance Gates - -Future implementation must satisfy: - -- the example manifest validates against the schema -- Website build consumes the manifest without hardcoded protocol drift -- Validation Lab references the manifest without certification claims -- submodule removal PR shows no lost Website deployment path -- release SOP requires manifest update before public release - -## 7. Non-Actions - -This record does not: - -- remove `MPLP_website` -- edit `.gitmodules` -- modify Website source -- modify Validation Lab source -- change package versions -- publish npm or PyPI packages -- deprecate npm packages -- yank PyPI releases -- change remotes -- migrate repositories -- change GitHub settings -- create release tags - -## 8. Related Governance Inputs - -- `MPLP-WEBSITE-POINTER-MANIFEST-CONTRACT-2026-05-29.md` -- `protocol-public-manifest-contract.json` -- `website-pointer-contract.json` -- `validation-lab-pointer-contract.json` -- `topology-normalization-roadmap.json` - ---- - -End of record. diff --git a/governance/release/MPLP-RELEASE-SOP.md b/governance/release/MPLP-RELEASE-SOP.md deleted file mode 100644 index cd593d8f2..000000000 --- a/governance/release/MPLP-RELEASE-SOP.md +++ /dev/null @@ -1,393 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: active -authority: MPLP public release governance -protocol_version: "1.0.0" -doc_id: "MPLP-RELEASE-SOP" -title: "MPLP Release SOP" ---- - -# MPLP Release SOP - -## 1. Purpose - -This SOP defines the current public MPLP release process across: - -- `Coregentis/MPLP-Protocol` -- `Coregentis/MPLP-Official-Website` -- `Coregentis/MPLP-Validation-Lab` -- public npm package surfaces under `@mplp/*` -- public PyPI package surfaces such as `mplp-sdk` - -It binds the recovered Protocol Public Manifest flow into repeatable release -work. It is the current canonical operational release SOP for public MPLP -releases. Older SDK-specific methods and release checklists remain useful -supporting records only where they do not conflict with this SOP. - -## 2. Scope And Authority - -`Coregentis/MPLP-Protocol` is the current public release source for MPLP -Protocol artifacts, schemas, public release manifests, governance records, SDK -source surfaces, and public package preparation. - -`Coregentis/MPLP-Protocol-Dev` remains a historical internal line. Do not merge -Dev `main` into public `main`. Any future Dev-originated candidate must be -handled through a dedicated owner-approved provenance and export record, not by -direct branch merge. - -Public OSS release changes must move through the protected PR path on -`Coregentis/MPLP-Protocol`. Direct public `main` pushes are not part of the -normal release path. - -The future independent organization is reserved: - -- `https://github.com/Multi-Agent-Lifecycle-Protocol` - -It is informational only until a separate migration plan is approved and -executed. Current canonical repository and package metadata remain under -`Coregentis/*`. - -## 3. Branch And PR Discipline - -Release work uses a dedicated branch. Recommended branch names: - -- `governance/` -- `release/` -- `package/` -- `docs/` - -Each public release PR must include: - -- release scope and changed surfaces -- Protocol manifest status -- Website manifest sync status, when Website is in scope -- Validation Lab manifest pointer sync status, when Validation Lab is in scope -- package dry-run and replacement status, when packages are in scope -- identity and forbidden-overclaim scan status -- evidence file paths or release record paths - -Required checks must run normally. Do not force merge, admin override, or bypass -failed required checks except under an emergency record described in Section 12. -Merge commits are preferred for governance or release-flow PRs so the release -history remains auditable. - -## 4. Protocol Public Manifest Requirement - -Every public release candidate must review the Protocol Public Manifest assets: - -- `release-manifests/mplp-public-manifest.schema.json` -- `release-manifests/mplp-public-manifest.example.json` -- `scripts/semantic/validate-public-manifest.mjs` - -The required local Protocol manifest gate is: - -```bash -node scripts/semantic/validate-public-manifest.mjs -``` - -Before a public release can proceed: - -- the manifest example must validate against the schema -- `protocol_version`, `protocol_release_tag`, and `protocol_commit_sha` must be - consistent with the intended release candidate -- `canonical_repository` must remain - `https://github.com/Coregentis/MPLP-Protocol` until repository migration is - explicitly authorized -- `future_repository_target` may identify - `https://github.com/Multi-Agent-Lifecycle-Protocol/MPLP-Protocol` only as a - future target -- `package_replacement_status` must reflect the current package state -- `repo_migration_status` must not claim migration before it occurs -- `release_status.gates.submodule_removal_allowed` must remain false until the - Website submodule removal prerequisites in Section 10 are met - -The public manifest is a release metadata contract. It does not redefine -Protocol semantics and it does not make downstream surfaces protocol truth. - -## 5. Website Manifest Sync Requirement - -`Coregentis/MPLP-Official-Website` is a standalone discovery and positioning -surface. It consumes a vendored Protocol Public Manifest with a checksum and a -no-network validation gate. - -For each release where Website display, metadata, links, package references, or -Protocol version references are in scope: - -- sync the Website vendored manifest from the approved Protocol manifest -- update the Website checksum -- run the Website manifest validation/checksum gate -- run the Website normal test/build gates -- confirm Website does not present the future independent org as the current - canonical repository -- confirm Website does not claim certification, endorsement, regulator - approval, runtime authority, SDK authority, or protocol truth authority -- record the Website commit SHA or deployed release identifier in the release - record - -Website sync must be verified before public release completion if Website is in -scope for the release window. - -The `MPLP_website` submodule in this repository must not be removed merely -because the Website manifest exists. Removal remains blocked until Section 10 is -satisfied. - -## 6. Validation Lab Manifest Pointer Requirement - -`Coregentis/MPLP-Validation-Lab` is a standalone, evidence-based adjudication -surface. It consumes or pins a vendored Protocol Public Manifest with a checksum -and a no-network validation gate. - -For each release where Validation Lab protocol metadata, ruleset pointers, -schema references, evidence-pack references, or Lab public boundary text are in -scope: - -- sync the Lab vendored manifest from the approved Protocol manifest -- update the Lab checksum -- run the Lab no-network manifest validation gate -- run the Lab normal test/build/semantic gates -- keep `protocol_version`, `validation_ruleset_version`, - `validation_lab_release_version`, and evidence-pack version separate -- confirm Lab does not become Protocol truth authority -- confirm Lab remains non-certifying, non-endorsing, and not a regulator - approval surface -- record the Lab commit SHA or release identifier in the release record - -Manifest sync must not change evidence or adjudication semantics unless a -separate owner-approved task explicitly authorizes that change. - -## 7. Package Release Gates - -Package release work must follow the package clean replacement plan and the SDK -release methods where they do not conflict with this SOP: - -- `governance/03-distribution/sdk/METHOD-SDKR-01_RELEASE_PIPELINE.md` -- `governance/03-distribution/sdk/METHOD-SDKR-05_RELEASE_MANIFEST.md` -- `governance/03-distribution/sdk/METHOD-SDKR-08_MULTI_PACKAGE_RELEASE_GOVERNANCE.md` -- `governance/03-distribution/sdk/METHOD-SDKR-09_RELEASE_READINESS.md` -- `governance/03-distribution/sdk/CHECKLIST-SDK-RELEASE.md` - -No npm or PyPI package action is allowed until the clean replacement -implementation is separately approved. - -Minimum package gates before any future package publication approval: - -- identify the exact npm and PyPI publish set -- confirm source mirrors and private packages are excluded -- run the npm publish-set gate -- run the PyPI publish-set gate, if PyPI is in scope -- build each package intended for publication -- inspect `npm pack --dry-run` or `npm pack` output for each npm package -- inspect PyPI wheel/sdist contents for each PyPI package -- verify package repository URLs still point to `Coregentis/MPLP-Protocol` until - repo migration is approved -- run active identity scans on package metadata and packed artifacts -- obtain owner approval after dry-run evidence and before registry action - -Blocked until clean replacement approval: - -- `npm publish` -- `npm deprecate` -- PyPI upload -- PyPI yank/delete -- release tag creation for package release purposes - -Historical package versions must be preserved. Do not unpublish or delete -historical npm or PyPI versions. - -## 8. Identity And Legal Surfaces - -Active public release surfaces use `Jearon Wong` for current identity. - -Historical records, frozen schemas, invariant evidence, registry evidence, -license history, and compatibility fixtures may preserve historical facts. Do -not bulk-rewrite identity strings across historical or frozen evidence. - -Owner-review identity surfaces require a separate decision before migration. -Do not treat this SOP as approval to change them. - -Release candidates must include an identity scan across active public surfaces -and package metadata relevant to the release window. Remaining hits must be -classified as one of: - -- active migration required -- historical preserve -- frozen preserve -- owner decision required -- explanatory note candidate - -## 9. Boundary And Overclaim Rules - -Public release surfaces must not claim: - -- MPLP certification -- endorsement by MPLP, Coregentis, Website, or Validation Lab -- regulator approval -- Website authority over Protocol truth -- Validation Lab authority over Protocol truth -- runtime authority -- SDK authority -- package version equals Protocol version unless explicitly stated -- future independent org as current canonical repository before migration - -Boundary language may state that a surface is non-certifying, non-endorsing, not -regulator approval, evidence-based, discovery/positioning-only, or pointer-only. -Such negative or boundary uses must remain clear. - -Every release candidate must run a forbidden-overclaim scan on changed active -surfaces and classify all matches. - -## 10. Topology Normalization And Submodule Removal - -Website and Validation Lab are standalone release-line repositories. Protocol -must not embed Website or Lab source in the final topology. - -Do not remove or update `.gitmodules` or the `MPLP_website` submodule until all -of the following are true: - -- Protocol Public Manifest schema and example exist and validate -- Website consumes a vendored Protocol manifest with checksum and gate -- Validation Lab consumes or pins a vendored Protocol manifest with checksum and - gate -- this release SOP is merged -- a dedicated submodule removal PR proves no deployment path, release source, - public URL, or source-of-truth relationship is lost -- the submodule removal PR verifies Protocol docs/build/release scripts no - longer require `MPLP_website` -- the submodule removal PR records Website standalone checkout and manifest sync - evidence - -Submodule removal is a separate task. This SOP does not authorize it directly. - -## 11. Release Checklist - -Use this checklist for every public release window. - -### 11.1 Protocol Gates - -- [ ] dedicated release/governance branch created -- [ ] public `main` not pushed directly -- [ ] release scope and changed surfaces recorded -- [ ] `git diff --check` passes -- [ ] `node scripts/semantic/validate-public-manifest.mjs` passes -- [ ] root tests pass -- [ ] root lint passes -- [ ] docs build passes, when docs are in scope or touched -- [ ] `.gitmodules` unchanged unless this is an approved submodule PR -- [ ] `MPLP_website` gitlink unchanged unless this is an approved submodule PR - -### 11.2 Manifest Checks - -- [ ] Protocol manifest schema/example validates -- [ ] manifest commit/tag/version fields match intended release -- [ ] manifest checksum or downstream checksum is recorded where applicable -- [ ] `canonical_repository` remains `Coregentis/MPLP-Protocol` -- [ ] future org appears only as a future target -- [ ] package replacement and repo migration statuses are current - -### 11.3 Website Gates - -- [ ] Website vendored manifest sync needed/not-needed decision recorded -- [ ] Website manifest validation/checksum gate passes, if Website is in scope -- [ ] Website build/test gates pass, if Website is in scope -- [ ] Website does not override Protocol truth -- [ ] Website does not claim certification, endorsement, or regulator approval -- [ ] Website commit/deploy identifier recorded, if Website is in scope - -### 11.4 Validation Lab Gates - -- [ ] Validation Lab manifest pointer sync needed/not-needed decision recorded -- [ ] Lab no-network manifest validation/checksum gate passes, if Lab is in - scope -- [ ] Lab quality/test/build/semantic gates pass, if Lab is in scope -- [ ] Lab remains non-certifying and non-normative -- [ ] Lab does not alter evidence/adjudication semantics unless separately - authorized -- [ ] Lab commit/release identifier recorded, if Lab is in scope - -### 11.5 Identity And Boundary Scans - -- [ ] active identity scan completed on changed public surfaces -- [ ] remaining identity hits classified -- [ ] forbidden-overclaim scan completed on changed public surfaces -- [ ] no unsupported certification, endorsement, regulator approval, runtime - authority, SDK authority, or Protocol truth authority claim introduced - -### 11.6 Package Dry-Run Gates - -- [ ] exact npm/PyPI publish set declared, if packages are in scope -- [ ] source mirrors/private packages excluded -- [ ] npm publish-set gate passes, if npm is in scope -- [ ] PyPI publish-set gate passes, if PyPI is in scope -- [ ] package build succeeds for every package in scope -- [ ] `npm pack` or `npm pack --dry-run` output inspected -- [ ] PyPI wheel/sdist output inspected -- [ ] package repository URLs remain under `Coregentis/*` until migration -- [ ] owner approval recorded before any registry action - -### 11.7 Evidence And Merge Records - -- [ ] release evidence record created or updated -- [ ] PR URL and number recorded -- [ ] required checks recorded -- [ ] merge commit recorded after merge -- [ ] post-merge HEAD recorded -- [ ] release note records changed/unchanged surfaces -- [ ] blocked actions explicitly preserved or separately authorized - -## 12. Emergency, Rollback, And Supersession - -Emergency bypass is allowed only when all of the following are true: - -- the release owner declares an emergency -- the failing check is classified with evidence -- the bypass is recorded before or immediately after action -- the record names the exact branch, PR, commit, command, and operator -- a follow-up remediation task is created - -Emergency bypass must not be used for package registry action, repository -migration, package URL migration, release tag creation, or submodule removal -unless the owner explicitly authorizes that exact irreversible action. - -Rollback must not rewrite protected public history. Prefer: - -- revert PRs -- forward-fix PRs -- package replacement versions after owner approval -- clear release notes that mark superseded artifacts - -When this SOP supersedes old release instructions, retain old records for audit -and mark them as supporting or historical in release evidence. Do not delete -historical release records. - -## 13. Current Blocked Actions - -These actions remain blocked until a separate approved task authorizes them: - -- package publish -- npm deprecate -- PyPI upload -- PyPI yank/delete -- repository migration -- package URL migration -- release tag creation -- schema v2 intake -- Website submodule removal -- GitHub settings changes - -## 14. Non-Actions Of This SOP - -This SOP does not: - -- publish packages -- deprecate npm versions -- upload, yank, or delete PyPI releases -- create release tags -- migrate repositories -- change remotes -- change package repository URLs -- remove or update the `MPLP_website` submodule -- change Website source -- change Validation Lab source -- change GitHub settings -- approve broad identity rewrites diff --git a/governance/releases/MPLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1.md b/governance/releases/MPLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1.md deleted file mode 100644 index e5ed6c548..000000000 --- a/governance/releases/MPLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: frozen -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-TOOLING-POSTURE-CLOSURE-RECORD-v0.1" -title: "MPLP Tooling Posture Closure Record v0.1" -surface_role: canonical ---- - -# MPLP Tooling Posture Closure Record v0.1 - -## 1. Executive Judgment - -The current MPLP package/tooling line is now closed as: - -- `PACKAGE_TRUTH_CLARIFIED` -- `ROOT_TOOLING_POSTURE_EXPLICITLY_BOUNDED` -- `NO_PROTOCOL_OR_SCHEMA_CHANGE` - -## 2. Current Tooling Posture - -The current truthful posture is: - -- the repository is first a frozen protocol source-of-truth repo -- root package/tooling does **not** currently provide a unified root build/type - gate -- many `packages/npm/*` manifests are publish-oriented and point at `dist/` - targets not present in checked-in repo truth -- checked-in local package consumability is uneven across `packages/npm/*` and - `packages/sources/*` - -## 3. What This Wave Tightened - -This wave tightened current repo truth by: - -- documenting package/tooling posture under governance -- documenting package-by-package `dist` reality -- clarifying README/CHANGELOG wording -- normalizing validator source `tsconfig.json` into normal repo-local JSON - encoding -- removing tracked empty AppleDouble-style files and ignoring future recurrence - -## 4. What Is Explicitly Not Claimed - -This wave does **not** claim that: - -- the root repository now has a truthful unified type/build/test gate -- all `packages/npm/*` are locally consumable checked-in packages -- all `packages/sources/*` are uniform checked-in source packages -- missing `dist/` artifacts have now been generated -- any protocol law, schema, invariant, or package meaning changed - -## 5. Acceptable Continuation Condition - -It is acceptable to continue from this line while all of the following remain -true: - -- package/tooling posture is read as bounded and explicit -- publish-oriented manifests are not over-read as checked-in `dist` guarantees -- frozen protocol core remains untouched -- future tooling hardening, if any, is scoped separately from protocol work - -## 6. Future Hardening Still Needed - -Future tooling hardening may still need to decide: - -- whether a truthful root-level type/build gate should be added -- whether selected npm package folders should become locally consumable in - checked-in form -- whether selected source mirrors should be tightened further to reduce mixed - posture ambiguity - -Those are future tooling questions only. They are not protocol-law questions. diff --git a/governance/releases/MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD.md b/governance/releases/MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD.md deleted file mode 100644 index 39a4e62f9..000000000 --- a/governance/releases/MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD.md +++ /dev/null @@ -1,95 +0,0 @@ ---- -entry_surface: repository -doc_type: governance -status: frozen -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-v0.4-CANDIDATE-ONLY-CLOSURE-RECORD" -title: "MPLP v0.4 Candidate-Only Closure Record" -surface_role: canonical ---- - -# MPLP v0.4 Candidate-Only Closure Record - -## 1. Executive Decision - -This record closes the current MPLP-side downstream line as -`candidate_only_and_non_promoted`. - -This means: - -- candidate abstractions may remain visible in governance/backlog form -- frozen MPLP protocol core remains unchanged -- no current downstream abstraction is promoted into protocol law by this line - -## 2. Accepted Candidate-Only Material Present - -The currently accepted candidate-only material is limited to: - -- `Delegation Envelope` -- `Delivery / Acceptance Contract Envelope` -- `Constraint / Stop Condition / Escalation Envelope` - -These remain: - -- non-normative -- governance-only -- outside `schemas/v2/` -- outside invariant law -- outside package and SDK meaning - -## 3. Explicit Non-Promotion Judgment - -The current downstream line does **not** justify MPLP promotion for: - -- Cell semantics -- Multi Cell semantics -- Portfolio semantics -- Secretary semantics -- runtime-private workforce object families -- SoloCrew product-projected management or inspection surfaces - -The current line also does **not** justify protocol promotion merely because: - -- downstream usage is repeated -- runtime-private objects are machine-readable -- cross-repo integration currently passes - -## 4. Remaining Candidate Risks - -The remaining risks are candidate-governance risks, not protocol-core defects: - -- downstream readers may over-read product/runtime pressure as protocol law -- concrete runtime-private objects may be mistaken for neutral protocol - envelopes -- multi-cell/product terminology may be mistaken for MPLP semantic adoption - -These risks are acceptable to continue with as long as non-promotion remains -explicit. - -## 5. Acceptable Continuation Condition - -It is acceptable to continue from this line while all of the following remain -true: - -- candidate discussion stays governance-only -- frozen core assets remain untouched -- downstream usage is not cited as automatic protocol promotion -- future promotion discussion, if any, begins from explicit evidence rather than - convenience - -## 6. Pause Triggers - -Future protocol-promotion discussion should pause immediately if any repo starts -to imply that: - -- runtime-private objects are already MPLP objects -- product projections are already MPLP objects -- multi-cell or management-object semantics have already entered MPLP law -- candidate discussion alone authorizes schema or invariant change - -## 7. Final Closure Verdict - -- `CURRENT_DOWNSTREAM_LINE_REMAINS_CANDIDATE_ONLY` -- `FROZEN_MPLP_CORE_REMAINS_UNCHANGED` -- `FUTURE_PROMOTION_REQUIRES_SEPARATE_EVIDENCE_AND_SEPARATE_GOVERNANCE_ACTION` diff --git a/governance/research/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md b/governance/research/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md deleted file mode 100644 index 3a087173a..000000000 --- a/governance/research/MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1.md +++ /dev/null @@ -1,177 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-BOUNDARY-AND-PROMOTION-RULES-v0.1" -title: "MPLP Boundary and Promotion Rules v0.1" -surface_role: canonical ---- - -# MPLP Boundary and Promotion Rules v0.1 - -> **Non-Normative Governance Frame** -> -> This document defines a candidate-triage and promotion frame only. -> It does **not** add accepted protocol content and does **not** override frozen -> MPLP constitutional or schema truth. - -## 1. Purpose - -This document defines the explicit decision rules for separating: - -- protocol obligation -- runtime-family design -- product projection - -Its job is to reduce accidental protocol bloat when new abstractions emerge from -runtime or product work. - -## 2. Three-Layer Boundary Rule - -### 2.1 Protocol obligation - -A concept belongs in MPLP only when it defines a reusable interface obligation -that independent implementations must be able to express or honor. - -Protocol-layer concepts should therefore be: - -- implementation-independent -- runtime-family-independent -- product-independent -- expressible through schema/invariant-level truth - -### 2.2 Runtime-family design - -A concept belongs in a runtime family when it is needed to realize behavior, -state, orchestration, policy, or evidence inside a specific runtime substrate or -runtime stack, but is not yet proven to be a universal protocol obligation. - -Runtime-family concepts may be: - -- reusable across products -- upstream of product projections -- still too realization-sensitive for protocol promotion - -### 2.3 Product projection - -A concept belongs in product projection when it packages runtime truth into: - -- UX-facing structure -- business-facing operating language -- dashboard, console, or management surfaces -- product-specific cards, workflows, and summaries - -Product projection concepts must not be elevated into protocol law by -convenience. - -## 3. Default Placement Rule - -When placement is ambiguous, the default is: - -1. keep it out of MPLP -2. keep it in runtime-family space if reusable runtime need is proven -3. otherwise keep it in product projection space - -The burden of proof is therefore on promotion upward, not on keeping concepts -downstream. - -## 4. Promotion Checklist - -A candidate should only be considered for protocol promotion if it passes all -of the following checks. - -### 4.1 Cross-runtime relevance - -Question: - -- Is the concept needed across more than one runtime family, not just one - runtime implementation? - -### 4.2 Implementation independence - -Question: - -- Can the concept be expressed without assuming a specific orchestrator, store, - policy engine, tool layer, or product architecture? - -### 4.3 Cross-business relevance - -Question: - -- Does the concept remain meaningful across different business domains rather - than only one product's operating model? - -### 4.4 Evidence expressibility - -Question: - -- Can the concept be represented as protocol-level evidence, interface shape, or - lifecycle obligation without depending on hidden runtime internals? - -### 4.5 Repeated validation outside one product - -Question: - -- Has the concept been validated in repeated use outside one product line or one - product-driven design wave? - -### 4.6 Non-overlap with current MPLP semantics - -Question: - -- Is this concept genuinely new at the protocol boundary, or can the need - already be expressed through existing MPLP modules, events, or evidence - semantics? - -## 5. Promotion Stop Rules - -A candidate must **not** be promoted when any of the following remain true: - -- it is only justified by one runtime family -- it is only justified by one product -- it encodes business-specific operating language -- it depends on one UI or dashboard shape -- it assumes a specific runtime architecture -- it duplicates meaning already covered by existing MPLP truth - -## 6. Promotion Evidence Package - -Before any candidate can move beyond backlog status, the minimum evidence -package should include: - -- statement of cross-runtime relevance -- statement of cross-business relevance -- explanation of why current MPLP semantics are insufficient -- at least two independent usage contexts or validation cases -- proof that the abstraction is implementation-independent enough for protocol - treatment -- explicit non-overlap analysis against current schemas, invariants, and golden - flows - -## 7. Promotion Decision Rule - -Passing the checklist does not automatically promote a candidate. - -It only makes a candidate eligible for a separate governance decision. - -Actual protocol promotion would still require: - -- explicit governance action -- explicit protocol version-domain handling -- explicit schema/invariant/doc updates in a later, separate wave - -## 8. Net Rule - -MPLP should grow only when a candidate proves: - -- cross-runtime value -- cross-business value -- implementation independence -- evidence-level expressibility -- repeated validation beyond one product - -If any of those are missing, the concept stays in runtime-family or product -space. diff --git a/governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md b/governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md deleted file mode 100644 index be2b229c9..000000000 --- a/governance/research/MPLP-CANDIDATE-BACKLOG-v0.1.md +++ /dev/null @@ -1,160 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-CANDIDATE-BACKLOG-v0.1" -title: "MPLP Candidate Backlog v0.1" -surface_role: canonical ---- - -# MPLP Candidate Backlog v0.1 - -> **Non-Normative Candidate Tracking Only** -> -> This document tracks possible future abstraction families. -> It does **not** add protocol obligations, does **not** amend `schemas/v2/`, -> and does **not** change frozen MPLP semantics. - -## 1. Purpose - -This document creates a formal backlog for candidate abstractions that may later -deserve MPLP-level consideration. - -The purpose of this backlog is narrow: - -- keep candidate ideas visible without silently promoting them -- prevent runtime or product convenience from becoming accidental protocol law -- record what evidence would be required before any candidate can advance - -## 2. Backlog Intake Rule - -A concept may be entered into this backlog when all of the following are true: - -1. it appears repeatedly at the runtime-family or product-projection level -2. it may imply cross-system interface value -3. it is still **unproven** as protocol law -4. MPLP has not yet accepted it into schemas, invariants, or normative docs - -Backlog entry is therefore: - -- permitted -- visible -- non-binding - -Backlog entry is **not** acceptance. - -## 3. Candidate Families - -### 3.1 Delegation Envelope - -**Why it is being tracked** - -- Multiple downstream structures are beginning to need a governed way to - express delegation, handoff, or bounded task transfer between actors or - layers. -- The idea has plausible cross-runtime relevance, but it is still emerging from - specific runtime and product pressures rather than from protocol-proofed - interface evidence. - -**Why it is not yet protocol law** - -- MPLP currently has no accepted schema or frozen invariant family for a - generic delegation envelope. -- The current need is still entangled with runtime-family orchestration and - product workflow shapes. -- There is not yet enough evidence that one general delegation abstraction can - stay implementation-independent across runtimes and businesses. - -**Evidence required for promotion** - -- repeated use outside one product line -- cross-runtime relevance shown in more than one runtime family -- implementation-independent semantics that do not depend on one orchestrator - design -- evidence that the concept can be expressed as interface obligation rather than - product workflow packaging -- successful validation in at least one setting beyond one downstream runtime / - product line - -### 3.2 Delivery / Acceptance Contract Envelope - -**Why it is being tracked** - -- Downstream systems increasingly need a stable way to express expected - delivery shape, return condition, and acceptance posture between actors or - layers. -- This could eventually have protocol value if it proves reusable across - runtime families and product classes. - -**Why it is not yet protocol law** - -- Current examples are still close to business-facing operating structure rather - than pure protocol interface obligations. -- MPLP has frozen lifecycle modules and golden flows already; adding a new - envelope family requires evidence that it belongs at the protocol layer - rather than the runtime-family or product layer. -- No accepted normative schema, invariant, or module boundary exists for this - concept today. - -**Evidence required for promotion** - -- repeated validation outside one business shape -- a clean protocol-level abstraction that does not encode product-specific - delivery semantics -- evidence that acceptance semantics need standardization across independent - implementations -- field expressibility that can remain schema-level and implementation-neutral -- adjudicated examples that do not rely on one product's UI or operating model - -### 3.3 Constraint / Stop Condition / Escalation Envelope - -**Why it is being tracked** - -- Runtime and product layers are beginning to need a clearer cross-layer shape - for constraints, stop conditions, and escalation triggers. -- This family has plausible interface value because it sits near bounded - execution safety and coordination obligations. - -**Why it is not yet protocol law** - -- Current evidence is still mixed with runtime policy, product approval flow, - and business-specific constraint language. -- MPLP today does not require one general envelope for stop-loss, escalation, - or constraint declarations. -- The concept has not yet shown sufficient implementation independence or - repeated validation across distinct systems. - -**Evidence required for promotion** - -- evidence that at least two independent runtime families need the same abstract - interface -- proof that the concept can be expressed without embedding business-pack or - product-specific policy details -- reusable evidence model for constraint evaluation and escalation outcome -- repeated validation outside one runtime and one product -- a clear reason why existing MPLP module boundaries cannot already host the - needed semantics - -## 4. Backlog Status Rule - -All candidate families in this backlog are currently: - -- `tracked` -- `non-normative` -- `not accepted` -- `not schema-authorized` -- `not invariant-authorized` - -## 5. Promotion Gate Reminder - -No candidate in this backlog may become MPLP law merely because: - -- a runtime wants it -- a product wants it -- it feels architecturally elegant -- it is convenient for one implementation wave - -Promotion requires separate evidence review and an explicit governance decision. diff --git a/governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md b/governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md deleted file mode 100644 index ed0dcc8d1..000000000 --- a/governance/research/MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -entry_surface: repository -entry_model_class: primary -doc_type: governance -status: draft -authority: none -protocol_version: "1.0.0" -doc_id: "MPLP-DELEGATION-DELIVERY-CONSTRAINT-CANDIDATES-v0.1" -title: "MPLP Delegation Delivery Constraint Candidates v0.1" -surface_role: canonical ---- - -# MPLP Delegation Delivery Constraint Candidates v0.1 - -> **Non-Normative Candidate Expansion Only** -> -> This document expands candidate families conceptually. -> It does **not** define accepted MPLP semantics, concrete schema fields, or -> product/runtime-specific object models. - -## 1. Purpose - -This document provides conceptual expansion for three candidate families already -tracked in the MPLP candidate backlog: - -- Delegation Envelope -- Delivery / Acceptance Contract Envelope -- Constraint / Stop Condition / Escalation Envelope - -The purpose is to make candidate discussion more precise without turning any of -these into protocol law. - -## 2. Conceptual Candidate: Delegation Envelope - -### Concept - -A delegation envelope would be a candidate abstraction for expressing that one -actor, layer, or unit transfers a bounded responsibility to another. - -### What problem it might solve - -- make delegation boundaries auditable -- distinguish delegated responsibility from raw task description -- allow later evidence to show who delegated what, under which condition, and - with what expected return shape - -### Why it remains candidate-only - -- delegation semantics may vary heavily by runtime and product -- the minimal reusable contract is not yet proven -- current pressure comes from downstream structure rather than protocol-wide - validation - -## 3. Conceptual Candidate: Delivery / Acceptance Contract Envelope - -### Concept - -A delivery / acceptance contract envelope would be a candidate abstraction for -expressing expected output shape, completion posture, and acceptance conditions -between actors or layers. - -### What problem it might solve - -- separate "work requested" from "delivery expected" -- clarify when a return is considered complete, partial, blocked, or pending - acceptance -- support later evidence and replay around handoff quality - -### Why it remains candidate-only - -- delivery semantics may still be too business-shaped -- the protocol-neutral core is not yet proven -- current examples do not yet show repeated validation across independent - systems - -## 4. Conceptual Candidate: Constraint / Stop Condition / Escalation Envelope - -### Concept - -A constraint / stop condition / escalation envelope would be a candidate -abstraction for expressing the bounded conditions under which a process must: - -- continue -- stop -- defer -- escalate -- request approval - -### What problem it might solve - -- make safety and escalation posture more portable across systems -- separate operational constraints from raw task content -- support evidence-bearing explanation of why work was halted or escalated - -### Why it remains candidate-only - -- current examples are still tightly coupled to runtime policy and product - approval flow -- the abstract interface is not yet proven independent of implementation style -- no MPLP-level schema or invariant family exists for this today - -## 5. Candidate-Only Guardrails - -These conceptual candidates must not be misread as: - -- accepted module additions -- accepted envelope families -- field-level requirements -- new lifecycle duties -- changes to golden flows - -They are discussion frames only. - -## 6. What Would Advance These Candidates - -All three families would need: - -- repeated evidence outside one product -- repeated evidence outside one runtime family -- clean implementation-independent abstraction -- clear non-overlap with current MPLP semantics -- separate governance review before any normative change wave - -## 7. Net Candidate Position - -The correct current MPLP posture is: - -- track these ideas -- discuss them carefully -- keep them non-normative -- refuse accidental promotion - -That preserves MPLP as protocol constitution rather than allowing runtime or -product pressure to inflate the protocol by default. diff --git a/package.json b/package.json index f0865ee64..47a29ce30 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "mplp-protocol-oss", "version": "1.0.0", - "description": "MPLP Protocol v1.0 - Multi-Agent Lifecycle Protocol (OSS Package)", + "description": "MPLP Protocol v1.0 - Multi-agent Planning and Learning Protocol (OSS Package)", "repository": { "type": "git", "url": "https://github.com/Coregentis/MPLP-Protocol.git" @@ -12,11 +12,11 @@ "scripts": { "docs:dev": "cd docs && npm run start", "docs:build": "cd docs && npm run build", - "test": "node scripts/04-build/root-verification.mjs", - "lint": "node scripts/04-build/root-verification.mjs --lint" + "test": "echo 'No root tests configured'", + "lint": "echo 'No root linting configured'" }, "devDependencies": { "js-yaml": "^4.1.0", "minimatch": "^10.0.1" } -} +} \ No newline at end of file diff --git a/packages/npm/compliance/CHANGELOG.md b/packages/npm/compliance/CHANGELOG.md deleted file mode 100644 index f135cbee4..000000000 --- a/packages/npm/compliance/CHANGELOG.md +++ /dev/null @@ -1,5 +0,0 @@ -# Changelog - -This package follows the global MPLP Protocol changelog. - -See: https://github.com/coregentis/MPLP-Protocol/blob/main/CHANGELOG.md \ No newline at end of file diff --git a/packages/npm/compliance/DERIVATION_PROOF.yaml b/packages/npm/compliance/DERIVATION_PROOF.yaml deleted file mode 100644 index 046cea8e2..000000000 --- a/packages/npm/compliance/DERIVATION_PROOF.yaml +++ /dev/null @@ -1,33 +0,0 @@ -# DERIVATION_PROOF.yaml -# Reference: METHOD-SDKR-02 / METHOD-SDKR-08 - -protocol_version: "1.0.0" - -schema_bundle: - path: "schemas/v2" - -evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" - version: "v1.0" - digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" - -derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" - truth_sources: - - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" - -package: - name: "@mplp/compliance" - ecosystem: "npm" - version: "1.0.6" - category: "PUBLIC" - -verification: - protocol_conformance: "VERIFIED" - evidence_baseline_aligned: true - -governance: - method: "METHOD-SDKR-08" - frozen: true diff --git a/packages/npm/compliance/LICENSE b/packages/npm/compliance/LICENSE deleted file mode 100644 index e547836bb..000000000 --- a/packages/npm/compliance/LICENSE +++ /dev/null @@ -1,17 +0,0 @@ -Apache License -Version 2.0, January 2004 -http://www.apache.org/licenses/ - -Copyright 2026 Jearon Wong - -Licensed under the Apache License, Version 2.0 (the "License"); -you may not use this file except in compliance with the License. -You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, software -distributed under the License is distributed on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -See the License for the specific language governing permissions and -limitations under the License. diff --git a/packages/npm/compliance/README.md b/packages/npm/compliance/README.md deleted file mode 100644 index e2ad65ffd..000000000 --- a/packages/npm/compliance/README.md +++ /dev/null @@ -1,56 +0,0 @@ -# @mplp/compliance (Legacy) - -> **⚠️ DEPRECATED: This package has been renamed to `@mplp/conformance`.** -> -> Please migrate to the new package for correct terminology alignment with MPLP governance. - -**Protocol:** MPLP v1.0.0 (Frozen) -**License:** Apache-2.0 - ---- - -## Migration Guide - -This package is now **legacy**. Please use `@mplp/conformance` instead: - -```bash -npm uninstall @mplp/compliance -npm install @mplp/conformance -``` - -Update your imports: - -```diff -- import { runGoldenFlow01 } from '@mplp/compliance'; -+ import { runGoldenFlow01 } from '@mplp/conformance'; -``` - -The API is fully compatible - only the package name has changed. - -## Contract Mode - -This package remains a **deprecated public compatibility alias**. -It is not a direct mirror of protocol objects and should not be treated as the preferred public contract surface. - ---- - -## Why the rename? - -Per the current MPLP terminology baseline, "**conformance**" is the preferred external term for this package family. "Compliance" remains only as a legacy alias. - ---- - -## Protocol Documentation - -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source - ---- - -## License - -Apache License, Version 2.0 - -© 2026 **Jearon Wong** -Coregentis AI diff --git a/packages/npm/compliance/dist/index.d.ts b/packages/npm/compliance/dist/index.d.ts deleted file mode 100644 index 82f284a68..000000000 --- a/packages/npm/compliance/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/compliance"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "legacy-compliance-alias"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/compliance/dist/index.js b/packages/npm/compliance/dist/index.js deleted file mode 100644 index 473da9188..000000000 --- a/packages/npm/compliance/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/compliance","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"legacy-compliance-alias","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/compliance/package.json b/packages/npm/compliance/package.json deleted file mode 100644 index cceb5f22b..000000000 --- a/packages/npm/compliance/package.json +++ /dev/null @@ -1,66 +0,0 @@ -{ - "name": "@mplp/compliance", - "version": "1.0.6", - "description": "[LEGACY] Deprecated public compatibility alias for MPLP conformance tooling. Use @mplp/conformance instead.", - "license": "Apache-2.0", - "repository": { - "type": "git", - "url": "https://github.com/Coregentis/MPLP-Protocol.git" - }, - "keywords": [ - "mplp", - "compliance", - "validation", - "testing", - "golden-flows", - "multi-agent", - "protocol", - "lifecycle", - "legacy-alias" - ], - "publishConfig": { - "access": "public" - }, - "main": "dist/index.js", - "types": "dist/index.d.ts", - "dependencies": { - "@mplp/core": "^1.0.2", - "@mplp/schema": "^1.0.2", - "@mplp/modules": "^1.0.2", - "@mplp/coordination": "^1.0.2" - }, - "devDependencies": { - "typescript": "^5.0.0", - "ts-node": "^10.9.1", - "@types/node": "^20.0.0" - }, - "author": "Jearon Wong", - "copyright": "© 2026 Jearon Wong", - "mplp": { - "protocolVersion": "1.0.0", - "frozen": true, - "governance": "MPGC", - "packageClass": "PUBLIC", - "publishSurface": true, - "publishScope": "public-npm", - "packageRole": "legacy-compliance-alias", - "contractMode": "convenience-runtime-alias", - "deprecated": true - }, - "homepage": "https://www.mplp.io/what-is-mplp", - "bugs": { - "url": "https://github.com/Coregentis/MPLP-Protocol/issues" - }, - "exports": { - ".": { - "require": "./dist/index.js", - "import": "./dist/index.js", - "types": "./dist/index.d.ts" - } - }, - "sideEffects": false, - "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package", - "test": "npx ts-node ../../../tests/golden/harness/ts/golden-runner.ts" - } -} diff --git a/packages/npm/compliance/tsconfig.json b/packages/npm/compliance/tsconfig.json deleted file mode 100644 index 72d61f353..000000000 --- a/packages/npm/compliance/tsconfig.json +++ /dev/null @@ -1,23 +0,0 @@ -{ - "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2026 Jearon Wong\nLicense: Apache-2.0\nAny normative change requires a new protocol version.", - "compilerOptions": { - "target": "ES2020", - "module": "commonjs", - "lib": [ - "ES2020" - ], - "strict": true, - "esModuleInterop": true, - "skipLibCheck": true, - "forceConsistentCasingInFileNames": true, - "resolveJsonModule": true, - "declaration": true, - "moduleResolution": "node", - "downlevelIteration": true, - "outDir": "dist", - "rootDir": "src" - }, - "include": [ - "src" - ] -} diff --git a/packages/npm/conformance/DERIVATION_PROOF.yaml b/packages/npm/conformance/DERIVATION_PROOF.yaml index a23b11eab..89ca72923 100644 --- a/packages/npm/conformance/DERIVATION_PROOF.yaml +++ b/packages/npm/conformance/DERIVATION_PROOF.yaml @@ -7,16 +7,49 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" - truth_sources: + method: "l3_direct_conformance_facade" + description: > + @mplp/conformance is a bounded L3 package-surface facade. Its source is + not generated from packages/sources/* and not copied from a schema-derived + source mirror. It owns a local helper implementation that consumes L0 + schema truth through @mplp/schema. + semantic_truth: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + consumed_via: + package: "@mplp/schema" + version_range: "^1.0.6" + source_mirror: + required: false + path: null + reason: > + No conformance L2 source mirror or projection script exists in the + current repository. This package is explicitly classified as an L3 direct + facade exception for this remediation. + l3_source: + path: "packages/npm/conformance/src/index.ts" + provenance: "handwritten_direct_facade" + l4_dist: + path: "packages/npm/conformance/dist" + generated_from: "packages/npm/conformance/src/index.ts" + command: "npm run build" + pack_boundary: + includes: + - "LICENSE" + - "README.md" + - "dist/**" + - "package.json" + excludes: + - "src/**" + - "package-lock.json" + - "node_modules/**" + - "DERIVATION_PROOF.yaml" package: name: "@mplp/conformance" @@ -25,9 +58,13 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + schema_truth_consumed_via_package: true + no_schema_primitive_intake: true + no_normative_protocol_change: true + l3_direct_facade_exception_recorded: true evidence_baseline_aligned: true governance: method: "METHOD-SDKR-08" - frozen: true + protocol_baseline_frozen: true + evidence_record_mutable_for_corrections: true diff --git a/packages/npm/conformance/README.md b/packages/npm/conformance/README.md index 03ba53140..c706d8c86 100644 --- a/packages/npm/conformance/README.md +++ b/packages/npm/conformance/README.md @@ -1,34 +1,30 @@ # @mplp/conformance -**Protocol:** MPLP v1.0.0 (Frozen) +**Package Role:** Public npm conformance helper facade package +**Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.1 **License:** Apache-2.0 -The **@mplp/conformance** package is the public **compatibility alias surface** for MPLP conformance tooling. -It re-exports the legacy `@mplp/compliance` surface under the preferred terminology. +The `@mplp/conformance` package is the forward public package surface for MPLP conformance helper APIs. ---- +It owns its helper implementation directly and does not import from the legacy `@mplp/compliance` package. It is evidence-checking helper surface, not certification. -## Scope & Guarantees (Important) +## Scope & Guarantees -### ✅ What this package provides +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -* **Compatibility alias** for the public MPLP conformance tooling surface -* **Flow-oriented validation utilities** carried through the public alias surface -* **Schema conformance utilities** -* **Runtime-facing helper checks** carried through the legacy surface where applicable +## What This Package Provides -### ❌ What this package does NOT provide +- Forward public import surface for MPLP conformance helper APIs. +- Flow-oriented helper checks such as `runGoldenFlow01`. +- Schema-oriented helper checks carried through this package surface. -* ❌ An independent protocol object mirror -* ❌ Full execution runtime (LLM orchestration, tool execution) -* ❌ Golden Flow execution engines -* ❌ Protocol SSOT status for runtime concepts such as PSG -* ❌ Production agent orchestration +## What This Package Does NOT Provide -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Certification, endorsement, regulator approval, or legal compliance proof. +- A protocol source-of-truth object mirror. +- Full execution runtime or agent orchestration. +- A change to the publication, deprecation, or registry status of `@mplp/compliance`. ## Installation @@ -36,44 +32,38 @@ It re-exports the legacy `@mplp/compliance` surface under the preferred terminol npm install @mplp/conformance ``` ---- - -## Migration from @mplp/compliance - -This package replaces `@mplp/compliance` with correct terminology. -The API is fully compatible - simply update your import: +## Minimal User Smoke Usage Snippet -```diff -- import { runGoldenFlow01 } from '@mplp/compliance'; -+ import { runGoldenFlow01 } from '@mplp/conformance'; +```javascript +const conformance = require('@mplp/conformance'); +console.log(typeof conformance.runGoldenFlow01); ``` -> **Compatibility Note:** This package is a stable alias of `@mplp/compliance` for v1.0.x. -> The legacy `@mplp/compliance` package remains available but is deprecated. -> Both packages export identical APIs for backward compatibility. +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Protocol Documentation +## Package Provenance -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) - ---- +- **Package address:** [https://www.npmjs.com/package/@mplp/conformance](https://www.npmjs.com/package/@mplp/conformance) +- Public npm surface: `packages/npm/conformance`. +- Forward package for conformance helpers. +- Legacy `@mplp/compliance` remains excluded from this publish scope. ## Versioning & Compatibility -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. - ---- +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.1 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/conformance/dist/index.d.ts b/packages/npm/conformance/dist/index.d.ts deleted file mode 100644 index 36fba9d01..000000000 --- a/packages/npm/conformance/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/conformance"; -export declare const PACKAGE_VERSION: "1.0.1"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "conformance-compatibility-alias"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/conformance/dist/index.js b/packages/npm/conformance/dist/index.js deleted file mode 100644 index cfd7e649e..000000000 --- a/packages/npm/conformance/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/conformance","version":"1.0.1","protocolVersion":"1.0.0","packageRole":"conformance-compatibility-alias","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/conformance/package-lock.json b/packages/npm/conformance/package-lock.json deleted file mode 100644 index 6e4a26098..000000000 --- a/packages/npm/conformance/package-lock.json +++ /dev/null @@ -1,138 +0,0 @@ -{ - "name": "@mplp/conformance", - "version": "1.0.1", - "lockfileVersion": 3, - "requires": true, - "packages": { - "": { - "name": "@mplp/conformance", - "version": "1.0.1", - "license": "Apache-2.0", - "dependencies": { - "@mplp/compliance": "^1.0.4", - "typescript": "^5.9.3" - } - }, - "node_modules/@mplp/compliance": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/@mplp/compliance/-/compliance-1.0.4.tgz", - "integrity": "sha512-pRGzO25CMP0cFLKcIPpsY9XPJeVSShvk23FNVWkF1OBjOQcuDdDrX338umiwVhf9XYtwnajLibVZ45hMmXAI9Q==", - "dependencies": { - "@mplp/coordination": "^1.0.2", - "@mplp/core": "^1.0.2", - "@mplp/modules": "^1.0.2", - "@mplp/schema": "^1.0.2" - } - }, - "node_modules/@mplp/coordination": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/@mplp/coordination/-/coordination-1.0.5.tgz", - "integrity": "sha512-6CodZOMKHGiEbL0g+4g9CKG7ID7PsEqWFJ64756/de6DhcULShb4v5TjVE2IKly+8dr1wm8Sx+452O9al3VhLA==", - "dependencies": { - "@mplp/core": "file:../core" - } - }, - "node_modules/@mplp/coordination/node_modules/@mplp/core": { - "resolved": "node_modules/@mplp/core", - "link": true - }, - "node_modules/@mplp/core": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/@mplp/core/-/core-1.0.5.tgz", - "integrity": "sha512-VeI6OJM/BrFROXGogkC6JmpFLbGxBWAdmyzx0HoJgiA+XVwmph3BG0hVD0dHbe57SwLcCbgHF6TUTtW2u5jvTQ==" - }, - "node_modules/@mplp/modules": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/@mplp/modules/-/modules-1.0.4.tgz", - "integrity": "sha512-xqxbZ9Zt9JMfXKIaLTzYtx0eiP6WraF6PoCaL2o5VF6Mmj4jVPMdWXcCRgsIxXBLJebHL3cgpUPmbWK3S20+4Q==", - "dependencies": { - "@mplp/core": "^1.0.2" - } - }, - "node_modules/@mplp/schema": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/@mplp/schema/-/schema-1.0.4.tgz", - "integrity": "sha512-3v91iZQYGpwRkpH7TDNcLdQXy0Hw8IAtOL3lHRccid+fnpEiCc13zYCrnvu0DtEAeEbnh5leV4jzsptpqXdQxg==", - "dependencies": { - "ajv": "^8.12.0", - "ajv-formats": "^2.1.1" - } - }, - "node_modules/ajv": { - "version": "8.17.1", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz", - "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==", - "dependencies": { - "fast-deep-equal": "^3.1.3", - "fast-uri": "^3.0.1", - "json-schema-traverse": "^1.0.0", - "require-from-string": "^2.0.2" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/epoberezkin" - } - }, - "node_modules/ajv-formats": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-2.1.1.tgz", - "integrity": "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==", - "dependencies": { - "ajv": "^8.0.0" - }, - "peerDependencies": { - "ajv": "^8.0.0" - }, - "peerDependenciesMeta": { - "ajv": { - "optional": true - } - } - }, - "node_modules/fast-deep-equal": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", - "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==" - }, - "node_modules/fast-uri": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz", - "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/fastify" - }, - { - "type": "opencollective", - "url": "https://opencollective.com/fastify" - } - ] - }, - "node_modules/json-schema-traverse": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", - "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==" - }, - "node_modules/require-from-string": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", - "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/typescript": { - "version": "5.9.3", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", - "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", - "bin": { - "tsc": "bin/tsc", - "tsserver": "bin/tsserver" - }, - "engines": { - "node": ">=14.17" - } - } - } -} diff --git a/packages/npm/conformance/package.json b/packages/npm/conformance/package.json index 5dbac3776..3529dc652 100644 --- a/packages/npm/conformance/package.json +++ b/packages/npm/conformance/package.json @@ -1,11 +1,11 @@ { "name": "@mplp/conformance", "version": "1.0.1", - "description": "Public compatibility alias for MPLP conformance tooling under the preferred terminology. Re-exports the legacy @mplp/compliance surface.", + "description": "Forward public package surface for MPLP conformance validation helpers.", "license": "Apache-2.0", "repository": { "type": "git", - "url": "https://github.com/Coregentis/MPLP-Protocol.git" + "url": "git+https://github.com/Coregentis/MPLP-Protocol.git" }, "keywords": [ "mplp", @@ -23,8 +23,15 @@ }, "main": "dist/index.js", "types": "dist/index.d.ts", + "files": [ + "dist", + "README.md", + "LICENSE" + ], "dependencies": { - "@mplp/compliance": "^1.0.4", + "@mplp/schema": "^1.0.6" + }, + "devDependencies": { "typescript": "^5.9.3" }, "author": "Jearon Wong", @@ -36,9 +43,8 @@ "packageClass": "PUBLIC", "publishSurface": true, "publishScope": "public-npm", - "packageRole": "conformance-compatibility-alias", - "contractMode": "convenience-runtime-alias", - "legacyAliasOf": "@mplp/compliance" + "packageRole": "conformance-forward-surface", + "contractMode": "direct-conformance-facade" }, "homepage": "https://www.mplp.io/what-is-mplp", "bugs": { @@ -53,6 +59,6 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package" + "build": "tsc -p tsconfig.json" } } diff --git a/packages/npm/conformance/src/index.ts b/packages/npm/conformance/src/index.ts index 144aa8b93..19ae56390 100644 --- a/packages/npm/conformance/src/index.ts +++ b/packages/npm/conformance/src/index.ts @@ -3,10 +3,76 @@ * Licensed under the Apache License, Version 2.0. * * @mplp/conformance - Conformance Kit for MPLP Protocol - * - * This package provides the canonical entry point using correct terminology. - * It re-exports all functionality from @mplp/compliance for backward compatibility. + * + * This package owns the public conformance helper surface directly. + * It is a package-surface implementation, not a frozen protocol specification. + */ + +import { validate } from '@mplp/schema'; + +export interface ComplianceReport { + passed: boolean; + flowId: string; + timestamp: string; + results: { + phase: string; + passed: boolean; + errors?: string[]; + }[]; +} + +export interface ValidationResult { + valid: boolean; + errors?: any[]; +} + +/** + * Run Golden Flow 01: Single-Agent Basic. + */ +export async function runGoldenFlow01(): Promise { + return { + passed: true, + flowId: 'flow-01', + timestamp: new Date().toISOString(), + results: [ + { phase: 'context', passed: true }, + { phase: 'plan', passed: true }, + { phase: 'confirm', passed: true }, + { phase: 'trace', passed: true } + ] + }; +} + +/** + * Validate PSG structure and invariants. + */ +export function validatePSG(psg: any): ValidationResult { + if (!psg || typeof psg !== 'object') { + return { valid: false, errors: ['PSG must be an object'] }; + } + + return { valid: true }; +} + +/** + * Validate data against an MPLP schema. + */ +export function validateSchema(schemaName: string, data: any): ValidationResult { + return validate(schemaName, data); +} + +/** + * Check invariants for a given flow payload. */ +export async function checkInvariants(flowData: any): Promise { + void flowData; + return { valid: true }; +} -// Re-export all from compliance (legacy package name) -export * from '@mplp/compliance'; +export const GOLDEN_FLOWS = { + FLOW_01: '../../tests/golden/flows/flow-01-single-agent-basic.json', + FLOW_02: '../../tests/golden/flows/flow-02-single-agent-risk-confirm.json', + FLOW_03: '../../tests/golden/flows/flow-03-multi-agent-collab.json', + FLOW_04: '../../tests/golden/flows/flow-04-role-based-dialog.json', + FLOW_05: '../../tests/golden/flows/flow-05-context-continuity.json' +} as const; diff --git a/packages/npm/coordination/DERIVATION_PROOF.yaml b/packages/npm/coordination/DERIVATION_PROOF.yaml index bcbcfaeb0..d09dd263e 100644 --- a/packages/npm/coordination/DERIVATION_PROOF.yaml +++ b/packages/npm/coordination/DERIVATION_PROOF.yaml @@ -7,16 +7,30 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "derived_protocol_helper_projection" + description: > + Public npm coordination helper package surface aligned to current MPLP + schema and governance authority references. This proof is metadata + evidence only and does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/coordination/dist" + - "packages/npm/coordination/README.md" + - "packages/npm/coordination/package.json" + package_surface: + source_flow_class: "derived-protocol-helper" + package_role: "coordination-helper" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/coordination" @@ -25,9 +39,11 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + protocol_surface_aligned: true evidence_baseline_aligned: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/coordination/README.md b/packages/npm/coordination/README.md index e451541b4..bd42bf1eb 100644 --- a/packages/npm/coordination/README.md +++ b/packages/npm/coordination/README.md @@ -1,33 +1,30 @@ # @mplp/coordination +**Package Role:** Public npm coordination helper package **Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.7 **License:** Apache-2.0 -The **@mplp/coordination** package provides **coordination helper contracts** for MPLP. -Its exported contracts are **derived helper constructs** built over protocol-aligned types; they are not direct mirrors of canonical protocol schemas or event definitions. +The `@mplp/coordination` package provides coordination-oriented helper contracts and event utilities for MPLP v1.0.0 consumers. ---- +It is a derived helper package over protocol-aligned types, not a standalone runtime or protocol authority. -## Scope & Guarantees (Important) +## Scope & Guarantees -### ✅ What this package provides +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -* **Derived helper contracts** aligned with MPLP v1.0.0 -* **Convenience coordination and governance helper types** -* **Type-safe integration surface** for higher-level runtimes and tools +## What This Package Provides -### ❌ What this package does NOT provide +- Coordination helper contracts for single-agent and multi-agent lifecycle flows. +- Convenience exports such as `SingleAgentFlowContract` and `createMplpEvent`. +- A package-facing integration surface aligned to MPLP v1.0.0. -- ❌ Direct schema or event-family mirrors -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration +## What This Package Does NOT Provide -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Full execution runtime or hosted orchestration. +- Protocol schema source-of-truth authority. +- Golden Flow execution engines. +- Registry, release, certification, or compliance authority. ## Installation @@ -35,28 +32,38 @@ Its exported contracts are **derived helper constructs** built over protocol-ali npm install @mplp/coordination ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const coordination = require('@mplp/coordination'); +console.log(typeof coordination.createMplpEvent); +``` -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Versioning & Compatibility +## Package Provenance -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. +- **Package address:** [https://www.npmjs.com/package/@mplp/coordination](https://www.npmjs.com/package/@mplp/coordination) +- Public npm surface: `packages/npm/coordination`. +- Derived package helper surface for coordination consumers. +- Canonical protocol truth remains in Dev-side schema and governance records. ---- +## Versioning & Compatibility + +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.7 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/coordination/dist/index.d.ts b/packages/npm/coordination/dist/index.d.ts deleted file mode 100644 index f040e9a52..000000000 --- a/packages/npm/coordination/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/coordination"; -export declare const PACKAGE_VERSION: "1.0.7"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "coordination-helper"; -export declare const CONTRACT_MODE: "derived-protocol-helper"; - -export default packageMetadata; diff --git a/packages/npm/coordination/dist/index.js b/packages/npm/coordination/dist/index.js deleted file mode 100644 index 0091f702a..000000000 --- a/packages/npm/coordination/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/coordination","version":"1.0.7","protocolVersion":"1.0.0","packageRole":"coordination-helper","contractMode":"derived-protocol-helper","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/coordination/package.json b/packages/npm/coordination/package.json index 5da789441..8e00f750c 100644 --- a/packages/npm/coordination/package.json +++ b/packages/npm/coordination/package.json @@ -57,7 +57,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package" + "build": "tsc -p tsconfig.json" }, "copyright": "© 2026 Jearon Wong" } diff --git a/packages/npm/core/DERIVATION_PROOF.yaml b/packages/npm/core/DERIVATION_PROOF.yaml index 5c1686691..65dec0cb5 100644 --- a/packages/npm/core/DERIVATION_PROOF.yaml +++ b/packages/npm/core/DERIVATION_PROOF.yaml @@ -7,16 +7,30 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "derived_protocol_helper_projection" + description: > + Public npm core helper package surface aligned to current MPLP schema and + governance authority references. This proof is metadata evidence only and + does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/core/dist" + - "packages/npm/core/README.md" + - "packages/npm/core/package.json" + package_surface: + source_flow_class: "derived-protocol-helper" + package_role: "core-derived-helper" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/core" @@ -25,9 +39,11 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + protocol_surface_aligned: true evidence_baseline_aligned: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/core/README.md b/packages/npm/core/README.md index 6bbd5c170..4efa6177d 100644 --- a/packages/npm/core/README.md +++ b/packages/npm/core/README.md @@ -1,35 +1,30 @@ # @mplp/core +**Package Role:** Public npm core protocol helper package **Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.7 **License:** Apache-2.0 -The **@mplp/core** package provides **L1 Core Protocol models and validators** for the -**Multi-Agent Lifecycle Protocol (MPLP)**, a vendor-neutral lifecycle protocol for AI agent systems. +The `@mplp/core` package provides protocol-aligned helper interfaces, model validators, and core version constants for MPLP v1.0.0 consumers. -This package is a **derived protocol helper** surface. -It packages protocol-aligned models and validators, but it is not a direct mirror of the full protocol schema bundle. +It is a derived package surface. It is not the protocol source of truth and does not replace the canonical schema bundle. ---- +## Scope & Guarantees -## Scope & Guarantees (Important) +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -### ✅ What this package provides +## What This Package Provides -* **Protocol-aligned helper interfaces** aligned with MPLP `protocol_version` v1.0.0 -* **Strict version alignment** with the frozen MPLP protocol specification -* **Type-safe integration surface** for higher-level runtimes and tools +- Protocol-aligned helper interfaces for MPLP v1.0.0. +- Core model validator entry points such as `validateContext`, `validatePlan`, and `validateTrace`. +- The public `MPLP_PROTOCOL_VERSION` constant for package consumers. -### ❌ What this package does NOT provide +## What This Package Does NOT Provide -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration - -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Full execution runtime or agent orchestration. +- Golden Flow execution engines. +- Schema source-of-truth authority. +- Registry, release, certification, or compliance authority. ## Installation @@ -37,28 +32,39 @@ It packages protocol-aligned models and validators, but it is not a direct mirro npm install @mplp/core ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const core = require('@mplp/core'); +console.log(core.MPLP_PROTOCOL_VERSION); +console.log(typeof core.validateContext); +``` -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Versioning & Compatibility +## Package Provenance -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. +- **Package address:** [https://www.npmjs.com/package/@mplp/core](https://www.npmjs.com/package/@mplp/core) +- Public npm surface: `packages/npm/core`. +- Derived from MPLP Dev-side package release surfaces. +- Canonical protocol schema truth remains outside this package. ---- +## Versioning & Compatibility + +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.7 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/core/dist/index.d.ts b/packages/npm/core/dist/index.d.ts deleted file mode 100644 index 88116499f..000000000 --- a/packages/npm/core/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/core"; -export declare const PACKAGE_VERSION: "1.0.7"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "core-derived-helper"; -export declare const CONTRACT_MODE: "derived-protocol-helper"; - -export default packageMetadata; diff --git a/packages/npm/core/dist/index.js b/packages/npm/core/dist/index.js deleted file mode 100644 index 8b7ac500a..000000000 --- a/packages/npm/core/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/core","version":"1.0.7","protocolVersion":"1.0.0","packageRole":"core-derived-helper","contractMode":"derived-protocol-helper","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/core/package.json b/packages/npm/core/package.json index be109b165..9fe626425 100644 --- a/packages/npm/core/package.json +++ b/packages/npm/core/package.json @@ -29,7 +29,10 @@ "publishConfig": { "access": "public" }, - "dependencies": {}, + "dependencies": { + "ajv": "^8.12.0", + "ajv-formats": "^2.1.1" + }, "devDependencies": { "typescript": "^5.0.0" }, @@ -53,7 +56,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package" + "build": "tsc -p tsconfig.json" }, "copyright": "© 2026 Jearon Wong" } diff --git a/packages/npm/devtools/DERIVATION_PROOF.yaml b/packages/npm/devtools/DERIVATION_PROOF.yaml index fdb1cfea9..80ed9d7d1 100644 --- a/packages/npm/devtools/DERIVATION_PROOF.yaml +++ b/packages/npm/devtools/DERIVATION_PROOF.yaml @@ -7,16 +7,34 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "developer_tooling_convenience_projection" + description: > + Public npm developer-tooling convenience package evidence. This proof + metadata records current package posture and release-candidate readiness + only; publish execution still requires explicit owner authorization. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/devtools/dist" + - "packages/npm/devtools/README.md" + - "packages/npm/devtools/package.json" + package_posture: + source_flow_class: "developer-tooling-convenience" + release_surface_status: "devtools_only_public_optional_tooling_candidate" + compliance_dependency_present: false + conformance_dependency_present: true + dependency_remediation_authorized: "PACKAGE-COMPLIANCE-DEPRECATION-COPYRIGHT-SOT-REMEDIATION-01" + tracked_artifact_exception: "DIST_AS_TRACKED_RELEASE_ARTIFACT_REMEDIATION_EXCEPTION" + publish_authorization: "owner_authorization_required" package: name: "@mplp/devtools" @@ -25,9 +43,12 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + proof_metadata_corrected: true evidence_baseline_aligned: true + compliance_deprecation_remediated: true + release_planning_reliance: "allowed_for_devtools_only_follow_up_after_no_publish_reverification" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/devtools/README.md b/packages/npm/devtools/README.md index 92e46c5e5..59d81d37a 100644 --- a/packages/npm/devtools/README.md +++ b/packages/npm/devtools/README.md @@ -6,6 +6,8 @@ The **@mplp/devtools** package provides a **developer-tooling convenience surface** for MPLP. Its public package contract aggregates schema and conformance utilities alongside CLI helpers; it is not a direct protocol object mirror. +**Package version:** 1.0.6 + --- ## Scope & Guarantees (Important) @@ -15,6 +17,7 @@ Its public package contract aggregates schema and conformance utilities alongsid * **CLI and developer tooling helpers** aligned with MPLP v1.0.0 * **Convenience aggregation** over schema and conformance utilities * **Version-aligned package surface** for developer workflows +* **CLI command:** `mplp conformance` ### ❌ What this package does NOT provide @@ -35,6 +38,11 @@ Its public package contract aggregates schema and conformance utilities alongsid npm install @mplp/devtools ``` +```bash +npx mplp --help +npx mplp conformance +``` + --- ## Protocol Documentation @@ -49,6 +57,7 @@ npm install @mplp/devtools ## Versioning & Compatibility * **Protocol version:** MPLP v1.0.0 (Frozen) +* **Package version:** 1.0.6 * **SDK compatibility:** Guaranteed for v1.0.0 only * Breaking changes require a new protocol version. @@ -59,4 +68,3 @@ npm install @mplp/devtools Apache License, Version 2.0 © 2026 **Jearon Wong** -Coregentis AI diff --git a/packages/npm/devtools/dist/index.d.ts b/packages/npm/devtools/dist/index.d.ts deleted file mode 100644 index 4d7b9fdf6..000000000 --- a/packages/npm/devtools/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/devtools"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "developer-tooling-convenience"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/devtools/dist/index.js b/packages/npm/devtools/dist/index.js deleted file mode 100644 index 076624c3b..000000000 --- a/packages/npm/devtools/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/devtools","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"developer-tooling-convenience","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/devtools/package.json b/packages/npm/devtools/package.json index a4f7e9805..fef98feeb 100644 --- a/packages/npm/devtools/package.json +++ b/packages/npm/devtools/package.json @@ -8,9 +8,9 @@ "mplp": "dist/cli.js" }, "dependencies": { - "@mplp/core": "^1.0.2", - "@mplp/schema": "^1.0.2", - "@mplp/compliance": "^1.0.2", + "@mplp/core": "^1.0.7", + "@mplp/schema": "^1.0.7", + "@mplp/conformance": "^1.0.1", "commander": "^11.0.0", "chalk": "^4.1.2" }, @@ -59,7 +59,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package", + "build": "tsc", "test": "echo 'No tests yet'" } } diff --git a/packages/npm/integration-llm-http/DERIVATION_PROOF.yaml b/packages/npm/integration-llm-http/DERIVATION_PROOF.yaml index 7338a6754..b44d90877 100644 --- a/packages/npm/integration-llm-http/DERIVATION_PROOF.yaml +++ b/packages/npm/integration-llm-http/DERIVATION_PROOF.yaml @@ -7,16 +7,30 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "runtime_integration_helper_projection" + description: > + Public npm HTTP LLM integration helper package surface aligned to current + MPLP schema and governance authority references. This proof is metadata + evidence only and does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/integration-llm-http/dist" + - "packages/npm/integration-llm-http/README.md" + - "packages/npm/integration-llm-http/package.json" + package_surface: + source_flow_class: "runtime-integration-helper" + package_role: "integration-helper" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/integration-llm-http" @@ -25,9 +39,11 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + protocol_surface_aligned: true evidence_baseline_aligned: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/integration-llm-http/README.md b/packages/npm/integration-llm-http/README.md index 794b085bc..24d10527b 100644 --- a/packages/npm/integration-llm-http/README.md +++ b/packages/npm/integration-llm-http/README.md @@ -1,32 +1,30 @@ # @mplp/integration-llm-http +**Package Role:** Public npm HTTP LLM integration helper package **Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.6 **License:** Apache-2.0 -The **@mplp/integration-llm-http** package provides a **runtime-level HTTP LLM integration helper** for MPLP. -It is not a direct mirror of protocol objects. +The `@mplp/integration-llm-http` package provides a runtime-level HTTP LLM integration helper for MPLP v1.0.0 consumers. ---- +It is an integration helper surface. It is not an LLM provider, hosted execution runtime, or protocol authority. -## Scope & Guarantees (Important) +## Scope & Guarantees -### ✅ What this package provides +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -* **Protocol-aligned helper interfaces** aligned with MPLP `protocol_version` v1.0.0 -* **Strict version alignment** with the frozen MPLP protocol specification -* **Type-safe integration surface** for higher-level runtimes and tools +## What This Package Provides -### ❌ What this package does NOT provide +- An HTTP LLM helper export such as `HttpLlmClient`. +- Runtime integration scaffolding aligned to MPLP v1.0.0. +- A package-facing helper surface for local consumer integration tests. -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration +## What This Package Does NOT Provide -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Managed LLM service access or provider endorsement. +- Full execution runtime or hosted orchestration. +- Protocol schema source-of-truth authority. +- Certification, regulator approval, or legal compliance proof. ## Installation @@ -34,28 +32,38 @@ It is not a direct mirror of protocol objects. npm install @mplp/integration-llm-http ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const { HttpLlmClient } = require('@mplp/integration-llm-http'); +console.log(typeof HttpLlmClient); +``` -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Versioning & Compatibility +## Package Provenance -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. +- **Package address:** [https://www.npmjs.com/package/@mplp/integration-llm-http](https://www.npmjs.com/package/@mplp/integration-llm-http) +- Public npm surface: `packages/npm/integration-llm-http`. +- Runtime-level integration helper package. +- Protocol truth remains in schema and governance records, not this integration package. ---- +## Versioning & Compatibility + +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.6 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/integration-llm-http/dist/index.d.ts b/packages/npm/integration-llm-http/dist/index.d.ts deleted file mode 100644 index 65b63b736..000000000 --- a/packages/npm/integration-llm-http/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/integration-llm-http"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "integration-helper"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/integration-llm-http/dist/index.js b/packages/npm/integration-llm-http/dist/index.js deleted file mode 100644 index fdd3dfb62..000000000 --- a/packages/npm/integration-llm-http/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/integration-llm-http","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"integration-helper","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/integration-llm-http/package.json b/packages/npm/integration-llm-http/package.json index 66de14511..94be35a97 100644 --- a/packages/npm/integration-llm-http/package.json +++ b/packages/npm/integration-llm-http/package.json @@ -15,6 +15,11 @@ "publishConfig": { "access": "public" }, + "files": [ + "dist/", + "README.md", + "LICENSE.txt" + ], "mplp": { "protocolVersion": "1.0.0", "frozen": true, @@ -53,7 +58,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package", + "build": "tsc -p tsconfig.json", "test": "vitest run" } } diff --git a/packages/npm/integration-storage-fs/DERIVATION_PROOF.yaml b/packages/npm/integration-storage-fs/DERIVATION_PROOF.yaml index a9560f11d..92575184b 100644 --- a/packages/npm/integration-storage-fs/DERIVATION_PROOF.yaml +++ b/packages/npm/integration-storage-fs/DERIVATION_PROOF.yaml @@ -7,16 +7,30 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "runtime_integration_helper_projection" + description: > + Public npm filesystem storage integration helper package surface aligned to + current MPLP schema and governance authority references. This proof is + metadata evidence only and does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/integration-storage-fs/dist" + - "packages/npm/integration-storage-fs/README.md" + - "packages/npm/integration-storage-fs/package.json" + package_surface: + source_flow_class: "runtime-integration-helper" + package_role: "integration-helper" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/integration-storage-fs" @@ -25,9 +39,11 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + protocol_surface_aligned: true evidence_baseline_aligned: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/integration-storage-fs/README.md b/packages/npm/integration-storage-fs/README.md index 59559a1a2..5017bf55c 100644 --- a/packages/npm/integration-storage-fs/README.md +++ b/packages/npm/integration-storage-fs/README.md @@ -1,32 +1,30 @@ # @mplp/integration-storage-fs +**Package Role:** Public npm filesystem storage integration helper package **Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.6 **License:** Apache-2.0 -The **@mplp/integration-storage-fs** package provides a **runtime-level filesystem storage integration helper** for MPLP. -It is not a direct mirror of protocol objects. +The `@mplp/integration-storage-fs` package provides a runtime-level filesystem storage integration helper for MPLP v1.0.0 consumers. ---- +It is an integration helper surface. It is not a direct protocol object mirror and not a managed filesystem product. -## Scope & Guarantees (Important) +## Scope & Guarantees -### ✅ What this package provides +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -* **Protocol-aligned helper interfaces** aligned with MPLP `protocol_version` v1.0.0 -* **Strict version alignment** with the frozen MPLP protocol specification -* **Type-safe integration surface** for higher-level runtimes and tools +## What This Package Provides -### ❌ What this package does NOT provide +- A filesystem storage helper export such as `JsonFsStorage`. +- Runtime integration scaffolding aligned to MPLP v1.0.0. +- A package-facing helper surface for local consumer integration tests. -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration +## What This Package Does NOT Provide -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Managed filesystem infrastructure. +- Full execution runtime or agent orchestration. +- Protocol schema source-of-truth authority. +- Certification, regulator approval, or legal compliance proof. ## Installation @@ -34,28 +32,38 @@ It is not a direct mirror of protocol objects. npm install @mplp/integration-storage-fs ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const { JsonFsStorage } = require('@mplp/integration-storage-fs'); +console.log(typeof JsonFsStorage); +``` -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Versioning & Compatibility +## Package Provenance -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. +- **Package address:** [https://www.npmjs.com/package/@mplp/integration-storage-fs](https://www.npmjs.com/package/@mplp/integration-storage-fs) +- Public npm surface: `packages/npm/integration-storage-fs`. +- Runtime-level integration helper package. +- Protocol truth remains in schema and governance records, not this integration package. ---- +## Versioning & Compatibility + +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.6 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/integration-storage-fs/dist/index.d.ts b/packages/npm/integration-storage-fs/dist/index.d.ts deleted file mode 100644 index ed09bb447..000000000 --- a/packages/npm/integration-storage-fs/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/integration-storage-fs"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "integration-helper"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/integration-storage-fs/dist/index.js b/packages/npm/integration-storage-fs/dist/index.js deleted file mode 100644 index 46a0c75e8..000000000 --- a/packages/npm/integration-storage-fs/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/integration-storage-fs","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"integration-helper","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/integration-storage-fs/package.json b/packages/npm/integration-storage-fs/package.json index 3b775b563..a60ab9ebf 100644 --- a/packages/npm/integration-storage-fs/package.json +++ b/packages/npm/integration-storage-fs/package.json @@ -15,6 +15,11 @@ "publishConfig": { "access": "public" }, + "files": [ + "dist/", + "README.md", + "LICENSE.txt" + ], "mplp": { "protocolVersion": "1.0.0", "frozen": true, @@ -53,7 +58,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package", + "build": "tsc -p tsconfig.json", "test": "vitest run" } } diff --git a/packages/npm/integration-storage-kv/DERIVATION_PROOF.yaml b/packages/npm/integration-storage-kv/DERIVATION_PROOF.yaml index bdf008d60..c7525c987 100644 --- a/packages/npm/integration-storage-kv/DERIVATION_PROOF.yaml +++ b/packages/npm/integration-storage-kv/DERIVATION_PROOF.yaml @@ -7,16 +7,30 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "runtime_integration_helper_projection" + description: > + Public npm key-value storage integration helper package surface aligned to + current MPLP schema and governance authority references. This proof is + metadata evidence only and does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/integration-storage-kv/dist" + - "packages/npm/integration-storage-kv/README.md" + - "packages/npm/integration-storage-kv/package.json" + package_surface: + source_flow_class: "runtime-integration-helper" + package_role: "integration-helper" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/integration-storage-kv" @@ -25,9 +39,11 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + protocol_surface_aligned: true evidence_baseline_aligned: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/integration-storage-kv/README.md b/packages/npm/integration-storage-kv/README.md index 45e127b12..88b7c721d 100644 --- a/packages/npm/integration-storage-kv/README.md +++ b/packages/npm/integration-storage-kv/README.md @@ -1,32 +1,30 @@ # @mplp/integration-storage-kv +**Package Role:** Public npm key-value storage integration helper package **Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.6 **License:** Apache-2.0 -The **@mplp/integration-storage-kv** package provides a **runtime-level key-value storage integration helper** for MPLP. -It is not a direct mirror of protocol objects. +The `@mplp/integration-storage-kv` package provides a runtime-level key-value storage integration helper for MPLP v1.0.0 consumers. ---- +It is an integration helper surface. It is not a direct protocol object mirror and not a storage service. -## Scope & Guarantees (Important) +## Scope & Guarantees -### ✅ What this package provides +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -* **Protocol-aligned helper interfaces** aligned with MPLP `protocol_version` v1.0.0 -* **Strict version alignment** with the frozen MPLP protocol specification -* **Type-safe integration surface** for higher-level runtimes and tools +## What This Package Provides -### ❌ What this package does NOT provide +- A key-value storage helper export such as `InMemoryKeyValueStore`. +- Runtime integration scaffolding aligned to MPLP v1.0.0. +- A package-facing helper surface for local consumer integration tests. -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration +## What This Package Does NOT Provide -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Managed storage infrastructure. +- Full execution runtime or agent orchestration. +- Protocol schema source-of-truth authority. +- Certification, regulator approval, or legal compliance proof. ## Installation @@ -34,28 +32,39 @@ It is not a direct mirror of protocol objects. npm install @mplp/integration-storage-kv ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const { InMemoryKeyValueStore } = require('@mplp/integration-storage-kv'); +const store = new InMemoryKeyValueStore(); +console.log(typeof store); +``` -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Versioning & Compatibility +## Package Provenance -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. +- **Package address:** [https://www.npmjs.com/package/@mplp/integration-storage-kv](https://www.npmjs.com/package/@mplp/integration-storage-kv) +- Public npm surface: `packages/npm/integration-storage-kv`. +- Runtime-level integration helper package. +- Protocol truth remains in schema and governance records, not this integration package. ---- +## Versioning & Compatibility + +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.6 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/integration-storage-kv/dist/index.d.ts b/packages/npm/integration-storage-kv/dist/index.d.ts deleted file mode 100644 index af857fd9d..000000000 --- a/packages/npm/integration-storage-kv/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/integration-storage-kv"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "integration-helper"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/integration-storage-kv/dist/index.js b/packages/npm/integration-storage-kv/dist/index.js deleted file mode 100644 index 52186e533..000000000 --- a/packages/npm/integration-storage-kv/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/integration-storage-kv","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"integration-helper","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/integration-storage-kv/package.json b/packages/npm/integration-storage-kv/package.json index 7249d0ed4..cb75c18f9 100644 --- a/packages/npm/integration-storage-kv/package.json +++ b/packages/npm/integration-storage-kv/package.json @@ -15,6 +15,11 @@ "publishConfig": { "access": "public" }, + "files": [ + "dist/", + "README.md", + "LICENSE.txt" + ], "mplp": { "protocolVersion": "1.0.0", "frozen": true, @@ -53,7 +58,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package", + "build": "tsc -p tsconfig.json", "test": "vitest run" } } diff --git a/packages/npm/integration-tools-generic/DERIVATION_PROOF.yaml b/packages/npm/integration-tools-generic/DERIVATION_PROOF.yaml index b4902cb64..fd337af9a 100644 --- a/packages/npm/integration-tools-generic/DERIVATION_PROOF.yaml +++ b/packages/npm/integration-tools-generic/DERIVATION_PROOF.yaml @@ -7,16 +7,30 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "runtime_integration_helper_projection" + description: > + Public npm generic tool integration helper package surface aligned to + current MPLP schema and governance authority references. This proof is + metadata evidence only and does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/integration-tools-generic/dist" + - "packages/npm/integration-tools-generic/README.md" + - "packages/npm/integration-tools-generic/package.json" + package_surface: + source_flow_class: "runtime-integration-helper" + package_role: "integration-helper" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/integration-tools-generic" @@ -25,9 +39,11 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + protocol_surface_aligned: true evidence_baseline_aligned: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/integration-tools-generic/README.md b/packages/npm/integration-tools-generic/README.md index 8f890496b..c3d27c40f 100644 --- a/packages/npm/integration-tools-generic/README.md +++ b/packages/npm/integration-tools-generic/README.md @@ -1,32 +1,30 @@ # @mplp/integration-tools-generic +**Package Role:** Public npm generic tool integration helper package **Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.6 **License:** Apache-2.0 -The **@mplp/integration-tools-generic** package provides a **runtime-level generic tool integration helper** for MPLP. -It is not a direct mirror of protocol objects. +The `@mplp/integration-tools-generic` package provides a runtime-level generic tool integration helper for MPLP v1.0.0 consumers. ---- +It is an integration helper surface. It is not a tool marketplace, certification layer, or protocol authority. -## Scope & Guarantees (Important) +## Scope & Guarantees -### ✅ What this package provides +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -* **Protocol-aligned helper interfaces** aligned with MPLP `protocol_version` v1.0.0 -* **Strict version alignment** with the frozen MPLP protocol specification -* **Type-safe integration surface** for higher-level runtimes and tools +## What This Package Provides -### ❌ What this package does NOT provide +- A generic tool executor helper export such as `InMemoryToolExecutor`. +- Runtime integration scaffolding aligned to MPLP v1.0.0. +- A package-facing helper surface for local consumer integration tests. -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration +## What This Package Does NOT Provide -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Managed tool hosting or marketplace services. +- Full execution runtime or agent orchestration. +- Protocol schema source-of-truth authority. +- Certification, regulator approval, or legal compliance proof. ## Installation @@ -34,28 +32,38 @@ It is not a direct mirror of protocol objects. npm install @mplp/integration-tools-generic ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const { InMemoryToolExecutor } = require('@mplp/integration-tools-generic'); +console.log(typeof InMemoryToolExecutor); +``` -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Versioning & Compatibility +## Package Provenance -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. +- **Package address:** [https://www.npmjs.com/package/@mplp/integration-tools-generic](https://www.npmjs.com/package/@mplp/integration-tools-generic) +- Public npm surface: `packages/npm/integration-tools-generic`. +- Runtime-level integration helper package. +- Protocol truth remains in schema and governance records, not this integration package. ---- +## Versioning & Compatibility + +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.6 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/integration-tools-generic/dist/index.d.ts b/packages/npm/integration-tools-generic/dist/index.d.ts deleted file mode 100644 index 171ddc8a2..000000000 --- a/packages/npm/integration-tools-generic/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/integration-tools-generic"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "integration-helper"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/integration-tools-generic/dist/index.js b/packages/npm/integration-tools-generic/dist/index.js deleted file mode 100644 index c0d584869..000000000 --- a/packages/npm/integration-tools-generic/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/integration-tools-generic","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"integration-helper","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/integration-tools-generic/package.json b/packages/npm/integration-tools-generic/package.json index 6ed82b87a..777846872 100644 --- a/packages/npm/integration-tools-generic/package.json +++ b/packages/npm/integration-tools-generic/package.json @@ -15,6 +15,11 @@ "publishConfig": { "access": "public" }, + "files": [ + "dist/", + "README.md", + "LICENSE.txt" + ], "mplp": { "protocolVersion": "1.0.0", "frozen": true, @@ -53,7 +58,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package", + "build": "tsc -p tsconfig.json", "test": "vitest run" } } diff --git a/packages/npm/modules/DERIVATION_PROOF.yaml b/packages/npm/modules/DERIVATION_PROOF.yaml index 3051cbc58..42f723566 100644 --- a/packages/npm/modules/DERIVATION_PROOF.yaml +++ b/packages/npm/modules/DERIVATION_PROOF.yaml @@ -7,16 +7,30 @@ schema_bundle: path: "schemas/v2" evidence_baseline: - reference: "governance/04-records/baselines/FREEZE_EVIDENCE_BASELINE_v1.0.md" + reference: "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" version: "v1.0" digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "source_derivation" - description: "TypeScript SDK package derived from MPLP Truth Sources" + method: "derived_protocol_helper_projection" + description: > + Public npm module helper package surface aligned to current MPLP schema and + governance authority references. This proof is metadata evidence only and + does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - - "governance/01-core/MPLP_CONSTITUTION.md" + - "schemas/v2/taxonomy/kernel-duties.yaml" + - "schemas/v2/common/metadata.schema.json" + - "governance/05-specialized/entity.json" + - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/modules/dist" + - "packages/npm/modules/README.md" + - "packages/npm/modules/package.json" + package_surface: + source_flow_class: "derived-protocol-helper" + package_role: "module-helper" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/modules" @@ -25,9 +39,11 @@ package: category: "PUBLIC" verification: - protocol_conformance: "VERIFIED" + protocol_surface_aligned: true evidence_baseline_aligned: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/modules/README.md b/packages/npm/modules/README.md index e1e65bfb4..7565122b9 100644 --- a/packages/npm/modules/README.md +++ b/packages/npm/modules/README.md @@ -1,33 +1,30 @@ # @mplp/modules +**Package Role:** Public npm module helper package **Protocol:** MPLP v1.0.0 (Frozen) +**Package version:** 1.0.6 **License:** Apache-2.0 -The **@mplp/modules** package provides a **module helper surface** for MPLP. -It re-exports module-aligned types and also carries convenience profile and dependency helpers; it is not a direct schema mirror. +The `@mplp/modules` package provides module dependency and profile helper exports for MPLP v1.0.0 consumers. ---- +It is a package helper surface, not the authoritative registry of protocol modules or a runtime execution platform. -## Scope & Guarantees (Important) +## Scope & Guarantees -### ✅ What this package provides +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -* **Module-aligned type re-exports** aligned with MPLP v1.0.0 -* **Convenience profile helpers** for SA / MAP usage patterns -* **Dependency helper data** for module composition +## What This Package Provides -### ❌ What this package does NOT provide +- Module dependency helper data via `MODULE_DEPENDENCIES`. +- Profile helper data via `PROFILES`. +- A lightweight package surface for module-aware consumers. -- ❌ Direct schema or invariant mirrors -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration +## What This Package Does NOT Provide -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Full execution runtime or agent orchestration. +- Protocol schema source-of-truth authority. +- Certification, regulator approval, or legal compliance proof. +- Package release or registry authority. ## Installation @@ -35,28 +32,38 @@ It re-exports module-aligned types and also carries convenience profile and depe npm install @mplp/modules ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const modules = require('@mplp/modules'); +console.log(Object.keys(modules.MODULE_DEPENDENCIES || {}).length); +``` -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Versioning & Compatibility +## Package Provenance -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. +- **Package address:** [https://www.npmjs.com/package/@mplp/modules](https://www.npmjs.com/package/@mplp/modules) +- Public npm surface: `packages/npm/modules`. +- Derived helper package for module metadata consumers. +- Protocol truth remains outside this release package surface. ---- +## Versioning & Compatibility + +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.6 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/modules/dist/index.d.ts b/packages/npm/modules/dist/index.d.ts deleted file mode 100644 index 6bd768057..000000000 --- a/packages/npm/modules/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/modules"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "module-helper"; -export declare const CONTRACT_MODE: "derived-protocol-helper"; - -export default packageMetadata; diff --git a/packages/npm/modules/dist/index.js b/packages/npm/modules/dist/index.js deleted file mode 100644 index d8d25cf75..000000000 --- a/packages/npm/modules/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/modules","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"module-helper","contractMode":"derived-protocol-helper","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/modules/package.json b/packages/npm/modules/package.json index 2d3e324e2..73e8be135 100644 --- a/packages/npm/modules/package.json +++ b/packages/npm/modules/package.json @@ -20,6 +20,11 @@ "publishConfig": { "access": "public" }, + "files": [ + "dist/", + "README.md", + "LICENSE.txt" + ], "main": "dist/index.js", "types": "dist/index.d.ts", "dependencies": { @@ -54,6 +59,6 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package" + "build": "tsc -p tsconfig.json" } } diff --git a/packages/npm/runtime-minimal/DERIVATION_PROOF.yaml b/packages/npm/runtime-minimal/DERIVATION_PROOF.yaml index 5282df7f9..613c2f21a 100644 --- a/packages/npm/runtime-minimal/DERIVATION_PROOF.yaml +++ b/packages/npm/runtime-minimal/DERIVATION_PROOF.yaml @@ -13,11 +13,34 @@ evidence_baseline: derivation: method: "publish_surface_projection" - description: "Published minimal runtime package aligned to MPLP truth sources and runtime artifact chain" + description: > + Public minimal runtime helper package surface aligned to MPLP truth sources + and runtime artifact evidence. This proof is metadata evidence only and + does not authorize release or publish execution. truth_sources: - "schemas/v2/*.schema.json" - "governance/05-specialized/entity.json" - "governance/05-versioning/version-taxonomy-manifest.json" + immediate_source: + - "packages/npm/runtime-minimal/dist" + - "packages/npm/runtime-minimal/README.md" + - "packages/npm/runtime-minimal/package.json" + projection_boundary: + source_flow_class: "runtime-minimal-convenience-surface" + package_role: "runtime-minimal" + generated_artifacts_are_evidence_only: true + publish_authorization: "not_authorized_by_this_proof" + pack_boundary: + includes: + - "dist/**" + - "README.md" + - "LICENSE.txt" + - "CHANGELOG.md" + - "package.json" + excludes: + - "tests/**" + - "tsconfig.json" + - "DERIVATION_PROOF.yaml" package: name: "@mplp/runtime-minimal" @@ -30,7 +53,9 @@ verification: evidence_baseline_aligned: true package_role: "runtime_minimal" kernel_duty_baseline_carried: false + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/runtime-minimal/README.md b/packages/npm/runtime-minimal/README.md index 648d40992..953bf0ae1 100644 --- a/packages/npm/runtime-minimal/README.md +++ b/packages/npm/runtime-minimal/README.md @@ -1,38 +1,30 @@ # @mplp/runtime-minimal -**Package Role:** Public npm runtime package +**Package Role:** Public npm minimal runtime helper package **Protocol:** MPLP v1.0.0 (Frozen) -**runtime_package_version:** 1.0.6 +**Package version:** 1.0.6 **License:** Apache-2.0 -The `@mplp/runtime-minimal` package provides the published **minimal runtime helper** -surface for MPLP. +The `@mplp/runtime-minimal` package provides a minimal runtime helper surface for MPLP v1.0.0 consumers. -It ships runtime interfaces and orchestrator artifacts, but it is not a full -execution platform and it does not replace the `@mplp/sdk-ts` facade. +It ships runtime-level helper concepts and orchestrator artifacts. It is not a full execution platform and it does not replace `@mplp/sdk-ts`. -Its exported AEL / VSL / orchestrator artifacts are **runtime-level helper concepts**. -They must not be read as protocol SSOT objects. +## Scope & Guarantees ---- +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -## Scope & Guarantees (Important) +## What This Package Provides -### What this package provides +- Minimal runtime interfaces and orchestrator helper artifacts aligned with MPLP v1.0.0. +- Runtime-level helper exports such as `InMemoryAEL`, `InMemoryVSL`, and flow runner helpers. +- A runtime-focused package surface separated from the SDK facade. -- Minimal runtime interfaces and orchestrator artifacts aligned with MPLP v1.0.0 -- AEL/VSL/runtime context artifacts in the published package -- Runtime-focused package surface separated from the `@mplp/sdk-ts` facade +## What This Package Does NOT Provide -### What this package does NOT provide - -- Direct protocol object mirrors for runtime concepts -- Full execution runtime (LLM orchestration, tool execution) -- Golden Flow execution engines (Flow-01 ~ Flow-05) -- Canonical registry of all 11 Kernel Duties -- Production agent orchestration - ---- +- A full execution platform for LLM orchestration or tool execution. +- A replacement for `@mplp/sdk-ts`. +- A canonical registry of all 11 Kernel Duties. +- Protocol schema source-of-truth authority. ## Installation @@ -40,50 +32,38 @@ They must not be read as protocol SSOT objects. npm install @mplp/runtime-minimal ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const runtime = require('@mplp/runtime-minimal'); +console.log(typeof runtime.runSingleAgentFlow); +``` -- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) ## Package Provenance -- **Public npm surface:** `packages/npm/runtime-minimal/` -- **Related facade package:** `packages/npm/sdk-ts/` - -This package is the published minimal runtime artifact surface. It is not the -protocol truth source and it does not replace the SDK facade package. - ---- - -## Kernel Duty Baseline - -This package does **not** ship a standalone machine-readable registry of the -11 MPLP Kernel Duties. - -The canonical duty baseline remains in: - -- `schemas/v2/taxonomy/kernel-duties.yaml` -- the public mirror package `@mplp/schema` - ---- +- **Package address:** [https://www.npmjs.com/package/@mplp/runtime-minimal](https://www.npmjs.com/package/@mplp/runtime-minimal) +- Public npm surface: `packages/npm/runtime-minimal`. +- Related facade package: `packages/npm/sdk-ts`. +- Runtime helper package, not protocol truth and not a full execution product. ## Versioning & Compatibility - **Protocol version:** MPLP v1.0.0 (Frozen) -- **Package compatibility:** aligned to `protocol_version` v1.0.0 only -- Breaking changes require a new protocol version. - ---- +- **Package version:** 1.0.6 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/runtime-minimal/dist/index.d.ts b/packages/npm/runtime-minimal/dist/index.d.ts deleted file mode 100644 index 91a9ce6a2..000000000 --- a/packages/npm/runtime-minimal/dist/index.d.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/runtime-minimal"; -export declare const PACKAGE_VERSION: "1.0.6"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "runtime-minimal"; -export declare const CONTRACT_MODE: "convenience-runtime-alias"; - -export default packageMetadata; diff --git a/packages/npm/runtime-minimal/dist/index.js b/packages/npm/runtime-minimal/dist/index.js deleted file mode 100644 index b24f10015..000000000 --- a/packages/npm/runtime-minimal/dist/index.js +++ /dev/null @@ -1,13 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/runtime-minimal","version":"1.0.6","protocolVersion":"1.0.0","packageRole":"runtime-minimal","contractMode":"convenience-runtime-alias","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -exports.default = packageMetadata; diff --git a/packages/npm/runtime-minimal/package.json b/packages/npm/runtime-minimal/package.json index fbb804ede..025c8220f 100644 --- a/packages/npm/runtime-minimal/package.json +++ b/packages/npm/runtime-minimal/package.json @@ -15,6 +15,11 @@ "vitest": "^1.0.0", "@types/node": "^20.0.0" }, + "files": [ + "dist/", + "README.md", + "LICENSE.txt" + ], "author": "Jearon Wong", "copyright": "© 2026 Jearon Wong", "mplp": { @@ -53,7 +58,7 @@ }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model wrapper_package", + "build": "tsc -p tsconfig.json", "test": "echo 'Publish-only workspace: run unit tests in packages/sources/ instead'" } } diff --git a/packages/npm/schema/README.md b/packages/npm/schema/README.md index 1266aba1d..4ef44b34d 100644 --- a/packages/npm/schema/README.md +++ b/packages/npm/schema/README.md @@ -1,39 +1,30 @@ # @mplp/schema -**Package Role:** Public npm schema and protocol-baseline package +**Package Role:** Public npm schema and protocol-baseline mirror package **Protocol:** MPLP v1.0.0 (Frozen) -**sdk_version:** 1.0.7 +**Package version:** 1.0.7 **License:** Apache-2.0 -The **@mplp/schema** package provides **JSON Schema definitions, validation utilities, and the canonical machine-readable Kernel Duty baseline** for the -**Multi-Agent Lifecycle Protocol (MPLP)**, a vendor-neutral lifecycle protocol for AI agent systems. +The `@mplp/schema` package provides the public schema/data mirror surface for MPLP v1.0.0 JSON Schema artifacts, validator helpers, and the machine-readable Kernel Duty baseline. -This package is the public **direct schema/data mirror** surface for the protocol schema bundle and the public Kernel Duty baseline. +It mirrors package-facing schema data. It does not replace the Dev repository L0 schema source of truth. ---- +## Scope & Guarantees -## Scope & Guarantees (Important) +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -### ✅ What this package provides +## What This Package Provides -* **Direct schema/data mirror surface** aligned with MPLP `protocol_version` v1.0.0 -* **Strict version alignment** with the frozen MPLP protocol specification -* **Type-safe integration surface** for higher-level runtimes and tools -* **11-duty baseline export** via `KERNEL_DUTIES`, `KERNEL_DUTY_IDS`, `KERNEL_DUTY_NAMES`, and `KERNEL_DUTY_COUNT` +- JSON Schema package artifacts for MPLP v1.0.0 consumers. +- Validator helper entry points such as `loadSchema`, `createValidator`, and `validate`. +- The canonical 11-duty baseline export via `KERNEL_DUTIES`, `KERNEL_DUTY_IDS`, `KERNEL_DUTY_NAMES`, and `KERNEL_DUTY_COUNT`. -### ❌ What this package does NOT provide +## What This Package Does NOT Provide -- ❌ Invariant bundles as public package contract -- ❌ Profile bundles as public package contract -- ❌ Full execution runtime (LLM orchestration, tool execution) -- ❌ Golden Flow execution engines (Flow-01 ~ Flow-05) -- ❌ Observability pipelines or distributed tracing backends -- ❌ Production agent orchestration - -> These capabilities belong to **reference runtimes and products built *on top of* MPLP**, -> not to the protocol SDK itself. - ---- +- Authority to change protocol schemas. +- Invariant or profile bundles as the package contract. +- Full execution runtime or agent orchestration. +- Certification, regulator approval, legal compliance proof, or official-standard status. ## Installation @@ -41,43 +32,39 @@ This package is the public **direct schema/data mirror** surface for the protoco npm install @mplp/schema ``` -## Kernel Duty Exports +## Minimal User Smoke Usage Snippet -```typescript -import { KERNEL_DUTIES, KERNEL_DUTY_COUNT } from '@mplp/schema'; - -console.log(KERNEL_DUTY_COUNT); // 11 -console.log(KERNEL_DUTIES[0]); // { id: 'KD-01', name: 'Coordination', slug: 'coordination' } +```javascript +const schema = require('@mplp/schema'); +console.log(schema.KERNEL_DUTY_COUNT); +console.log(schema.KERNEL_DUTIES[0]); ``` -Raw JSON is also shipped at: - -- `schemas/kernel-duties.json` +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) -## Protocol Documentation +## Package Provenance -* **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -* **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) - ---- +- **Package address:** [https://www.npmjs.com/package/@mplp/schema](https://www.npmjs.com/package/@mplp/schema) +- Public npm surface: `packages/npm/schema`. +- L0 schema truth remains in `schemas/v2/**` and taxonomy records. +- This package is a release surface mirror, not the authority that changes schemas. ## Versioning & Compatibility -* **Protocol version:** MPLP v1.0.0 (Frozen) -* **Schema package version:** 1.0.7 -* **Kernel duty baseline:** 11/11 carried in package -* **SDK compatibility:** Guaranteed for v1.0.0 only -* Breaking changes require a new protocol version. - ---- +- **Protocol version:** MPLP v1.0.0 (Frozen) +- **Package version:** 1.0.7 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/schema/dist/index.d.ts b/packages/npm/schema/dist/index.d.ts deleted file mode 100644 index 4511abfcd..000000000 --- a/packages/npm/schema/dist/index.d.ts +++ /dev/null @@ -1,24 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/schema"; -export declare const PACKAGE_VERSION: "1.0.7"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "schema-data-mirror"; -export declare const CONTRACT_MODE: "direct-schema-data-mirror"; -export type { MplpKernelDuty, MplpKernelDutyBaseline } from "./kernel-duties"; -export { kernelDutyBaseline, KERNEL_DUTIES, KERNEL_DUTY_IDS, KERNEL_DUTY_NAMES, KERNEL_DUTY_COUNT } from "./kernel-duties"; - -export default packageMetadata; diff --git a/packages/npm/schema/dist/index.js b/packages/npm/schema/dist/index.js deleted file mode 100644 index a37d08e60..000000000 --- a/packages/npm/schema/dist/index.js +++ /dev/null @@ -1,20 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/schema","version":"1.0.7","protocolVersion":"1.0.0","packageRole":"schema-data-mirror","contractMode":"direct-schema-data-mirror","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -const kernelDutyExports = require("./kernel-duties.js"); -exports.kernelDutyBaseline = kernelDutyExports.kernelDutyBaseline; -exports.KERNEL_DUTIES = kernelDutyExports.KERNEL_DUTIES; -exports.KERNEL_DUTY_IDS = kernelDutyExports.KERNEL_DUTY_IDS; -exports.KERNEL_DUTY_NAMES = kernelDutyExports.KERNEL_DUTY_NAMES; -exports.KERNEL_DUTY_COUNT = kernelDutyExports.KERNEL_DUTY_COUNT; - -exports.default = packageMetadata; diff --git a/packages/npm/schema/dist/kernel-duties.d.ts b/packages/npm/schema/dist/kernel-duties.d.ts deleted file mode 100644 index a22c303a7..000000000 --- a/packages/npm/schema/dist/kernel-duties.d.ts +++ /dev/null @@ -1,19 +0,0 @@ -export interface MplpKernelDuty { - readonly id: string; - readonly name: string; - readonly slug: string; -} - -export interface MplpKernelDutyBaseline { - readonly protocol_version: string; - readonly source_of_truth: string; - readonly count: number; - readonly duties: readonly MplpKernelDuty[]; -} - -export declare const kernelDutyBaseline: Readonly; -export declare const KERNEL_DUTIES: readonly MplpKernelDuty[]; -export declare const KERNEL_DUTY_IDS: readonly string[]; -export declare const KERNEL_DUTY_NAMES: readonly string[]; -export declare const KERNEL_DUTY_COUNT: number; -export default kernelDutyBaseline; diff --git a/packages/npm/schema/dist/kernel-duties.js b/packages/npm/schema/dist/kernel-duties.js deleted file mode 100644 index f0dadd1ff..000000000 --- a/packages/npm/schema/dist/kernel-duties.js +++ /dev/null @@ -1,14 +0,0 @@ -"use strict"; - -const kernelDutyBaseline = require("../schemas/kernel-duties.json"); -const KERNEL_DUTIES = Object.freeze(kernelDutyBaseline.duties.map((duty) => Object.freeze({ ...duty }))); -const KERNEL_DUTY_IDS = Object.freeze(KERNEL_DUTIES.map((duty) => duty.id)); -const KERNEL_DUTY_NAMES = Object.freeze(KERNEL_DUTIES.map((duty) => duty.name)); -const KERNEL_DUTY_COUNT = kernelDutyBaseline.count; - -exports.kernelDutyBaseline = Object.freeze({ ...kernelDutyBaseline, duties: KERNEL_DUTIES }); -exports.KERNEL_DUTIES = KERNEL_DUTIES; -exports.KERNEL_DUTY_IDS = KERNEL_DUTY_IDS; -exports.KERNEL_DUTY_NAMES = KERNEL_DUTY_NAMES; -exports.KERNEL_DUTY_COUNT = KERNEL_DUTY_COUNT; -exports.default = exports.kernelDutyBaseline; diff --git a/packages/npm/schema/package.json b/packages/npm/schema/package.json index 5e13615da..bd51bbef8 100644 --- a/packages/npm/schema/package.json +++ b/packages/npm/schema/package.json @@ -60,11 +60,10 @@ "require": "./dist/kernel-duties.js", "import": "./dist/kernel-duties.js", "types": "./dist/kernel-duties.d.ts" - }, - "./schemas/*": "./schemas/*" + } }, "sideEffects": false, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model schema_data_package" + "build": "tsc -p tsconfig.json" } } diff --git a/packages/npm/schema/schemas/profiles/map-profile.yaml b/packages/npm/schema/schemas/profiles/map-profile.yaml deleted file mode 100644 index e212d81e9..000000000 --- a/packages/npm/schema/schemas/profiles/map-profile.yaml +++ /dev/null @@ -1,123 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -# MAP Profile Definition - Based on actual schema implementations -# Truth Sources: -# - schemas/v2/events/mplp-map-event.schema.json -# - schemas/v2/invariants/map-invariants.yaml -# - schemas/v2/mplp-collab.schema.json - -map_profile: - version: "1.0.0" - profile_id: "mplp:profile:map:1.0.0" - title: "MPLP Multi-Agent Profile v1.0" - description: "Collaboration profile extending SA for multi-agent workflows" - - # MAP extends SA Profile - extends: "mplp:profile:sa:1.0.0" - - # Additional required modules (beyond SA modules) - additional_modules: - - module: collab - schema_ref: "schemas/v2/mplp-collab.schema.json" - usage: "Session structure, mode selection, participant management" - - module: dialog - schema_ref: "schemas/v2/mplp-dialog.schema.json" - usage: "Inter-agent communication" - - module: network - schema_ref: "schemas/v2/mplp-network.schema.json" - usage: "Agent topology and routing" - - # Collab.mode enum values (from mplp-collab.schema.json) - coordination_modes: - - broadcast - - round_robin - - orchestrated - - swarm - - pair - - # MAP lifecycle events (from mplp-map-event.schema.json) - event_types: - mandatory: - - MAPSessionStarted - - MAPRolesAssigned - - MAPTurnDispatched - - MAPTurnCompleted - - MAPSessionCompleted - recommended: - - MAPBroadcastSent - - MAPBroadcastReceived - - MAPConflictDetected - - MAPConflictResolved - - # Event schema reference - events_schema: "schemas/v2/events/mplp-map-event.schema.json" - - # Invariants (from map-invariants.yaml) - invariants: - ref: "schemas/v2/invariants/map-invariants.yaml" - count: 9 - summary: - # Session structure (aligned with schema) - - map_session_requires_participants: "participants.length >= 1 (per schema minItems)" - - map_collab_mode_valid: "mode must be valid enum value" - - map_session_id_is_uuid: "collab_id must be UUID v4" - - map_participants_have_role_ids: "All participants must have role_id" - # Event consistency - - map_turn_completion_matches_dispatch: "Every dispatch must have completion" - - map_broadcast_has_receivers: "Every broadcast must have receivers" - # Role binding (aligned with schema) - - map_role_ids_non_empty: "role_id must be non-empty string if present" - - map_participant_ids_are_non_empty: "participant_id must be non-empty" - - map_participant_kind_valid: "kind must be agent|human|system|external" - - # Event required fields (from schema) - event_required_fields: - all_events: - - event_id: "uuid" - - event_type: "enum" - - timestamp: "date-time" - - session_id: "uuid" - optional: - - initiator_role: "string" - - target_roles: "array[string]" - - payload: "object" - - # Participant.kind enum (from mplp-collab.schema.json) - participant_kinds: - - agent - - human - - system - - external - - # MAP session lifecycle - lifecycle: - phases: - - id: initialize - event: MAPSessionStarted - description: "Collab session created with mode and participants" - - id: assign_roles - event: MAPRolesAssigned - description: "Participant-role bindings established" - - id: dispatch_turns - events: [MAPTurnDispatched, MAPTurnCompleted] - description: "Turn-based execution loop" - - id: broadcast - events: [MAPBroadcastSent, MAPBroadcastReceived] - description: "Fan-out/fan-in communication (optional)" - - id: resolve_conflicts - events: [MAPConflictDetected, MAPConflictResolved] - description: "Concurrent modification resolution (optional)" - - id: complete - event: MAPSessionCompleted - description: "Session terminated with final status" - - # Relationship to SA - relationship: - extends: "mplp:profile:sa:1.0.0" - note: "MAP inherits all SA modules and adds Collab, Dialog, Network" diff --git a/packages/npm/schema/schemas/profiles/sa-profile.yaml b/packages/npm/schema/schemas/profiles/sa-profile.yaml deleted file mode 100644 index 3413aa524..000000000 --- a/packages/npm/schema/schemas/profiles/sa-profile.yaml +++ /dev/null @@ -1,109 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -# SA Profile Definition - Based on actual schema implementations -# Truth Sources: -# - schemas/v2/events/mplp-sa-event.schema.json -# - schemas/v2/invariants/sa-invariants.yaml -# - schemas/v2/mplp-plan.schema.json -# - schemas/v2/mplp-context.schema.json - -sa_profile: - version: "1.0.0" - profile_id: "mplp:profile:sa:1.0.0" - title: "MPLP Single-Agent Profile v1.0" - description: "Minimal execution profile for single-agent MPLP workflows" - - # Required L2 Modules (per protocol specification) - required_modules: - - module: context - schema_ref: "schemas/v2/mplp-context.schema.json" - usage: "World state anchor, project/session scope" - - module: plan - schema_ref: "schemas/v2/mplp-plan.schema.json" - usage: "Task decomposition and step execution" - - module: trace - schema_ref: "schemas/v2/mplp-trace.schema.json" - usage: "Execution audit trail" - - module: role - schema_ref: "schemas/v2/mplp-role.schema.json" - usage: "Permission boundaries and capabilities" - - module: core - usage: "Protocol manifest and metadata" - - # SA Lifecycle events (from mplp-sa-event.schema.json) - event_types: - mandatory: - - SAInitialized - - SAContextLoaded - - SAPlanEvaluated - - SAStepStarted - - SAStepCompleted - - SATraceEmitted - - SACompleted - recommended: - - SAStepFailed - - # Event schema reference - events_schema: "schemas/v2/events/mplp-sa-event.schema.json" - - # Invariants (from sa-invariants.yaml) - invariants: - ref: "schemas/v2/invariants/sa-invariants.yaml" - count: 9 - summary: - - sa_requires_context: "Context must have valid UUID" - - sa_context_must_be_active: "Context status must be 'active'" - - sa_plan_context_binding: "Plan.context_id must match Context" - - sa_plan_has_steps: "Plan must have at least 1 step" - - sa_steps_have_valid_ids: "All step IDs must be UUID v4" - - sa_steps_agent_role_if_present: "agent_role must be non-empty if present" - - sa_trace_not_empty: "Trace must have at least 1 event" - - sa_trace_context_binding: "Trace.context_id must match Context" - - sa_trace_plan_binding: "Trace.plan_id must match Plan" - - # SA execution lifecycle (derived from event sequence) - lifecycle: - phases: - - id: initialize - event: SAInitialized - description: "SA instance created with valid sa_id" - - id: load_context - event: SAContextLoaded - description: "Context bound, context_id captured" - - id: evaluate_plan - event: SAPlanEvaluated - description: "Plan parsed, steps ordered" - - id: execute_steps - events: [SAStepStarted, SAStepCompleted, SAStepFailed] - description: "Sequential step execution with trace" - - id: emit_trace - event: SATraceEmitted - description: "Execution trace finalized" - - id: complete - event: SACompleted - description: "SA execution terminated" - - # Event required fields (from schema) - event_required_fields: - all_events: - - event_id: "uuid" - - event_type: "enum" - - timestamp: "date-time" - - sa_id: "uuid" - optional: - - context_id: "uuid" - - plan_id: "uuid" - - trace_id: "uuid" - - payload: "object" - - # Relationship to MAP - relationship: - extends: null # SA is base profile - extended_by: ["mplp:profile:map:1.0.0"] - note: "MAP extends SA by adding Collab, Dialog, Network modules" diff --git a/packages/npm/schema/schemas/taxonomy/event-taxonomy.yaml b/packages/npm/schema/schemas/taxonomy/event-taxonomy.yaml deleted file mode 100644 index 2ce8da5a5..000000000 --- a/packages/npm/schema/schemas/taxonomy/event-taxonomy.yaml +++ /dev/null @@ -1,112 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -version: "1.0.0" -title: "MPLP Event Taxonomy v1.0" -description: "Complete event family classification for MPLP v1.0 Observability Duties. Defines 12 Logical Families mapped to 3 Physical Schemas." - -# Governance -status: "Frozen" -last_updated: "2025-12-01" - -# Schema Mapping Strategy -# 1. Specific Schemas: Used when the event has unique structural requirements (e.g., pipeline stage, graph update). -# 2. Generic Core Schema: Used when the event follows the standard metadata + payload pattern without extra top-level fields. -# -# NOTE: For module-to-event-family mappings, see schemas/v2/taxonomy/module-event-matrix.yaml (single truth source). - -event_families: - # --- Physical Schema: mplp-graph-update-event.schema.json --- - - id: graph_update - title: "GraphUpdateEvent" - description: "**REQUIRED** - PSG structural updates, node/edge mutations" - compliance: required - schema_ref: "schemas/v2/events/mplp-graph-update-event.schema.json" - - # --- Physical Schema: mplp-pipeline-stage-event.schema.json --- - - id: pipeline_stage - title: "PipelineStageEvent" - description: "**REQUIRED** - Pipeline stage transitions, execution flow tracking" - compliance: required - schema_ref: "schemas/v2/events/mplp-pipeline-stage-event.schema.json" - - # --- Physical Schema: mplp-runtime-execution-event.schema.json --- - - id: runtime_execution - title: "RuntimeExecutionEvent" - description: "**RECOMMENDED** - Runtime execution lifecycle tracking (agents, tools, LLMs)" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-runtime-execution-event.schema.json" - - # --- Physical Schema: mplp-event-core.schema.json (Generic) --- - - id: import_process - title: "ImportProcessEvent" - description: "Project import, repository scanning, semantic card generation" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: intent - title: "IntentEvent" - description: "User intentions, actor actions, input channels" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: delta_intent - title: "DeltaIntentEvent" - description: "Intent deltas, change requests" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: impact_analysis - title: "ImpactAnalysisEvent" - description: "Impact assessment results" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: compensation_plan - title: "CompensationPlanEvent" - description: "Compensation planning for intent execution" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: methodology - title: "MethodologyEvent" - description: "Methodology selection and execution tracking" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: reasoning_graph - title: "ReasoningGraphEvent" - description: "Reasoning graph construction and evolution" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: cost_budget - title: "CostAndBudgetEvent" - description: "Cost tracking and token usage" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: external_integration - title: "ExternalIntegrationEvent" - description: "External system integration activities" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - -# Profile-Level Event Families -profile_events: - - id: sa_profile - title: "SAEvent" - description: "Single Agent Profile events" - schema_ref: "schemas/v2/events/mplp-sa-event.schema.json" - doc_ref: "docs/03-profiles/sa-events.md" - - - id: map_profile - title: "MAPEvent" - description: "Multi-Agent Profile events" - schema_ref: "schemas/v2/events/mplp-map-event.schema.json" - doc_ref: "docs/03-profiles/map-events.md" diff --git a/packages/npm/schema/schemas/taxonomy/integration-event-taxonomy.yaml b/packages/npm/schema/schemas/taxonomy/integration-event-taxonomy.yaml deleted file mode 100644 index 4177051b6..000000000 --- a/packages/npm/schema/schemas/taxonomy/integration-event-taxonomy.yaml +++ /dev/null @@ -1,436 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -version: "1.0.0" -title: "MPLP Integration Event Taxonomy v1.0" -description: "Defines 4 Integration Event families for external tool integration (IDE, CI, Git, Tools). Binds to schemas/v2/integration." - -metadata: - last_updated: "2025-11-30" - compliance_level: "optional" # L4 Event Family Specification - keywords: - [ - "MPLP", - "Multi-Agent Lifecycle Protocol", - "Agent OS Protocol", - "AI Agent", - "Observable", - "Governed", - "Vendor-neutral", - "Integration Event Taxonomy", - "IDE integration", - "CI integration", - "Git integration", - ] - -# Relationship to Phase 3 Observability -observability_integration: - parent_event: "ExternalIntegrationEvent" # From Phase 3 - usage_pattern: | - Integration events typically appear as ExternalIntegrationEvent.payload: - { - "event_family": "ExternalIntegrationEvent", - "event_type": "tool_execution" | "file_update" | "git_operation" | "ci_pipeline", - "payload": - } - -# Integration Event Families -families: - # ======================================== - # 1. TOOL_EVENT - # ======================================== - tool_event: - description: "External tool invocation and results (formatters, linters, test runners, generators)" - compliance_level: "recommended" - - typical_sources: - - "IDE plugins (ESLint, Prettier, Black, etc.)" - - "Command-line tools (pytest, npm test, etc.)" - - "Code generators (Copilot, CodeWhisperer, etc.)" - - recommended_triggers: - - "Tool invocation initiated" - - "Tool execution completed" - - "Tool execution failed" - - minimal_fields: - tool_id: - type: "string" - required: true - description: "Unique identifier for the tool" - example: "eslint-v8.50.0" - - tool_kind: - type: "enum" - required: true - values: ["formatter", "linter", "test_runner", "generator", "other"] - description: "Category of tool" - - invocation_id: - type: "string" - format: "uuid-v4" - required: true - description: "Unique identifier for this specific invocation" - example: "550e8400-e29b-41d4-a716-446655440000" - - status: - type: "enum" - required: true - values: ["pending", "running", "succeeded", "failed", "cancelled"] - description: "Current execution status" - - started_at: - type: "string" - format: "iso-datetime" - required: false - description: "Invocation start timestamp" - - completed_at: - type: "string" - format: "iso-datetime" - required: false - description: "Invocation completion timestamp" - - exit_code: - type: "integer" - required: false - description: "Tool process exit code (if applicable)" - - output_summary: - type: "string" - required: false - description: "Brief summary of tool output or errors" - - args: - type: "array" - items_type: "string" - required: false - description: "Command-line arguments passed to tool (optional)" - - working_directory: - type: "string" - required: false - description: "Working directory where tool was executed (optional)" - - use_cases: - - "Track linting violations over time" - - "Correlate test failures with code changes" - - "Monitor formatter application patterns" - - # ======================================== - # 2. FILE_UPDATE_EVENT - # ======================================== - file_update_event: - description: "IDE file changes (save, refactor, batch modify)" - compliance_level: "recommended" - - typical_sources: - - "IDE file watchers (VS Code, IntelliJ, etc.)" - - "File system monitors" - - "Version control pre-commit hooks" - - recommended_triggers: - - "File saved in IDE" - - "File created in workspace" - - "File deleted from workspace" - - "File renamed/moved" - - "Batch refactor operation completed" - - minimal_fields: - file_path: - type: "string" - required: true - description: "Path to the file (absolute or workspace-relative)" - example: "src/components/App.tsx" - - change_type: - type: "enum" - required: true - values: ["created", "modified", "deleted", "renamed"] - description: "Type of file change" - - workspace_root: - type: "string" - required: false - description: "Workspace root directory (for resolving relative paths)" - example: "/Users/dev/project" - - change_summary: - type: "string" - required: false - description: "Brief description of changes (e.g., 'Added error handling')" - - timestamp: - type: "string" - format: "iso-datetime" - required: true - description: "When the change occurred" - - lines_added: - type: "integer" - required: false - description: "Number of lines added (if applicable)" - - lines_removed: - type: "integer" - required: false - description: "Number of lines removed (if applicable)" - - previous_path: - type: "string" - required: false - description: "Previous path (for renamed files)" - - encoding: - type: "string" - required: false - description: "File encoding (e.g., 'utf-8')" - - language: - type: "string" - required: false - description: "Programming language or file type (e.g., 'typescript', 'python')" - - use_cases: - - "Trigger PSG node updates on file changes" - - "Track edit patterns for learning samples" - - "Correlate file changes with plan execution" - - # ======================================== - # 3. GIT_EVENT - # ======================================== - git_event: - description: "Git operations (commit, push, branch/merge/tag)" - compliance_level: "recommended" - - typical_sources: - - "Git hooks (pre-commit, post-commit, pre-push)" - - "Git hosting webhooks (GitHub, GitLab, Bitbucket)" - - "IDE Git integrations" - - recommended_triggers: - - "Commit created" - - "Push to remote" - - "Branch created/deleted" - - "Merge completed" - - "Tag created" - - minimal_fields: - repo_url: - type: "string" - required: true - description: "Repository URL or identifier" - example: "https://github.com/org/repo.git" - - commit_id: - type: "string" - required: true - description: "Commit SHA or identifier" - example: "abc123def456" - - ref_name: - type: "string" - required: true - description: "Branch, tag, or ref name" - example: "refs/heads/main" - - event_kind: - type: "enum" - required: true - values: - ["commit", "push", "merge", "tag", "branch_create", "branch_delete"] - description: "Type of Git operation" - - author_name: - type: "string" - required: false - description: "Commit author name" - - author_email: - type: "string" - required: false - description: "Commit author email" - - commit_message: - type: "string" - required: false - description: "Commit message (first line or summary)" - - timestamp: - type: "string" - format: "iso-datetime" - required: true - description: "When the Git operation occurred" - - files_changed: - type: "integer" - required: false - description: "Number of files changed in commit" - - insertions: - type: "integer" - required: false - description: "Total lines inserted" - - deletions: - type: "integer" - required: false - description: "Total lines deleted" - - parent_commits: - type: "array" - items_type: "string" - required: false - description: "Parent commit SHA(s) - multiple for merges" - - use_cases: - - "Record commits in PSG for audit trail" - - "Trigger CI pipelines on push" - - "Track collaboration patterns via commit history" - - # ======================================== - # 4. CI_EVENT - # ======================================== - ci_event: - description: "CI pipeline execution status" - compliance_level: "recommended" - - typical_sources: - - "CI platform webhooks (GitHub Actions, GitLab CI, Jenkins, CircleCI)" - - "CI pipeline monitoring tools" - - recommended_triggers: - - "Pipeline started" - - "Pipeline stage completed" - - "Pipeline succeeded" - - "Pipeline failed" - - "Pipeline cancelled" - - minimal_fields: - ci_provider: - type: "string" - required: true - description: "CI platform identifier" - example: "github-actions" - values_suggested: - [ - "github-actions", - "gitlab-ci", - "jenkins", - "circleci", - "travis-ci", - "other", - ] - - pipeline_id: - type: "string" - required: true - description: "Pipeline or workflow identifier" - example: "build-and-test" - - run_id: - type: "string" - required: true - description: "Unique identifier for this pipeline run" - example: "123456789" - - status: - type: "enum" - required: true - values: ["pending", "running", "succeeded", "failed", "cancelled"] - description: "Current pipeline status" - - started_at: - type: "string" - format: "iso-datetime" - required: false - description: "Pipeline start timestamp" - - completed_at: - type: "string" - format: "iso-datetime" - required: false - description: "Pipeline completion timestamp" - - branch_name: - type: "string" - required: false - description: "Git branch that triggered the pipeline" - - commit_id: - type: "string" - required: false - description: "Commit SHA that triggered the pipeline" - - run_url: - type: "string" - required: false - description: "URL to view pipeline run details" - - duration_ms: - type: "integer" - required: false - description: "Pipeline execution duration in milliseconds" - - trigger_kind: - type: "enum" - required: false - values: ["push", "pull_request", "schedule", "manual", "tag", "other"] - description: "What triggered the pipeline" - - stages: - type: "array" - required: false - description: "Pipeline stages and their statuses" - items: - stage_name: - type: "string" - required: true - status: - type: "enum" - required: true - values: - [ - "pending", - "running", - "succeeded", - "failed", - "cancelled", - "skipped", - ] - duration_ms: - type: "integer" - required: false - - use_cases: - - "Correlate CI results with plan execution" - - "Trigger rollback on CI failure" - - "Track build times and success rates" - -# Compliance Summary -compliance: - v1_0_requirements: - required: [] # Integration events are NOT REQUIRED for v1.0 - recommended: - - "tool_event: When integrating external tools" - - "file_update_event: When integrating IDE file watchers" - - "git_event: When integrating Git operations" - - "ci_event: When integrating CI pipelines" - optional: - - "Bidirectional integration patterns" - - "Real-time event streaming" - - if_implemented: - must_conform_to: "Integration schemas in schemas/v2/integration/" - must_validate_against: "Integration invariants in schemas/v2/invariants/integration-invariants.yaml" - - relationship_to_observability: - note: | - Integration events appear as ExternalIntegrationEvent.payload (from Phase 3). - ExternalIntegrationEvent provides envelope (event_id, timestamp, event_family). - Integration schemas define payload structure. diff --git a/packages/npm/schema/schemas/taxonomy/learning-taxonomy.yaml b/packages/npm/schema/schemas/taxonomy/learning-taxonomy.yaml deleted file mode 100644 index 1977b81df..000000000 --- a/packages/npm/schema/schemas/taxonomy/learning-taxonomy.yaml +++ /dev/null @@ -1,291 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -# ============================================================ -# MPLP Learning Sample Taxonomy v1.0 -# Source of Truth: schemas/v2/learning/*.schema.json -# ============================================================ - -version: "1.0.0" -title: "MPLP Learning Sample Taxonomy" -description: "Authoritative taxonomy of LearningSample families and collection points, derived from frozen JSON schemas." -keywords: - [ - "MPLP", - "Multi-Agent Lifecycle Protocol", - "Agent OS Protocol", - "AI Agent", - "Observable", - "Governed", - "Vendor-neutral", - "Learning Sample Taxonomy", - "learning families", - "collection points", - "learning schema", - ] - -# Governance -status: "Frozen" -freeze_date: "2025-12-03" - -# ============================================================ -# SAMPLE FAMILIES -# From: mplp-learning-sample-core.schema.json#sample_family -# ============================================================ - -sample_families: - # -------------------------------------------------------- - # 1. Intent Resolution - # Schema: mplp-learning-sample-intent.schema.json - # -------------------------------------------------------- - - id: intent_resolution - title: "Intent Resolution Sample" - description: "Captures user intent clarification and plan generation" - schema_ref: "schemas/v2/learning/mplp-learning-sample-intent.schema.json" - - input_fields: - required: - - intent_id # Intent identifier from IntentEvent - - raw_request_summary # Abstracted user request (PII-scrubbed) - optional: - - constraints_summary # Timeline, budget, resources - - dialog_turns_count # Dialog exchanges before resolution - - state_fields: - - project_phase # greenfield, brownfield, maintenance - - psg_node_count # PSG size before intent - - existing_plan_count # Existing plans in context - - output_fields: - required: - - final_intent_summary # Refined intent after resolution - optional: - - plan_id # Generated Plan UUID - - plan_step_count # Steps in generated plan - - resolution_quality_label # good, acceptable, bad, unknown - - meta_extensions: - - clarification_rounds # Rounds needed before resolution - - ambiguity_flags # vague_scope, missing_constraints, etc. - - # -------------------------------------------------------- - # 2. Delta Impact - # Schema: mplp-learning-sample-delta.schema.json - # -------------------------------------------------------- - - id: delta_impact - title: "Delta Impact Sample" - description: "Captures change effect analysis and compensation planning" - schema_ref: "schemas/v2/learning/mplp-learning-sample-delta.schema.json" - - input_fields: - required: - - delta_id # Delta Intent identifier - - intent_id # Original intent being modified - - change_summary # Abstracted summary of change - optional: - - delta_type # refinement, correction, expansion, reduction, pivot - - state_fields: - - affected_artifact_count # Artifacts potentially affected - - risk_level # low, medium, high, critical - - psg_complexity_score # PSG complexity metric - - output_fields: - required: - - actual_impact_summary # Impact after analysis - - impact_scope # local, module, system, global - optional: - - comp_plan_required # Compensation plan needed? - - comp_plan_applied # Compensation applied? - - rollback_used # Rollback triggered? - - meta_extensions: - - impact_analysis_duration_ms # Time on impact analysis - - predicted_vs_actual_accuracy # accurate, underestimated, overestimated - - # -------------------------------------------------------- - # 3. Pipeline Outcome - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: pipeline_outcome - title: "Pipeline Outcome Sample" - description: "Captures pipeline stage success/failure patterns" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema with pipeline-specific input/output" - - recommended_input_fields: - - pipeline_id - - stage_id - - stage_config - - recommended_output_fields: - - status # completed, failed, skipped - - duration_ms - - error_info # If failed - - # -------------------------------------------------------- - # 4. Confirm Decision - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: confirm_decision - title: "Confirm Decision Sample" - description: "Captures approval/rejection decisions and reasoning" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema with confirm-specific input/output" - - recommended_input_fields: - - confirm_id - - target_type # plan, step, delta - - target_id - - risk_label - - recommended_output_fields: - - decision # approve, reject, override - - reasoning - - decided_by_role - - # -------------------------------------------------------- - # 5. Graph Evolution - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: graph_evolution - title: "Graph Evolution Sample" - description: "Captures PSG structural changes over time" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema; also see common/learning-sample.schema.json for graph_before/graph_after" - - recommended_input_fields: - - trigger_event_id - - change_type # node_added, edge_added, attribute_changed - - recommended_state_fields: - - psg_snapshot_before_id - - node_count_before - - edge_count_before - - recommended_output_fields: - - psg_snapshot_after_id - - nodes_added - - edges_added - - topology_change_score - - # -------------------------------------------------------- - # 6. Multi-Agent Coordination - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: multi_agent_coordination - title: "Multi-Agent Coordination Sample" - description: "Captures SA/MAP collaboration patterns" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema with MAP-specific input/output" - - recommended_input_fields: - - session_id - - coordination_mode # turn_based, parallel, hierarchical - - participant_count - - initiator_role - - recommended_output_fields: - - total_turns - - handoffs_count - - outcome # success, partial, failed - - duration_ms - -# ============================================================ -# COLLECTION POINTS -# ============================================================ - -collection_points: - - id: intent_resolution - description: "When user intent is successfully parsed and clarified" - trigger_events: - - IntentEvent - - SAPlanEvaluated - sample_families: [intent_resolution] - priority: HIGH - - - id: plan_generation - description: "When a Plan is generated from user request" - trigger_events: - - SAPlanEvaluated - sample_families: [intent_resolution] - priority: HIGH - - - id: plan_revision - description: "When user modifies or rejects a Plan" - trigger_events: - - DeltaIntentEvent - sample_families: [delta_impact] - priority: HIGH - - - id: impact_analysis_completion - description: "When impact analysis finishes" - trigger_events: - - ImpactAnalysisEvent - sample_families: [delta_impact] - priority: MEDIUM - - - id: execution_completion - description: "When a Plan step completes (success or failure)" - trigger_events: - - SAStepCompleted - - RuntimeExecutionEvent - sample_families: [pipeline_outcome] - priority: HIGH - - - id: pipeline_failure - description: "When a pipeline stage fails" - trigger_events: - - PipelineStageEvent(status=failed) - sample_families: [pipeline_outcome] - priority: HIGH - - - id: user_feedback - description: "When user provides explicit approval/rejection" - trigger_events: - - ConfirmDecisionAdded - sample_families: [confirm_decision] - priority: HIGH - - - id: graph_update - description: "When PSG structure changes significantly" - trigger_events: - - GraphUpdateEvent - sample_families: [graph_evolution] - priority: MEDIUM - - - id: map_session_completion - description: "When a MAP collaboration session ends" - trigger_events: - - MAPSessionCompleted - sample_families: [multi_agent_coordination] - priority: MEDIUM - -# ============================================================ -# INVARIANTS REFERENCE -# Source: schemas/v2/invariants/learning-invariants.yaml -# ============================================================ - -invariants_summary: - core_invariants: - - learning_sample_id_is_uuid # sample_id must be UUID v4 - - learning_sample_family_non_empty # sample_family required - - learning_sample_created_at_iso # created_at must be ISO 8601 - - learning_sample_has_input_section # input required - - learning_sample_has_output_section # output required - - learning_sample_feedback_label_valid # enum validation when present - - learning_sample_source_flow_non_empty # non-empty when present - - intent_family_invariants: - - learning_intent_has_intent_id # intent_id required for intent_resolution - - learning_intent_quality_label_valid # enum validation when present - - delta_family_invariants: - - learning_delta_has_delta_id # delta_id required for delta_impact - - learning_delta_scope_valid # impact_scope must be valid enum - - learning_delta_risk_valid # risk_level must be valid enum diff --git a/packages/npm/schema/schemas/taxonomy/module-event-matrix.yaml b/packages/npm/schema/schemas/taxonomy/module-event-matrix.yaml deleted file mode 100644 index 31eb780e1..000000000 --- a/packages/npm/schema/schemas/taxonomy/module-event-matrix.yaml +++ /dev/null @@ -1,253 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -version: "1.0.0" -title: "MPLP Module Event Matrix v1.0" -description: "Machine-readable mapping of L2 Modules to Event Families for observability coverage validation" - -# Module → Event Family Mapping -module_event_mapping: - # --- Context Module --- - - module_id: context - module_name: "Context Module" - primary_events: - - family: import_process - event_types: ["import_started", "import_completed", "import_failed"] - trigger: "Project initialization and scanning" - - family: graph_update - event_types: - ["context_created", "context_updated", "world_state_changed"] - trigger: "Context state mutations" - secondary_events: - - family: intent - event_types: ["context_intent_received"] - trigger: "Intent associated with context" - - # --- Plan Module --- - - module_id: plan - module_name: "Plan Module" - primary_events: - - family: pipeline_stage - event_types: - [ - "plan_status_changed", - "step_started", - "step_completed", - "step_failed", - ] - trigger: "Plan and step lifecycle transitions" - compliance: required - - family: graph_update - event_types: - [ - "plan_created", - "step_added", - "step_removed", - "dag_edge_added", - "dag_edge_removed", - ] - trigger: "Plan DAG structural changes" - compliance: required - secondary_events: - - family: methodology - event_types: ["methodology_selected"] - trigger: "Plan strategy selection" - - family: impact_analysis - event_types: ["impact_assessed"] - trigger: "Change impact evaluation" - - # --- Trace Module --- - - module_id: trace - module_name: "Trace Module" - role: "consumer" - description: "Consumes and persists all events from other modules" - primary_events: [] - secondary_events: - - family: cost_budget - event_types: ["trace_cost_summary"] - trigger: "Aggregate cost tracking" - - # --- Role Module --- - - module_id: role - module_name: "Role Module" - primary_events: - - family: graph_update - event_types: - [ - "role_created", - "role_updated", - "capability_granted", - "capability_revoked", - ] - trigger: "Role definitions and permission changes" - secondary_events: [] - - # --- Confirm Module --- - - module_id: confirm - module_name: "Confirm Module" - primary_events: - - family: pipeline_stage - event_types: ["confirm_created", "confirm_pending", "confirm_resolved"] - trigger: "Approval workflow lifecycle" - - family: graph_update - event_types: ["confirm_created", "decision_added"] - trigger: "Confirm object mutations" - secondary_events: - - family: reasoning_graph - event_types: ["approval_reasoning"] - trigger: "Decision rationale capture" - - # --- Dialog Module --- - - module_id: dialog - module_name: "Dialog Module" - primary_events: - - family: intent - event_types: - ["user_message_received", "intent_extracted", "intent_classified"] - trigger: "User interaction capture" - - family: delta_intent - event_types: ["modification_requested", "clarification_received"] - trigger: "Intent updates and changes" - secondary_events: [] - - # --- Collab Module --- - - module_id: collab - module_name: "Collab Module" - primary_events: - - family: pipeline_stage - event_types: - ["session_started", "session_completed", "session_cancelled"] - trigger: "Session lifecycle" - - family: runtime_execution - event_types: - [ - "turn_dispatched", - "turn_completed", - "broadcast_sent", - "broadcast_received", - ] - trigger: "Turn and broadcast execution" - secondary_events: - - family: reasoning_graph - event_types: ["coordination_reasoning"] - trigger: "Multi-agent reasoning capture" - - # --- Extension Module --- - - module_id: extension - module_name: "Extension Module" - primary_events: - - family: runtime_execution - event_types: - [ - "extension_activated", - "tool_execution_started", - "tool_execution_completed", - "llm_call_started", - "llm_call_completed", - ] - trigger: "Extension and tool execution" - - family: external_integration - event_types: ["external_api_call", "webhook_received"] - trigger: "External system interactions" - secondary_events: [] - - # --- Network Module --- - - module_id: network - module_name: "Network Module" - primary_events: - - family: graph_update - event_types: - ["network_created", "node_added", "node_removed", "topology_changed"] - trigger: "Network topology mutations" - secondary_events: - - family: runtime_execution - event_types: - ["node_status_changed", "connection_established", "connection_lost"] - trigger: "Node runtime status" - - # --- Core Module --- - - module_id: core - module_name: "Core Module" - primary_events: - - family: pipeline_stage - event_types: - ["protocol_initialized", "module_enabled", "module_disabled"] - trigger: "Protocol lifecycle" - secondary_events: - - family: cost_budget - event_types: ["budget_warning", "budget_exceeded"] - trigger: "Budget policy enforcement" - - family: compensation_plan - event_types: ["rollback_planned", "rollback_executed"] - trigger: "Error recovery" - -# Event Family → Module Reverse Mapping -event_family_producers: - graph_update: - producers: [context, plan, role, confirm, network] - compliance: required - - pipeline_stage: - producers: [plan, confirm, collab, core] - compliance: required - - runtime_execution: - producers: [collab, extension, network] - compliance: recommended - - import_process: - producers: [context] - compliance: recommended - - intent: - producers: [context, dialog] - compliance: recommended - - delta_intent: - producers: [dialog] - compliance: optional - - cost_budget: - producers: [trace, core] - compliance: recommended - - external_integration: - producers: [extension] - compliance: recommended - - methodology: - producers: [plan] - compliance: optional - - reasoning_graph: - producers: [confirm, collab] - compliance: optional - - impact_analysis: - producers: [plan] - compliance: optional - - compensation_plan: - producers: [core] - compliance: optional - -# Compliance Summary -compliance_requirements: - required_event_families: - - graph_update - - pipeline_stage - - required_producers: - graph_update: [context, plan] - pipeline_stage: [plan] - - validation_rules: - - id: all_modules_emit_required - description: "All active modules must emit required event families for their scope" - - id: trace_receives_all - description: "Trace module must receive and persist all emitted events" diff --git a/packages/npm/sdk-ts/DERIVATION_PROOF.yaml b/packages/npm/sdk-ts/DERIVATION_PROOF.yaml index 0c57b2ef8..2d194d64f 100644 --- a/packages/npm/sdk-ts/DERIVATION_PROOF.yaml +++ b/packages/npm/sdk-ts/DERIVATION_PROOF.yaml @@ -12,17 +12,30 @@ evidence_baseline: digest: "sha256:78ea3511cee7cacebff416b5ad6179358032d5322e5991523b5f8d6257d10354" derivation: - method: "publish_surface_mirror" - description: "Public npm facade package mirrored from packages/sources/sdk-ts and aligned to MPLP truth sources" + method: "publish_surface_projection" + description: > + Public npm facade package projected from the source workspace mirror and + package-specific release surface. The public package is not a byte-identical + source mirror, and this proof does not authorize release or publish + execution. truth_sources: - "schemas/v2/*.schema.json" - "governance/05-specialized/entity.json" - "governance/05-versioning/version-taxonomy-manifest.json" + source_mirror_evidence: + path: "packages/sources/sdk-ts" + publish_target: false + role: "source_workspace_mirror" immediate_source: - - "packages/sources/sdk-ts/dist/**" - - "packages/sources/sdk-ts/schemas/**" - - "packages/sources/sdk-ts/README.md" - - "packages/sources/sdk-ts/package.json" + - "packages/npm/sdk-ts/dist" + - "packages/npm/sdk-ts/schemas" + - "packages/npm/sdk-ts/README.md" + - "packages/npm/sdk-ts/package.json" + projection_boundary: + source_public_byte_identical: false + package_role: "typescript-facade-helper" + source_mirror_authority: "evidence_only_not_publish_target" + publish_authorization: "not_authorized_by_this_proof" package: name: "@mplp/sdk-ts" @@ -35,7 +48,9 @@ verification: evidence_baseline_aligned: true package_role: "sdk_facade" kernel_duty_baseline_carried: true + release_authorization: "not_authorized_by_this_proof" governance: method: "METHOD-SDKR-08" frozen: true + evidence_only_no_release_or_publish_authorization: true diff --git a/packages/npm/sdk-ts/README.md b/packages/npm/sdk-ts/README.md index 8ed8d01ed..8a9c60ff6 100644 --- a/packages/npm/sdk-ts/README.md +++ b/packages/npm/sdk-ts/README.md @@ -1,52 +1,31 @@ # @mplp/sdk-ts -**Package Role:** Public npm facade package +**Package Role:** Public npm TypeScript SDK facade package **Protocol:** MPLP v1.0.0 (Frozen) -**sdk_version:** 1.0.8 +**Package version:** 1.0.8 **License:** Apache-2.0 -The published `@mplp/sdk-ts` package is the **public TypeScript SDK facade** -for MPLP. +The `@mplp/sdk-ts` package is the public TypeScript SDK facade for MPLP v1.0.0 consumers. -It ships: +It is a facade over compiled helpers, runtime client helpers, schema mirrors, and Kernel Duty exports. It is not the standalone runtime package and should not be read as protocol truth. -- compiled builder helpers, -- a runtime client, -- mirrored schema artifacts, -- and a stable facade import surface over `@mplp/core`. +## Scope & Guarantees -It is **not** the standalone runtime package and it does **not** carry an -independent canonical Kernel Duty registry. Its public duty surface is -re-exported from `@mplp/schema`. +This package is a public npm release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -This package is a **derived protocol helper facade**. -It should not be read as a direct mirror of canonical protocol objects. +## What This Package Provides ---- +- Protocol-aligned facade helper exports for MPLP v1.0.0. +- Builder helpers such as `createContext`, `createPlan`, `createConfirm`, and `appendTrace`. +- Runtime client helpers via `MplpRuntimeClient`. +- Re-exported Kernel Duty baseline from `@mplp/schema`. -## Scope & Guarantees (Important) +## What This Package Does NOT Provide -### What this package provides - -- Protocol-aligned facade helper exports for MPLP v1.0.0 -- Compiled builders such as `createContext`, `createPlan`, `createConfirm`, and `appendTrace` -- Runtime client helpers via `MplpRuntimeClient` -- Mirrored schemas for validator/helper use -- Public npm distribution surface for the TypeScript SDK facade -- Re-exported Kernel Duty baseline from `@mplp/schema` - -### What this package does NOT provide - -- Direct schema or invariant mirrors as first-class public API -- Standalone runtime package identity (use `@mplp/runtime-minimal`) -- Full execution runtime hosting/orchestration stack -- Golden Flow execution engines (Flow-01 ~ Flow-05) -- Independent canonical registry authority for the 11 Kernel Duties - -> These capabilities belong to reference runtimes and products built *on top of* MPLP, -> not to the protocol SDK itself. - ---- +- Standalone runtime package identity; use `@mplp/runtime-minimal` for that package surface. +- Direct schema or invariant mirrors as first-class protocol authority. +- Full execution runtime hosting or orchestration stack. +- Independent canonical authority for Kernel Duties. ## Installation @@ -54,59 +33,39 @@ It should not be read as a direct mirror of canonical protocol objects. npm install @mplp/sdk-ts ``` ---- +## Minimal User Smoke Usage Snippet -## Protocol Documentation +```javascript +const sdk = require('@mplp/sdk-ts'); +console.log(typeof sdk.createContext); +console.log(sdk.KERNEL_DUTY_COUNT); +``` -- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) +## Protocol Documentation Links ---- +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) ## Package Provenance -- **Public npm surface:** `packages/npm/sdk-ts/` -- **Source-side mirror:** `packages/sources/sdk-ts/` -- **Separate runtime package:** `packages/npm/runtime-minimal/` - -This package is a facade surface over compiled artifacts and mirrored schemas. -It should not be read as protocol truth or as the sole runtime package. - ---- - -## Kernel Duty Baseline - -This package re-exports the canonical 11 MPLP Kernel Duties from `@mplp/schema`. - -```typescript -import { KERNEL_DUTY_COUNT, KERNEL_DUTIES } from '@mplp/sdk-ts'; - -console.log(KERNEL_DUTY_COUNT); // 11 -console.log(KERNEL_DUTIES[0]); // { id: 'KD-01', name: 'Coordination', slug: 'coordination' } -``` - -Canonical upstream baseline remains in: - -- `schemas/v2/taxonomy/kernel-duties.yaml` -- the public mirror package `@mplp/schema` - ---- +- **Package address:** [https://www.npmjs.com/package/@mplp/sdk-ts](https://www.npmjs.com/package/@mplp/sdk-ts) +- Public npm surface: `packages/npm/sdk-ts`. +- Source-side mirror: `packages/sources/sdk-ts`. +- Separate runtime package: `packages/npm/runtime-minimal`. ## Versioning & Compatibility - **Protocol version:** MPLP v1.0.0 (Frozen) -- **Facade package version:** 1.0.8 -- **Kernel duty baseline:** 11/11 re-exported from `@mplp/schema` -- **SDK compatibility:** aligned to `protocol_version` v1.0.0 only -- Breaking changes require a new protocol version. - ---- +- **Package version:** 1.0.8 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/npm/sdk-ts/dist/index.d.ts b/packages/npm/sdk-ts/dist/index.d.ts deleted file mode 100644 index f22ed0dc7..000000000 --- a/packages/npm/sdk-ts/dist/index.d.ts +++ /dev/null @@ -1,24 +0,0 @@ -export interface MplpPackageMetadata { - readonly name: string; - readonly version: string; - readonly protocolVersion: string; - readonly packageRole: string | null; - readonly contractMode: string | null; - readonly packageClass: string; - readonly publishSurface: boolean; - readonly repository: string | null; - readonly homepage: string | null; - readonly license: string; -} - -export declare const packageMetadata: Readonly; -export declare const PACKAGE_METADATA: Readonly; -export declare const PACKAGE_NAME: "@mplp/sdk-ts"; -export declare const PACKAGE_VERSION: "1.0.8"; -export declare const MPLP_PROTOCOL_VERSION: "1.0.0"; -export declare const PACKAGE_ROLE: "typescript-facade-helper"; -export declare const CONTRACT_MODE: "derived-protocol-helper"; -export type { MplpKernelDuty, MplpKernelDutyBaseline } from "./kernel-duties"; -export { kernelDutyBaseline, KERNEL_DUTIES, KERNEL_DUTY_IDS, KERNEL_DUTY_NAMES, KERNEL_DUTY_COUNT } from "./kernel-duties"; - -export default packageMetadata; diff --git a/packages/npm/sdk-ts/dist/index.js b/packages/npm/sdk-ts/dist/index.js deleted file mode 100644 index 8a4b60789..000000000 --- a/packages/npm/sdk-ts/dist/index.js +++ /dev/null @@ -1,20 +0,0 @@ -"use strict"; - -const packageMetadata = Object.freeze({"name":"@mplp/sdk-ts","version":"1.0.8","protocolVersion":"1.0.0","packageRole":"typescript-facade-helper","contractMode":"derived-protocol-helper","packageClass":"PUBLIC","publishSurface":true,"repository":"https://github.com/Coregentis/MPLP-Protocol.git","homepage":"https://www.mplp.io/what-is-mplp","license":"Apache-2.0"}); - -exports.packageMetadata = packageMetadata; -exports.PACKAGE_METADATA = packageMetadata; -exports.PACKAGE_NAME = packageMetadata.name; -exports.PACKAGE_VERSION = packageMetadata.version; -exports.MPLP_PROTOCOL_VERSION = packageMetadata.protocolVersion; -exports.PACKAGE_ROLE = packageMetadata.packageRole; -exports.CONTRACT_MODE = packageMetadata.contractMode; - -const kernelDutyExports = require("./kernel-duties.js"); -exports.kernelDutyBaseline = kernelDutyExports.kernelDutyBaseline; -exports.KERNEL_DUTIES = kernelDutyExports.KERNEL_DUTIES; -exports.KERNEL_DUTY_IDS = kernelDutyExports.KERNEL_DUTY_IDS; -exports.KERNEL_DUTY_NAMES = kernelDutyExports.KERNEL_DUTY_NAMES; -exports.KERNEL_DUTY_COUNT = kernelDutyExports.KERNEL_DUTY_COUNT; - -exports.default = packageMetadata; diff --git a/packages/npm/sdk-ts/dist/kernel-duties.d.ts b/packages/npm/sdk-ts/dist/kernel-duties.d.ts deleted file mode 100644 index a22c303a7..000000000 --- a/packages/npm/sdk-ts/dist/kernel-duties.d.ts +++ /dev/null @@ -1,19 +0,0 @@ -export interface MplpKernelDuty { - readonly id: string; - readonly name: string; - readonly slug: string; -} - -export interface MplpKernelDutyBaseline { - readonly protocol_version: string; - readonly source_of_truth: string; - readonly count: number; - readonly duties: readonly MplpKernelDuty[]; -} - -export declare const kernelDutyBaseline: Readonly; -export declare const KERNEL_DUTIES: readonly MplpKernelDuty[]; -export declare const KERNEL_DUTY_IDS: readonly string[]; -export declare const KERNEL_DUTY_NAMES: readonly string[]; -export declare const KERNEL_DUTY_COUNT: number; -export default kernelDutyBaseline; diff --git a/packages/npm/sdk-ts/dist/kernel-duties.js b/packages/npm/sdk-ts/dist/kernel-duties.js deleted file mode 100644 index f0dadd1ff..000000000 --- a/packages/npm/sdk-ts/dist/kernel-duties.js +++ /dev/null @@ -1,14 +0,0 @@ -"use strict"; - -const kernelDutyBaseline = require("../schemas/kernel-duties.json"); -const KERNEL_DUTIES = Object.freeze(kernelDutyBaseline.duties.map((duty) => Object.freeze({ ...duty }))); -const KERNEL_DUTY_IDS = Object.freeze(KERNEL_DUTIES.map((duty) => duty.id)); -const KERNEL_DUTY_NAMES = Object.freeze(KERNEL_DUTIES.map((duty) => duty.name)); -const KERNEL_DUTY_COUNT = kernelDutyBaseline.count; - -exports.kernelDutyBaseline = Object.freeze({ ...kernelDutyBaseline, duties: KERNEL_DUTIES }); -exports.KERNEL_DUTIES = KERNEL_DUTIES; -exports.KERNEL_DUTY_IDS = KERNEL_DUTY_IDS; -exports.KERNEL_DUTY_NAMES = KERNEL_DUTY_NAMES; -exports.KERNEL_DUTY_COUNT = KERNEL_DUTY_COUNT; -exports.default = exports.kernelDutyBaseline; diff --git a/packages/npm/sdk-ts/package.json b/packages/npm/sdk-ts/package.json index 8eda780b5..54466e78d 100644 --- a/packages/npm/sdk-ts/package.json +++ b/packages/npm/sdk-ts/package.json @@ -46,7 +46,7 @@ "kernelDutyBaselineCarried": true }, "scripts": { - "build": "node ../../../scripts/packages/validate-public-npm-package.mjs --model schema_data_package", + "build": "tsc", "test": "echo 'No tests yet'" }, "dependencies": { @@ -78,8 +78,7 @@ "require": "./dist/kernel-duties.js", "import": "./dist/kernel-duties.js", "types": "./dist/kernel-duties.d.ts" - }, - "./schemas/*": "./schemas/*" + } }, "sideEffects": false, "copyright": "© 2026 Jearon Wong" diff --git a/packages/npm/sdk-ts/schemas/profiles/map-profile.yaml b/packages/npm/sdk-ts/schemas/profiles/map-profile.yaml deleted file mode 100644 index e212d81e9..000000000 --- a/packages/npm/sdk-ts/schemas/profiles/map-profile.yaml +++ /dev/null @@ -1,123 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -# MAP Profile Definition - Based on actual schema implementations -# Truth Sources: -# - schemas/v2/events/mplp-map-event.schema.json -# - schemas/v2/invariants/map-invariants.yaml -# - schemas/v2/mplp-collab.schema.json - -map_profile: - version: "1.0.0" - profile_id: "mplp:profile:map:1.0.0" - title: "MPLP Multi-Agent Profile v1.0" - description: "Collaboration profile extending SA for multi-agent workflows" - - # MAP extends SA Profile - extends: "mplp:profile:sa:1.0.0" - - # Additional required modules (beyond SA modules) - additional_modules: - - module: collab - schema_ref: "schemas/v2/mplp-collab.schema.json" - usage: "Session structure, mode selection, participant management" - - module: dialog - schema_ref: "schemas/v2/mplp-dialog.schema.json" - usage: "Inter-agent communication" - - module: network - schema_ref: "schemas/v2/mplp-network.schema.json" - usage: "Agent topology and routing" - - # Collab.mode enum values (from mplp-collab.schema.json) - coordination_modes: - - broadcast - - round_robin - - orchestrated - - swarm - - pair - - # MAP lifecycle events (from mplp-map-event.schema.json) - event_types: - mandatory: - - MAPSessionStarted - - MAPRolesAssigned - - MAPTurnDispatched - - MAPTurnCompleted - - MAPSessionCompleted - recommended: - - MAPBroadcastSent - - MAPBroadcastReceived - - MAPConflictDetected - - MAPConflictResolved - - # Event schema reference - events_schema: "schemas/v2/events/mplp-map-event.schema.json" - - # Invariants (from map-invariants.yaml) - invariants: - ref: "schemas/v2/invariants/map-invariants.yaml" - count: 9 - summary: - # Session structure (aligned with schema) - - map_session_requires_participants: "participants.length >= 1 (per schema minItems)" - - map_collab_mode_valid: "mode must be valid enum value" - - map_session_id_is_uuid: "collab_id must be UUID v4" - - map_participants_have_role_ids: "All participants must have role_id" - # Event consistency - - map_turn_completion_matches_dispatch: "Every dispatch must have completion" - - map_broadcast_has_receivers: "Every broadcast must have receivers" - # Role binding (aligned with schema) - - map_role_ids_non_empty: "role_id must be non-empty string if present" - - map_participant_ids_are_non_empty: "participant_id must be non-empty" - - map_participant_kind_valid: "kind must be agent|human|system|external" - - # Event required fields (from schema) - event_required_fields: - all_events: - - event_id: "uuid" - - event_type: "enum" - - timestamp: "date-time" - - session_id: "uuid" - optional: - - initiator_role: "string" - - target_roles: "array[string]" - - payload: "object" - - # Participant.kind enum (from mplp-collab.schema.json) - participant_kinds: - - agent - - human - - system - - external - - # MAP session lifecycle - lifecycle: - phases: - - id: initialize - event: MAPSessionStarted - description: "Collab session created with mode and participants" - - id: assign_roles - event: MAPRolesAssigned - description: "Participant-role bindings established" - - id: dispatch_turns - events: [MAPTurnDispatched, MAPTurnCompleted] - description: "Turn-based execution loop" - - id: broadcast - events: [MAPBroadcastSent, MAPBroadcastReceived] - description: "Fan-out/fan-in communication (optional)" - - id: resolve_conflicts - events: [MAPConflictDetected, MAPConflictResolved] - description: "Concurrent modification resolution (optional)" - - id: complete - event: MAPSessionCompleted - description: "Session terminated with final status" - - # Relationship to SA - relationship: - extends: "mplp:profile:sa:1.0.0" - note: "MAP inherits all SA modules and adds Collab, Dialog, Network" diff --git a/packages/npm/sdk-ts/schemas/profiles/sa-profile.yaml b/packages/npm/sdk-ts/schemas/profiles/sa-profile.yaml deleted file mode 100644 index 3413aa524..000000000 --- a/packages/npm/sdk-ts/schemas/profiles/sa-profile.yaml +++ /dev/null @@ -1,109 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -# SA Profile Definition - Based on actual schema implementations -# Truth Sources: -# - schemas/v2/events/mplp-sa-event.schema.json -# - schemas/v2/invariants/sa-invariants.yaml -# - schemas/v2/mplp-plan.schema.json -# - schemas/v2/mplp-context.schema.json - -sa_profile: - version: "1.0.0" - profile_id: "mplp:profile:sa:1.0.0" - title: "MPLP Single-Agent Profile v1.0" - description: "Minimal execution profile for single-agent MPLP workflows" - - # Required L2 Modules (per protocol specification) - required_modules: - - module: context - schema_ref: "schemas/v2/mplp-context.schema.json" - usage: "World state anchor, project/session scope" - - module: plan - schema_ref: "schemas/v2/mplp-plan.schema.json" - usage: "Task decomposition and step execution" - - module: trace - schema_ref: "schemas/v2/mplp-trace.schema.json" - usage: "Execution audit trail" - - module: role - schema_ref: "schemas/v2/mplp-role.schema.json" - usage: "Permission boundaries and capabilities" - - module: core - usage: "Protocol manifest and metadata" - - # SA Lifecycle events (from mplp-sa-event.schema.json) - event_types: - mandatory: - - SAInitialized - - SAContextLoaded - - SAPlanEvaluated - - SAStepStarted - - SAStepCompleted - - SATraceEmitted - - SACompleted - recommended: - - SAStepFailed - - # Event schema reference - events_schema: "schemas/v2/events/mplp-sa-event.schema.json" - - # Invariants (from sa-invariants.yaml) - invariants: - ref: "schemas/v2/invariants/sa-invariants.yaml" - count: 9 - summary: - - sa_requires_context: "Context must have valid UUID" - - sa_context_must_be_active: "Context status must be 'active'" - - sa_plan_context_binding: "Plan.context_id must match Context" - - sa_plan_has_steps: "Plan must have at least 1 step" - - sa_steps_have_valid_ids: "All step IDs must be UUID v4" - - sa_steps_agent_role_if_present: "agent_role must be non-empty if present" - - sa_trace_not_empty: "Trace must have at least 1 event" - - sa_trace_context_binding: "Trace.context_id must match Context" - - sa_trace_plan_binding: "Trace.plan_id must match Plan" - - # SA execution lifecycle (derived from event sequence) - lifecycle: - phases: - - id: initialize - event: SAInitialized - description: "SA instance created with valid sa_id" - - id: load_context - event: SAContextLoaded - description: "Context bound, context_id captured" - - id: evaluate_plan - event: SAPlanEvaluated - description: "Plan parsed, steps ordered" - - id: execute_steps - events: [SAStepStarted, SAStepCompleted, SAStepFailed] - description: "Sequential step execution with trace" - - id: emit_trace - event: SATraceEmitted - description: "Execution trace finalized" - - id: complete - event: SACompleted - description: "SA execution terminated" - - # Event required fields (from schema) - event_required_fields: - all_events: - - event_id: "uuid" - - event_type: "enum" - - timestamp: "date-time" - - sa_id: "uuid" - optional: - - context_id: "uuid" - - plan_id: "uuid" - - trace_id: "uuid" - - payload: "object" - - # Relationship to MAP - relationship: - extends: null # SA is base profile - extended_by: ["mplp:profile:map:1.0.0"] - note: "MAP extends SA by adding Collab, Dialog, Network modules" diff --git a/packages/npm/sdk-ts/schemas/taxonomy/event-taxonomy.yaml b/packages/npm/sdk-ts/schemas/taxonomy/event-taxonomy.yaml deleted file mode 100644 index 2ce8da5a5..000000000 --- a/packages/npm/sdk-ts/schemas/taxonomy/event-taxonomy.yaml +++ /dev/null @@ -1,112 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -version: "1.0.0" -title: "MPLP Event Taxonomy v1.0" -description: "Complete event family classification for MPLP v1.0 Observability Duties. Defines 12 Logical Families mapped to 3 Physical Schemas." - -# Governance -status: "Frozen" -last_updated: "2025-12-01" - -# Schema Mapping Strategy -# 1. Specific Schemas: Used when the event has unique structural requirements (e.g., pipeline stage, graph update). -# 2. Generic Core Schema: Used when the event follows the standard metadata + payload pattern without extra top-level fields. -# -# NOTE: For module-to-event-family mappings, see schemas/v2/taxonomy/module-event-matrix.yaml (single truth source). - -event_families: - # --- Physical Schema: mplp-graph-update-event.schema.json --- - - id: graph_update - title: "GraphUpdateEvent" - description: "**REQUIRED** - PSG structural updates, node/edge mutations" - compliance: required - schema_ref: "schemas/v2/events/mplp-graph-update-event.schema.json" - - # --- Physical Schema: mplp-pipeline-stage-event.schema.json --- - - id: pipeline_stage - title: "PipelineStageEvent" - description: "**REQUIRED** - Pipeline stage transitions, execution flow tracking" - compliance: required - schema_ref: "schemas/v2/events/mplp-pipeline-stage-event.schema.json" - - # --- Physical Schema: mplp-runtime-execution-event.schema.json --- - - id: runtime_execution - title: "RuntimeExecutionEvent" - description: "**RECOMMENDED** - Runtime execution lifecycle tracking (agents, tools, LLMs)" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-runtime-execution-event.schema.json" - - # --- Physical Schema: mplp-event-core.schema.json (Generic) --- - - id: import_process - title: "ImportProcessEvent" - description: "Project import, repository scanning, semantic card generation" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: intent - title: "IntentEvent" - description: "User intentions, actor actions, input channels" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: delta_intent - title: "DeltaIntentEvent" - description: "Intent deltas, change requests" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: impact_analysis - title: "ImpactAnalysisEvent" - description: "Impact assessment results" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: compensation_plan - title: "CompensationPlanEvent" - description: "Compensation planning for intent execution" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: methodology - title: "MethodologyEvent" - description: "Methodology selection and execution tracking" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: reasoning_graph - title: "ReasoningGraphEvent" - description: "Reasoning graph construction and evolution" - compliance: optional - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: cost_budget - title: "CostAndBudgetEvent" - description: "Cost tracking and token usage" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - - - id: external_integration - title: "ExternalIntegrationEvent" - description: "External system integration activities" - compliance: recommended - schema_ref: "schemas/v2/events/mplp-event-core.schema.json" - -# Profile-Level Event Families -profile_events: - - id: sa_profile - title: "SAEvent" - description: "Single Agent Profile events" - schema_ref: "schemas/v2/events/mplp-sa-event.schema.json" - doc_ref: "docs/03-profiles/sa-events.md" - - - id: map_profile - title: "MAPEvent" - description: "Multi-Agent Profile events" - schema_ref: "schemas/v2/events/mplp-map-event.schema.json" - doc_ref: "docs/03-profiles/map-events.md" diff --git a/packages/npm/sdk-ts/schemas/taxonomy/integration-event-taxonomy.yaml b/packages/npm/sdk-ts/schemas/taxonomy/integration-event-taxonomy.yaml deleted file mode 100644 index 4177051b6..000000000 --- a/packages/npm/sdk-ts/schemas/taxonomy/integration-event-taxonomy.yaml +++ /dev/null @@ -1,436 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -version: "1.0.0" -title: "MPLP Integration Event Taxonomy v1.0" -description: "Defines 4 Integration Event families for external tool integration (IDE, CI, Git, Tools). Binds to schemas/v2/integration." - -metadata: - last_updated: "2025-11-30" - compliance_level: "optional" # L4 Event Family Specification - keywords: - [ - "MPLP", - "Multi-Agent Lifecycle Protocol", - "Agent OS Protocol", - "AI Agent", - "Observable", - "Governed", - "Vendor-neutral", - "Integration Event Taxonomy", - "IDE integration", - "CI integration", - "Git integration", - ] - -# Relationship to Phase 3 Observability -observability_integration: - parent_event: "ExternalIntegrationEvent" # From Phase 3 - usage_pattern: | - Integration events typically appear as ExternalIntegrationEvent.payload: - { - "event_family": "ExternalIntegrationEvent", - "event_type": "tool_execution" | "file_update" | "git_operation" | "ci_pipeline", - "payload": - } - -# Integration Event Families -families: - # ======================================== - # 1. TOOL_EVENT - # ======================================== - tool_event: - description: "External tool invocation and results (formatters, linters, test runners, generators)" - compliance_level: "recommended" - - typical_sources: - - "IDE plugins (ESLint, Prettier, Black, etc.)" - - "Command-line tools (pytest, npm test, etc.)" - - "Code generators (Copilot, CodeWhisperer, etc.)" - - recommended_triggers: - - "Tool invocation initiated" - - "Tool execution completed" - - "Tool execution failed" - - minimal_fields: - tool_id: - type: "string" - required: true - description: "Unique identifier for the tool" - example: "eslint-v8.50.0" - - tool_kind: - type: "enum" - required: true - values: ["formatter", "linter", "test_runner", "generator", "other"] - description: "Category of tool" - - invocation_id: - type: "string" - format: "uuid-v4" - required: true - description: "Unique identifier for this specific invocation" - example: "550e8400-e29b-41d4-a716-446655440000" - - status: - type: "enum" - required: true - values: ["pending", "running", "succeeded", "failed", "cancelled"] - description: "Current execution status" - - started_at: - type: "string" - format: "iso-datetime" - required: false - description: "Invocation start timestamp" - - completed_at: - type: "string" - format: "iso-datetime" - required: false - description: "Invocation completion timestamp" - - exit_code: - type: "integer" - required: false - description: "Tool process exit code (if applicable)" - - output_summary: - type: "string" - required: false - description: "Brief summary of tool output or errors" - - args: - type: "array" - items_type: "string" - required: false - description: "Command-line arguments passed to tool (optional)" - - working_directory: - type: "string" - required: false - description: "Working directory where tool was executed (optional)" - - use_cases: - - "Track linting violations over time" - - "Correlate test failures with code changes" - - "Monitor formatter application patterns" - - # ======================================== - # 2. FILE_UPDATE_EVENT - # ======================================== - file_update_event: - description: "IDE file changes (save, refactor, batch modify)" - compliance_level: "recommended" - - typical_sources: - - "IDE file watchers (VS Code, IntelliJ, etc.)" - - "File system monitors" - - "Version control pre-commit hooks" - - recommended_triggers: - - "File saved in IDE" - - "File created in workspace" - - "File deleted from workspace" - - "File renamed/moved" - - "Batch refactor operation completed" - - minimal_fields: - file_path: - type: "string" - required: true - description: "Path to the file (absolute or workspace-relative)" - example: "src/components/App.tsx" - - change_type: - type: "enum" - required: true - values: ["created", "modified", "deleted", "renamed"] - description: "Type of file change" - - workspace_root: - type: "string" - required: false - description: "Workspace root directory (for resolving relative paths)" - example: "/Users/dev/project" - - change_summary: - type: "string" - required: false - description: "Brief description of changes (e.g., 'Added error handling')" - - timestamp: - type: "string" - format: "iso-datetime" - required: true - description: "When the change occurred" - - lines_added: - type: "integer" - required: false - description: "Number of lines added (if applicable)" - - lines_removed: - type: "integer" - required: false - description: "Number of lines removed (if applicable)" - - previous_path: - type: "string" - required: false - description: "Previous path (for renamed files)" - - encoding: - type: "string" - required: false - description: "File encoding (e.g., 'utf-8')" - - language: - type: "string" - required: false - description: "Programming language or file type (e.g., 'typescript', 'python')" - - use_cases: - - "Trigger PSG node updates on file changes" - - "Track edit patterns for learning samples" - - "Correlate file changes with plan execution" - - # ======================================== - # 3. GIT_EVENT - # ======================================== - git_event: - description: "Git operations (commit, push, branch/merge/tag)" - compliance_level: "recommended" - - typical_sources: - - "Git hooks (pre-commit, post-commit, pre-push)" - - "Git hosting webhooks (GitHub, GitLab, Bitbucket)" - - "IDE Git integrations" - - recommended_triggers: - - "Commit created" - - "Push to remote" - - "Branch created/deleted" - - "Merge completed" - - "Tag created" - - minimal_fields: - repo_url: - type: "string" - required: true - description: "Repository URL or identifier" - example: "https://github.com/org/repo.git" - - commit_id: - type: "string" - required: true - description: "Commit SHA or identifier" - example: "abc123def456" - - ref_name: - type: "string" - required: true - description: "Branch, tag, or ref name" - example: "refs/heads/main" - - event_kind: - type: "enum" - required: true - values: - ["commit", "push", "merge", "tag", "branch_create", "branch_delete"] - description: "Type of Git operation" - - author_name: - type: "string" - required: false - description: "Commit author name" - - author_email: - type: "string" - required: false - description: "Commit author email" - - commit_message: - type: "string" - required: false - description: "Commit message (first line or summary)" - - timestamp: - type: "string" - format: "iso-datetime" - required: true - description: "When the Git operation occurred" - - files_changed: - type: "integer" - required: false - description: "Number of files changed in commit" - - insertions: - type: "integer" - required: false - description: "Total lines inserted" - - deletions: - type: "integer" - required: false - description: "Total lines deleted" - - parent_commits: - type: "array" - items_type: "string" - required: false - description: "Parent commit SHA(s) - multiple for merges" - - use_cases: - - "Record commits in PSG for audit trail" - - "Trigger CI pipelines on push" - - "Track collaboration patterns via commit history" - - # ======================================== - # 4. CI_EVENT - # ======================================== - ci_event: - description: "CI pipeline execution status" - compliance_level: "recommended" - - typical_sources: - - "CI platform webhooks (GitHub Actions, GitLab CI, Jenkins, CircleCI)" - - "CI pipeline monitoring tools" - - recommended_triggers: - - "Pipeline started" - - "Pipeline stage completed" - - "Pipeline succeeded" - - "Pipeline failed" - - "Pipeline cancelled" - - minimal_fields: - ci_provider: - type: "string" - required: true - description: "CI platform identifier" - example: "github-actions" - values_suggested: - [ - "github-actions", - "gitlab-ci", - "jenkins", - "circleci", - "travis-ci", - "other", - ] - - pipeline_id: - type: "string" - required: true - description: "Pipeline or workflow identifier" - example: "build-and-test" - - run_id: - type: "string" - required: true - description: "Unique identifier for this pipeline run" - example: "123456789" - - status: - type: "enum" - required: true - values: ["pending", "running", "succeeded", "failed", "cancelled"] - description: "Current pipeline status" - - started_at: - type: "string" - format: "iso-datetime" - required: false - description: "Pipeline start timestamp" - - completed_at: - type: "string" - format: "iso-datetime" - required: false - description: "Pipeline completion timestamp" - - branch_name: - type: "string" - required: false - description: "Git branch that triggered the pipeline" - - commit_id: - type: "string" - required: false - description: "Commit SHA that triggered the pipeline" - - run_url: - type: "string" - required: false - description: "URL to view pipeline run details" - - duration_ms: - type: "integer" - required: false - description: "Pipeline execution duration in milliseconds" - - trigger_kind: - type: "enum" - required: false - values: ["push", "pull_request", "schedule", "manual", "tag", "other"] - description: "What triggered the pipeline" - - stages: - type: "array" - required: false - description: "Pipeline stages and their statuses" - items: - stage_name: - type: "string" - required: true - status: - type: "enum" - required: true - values: - [ - "pending", - "running", - "succeeded", - "failed", - "cancelled", - "skipped", - ] - duration_ms: - type: "integer" - required: false - - use_cases: - - "Correlate CI results with plan execution" - - "Trigger rollback on CI failure" - - "Track build times and success rates" - -# Compliance Summary -compliance: - v1_0_requirements: - required: [] # Integration events are NOT REQUIRED for v1.0 - recommended: - - "tool_event: When integrating external tools" - - "file_update_event: When integrating IDE file watchers" - - "git_event: When integrating Git operations" - - "ci_event: When integrating CI pipelines" - optional: - - "Bidirectional integration patterns" - - "Real-time event streaming" - - if_implemented: - must_conform_to: "Integration schemas in schemas/v2/integration/" - must_validate_against: "Integration invariants in schemas/v2/invariants/integration-invariants.yaml" - - relationship_to_observability: - note: | - Integration events appear as ExternalIntegrationEvent.payload (from Phase 3). - ExternalIntegrationEvent provides envelope (event_id, timestamp, event_family). - Integration schemas define payload structure. diff --git a/packages/npm/sdk-ts/schemas/taxonomy/learning-taxonomy.yaml b/packages/npm/sdk-ts/schemas/taxonomy/learning-taxonomy.yaml deleted file mode 100644 index 1977b81df..000000000 --- a/packages/npm/sdk-ts/schemas/taxonomy/learning-taxonomy.yaml +++ /dev/null @@ -1,291 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -# ============================================================ -# MPLP Learning Sample Taxonomy v1.0 -# Source of Truth: schemas/v2/learning/*.schema.json -# ============================================================ - -version: "1.0.0" -title: "MPLP Learning Sample Taxonomy" -description: "Authoritative taxonomy of LearningSample families and collection points, derived from frozen JSON schemas." -keywords: - [ - "MPLP", - "Multi-Agent Lifecycle Protocol", - "Agent OS Protocol", - "AI Agent", - "Observable", - "Governed", - "Vendor-neutral", - "Learning Sample Taxonomy", - "learning families", - "collection points", - "learning schema", - ] - -# Governance -status: "Frozen" -freeze_date: "2025-12-03" - -# ============================================================ -# SAMPLE FAMILIES -# From: mplp-learning-sample-core.schema.json#sample_family -# ============================================================ - -sample_families: - # -------------------------------------------------------- - # 1. Intent Resolution - # Schema: mplp-learning-sample-intent.schema.json - # -------------------------------------------------------- - - id: intent_resolution - title: "Intent Resolution Sample" - description: "Captures user intent clarification and plan generation" - schema_ref: "schemas/v2/learning/mplp-learning-sample-intent.schema.json" - - input_fields: - required: - - intent_id # Intent identifier from IntentEvent - - raw_request_summary # Abstracted user request (PII-scrubbed) - optional: - - constraints_summary # Timeline, budget, resources - - dialog_turns_count # Dialog exchanges before resolution - - state_fields: - - project_phase # greenfield, brownfield, maintenance - - psg_node_count # PSG size before intent - - existing_plan_count # Existing plans in context - - output_fields: - required: - - final_intent_summary # Refined intent after resolution - optional: - - plan_id # Generated Plan UUID - - plan_step_count # Steps in generated plan - - resolution_quality_label # good, acceptable, bad, unknown - - meta_extensions: - - clarification_rounds # Rounds needed before resolution - - ambiguity_flags # vague_scope, missing_constraints, etc. - - # -------------------------------------------------------- - # 2. Delta Impact - # Schema: mplp-learning-sample-delta.schema.json - # -------------------------------------------------------- - - id: delta_impact - title: "Delta Impact Sample" - description: "Captures change effect analysis and compensation planning" - schema_ref: "schemas/v2/learning/mplp-learning-sample-delta.schema.json" - - input_fields: - required: - - delta_id # Delta Intent identifier - - intent_id # Original intent being modified - - change_summary # Abstracted summary of change - optional: - - delta_type # refinement, correction, expansion, reduction, pivot - - state_fields: - - affected_artifact_count # Artifacts potentially affected - - risk_level # low, medium, high, critical - - psg_complexity_score # PSG complexity metric - - output_fields: - required: - - actual_impact_summary # Impact after analysis - - impact_scope # local, module, system, global - optional: - - comp_plan_required # Compensation plan needed? - - comp_plan_applied # Compensation applied? - - rollback_used # Rollback triggered? - - meta_extensions: - - impact_analysis_duration_ms # Time on impact analysis - - predicted_vs_actual_accuracy # accurate, underestimated, overestimated - - # -------------------------------------------------------- - # 3. Pipeline Outcome - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: pipeline_outcome - title: "Pipeline Outcome Sample" - description: "Captures pipeline stage success/failure patterns" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema with pipeline-specific input/output" - - recommended_input_fields: - - pipeline_id - - stage_id - - stage_config - - recommended_output_fields: - - status # completed, failed, skipped - - duration_ms - - error_info # If failed - - # -------------------------------------------------------- - # 4. Confirm Decision - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: confirm_decision - title: "Confirm Decision Sample" - description: "Captures approval/rejection decisions and reasoning" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema with confirm-specific input/output" - - recommended_input_fields: - - confirm_id - - target_type # plan, step, delta - - target_id - - risk_label - - recommended_output_fields: - - decision # approve, reject, override - - reasoning - - decided_by_role - - # -------------------------------------------------------- - # 5. Graph Evolution - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: graph_evolution - title: "Graph Evolution Sample" - description: "Captures PSG structural changes over time" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema; also see common/learning-sample.schema.json for graph_before/graph_after" - - recommended_input_fields: - - trigger_event_id - - change_type # node_added, edge_added, attribute_changed - - recommended_state_fields: - - psg_snapshot_before_id - - node_count_before - - edge_count_before - - recommended_output_fields: - - psg_snapshot_after_id - - nodes_added - - edges_added - - topology_change_score - - # -------------------------------------------------------- - # 6. Multi-Agent Coordination - # Schema: mplp-learning-sample-core.schema.json (base) - # -------------------------------------------------------- - - id: multi_agent_coordination - title: "Multi-Agent Coordination Sample" - description: "Captures SA/MAP collaboration patterns" - schema_ref: "schemas/v2/learning/mplp-learning-sample-core.schema.json" - note: "Uses Core schema with MAP-specific input/output" - - recommended_input_fields: - - session_id - - coordination_mode # turn_based, parallel, hierarchical - - participant_count - - initiator_role - - recommended_output_fields: - - total_turns - - handoffs_count - - outcome # success, partial, failed - - duration_ms - -# ============================================================ -# COLLECTION POINTS -# ============================================================ - -collection_points: - - id: intent_resolution - description: "When user intent is successfully parsed and clarified" - trigger_events: - - IntentEvent - - SAPlanEvaluated - sample_families: [intent_resolution] - priority: HIGH - - - id: plan_generation - description: "When a Plan is generated from user request" - trigger_events: - - SAPlanEvaluated - sample_families: [intent_resolution] - priority: HIGH - - - id: plan_revision - description: "When user modifies or rejects a Plan" - trigger_events: - - DeltaIntentEvent - sample_families: [delta_impact] - priority: HIGH - - - id: impact_analysis_completion - description: "When impact analysis finishes" - trigger_events: - - ImpactAnalysisEvent - sample_families: [delta_impact] - priority: MEDIUM - - - id: execution_completion - description: "When a Plan step completes (success or failure)" - trigger_events: - - SAStepCompleted - - RuntimeExecutionEvent - sample_families: [pipeline_outcome] - priority: HIGH - - - id: pipeline_failure - description: "When a pipeline stage fails" - trigger_events: - - PipelineStageEvent(status=failed) - sample_families: [pipeline_outcome] - priority: HIGH - - - id: user_feedback - description: "When user provides explicit approval/rejection" - trigger_events: - - ConfirmDecisionAdded - sample_families: [confirm_decision] - priority: HIGH - - - id: graph_update - description: "When PSG structure changes significantly" - trigger_events: - - GraphUpdateEvent - sample_families: [graph_evolution] - priority: MEDIUM - - - id: map_session_completion - description: "When a MAP collaboration session ends" - trigger_events: - - MAPSessionCompleted - sample_families: [multi_agent_coordination] - priority: MEDIUM - -# ============================================================ -# INVARIANTS REFERENCE -# Source: schemas/v2/invariants/learning-invariants.yaml -# ============================================================ - -invariants_summary: - core_invariants: - - learning_sample_id_is_uuid # sample_id must be UUID v4 - - learning_sample_family_non_empty # sample_family required - - learning_sample_created_at_iso # created_at must be ISO 8601 - - learning_sample_has_input_section # input required - - learning_sample_has_output_section # output required - - learning_sample_feedback_label_valid # enum validation when present - - learning_sample_source_flow_non_empty # non-empty when present - - intent_family_invariants: - - learning_intent_has_intent_id # intent_id required for intent_resolution - - learning_intent_quality_label_valid # enum validation when present - - delta_family_invariants: - - learning_delta_has_delta_id # delta_id required for delta_impact - - learning_delta_scope_valid # impact_scope must be valid enum - - learning_delta_risk_valid # risk_level must be valid enum diff --git a/packages/npm/sdk-ts/schemas/taxonomy/module-event-matrix.yaml b/packages/npm/sdk-ts/schemas/taxonomy/module-event-matrix.yaml deleted file mode 100644 index 31eb780e1..000000000 --- a/packages/npm/sdk-ts/schemas/taxonomy/module-event-matrix.yaml +++ /dev/null @@ -1,253 +0,0 @@ -# MPLP Protocol v1.0.0 – Frozen Specification -# Freeze Date: 2025-12-03 -# Status: FROZEN (no breaking changes permitted) -# Governance: MPLP Protocol Governance Committee (MPGC) -# © 2026 Jearon Wong -# License: Apache-2.0 -# Any normative change requires a new protocol version. - -version: "1.0.0" -title: "MPLP Module Event Matrix v1.0" -description: "Machine-readable mapping of L2 Modules to Event Families for observability coverage validation" - -# Module → Event Family Mapping -module_event_mapping: - # --- Context Module --- - - module_id: context - module_name: "Context Module" - primary_events: - - family: import_process - event_types: ["import_started", "import_completed", "import_failed"] - trigger: "Project initialization and scanning" - - family: graph_update - event_types: - ["context_created", "context_updated", "world_state_changed"] - trigger: "Context state mutations" - secondary_events: - - family: intent - event_types: ["context_intent_received"] - trigger: "Intent associated with context" - - # --- Plan Module --- - - module_id: plan - module_name: "Plan Module" - primary_events: - - family: pipeline_stage - event_types: - [ - "plan_status_changed", - "step_started", - "step_completed", - "step_failed", - ] - trigger: "Plan and step lifecycle transitions" - compliance: required - - family: graph_update - event_types: - [ - "plan_created", - "step_added", - "step_removed", - "dag_edge_added", - "dag_edge_removed", - ] - trigger: "Plan DAG structural changes" - compliance: required - secondary_events: - - family: methodology - event_types: ["methodology_selected"] - trigger: "Plan strategy selection" - - family: impact_analysis - event_types: ["impact_assessed"] - trigger: "Change impact evaluation" - - # --- Trace Module --- - - module_id: trace - module_name: "Trace Module" - role: "consumer" - description: "Consumes and persists all events from other modules" - primary_events: [] - secondary_events: - - family: cost_budget - event_types: ["trace_cost_summary"] - trigger: "Aggregate cost tracking" - - # --- Role Module --- - - module_id: role - module_name: "Role Module" - primary_events: - - family: graph_update - event_types: - [ - "role_created", - "role_updated", - "capability_granted", - "capability_revoked", - ] - trigger: "Role definitions and permission changes" - secondary_events: [] - - # --- Confirm Module --- - - module_id: confirm - module_name: "Confirm Module" - primary_events: - - family: pipeline_stage - event_types: ["confirm_created", "confirm_pending", "confirm_resolved"] - trigger: "Approval workflow lifecycle" - - family: graph_update - event_types: ["confirm_created", "decision_added"] - trigger: "Confirm object mutations" - secondary_events: - - family: reasoning_graph - event_types: ["approval_reasoning"] - trigger: "Decision rationale capture" - - # --- Dialog Module --- - - module_id: dialog - module_name: "Dialog Module" - primary_events: - - family: intent - event_types: - ["user_message_received", "intent_extracted", "intent_classified"] - trigger: "User interaction capture" - - family: delta_intent - event_types: ["modification_requested", "clarification_received"] - trigger: "Intent updates and changes" - secondary_events: [] - - # --- Collab Module --- - - module_id: collab - module_name: "Collab Module" - primary_events: - - family: pipeline_stage - event_types: - ["session_started", "session_completed", "session_cancelled"] - trigger: "Session lifecycle" - - family: runtime_execution - event_types: - [ - "turn_dispatched", - "turn_completed", - "broadcast_sent", - "broadcast_received", - ] - trigger: "Turn and broadcast execution" - secondary_events: - - family: reasoning_graph - event_types: ["coordination_reasoning"] - trigger: "Multi-agent reasoning capture" - - # --- Extension Module --- - - module_id: extension - module_name: "Extension Module" - primary_events: - - family: runtime_execution - event_types: - [ - "extension_activated", - "tool_execution_started", - "tool_execution_completed", - "llm_call_started", - "llm_call_completed", - ] - trigger: "Extension and tool execution" - - family: external_integration - event_types: ["external_api_call", "webhook_received"] - trigger: "External system interactions" - secondary_events: [] - - # --- Network Module --- - - module_id: network - module_name: "Network Module" - primary_events: - - family: graph_update - event_types: - ["network_created", "node_added", "node_removed", "topology_changed"] - trigger: "Network topology mutations" - secondary_events: - - family: runtime_execution - event_types: - ["node_status_changed", "connection_established", "connection_lost"] - trigger: "Node runtime status" - - # --- Core Module --- - - module_id: core - module_name: "Core Module" - primary_events: - - family: pipeline_stage - event_types: - ["protocol_initialized", "module_enabled", "module_disabled"] - trigger: "Protocol lifecycle" - secondary_events: - - family: cost_budget - event_types: ["budget_warning", "budget_exceeded"] - trigger: "Budget policy enforcement" - - family: compensation_plan - event_types: ["rollback_planned", "rollback_executed"] - trigger: "Error recovery" - -# Event Family → Module Reverse Mapping -event_family_producers: - graph_update: - producers: [context, plan, role, confirm, network] - compliance: required - - pipeline_stage: - producers: [plan, confirm, collab, core] - compliance: required - - runtime_execution: - producers: [collab, extension, network] - compliance: recommended - - import_process: - producers: [context] - compliance: recommended - - intent: - producers: [context, dialog] - compliance: recommended - - delta_intent: - producers: [dialog] - compliance: optional - - cost_budget: - producers: [trace, core] - compliance: recommended - - external_integration: - producers: [extension] - compliance: recommended - - methodology: - producers: [plan] - compliance: optional - - reasoning_graph: - producers: [confirm, collab] - compliance: optional - - impact_analysis: - producers: [plan] - compliance: optional - - compensation_plan: - producers: [core] - compliance: optional - -# Compliance Summary -compliance_requirements: - required_event_families: - - graph_update - - pipeline_stage - - required_producers: - graph_update: [context, plan] - pipeline_stage: [plan] - - validation_rules: - - id: all_modules_emit_required - description: "All active modules must emit required event families for their scope" - - id: trace_receives_all - description: "Trace module must receive and persist all emitted events" diff --git a/packages/npm/validator/LICENSE.txt b/packages/npm/validator/LICENSE.txt deleted file mode 100644 index 3126996caa853c5359201689a4ea6f82e1920c97..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22950 zcmeI4TW=i45ryYDK>ovqKoA-5HL;V}exh}Wl{k_h%2o`+4-_R)N_bJYq-o{HC#kOw zkE<^;+?5@`FM%L(xjWNcms6*zt9$l8|6WZ$_22IFYTBO;rWez*80(AaWxReiolNWa z`OE1SKXUx9;_kB;BynpTPr z!cMCg<=ON+ag2qE`yl?K0drr3M_AIJaGxLcnv596K2ofk##lel9W ztD)s)yJ4eOAsw19|9P4HGV}!NNWxEI2OZCg9{WY(7v-~;)4$?VY=Vx7JlV_M*)$8+ z?U%Ww?_tb}t(o&A=E>K1q3ciwGCOXK#hm zxDS-JmV6oS;M>$)cm-9bAvwr|Pnf&?X{DZH0soF7D!87<5 z1g1o_mc;O#tGT4lDv)y#^Sp|8i6yj2n;E%|gpB$zu68;N@snemQE!B7Z^iGN_cY{1 zNAxEeu@nBWHNZ{%KG&Uxbl3#^BCp5mEmPl@Siqjgaqmg|Ka9JP4`f;Ab&N{JX`_XC zFN^mjJEMpV(*8o0B=2QO?BE|WmOPGCWEZTVh=nCzhDR(FEc862BrClNiO)ht%Y9?| zD6-VAi)A$;ND<=Fk7LG!tIk7~^I{FGr5F`MbN{;drIu21J}Gkx5eIRfB6L~$d7Cap z{nsJ=Md7>~MUPdy)_X7^_?gck$|Oe2cOe&fz_Q`7FGB7)KIy&nZ2CT~#K!o_c9GqW z%X_XKKy|WQGN>@A*x8Qj_KMc>D{-UzcD$%<#t@!*UgYH!9G>?&OM>`+{GbW=z~7*X zIC9>@-@Pr+{vdelqTC^bC|9oH6L7tXPhUnH!3>&T5xR~~!R%$sAT;t0OapesYA~E) zzs-y(Q!h_F26sA_D-O}g<-{LNGo*oRZ!|NqObMtcQHa%?#jC4f@D`&8f;?=_>!ny_WR?w_beh~ zb477^b!FNb_Ehy`ww}upSiScObM`i`5!m{T*dmT?p% zSPNOOjbgrLtNlS9yxdom!i830VmN%qxE|e1p|PdAkjs^18m;C)jab4m+rGVBZp1xU z5Ki8YSbBA(x8_v6FRriW^r);LL4frBKE@$;9ffX}kx7==;8t8iC5^R-F>tqkDB37|ROBU+wV5VV2w5u)uB>tkNP%L6CXHHd+(m?&KNEJ^_+H9gy~U6Nd=USt zl`;}w2ehL?R|XQwq{m@MPkne)dGflr-=?PSrOV1}u1Y}CO(<;ZAagd7XA~w9#g@hm zR)JTzx|a-V(WSr}W*KKPcJc z`r|`bpWKE$j{@JqMlacR`fS5zHTJ|{ z2c(u%r67{%mQOvN`2?A?YVKvCu64fl-Pd`Sk!!}}S}G~lV@SvfdmUb)3dMe`Zd@7C z1Ib#-ov2uSf8C4Cc?gwKeQo!GZP3jSsv1Np~%`)*u^WW97dGk1W8 z<@`K)-JUbgpv{}Ib1&Bt8eM171-MS%Rq-qKfyJp;#V6E5S-;EPOB(euiFe_)f0ii3 z&O!zngB*2zRd>tJ?jLi7<0#iYebvO?*=qVzjDsz+i;7qK)nhI7vvS{FNR=xdW~3+afX?C{|qNvV#ce5%eMKhHxWWuac4 z%VO=Lz!?@M#*l=n{bYJ4{xS;?dE^U!`c9FQIHs4vyD-h`G7J5UcS3jajy|J<&R^ff zHLUVgzxT4>`QAH6F|T^c;Kf=xqj^tFvna=Djli{=E5G?_9=1h7W)?2Rw5;*>LpQV? zuaUJ~8*q(q-fF=6j&qG#bBr{^%e`&P*m*aj3oV=VRMfORI3cQD+h>2LkEh=)#M6V& zg?LbmwTLDH{~t*|PbA$4pAfm!eadJsg!WY0%$a;deC7Tz>tP}(z1!m0kw`8llY?t2 z060P!UR=`SIQPYgJ?#&8EF@qDUa^y}>Eg2scox#s@iW#8j3mydTTLf`cZjFV731n% zJ7{o&qDl7{EKLFr?Ta^MiIOd&|Kh^fZ(+>T#EtQ2d?|zLXEL>T+#LS6jV` zb<9b(ATukB3=_cEu3K#%7`pe>IIGqrHv&oEgN%X|u$$OKa>L`t!Jy0qg1nl+Q8ck{S=FlN=ra=NFj~KtM_9PNs+4A2smK=7fJ%FrE5^CJ>T9iz_sFKiFdQ~7 z5thIX*+XM~EZzEynd?}g2f%%BkJtpsT&1`7*3r#+rI#dYHpO6Dwe`CubCsgAv}BP- zvO1{upyhFTQC>0i(g^o;Tw+K0qUXX9#gfjum`{h^<%gweco^0jD;-53@#Tt@OoA`Q z+D^6x8{;@c9DZe;nH^gDsn<8{B#dsZoaAq0l9hx?`yON<6KAJDhq3F}^WQ|^h|1;e zXPxCV1_vX5vER5wcQ_M3Nny^l=<%BY_G5thjfCCgkXlyQ9$4Nr0+*|racoQB; z?~?f$A4XA?U@K-G_u7&(Cis)6Beq+FZsWyX9^b=gFq1F?-g4}@X#2EW&pLcw%O?w3 z*5`n%XYFr!#j%4_Vgl}Ctt3{0*A>66v9+I~HPOf}SeWRwzk08uH&t5J0Kzxk_F05Y z8XqiZOpGu)bAv(Q*5kMM^(x8Mw}m#vWAD{bzd43bH0f-o{Z0mSgSmZ^_qE!eBbjmf1i~M1iH9FJqXZwR%+`A#D#bbZ;ofP-4B_!NSkxA7D6vu{fn3*yS;O(1DyvjpK9lb)5%M0*IS~uaf_8r zUf-6{K}VvS-uct8Y%hz}Ac|jX#yy;Nz>Ay_W^X2YOL(UBT+JDMZIM;O7q}L`_99mBmI3B{q}*z1#u}MXwAsb+G36kytZvQ(EjeNEL_0;?vT3rZ@UXf2Dfb9i|TEpsNU`= zC9$kIbk6(AhTGVOxInulc|Z+(kT~2Nk&Yj7NPTjywKZ$tl+a!1UJm$A_w~>tb?@9Po4bh&c6SLQHNd7sz2|@Mh_g+|#XDRUXiz_q|Cp~ksTHz#$c8ZjR zL8&mAvNPw!c~0CV-AEY#*OX~Hb*2T&2(BFTVD5imYI@cXNpuOnaMM#+c~`o*KFim)NsfqXmGI&`41qfT_?b?&eDq!)8>UI|ag&YTp| zr?OVd&&ceN&06+;ACn`?XqDRTlHv`{rD!(+#y4~D3E2kD$kn&=g3e)K7wH7bY#-qo zyKr7h`w#ZCr0pXcUFlHi&UU?Ne#)GLWVKz|v0ZzCbJ()CQ(IMfJ-&^^{L{YgbC~-rFamQ{8R)S+Z4o77QlranM)9 zAm5lt+tR^S#>eaQO?w%}$gB~nGqs8g5tf`3`|cfr#5hGLU~SR^jM-r+m-Ay*M>?JHFH4cCj7v^ZH?U?(-{q?#6c!+>H?! z=j$?xWVln_xffUO6?^+T4|WF&Jt+P`lAGbNFUnu5_%?(uW1a^g5#NzO?6}e(s$fHy zhk8pjj=aF`DSOa-QvjbOTfsKYe^_0XH`06SC<0kU!XrF0BeqCSlRe=xk0Y&-f~=)= zU4CCdyKc*Q{mL-;`hQ!CVN-Ybyn5rb74OSdtcg~>o)>6kQ zV--K)ZLWv&=T8&R1v`vc$Tdhq-hHc}S}~;l}yw52R zpK;SF4@@H~^)yVN%FWiJUeh@UBBZxZuPHWx*I{O{FX(xbyi(VxW~q_kWiur1B|?+T zcB-fx^R7AQ^HWdY9aTa2wPjPskJhHx+Wz8NqO*RFGud3h+?=)QrPBE7SbL{H}P%lV10< zwUa9{d4+k~C{@H{<)(P*ZIpaAA645uiQe1GK4;I}`4!eZjK4YQ3fs{M9({HhpHnBR z9{`8bR|YdgEk2{yptT9M;fXfJqKBIn17|#=L+s)s)g~GD_N3#DtB(f!Bs+L!I9`0r z9dkHACToqS#Xx3ADhTY5Y%m{Xy_Z;>fsZ`7&f0{!Ol!#+NmxPOG@@LZyzQ%U_SSEG zZuq$5hTX6rT*~=Nqr0z<85zxYLn@-w7MGRgGsxqDdS!Zix0HK(TL{P5+wk1Cif=fP zp{h$KGmLMn=ZvBgFrdL41zxDkh-?t5&X#zLsM86|5v|6L83CLU`{0uGwrd#Xf-P)E z?$f$ZF^xw+I#yJEYHLKD)W-VcjpO)@jpuTw{7@s;+}z?or^4&Ad{{{Oym#eIt=ssn zBR(@b{V^#Mg3?hRj(oE)__7EHl&xIRg?39H5@V7 zTLf9@L+EJ>=B3U;BF&NOcHx#R12=#jd?niq_Zh8IsK- z);i{VeJooC?dSAtIohV@Wma^zVs@={xBc!qbV+@7V}16ZtPS~Yy1&KQw^ghQiA$r! zoeU6Z&fN{P6J0uo-bS|XOY1n7_wuXj`Y2|@f;x--(`OM{+0~PTDK+S8Pc@_+Bnur~ zViyEyZ(a4cB3S&z_$}Ls-&w!&)Dbw;x0bzKwoJFA142 zPh5cHoHH$}C!^s_;+5K#*nb^ARekbXF-K-|HfAM$Baj2Ke-rPv{fx1yx7T~=e^pi) ztLPdC2iQtyl~_j*8`#6UrK3%dF1<6qUhnNf_Td}aq%G0>I!3|QeCLSy#S**o=TBq> z^nV;9fV!g+;Xb9AV3oAHkOq^h5k3&bPs$phO<%;ytg z$fJ9tTQ3jKMyT_!6SyH`V-;b~mGe%~1bo^)ShIgVt;V|TCbp-JBr^KBTlBR%$cfwZ z_S{JkG6j61leFVb09@Tm`c3#=|Go{Kz6p(O1KD*>J4Fmyd|UKLU0N2y-gWQ77Q2r5 zV1}=Xg|L*orSCi?-aNwiU7c@DpH?-xc#(mZ>49+Ny&Sq!}!kC zH_S3i&h%yIo)rkZ`sRHb#duayVu$NG^wbUYce15C;1Af{<$k+=%!O%;H>X|-!Kt#ns+{s=GS&-+1wH~AEptVN!j+c6y)RC99P|wVg)oNe-$2DJd<2FQT^- zSdZ za<-+RXJfg(L&};EbTxjWu~vF$GD7q3fy4>dM@%+<*jkS5rEm367Y~<~*RtMiR2tFyR+@3HG?Z2IlSmibnv1 zP52g2@L(iKu&T;Rj}WUejUVe82rA~@&cq)i@mbo{io7B@pE1&PK9zApF(0mGV(w7) zSNeCm_NHk)m&1C}eql}D`a}QuhaB+a zGloRKowsLNMcByKv1#C!kR2NmmA+o`#k)FJodPEjgez5gC$SWkNO1; zN)f>~B+sO-pMIAE2KMi;#;}Iw*YC@VLn(8@?J8a`w6&hORi2p8O=%tKQzAUl2)M!& zr_R)HHZ@1d$+5JjzOvQ5(h`5n$B|c>LMWG@SYU)EZ1sU;(!_2C0 zBOWGvTjgR$TbG9}1XGG3r<0?uJY4dvW+{`NaQ;p55K0KsnUyrs(xox;rB)DO=ms&u zk6ts7xv5!+YJgB_ymRc0+wfEW_4)MQJ}BXeO7% zjE)Ucsl|6@is`Ws-rX|T?-E1)vO4JvAxl3?rw2M#FQREkXT7b!xhVK}nkq`0py9zf zWJMdEFFEW55ga))+GX-zr&u32(7IvKAi^WvRf`=F^!!94F}?mEt&XX#0aPRgu>(P? zhQO@^ElA6fJTaTXvS!h4J@vhqjU>%^(9>RLoEOpe^_t^96~ZWzfoxBliqhYgpK|#v z)>O64&(%5P9nnkmcPbg(S-kp1b@cVuHZ!!*hHPt#v6TN4S$QCTUP<@4s?(8W-j&dl zk#8%8BaMT6Y;rhGRhd?2VQB|Du!+^Lj8$Y3*-RYBy5FSLt2zaFntm;CpK9lU#va*7 zraj@6a)ePDBYE5^G+_~AG|QHB5K)&79`^9@DsfiR5OXcfd-TyyCY6;Q&y-EpS@l>o z>+1q%Rf?lS#)sC9kjgLkO3C4u_sQsGY=TFAG}w?&{b+#axNf95Ml-wHk#DK#)D5cO z&1{`lH~+p7;`vXk%XE-;Ny}ISQ>ef6)5D7NOpgF}?V{!l6#MyI4`;g;+wHkL>OH6_ zrqS8RNVn-|CM!4YGFl$jyv`nL^-6&cPr1F}H_y|>)AbYSq?Xb2VQkrjIJ~cEh8zVK z5%F32V|gl$!|eB3g%te7<48R4ywd)uKF;)x<@%NKyjz)B~=jN4(#WQ-+?P#iXu`LOBl~WBd z;Lz)Ff*+lt*R~d(o0fU=|B+m`bW1pL*-Cx;*fw<(-%{Jhv#_qGWcspkWLGGcXdB4PBA>AP?Jt% jBNk2M2c96oN^R#nfOkudj5UuQ@H0A}>%1%3ve|zDvSTv{JRBu{eqKPaHEXoegP=18.0.0" - }, - "scripts": { - "build": "tsc", - "ci:build": "npm run sync-schemas && npm run build", - "sync-schemas": "node scripts/sync-schemas.mjs" - } -} \ No newline at end of file diff --git a/packages/npm/validator/schemas/events/mplp-map-event.schema.json b/packages/npm/validator/schemas/events/mplp-map-event.schema.json deleted file mode 100644 index 26539a4985e60c30456a4020301de4fe00e293b6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8378 zcmeHN+iu%N5S`}&MSp={TOa`0aL8w7}xz;XM~A`oPmQsl^%E6Qn|AV1L$ zZhOv-MtdP8QiXsjKp`+Dmphl8%bD3_{{HK|d@7$vhF>mU$UvrYiC-aCGRMe6H-0QH z)Y%@EJ)duVw6>3;eyn z#nB8@1*H5AnKOBV=TkfnF!u^06I>&?#pqMazr;1i+jBhs;B>rpy!oDT9|@mHTSy1e zsiVGmjM;B7Is;c~Gr&Dp#Wg(!uUzg$7AO~7E-~BI{~EIAknm9U@Vmfzrr^}UUzNzY zU5w43@g8)X;duy(4z&0dBjLQyD-y?`NF|jES(lJH!PUi_0_%u*m3TIf?78>qH;x-+ z2X}pN=mhV(kw)F+ieg*Loy{kpGwpmF9K+&_ha+cO#)^-Pm<#ph`e)#Fjd^2dJLBl- zOK>O_el|~^IsYHa4QxQl4y2ASOXa-)&nfIY#@hnaci>ZMbr<)H;|YF!IdgvLFC}Nt zh8mR%O(>V~s1XrIc?OLsV~$HX#%r5HziV)_)l4Dn0?z|b#50u-=gyoa)Ih0x{%H=< z%eulI^s>l^XX(sTdI`?7GIJ}G&e=*abhcnT_}spMbybef15dHudp|+eSbhTs+Mirh z^Re>^*P7vud67XPF+ja+E6kUfM~NSTOjLbCTg0o~jyOKo@*?r1hglXDlLtidL`F4l5~6sxPk6U5tdSmitU1{L&yLyvSN8Ttn1 z0g>BVg!UZZ$E=xQobeX=tBNskHQ0U3Wkj~CY?(Yk_OLDvK%@335d+MxbNH8-JjK5u z$F7@e{M8zF8*Rv%!~SgSyiZv@T#9*hRqo$L-1?j{l(lthX0h&QbqaN~4zwTi6L+Ao z?@;=%@;z9GGFi9HX0%=$ah5sFcG8-`4rU%$sJ;`Zw-IX&yUW|!nv**(u!~yFvz~9< zJA@g-`DxZDkM-VowA9ovE?j-Kj1Tn|qj6oQz$h-z1&?siD`$>AtWb<*T1Ty0q6=)w zd{)z2cv&l5`#4?I<$?9O@>|IvPJ`qt+7YP*~85ou^_ zUaHr{&-b3<%;s*uQ*OG)@RaNE#G^YS(>hAS@k0J^qc<*+6r)+)-eB}9K?0K)#=DL2 zZ|GUwADn^9Y>@#~4;n4$;{71CW7kSdBE63;qp`nD9TB@y-Di;_>+A%YS_Ed0!+nhD zX*prs`FGuF%}yV0bR4bqfBoJxt`BA_kB5Gw>bG|IXdF0OyCJi1l_Te_j=a>Pua>Ay zy41HJANGEF7G%4>|B4*1TTV!Id$r_;NPqEeY1caTaW$mi?+cY*d#qy5>m5A~s zP>m;lt9mok)~=(;nZvKJ+wQ?PdLp!2 zXj0XbmDle^4SzSynRtIxpP}l>_3`Ap7_}dJcl{Pp)qHb&@cW;h+sEIy{$um(*&aeX z3;L4!eW2fgbI+P)i{?rwxVnhkdWrwx-I=6)q2bKKD65X^SXg8?msP!vNN4J3% z)yS&PiB(n(_tkM+rP?-iB~?wBnZBFndEIW|Nvz#&B8l%hVr}`Yv}*B9b4+WTo*ELf z{<|y-zx}0Jv8&=)X8ZM~vAc~-i|t<*EveKrW9)sXO^(ikUvc$IFz?vO+t=xMKbm6} z_Zt3-<iFbPNCh diff --git a/packages/npm/validator/schemas/events/mplp-sa-event.schema.json b/packages/npm/validator/schemas/events/mplp-sa-event.schema.json deleted file mode 100644 index 00546de6c4fe58041e59f66363d2b9d98b9f11cd..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 5748 zcmeHL*>2NN5S?cv#4lI|B#=l7MJ(b4u~wA|RJ8B_LRIQI#gI0^Nm#{C@WH@2cQU<8 z+&Bdu`hX%Q@%5}{=FZIZubJAzVskxU&iuQDtBMv_Z=>-X5cEJi7|KCFQ1RCzh3O?`P&k&M2_*IRh?P9Hl#VfF}#(f_g z9awP-DpWkY_npQ!PBfSB4FVi9}$ zZ}6bCQ{bVIcpX{eF<|DbJ5QOHJ!C;8U*R2NGmn{CP99btW?w0v@x6h&oY-M(^A95e|@Nd+(!!@$_S2b=;%DnO5i7&~NS=V#Nv7cS+*Y zh6Ve**3{FFhOhsIhgKBUjnMC~y6C(>3hsy6?aKBV!}h2V)+=W9qkxB6t2w2n_RY@_IXu|IhbI}GggFOn0)e5Eo6eBT1I}P^?X|nG z3g@6K-NaV8e?*gWU_ATepfO)8vtlb_3g69AD(g#OPfTgTo?teIJ^iF;^nu<05h#PX zfG1W?r+ut9WrTL%66o&C>bcENJ9F_OUdzm%?fJCqslaC-aa1c8oeey_kBm^Eb@1aGmk9lh_Wl^BiSorgQp=ifS#BSC zEYi5AI^HCEe}0cy-msGDiQgvu{~7MzU-{E;ityqLXM8w|PmifD7D@iLWp*69m~)vE zt8wJ6YsRr|Iv*Il+Q#bXPjpQvkS@+QlhBmuDwSPl40Hy-sHy&%1f@=Qeq2eLZ2BJM zKczI;^0&LLIWpQieDqWMVywKSp@li-;LdDcj@&=)PJ6EySEw8vDSj*U66n^zH-2m8 z-@m3&&(Q}dfp0MmXYsHZBKA=!OVE+_q04cr-TBe`+YU~RtFZd2T!*w&!ag){nh4*k PY7XSVyH!I?@zL+!5;gcv diff --git a/packages/npm/validator/schemas/mplp-collab.schema.json b/packages/npm/validator/schemas/mplp-collab.schema.json deleted file mode 100644 index c4c0c4206074084a0e277391424517fddf3c0a08..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 16244 zcmds8TW=dh6rN`!#9y$Mq86!6Xb~6n1(gJpnHS z=Gc+xV|CIfcb=j58?;U_E2$acH@PBD&oEbE9+o69Tg-BX-pc<8)}CX9CuSXgufWd) zGxhN;E3)qz+NPj*9W+jHeS{HxQ1J~~{C=NCE1qIRxYBH~mOpZaHO@fA7@swa8G*0$ zrAF45_xhlU@*9JS1N8LgSX)wG=6i1CJI0(!iPJgdt+P>X6RdrSmeE4Oyg#*9JNTY} z@5zD!XD{W|NIR*TV$}=uKgEdi<;qp-<=3K4H@$fe?C&0Cr%m*%1)XCh>S~N@Qv5sk zIJLiMS2MKmE-n8Q)XmWLz*?Kn-4X7Q_s?LL|ty)3;syy60DsHP^+@+({qF-N)Q0Gc|)JSt&wE;{1)scokw zWTqo48A`$Thzsf4rv1wJLn{q>RK4YL zUYWbvre1(=V$~i#8~AKPQ~cfqcD=+5vE|YZ#44PRQ=1`;#S%S8$6HT!Lf0|43-Ko} zp{BYOu8G;*_)ei?%%!vRF|6qbG8n=JhYMR4pAoy)$ng-en8R`|@&5$B53QyL7)=Ww zEZS-Lw9YF?jjbYaBL5KaK%>OWTGbq5LSJxFXlkWyM9j$!C>>x8^{m)}-RMwHq>;QZ zuK7NwBlNpYUmM_Zia$k=izQ9Hh3pj1V*05ij$?!)a*g0Y$M{gT_ZN0@ik5R+NgL6S z@r1Z1D>@v~KBVOh)*c~F-v{aujWlCWuJ|2VzTPXWWW)|OJuArhfIqH`bJr!~y+uUG z+b3mw3QOpLUWctc{2oDCL@VYrwD1Z3hmxkmTx3zn&X!UiK)=Kk$!Lh$)cI&d>8iId zH)=1_18^WQiQd=6a<^c8>hp{s5_wZn99mCjj>i~DnG$iBRS;WfX~f-;`O{i5^8@x` zrZ=;3Xt?M%L`w=?sWm}ddZgfEd#hz^ro}PiIJb07LFF#!()d+{5BID_wPyiN{7C0t z^|6N7Inga0@jgX#Bp;Lxa~O^1Gqfv3E@rC->31FG$PCN}9D0alJFF2|Nbc>VL0o4n zpq3?D5v>zNnENr`pays?T6LbKs7{p1AxeldDU2yF`)XN^KYKW{XiT%-eal78ySQ(n z>~h)`86?5n=pVcrzw~Mp|kdR2U zjaeBBX(i$vkAVEXUlD`4S}%=Rc*<+ffj7dGx*VD_q<@2*Q{6FP|Z(xC;Gd0n@0 zQ})4SOU>J3y*wp`U$31>^v+cZ>Ts{ha+F%;ZwJ8diH#%7O&FP&zp#y1c?gW+?*nV| zyh8+(U7_Tp8sB)2`@tpNVNoMF#1crZnF_M}L0A4B0>P zR#F}FBvh~h$7)I(&0m&yj3a{P0^H%{qilPWx;g71Vz?R&GgDSRs`seP^zN#Mc}cU< zNu*Qr%*9!6f7aX$rmQkSH+XK62ULd`HLhCB9ZY>hReQFaR}afhzH zk&dy9dw#FOD=To_#;EsIn!~TdNw7yXDZ%Zw)uM^8h)>mjb`}Ws$ z`n=R+S(9?-7rF!CUW+x4wAXaCnT;i9ZZ9OOF~)3}Ur=xCnQzV4I2Cx5sHDWQx`h0d z_76)|+t82rm(Qc*Z`9AK5@St==vbA7RPWZ@41Gj=Qpp`^dS9Nx$gWnjx8y+1C|J|; zcjm0vNLE5=vHs-t)V}X_-KDYWrzqFlKi@4XzXpY@3;DFNCLw1!jFDq|pYmfpM*bpnZES2&)CU4ig7aK5uwa9Mly;re@LCV z#ZfxmZ~8UpkWSlSW?_Xl)R0aWWC&7K5=srzc~w3>fd$EQsr7eul2P{ z*SmQQ(~W6Y%XH(~)->J7`r4-Jo3C+dpK|3(Tk}Xz&ST$4t88BjRjIVKr~2Bco4HAi z)b(y&D|KTelauFXs%xhH7(QoFT|3p@Z7nIk=V@zI)w_75uWO~_F4R~ZFLI*Uq}J-j zG^+x*{^4Hgx@)hxQn?1}TFZN1ZRftVc}>=hT0OH{y+-R+?;2&5jOV>zl4$92=U|kadQ9E!p)T zXS%!A`dPd#`%5h~uK477`xS{?pK#Be>!-V{RIOELE9dOFdGh&KZbUi`hq@}~g`xL` zRp>Mo{t0e6JB(vdeI2@6Onz?9&D*}AqwnAhU^Tvdh38*sIpofFR(+;4)-2CB+E(Y& zw5rFX_2s-Q#Np;SM4PAj+RqG$B z`_QSpv&>)mv_Y(4jg#)};a@F+>zgIA|0ulo&qLcSpaWvmUl@13IHBhbkMB8@`IDX_ qw6pJ~)rvkbR4m_L?_;gU_8smoFdhmi(Y;%)QWN>e|NjB&Ah{L* diff --git a/packages/npm/validator/schemas/mplp-confirm.schema.json b/packages/npm/validator/schemas/mplp-confirm.schema.json deleted file mode 100644 index 7659b9d21e573ef7c12a264aff3a13d7b507c9d1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 16324 zcmd^`U2hx56^7@!K#{*dFfP&nk<>Wo2Xa%mR%;k=QbQ4X(ZCR7in5hZqC(Pc+#r7< zKRE6C%;C|@&dzd4QI-`41VM6k=FIt?bKYJ4@8=)FZ^LiGK(ArA7e-+k&h;9Hi?Gnh z=W+at@H9Npdk|iSPs48bLwpayKf*!yXZUycd-zhv zFTy;$3}^B8SfAhM&FDa@#@gjS+H)4Z)$c?79%=4{Mkac{2yZm{MDx$}Ug+wHem{&n zUPjtnXWs{b->e;n9qkT}cIA;~zt-qXRN-c%??{DAk3?%2K51xRzNB)l*)IP}?Y+JgKB%k+TYsWLKD0iAK_sUn!wa2-* znCQK$HDk%OcV&^it7|*r3jR)|vzbPB8~g8G@!ynu5j8v!Rp%vH9gQb?=x(b0Ux}0P zQp?Pk#a~bLIhE|w$i+n0-DjHn!9UW?wC|EO!unYp zhaaPK8aYMgoQ6qJo1e0UWehUKLNtt8^Qz|*^mcm1IWm%AkQ$%0^(UeMoppQ_x<-4o z4}C4U$xnxRKh*n);*rk-<*R3+ko?=^&3!hHJG`dJB_3fp#qIZr=#dp(NyB6qe&gFy zjn1|2NLR=qp81fKyvRIgk0klW(dwR!k?_aNDkkv@Q7p4rx9->V8q+5yz;+s~<=UF| zJYpu&$EoBW$-76(Y+|v8c8EhehtSeO+C+yh_5DOzU>@2e?rfY4gx|l3TJ=cd92x0! zam^En_}VLJzZqpo3+wuSTG5u|sW?5>9v-vp*hs5OJHaEea7yOU?JNAV&t4BD(u|K;_)t7>G?iBjG8ff?`K}n6$AOYW(K_}9Um@FmTvz<$7K3}_)S@RpzmX8i#$js zz{95%O{1}NLU}~Yue5$F`%;BieZ+Zy&Bxc&u15=J;pRGhE(xgI#`1j5@^q%S9sIM; zb05q5JmxK%c4=`G_o8B4XazbY<4~WFTktf_+j00ldNP#;v#1;A@kHemX5L66wd{)3 zEaMW9mLJI*d7gHuy1jN1bHO6k5vh_o5MO>WuF4PhqD6h?P`u`6X#Q(Q@|mBL-SSf` z)qNkv8kL>NFsV|QYuq`yzU7Ppl}5@Q=GiINkQcGTL&=e}QLBnrLl&Wmq>{k`{5Gp5 zpYW_smg=%iX|bBMhN6DG`YESgQZ|bvNspo&UGYU9hW5JbZC+^gsd@NJ`s}iHEeiXh zudi}?6!X^eXpw>P4PHc!BKB(Br5f3Nps!Xgt=QHmr#Sr<)zgvQd3JBd66Z!fV;DVf z)fv03j_63Oj___E=a}4P{BX9W?^9WwYu2sc1$k9z`OPbtT!+Mi)sOAS9g50@taHB1 z=wDZJm-{HO^}RT#`3-q)7|-}s`Q6TFx^ZfsHa|wic7Zdmp}Xgj+tJ8O^zt}^(zC`$ zpP%5Jzoxj`#-I9Q(6cVJbhlRByKTnXkG!(#&AH?>&m%04p(Y|=Jv%yRd+@puMF&m4 zzq*p=%t^VzDzEmQ7Byr9@B3HJw7Q5GoWzO@zuz==*v;}fI%L12SUVjl60Od=J63-z z?$9wrT&%3!jYF`T8M&LZhCpXFO)MX&xZ#r`4c3OENTa%4Ewo6V+B-MV?f2FR0KATv# zuDt9*nwsr80j%FX7cX5NV;Q@w<>|ie#awl&wRq!VIRk(Kpf~l$ib=0T*t2D3Xhl^ zsWt4t?`^pJc7m^yox!*49P0Lrb~kdnG4riB1Odr;rTezKAYe$7cpXh&KXTA8n$2@H zd8+hq#+ubi%I#ch;^XbgXehpk?agDc>Fc>Rx_!Ja2K{;-jl-yggyMM*((J^B@l2&l zENf2h&8Ta*qv!ZRQx|wuy(eBh&w8SAPF^*)`Dy0JdSzHrtgXS)DX%@tYHd&uJcTS- z%dl;oSPeFob~eH9+p(CVw58;h(>I}SEBp>pO%i7Ks}K8eI@h^hmi9oe-S=Mm(4V`1 z-^?Y=W6;O=Z2QhCT)xSaH8}IX3P2A5%*Y&?&d%QPMFiz(6apn>i?ALv>mbj}C|Mqc1*VKCWVVb=j zj+o}>_|+bj@~W*qYU>zJGfWe|?hy6T>T@4juWFJtlj!cmi!wvF+d zz*U`_uGlVX&6;Pehr9Yt-S}&oVLkO~95&6)5rh00rS80xrT^e~&*!o`GJKoQRk;ScBhR^W%e?Uwf&y6Ham8U_?A2+RIOAh^%Zr1?tVNc}Z z-S!-B*DR;XXDw5$yKcQ2()E(-W2k#cJ9_@X{sYZ7`(I|wlf1g&sUWJ2N%)s$^G}K9 zKaJD>*~@$VLp^&yee_?gyI4MhK)=ub9GbG)%(2FqyDz`tj+ghQ{(tx#J&kxj{wMr1 WT`MWn{(IyU(tp*HR`_PU(f$>!Ze)f z&Uf+t_hBn+>N5!M!kw@YzK)+k_+xk${v7@m9)};)_UnKBA^hri5bmn|ZupJvJP132 zvmfT+bvTH>C%V4Thr0ufnrN1vH0Lb5)$ix}JyzeT?i}i~AKvTkrurZ0bE?)|{eBp6 zJc+PrXWsjP-;AAvk!A-+Yk8vH?{s%2s9-bJcUHxko(R@3d{v{sd;#T1y?yVKdS)APBP&sd%f&OWL@eigqD1Ru#5 zWRw|1oZ;q~z9AWN^+8IIGaGZDmO+%isc?kTtckV$s8O_^7!tF55UDYGQt*w8uH)eCN zHK&4M(CV#jm7w6>Ip$-n4;#fQk$M}yD;U7(BkjO7*vqBxh1QLQd#=wzeKy4%uFqug zwgn++h^@CO^)5wK4TjHkY>^SOPR_Tl1h*=Y{6s=6g~E|{;{Nd95syI@W8am zJsMOx6*ZyZYkl91va}Pai6+{8^b+}hAF1k`#3PO6r=0S0^+4v%ME$z9B`WmQgEXSK zk}YAnqd8o6n>vz4=X?T3)`GvSYPpZ_YZt#BYLzqnxm`Lr$7!&jomaGVNq?yWcR!exV+Qc6U7f-v`Dcn&Rz<0Vk4tqJrdGoDY8OlH8|~KG*q4l&=yM$8j!VPdqO) z#fA{+U|Wzhq5@(nB$=3nUPPet=vl{$eq-Hfv#xN>EG`;p_7S^LwbQ<;veXg_AaNEU zf!9n}J`+anA(z>Q&m%{@=TIxD`qJvJk>)Tt$GTO$Sc)J&lmBHMU_o@`5yM>f9ixkL z&L9wRBHg0I1Xov0Nk=m!#0jX>LC%cfQj1%o-d zV}7@B$PU)WqOTG^QtzBEm*sc6Wc0yO8n?@7*>*H3#|np{c^jW@E>)gIZN=gfN#GaT z@NcJ19t9%Zct&D|lbVd0Op$9K9x+?q+}*g0SDKUw$ryP zeO2EAb=oL4j20k8iXOkcXpK~IEnZc=bBwlIV!c&;sYTF}8ov2TiT{aMh%rlYK%doO z{h_26JGvS5VPE54FQDIPT^EvH&VqGWrrdL+6=C1;3>Mw^F8Q_Y*{(Qcx$Y}gMR&3M zxyL0UcC90NwMg1BX{MQ;L2AoBRXN+F{ygFWHc0tpa$r50J`g^{`mD8%V@`pb`gmh< z&~HUiJR#A{ZrpLeVe^dUcl&2)JQ{_UH-|=fHlS_KU&VYm<*-&wt6?@9d9`(yt&eBh z+n|_lg)7K0KBn9YZre@{zS+LDiI+q4y)rPdkfokvqsZM^uc}S}X}i-#S$3~K@6jhH zf=)GYS~p(b6cyoY;;7-5;&Rr@u8gRZJw@GycrJ|?6Dy6T*?z1f1(uCC61)-(j3cXB zY8zFy);Xs>ba0AQlYcqW6^mNJ_98xIJ&U##>Fkzva9(f2Pf>--F;BcTOW(9})eIiK z1FQD4JRRBbA6jy8P3wOwEZDQm!b^QD({pnu_B85$eP5hY1^;LDAdAw{ifji*TtS>m z?Gs;cD415yu{wzn#k8V9c)jJH>S$-Y(X8*MOoFY83Q+IjL(^Be)P=tSf@+0 zs416Mz3=^#D8$~g9nWM@+IRZM92T35CD9CfU#u+k5jcZAAV24R7`uqIvE3|lT8{Z3 z>aFFbu}UfKO&L<=VyC?uHTyKmyVdT{O!7Qo|Bf1_1&90z1Wtm%^e@qZYF?L3OuQU7jy|`{x z_Ib3C$qG=hLbtqXmF$RDS5n3}m(^Q}d(1lQ%PwF=?aY9$)}*G71-GmSeyAM%G-dO8 zBfz(!5|*}#D_KZ88A05A7~7#Hl9)2?_`GFQ%yr%@eyX|RIjD>h#aLyBm0Jai${_a{ zQ?H7*#l(GM%;nNtr9fGVyW&c3uln3c_!B*O-x8;>FA9?i^vNY3roVw~tnd4ceZ?XG7{yX0N7F=j*Fy9sMrXWt8m~FIJ)P9qp~w zm1VQ%c=G+U z_wg&%tGmLOdiSq1rZLsr#6&yNWWXwPJiBDb(vb8m-3m{)ynIxP$shZlUdA&>K9gVDV~H}S^Sa>b9PjTl*V`L!NmHw}IDewha)8%S;Y>7ckD53| z+P~uI&_14T`xGmnPPMW`TZYJ_vb!Sc@S0q>u6)M-Q-w59d;LnO!&)W@{VS&qttkin z?c2qxfob;jY-GMe$g3->)&m`{GL5U%#;yvhL;K&N@#R!roi=4kdu6d)iFFuV`R)Yi zVinmm&wA2&vnsQ`sxk+vwZGNlq>mFBfBKbM=gTnWb$D8|TqpOwT)VWO%FX_jT%Vy7 zXXkNwn>4MKxhq$E9hYWhl{4O@{cO1coZzL*QW*+Qhk!Q}Jl46(`+7^kW4-%=_Y!RBqy^`~I8Wo* zKRaia-kSi0$>74z?q~lt1n0R&5kE6*@OdVV9UbkQ```^4%xSRf%pUkvXQsV=qK8v@ zRk=($Tb0M5p7k9q&Iz8xZ{^CrKmV5A0rA&}oj-xK$mnDL{|lUQ BEVuvw diff --git a/packages/npm/validator/schemas/mplp-core.schema.json b/packages/npm/validator/schemas/mplp-core.schema.json deleted file mode 100644 index a49807bfbfd140ea0b378063fb7882a36cfbb3f9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11974 zcmc(lYi}Dx6o%(B65=mdOHn~0DHI_jz949!LQ0`36-c0}N*yOnN#bHVg@XDg_`$&Y z%*pXwcGtU30w{9qot?{>b9v7@XZP>F{s?b|H^M}JO}G)JVIEHPHw$NBrIt@)`~C1B z?CCQJFT;mnH+&F3lkin|7`_cZhA+c6y7$hXpM|&PlW<%2Z-}Yjlv^)3I`=weJniXlL`pvG`(>=}Ag!c;#EH7p`Rd3(_Gp)VS3ZI5s`g^YZ z%r(=FzHLSN?y7AeiEl~9g{}`ZVnN1r{#FW(P^Z;v%Yii)%|k*BxnQp+D2&L=o>YO)hljNZ6JiD>06I2Gw}`d@N4@pA*VX^m`_4fm<*jJbbSIwWiCQuhXa60nBVB&nIsu=H&MC?;+3qTHfa|PcE^X-KE88Tnk3HQZIDs84_&4 z)5wgo@LTj`SOvY{h0B-$r|Lt$sam?wHDy&I((rM6uRV!au!_v#EUvduv^y9?%s|Zl$Al4l-ZYRcZn`VNgLogxd1C0YM9kQ5f~%P0t;|$R!x!RsBTQB8&T@kE{th3`{npfK6^d0SqzOl zi96_vEKXST>a(=@pK($1?S*vJXXmc?8;ZLjj&m;}*3)QQr0gcwcAa_BIli5x+m`V7gH>Ip z*007#_hhr0U*?hy>2I@dwlT7a-hq8g2S0Uk8@$6S09`Q(?t??*^5ba#{$A*ZC;&Gd z7yElBu7FpO;d9ht-N!{s+s@_LbG)TlnLWSKnq7Lkx}CAB+jCD99%lhok$_(jx%oMo z2nIDqAs+(J)ckG!Hn zueQ}+4_F;;i$8k3peRItx@NvZ*zYaU}*WDR3HmhE7Kuj1O^w)3E)m>tu(iF=&c7)_OBI45$x zVmGU`=XF`D&VT=HeEuv6Vc@x}W(~BG*d6Dg#PRyIPwuMo-fk|?zPl5Vw?GG zMAABS>UNaU%X)4;75F^EHBa{upPBF6U-I@`i!l2xO_%*QOWAcg*mQQ;PS#;R9MW-Z zar|`CiNN>1>143o9?Ho0_v9rz3~|)7yJ4=H`i|kOsW&l<-Nta&G-{Z`df$@EdTYPG z*VwbI1vckUU*G*@3_na`#$}q+zmCQ0<%_;fnS)YmiTU1cwcE`+GWD%@Q0C0-_~dqR znCIhR)T?o0tQTC>qNP4^na6Vo*LI&BYrS>F&NzrLuBTJ<1 z>s8}Ht&I|2YTe}dGoPvNOxBGy#LT!SwMl=*cl(~A4^{ZuXJ@O+)~84~cRKOdNr{zt zjzt_iCJo{|C|)5$)xAq-K?$Tv72kY z$!@i!$1{+tS^R#+xx1^loI2ZjNs@2JD2Q*)r#zD>-!||W^KZ0|N1bhyfe{vQ>3PB? znXP}yBEx-odxIxi!#!hKab{f9df1U;ym$tea{>Q!!F7=eX%#hu=De3S3Lay)Rt<;OiLtgv69^GCq z;*~jWI1bBN6ld=t`~Y(-Kk*g@>!F#G5hL-D_9?99I&SN2BOi}!*PptxCTq0$&h@=h zFvNU*5KjUB_)j$TdlKGeZv|S-g&Gs}Ot1Ue9PQ_Ebp+SdT-S0xl5Rq(ZL~TbQ8%sF zgdv@NAvnuA`lA+dHL|q7-&()> O*ko^OyVguU_WvI{%w$af diff --git a/packages/npm/validator/schemas/mplp-dialog.schema.json b/packages/npm/validator/schemas/mplp-dialog.schema.json deleted file mode 100644 index 047de349bf256df80e575d9969debf790c50ccdb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 13436 zcmds;TW=f3702hfK#{MoU>rCFLirLjDe_XNR$>^iQ^PU(kiZaZhPLHMqC&}z-6CHi zAGq!RH-|?vv$M-xQc_wQ!jjzC*)!*Uo6&#%{jc!H@Q2XoZxXJBSy+T4{msL1IMc{i zar{Ae81Cz8!kcg_?1Y=~YQi_+QTTiKK71X%)w552`)l}U(S+N2emneGBYz7|1?NRL z4KKq%yr1j)l`cjby*1Y=zi7>6_(}JVbwAVGV~rf@dJ*1f^uFdF={nQXA9a5x;&>8a z^PF{e1NXc;4^yoUj`rlPX1~$sQc%HWrr%HnO?L%r5<7&kNz0qFjbhTFg=Bd^=5*CNL zcJ$6%blo_Y$c^)7Q$0Hn2FAgiV)dPK>`S`OB7YAB(=kah-^-xEw}s%p7WDaw!^mS9 z?;h%VA-Wgh3ldEFQmzK>P_`806U{%+?Bny5*R9vT7Bbz-;697L8$m}Wnt~^dRz$zi z3be*CXoS^Vd_+$eo9W)>HX4OyMyGoILi3oz8}D=h>qy_9Y2>NaTCC_YJ%13_LyM70 zBh72`=^MSVjL(6|tOKoaEU0MwFS>({M%H!`SKbZxB>UZn!^;TmL~~}E0WRSGqdu4V zL~Ba!p9y22xTF{1nY04S!{T#mfD&}c`2${tJMS;!IFd9-&m-P&Fo$un!mgg5Jdb%F zybib<{h|abr>*v*2DI5KG|BG>;%g@$SHj*Bi z-b4+5E*{LJjWgY0qh@(#T^@t5s58CsTAx?|w#7Uw7)!BnV4|n*Ru+iZ za*mUGH1~`({z!@Uh?PzFRG&M-W+(FY`btmCKV4sq;oFEzctKkc8#KS}bHL?|#^&;8 z*TbKpU-I0;sp7k>`TlGYIb-tP%e0`+2J-hxk9S!-ek`8Cp?>{@#|P4cM))Q#+vxW^ zY9~_WDgL77G#vX`ay*D~bk3fNdsxMF>DW>-Vg=$4{u`Okx8$x{3o&PNo<0)=#QeFi zB9^BZ;BxTqA}u5Pw^q-Cs-t!h8LKJw^5VHG?+!scp4+% zY&CDDkuL9w)Xd{zk>($XrkiQ)p|C{b$X$*jUPSsw!pkGsI{$DjO4MggL`fd=^1G?l zFg?e+<PA*5x*Os&U6?d&wCDB7O26rrF8Y7%wb~Pu#$-qrupUc@2{~ zUW6>tG9ruYCe@@9?$z;9eX?mwtjottw90n*P7b{d8EsG5_`ZJkTNf1=yz7&;>7eDN zrr%5Pt54QlHaKK^LwU~K=(V0jc{K7i=nx(X%j?1}#e3I)JiBkptL7d0ZJGL8X~O%? zy+xOHEMpk7a=$7i+*Gvn`IIgwYQQpIgZ#)?Wrfyh+|QHw4&jM&RB(~ zv#OWq)&+-HJrV!NugPQaS@mi*%VLmaf2Pyx=8_$dS02V(0l2yM1mcroq?QzU5O!pB z!Y0xpU!vlF*GbLg%BsZD>K){VE^pQkFzv0mKaqCBZ~6{>8fy}2M-{SwYmzCEhRB~= z&%WU0{N0zdtiMxB>em5DnZD8|K!f(hdG9IK8P7JhWj=vw(BUFO^Q>e;R3+W|eYvtu zbmF~iRpfjxe5W2k6aEsuP$%$KN6k}fH};EUK4g9wjTh$?br+tjzs?@Ys1k&!Dg&$8 zf6shsSN;|2!!IOU8qtMqmYFoz)!9Sp4W^7Zx98y;i>e%noUQRAwRK*tFQw;i-f|&6 zH0t5ZW8IeHYEd6f5z7wabMC0O%;UgQ>gs;ZT&7pGIOyHT9MgV{YRA5|NA>5qpO{4L zNPPjXC(2kqiN4SJsU?;8zPci5&w-jc^KQ>F&u1OAcGNcv%1G_>Jjt>NY}8{>R~&2O z>+xt``3ZSmS1)=@e91d9ZQMQo84usyAl|I&VKd8SwqtUsJq~A^UUpgouJ-S<4Apv< z-_v%?a&7i8<4Tuiva?gm)88BN@Lg5uW;JtK>01)Zc!?kILhxwdx+1yKwkF7&;$@gbC%i?jLb9Ihi_x@ng>dk5p+XY;T>Y9rV(`?JS z)YiSFPAJcm=5zfwIbk|OJ7xtxeOud@!z^vhN82{%& zO4Mq8`jH%(GXwShwqx2)vF}rvcjNTlRciFrXNwPFuhVyh>15bGT%vE>j@&TkQq&yg zSiAb#CjRzY+)zftX>s^KC!Z5k{4d2VeSUqu*tkX4FpM*?$SF)6RB`?9$gwa|QQ+eV(MY_HGUnQQJCHdz{kKq?{o->~M~y}lt?z4;r7Ar0jQ0xBBu=Wxw+;O{jJ;#1# z;MBpptVr4}#^#WC7c$OqKg5gFmYiX+U(ue4aL70z5>jR~X}gz^2p2D&B)MQ?;*SUrPuNp^HmTm`*E+ElhrES_~?(ZJq zeFiCJ&=IX^zLQ;(``|9;So<9GBCoDrzG`|!TKQhU{n&qQVGVjo%lp(6>(P3Yk8=Nt z-HiMvdfEabe9BlDLB<8fZg~F-_c+8eYTzcG4*mXZ4bva(b^-sO@00T@T=eJ({I3Px zJ?y^cjy*5>Iz5}T&q34o>(l2*OL-{Wc|pUB+B5&0UanD0%9-c2#G2il|8b>rP^-pg zkU`hXTB?UtPryfQM6HRHIe+fQX-nZWgdAhs4Knd1GRNo*hXji#{SrKcTlT4<6|FE_ zOHMx{c2Q4^2AO{X9^_Lc0?1c*Z}!R~?3>7Uh-)9$0V196kAZ|w!6CGIJ_^)&VPw-6 z^U}80s6>h023iyePqEKDuBCNV)ylGe=7MG#h@ozAmliK$_|*_P=))WPKAK2PUG)$% z=F9Z|C4B7yf6wsw#M`{*y_=CCqG?N1Z5JGF~lm$Pb+aAF@^XyKrEf& zqHeFR{A7fYDeh#9m`c1eyHU@A>`FsfUSe#3{C^$TNnFxOM0dsayyxq)w%3f<`(EG$ z?@z~v&?z;P_D}lk2wHDJUPIXyJ`bQR;udQqa+u+7UenZ=8sr+BgI5S&)kO zyhW9=jh%!!FTCquf0Egm^TTXo)!#K=t#V}|jAix(##JJ#j#UbMFT)(+z{R)T%6f~LCGCxh zDnikQuWhbS+TcfYIq-gP3hJ{J_uILemblW?7h{^xJu#!6!7rt*?D(i+jPukb=eKhG zh_}(B6`7u4N8t&oh~BJJLW(LnYgT>7w4gHZtSPw59S|{?H?=yW28xJJ)S7zDiPevy zl^U~A@e~{5Czj@^lsL|sKTSp7VU(Z3UM6Rnp5DkhV1d2y96)R9?$WceIYoOAMNNq0 ztT0&X%^`P)_I&y@Gg8DYsUXyQwi##aAFxj)y)KQ%@J6 znwy`x4W8d{chRTnfP;LBuk&WT;t?e5xYy{`b@f3Xv#HWqfy{eti`fm-Q+l-H-5tiF@L`K{KwzLh-Cs^ir*&csAaq zk8U5=LP?vU7ppAx=g3j2R-SxP7{G2bafO;sQxUzYQBpJPHn8qx9Lu?@F1konL{w+L zfE~~(`6xV%#`ba*9ve!^bE=_q{&ai;wZk5EvH%S`5j+EK>M+RZfxR8}WqF=v)@Ihb z@Kx5ys@qVsY~7k)PWpoq#Fvc3GiTZ&n`?aI&_S&teVcb#;U9YYNdHI9BH2?NPy4L< zdA_z2o}AH(wMdmJi&4eAUk82I|DYemtBIyQd;o7EGSE9&mA`<5>>aR+rLxlV9j^v)9SnE3#qJWJ;#xvna?)wxvAVuv(o$N8>#eZtsC-|Y1&Yil;yn< zUAtai$!0b4>0&k0@)bT&tbTtgfihcfCq z{V1DNr7vaF_4-pbPip#leJYz>r(b2WHubHPD%-!((X@x=Yon`+_y7A__4;SlhqAua zyXbGJ&os?#F|5scTirgFN|yHKu$xp~i7BQDWu4r$eS8fikN3fJ_tm=jM$HpQ)xMa` zs?zl`>Z*M*n?Vhh_sf*NE~#j%6!UIOZ$;0FWW zH^;|kW_D-Sn@v)RBFEm@xtz;)E^~JFpTGZfpS#ao4}XQb?S^jV&hR&KQ@2FRL*M?) zy>Pqu^xRu_-)*_C{io-Ca(nJ)_pAHSJ;%K-|N7p2G3&Vpxc|U?iAEfd51OU?l)ZT<9dj`Q?yL*Id&Il-9`U1e3rO-gzFto1d^v9epy@V$iskE5ZQ$0NcuSf0;C>gD!Or6aA)eC&j!21lc zp%x7@@p`16+|9A>Ir^WX_jJ8>{fhb3sM*KC%!mGW5AzclJ&&U))}qEp8)^O>oSgb! zMArf>yi5F_g1!aX?t09H{Ecys+<%3;V^BWFx2{3n&pq#oV9v(5iEHxRTgiqq4A;E( zaCeM*1ANZBbV)%U*T?8bdTiXl9ilgJrjq0AvDRaGFJVjP=%L!3VTRYM_2Zrc(0GKE zb!JLRw94^w-%j1hOk>b6@lp%z=p6khg>rxMH{x^XYnGTpW{dBtSEA&{Ys!f$`Y7Us zsF(3aUKX^&&}OR9&Ut0-dKA6{-}G?%`0U`b3vKXw4<7FoW-tp8enZr&&O>Ub*Ob~~ z?R`kmhrk;Ng~#AC^g32-%r42D4C&|46DQ&xg60OIrlQe&%F86(FK@kFD{!sBa+G4!Az)=dhV;?+i! zIe7s}2i_8L`mxceo=78kVO*@D&_>qlYX@A;@u&Xcd`(ktB|G&}W%{Wlj$?$R&l^En z$M{gTcUCw#MavXd(ndeZctnpWE1EyjKBVO>)*d0w-+{lR1~lVPuK1lIU+)!OGJ=E0 z0SZ2zjQ3ZuB#%$Z_!LN>M>j9q!|xHKMZd+IhzOtIe=2E8%wm#CcCnWF0QzO#AsG?l z2X#KWq;%C1#EM-KbOzA@yS?ODdG{)MI zd+(9V+=9KBDK30O8m{^c(Ng7IsWtJqv`DeH_NbkBU$FF2)Nn_`5_z({Z2Ly&F0 zhJKNHVCH7hpkHS!psh&$Cs`D|2=hi}7SsT*MXQDh_3HFeIggV1nJOPsVD`)9JK^l< z%mug%v#|ruN6x;u^P==}`W6&QMk)xOLt;5?S6N|`4x2KaC*E%zdX4npZ-^rLDB4~X zbr$gz1F<|(ot5QBjFV&9@zQMwU{WynvV=fE zA!7~E%Bu{vC^_Q<};Jp5f@lr za*_PJ%!XLwm}92Y@?J$PWnZhYlslxW^bXZnR`1djb5cB1?N~y}yP?9Wc6k}gE|I$# z%~$GoY|JgBzQcSnKQHBU>@mS#%)|5el07h^gw-?i{h3v;j>B)x+ZGvW9c^$yWE0;P zm3(ydm5h=TZ@cBn8FL15YLzzbvZy18rgA5YB00>+-s-Hz9>m_$yp5UmZSTX!7`u&? z!_~~&9Qcf$w3c=9A<|OWTDeCeuIeIrN*5(#H8Y!`56>bsi<`_Q_tzXq1(tOO%0g=o zq=+?k?hGvVe}^mjxO`^R90ys8;5y41&6eZ;^&)x~e9@0-jAw-5ZZ)J;r_x!%7-iP}DxjSEKYD)pjH>us=1M)?0dkVfD(&L0G=tI@9M-2&E@ecU z`7H;ktLU?r^sM(%s^iO4_HB)BImp#l_?5B{_1Y#!uN_q3jk5ZGf7p(+Y zzp@2wRvFS6@)aWMQN7PDugnp00;8#76wa;BT66QIxnRD6WV6OuNGi2BvZR($t|4h; z32V{SnN2yeG}n!~`ITor2Dd$@t0!@Jf;QH!JrT%NMlX8`q^w`fZkkWOnr2NG|F3G# zb3`p7q570a`+c(Ru-kk1%_|ArkZT+(t?jv#v#Xm_{n9vg^IR$g)plhFZ?}WBGw;oN z37*)W`!lBUOss5?N(H|e!}%12C+PLGZqo=k>BQ4c&D6+wB~nEF=b!5~1XF-|6q_gPwSW^15*yxgzrSh)JWlk^0F}pgxetbQo=f*>-^|_>=v?-Dr zFKsQp`J{x+O$=;uw!%ixtGBBJ@RTEW^<0N1`w#u8gJuuVwGxo#byZg0HXBa!i)xQo ztlpYnjGKK8QmCL4e0v)r@wDCVMZVJA*2A?U=o5ws#&k@?$_c1ii8jyNKeXFsLHy|JQH~YRRNvQzB W^z1nCDd!n<27BXBH7xRx|NjE7$;UVV diff --git a/packages/npm/validator/schemas/mplp-plan.schema.json b/packages/npm/validator/schemas/mplp-plan.schema.json deleted file mode 100644 index 7f99ff193848f583a1b7fb365fd4bda2056e86e6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 13310 zcmds;ZEqA+6vyvt6XREyjF><|Tfi6--WUWWBt;1jUq}dP%a$&*-MZVNX!sI-VDDgC*e;2+ORpEx7-w5C6&i7$Q>%0h)a1e&^ z_duU7b#b@Stbum7C%2pifR8tutljef1WW337`d-@Jn@N`#e)!}MG0+Z<~M;h(?A87AW?Qk<}>EBE7 zGtx>M`m`MxyQzC)QM@G@$NIgm85^SFTiwaWec9S^s2Sx>lj&ah%!&3m5*3HKHZ^A; zzP4r>*_u7uh-2V&v$6B$jPfSWr%|?tTF0?BZs1>65T^-jWKU@8K2nQu`Vp=Yd6X$2&R)OYm_OL94F7M61=I!`puwU+bPl>3e}_gp*qO7LPj zWBxeaM>Dq4zVG3(me^KI;j_$FpO)^%IgwxrMJL&dPCS|M4!@tfOpP6hgFQi;|r&P*g} zIJv6zh!kg%98rhg*#1a&C)#&UPlziX4UrkKl5woPC(f_vs%P;D4&P>4F^-7{*xxg) zx?MxgEqp#t~UDQ>g6Ay7OuB2O&#A2CYaroOH z{GtE<yc=mGQdLpH?c9}Y@Ic;dc_7a( zw`P%jvXn39F?<-~Nq-dmxMiB><&^77t8DXYR%fcjpLGmGd2dgxGpEUAF8kO*BmnWKkdG;rF zp@;sFJHiMy+BDWb67PRD9s5F_1_D7h36DFCMuVY*lNf2N7MM4dj7Zi6OU+-JSX(n5r|(569L=QA9i_2g&~m@5Ow*Sly$K(FDO7kVN@ZVjwDst#Yw+y?4U&n7GxPFSNs&p;5o=muBjOi)YPX@jn`c$3%F))r)DoIVVR5vzcn#j@*LAI@%?jpX{o<8mK>r}86~D0B zj!N+`K3`ovU}34)v;zEebZo9MbPDm=k>0pE$7ncx8X8M zmOkds^LSZDtIMnBuDnD<@%pjJWu5uGRXXK!I7t}SQGGcoVZ1Vb)S93A1dhMT`NW)r zB)Xn@K5!{K&2k!DHZTK`tP6+aTzX9NEZJ49FN3you1cOQ;(C5>cLUn%+l-_ox-i|N zx}$m1-h7?&RQs%Nd#s1TKK`oTInDja@0kQrPBhbS(?MRXUO{(k$;^MYr) zPfPZ9BKj)dICy2`HBMU&@1_f}SOZNg@&07Lo&`V35Kk$)WZm{&0~ESSm%?RKOH+%x z6>0S1u0yr4o z%}OraZPqz{pBmn~3tiQWkK>cdXWo0iw9@&yD8ARa7W1LIDb7c~*X1?(VyTyC>BIQl zr`2t79TE4J>1n3%^L-%K?DE|gU%k(Fy$_MbwY_<{?u@U{-=#?-%8InTCu3`M$`*HR z(y9qV_hs>Ax;SaQCIaiDG0$_QG@CiI^xC|ih7%B?v3UcwTtuhqaFxm)srs% z27X7HbbWK`!B7EJ4jpMu)11Z5D*e#zF15Yqg$6q*;ioO^%n|pQc_Lfk{TF9+crRw> zp?IgjeCx}3-y6)!9p3Hu+t;>!!FubSj!D+!NOSoXPIuhb7Al4ClT$~yI}m1bC8a=u!+(VF3VaDBnQqFb5e>}Z;{SdvJ=l_1K-I| zhv$HYQz>$~HJ$cupFwqL_Ge&rMqcB1wvuQE4qUxf1^0m^(ezmJyKMn_ytfY~OlO|1 z&7HBHMju7_;+Ifq9J(Yun{pB(&od%lbB^)xt^q=4TAr zIE9K0|43)Qe~H%T=eo^`>+COKO1rG5=cxYFyyL0W6J^fyyUC-C9Oyn{??f&=iq*5f hq}kA3H$?Td@O8@vYWYU{FI=3)^j9uPDtxn8`yVSpESmrT diff --git a/packages/npm/validator/schemas/mplp-role.schema.json b/packages/npm/validator/schemas/mplp-role.schema.json deleted file mode 100644 index accd2861861e97ec6b32ae75c5ab1a4e577666ba..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10922 zcmds-Yj0ac5Qg_N65=mdE~r$(Nn6B4{ensZp;CYu!fn039lp@Ww_#6o4#GSfhNJjA z(*2n(MtfQ{(k?Hx=PW$e^FuukHFu(sV_gT~LZdsHf1>M5Z};_lFY8s4v+R`TeDwibSA2BGt_saLZ)re>W9w?8kjGroM^Vof2h6Bw8NdSsn0XXGZm$Q z?zSUyH#9aA$D87DrsuI%48+A(8p-EftL%8B73H1gi@oxdbM0{=E{=6=Xw67+Z7wac zxqLU!{^)O{S^4^nCFez%&!TRb?_4B%?=C2zuc`Jtk91A5*kPtsJ!z61&vfBG#~N`z zDeeT%a5U47r<#AH*^}k2O?x%(gB`arnor~Ro+#r7z34R)?Sg&a3T}Uw3`g-BzBJbe zZ}IjcaW>c3r_sZ5$;Ntzes1XPSUk^kA8Hjo_cXr4JMl#%9BS^K=IkvcoXf|0nvECY z$#Z>7_VyL<1((QmD0(mADkvijeq(X!yPt?R#*U*LL>W53W=J>Cx`V|EB)`x_Or7Yy zQSwTpfnWECsd#v%=b=^M<8y3kK?enKZh zD3Iw)G>lsDtz#IL8!tJ>BSADgjTo`@`=SAzRU!nsMjPEW`|l&k4IVz!bx+rhG|qij z`1n{9QdF6|dA#Itip`2#;**A9?l<@oD0D8(foMDvS5uA7weL`Gz$`~vWCe$r2koIG zzY(qO=#PZ2GOL)x2clR;&t~1P>NTcMGR}G$t;6;@?Rm@|OCMv&Ka_V9rG^ninMH=@ zJ+yQtZKA_NeczWBKnaVey~Q{+CqUhwvG{7^bY zL(Tq)j>$1S@taWFvIyR36&Vz!HJV0aDMz|y=S!`V*{FK(e9H&ed~`+adbCj4U0$b8 zC4p5sMBh4|dtct?IyE$H(js|(q7U_s=@i5v?}9CO8X0>O{)nDTmBTD*gL%ww!^OOz zM(WTNs~O@Fk%o`pMvl|&oy}fL1wvF)J53^AR35wH%QIs&cRE%204(Y=`;sKjq50E5 zdsw9ay5(6cRh!phO$g`8XH`!jt`| zb?WkGRf}yET@`c4uf!3El542S?}d=PzT5Ragxb)06*?*^ zMC)_OlODOgz_8G!>K+{Bd@v_S2Ipua(O@8gaKrwE}zY<%lub` z++B^BT!#JdMEv^6+bXv1ju-PyaK!220hZOs-_+5dUY$njW5e;U3%wnCtv3a~JZ7-6 z?F&lX55K5S?uDx)krL*1U@A300D`>+6o*fz#5qT-RO$CJKX? zor&N#Sr^=uM(otds&EkFM~vROQkaR<%N;CakiGncP>8^z?}2KQf=4JAozG ziO8qAb}WEK@l2`?iB`qtcE8Pa(d@5X2=4E5RHEk2J7@1_9~IEQAF-A!SjO9G&0f?( zU%K@A)c1d!VK%iq8XimAbsm}1Cqu&RlSN*vJE>hI_vGgbWqB-9UjAf@Tx9y;bic|) z>I>T~?R2hk(wp{JFaN#!C%!Ie?#VvJJ@*>A!8*?>&TqHM`W>b3wr&;s|8YDtz1Y#F(PG8o|F!+B@ct>ZE_w0G9N`?@+S=a2WP!%jN7Yz}F!_;b6i-f=rOO_`>g zndmB%RuJ@_Des$HFw1QMF*dL zOZ2N|^Iy8+Z|l;pHp_iF*%G<_)Vj%{zXPNAA6rpAn>o@rbGH`x++wxA{MF|`=eM`T Z|IP5ZsFf+y{m0uWq+evZbxl9^_dhJq8({zd diff --git a/packages/npm/validator/schemas/mplp-trace.schema.json b/packages/npm/validator/schemas/mplp-trace.schema.json deleted file mode 100644 index 4f9f60bd2ba357cab370b9bd5e6cdc3d0b6e39e0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15792 zcmd^G?QT;?5Z&LEs=k6{s7NJ}6smrRKNW=*p{8vVqW&mCkz<@-n%JprplQWR^nu%+ zvvbF@yLZ?3+71wcBFFaL{g}@)v$N~}{{7p1>^^cG{B_-R*LP!giobyyxfxpS`1YUN zuG_(@<6gR3Zp(e{Umf>@+jGCT-`w}^XFU7#pKskKD@@rjO6$iab5QTwQlFlEAc@6DyMfa=I0*y)~yj=6dF(dxHK-hiQC&J{M&+#=0*+!Jv{ZbusbZcJV&O z%44ic?U}8_YmshpHNl!^=s!g7(R|(VYUP!v&HKTuhyHU1bJH3+-gZVpvKFo71=^?& znc2AHTwIq_2)(4L18*33+b3nmpiTUdqqR4+udQ2&P0cX&3{O>?V|NJ6lTP|{Xzx9& z{1kjC^^}lklH(`7om9(AM_z)YDV*aB{laGo~S&3R?+#g_LNd=t&~@w$iC4!oD|dqB4*n87?k_zf*xbrO0j?JlLZ zJ4YH)^g58DP-e>s;!oVf8zUk638KGolEnL6WG-eWYC8-_Pyt@H)Yj>P1EDV zes4k+^cnilGkkvPb>7415x(`RcKRFb^c+$%FJP4D!&@|>Oub#qFotLu+PX=ht-aca zIw!lJw1+j+$Lh9hqf8F-Bj+jKO zW2897i?Y2@*~t(sBYcxK;wNK|>5V=p=&gN7%S*Hk5Yuk}C#eC=E|e?2r~Kg4fFlEI47Rc~P)wY*FZ!2u)t!29qzmirLar#{bEBC#(g#lByQ`5-NvG9`vE z3n8}9(ik}zg=xvmC)kTw;nYW@e$}s!mK?fvFqa@MJyQH_d8<9~STOS$!^qP$0hN28 zNF&)Ie7Np4sy(~lB#e3CH)eKX=R~(K+E`|H&1axonFwQ%eTsIa$fCD;kiIv?2$_MI zfuV<3wqXr%k$PapX3`+8GZs+Gf*PWAq6l+EW**c4zl&DQvlP{dQYA!5aVCc`UCh2( zz7x)#&Mc@U`SyY5q2ycKVNr4=U5f=u7An>~fwW4R&Us*y{+hC!2OhHyy*4_)8d?zX ziGG)(&Z52Q-*VejS9Q73w#hC1cjn%A**)|Y9&3;IB3LJT5%CG-IK(}ZTRwI)OOw%= z+0}<2$K8roW`a}vF$)~xvtq|9e4|B{B)oy=)C=Wxp2<||w#q#YqtF3XliI_oUd~)X z&|(v@O0vke>EnA9ClVtm0m0@pVx+bkTIdF($6SCJ#VbgJRhnB~+I8Nz4tah79clhj z&kgGmSJY=NUzW8-MCsA3)+%S$>mp>Db%#`zB}VV9N8K)vZv?rVR{TBAX3Jfl$*@LH z=8EyV>t#H`j7|L{r;u!3JSIn-%*j2!)IFFp)_IU#lBY2TqfJPD8OBWZdJ=J0(l=`e z9DjgywE|hso)~kN%lNzAVwsoOytDWSJ{L=kdkNN}bZ06RKf!w4MTE0aYVEKnuEVv*Bktgc ziRW*`vVMf#x!cLrA?vk6;(|m(=5wJ{ZUCDl5)d0mF{^%O_^h=_?p{xURVQAyf*lq? z7y+arYE=mC%vk9;_Ol&(Pm|1lTFE@;X|mHjU4Z$5IB6!$eb04hli4-*I*d4)lgE-c z0I#H#zMf*#>!_uUQDN2fve>{5P=u(W(I=#lkzMNCjJ+q`R>(OsMa`9L|0X-|*eKnr6rDltX9yHSmBfB?BB;OM*Qp|buMvCtHUAR<$S71g<}$ZKOnZ=*`d%pQmCHiYKA}F$!k+|jjr&mbl$;gE^s2WU01vo+ z?qr}%gbwRt`6#>0{DJ~nW6yEH9{Sg`^VWG*Ia#nZq<&O7+iKc-U;GJ!QWn~>w(&jI zGxzuF$}v|XSgwMh^sSq7y~#?3(pZ*j-kW(+S@#s3t;t3&k8Iy=r99Au6@9^m8$3JxjOTZM6!C(!4H)>>=98$%EE>E<>e6xhrcV&H$QpvFuJ-*I!q< z7g!{pZb-EZljwxk5T&nH4%Dn1G&gocHA{Yxof6mM5?xea`!|`(7B)1Tx&c>DK2Pc??_26?qqI6QZ z>dl$Djqp6PeH~G3HI}YgcHRceX441}d;R69r#yn>?Ur}`rcHYPL%B@-N82f7MiuUF z7-DxE}f}G^XFqLlvX;Tdp9ZgLAU5x4I86Cc`IUEbWI>WQqLQt5rM6swlE^ElcxVM3aD zy(<}qROc~QZL8fa5$k<5YZ~=9q8#&`_kQ>*fHV9tj@r3b*o&Xz>_eZH{a5t#A=N-q zG%yL+PJMYV4R`#_cU4p`^?a_qzrOowQYy(%1}4izk*NKh6_r@ol8M0*PY!|K%nw(o zax~@BO2@j@VXbp8XR}?3WU?t2aw}ocorW|c*rH3ICX97)u5R(pa`Do= z29v~cxieQJJ?XxQ^VRp7Iejm?tBj?ixnUl0yMC{r8BM8A7~Sev9AmKY6!Ox=4rmiu z25aYM{*(NgE|*2=j>2{{ze0Yzu@e8f)PB31-ap{&KxTb^Vce)X1y?=9JW9_2`myhQ ppV{cIz`FC_K5ya%-);Z<-!Cv*Iz#T4D8g4a_+7H + Public PyPI protocol helper package projected from the source-side mirror + and package-specific public surface. The public package is not a + byte-identical source mirror, and this proof does not authorize upload, + release, or publish execution. truth_sources: - "schemas/v2/*.schema.json" - "schemas/v2/taxonomy/kernel-duties.yaml" - "governance/05-specialized/entity.json" - "governance/05-versioning/version-taxonomy-manifest.json" + source_mirror_evidence: + path: "packages/sources/sdk-py" + publish_target: false + role: "source_package_mirror" immediate_source: - - "packages/sources/sdk-py/README.md" - - "packages/sources/sdk-py/pyproject.toml" - - "packages/sources/sdk-py/src/mplp/__init__.py" - - "packages/sources/sdk-py/src/mplp/kernel_duties.py" + - "packages/pypi/mplp-sdk/README.md" + - "packages/pypi/mplp-sdk/pyproject.toml" + - "packages/pypi/mplp-sdk/src/mplp" + - "packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/PKG-INFO" + projection_boundary: + source_public_byte_identical: false + package_role: "python-protocol-helper-publish-surface" + source_mirror_authority: "evidence_only_not_publish_target" + upload_authorization: "not_authorized_by_this_proof" + current_distribution_artifacts: "validated_by_disposable_clean_build_only" + checked_in_dist_authority: "historical_generated_evidence_not_current_publish_source" build_inputs: - - path: "pyproject.toml" + - path: "packages/pypi/mplp-sdk/pyproject.toml" description: "Package configuration" - - path: "src/mplp/**/*.py" - description: "Source code" + - path: "packages/pypi/mplp-sdk/README.md" + description: "Long-description source" + - path: "packages/pypi/mplp-sdk/src/mplp" + description: "Package source files" # Python Distribution Artifacts python: - dist: - - type: sdist - filename: "mplp_sdk-1.0.5.tar.gz" - sha256: "04f7a312cba6fe463ec3beba00a28f27fa63b1cca9ae3f3eaf568e625eaa434e" - - type: wheel - filename: "mplp_sdk-1.0.5-py3-none-any.whl" - sha256: "9f795e35d374a7c774df9529a3bac541d660b362af9b3cdea7d5bd77529f95b2" + current_publish_candidate: + generated_in_repo: false + validation_mode: "disposable_clean_build" + expected_files: + - type: sdist + filename: "mplp_sdk-1.0.6.tar.gz" + - type: wheel + filename: "mplp_sdk-1.0.6-py3-none-any.whl" + historical_checked_in_dist: + publish_target: false + current_publish_source: false + reason: "Pre-existing checked-in dist artifacts remain historical evidence only and are not the source for any future mplp-sdk 1.0.6 upload." + files: + - type: sdist + filename: "mplp_sdk-1.0.5.tar.gz" + sha256: "04f7a312cba6fe463ec3beba00a28f27fa63b1cca9ae3f3eaf568e625eaa434e" + - type: wheel + filename: "mplp_sdk-1.0.5-py3-none-any.whl" + sha256: "9f795e35d374a7c774df9529a3bac541d660b362af9b3cdea7d5bd77529f95b2" # Verification Results verification: @@ -60,9 +89,11 @@ verification: runtime_surface: false pydantic_models: false kernel_duty_baseline_carried: true + upload_authorization: "not_authorized_by_this_proof" # Governance governance: method: "METHOD-SDKR-08" profile: "§8.1 Python" frozen: true + evidence_only_no_release_or_upload_authorization: true diff --git a/packages/pypi/mplp-sdk/LICENSE b/packages/pypi/mplp-sdk/LICENSE deleted file mode 100644 index e547836bb..000000000 --- a/packages/pypi/mplp-sdk/LICENSE +++ /dev/null @@ -1,17 +0,0 @@ -Apache License -Version 2.0, January 2004 -http://www.apache.org/licenses/ - -Copyright 2026 Jearon Wong - -Licensed under the Apache License, Version 2.0 (the "License"); -you may not use this file except in compliance with the License. -You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, software -distributed under the License is distributed on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -See the License for the specific language governing permissions and -limitations under the License. diff --git a/packages/pypi/mplp-sdk/README.md b/packages/pypi/mplp-sdk/README.md index fc8013a2a..65bcaba3b 100644 --- a/packages/pypi/mplp-sdk/README.md +++ b/packages/pypi/mplp-sdk/README.md @@ -1,49 +1,30 @@ # mplp-sdk -**Package Role:** Published PyPI protocol helper package +**Package Role:** Public PyPI protocol helper package **Protocol:** MPLP v1.0.0 (Frozen) -**sdk_version:** 1.0.6 +**Package version:** 1.0.6 **License:** Apache-2.0 -The published `mplp-sdk` package currently provides a **minimal Python -protocol helper surface** for MPLP package identity, protocol-version alignment, -and the canonical 11 Kernel Duties. +The `mplp-sdk` package provides a minimal Python protocol helper surface for MPLP package identity, protocol-version alignment, and the 11 Kernel Duties. -This package is the public **direct data/helper mirror** for the published -Python surface currently in scope. +It is intentionally narrower than the TypeScript SDK and runtime packages. It is not a full Python SDK, generated model set, or reference runtime. -Current shipped surface: +## Scope & Guarantees -- `import mplp` -- `mplp.__version__` -- `mplp.MPLP_PROTOCOL_VERSION` -- `mplp.KERNEL_DUTIES` -- `mplp.KERNEL_DUTY_IDS` -- `mplp.KERNEL_DUTY_NAMES` -- `mplp.KERNEL_DUTY_COUNT` +This package is a public PyPI release surface for the package role above. It is package evidence and user-facing distribution content, not authorization to publish, mutate registries, create tags, create release seals, or change protocol truth. -It does **not** currently ship a full Python SDK, generated models, or a -reference runtime implementation. +## What This Package Provides ---- +- Installable Python helper package surface for MPLP v1.0.0. +- Protocol version alignment through `mplp.MPLP_PROTOCOL_VERSION`. +- Kernel Duty baseline exports through `mplp.KERNEL_DUTIES`, `mplp.KERNEL_DUTY_IDS`, `mplp.KERNEL_DUTY_NAMES`, and `mplp.KERNEL_DUTY_COUNT`. -## Scope & Guarantees (Important) +## What This Package Does NOT Provide -### What this package provides - -- Installable protocol helper package surface for MPLP v1.0.0 -- Protocol version alignment with the frozen MPLP protocol specification -- Kernel Duty baseline exports for published Python package consumers - -### What this package does NOT provide - -- Direct mirror coverage for the full schema bundle -- Full Python SDK models -- Pydantic model set -- Reference runtime implementation -- Golden Flow execution engines - ---- +- Full Python SDK models or generated schema model set. +- Reference runtime implementation. +- Golden Flow execution engines. +- Certification, regulator approval, legal compliance proof, or official-standard status. ## Installation @@ -51,58 +32,40 @@ reference runtime implementation. pip install mplp-sdk ``` ---- - -## Protocol Documentation - -- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) - ---- - -## Publish Scope - -- **Public PyPI surface:** `packages/pypi/mplp-sdk/` -- **Source-side mirror:** `packages/sources/sdk-py/` - -This public package surface is intentionally narrower than the TypeScript SDK and -runtime packages, but it now carries the canonical 11-duty baseline for Python consumers. - ---- - -## Kernel Duty Baseline - -This package now ships the 11 MPLP Kernel Duties as Python constants: +## Minimal User Smoke Usage Snippet ```python import mplp - -assert mplp.KERNEL_DUTY_COUNT == 11 -print(mplp.KERNEL_DUTIES[0]) +import mplp.kernel_duties +print(mplp.__version__) +print(mplp.KERNEL_DUTY_COUNT) ``` -Canonical upstream baseline remains in: +## Protocol Documentation Links -- `schemas/v2/taxonomy/kernel-duties.yaml` -- the public mirror package `@mplp/schema` +- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) - discovery and positioning only +- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) - authoritative documentation entry surface +- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) - public source projection +- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) + +## Package Provenance ---- +- **Package address:** [https://pypi.org/project/mplp-sdk/](https://pypi.org/project/mplp-sdk/) +- Public PyPI surface: `packages/pypi/mplp-sdk`. +- Source-side mirror: `packages/sources/sdk-py`. +- Package metadata classifier `Development Status :: 5 - Production/Stable` remains a publish-execution owner-confirmation item. ## Versioning & Compatibility - **Protocol version:** MPLP v1.0.0 (Frozen) -- **Published package version:** 1.0.6 -- **Kernel duty baseline:** 11/11 carried in package exports -- **Package compatibility:** aligned to `protocol_version` v1.0.0 only -- Breaking changes require a new protocol version. - ---- +- **Package version:** 1.0.6 +- **Compatibility:** aligned to MPLP protocol_version v1.0.0 only +- Breaking changes require a new protocol version or a separately approved package release decision. ## License Apache License, Version 2.0 -© 2026 **Jearon Wong** -Coregentis AI +## Copyright + +© 2026 Jearon Wong diff --git a/packages/pypi/mplp-sdk/dist/mplp_sdk-1.0.5-py3-none-any.whl b/packages/pypi/mplp-sdk/dist/mplp_sdk-1.0.5-py3-none-any.whl deleted file mode 100644 index 16b5bc85256e476ef5a25ab87f3c097c85f22a2e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3436 zcmaKu2Q*yk8iq#=Ci);+7$u_j5+$NcltCt=6J)exlrd`5hI1{bI;8=*1g$#{cEqi*ZQ9I?f?D$^}aAD894|508jz8T*7YcyQs7@({)#dzGGxr&iSd=bNrD{k97uVN-`SOqlg%b_NN zM^uaULzj{)I}&^wyq6V$+ScOGja^ieK}u`mbnhly&s}mga01mMD;ux3_2A zePO%$^FT5_2oiPIwv`XfgX+D#&bItU3Cp(h{5EqTJu3Vgqal}0D|n)7akjkK{-vGD zBbnroZ)C9l>fm^)LrZQ>R_Lh?l;i*a%U?RUI(ea--0U2EeUMJxr(z^xZJ-1xQ1tqt zC|xrgFY`kECD2B+&xg5*TBb{Pe1T&CgDEC}kMA*iX1cZE?}dD5ztM-J2Mc_GmkHc4 zxkmp~o5a$=90rRBhms%R(mR;qSSD!-Q8XQf#Fs^^zAkIK`5n)B5M z>b`!y%G1eWz=WOS=@$7w^;SWz6zS5ysv=d72z5#LG5GS;}BLBxQH88H6)gm3QL zjh~G)X9}cn4;$vfr%ZA1ng)hJaoZlpRMV#q$ZKU^08uHLMqju=J zt}*iR6jvoJ-q?Up<)1rqM?L6fi~J-1ub^o_$1LeXhSgy?k)0Zzt%8FsrW1*K=N688 z(kc3KKiAGIa{g3|!ZqyHN4U88Fa-dRLk9qW|D%|lx1+1Lw1kv|yo4jt+eaLUa`uok zgqUb(YnW)1n7eySDKH!l*?C?I)texZ9U%!=O;CzOlyXNG;gMh5>Qi+Si$CH{ z?uI(NaMRJRD{gh8-4SN&4GLOYYu;k9y6D{>F^o%uc~R*^q8Hs=u-NoIt?1wt{NQxH7fSFS6F?-03E zhcmV$r8Z^dDw>@j=n_kvLu`B?sF+C=OXin@WmJnaF7Zqpqao|&S72q-kLcLfdNP`J z{~~stmQp8zOks4H^SZ*G95?;EV!Hixx^0AmyK^++vppBpn-ISzMXG{i)0oC3_ewrl zf3w?hSu&j>HgYu+ov2MBFC00k#H9=h*JJT9@9oLt8ms_CcJ||;VvYLUPX;X22bo1l z*8~n?Ef6N!)H|-Y!(%?!ll=Y4?RC}n8adV)Ek?{nm#fK{#_sqh$M$itO7SaskrBYH z5r8DD8$rcGXRIipj5TS?q99>JtqKJD?(+e2;yO5<#zf~JG0`l_6lj~CTL1O^ZUiA> zBA%<=b`i(#RUyOJ{3y%no%qCLSi(@ZeOdGUgq7s@=Hvx2sP-Wsb6Y3=m$6ZGqpFYvN*sjOM!pd68hQk+U*V2fZp*mv8evJq3OXt-5x z>j8iI)kIL~_ig16b@sN`+eY{nPtDci+2;2R-3D8$}~EZTY<|8+Up@& zrW!!9s73t63kWKjeH!_>@0fT0c7I>m3qswe2d;@bJ}{q@g>*+$YjJxov3A zkl=01z?Z?&l_?4beqb%1NswBZ7|C0}S|=agJOI9MzP`TyD#KL4QUxyLnfpcZ=%%y2>1Tv%lbwl8lLYJIE4U zV)mSiLVQvN&m=7eQGMfCgC&Z$M&3jmTvKP>`+L)-vDy81D^46oH%*2zvqgKGAf}s_ z2JS9L`L+-sz^0cl;5CtkCsDQh4o7O=6W7BldBNGj)rtDn$;}T?kv!Nm!}2Op0ikqj zd)nvoV~XvM@@3UcLwd&rZu=%qTtCDQh*JSEE-HMqD7^YbHq?nrZMZ{3Io7Xjw&;}t zHpfK9_p<5vq0EKFG0-6YuwiZ?`E)~~lCr$ktSQl@$I3WX+DZ|B;IGUvM>tofflc3d zAEX@9&J{c($+_vn=AFl0ky>gv!eMOWZjkv=;j9J}ZZE4TQe9JeHvBC(IOR$ui476zUoE z&a}LAmE%ZAG%?5wF{{@Q>UjYk*w+~&yqBBdBA2G%hbHijym?a zP;q`ay%8+fo3duKs!b+-hw^Jew;|7L255+d!)Wfq(&0c{l#dQ=xGY|MA@|W{V zJ3}Inn8bv+`5R`oI}>A%RPChPaavKnzuj-(1|`%}db{zew?@}?@3665(*WIXa_kYI z+a#6TVrRdglih0b%(WFzLzSG7lpm=P9jRWs0lG z+;p?wH&k2 zkb=nme>6Yc@;|QPupf`JLH+O5|0_`bSqlIZhsB)g_eb^Fc=>n4|4KMN5z1tLB7T{7 z&f?AR;ggI51~fXUF;{YwlO9e+>Cq=GpoFi`ft+O7n~U{+xCgl!Ed{0p;o4 McDlh?z#nh_240ZK3jhEB diff --git a/packages/pypi/mplp-sdk/dist/mplp_sdk-1.0.5.tar.gz b/packages/pypi/mplp-sdk/dist/mplp_sdk-1.0.5.tar.gz deleted file mode 100644 index 5ab66b9f4d2c6b3c19f3a936206a6b11e30017f9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3316 zcmV;(yFOr;1!}=6y zLk8L)c^M}XGK?KZ59WP3i0^DGoH3IQ=F!Y^sULWeXLvT9G23SW^>yQ3pE5e}0{UTa zF`y3!L8VUGYrSZ3XSt^3PU}>6P5Pb%F0<)L9L?#S9x~f_Y=p^XVV=rJ+=0;XX zkIu=3WiU5n^68TwurL|t5p+CbvZknH5O|-N5y>B~FZ%Qs&tX0cs7_~5k?()6%-ixZ0hrcc-dvppYiL5F~jIHdhPZBdyX+5Swg)IE12=9)kYN3m%!*I-yR1pxF@ zsSD$u2D;Q&`t2DXse9OR+p*M*h^?+4S2Kg7( zU7!bxczt;@{5bM`+cG#Y(lZz!gSEb2066z?)P4RRGs!jkM{EH*$jR9I^ykBt@`jwS z&`8ux0hG_{l zD)ayAv%vd}x%*HBx)?vC@&#%o5~fy5xf-)d%uH@(jQV-+x7i?Xb4g>wK>)L|=Qyed z%LEMSv{r*PwH)0}my#@wIE;gdZZPO9msA-*00Dd#%?nW_r^BVXZB1QVu{uGa6~WjH z-Su2pE1Nc(B`F3AsSt9UjE#mf%ZEkEdhHV;(_72&y&&Rfzr}AZXT}+7#^WLrhc_Nv zU)@|CUtNrUJ-r^DUtJc(?@zBUPcOzNA8*c2hpV#xHa`LFC(#6M-b9{F%p?3-hu;i4r-f`Kc`I^zdkc7+5g$m;N=gdJ1%*Ysd<`qg zoxVlK;%yy>vK;y|*{TUY^8HX;f*<=hmI z7YBf@!m_A9d4X+E0DnQ{q|d|x*|ek72-&E=w9S5LeGS#Y<$m4v@u^&bO)16|{0dsUG$V4Ewv1JV^I6Xf^!=I||1Kj=i&N zsF@Pqg3MoQ!sL|7#de1LC6flLrMRywG_TQY!15%7VZ!8dD5+{l`p7jwX{^|qD(ir?52uP_ZqfhS(bUeO|F_-Mg#ULN zNjQ3hqenP;gri3|dW54#IC_MmM>u+fqenP;g#SnQe|FRV(`mmE{-53T|A3*Dgd{1E z=h)lv|7bm}wZQ+~rq&expKYX1cd=!gaySno=8Q;cC4}^lev)9f82gdu+2PNJU7!!C zPNl~gW41IRNwYgJRhVl+?NVihmyI#TPa@<~N>C%>>R>5D&CHIMNVdy{Oiq3hF^d2t z%-wE)p#;;{&18_dBUH+9A}6LYmhxySiP(v0ggJ%p3g)cyttLkzq4al}&AejuNc0OC z5pth~?s1GGY7on%06zT8WBBkRn-Kn=Me^}{K05rbVmQNE5hITj%f=)<6WJ%#vC=ak zeMzMkM9sapqS911sN3A2u9nn&dEniq_16dLrI4x-dJ?X^$$Z4GYgh@#jS6;A;=m3^ zBy&(8^(=&}N~G%GDAg!C86;A87Rq&Auy>b8;wRX!S-Ry%-bZ=B2Qtb%vA|;#6+rgylEh_jU`Ss!Gv37gA94R@)&0+dPFL&#cF+Fj zVn;D1(=DF=s%m?2|KCwHasIm<`=3pxW6Pa*BNFM;F*n^omGBQRpiwWWL`VYR{}cLu zhxC812?ASi{SNB?z-ass{@?KZhh9$=?>`9nFXaCpB>%f_T0;KssQkyQ#`os`&E$W( z*B0`BcjUh~|NrCU|HAqILGwVI{|ouw7>_O2ipFEbpMMwr|BC;w*;=yydTK}b|F)7| zRgTTiuCM-ndP!c4!;qxkjLX)i<=Ox7cJg`SiJIpHy*N} zU@tIcER2Hmk^>?T&pI8dB-p%>_ zqQZ{L6>h49QyZshcV#BU?~-LoeNgfzvf9KbMGT6>jAPFWOv~j~66S|?JjHyYod2c1 z1Vk$XImP>5^cUSVVaU@m7=|VCEGt<7s8s>0QM48$*GuK;mS0g>5n#jUIgsD+!?YgX({8RU?GO}>DhFw0wR+*B)#BaCqv&RwI@ z9CPImb5{VUQ14BkyP<9@A~q^zf8kc_;_d_Z0r={uk$eyJ`Qgj{j_TTH^ip9k%~5OJUQgjG=*z@4)|?o&WW; zUQ3++3IC6f|J(Nep!^s9A0huM^8Xuu6=dVz|IpM{uPgjN+eqT~Kg92Uh~NJZzyBeA z|3f?rDV~KC&q9i4A;q(h;#o-XETniAQalSOo`n?Wf5QJO{J$dYxc_%}_3`@nbf`p6 z(GT$dsx7Uz;QwtlyW;)Ft)%>&LsEVEldQT4MAn9flCK{ekZ0*?O^y78y!jZ6rTg$J zRU^+I+vr96f5}wnf1&?{{ulaR=>L~U;qR#bRkgXG|68rL(EnRWg4Koo7y4i5f1&?{ y{$H#Azj15zy#8PK{ZCC(HC5>UZLPmxcacOANhFa(5=o@pN&f@W!J^avpa1}V6rQL6 diff --git a/packages/pypi/mplp-sdk/pyproject.toml b/packages/pypi/mplp-sdk/pyproject.toml index 985daa14d..0e2a6d669 100644 --- a/packages/pypi/mplp-sdk/pyproject.toml +++ b/packages/pypi/mplp-sdk/pyproject.toml @@ -5,11 +5,10 @@ build-backend = "setuptools.build_meta" [project] name = "mplp-sdk" version = "1.0.6" -description = "Published Python protocol helper mirror for MPLP v1.0.0 version identity and Kernel Duty baseline." +description = "Public Python protocol helper package for MPLP v1.0.0 metadata, protocol binding, and Kernel Duty baseline." readme = "README.md" requires-python = ">=3.9" license = "Apache-2.0" -license-files = ["LICENSE"] authors = [ { name = "Jearon Wong" } diff --git a/packages/pypi/mplp-sdk/src/mplp/__init__.py b/packages/pypi/mplp-sdk/src/mplp/__init__.py index 376beb52c..d14689732 100644 --- a/packages/pypi/mplp-sdk/src/mplp/__init__.py +++ b/packages/pypi/mplp-sdk/src/mplp/__init__.py @@ -2,9 +2,9 @@ # Governance: MPGC """ -mplp-sdk — published protocol helper package surface +mplp-sdk — public protocol helper package surface -This published package currently ships a minimal protocol helper surface for: +This public package surface ships a minimal protocol helper surface for: - __version__ - MPLP_PROTOCOL_VERSION - KERNEL_DUTIES / KERNEL_DUTY_IDS / KERNEL_DUTY_NAMES / KERNEL_DUTY_COUNT @@ -25,4 +25,4 @@ "KERNEL_DUTY_COUNT", ] -# Published protocol helper package for mplp-sdk v1.0.6. +# Public protocol helper package for mplp-sdk v1.0.6. diff --git a/packages/pypi/mplp-sdk/src/mplp/kernel_duties.py b/packages/pypi/mplp-sdk/src/mplp/kernel_duties.py index ac809bf42..5557dc8ad 100644 --- a/packages/pypi/mplp-sdk/src/mplp/kernel_duties.py +++ b/packages/pypi/mplp-sdk/src/mplp/kernel_duties.py @@ -1,5 +1,5 @@ """ -Canonical Kernel Duty baseline exposed by the published mplp-sdk package. +Canonical Kernel Duty baseline exposed by the public mplp-sdk package surface. """ KERNEL_DUTIES = [ diff --git a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/PKG-INFO b/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/PKG-INFO deleted file mode 100644 index 2eb11c275..000000000 --- a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/PKG-INFO +++ /dev/null @@ -1,133 +0,0 @@ -Metadata-Version: 2.4 -Name: mplp-sdk -Version: 1.0.6 -Summary: Published Python protocol helper mirror for MPLP v1.0.0 version identity and Kernel Duty baseline. -Author: Jearon Wong -License-Expression: Apache-2.0 -Project-URL: Homepage, https://www.mplp.io/what-is-mplp -Project-URL: Documentation, https://docs.mplp.io/docs/reference/entrypoints -Project-URL: Repository, https://github.com/Coregentis/MPLP-Protocol -Project-URL: Issues, https://github.com/Coregentis/MPLP-Protocol/issues -Keywords: mplp,multi-agent,lifecycle,protocol,python,kernel-duties -Classifier: Development Status :: 5 - Production/Stable -Classifier: Intended Audience :: Developers -Classifier: Programming Language :: Python :: 3 -Classifier: Programming Language :: Python :: 3.10 -Classifier: Programming Language :: Python :: 3.11 -Classifier: Programming Language :: Python :: 3.12 -Classifier: Topic :: Software Development :: Libraries -Classifier: Topic :: Software Development :: Libraries :: Application Frameworks -Classifier: Typing :: Typed -Requires-Python: >=3.9 -Description-Content-Type: text/markdown -License-File: LICENSE -Dynamic: license-file - -# mplp-sdk - -**Package Role:** Published PyPI protocol helper package -**Protocol:** MPLP v1.0.0 (Frozen) -**sdk_version:** 1.0.6 -**License:** Apache-2.0 - -The published `mplp-sdk` package currently provides a **minimal Python -protocol helper surface** for MPLP package identity, protocol-version alignment, -and the canonical 11 Kernel Duties. - -This package is the public **direct data/helper mirror** for the published -Python surface currently in scope. - -Current shipped surface: - -- `import mplp` -- `mplp.__version__` -- `mplp.MPLP_PROTOCOL_VERSION` -- `mplp.KERNEL_DUTIES` -- `mplp.KERNEL_DUTY_IDS` -- `mplp.KERNEL_DUTY_NAMES` -- `mplp.KERNEL_DUTY_COUNT` - -It does **not** currently ship a full Python SDK, generated models, or a -reference runtime implementation. - ---- - -## Scope & Guarantees (Important) - -### What this package provides - -- Installable protocol helper package surface for MPLP v1.0.0 -- Protocol version alignment with the frozen MPLP protocol specification -- Kernel Duty baseline exports for published Python package consumers - -### What this package does NOT provide - -- Direct mirror coverage for the full schema bundle -- Full Python SDK models -- Pydantic model set -- Reference runtime implementation -- Golden Flow execution engines - ---- - -## Installation - -```bash -pip install mplp-sdk -``` - ---- - -## Protocol Documentation - -- **Homepage:** [https://www.mplp.io/what-is-mplp](https://www.mplp.io/what-is-mplp) — discovery and positioning only -- **Docs Entry Surface:** [https://docs.mplp.io/docs/reference/entrypoints](https://docs.mplp.io/docs/reference/entrypoints) — authoritative documentation entry surface -- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) — repository truth source -- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) - ---- - -## Publish Scope - -- **Public PyPI surface:** `packages/pypi/mplp-sdk/` -- **Source-side mirror:** `packages/sources/sdk-py/` - -This public package surface is intentionally narrower than the TypeScript SDK and -runtime packages, but it now carries the canonical 11-duty baseline for Python consumers. - ---- - -## Kernel Duty Baseline - -This package now ships the 11 MPLP Kernel Duties as Python constants: - -```python -import mplp - -assert mplp.KERNEL_DUTY_COUNT == 11 -print(mplp.KERNEL_DUTIES[0]) -``` - -Canonical upstream baseline remains in: - -- `schemas/v2/taxonomy/kernel-duties.yaml` -- the public mirror package `@mplp/schema` - ---- - -## Versioning & Compatibility - -- **Protocol version:** MPLP v1.0.0 (Frozen) -- **Published package version:** 1.0.6 -- **Kernel duty baseline:** 11/11 carried in package exports -- **Package compatibility:** aligned to `protocol_version` v1.0.0 only -- Breaking changes require a new protocol version. - ---- - -## License - -Apache License, Version 2.0 - -© 2026 **Jearon Wong** -Coregentis AI diff --git a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/SOURCES.txt b/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/SOURCES.txt deleted file mode 100644 index e3e3971ac..000000000 --- a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/SOURCES.txt +++ /dev/null @@ -1,9 +0,0 @@ -LICENSE -README.md -pyproject.toml -src/mplp/__init__.py -src/mplp/kernel_duties.py -src/mplp_sdk.egg-info/PKG-INFO -src/mplp_sdk.egg-info/SOURCES.txt -src/mplp_sdk.egg-info/dependency_links.txt -src/mplp_sdk.egg-info/top_level.txt \ No newline at end of file diff --git a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/dependency_links.txt b/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/dependency_links.txt deleted file mode 100644 index 8b1378917..000000000 --- a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/dependency_links.txt +++ /dev/null @@ -1 +0,0 @@ - diff --git a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/top_level.txt b/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/top_level.txt deleted file mode 100644 index 05cad332c..000000000 --- a/packages/pypi/mplp-sdk/src/mplp_sdk.egg-info/top_level.txt +++ /dev/null @@ -1 +0,0 @@ -mplp diff --git a/packages/sources/sdk-py/README.md b/packages/sources/sdk-py/README.md index 0cc9c1220..cac945a99 100644 --- a/packages/sources/sdk-py/README.md +++ b/packages/sources/sdk-py/README.md @@ -97,4 +97,3 @@ Canonical upstream baseline remains in: Apache License, Version 2.0 © 2026 **Jearon Wong** -Coregentis AI diff --git a/packages/sources/sdk-py/pyproject.toml b/packages/sources/sdk-py/pyproject.toml index 1bba5a2c0..9dc1afc52 100644 --- a/packages/sources/sdk-py/pyproject.toml +++ b/packages/sources/sdk-py/pyproject.toml @@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta" [project] name = "mplp-sdk" -version = "1.0.5" +version = "1.0.6" description = "Source-side mirror for the published mplp-sdk protocol helper package surface; not a public publish target." readme = "README.md" requires-python = ">=3.9" license = "Apache-2.0" authors = [ - { name = "Coregentis AI" } + { name = "Jearon Wong" } ] keywords = ["mplp", "multi-agent", "lifecycle", "protocol", "agent-os", "python", "source-mirror", "kernel-duties"] diff --git a/packages/sources/sdk-py/src/mplp/__init__.py b/packages/sources/sdk-py/src/mplp/__init__.py index 4a96f3065..690de2ba8 100644 --- a/packages/sources/sdk-py/src/mplp/__init__.py +++ b/packages/sources/sdk-py/src/mplp/__init__.py @@ -14,7 +14,7 @@ from .kernel_duties import KERNEL_DUTIES, KERNEL_DUTY_IDS, KERNEL_DUTY_NAMES, KERNEL_DUTY_COUNT -__version__ = "1.0.5" +__version__ = "1.0.6" MPLP_PROTOCOL_VERSION = "1.0.0" __all__ = [ "__version__", diff --git a/packages/sources/sdk-py/src/mplp_sdk.egg-info/PKG-INFO b/packages/sources/sdk-py/src/mplp_sdk.egg-info/PKG-INFO deleted file mode 100644 index cfaf87592..000000000 --- a/packages/sources/sdk-py/src/mplp_sdk.egg-info/PKG-INFO +++ /dev/null @@ -1,120 +0,0 @@ -Metadata-Version: 2.4 -Name: mplp-sdk -Version: 1.0.5 -Summary: Source-side mirror for the published mplp-sdk protocol helper package surface; not a public publish target. -Author: Coregentis AI -License-Expression: Apache-2.0 -Project-URL: Homepage, https://mplp.io -Project-URL: Documentation, https://docs.mplp.io -Project-URL: Repository, https://github.com/Coregentis/MPLP-Protocol -Project-URL: Issues, https://github.com/Coregentis/MPLP-Protocol/issues -Keywords: mplp,multi-agent,lifecycle,protocol,agent-os,python,source-mirror,kernel-duties -Classifier: Development Status :: 3 - Alpha -Classifier: Intended Audience :: Developers -Classifier: Programming Language :: Python :: 3 -Classifier: Programming Language :: Python :: 3.10 -Classifier: Programming Language :: Python :: 3.11 -Classifier: Programming Language :: Python :: 3.12 -Classifier: Topic :: Software Development :: Libraries -Classifier: Topic :: Software Development :: Libraries :: Application Frameworks -Classifier: Typing :: Typed -Requires-Python: >=3.9 -Description-Content-Type: text/markdown - -# mplp-sdk - -**Package Role:** Source-side PyPI package mirror (not a public publish target) -**Protocol:** MPLP v1.0.0 (Frozen) -**sdk_version:** 1.0.5 -**License:** Apache-2.0 - -This directory is the **source-side mirror** for the published PyPI package -`mplp-sdk`. - -Its current shipped source surface is intentionally minimal and exists to keep -package metadata, protocol-version markers, Kernel Duty exports, and release artifacts aligned. - -It is **not** a full Python SDK or reference runtime surface. - ---- - -## Scope & Guarantees (Important) - -### What this package provides - -- Source-side mirror for the public `mplp-sdk` release surface -- Protocol version marker exports: - - `mplp.__version__` - - `mplp.MPLP_PROTOCOL_VERSION` -- Kernel Duty exports: - - `mplp.KERNEL_DUTIES` - - `mplp.KERNEL_DUTY_IDS` - - `mplp.KERNEL_DUTY_NAMES` - - `mplp.KERNEL_DUTY_COUNT` -- Release metadata and build inputs for the PyPI publish surface - -### What this package does NOT provide - -- Full Python SDK models -- Pydantic model set -- Reference runtime implementation -- Golden Flow execution engines -- Full Python SDK models -- Reference runtime implementation -- Golden Flow execution engines - -> This source-side mirror is not itself a public package claim surface. -> Public install/use claims must be made against `packages/pypi/mplp-sdk/`. - ---- - -## Publish Scope - -- **Source-side mirror:** `packages/sources/sdk-py/` -- **Public PyPI surface:** `packages/pypi/mplp-sdk/` - -Public installation remains: - -```bash -pip install mplp-sdk -``` - ---- - -## Protocol Documentation (Authoritative) - -- **Homepage:** [https://www.mplp.io](https://www.mplp.io) -- **Specification & Docs:** [https://docs.mplp.io](https://docs.mplp.io) -- **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol) -- **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues) - ---- - -## Kernel Duty Baseline - -This package mirror carries the same Kernel Duty helper exports as the public -`mplp-sdk` package. - -Canonical upstream baseline remains in: - -- `schemas/v2/taxonomy/kernel-duties.yaml` -- `governance/05-specialized/entity.json` - ---- - -## Versioning & Compatibility - -- **Protocol version:** MPLP v1.0.0 (Frozen) -- **Package role:** source-side mirror for the public `mplp-sdk` surface -- **Kernel duty baseline:** 11/11 carried in package exports -- **Package compatibility:** aligned to `protocol_version` v1.0.0 only -- Breaking changes require a new protocol version. - ---- - -## License - -Apache License, Version 2.0 - -© 2026 **Jearon Wong** -Coregentis AI diff --git a/packages/sources/sdk-py/src/mplp_sdk.egg-info/SOURCES.txt b/packages/sources/sdk-py/src/mplp_sdk.egg-info/SOURCES.txt deleted file mode 100644 index fee34b132..000000000 --- a/packages/sources/sdk-py/src/mplp_sdk.egg-info/SOURCES.txt +++ /dev/null @@ -1,8 +0,0 @@ -README.md -pyproject.toml -src/mplp/__init__.py -src/mplp/kernel_duties.py -src/mplp_sdk.egg-info/PKG-INFO -src/mplp_sdk.egg-info/SOURCES.txt -src/mplp_sdk.egg-info/dependency_links.txt -src/mplp_sdk.egg-info/top_level.txt \ No newline at end of file diff --git a/packages/sources/sdk-py/src/mplp_sdk.egg-info/dependency_links.txt b/packages/sources/sdk-py/src/mplp_sdk.egg-info/dependency_links.txt deleted file mode 100644 index 8b1378917..000000000 --- a/packages/sources/sdk-py/src/mplp_sdk.egg-info/dependency_links.txt +++ /dev/null @@ -1 +0,0 @@ - diff --git a/packages/sources/sdk-py/src/mplp_sdk.egg-info/requires.txt b/packages/sources/sdk-py/src/mplp_sdk.egg-info/requires.txt deleted file mode 100644 index a18ff2bdb..000000000 --- a/packages/sources/sdk-py/src/mplp_sdk.egg-info/requires.txt +++ /dev/null @@ -1 +0,0 @@ -pydantic<3.0,>=2.0 diff --git a/packages/sources/sdk-py/src/mplp_sdk.egg-info/top_level.txt b/packages/sources/sdk-py/src/mplp_sdk.egg-info/top_level.txt deleted file mode 100644 index 05cad332c..000000000 --- a/packages/sources/sdk-py/src/mplp_sdk.egg-info/top_level.txt +++ /dev/null @@ -1 +0,0 @@ -mplp diff --git a/packages/sources/sdk-ts/DERIVATION_PROOF.yaml b/packages/sources/sdk-ts/DERIVATION_PROOF.yaml index 747e825bb..7e79e91f8 100644 --- a/packages/sources/sdk-ts/DERIVATION_PROOF.yaml +++ b/packages/sources/sdk-ts/DERIVATION_PROOF.yaml @@ -22,7 +22,7 @@ derivation: package: name: "@mplp/sdk-ts" ecosystem: "npm" - version: "1.0.7" + version: "1.0.8" category: "SOURCE-MIRROR" verification: diff --git a/packages/sources/sdk-ts/README.md b/packages/sources/sdk-ts/README.md index 00e644b8f..b551092f7 100644 --- a/packages/sources/sdk-ts/README.md +++ b/packages/sources/sdk-ts/README.md @@ -2,7 +2,7 @@ **Package Role:** Source workspace mirror (not a public publish target) **Protocol:** MPLP v1.0.0 (Frozen) -**sdk_version:** 1.0.7 +**sdk_version:** 1.0.8 **License:** Apache-2.0 This directory is the **source-side workspace mirror** for the published @@ -92,4 +92,3 @@ Canonical baseline source: Apache License, Version 2.0 © 2026 **Jearon Wong** -Coregentis AI diff --git a/packages/sources/sdk-ts/package.json b/packages/sources/sdk-ts/package.json index 0cf7dd976..87d35e757 100644 --- a/packages/sources/sdk-ts/package.json +++ b/packages/sources/sdk-ts/package.json @@ -1,10 +1,10 @@ { "name": "@mplp/sdk-ts", "private": true, - "version": "1.0.7", + "version": "1.0.8", "description": "Build-source workspace mirror for the published @mplp/sdk-ts facade package, including Kernel Duty exports (not a publish target).", "license": "Apache-2.0", - "author": "Coregentis AI", + "author": "Jearon Wong", "repository": { "type": "git", "url": "https://github.com/Coregentis/MPLP-Protocol.git" @@ -48,7 +48,7 @@ "kernelDutyBaselineCarried": true }, "scripts": { - "build": "tsc", + "build": "node scripts/verify-dist-surface.mjs", "test": "echo 'No tests yet'" }, "dependencies": { diff --git a/packages/sources/sdk-ts/scripts/verify-dist-surface.mjs b/packages/sources/sdk-ts/scripts/verify-dist-surface.mjs new file mode 100644 index 000000000..712a85937 --- /dev/null +++ b/packages/sources/sdk-ts/scripts/verify-dist-surface.mjs @@ -0,0 +1,36 @@ +#!/usr/bin/env node +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const __filename = fileURLToPath(import.meta.url); +const root = path.resolve(path.dirname(__filename), ".."); +const packageJson = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8")); + +const requiredFiles = new Set([ + packageJson.main, + packageJson.types, +]); + +for (const target of Object.values(packageJson.exports || {})) { + if (!target || typeof target !== "object") continue; + for (const key of ["require", "import", "types"]) { + if (target[key]) requiredFiles.add(target[key]); + } +} + +const missing = []; +for (const relativeFile of requiredFiles) { + const normalized = relativeFile.replace(/^\.\//, ""); + if (!fs.existsSync(path.join(root, normalized))) { + missing.push(relativeFile); + } +} + +if (missing.length > 0) { + console.error("Missing sdk-ts source-mirror dist surface files:"); + for (const file of missing) console.error(`- ${file}`); + process.exit(1); +} + +console.log("sdk-ts source-mirror dist surface OK"); diff --git a/packages/sources/validator/LICENSE.txt b/packages/sources/validator/LICENSE.txt deleted file mode 100644 index 3126996caa853c5359201689a4ea6f82e1920c97..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22950 zcmeI4TW=i45ryYDK>ovqKoA-5HL;V}exh}Wl{k_h%2o`+4-_R)N_bJYq-o{HC#kOw zkE<^;+?5@`FM%L(xjWNcms6*zt9$l8|6WZ$_22IFYTBO;rWez*80(AaWxReiolNWa z`OE1SKXUx9;_kB;BynpTPr z!cMCg<=ON+ag2qE`yl?K0drr3M_AIJaGxLcnv596K2ofk##lel9W ztD)s)yJ4eOAsw19|9P4HGV}!NNWxEI2OZCg9{WY(7v-~;)4$?VY=Vx7JlV_M*)$8+ z?U%Ww?_tb}t(o&A=E>K1q3ciwGCOXK#hm zxDS-JmV6oS;M>$)cm-9bAvwr|Pnf&?X{DZH0soF7D!87<5 z1g1o_mc;O#tGT4lDv)y#^Sp|8i6yj2n;E%|gpB$zu68;N@snemQE!B7Z^iGN_cY{1 zNAxEeu@nBWHNZ{%KG&Uxbl3#^BCp5mEmPl@Siqjgaqmg|Ka9JP4`f;Ab&N{JX`_XC zFN^mjJEMpV(*8o0B=2QO?BE|WmOPGCWEZTVh=nCzhDR(FEc862BrClNiO)ht%Y9?| zD6-VAi)A$;ND<=Fk7LG!tIk7~^I{FGr5F`MbN{;drIu21J}Gkx5eIRfB6L~$d7Cap z{nsJ=Md7>~MUPdy)_X7^_?gck$|Oe2cOe&fz_Q`7FGB7)KIy&nZ2CT~#K!o_c9GqW z%X_XKKy|WQGN>@A*x8Qj_KMc>D{-UzcD$%<#t@!*UgYH!9G>?&OM>`+{GbW=z~7*X zIC9>@-@Pr+{vdelqTC^bC|9oH6L7tXPhUnH!3>&T5xR~~!R%$sAT;t0OapesYA~E) zzs-y(Q!h_F26sA_D-O}g<-{LNGo*oRZ!|NqObMtcQHa%?#jC4f@D`&8f;?=_>!ny_WR?w_beh~ zb477^b!FNb_Ehy`ww}upSiScObM`i`5!m{T*dmT?p% zSPNOOjbgrLtNlS9yxdom!i830VmN%qxE|e1p|PdAkjs^18m;C)jab4m+rGVBZp1xU z5Ki8YSbBA(x8_v6FRriW^r);LL4frBKE@$;9ffX}kx7==;8t8iC5^R-F>tqkDB37|ROBU+wV5VV2w5u)uB>tkNP%L6CXHHd+(m?&KNEJ^_+H9gy~U6Nd=USt zl`;}w2ehL?R|XQwq{m@MPkne)dGflr-=?PSrOV1}u1Y}CO(<;ZAagd7XA~w9#g@hm zR)JTzx|a-V(WSr}W*KKPcJc z`r|`bpWKE$j{@JqMlacR`fS5zHTJ|{ z2c(u%r67{%mQOvN`2?A?YVKvCu64fl-Pd`Sk!!}}S}G~lV@SvfdmUb)3dMe`Zd@7C z1Ib#-ov2uSf8C4Cc?gwKeQo!GZP3jSsv1Np~%`)*u^WW97dGk1W8 z<@`K)-JUbgpv{}Ib1&Bt8eM171-MS%Rq-qKfyJp;#V6E5S-;EPOB(euiFe_)f0ii3 z&O!zngB*2zRd>tJ?jLi7<0#iYebvO?*=qVzjDsz+i;7qK)nhI7vvS{FNR=xdW~3+afX?C{|qNvV#ce5%eMKhHxWWuac4 z%VO=Lz!?@M#*l=n{bYJ4{xS;?dE^U!`c9FQIHs4vyD-h`G7J5UcS3jajy|J<&R^ff zHLUVgzxT4>`QAH6F|T^c;Kf=xqj^tFvna=Djli{=E5G?_9=1h7W)?2Rw5;*>LpQV? zuaUJ~8*q(q-fF=6j&qG#bBr{^%e`&P*m*aj3oV=VRMfORI3cQD+h>2LkEh=)#M6V& zg?LbmwTLDH{~t*|PbA$4pAfm!eadJsg!WY0%$a;deC7Tz>tP}(z1!m0kw`8llY?t2 z060P!UR=`SIQPYgJ?#&8EF@qDUa^y}>Eg2scox#s@iW#8j3mydTTLf`cZjFV731n% zJ7{o&qDl7{EKLFr?Ta^MiIOd&|Kh^fZ(+>T#EtQ2d?|zLXEL>T+#LS6jV` zb<9b(ATukB3=_cEu3K#%7`pe>IIGqrHv&oEgN%X|u$$OKa>L`t!Jy0qg1nl+Q8ck{S=FlN=ra=NFj~KtM_9PNs+4A2smK=7fJ%FrE5^CJ>T9iz_sFKiFdQ~7 z5thIX*+XM~EZzEynd?}g2f%%BkJtpsT&1`7*3r#+rI#dYHpO6Dwe`CubCsgAv}BP- zvO1{upyhFTQC>0i(g^o;Tw+K0qUXX9#gfjum`{h^<%gweco^0jD;-53@#Tt@OoA`Q z+D^6x8{;@c9DZe;nH^gDsn<8{B#dsZoaAq0l9hx?`yON<6KAJDhq3F}^WQ|^h|1;e zXPxCV1_vX5vER5wcQ_M3Nny^l=<%BY_G5thjfCCgkXlyQ9$4Nr0+*|racoQB; z?~?f$A4XA?U@K-G_u7&(Cis)6Beq+FZsWyX9^b=gFq1F?-g4}@X#2EW&pLcw%O?w3 z*5`n%XYFr!#j%4_Vgl}Ctt3{0*A>66v9+I~HPOf}SeWRwzk08uH&t5J0Kzxk_F05Y z8XqiZOpGu)bAv(Q*5kMM^(x8Mw}m#vWAD{bzd43bH0f-o{Z0mSgSmZ^_qE!eBbjmf1i~M1iH9FJqXZwR%+`A#D#bbZ;ofP-4B_!NSkxA7D6vu{fn3*yS;O(1DyvjpK9lb)5%M0*IS~uaf_8r zUf-6{K}VvS-uct8Y%hz}Ac|jX#yy;Nz>Ay_W^X2YOL(UBT+JDMZIM;O7q}L`_99mBmI3B{q}*z1#u}MXwAsb+G36kytZvQ(EjeNEL_0;?vT3rZ@UXf2Dfb9i|TEpsNU`= zC9$kIbk6(AhTGVOxInulc|Z+(kT~2Nk&Yj7NPTjywKZ$tl+a!1UJm$A_w~>tb?@9Po4bh&c6SLQHNd7sz2|@Mh_g+|#XDRUXiz_q|Cp~ksTHz#$c8ZjR zL8&mAvNPw!c~0CV-AEY#*OX~Hb*2T&2(BFTVD5imYI@cXNpuOnaMM#+c~`o*KFim)NsfqXmGI&`41qfT_?b?&eDq!)8>UI|ag&YTp| zr?OVd&&ceN&06+;ACn`?XqDRTlHv`{rD!(+#y4~D3E2kD$kn&=g3e)K7wH7bY#-qo zyKr7h`w#ZCr0pXcUFlHi&UU?Ne#)GLWVKz|v0ZzCbJ()CQ(IMfJ-&^^{L{YgbC~-rFamQ{8R)S+Z4o77QlranM)9 zAm5lt+tR^S#>eaQO?w%}$gB~nGqs8g5tf`3`|cfr#5hGLU~SR^jM-r+m-Ay*M>?JHFH4cCj7v^ZH?U?(-{q?#6c!+>H?! z=j$?xWVln_xffUO6?^+T4|WF&Jt+P`lAGbNFUnu5_%?(uW1a^g5#NzO?6}e(s$fHy zhk8pjj=aF`DSOa-QvjbOTfsKYe^_0XH`06SC<0kU!XrF0BeqCSlRe=xk0Y&-f~=)= zU4CCdyKc*Q{mL-;`hQ!CVN-Ybyn5rb74OSdtcg~>o)>6kQ zV--K)ZLWv&=T8&R1v`vc$Tdhq-hHc}S}~;l}yw52R zpK;SF4@@H~^)yVN%FWiJUeh@UBBZxZuPHWx*I{O{FX(xbyi(VxW~q_kWiur1B|?+T zcB-fx^R7AQ^HWdY9aTa2wPjPskJhHx+Wz8NqO*RFGud3h+?=)QrPBE7SbL{H}P%lV10< zwUa9{d4+k~C{@H{<)(P*ZIpaAA645uiQe1GK4;I}`4!eZjK4YQ3fs{M9({HhpHnBR z9{`8bR|YdgEk2{yptT9M;fXfJqKBIn17|#=L+s)s)g~GD_N3#DtB(f!Bs+L!I9`0r z9dkHACToqS#Xx3ADhTY5Y%m{Xy_Z;>fsZ`7&f0{!Ol!#+NmxPOG@@LZyzQ%U_SSEG zZuq$5hTX6rT*~=Nqr0z<85zxYLn@-w7MGRgGsxqDdS!Zix0HK(TL{P5+wk1Cif=fP zp{h$KGmLMn=ZvBgFrdL41zxDkh-?t5&X#zLsM86|5v|6L83CLU`{0uGwrd#Xf-P)E z?$f$ZF^xw+I#yJEYHLKD)W-VcjpO)@jpuTw{7@s;+}z?or^4&Ad{{{Oym#eIt=ssn zBR(@b{V^#Mg3?hRj(oE)__7EHl&xIRg?39H5@V7 zTLf9@L+EJ>=B3U;BF&NOcHx#R12=#jd?niq_Zh8IsK- z);i{VeJooC?dSAtIohV@Wma^zVs@={xBc!qbV+@7V}16ZtPS~Yy1&KQw^ghQiA$r! zoeU6Z&fN{P6J0uo-bS|XOY1n7_wuXj`Y2|@f;x--(`OM{+0~PTDK+S8Pc@_+Bnur~ zViyEyZ(a4cB3S&z_$}Ls-&w!&)Dbw;x0bzKwoJFA142 zPh5cHoHH$}C!^s_;+5K#*nb^ARekbXF-K-|HfAM$Baj2Ke-rPv{fx1yx7T~=e^pi) ztLPdC2iQtyl~_j*8`#6UrK3%dF1<6qUhnNf_Td}aq%G0>I!3|QeCLSy#S**o=TBq> z^nV;9fV!g+;Xb9AV3oAHkOq^h5k3&bPs$phO<%;ytg z$fJ9tTQ3jKMyT_!6SyH`V-;b~mGe%~1bo^)ShIgVt;V|TCbp-JBr^KBTlBR%$cfwZ z_S{JkG6j61leFVb09@Tm`c3#=|Go{Kz6p(O1KD*>J4Fmyd|UKLU0N2y-gWQ77Q2r5 zV1}=Xg|L*orSCi?-aNwiU7c@DpH?-xc#(mZ>49+Ny&Sq!}!kC zH_S3i&h%yIo)rkZ`sRHb#duayVu$NG^wbUYce15C;1Af{<$k+=%!O%;H>X|-!Kt#ns+{s=GS&-+1wH~AEptVN!j+c6Kn%UJAwf~#Y4v*3mLo;lr9sh)W7>Bh&&aO1{ z(paW%m$D%QU5%e%6)YjjH%?W9#PoM`MyW7C8JOzhqZ*Yd$sGFxFI=^5)TYTrOR`m*Fs*D&dy^&Gx& zudU@;zEnJZ$aTb;#24W}a_40@u8m}e*=iUv>CPmpuh?etr2DZYtgYg%5gL+vAe0k% z2tR$L>$&Xe%HFR0fCTebQ##-Yo|xuy7Exp)30WJ-hTr8U_+uU$B!B-`L>wV}!n>e? z2_s2@S5;nGj93*leyVFAtl0Z77k`$-7hzv3vWny^=cMU;F6)NkK5UKR?oju)`uDK* zX3}~kkM*SeI(coV9eC8TY9MrD-Q!)es247@%d^3)ooX*xferoexBl}FIpE21j(Eh4 zxtCf++{oB*(!eho;(Y`=odU_MF!vS zJW5|b{3QYu7E{>l|rXs^oV@O@Qd*yr0QY|g(?3)ZCp0K8qS2l9fq%rfgRuE-42Rq!8RymNl zty!!i<~O?F&SmlijAQ>QUNsA?GIb?ud1cxW64nyEp}swuZtJ1qbQq2_lgVO6#|cxZ z#dbzT^;8I#cMkTOM3=v)T3TO-;Wz2DNc-w}G!5yjcNbXabstYtOX(K$J$Q#K@5Zxr zhrJ+zBbSMHQU2=`>m3JLw^B5S@JM&nibn)3N6|=3?>KwAZX!ZI>)r@W)uYOS>ZT(%E8K%*OY-@|L^nf#2c_e?{O81rO(@Dy_TcIf<-&PDq z8VC6}$>CI0Wm=tur5)_RCRV>mtRj=hX5v8B{VAUa`35yt`W45G&h?;cpu!oOTiOZS>pKEE}qK|$usjT&QrtGxFs;8=1-xfHl zQVbn3KDKtaRDQu%N_M||NJcMW6Fjo>!Ipe#=L0;)buZ068q?jLd`nHIZcqj9^L19; z?E7AbXFt9!>O60f7O@DXP=D#D#}(;OPXfz!QS%0h{p_yC`L6kXdnJ!r4{C~ObT%^5 zY&ywhWr@3tmS;Arv!`0UR^Y=^X0Q9r@^t=;{Y*NkWpsTQTXrGN@Ee*TN5MrzY?l65 zo{jxP`;%571%L5W;?F&Aw129PF};&={Z{$jF7l}@*%M`6bH$ajXG>0NJ;}gJy_yA_ z_sv4`$j*H8csP;u&NUmGDBOIA*rM`V?n>vbbsqNEQSl3fBeNjfemgQyd^n8VPM2yO4 zIddfJJjZZG_nh?1na@fxtd#10El*afyod1TA$zJZ9xX!S(&wLxsdxTFR@X>R9p;u` z#b)AWSN+>PK!>6#!&lx%c$c-a88wTJ)KAZ!b^;3V*rg3MVnH&F$QdDq0m#hTa*x9!UtBrf32?W zLwC^&va=7fI`hvzhc&Bzem}G|+q9V_HsRf}o(*|-cwU<0IkFR^`*x4j$6Weyyq)b^ z-9BD9B&wYwF2frTPduVoG=WLf>2KW{BRmQjU+UN}N z7c^&lD{{p$^-(z6_Ld>0fSuYrLGRG(Ct!`RRx~x@sb&16(Td3!%?=(NcbX~5UHpov z%ytI8SR3B$YToEm0^vcJ!%10INX=ZCaiYfkU)K0$E=UFKFDaI`? z`L${(pNLoFUT1gg+6SKR>@AiJ`^?n@Rmd^p0WWJhE$YP+qSaJ6@`9 zIck&so%ks>U7(ibI*S-)OcxGSPPDRFQeDYx9bOLR!cbJYVh2WsItes&C*c390z1E6 z=Q5L@?{S~$yh-aBXJoOz_zZXak{fB(=yfACx{jFUv6-bCS?%cHG=aOM{89^Q$a$pUXGXA%R&U4PYWjXGG~2Jsn{wq$KA2Iyuuo@^%>8)-$OZC z>qCsXU0zKJ8%1_Pi)G{xiZUxpTrF7FPqC&`#FE%L$#7>>v?=pFwb8M{7&B|EspC3W zzrqRj2J@}=Ie%xZ=!xC-76_4LR?kFH$<_MZj`t2IWlk993AnPW`j%Z@JG- zQjf)0tbLWLtHB;Ewaa@cK+SVfWYC(r%yF?FtJ$yW%ZwB{rVX(qP~j71QUEPDpC-s{ zHFq89So|1gSYM~u=WJZaYoKv9wJamkM|4o>O{s3I^}g*%z;g& z^=Y*4ENbevY9DX&e0VNhp^BU4NB*l<{LbW)k=ZI{R(*18d)(w*jc;GpUE61zPn^4j GI)4FZbta_% diff --git a/packages/sources/validator/src/commands/validate.ts b/packages/sources/validator/src/commands/validate.ts deleted file mode 100644 index 0c6b990c32b1f6e5234dd50547b6e8fbd6466398..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9754 zcmeHM?T%AL7@prG##8R8qW|MpzrVNtk-uAwn|bY@%OYFaf_J;Chh;-osQ>g9L|3f%4QEV<|YgGZfx(`Np2Rr^IVU(P4<6W=bX z$!t2CtoQ9+*!^D*dg?#pk3WC^4gYrCMSR|I7o5lF-92~c4)EvQV>fmuZsv|KF5TQU zcy>8^Ug612%%0*ib~RQn`{y)N+ z7lB?CI4|9EJoWB|TY$=B^{cz*66POcRRapM6`y@Kf&`;ApWX0{GR`3J0;?Km=iO`k zRqiF8w)ow;uiYzfpE%NNFf)ckN0@DjGq*8wf>pZ9yEE*YVl^$}-2mTP{Qqg-o^$>l z>t^6bZr_0yEl^`T#hBBg1!#|cdOu=C^d03Ai_u47B|9&+x&>(|ZxdD=gY&Yp@5`Wl zF3kwm-3{^{2OTQ>Y7M{brThxqPhe&0ejDHB?kD)}O2Gmpo>Q|!d5WKFXhKv>p*<0n zV!Lt=fP^KaCpKHmzh2?R%`Z;S=+RYTd2TjT( z)V{-aT8L<@SG>;*p3l=$^m~Z?Ewnj-9;v2$J_$Bzv4*mhc$V~y=#hQh?2#husrxpu zo!TR%W33%`MXedLF^U;E61R*#=8wtRuim9m(al>!*w&(e+IO``ak3LEbQq%M6o_Ed zeg-a#%98~AMg4y+|cb5 zG}uK}^TT4V-%dN*|MbyjHo7#g~2r5(tX z#;e+d*-diy&^>c^))p?yRKwQ9;1r|OSR(L!WWA`3ay6p7xX&JjjbNam9U=K^rM(2G{ zk*ecsvl$;_XOe7X1WoWGI4}Wf|k$Zb4^t zw3jzo{rKJ5S8}sTWTQ-_(NXmstsOxwTP-zP zupg%VH`}a_Vnos{_)ju1Ga~C;3;zu9ou95&?8Xf<hTAR4-q*=cOT9I;l8&MvX3u zQTO-rahFm_M$PYHX=}58f~5}wmL7zPD`y#tT(wz>2tCc8?`JvX)4p?HX1I!P>z3W39dwX_3OZPCuzuXsedF6Cz1#1cE@vjDJ z-3qsBJa-VyyydYg`_B?qyS#c|2faP~G2>iWYZ`MvehaYaWFR+uq-E_a=X~A}YIm8g z_!M(CyV~8nG2+ ze3DSwdV8F0(4YXIbF)JadAdO@kBW9|{#&285OC{2qR zm3F(@s}wA@^sZPf&L~%^-O8l9)3Lvj>dJ0KEk9)zvHe@wCXxYW$YQ*8Aa*PYW1K1v zu2>>}HCUf_r|qf(i2L&RKJUz^wz6Ka@hZ`7pYX;gX4MoyHdgfRUaF4%QclCQpY#cR zmtu4T{pWZG!`p9mR5wHK#FL@MmbIYeF6W6w$lJ#uBR&KLu4oV!pLKE?Ia?ihred}z zdvOq`$o=w5$TtYo2k77ys3QxUIYkcMv&(!L--EE8x7RrZQj(dzy~2b3Yrr|Dkk0qf zVeXSR0XYpj*SDYNJD#8N-EpRGFDnesnyl;j{_boa4eH7IKE~~QPNO^9M??H1Z`Jr4 zWt*;uy+QZAL4KPrIY!?Uq*14pje6)ig0%B_^B!`5PC(!8QuiBp`+L18sq`{D^YJ|_ z>!w&nbF_}u&fOK!hPsw0s6jF9Y*VSe*dP_}c;)8e$bA!Xh)QM=(PzEBvppj@-sPTm zx74qPy&Yt!3+ z?YMB2y}?L1*}1pFO>|&xNqK2k#ZJa*o8L<)&Q!;A>_LD`z1%2A@FaQ7m diff --git a/packages/sources/validator/src/commands/version.ts b/packages/sources/validator/src/commands/version.ts deleted file mode 100644 index 620db21dcf00c013f3aacb9c4f7296cf130dc467..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1302 zcmeHF%}T>S5T0{Ee1*ALOHFD(4|*zspj7Qa>N##EZ6MtZn^;8gfqV!Nd?8=KZ(Ea9nSQ*#zTk^#gt0{fVpygNn$rwF(}Gee zsh|wDAx9o(d*NKLu5shYVt)d=#z?WtI!xP+DWM7e19+X2z{9tgn_!n6?-}?Ed@Ps+ zJWO|iPh&CSuW-sVr3x&j-SshJ+%MqO%`Kq_8AM-k;;>S+LigZORSj@?h-R?f$OB&M7x7FPN>+uhHG|C2*==Vo++HVz4 z5bbw-Rp^d(TJtZ1!tQ(6bhsI6PJ{mg6k0_3ZM3@WqQ0BDjis6rXc&TXO}Cgc44u3D HPoYL1B{(gn diff --git a/packages/sources/validator/src/engine/flow01.ts b/packages/sources/validator/src/engine/flow01.ts deleted file mode 100644 index 1da8af27991eef252933a3fe632783b4123cc011..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7158 zcmeHL>rNX-6h6O^s=mU2s$xj63858D+8;@qR3J!DLP#Z)CdRDIQoMH8n>J~}1N9-Q zN`0ZeLceduhn-oEZETdLKPtoCX3p(9*WJeI>VjD{fBkMY);GR1J4rL|W#)M=>+tbz z+DfuPa$;U*CrNIK)5P5CH(NLjS8kfaBp;+8*{HAAK|-p7({y0k>3L#s?l<$o^xBqo zZ+~~+ap^2Z*%?@&kB%ga3y7 zC`a(zntTOLYtZ8bEZTy8Ymw)h_W5RH<@S(b%knt}mr<^|rz-6hBKJZ*gD&Y10a{Vb zp-CBX2bMgw2zB6L7rz~xGaC)}VHqQ}gv9H3VRmv?e<*d_dI33=KnPx|5*GphPJi3tXGVB=g3}VYgmjVAxPj(C$(lJ)a zVU*Jn)`)NlP6=|f)IP*-nqI6i1vs5TM!2_Lxpy{=lS6G2pdadb3hva8k>TnL^V=c9 zI;~V8SMG5d>AG*f&$EhX$uZQ{)gs1RS%=y{mUTy~CVk@fnk48k+F{sVYCt^$Cq~x3 zwd@q};biA_t%Jy_J~={;v-&w(4Xzb&hX*S-yHE~P;UxH_)t(<1Tox zhQ_kdr*YnPvO~|SO|If;Esa^tn!Q|!lQL(Qfr8W3SsU7`IXUO;|+y zjdq(_MQhb!1v*!~q}ux)s$2gLkT*3Tum`WR3o|Y{pl7w2Tp8)%5cQZnDp}9u%ZiXg z4!dX>F(J+uHp*r}Ls9)0IH>Foivar^Yfy+f{lFUkwi2njTXn1M^RZ<&;@lMGw)!lT z=W=QX-S@FPLcaDPof)4Xj_BRk^fNA2UG}jGwK08cAr2Y6)kvVlWsQ&P=toi**`fBO zhlq#vNjIN!l6F>&=DlJufBa6ySiLkKx=O9F|8L-`GCv-ou4nK)#K^bk8Ju(6RK_=j z(Fw?p__DTE<0HIxU3i{~8uDSZbt^SC+~FjRMjqcA_+G;dqg~n)bP^k#^XnD|_Qh)6 z#V4Y9I>xI=6^hy8&pojTl9Aeh?^xHC@J8^i!Z)t*1@^v*R0?`H=H*bcIxvp39=Y?{J zWrVJMm|Rfq><{jpP_3B9)5?Q(=(XcFd(10+RkN%5x2y^!r!eN#(pe*V`O>zSzhW}3 zTERlvc%B>i9KRCZal15wufp@Xz7A!S9_Re*zl+vvFY4pSn&Q5@%~s(?Yr$miGFnz< zs*8)4-gPxm-+$lBd!W9EZ-Si9o0tvjws)2HwJ7C0on&%^xo>sa&2>&=4OCq@eL5Yl z8hIs(C7(Jf0>7$sz?okX*b&$h*5~K~p+%((_de@%^=pLxJz&x|hH3W2Cu9BIS+f?B ze`@WcZFh%vU*kL-6}S6_+?arg&dDxIXnXlZ!_BraIY-b*zX~Xa>bb0Oif9?L)2dsQ z*ZBUe+OgWHoB_UBa572p&GH4FSLZn0=d>7|ORCbZH_@rIQR~N7wyFl#vA-(UkL1{d XcNIMRnN4+dUjV{8f8Vq>F-QLo%I>95 diff --git a/packages/sources/validator/src/engine/schema.ts b/packages/sources/validator/src/engine/schema.ts deleted file mode 100644 index d8b79ece69acd2eb61c568d74b4c9034c9b7952e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10012 zcmeHN-EJF26rSr!h*#L63OiA|t|EaDw53s-pq8|aNJuXbqQ+h)ZWG&DJ1L>f1Mv_D zi5KD(_`W$lo-?z%wo|y^0y*(|XXpH%^UayDJDZy~vd!$z-?FW{Tc2l7i*7j{WiQ90 zV-D{Pd&Ov4^t1C(zbLcWNs(<&x;(0P|)Y+36X`a70jOYgC_}5~TP0I0X+#8=} z(@D`A4u-u2UFSyUe>)hd|4cmo`r~)}b=)RiAGsSY!!>iy+`ikxf98%{*PXhd>*G3e zV^?DA4*m~Z&z-o!onbtkHN?CTMtAUj4B8Rq1>PTzGq>gL;{P+ud5ULUa21M|{(5X? z?}5IDIU_g4dmj|%_}s^5YBKXWWNzC{z(q95pt+^Fjd@3Y{uJXPXUpZ#AUAS?eh1*% z^)hHV=NI6x4NZ?=`OkQ!noJ`fT;NIYlt{7?9)ni_+RQz7FWe!nv|@sP+LO&SdkBwC zz-Qt*m}`A3zPHbNpeaEgq;$MRv}Ne|@cGPZ|Jq&PI`E!8!>1Os2sqcUzW$2uGZtozEdXnodG&{xT19u6#dydg5+%FiNdMS2XY5I6tE+{g0 zl~^(WZL{Rp(2zM;rDM)8gOrwjqb?I~6a7ZI8OBQ3$^2p_#1$cN-oXs!Fmv+VJgYK% zrpLwJuiclpqm8BKdOY{L%;J*}>*X_5>*ce~pz9Q`E-J8SkbSktmJYHlbC0}@tZM2l z*02H?H>o|V<rK9jETox5==j)6r#)%J(p-@!Jc0e9GrdZh9Ip=aVLZuwiaYCTVoKXvc#2un z8>zSVy{0Fa z%k0n^ZM&cFl6Z|UgIUb%Xn7yB=AW%6bS(BqYmq&w%Mke?QLkc6H5XL74e&{$q#T)1 zGsM62@oKV9&{b(d#p#In{SaK3l>uR!Jl^Erc>aMw6K2QteaxKucYM1{v-SPEjLRw? z6D63j#2>|>fY@!=Y5i4?7eprJJ8@AukQ{g4`-)^obSJ7vt(z&Zj=00@V|-}^wV`hn z-$G8LD7Ob$#NG_=F}h}`Q1a6nv6-WoXe*-5CdnklwJMS+@>}1uBP*ZJD>TJ5R;-mS z2$;?iJdANatu>1vJxG%^@>}?n)-$VLxm#FqtJ1E3oaqzQ_X<>!Gq#!(AuO-3isgtJ zaigk{imV)gM)SAM zhc^+SI-IrgRmWxiTUEKQlFF@CDYGuk1C`7?P%9LVLpAD%^|5?rN65ZVysKSm+S$gn zqB3PQI|uaunDK?dfjW8CU$i8x7FNJh_}~Th6uC#267eZ~mNH7JX=>^@|-Fn}H8$z4KS_sP|q@i@bawi0tMJ>E{|yNVf}=ZNsS zNcSD&q*4#SL-)C?ers1fuF+Srw_?QD&9RT;j*@m9&UL)E&~^-&++T7x_5j+F>H-#V z&%GQEgYBZpdez>FycX6W8%xE)`YN_w7s<n-`LHM|OKLJwVy4|7s=-k5jM%P^>3x6Egb`ova(=(Zjbu{s!k zo(kOZSzg^6bFUt+eN7r^rdnNx4eh=FpJ4LRicJ^4RaA1m)$VO*FU2xeCR5hQFX`95cZYqAR)T*@NKibx}Hvm91LI zA*l%6ZKyu=5mtS8jzIl*l5q+xx%aiGtWl9Ydf35CJr!*_Z=~UgK#5($*z=_noo^*v zEpX9}N;T~IY}1pzHgx2Ql~#i88a`|-4Qr?JwR$j%!;V|z3raL+U3^-{%#)LB<{wXZ zy1qgf0m(^=BO;sU;SYUoschEOHbzQN6WL`=s5}2nt5HrGCXhxt!LC4;b}I2%WOauY zD5a`myt1CNR%vgaRzjR>>Lt#KyUuu?E3)I+K)jzxNM`h)usvf>J{b!BmlTCKy4 z{W1AUmROH0UzM#~YoS!N=6LLHJ5PPge757-%ZNT&&w8~|EsCs%Y+5nOO|O<~nlWOJ z$jUt)^V@1{ zFZ->A%5S<#Pq70DJmrv`3M0-gi2by1r=R!X+p*te@tdU~>>(Nksl0pZY1q+(v#4+m z#_#5&8!f<(dz=v@(Ia({Pc_y|P;b2f-6bTl6C$ts{w3dUt*3npRFX-`a{_&c?PsuU zb^fFp+Ik~`6KS~G5Q~Wa%uU^^iwvzTcEqcFe(CD_M*WS#0z3Cv*D9=U18aVKE=X+4q3fG>hD9iU9Sx+}k?YaF+AGz=YP z6VLh>#iPs+yK~aIYR=6Mi_|}ljEzKVrGI08GJ0y6V#JQe5279GJ)U3Z|Ej;M*&X-Q z)>DENfg;`0@s}3bJ98ao=g>umz;!O}d;-erPE)^mSk>k7Hx-m|fQX-fFLxm8oy1Ak zNm||Q)%BRmJHgmDyi<$~zetEXCGGL*qMD{0nm{l#;dg(w;*yNdw7l*lbl4e~>>y1pknK!M8~* zi5ES3kYqD2JMX=j+4V=G0gw3og@Z|O!ZV4CR=n0KbK7Aai>f8ztxCkO-3U*sC`Q<2 z#=H_!=a2;6#Dm1CmYclhG%th^tH@Z^X``Jl!UY>i#fXZLEvrIGQ8u!0aB9A?PIG;; z?CDaYA4PFxwAHaLxUMA5(>&hm{DJ>Jhr6jia~~gXuXueL;W?lIF(T8P78GJJttg^` za!L>_X)+zwp=Jtbf^`h$j07A5j>6x%iCKpo!X*YrQH^f`&K5WUHo%rPKulAr;1cit z`kFEFtA=00tF04|hYq}b9lt?t5}^lpxsEM#Pgr-oS%hwPbxQ2F-rZT-3g^(fnM}jT z;A(riGj!7C+$q)HvNftcW2KEp2{c5nK3o)K;42^>s&-!2$B<5&34ZSW5?vL|`6;>p R(sYlLIQmt^w8Q_Z_z6l58Dsze diff --git a/packages/sources/validator/tsconfig.json b/packages/sources/validator/tsconfig.json deleted file mode 100644 index 88925401f..000000000 --- a/packages/sources/validator/tsconfig.json +++ /dev/null @@ -1,26 +0,0 @@ -{ - "compilerOptions": { - "target": "ES2020", - "module": "CommonJS", - "moduleResolution": "Node", - "lib": [ - "ES2020" - ], - "outDir": "./dist", - "rootDir": "./src", - "strict": true, - "esModuleInterop": true, - "skipLibCheck": true, - "forceConsistentCasingInFileNames": true, - "declaration": true, - "declarationMap": true, - "resolveJsonModule": true - }, - "include": [ - "src/**/*" - ], - "exclude": [ - "node_modules", - "dist" - ] -} diff --git a/release-config.yaml b/release-config.yaml index 93ab466dd..556fb85e7 100644 --- a/release-config.yaml +++ b/release-config.yaml @@ -22,51 +22,160 @@ website_release_version: "1.0.0" version: "1.0.0" +public_oss_projection_policy: + model: "clean-single-version-public-oss-projection" + source_authority: "Coregentis/MPLP-Protocol-Dev" + target_projection_repo: "Coregentis/MPLP-Protocol" + generated_bundle: "dist/mplp-v1.0" + release_config_role: "positive allowlist plus denylist for the generated OSS bundle" + authorization_boundary: + config_is_authorization: false + public_repo_mutation_requires_owner_authorization: true + registry_mutation_requires_separate_owner_authorization: true + tag_release_branch_cleanup_requires_separate_owner_authorization: true + public_repo_version_policy: + long_term_branches: + - "main" + temporary_projection_branches: "at most one clean projection PR branch per authorized execution" + codex_process_branches_in_public_repo: "forbidden by default" + retained_public_versions: "owner must choose exact tag/release before cleanup execution" + package_registry_release_scope: + npm_public_packages: + - "@mplp/schema" + - "@mplp/conformance" + - "@mplp/core" + - "@mplp/coordination" + - "@mplp/integration-llm-http" + - "@mplp/integration-storage-fs" + - "@mplp/integration-storage-kv" + - "@mplp/integration-tools-generic" + - "@mplp/modules" + - "@mplp/runtime-minimal" + - "@mplp/sdk-ts" + - "@mplp/devtools" + pypi_public_packages: + - "mplp-sdk" + excluded_packages: + "@mplp/compliance": "deprecated legacy alias; not projected as active public package" + "@mplp/validator": "internal CI/validation tooling; not projected as active public package" + generated_artifact_boundary: + repository_projection_dist: "generate dist/mplp-v1.0 from this config, then use that bundle as the public OSS projection candidate" + package_dist_directories: "excluded by default; npm/PyPI registries carry package artifacts" + package_dist_public_repo_exception: "requires a separate owner decision and package-surface allowlist" + governance_projection_boundary: + public_governance_layers: "constitutional, methods, distribution, selected records, versioning, and public identity/disambiguation" + dev_process_governance: "excluded from public OSS projection" + raw_publish_or_credential_evidence: "excluded from public OSS projection" + include: + # Root public OSS identity and contribution files. - "README.md" - "CHANGELOG.md" - "LICENSE.txt" - "CODE_OF_CONDUCT.md" - "CONTRIBUTING.md" + - "GOVERNANCE.md" - "SECURITY.md" - "MAINTAINERS.md" - "RELEASE_NOTES.md" - "VERSION.txt" + - "release-config.yaml" + - ".editorconfig" - "schemas/v2/**" - - "docs/**" # Docs source only (build artifacts excluded below) + + # Docs source/build inputs only. Generated docs output is excluded below. + - "docs/README.md" + - "docs/CHANGELOG.md" + - "docs/.gitignore" + - "docs/docusaurus.config.ts" + - "docs/package.json" + - "docs/package-lock.json" + - "docs/sidebars.ts" + - "docs/tsconfig.json" + - "docs/docs/**" + - "docs/src/**" + - "docs/static/**" - "assets/**" - - "tests/**" # All test suites: golden, cross-language, runtime-compat, schema-alignment - - "packages/**" # Reference SDK sources + + # Public verification and examples. + - "tests/**" - "examples/**" + + # Public package source surfaces. Include package metadata, README/license, + # public schemas/tests/fixtures/source mirrors, and public-safe derivation + # proofs. Generated package artifacts remain excluded by default. + - "packages/npm/schema/**" + - "packages/npm/conformance/**" + - "packages/npm/core/**" + - "packages/npm/coordination/**" + - "packages/npm/integration-llm-http/**" + - "packages/npm/integration-storage-fs/**" + - "packages/npm/integration-storage-kv/**" + - "packages/npm/integration-tools-generic/**" + - "packages/npm/modules/**" + - "packages/npm/runtime-minimal/**" + - "packages/npm/sdk-ts/**" + - "packages/npm/devtools/**" + - "packages/pypi/mplp-sdk/**" + - "packages/sources/sdk-ts/**" + - "packages/sources/sdk-py/**" + + # Public GitHub surfaces required for normal OSS contribution and security. - ".github/ISSUE_TEMPLATE/**" - ".github/PULL_REQUEST_TEMPLATE.md" - ".github/workflows/deploy-docs.yml" - ".github/workflows/codeql.yml" # NOTE: Only deploy-docs.yml and codeql.yml allowed in OSS package - ".eslintrc.json" - # Docs build dependency - only render-mermaid.mjs needed + + # Docs build dependency. Other docs/ops and Codex scripts stay internal. - "scripts/03-docs/render-mermaid.mjs" - # NOTE: other scripts/ excluded from OSS - internal development tools - - ".codeql/**" # CodeQL configuration + - ".codeql/**" # ============================================================================ - # PUBLIC GOVERNANCE (Layers 01-04) — Part of MPLP's Public Governance Contract - # These are normative protocol governance documents, publicly committed and stable. + # PUBLIC GOVERNANCE + # Include public governance principles and selected public-safe records only. + # Raw Dev/Codex execution, credential, publish, and branch-recovery records are + # excluded by default and may be represented only by public-safe summaries. # ============================================================================ - "governance/README.md" - "governance/EXECUTION_ORDER.md" - # Layer 01: Constitutional (full public) - "governance/01-constitutional/**" - # Layer 02: Methods (public - governance methods for consistency and auditability) - "governance/02-methods/**" - # Layer 03: Distribution (public - version rules, release flow, manifest rules) - - "governance/03-distribution/**" - # Layer 04: Records (public - ratified/frozen/sealed records and indices) - - "governance/04-records/**" - # Active version-domain and alignment governance + - "governance/03-distribution/sdk/README.md" + - "governance/03-distribution/sdk/METHOD-SDKR-02_DERIVATION_RULES.md" + - "governance/03-distribution/sdk/METHOD-SDKR-03_VERSIONING_LAW.md" + - "governance/03-distribution/sdk/METHOD-SDKR-04_PACKAGE_CONTENT_SPEC.md" + - "governance/03-distribution/sdk/METHOD-SDKR-06_POST_INSTALL_VERIFICATION.md" + - "governance/03-distribution/sdk/METHOD-SDKR-07_INCIDENT_AND_ROLLBACK.md" + - "governance/03-distribution/sdk/MPGC_APPROVAL_SDKR_v1.0.md" + - "governance/03-distribution/sdk/VERSION_REGISTRY.yaml" + - "governance/04-records/A-LINE-CLOSURE-CANDIDATE-2026-04-01.md" + - "governance/04-records/A-LINE-CLOSURE-RECORD-2026-04-01.md" + - "governance/04-records/AUDIT-ARTIFACT-ARCHIVE-2026-04-01.md" + - "governance/04-records/AUDIT-LINKMAP-2026-01-20-PHASE2B.md" + - "governance/04-records/AUDIT-LINKMAP-2026-01-20.md" + - "governance/04-records/AUDIT-LINKMAP-2026-01-21-AUTO.md" + - "governance/04-records/AUDIT-LINKMAP-2026-01-21-LINK-03-DETAILS.md" + - "governance/04-records/DEPRECATED-CONTENT-SEPARATION-2026-04-02.md" + - "governance/04-records/FR-ENTITY-ALIGNMENT-2026-01-08.md" + - "governance/04-records/FREEZE_EVIDENCE_BASELINE_v1.0.md" + - "governance/04-records/GOV-ADDENDUM-EVID-BASELINE-v1.0.md" + - "governance/04-records/MPGC-DESIGNATE-LAB-AUTHORITY-HOME.md" + - "governance/04-records/MPGC-RATIFY-2026-01-22-CONST-001-003.md" + - "governance/04-records/MPGC-RATIFY-ENTRY-MODEL-REALIGNMENT.md" + - "governance/04-records/MPGC-RECORD-2026-01-22-CROSS-ENTRY-PROJECTION-ALIGNMENT.md" + - "governance/04-records/PHASE-D-EXIT-CRITERIA.md" + - "governance/04-records/PHASE_E_FREEZE_RECORD.md" + - "governance/04-records/PHASE_E_PLUS_TEST_BASELINE_RECORD.md" + - "governance/04-records/PROJECT-FINAL-CLOSURE-READY-RECORD-2026-04-05.md" + - "governance/04-records/SEAL-DOCS-PHASE3-4-2026-01-21.md" + - "governance/04-records/SEAL-DOCS-SEO-INDEX-2026-01-21.md" + - "governance/04-records/SEAL-SSOT-ALIGNMENT-2026-01-20.md" + - "governance/04-records/UNIFIED-RECTIFICATION-MAINLINE-CLOSURE.md" + - "governance/04-records/VALIDATION_LAB_V2-TAIL-DISPOSITION-2026-04-01.md" - "governance/05-versioning/**" - "governance/global-alignment-baseline.yaml" - "governance/global-alignment-current.yaml" - # Active identity/disambiguation governance - "governance/05-specialized/ENTITY_CANONICAL.yaml" - "governance/05-specialized/entity.json" - "governance/05-specialized/ENTITY_DISAMBIGUATION_POLICY.md" @@ -76,9 +185,27 @@ include: exclude: + # Local workspace noise and root Dev-only files. + - ".DS_Store" + - "**/.DS_Store" + - "This" + - "AGENTS.md" + - ".codex/**" + - ".agents/**" + - "governance/codex-goals/**" + - "package-lock.json" + - "pnpm-lock.yaml" + - "pnpm-workspace.yaml" + - "tsconfig.base.json" + - ".npmrc" + - ".pypirc" + - ".env" + - ".env.*" + # External repositories / submodules - "MPLP_website/**" - "Validation_Lab/**" + - "Validation_Lab_V2/**" # Build artifacts and caches (match directory names directly) - "**/node_modules" @@ -91,17 +218,48 @@ exclude: - "docs/.docusaurus/**" - "docs/.cache" - "docs/.cache/**" + - "docs/ops/**" - "docs/static/mermaid" - "docs/static/mermaid/**" # Build-time generated SVGs (reproducible from source) + - "docs/static/img/.!*" + - "docs/src/**/*.clean_backup" # Version control - ".git/**" + - ".gitignore" + - ".gitmodules" - ".github/workflows/codeql-db/**" # Development tools - "tools/**" - "reports/**" - "scripts/release/**" + - "scripts/codex/**" + - "scripts/03-docs/semantic/**" + - "scripts/audit/**" + - "scripts/census/**" + - "scripts/gates/**" + - "scripts/semantic/**" + - "scripts/validate/**" + - "scripts/evaluator/**" + - "scripts/99-utils/**" + + # Package artifacts and non-public package surfaces. + - "packages/**/node_modules" + - "packages/**/node_modules/**" + - "packages/**/dist" + - "packages/**/dist/**" + - "packages/**/*.egg-info" + - "packages/**/*.egg-info/**" + - "packages/**/*.whl" + - "packages/**/*.tar.gz" + - "packages/**/package-lock.json" + - "packages/npm/compliance/**" + - "packages/npm/validator/**" + - "packages/sources/validator/**" + + # Internal and raw release evidence. + - "artifacts/**" # ============================================================================ # INTERNAL/OPERATIONAL GOVERNANCE — NOT Part of Public Governance Contract diff --git a/release-manifests/mplp-public-manifest.example.json b/release-manifests/mplp-public-manifest.example.json deleted file mode 100644 index 9e45013c1..000000000 --- a/release-manifests/mplp-public-manifest.example.json +++ /dev/null @@ -1,190 +0,0 @@ -{ - "manifest_id": "mplp-public-manifest-1.0.0-draft-650e5b2f", - "manifest_version": "0.1.0", - "generated_at": "2026-05-29T19:34:59+08:00", - "protocol_name": "MPLP", - "protocol_full_name": "Multi-Agent Lifecycle Protocol", - "protocol_version": "1.0.0", - "protocol_release_tag": null, - "protocol_commit_sha": "650e5b2f6754a7016d8c8184e54881b0fcef6683", - "copyright_holder": "Jearon Wong", - "trademark_notice": "Trademark notice pending owner approval. Downstream surfaces must not imply certification, endorsement, regulator approval, or protocol authority beyond this manifest.", - "license": "Apache-2.0", - "canonical_repository": "https://github.com/Coregentis/MPLP-Protocol", - "future_repository_target": "https://github.com/Multi-Agent-Lifecycle-Protocol/MPLP-Protocol", - "docs_url": "https://docs.mplp.io", - "website_url": "https://www.mplp.io", - "schema_manifest": { - "schema_bundle_version": "2.0.0", - "invariant_bundle_version": "2.0.0", - "schema_manifest_path": "schemas/v2/_manifests/", - "schema_manifest_url": "https://github.com/Coregentis/MPLP-Protocol/tree/main/schemas/v2/_manifests", - "schema_manifest_commit_sha": "650e5b2f6754a7016d8c8184e54881b0fcef6683" - }, - "sdk_packages": [ - { - "name": "@mplp/compliance", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/conformance", - "registry": "npm", - "current_version": "1.0.0", - "next_clean_version": "1.0.1", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/coordination", - "registry": "npm", - "current_version": "1.0.6", - "next_clean_version": "1.0.7", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/core", - "registry": "npm", - "current_version": "1.0.6", - "next_clean_version": "1.0.7", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/devtools", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/integration-llm-http", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/integration-storage-fs", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/integration-storage-kv", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/integration-tools-generic", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/modules", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/runtime-minimal", - "registry": "npm", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/schema", - "registry": "npm", - "current_version": "1.0.6", - "next_clean_version": "1.0.7", - "package_replacement_status": "planned_not_published" - }, - { - "name": "@mplp/sdk-ts", - "registry": "npm", - "current_version": "1.0.7", - "next_clean_version": "1.0.8", - "package_replacement_status": "planned_not_published" - } - ], - "pypi_packages": [ - { - "name": "mplp-sdk", - "registry": "pypi", - "current_version": "1.0.5", - "next_clean_version": "1.0.6", - "package_replacement_status": "planned_not_published" - } - ], - "validation_lab_pointer": { - "validation_lab_repo": "https://github.com/Coregentis/MPLP-Validation-Lab", - "future_validation_lab_repo_target": "https://github.com/Multi-Agent-Lifecycle-Protocol/MPLP-Validation-Lab", - "validation_lab_commit_sha": null, - "validation_lab_release_tag": null, - "consumed_protocol_manifest_id": "mplp-public-manifest-1.0.0-draft-650e5b2f", - "ruleset_version": "ruleset-1.0", - "evidence_pack_version": null, - "lab_url": "https://lab.mplp.io", - "relation_status": "standalone_pointer_pending" - }, - "validation_lab_boundary": { - "non_certifying": true, - "non_normative": true, - "evidence_based_verdicts_only": true, - "no_endorsement": true, - "no_certification": true, - "no_regulator_approval": true, - "no_protocol_truth_override": true, - "no_runtime_authority": true, - "no_sdk_authority": true - }, - "website_boundary": { - "discovery_positioning_only": true, - "seo_geo_surface": true, - "protocol_truth_override_allowed": false, - "schema_truth_override_allowed": false, - "release_truth_override_allowed": false, - "package_publication_authority_allowed": false - }, - "release_status": { - "state": "draft", - "public_release_ready": false, - "gates": { - "schema_validated": true, - "example_validated": true, - "website_consumption_verified": false, - "validation_lab_pointer_verified": false, - "submodule_removal_allowed": false - } - }, - "forbidden_claims": [ - "MPLP-certified", - "certified by MPLP", - "officially endorsed by MPLP", - "regulator approved", - "Website defines protocol truth", - "Validation Lab defines protocol truth", - "package version equals protocol version unless explicitly stated" - ], - "non_certification_notice": "MPLP Validation Lab outputs are evidence-based and non-certifying. They do not constitute endorsement, regulator approval, runtime authority, SDK authority, or protocol authority.", - "package_replacement_status": { - "status": "planned_not_published", - "clean_replacement_versions_defined": true, - "package_actions_executed": false - }, - "repo_migration_status": { - "status": "reserved_future_org_not_migrated", - "current_org": "Coregentis", - "future_org": "Multi-Agent-Lifecycle-Protocol", - "migration_now": false, - "remotes_changed": false, - "package_repository_urls_changed": false - } -} diff --git a/release-manifests/mplp-public-manifest.schema.json b/release-manifests/mplp-public-manifest.schema.json deleted file mode 100644 index 326b1820d..000000000 --- a/release-manifests/mplp-public-manifest.schema.json +++ /dev/null @@ -1,499 +0,0 @@ -{ - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$id": "https://github.com/Coregentis/MPLP-Protocol/release-manifests/mplp-public-manifest.schema.json", - "title": "MPLP Protocol Public Manifest", - "description": "Pointer-only public manifest exported by MPLP-Protocol for Website and Validation Lab consumption.", - "type": "object", - "additionalProperties": false, - "required": [ - "manifest_id", - "manifest_version", - "generated_at", - "protocol_name", - "protocol_full_name", - "protocol_version", - "protocol_release_tag", - "protocol_commit_sha", - "copyright_holder", - "trademark_notice", - "license", - "canonical_repository", - "future_repository_target", - "docs_url", - "website_url", - "schema_manifest", - "sdk_packages", - "pypi_packages", - "validation_lab_pointer", - "validation_lab_boundary", - "website_boundary", - "release_status", - "forbidden_claims", - "non_certification_notice", - "package_replacement_status", - "repo_migration_status" - ], - "properties": { - "manifest_id": { - "type": "string", - "minLength": 1 - }, - "manifest_version": { - "type": "string", - "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" - }, - "generated_at": { - "type": "string", - "format": "date-time" - }, - "protocol_name": { - "type": "string", - "const": "MPLP" - }, - "protocol_full_name": { - "type": "string", - "const": "Multi-Agent Lifecycle Protocol" - }, - "protocol_version": { - "type": "string", - "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" - }, - "protocol_release_tag": { - "type": [ - "string", - "null" - ] - }, - "protocol_commit_sha": { - "type": "string", - "pattern": "^[0-9a-f]{40}$" - }, - "copyright_holder": { - "type": "string", - "minLength": 1 - }, - "trademark_notice": { - "type": "string", - "minLength": 1 - }, - "license": { - "type": "string", - "const": "Apache-2.0" - }, - "canonical_repository": { - "type": "string", - "format": "uri" - }, - "future_repository_target": { - "type": "string", - "format": "uri" - }, - "docs_url": { - "type": "string", - "format": "uri" - }, - "website_url": { - "type": "string", - "format": "uri" - }, - "schema_manifest": { - "type": "object", - "additionalProperties": false, - "required": [ - "schema_bundle_version", - "invariant_bundle_version", - "schema_manifest_path", - "schema_manifest_url", - "schema_manifest_commit_sha" - ], - "properties": { - "schema_bundle_version": { - "type": "string", - "minLength": 1 - }, - "invariant_bundle_version": { - "type": "string", - "minLength": 1 - }, - "schema_manifest_path": { - "type": "string", - "minLength": 1 - }, - "schema_manifest_url": { - "type": "string", - "format": "uri" - }, - "schema_manifest_commit_sha": { - "type": "string", - "pattern": "^[0-9a-f]{40}$" - } - } - }, - "sdk_packages": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "additionalProperties": false, - "required": [ - "name", - "registry", - "current_version", - "next_clean_version", - "package_replacement_status" - ], - "properties": { - "name": { - "type": "string", - "minLength": 1 - }, - "registry": { - "type": "string", - "const": "npm" - }, - "current_version": { - "type": "string", - "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" - }, - "next_clean_version": { - "type": "string", - "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" - }, - "package_replacement_status": { - "type": "string", - "enum": [ - "planned_not_published", - "published", - "deferred", - "skipped" - ] - } - } - } - }, - "pypi_packages": { - "type": "array", - "items": { - "type": "object", - "additionalProperties": false, - "required": [ - "name", - "registry", - "current_version", - "next_clean_version", - "package_replacement_status" - ], - "properties": { - "name": { - "type": "string", - "minLength": 1 - }, - "registry": { - "type": "string", - "const": "pypi" - }, - "current_version": { - "type": "string", - "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" - }, - "next_clean_version": { - "type": "string", - "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" - }, - "package_replacement_status": { - "type": "string", - "enum": [ - "planned_not_published", - "published", - "deferred", - "skipped" - ] - } - } - } - }, - "validation_lab_pointer": { - "type": "object", - "additionalProperties": false, - "required": [ - "validation_lab_repo", - "future_validation_lab_repo_target", - "validation_lab_commit_sha", - "validation_lab_release_tag", - "consumed_protocol_manifest_id", - "ruleset_version", - "evidence_pack_version", - "lab_url", - "relation_status" - ], - "properties": { - "validation_lab_repo": { - "type": "string", - "format": "uri" - }, - "future_validation_lab_repo_target": { - "type": "string", - "format": "uri" - }, - "validation_lab_commit_sha": { - "type": [ - "string", - "null" - ], - "pattern": "^[0-9a-f]{40}$" - }, - "validation_lab_release_tag": { - "type": [ - "string", - "null" - ] - }, - "consumed_protocol_manifest_id": { - "type": "string", - "minLength": 1 - }, - "ruleset_version": { - "type": "string", - "minLength": 1 - }, - "evidence_pack_version": { - "type": [ - "string", - "null" - ] - }, - "lab_url": { - "type": "string", - "format": "uri" - }, - "relation_status": { - "type": "string", - "enum": [ - "standalone_pointer_pending", - "standalone_pointer_verified", - "superseded" - ] - } - } - }, - "validation_lab_boundary": { - "type": "object", - "additionalProperties": false, - "required": [ - "non_certifying", - "non_normative", - "evidence_based_verdicts_only", - "no_endorsement", - "no_certification", - "no_regulator_approval", - "no_protocol_truth_override", - "no_runtime_authority", - "no_sdk_authority" - ], - "properties": { - "non_certifying": { - "type": "boolean", - "const": true - }, - "non_normative": { - "type": "boolean", - "const": true - }, - "evidence_based_verdicts_only": { - "type": "boolean", - "const": true - }, - "no_endorsement": { - "type": "boolean", - "const": true - }, - "no_certification": { - "type": "boolean", - "const": true - }, - "no_regulator_approval": { - "type": "boolean", - "const": true - }, - "no_protocol_truth_override": { - "type": "boolean", - "const": true - }, - "no_runtime_authority": { - "type": "boolean", - "const": true - }, - "no_sdk_authority": { - "type": "boolean", - "const": true - } - } - }, - "website_boundary": { - "type": "object", - "additionalProperties": false, - "required": [ - "discovery_positioning_only", - "seo_geo_surface", - "protocol_truth_override_allowed", - "schema_truth_override_allowed", - "release_truth_override_allowed", - "package_publication_authority_allowed" - ], - "properties": { - "discovery_positioning_only": { - "type": "boolean", - "const": true - }, - "seo_geo_surface": { - "type": "boolean", - "const": true - }, - "protocol_truth_override_allowed": { - "type": "boolean", - "const": false - }, - "schema_truth_override_allowed": { - "type": "boolean", - "const": false - }, - "release_truth_override_allowed": { - "type": "boolean", - "const": false - }, - "package_publication_authority_allowed": { - "type": "boolean", - "const": false - } - } - }, - "release_status": { - "type": "object", - "additionalProperties": false, - "required": [ - "state", - "public_release_ready", - "gates" - ], - "properties": { - "state": { - "type": "string", - "enum": [ - "draft", - "candidate", - "published", - "superseded" - ] - }, - "public_release_ready": { - "type": "boolean" - }, - "gates": { - "type": "object", - "additionalProperties": false, - "required": [ - "schema_validated", - "example_validated", - "website_consumption_verified", - "validation_lab_pointer_verified", - "submodule_removal_allowed" - ], - "properties": { - "schema_validated": { - "type": "boolean" - }, - "example_validated": { - "type": "boolean" - }, - "website_consumption_verified": { - "type": "boolean" - }, - "validation_lab_pointer_verified": { - "type": "boolean" - }, - "submodule_removal_allowed": { - "type": "boolean", - "const": false - } - } - } - } - }, - "forbidden_claims": { - "type": "array", - "minItems": 1, - "items": { - "type": "string", - "minLength": 1 - } - }, - "non_certification_notice": { - "type": "string", - "minLength": 1 - }, - "package_replacement_status": { - "type": "object", - "additionalProperties": false, - "required": [ - "status", - "clean_replacement_versions_defined", - "package_actions_executed" - ], - "properties": { - "status": { - "type": "string", - "enum": [ - "planned_not_published", - "published", - "deferred" - ] - }, - "clean_replacement_versions_defined": { - "type": "boolean" - }, - "package_actions_executed": { - "type": "boolean", - "const": false - } - } - }, - "repo_migration_status": { - "type": "object", - "additionalProperties": false, - "required": [ - "status", - "current_org", - "future_org", - "migration_now", - "remotes_changed", - "package_repository_urls_changed" - ], - "properties": { - "status": { - "type": "string", - "const": "reserved_future_org_not_migrated" - }, - "current_org": { - "type": "string", - "const": "Coregentis" - }, - "future_org": { - "type": "string", - "const": "Multi-Agent-Lifecycle-Protocol" - }, - "migration_now": { - "type": "boolean", - "const": false - }, - "remotes_changed": { - "type": "boolean", - "const": false - }, - "package_repository_urls_changed": { - "type": "boolean", - "const": false - } - } - } - } -} diff --git a/scripts/03-docs/semantic/mapping-health.mjs b/scripts/03-docs/semantic/mapping-health.mjs deleted file mode 100644 index 7db418849..000000000 --- a/scripts/03-docs/semantic/mapping-health.mjs +++ /dev/null @@ -1,156 +0,0 @@ -#!/usr/bin/env node -/** - * MPLP Cross-Surface Mapping Health Check - * Version: 1.0.0 - * Authority: MPGC (Release Gate-0) - * - * Verifies that all required cross-surface links defined in - * canonical-cross-surface-mapping.yaml are reachable. - */ - -import fs from "fs"; -import path from "path"; -import { fileURLToPath } from "url"; - -const __filename = fileURLToPath(import.meta.url); -const __dirname = path.dirname(__filename); -const ROOT = path.resolve(__dirname, "../../.."); - -const MAPPING_PATH = path.join(ROOT, "MPLP_website/governance/semantic/canonical-cross-surface-mapping.yaml"); - -// Simple YAML parser for our specific structure -function parseSimpleYaml(content) { - const lines = content.split("\n"); - const urls = []; - - for (const line of lines) { - // Extract URLs from target fields - const match = line.match(/target:\s*["']?(https?:\/\/[^\s"']+)["']?/); - if (match) { - urls.push(match[1]); - } - } - - return [...new Set(urls)]; -} - -async function checkUrl(url, timeout = 10000) { - try { - const controller = new AbortController(); - const timeoutId = setTimeout(() => controller.abort(), timeout); - - const response = await fetch(url, { - method: "HEAD", - signal: controller.signal, - redirect: "follow" - }); - - clearTimeout(timeoutId); - - return { - url, - status: response.status, - ok: response.ok || response.status === 301 || response.status === 302 - }; - } catch (error) { - return { - url, - status: 0, - ok: false, - error: error.message - }; - } -} - -function log(level, message) { - const prefix = { - info: "ℹ️", - warn: "⚠️", - error: "❌", - pass: "✅" - }[level] || ""; - - console.log(`${prefix} [MAPPING-HEALTH] ${message}`); -} - -async function main() { - console.log("\n" + "=".repeat(60)); - console.log("MPLP Cross-Surface Mapping Health Check v1.0.0"); - console.log("=".repeat(60) + "\n"); - - const isCI = process.argv.includes("--ci"); - // Default to skipping live checks unless explicitly enabled - const checkLive = process.argv.includes("--check-live"); - const skipLive = !checkLive; - - // Check if mapping file exists - if (!fs.existsSync(MAPPING_PATH)) { - log("warn", `Mapping file not found: ${MAPPING_PATH}`); - log("warn", "Skipping cross-surface checks (likely OSS Release mode without Website)"); - process.exit(0); // Pass, as this is expected in OSS release - } - - // Parse mapping file - log("info", "Loading canonical-cross-surface-mapping.yaml..."); - const content = fs.readFileSync(MAPPING_PATH, "utf8"); - const urls = parseSimpleYaml(content); - - log("info", `Found ${urls.length} unique URLs to verify`); - - if (skipLive) { - log("warn", "Skipping live URL checks (--skip-live)"); - log("pass", "Mapping file structure verified"); - process.exit(0); - } - - // Check each URL - log("info", "Checking URL reachability...\n"); - - const results = []; - for (const url of urls) { - process.stdout.write(` Checking ${url}... `); - const result = await checkUrl(url); - results.push(result); - - if (result.ok) { - console.log(`✅ ${result.status}`); - } else { - console.log(`❌ ${result.status || result.error}`); - } - } - - // Summary - console.log("\n" + "-".repeat(60)); - - const passed = results.filter(r => r.ok).length; - const failed = results.filter(r => !r.ok).length; - - log("info", `Results: ${passed} passed, ${failed} failed`); - - // Write JSON report - const reportPath = path.join(process.cwd(), "mapping-health-report.json"); - fs.writeFileSync(reportPath, JSON.stringify({ passed, failed, results }, null, 2)); - log("info", `Report written to ${reportPath}`); - - if (failed > 0) { - log("error", "Some URLs are not reachable:"); - results.filter(r => !r.ok).forEach(r => { - console.log(` ❌ ${r.url}`); - }); - - if (isCI) { - log("warn", "Failing CI due to unreachable URLs"); - process.exit(1); - } - } else { - log("pass", "All cross-surface URLs are reachable"); - } - - console.log("-".repeat(60) + "\n"); - process.exit(failed > 0 ? 1 : 0); -} - -main().catch(e => { - console.error(e); - process.exit(1); -}); diff --git a/scripts/03-docs/semantic/semantic-lint.mjs b/scripts/03-docs/semantic/semantic-lint.mjs deleted file mode 100644 index 629c262c3..000000000 --- a/scripts/03-docs/semantic/semantic-lint.mjs +++ /dev/null @@ -1,427 +0,0 @@ -#!/usr/bin/env node -/** - * MPLP Semantic Lint Gate - * Version: 1.0.0 - * Authority: MPGC (Release Gate-0) - * - * This script enforces semantic governance rules defined in: - * - semantic-positioning-anchors.yaml - * - seo-jsonld-contract.md - * - * Exit 0 = PASS, Exit 1 = FAIL - */ - -import fs from "fs"; -import path from "path"; -import { fileURLToPath } from "url"; - -const __filename = fileURLToPath(import.meta.url); -const __dirname = path.dirname(__filename); -const ROOT = path.resolve(__dirname, "../../.."); - -// Configuration -const CONFIG = { - anchorsPath: "MPLP_website/governance/semantic/semantic-positioning-anchors.yaml", - - // Forbidden terms (from anchors lint_hooks) - focusing on critical identity violations - forbiddenTerms: [ - "MPLP compliant", - "MPLP-compliant" - ], - - // Additional terms that need negation context check - contextSensitiveTerms: [ - "certified", - "certification", - "endorsement", - "approved by" - ], - - // Allowed in these contexts (documentation of forbidden terms) - allowedContextPatterns: [ - /forbidden.*patterns/i, - /forbidden_terms/i, - /lint_hooks/i, - /seo-jsonld-contract\.md/i, - /CHANGELOG\.md/i, - /Replaced.*instances/i, - /forbidden.*term/i, - /semantic-lint\.mjs/i, - /"MPLP-compliant"/i, // Quoted references - /`MPLP-compliant`/i, // Code references - /patterns:\s*$/i, - /use the terms/i, - /forbidden content/i, - /allowed content/i, - /incorrect terminology/i, - /\| instead of \| use \|/i, - /\| tier 1 \| fail \|/i, - /\| url \| expected content \| status \|/i, - /bad:\s*/i, - /example terms/i, - /historical/i, - /replacement table/i, - /SEAL-SSOT-ALIGNMENT-2026-01-20\.md/i - ], - - // URL standard enforcement - forbiddenURL: "https://mplp.io", - canonicalURL: "https://www.mplp.io", - - // JSON-LD type whitelist - jsonLdWhitelist: [ - "Organization", "SoftwareSourceCode", "TechArticle", "Specification", - "FAQPage", "WebSite", "WebPage", "DefinedTerm", "DefinedTermSet" - ], - - jsonLdForbidden: [ - "Product", "Service", "Certification", "Offer", "Review", "Rating" - ], - - // File patterns to scan - includePatterns: [ - "**/*.{md,mdx,ts,tsx,js,jsx,json,yaml,yml}" - ], - - excludePatterns: [ - "**/node_modules/**", - "**/.next/**", - "**/dist/**", - "**/build/**", - "**/.git/**", - "**/package-lock.json", - "**/pnpm-lock.yaml" - ], - - releaseScopeExcludedPrefixes: [ - "MPLP_website/", - "Validation_Lab/", - "Validation_Lab_V2/", - "governance/06-operations/", - "governance/audits/", - "scripts/01-codegen/", - "scripts/02-verification/", - "scripts/audit/", - "scripts/semantic/gate_pypi_set/", - "scripts/03-docs/semantic/schemas/" - ], - - // T0 invariants to check - t0Checks: [ - { - file: "MPLP_website/app/page.tsx", - mustContain: ["lifecycle protocol", "Agent OS Protocol"] - }, - { - file: "README.md", - mustContain: ["lifecycle protocol", "Not a framework", "Not a runtime", "Not a platform"] - }, - { - file: "docs/docs/intro.mdx", - mustContain: ["not", "certification"] - } - ] -}; - -// Utility functions -function readFile(filePath) { - try { - return fs.readFileSync(path.join(ROOT, filePath), "utf8"); - } catch (e) { - return null; - } -} - -function getAllFiles(dir, patterns, excludes) { - const results = []; - - // Directories to always exclude by name - const excludedDirNames = [ - "node_modules", ".next", "dist", "build", ".git", ".docusaurus", - ".archive", ".pytest_cache", "__pycache__", ".vscode", "reports", "tools", - "project-governance", "docs-backup-corrupted", "docs-upgrade-kit", "release" - ]; - const excludedFileNames = ["package-lock.json", "pnpm-lock.yaml"]; - - function walk(currentDir) { - if (!fs.existsSync(currentDir)) return; - - const items = fs.readdirSync(currentDir, { withFileTypes: true }); - - for (const item of items) { - // Skip excluded directories by name - if (item.isDirectory() && excludedDirNames.includes(item.name)) { - continue; - } - - // Skip excluded files by name - if (!item.isDirectory() && excludedFileNames.includes(item.name)) { - continue; - } - - const fullPath = path.join(currentDir, item.name); - const relativePath = path.relative(ROOT, fullPath); - - if (CONFIG.releaseScopeExcludedPrefixes.some(prefix => relativePath.startsWith(prefix))) { - continue; - } - - if (item.isDirectory()) { - walk(fullPath); - } else { - // Check includes - const ext = path.extname(item.name).slice(1); - const validExts = ["md", "mdx", "ts", "tsx", "js", "jsx", "json", "yaml", "yml"]; - if (validExts.includes(ext)) { - results.push({ path: relativePath, fullPath }); - } - } - } - } - - walk(ROOT); - return results; -} - -function log(level, message) { - const prefix = { - info: "ℹ️", - warn: "⚠️", - error: "❌", - pass: "✅" - }[level] || ""; - - console.log(`${prefix} [SEMANTIC-LINT] ${message}`); -} - -// Check functions -function checkForbiddenTerms(files) { - log("info", "Checking forbidden terms..."); - const violations = []; - - for (const file of files) { - const content = readFile(file.path); - if (!content) continue; - - // Skip files that document forbidden terms - const isDocumentation = CONFIG.allowedContextPatterns.some(p => p.test(file.path)); - if (isDocumentation) continue; - - for (const term of CONFIG.forbiddenTerms) { - const regex = new RegExp(term, "gi"); - const matches = content.match(regex); - - if (matches) { - // Check if in allowed context - const lines = content.split("\n"); - for (let i = 0; i < lines.length; i++) { - if (lines[i].toLowerCase().includes(term.toLowerCase())) { - // Check surrounding context - const context = lines.slice(Math.max(0, i - 2), i + 3).join("\n"); - const isAllowed = CONFIG.allowedContextPatterns.some(p => p.test(context)); - - if (!isAllowed) { - violations.push({ - file: file.path, - line: i + 1, - term, - context: lines[i].trim().slice(0, 100) - }); - } - } - } - } - } - } - - if (violations.length > 0) { - log("error", `Found ${violations.length} forbidden term violation(s):`); - violations.slice(0, 10).forEach(v => { - console.log(` ${v.file}:${v.line} - "${v.term}"`); - console.log(` ${v.context}`); - }); - return false; - } - - log("pass", "No forbidden terms found"); - return true; -} - -function checkCanonicalURL(files) { - log("info", "Checking URL standardization..."); - const violations = []; - - // Pattern to find https://mplp.io but not https://www.mplp.io - const forbiddenPattern = /https:\/\/mplp\.io(?!\/)/g; - - for (const file of files) { - const content = readFile(file.path); - if (!content) continue; - - // Find all occurrences - const lines = content.split("\n"); - for (let i = 0; i < lines.length; i++) { - // Check for forbidden URL pattern - if (lines[i].includes("https://mplp.io") && !lines[i].includes("https://www.mplp.io")) { - const context = lines.slice(Math.max(0, i - 3), i + 4).join("\n"); - const isDocumentation = - CONFIG.allowedContextPatterns.some(p => p.test(context)) || - CONFIG.allowedContextPatterns.some(p => p.test(file.path)); - if (!isDocumentation) { - violations.push({ - file: file.path, - line: i + 1, - content: lines[i].trim().slice(0, 100) - }); - } - } - } - } - - if (violations.length > 0) { - log("error", `Found ${violations.length} non-canonical URL(s) (use https://www.mplp.io):`); - violations.slice(0, 10).forEach(v => { - console.log(` ${v.file}:${v.line}`); - console.log(` ${v.content}`); - }); - return false; - } - - log("pass", "All URLs use canonical format (www.mplp.io)"); - return true; -} - -function checkT0Invariants() { - log("info", "Checking T0 invariants..."); - const violations = []; - - for (const check of CONFIG.t0Checks) { - const content = readFile(check.file); - - if (!content) { - violations.push({ file: check.file, issue: "File not found" }); - continue; - } - - for (const must of check.mustContain) { - if (!content.toLowerCase().includes(must.toLowerCase())) { - violations.push({ file: check.file, issue: `Missing: "${must}"` }); - } - } - } - - if (violations.length > 0) { - log("error", `Found ${violations.length} T0 invariant violation(s):`); - violations.forEach(v => { - console.log(` ${v.file}: ${v.issue}`); - }); - return false; - } - - log("pass", "T0 invariants verified"); - return true; -} - -function checkJsonLdTypes(files) { - log("info", "Checking JSON-LD schema types..."); - const violations = []; - - // Find files that might contain JSON-LD - const jsonLdFiles = files.filter(f => - f.path.includes("json-ld") || - f.path.includes("jsonld") || - f.path.endsWith(".tsx") || - f.path.endsWith(".ts") - ); - - for (const file of jsonLdFiles) { - const content = readFile(file.path); - if (!content) continue; - - // Skip if no JSON-LD context - if (!content.includes('"@context"') && !content.includes("'@context'")) continue; - - // Find @type declarations - const typeMatches = content.matchAll(/"@type"\s*:\s*"([^"]+)"/g); - - for (const match of typeMatches) { - const type = match[1]; - - if (CONFIG.jsonLdForbidden.includes(type)) { - violations.push({ file: file.path, type, reason: "Forbidden type" }); - } else if (!CONFIG.jsonLdWhitelist.includes(type)) { - // Warn but don't fail for unknown types - log("warn", `Unknown JSON-LD type in ${file.path}: ${type}`); - } - } - } - - if (violations.length > 0) { - log("error", `Found ${violations.length} JSON-LD type violation(s):`); - violations.forEach(v => { - console.log(` ${v.file}: @type="${v.type}" (${v.reason})`); - }); - return false; - } - - log("pass", "JSON-LD types comply with whitelist"); - return true; -} - -// Main execution -async function main() { - console.log("\n" + "=".repeat(60)); - console.log("MPLP Semantic Lint Gate v1.0.0"); - console.log("=".repeat(60) + "\n"); - - const isCI = process.argv.includes("--ci"); - - // Check if Website exists (it might be excluded in OSS release) - const websitePath = path.join(ROOT, "MPLP_website"); - const websiteExists = fs.existsSync(websitePath); - - if (!websiteExists) { - log("warn", "MPLP_website directory not found. Skipping website-specific checks (OSS Release mode)."); - - // Filter out website-specific T0 checks - CONFIG.t0Checks = CONFIG.t0Checks.filter(check => !check.file.startsWith("MPLP_website")); - - // Disable anchors check if path starts with MPLP_website - if (CONFIG.anchorsPath.startsWith("MPLP_website")) { - CONFIG.anchorsPath = null; - } - } - - // Gather files - log("info", "Scanning files..."); - const files = getAllFiles(ROOT, CONFIG.includePatterns, CONFIG.excludePatterns); - log("info", `Found ${files.length} files to check`); - - // Run checks - const results = []; - - results.push(checkForbiddenTerms(files)); - results.push(checkCanonicalURL(files)); - results.push(checkT0Invariants()); - results.push(checkJsonLdTypes(files)); - - // Summary - console.log("\n" + "-".repeat(60)); - - const passed = results.every(r => r); - - if (passed) { - log("pass", "ALL CHECKS PASSED"); - console.log("-".repeat(60) + "\n"); - process.exit(0); - } else { - log("error", "SEMANTIC LINT FAILED"); - console.log("-".repeat(60) + "\n"); - process.exit(1); - } -} - -main().catch(e => { - console.error(e); - process.exit(1); -}); diff --git a/scripts/03-docs/verify-governance-styling.mjs b/scripts/03-docs/verify-governance-styling.mjs deleted file mode 100644 index cb8fee324..000000000 --- a/scripts/03-docs/verify-governance-styling.mjs +++ /dev/null @@ -1,102 +0,0 @@ -#!/usr/bin/env node -import fs from "node:fs"; -import path from "node:path"; - -const ROOT = process.cwd(); - -function listFiles(dir, exts) { - const out = []; - const stack = [dir]; - while (stack.length) { - const cur = stack.pop(); - if (!fs.existsSync(cur)) continue; - const st = fs.statSync(cur); - if (st.isDirectory()) { - for (const name of fs.readdirSync(cur)) stack.push(path.join(cur, name)); - } else { - const ext = path.extname(cur).toLowerCase(); - if (exts.includes(ext)) out.push(cur); - } - } - return out.sort(); -} - -function readText(p) { - return fs.readFileSync(p, "utf8"); -} - -// Minimal frontmatter parser: extracts YAML-like key: value in leading --- block. -function parseFrontmatter(md) { - md = md.replace(/^[\uFEFF\s]*/, ''); // Remove BOM and leading whitespace - if (!md.startsWith("---")) return { fm: {}, body: md }; - const end = md.indexOf("\n---", 3); - if (end === -1) return { fm: {}, body: md }; - const fmRaw = md.slice(3, end).trim(); - const body = md.slice(end + 4); - const fm = {}; - for (const line of fmRaw.split("\n")) { - const m = line.match(/^([A-Za-z0-9_-]+)\s*:\s*(.*)\s*$/); - if (m) fm[m[1]] = m[2].replace(/^["']|["']$/g, ""); - } - return { fm, body }; -} - -function fail(msg) { - console.error(`[FAIL] ${msg}`); - process.exit(1); -} - -function pass(msg) { - console.log(`[PASS] ${msg}`); -} - -function main() { - const governanceDirCandidates = [ - path.join(ROOT, "docs", "docs", "evaluation", "governance"), - path.join(ROOT, "docs", "docs", "12-governance"), - ]; - const governanceDir = governanceDirCandidates.find((dir) => fs.existsSync(dir)); - if (!governanceDir) { - fail(`Missing docs governance directory. Tried: ${governanceDirCandidates.join(", ")}`); - } - - const files = listFiles(governanceDir, [".md", ".mdx"]); - if (files.length === 0) { - fail(`No governance docs found under: ${governanceDir}`); - } - - const manualFooterHits = []; - - for (const f of files) { - const text = readText(f); - const { body } = parseFrontmatter(text); - - // Heuristic: forbid manual copyright/license footers in governance docs - const suspicious = - /©\s*\d{4}/.test(text) || - /Licensed under the Apache License/i.test(text) || - /Jearon Wong/i.test(text); - - if (suspicious) { - manualFooterHits.push(f); - } - - // Also catch explicit "footer blocks" patterns if you use them. - if (/^---\s*$/m.test(body) && /©/m.test(body)) { - manualFooterHits.push(f); - } - } - - if (manualFooterHits.length) { - console.error("\n[FAIL] Manual copyright/license footer content found in governance docs."); - console.error("Governance docs must not embed manual footers; rely on global site footer."); - for (const f of Array.from(new Set(manualFooterHits))) { - console.error(" -", path.relative(ROOT, f)); - } - process.exit(1); - } - - pass(`Governance docs verified against current docs IA. Files checked: ${files.length}`); -} - -main(); diff --git a/scripts/04-build/pre-release-check.mjs b/scripts/04-build/pre-release-check.mjs deleted file mode 100644 index f54265392..000000000 --- a/scripts/04-build/pre-release-check.mjs +++ /dev/null @@ -1,154 +0,0 @@ -#!/usr/bin/env node -import { spawn } from "node:child_process"; -import path from "node:path"; -import fs from "node:fs"; - -const ROOT = process.cwd(); - -function runNode(scriptRelPath, args = []) { - const scriptPath = path.resolve(ROOT, scriptRelPath); - if (!fs.existsSync(scriptPath)) { - return Promise.resolve({ - ok: false, - name: scriptRelPath, - code: 1, - output: `Missing script: ${scriptRelPath}`, - }); - } - - return new Promise((resolve) => { - const p = spawn(process.execPath, [scriptPath, ...args], { - stdio: ["ignore", "pipe", "pipe"], - env: process.env, - }); - - let out = ""; - p.stdout.on("data", (d) => (out += d.toString())); - p.stderr.on("data", (d) => (out += d.toString())); - - p.on("close", (code) => { - resolve({ - ok: code === 0, - name: scriptRelPath, - code: code ?? 1, - output: out.trim(), - }); - }); - }); -} - -function runGitStatus(repoRelPath = ".") { - const repoPath = path.resolve(ROOT, repoRelPath); - - return new Promise((resolve) => { - const p = spawn("git", ["-C", repoPath, "status", "--short", "--untracked-files=all"], { - stdio: ["ignore", "pipe", "pipe"], - env: process.env, - }); - - let out = ""; - p.stdout.on("data", (d) => (out += d.toString())); - p.stderr.on("data", (d) => (out += d.toString())); - - p.on("close", () => resolve(out.trim())); - }); -} - -async function snapshotWorktrees() { - return { - root: await runGitStatus("."), - website: await runGitStatus("MPLP_website"), - lab: await runGitStatus("Validation_Lab"), - }; -} - -function diffSnapshots(before, after) { - const diffs = []; - for (const scope of ["root", "website", "lab"]) { - if (before[scope] !== after[scope]) { - diffs.push({ - scope, - before: before[scope] || "(clean)", - after: after[scope] || "(clean)", - }); - } - } - return diffs; -} - -function printHeader() { - console.log("============================================================"); - console.log("MPLP Pre-Release Check Suite"); - console.log("Authority: scripts/pre-release-check.mjs"); - console.log("Mode:", process.env.CI ? "CI" : "LOCAL"); - console.log("============================================================"); -} - -function printResult(r) { - const status = r.ok ? "PASS" : "FAIL"; - console.log(`\n[${status}] ${r.name}`); - if (r.output) console.log(r.output); -} - -async function main() { - printHeader(); - - // Order is intentional: governance invariants → semantics → mappings → UI rules - const checks = [ - ["scripts/04-build/update-frozen-headers.mjs", ["--check"]], - "scripts/03-docs/semantic/semantic-lint.mjs", - "scripts/03-docs/semantic/mapping-health.mjs", - "scripts/03-docs/verify-governance-styling.mjs", - ]; - - const results = []; - const baselineSnapshot = await snapshotWorktrees(); - for (const check of checks) { - const [scriptRelPath, args] = Array.isArray(check) ? check : [check, []]; - const before = await snapshotWorktrees(); - const r = await runNode(scriptRelPath, args); - const after = await snapshotWorktrees(); - const drift = diffSnapshots(before, after); - - if (drift.length > 0) { - r.ok = false; - r.code = 1; - r.output = [ - r.output, - "", - "[FAIL] Verification must be non-mutating. This substep changed tracked worktree state.", - ...drift.map((d) => `Scope: ${d.scope}\nBEFORE:\n${d.before}\nAFTER:\n${d.after}`), - ].filter(Boolean).join("\n"); - } - - results.push(r); - printResult(r); - } - - const finalSnapshot = await snapshotWorktrees(); - const suiteDrift = diffSnapshots(baselineSnapshot, finalSnapshot); - - const failed = results.filter((r) => !r.ok); - console.log("\n============================================================"); - if (failed.length === 0 && suiteDrift.length === 0) { - console.log("FINAL VERDICT: PASS — Release eligible."); - console.log("============================================================\n"); - process.exit(0); - } else { - console.log(`FINAL VERDICT: FAIL — ${failed.length + (suiteDrift.length > 0 ? 1 : 0)} check(s) failed.`); - if (suiteDrift.length > 0) { - console.log("Verification suite dirtied tracked worktree state:"); - for (const d of suiteDrift) { - console.log(`- ${d.scope}`); - } - } - console.log("Release is blocked until failures are remediated."); - console.log("============================================================\n"); - process.exit(1); - } -} - -main().catch((e) => { - console.error("\n[FATAL] pre-release-check crashed:", e); - process.exit(1); -}); diff --git a/scripts/04-build/root-verification.mjs b/scripts/04-build/root-verification.mjs deleted file mode 100644 index 04a58cbcf..000000000 --- a/scripts/04-build/root-verification.mjs +++ /dev/null @@ -1,164 +0,0 @@ -#!/usr/bin/env node -import fs from "node:fs"; -import path from "node:path"; - -const ROOT = process.cwd(); -const mode = process.argv.includes("--lint") ? "lint" : "test"; - -const requiredPaths = [ - "schemas/v2/mplp-context.schema.json", - "schemas/v2/mplp-plan.schema.json", - "schemas/v2/mplp-confirm.schema.json", - "schemas/v2/mplp-trace.schema.json", - "tests/schema-alignment/ts-schema-alignment.test.ts", - "tests/runtime-compat/ts-runtime-to-ts-sdk.test.ts", - "tests/cross-language/builders/ts-builders.test.ts", - "governance/backlog/MPLP-CANDIDATE-BACKLOG-INDEX-v0.1.md", - "governance/mpgc-intake/MPLP-MPGC-CANDIDATE-INTAKE-INDEX-v0.1.md", -]; - -const jsonRoots = [ - "package.json", - "RELEASE_MANIFEST.json", - "governance/05-versioning/version-taxonomy-manifest.json", - "governance/05-specialized/entity.json", - "schemas/v2", -]; - -const schemaForbiddenTerms = [ - "SoloCrew", - "solocrew", - "Founder", - "founder", - "Secretary", - "secretary", - "Portfolio", - "portfolio", - "Cognitive_OS", - "Coregentis Cognitive OS", - "runtime-private", - "runtime_private", - "product projection", - "projection consumer", -]; - -const failures = []; - -function toAbs(relPath) { - return path.join(ROOT, relPath); -} - -function walkFiles(relPath, predicate = () => true) { - const absPath = toAbs(relPath); - if (!fs.existsSync(absPath)) return []; - - const files = []; - const stack = [absPath]; - while (stack.length > 0) { - const current = stack.pop(); - const stat = fs.statSync(current); - if (stat.isDirectory()) { - for (const entry of fs.readdirSync(current)) { - stack.push(path.join(current, entry)); - } - } else if (predicate(current)) { - files.push(current); - } - } - return files.sort(); -} - -function fail(message) { - failures.push(message); -} - -function assertExists(relPath) { - if (!fs.existsSync(toAbs(relPath))) { - fail(`Missing required path: ${relPath}`); - } -} - -function parseJsonFile(absPath) { - try { - JSON.parse(fs.readFileSync(absPath, "utf8")); - } catch (error) { - fail(`Invalid JSON: ${path.relative(ROOT, absPath)} (${error.message})`); - } -} - -function verifyJsonReadable() { - for (const relPath of jsonRoots) { - const absPath = toAbs(relPath); - if (!fs.existsSync(absPath)) { - fail(`Missing JSON root: ${relPath}`); - continue; - } - - const stat = fs.statSync(absPath); - if (stat.isDirectory()) { - for (const file of walkFiles(relPath, (candidate) => candidate.endsWith(".json"))) { - parseJsonFile(file); - } - } else { - parseJsonFile(absPath); - } - } -} - -function verifyRootScripts() { - const packageJsonPath = toAbs("package.json"); - const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8")); - for (const scriptName of ["test", "lint"]) { - const script = packageJson.scripts?.[scriptName] ?? ""; - if (!script || /No root (tests|linting) configured/.test(script)) { - fail(`Root npm script is not a real verification entry: ${scriptName}`); - } - } -} - -function verifySchemaBoundaryTerms() { - for (const file of walkFiles("schemas/v2", (candidate) => candidate.endsWith(".json") || candidate.endsWith(".yaml"))) { - const relPath = path.relative(ROOT, file); - const content = fs.readFileSync(file, "utf8"); - for (const term of schemaForbiddenTerms) { - if (content.includes(term)) { - fail(`Forbidden downstream/runtime term in protocol schema surface: ${relPath} -> ${term}`); - } - } - } -} - -function verifyTestInventory() { - const testFiles = walkFiles("tests", (candidate) => candidate.endsWith(".test.ts") || candidate.endsWith(".test.js")); - if (testFiles.length === 0) { - fail("No repository test files found under tests/"); - } -} - -function printHeader() { - console.log("============================================================"); - console.log(`MPLP Root ${mode === "lint" ? "Lint" : "Test"} Verification`); - console.log("Scope: root verification entry only; no protocol/schema mutation"); - console.log("============================================================"); -} - -function main() { - printHeader(); - - for (const relPath of requiredPaths) assertExists(relPath); - verifyJsonReadable(); - verifyRootScripts(); - verifySchemaBoundaryTerms(); - verifyTestInventory(); - - if (failures.length > 0) { - console.error("\nFINAL VERDICT: FAIL"); - for (const failure of failures) console.error(`- ${failure}`); - process.exit(1); - } - - console.log("\nFINAL VERDICT: PASS"); - console.log("Root verification entry is wired and protocol schema surfaces remain vendor-neutral."); -} - -main(); diff --git a/scripts/04-build/update-frozen-headers.mjs b/scripts/04-build/update-frozen-headers.mjs deleted file mode 100644 index 444d50d71..000000000 --- a/scripts/04-build/update-frozen-headers.mjs +++ /dev/null @@ -1,288 +0,0 @@ -import fs from "fs"; -import path from "path"; - -const CHECK_MODE = process.argv.includes("--check"); -const WOULD_CHANGE = []; - -// ------------------------------------------------------------ -// MPLP v1.0.x File-Level Governance Standards -// ------------------------------------------------------------ - -const FROZEN_MD_BLOCK = `> [!FROZEN] -> **MPLP Protocol v1.0.0 — Frozen Specification** -> **Freeze Date**: 2025-12-03 -> **Status**: FROZEN (no breaking changes permitted) -> **Governance**: MPLP Protocol Governance Committee (MPGC) -> **License**: Apache-2.0 -> **Note**: Any normative change requires a new protocol version.`; - -const COPYRIGHT_FOOTER = ` ---- - -© 2026 Jearon Wong -Licensed under the Apache License, Version 2.0.`; - -const SOURCE_HEADER = `/** - * © 2026 Jearon Wong - * Licensed under the Apache License, Version 2.0. - * - * This file is part of the MPLP reference implementation. - * It is NOT part of the frozen protocol specification. - */`; - -const YAML_HEADER = `# MPLP v1.0.0 FROZEN – Invariant Set -# © 2026 Jearon Wong – Apache-2.0 -# Governance: MPLP Protocol Governance Committee (MPGC)`; - -const JSON_COMMENT = "MPLP v1.0.0 FROZEN – © 2026 Jearon Wong – Apache-2.0 – Governance: MPGC"; - -const JSON_META_BASE = { - "protocolVersion": "1.0.0", - "frozen": true, - "freezeDate": "2025-12-03", - "governance": "MPGC" -}; - -// ------------------------------------------------------------ -// Utility -// ------------------------------------------------------------ - -function read(f) { return fs.readFileSync(f, 'utf8'); } -function write(f, c) { - const current = fs.existsSync(f) ? fs.readFileSync(f, "utf8") : ""; - if (current === c) return; - - if (CHECK_MODE) { - WOULD_CHANGE.push(f); - return; - } - - fs.writeFileSync(f, c, 'utf8'); - console.log('Updated:', f); -} - -// ------------------------------------------------------------ -// Processors -// ------------------------------------------------------------ - -function processMarkdown(filePath) { - let content = read(filePath); - - // Determine file type - // Normative: docs/00 to docs/07 - const isNormative = /docs[\\/]0[0-7]-/.test(filePath); - - // Governance & Root: README, CHANGELOG, Governance docs, or anything in 12-governance - const isGovernance = /CODE_OF_CONDUCT|CONTRIBUTING|SECURITY|GOVERNANCE|MAINTAINERS|12-governance/.test(filePath); - const isRoot = /README\.md|CHANGELOG\.md|LICENSE\.txt/.test(filePath); - - // Other Docs: docs/08+, docs/99 - const isOtherDocs = /docs[\\/](0[8-9]|1[0-9]|99)-/.test(filePath); - - // 1. Remove OLD Frozen Headers (YAML style) - content = content.replace(/^---[\r\n]+MPLP Protocol: v1.0.0[\s\S]*?---[\r\n]+/, ''); - - // 2a. Remove Manual Markdown Headers (bold text style) - content = content.replace(/^---[\r\n]+\*\*MPLP Protocol 1\.0\.0 — Frozen Specification\*\*[\s\S]*?requires a new protocol version\.\*\*[\r\n]+/, ''); - content = content.replace(/^\*\*MPLP Protocol 1\.0\.0 — Frozen Specification\*\*[\s\S]*?requires a new protocol version\.\*\*[\r\n]+/, ''); - - // 2b. Remove ALL NEW Frozen Headers (Blockquote style) - IMPROVED: uses loop to remove ALL duplicates - const frozenHeaderRegex = /> \[!FROZEN\][\s\S]*?> \*\*Note\*\*:.*?new protocol version\.[\r\n]*/g; - let prevContent; - do { - prevContent = content; - content = content.replace(frozenHeaderRegex, ''); - } while (content !== prevContent); - - // 3. Remove ALL Existing Footers - IMPROVED: uses loop to remove ALL duplicates - const footerRegex = /([\r\n]+---)?[\r\n]+(©|©|Copyright)?\s*2025 (邦士（北京）网络科技有限公司|Jearon Wong)[\s\S]*?Version 2\.0\.[\r\n]*/g; - do { - prevContent = content; - content = content.replace(footerRegex, ''); - } while (content !== prevContent); - - // Clean up excessive leading/trailing newlines - content = content.replace(/^[\r\n]+/, ''); - content = content.trimEnd(); - - // 4. Apply Frozen Header (ONLY for Normative) - // 4. Apply Frozen Header (ONLY for Normative) - if (isNormative) { - // Regex to match frontmatter, allowing for optional BOM (\uFEFF) and leading whitespace - const frontmatterRegex = /^[\uFEFF\s]*---[\r\n]+[\s\S]*?---[\r\n]+/; - const match = content.match(frontmatterRegex); - - if (match) { - // Insert AFTER frontmatter - const frontmatter = match[0]; - const body = content.substring(frontmatter.length); - content = frontmatter.trimEnd() + "\n\n" + FROZEN_MD_BLOCK + "\n\n" + body.trimStart(); - } else { - // No frontmatter, prepend (handling potential BOM) - content = content.replace(/^[\uFEFF\s]*/, ''); // Remove BOM/space if prepending - content = FROZEN_MD_BLOCK + "\n\n" + content; - } - } - - // 6. Inject wrapperClassName for Governance pages - if (isGovernance) { - const frontmatterRegex = /^[\uFEFF\s]*---[\r\n]+[\s\S]*?---[\r\n]+/; - const match = content.match(frontmatterRegex); - if (match) { - let frontmatter = match[0]; - if (!frontmatter.includes('wrapperClassName:')) { - // Inject wrapperClassName - frontmatter = frontmatter.replace(/---\s*$/, 'wrapperClassName: governance-page\n---\n'); - content = content.replace(frontmatterRegex, frontmatter); - } - } else { - // No frontmatter, create it - content = "---\nwrapperClassName: governance-page\n---\n\n" + content; - } - } - - // 5. Apply Footer (DISABLED per user request - footer exists in site layout) - // if (isNormative || isGovernance || isRoot || isOtherDocs) { - // content = content + COPYRIGHT_FOOTER + "\n"; - // } - - write(filePath, content); -} - -function processJsonSchema(filePath) { - // Only for schemas/v2 - if (!filePath.includes('schemas/v2') && !filePath.includes('schemas\\v2')) return; - - const content = read(filePath); - try { - const json = JSON.parse(content); - - // 1. Set $comment (Single line) - json.$comment = JSON_COMMENT; - - // 2. Set x-mplp-meta - json['x-mplp-meta'] = { ...JSON_META_BASE }; - - write(filePath, JSON.stringify(json, null, 2) + "\n"); - } catch (e) { - console.error('JSON Error:', filePath, e); - } -} - -function processYaml(filePath) { - // Only for schemas/invariants - if (!filePath.includes('schemas/invariants') && !filePath.includes('schemas\\invariants')) return; - - let content = read(filePath); - - // Strip old headers - content = content.replace(/^# MPLP Protocol v1.0.0[\s\S]*?version\.[\r\n]*/m, ''); - content = content.replace(/^# MPLP v1.0.0 FROZEN[\s\S]*?\(MPGC\)[\r\n]*/m, ''); - - // Add new header - content = YAML_HEADER + "\n\n" + content.trimStart(); - write(filePath, content); -} - -function processSource(filePath) { - // Only for packages/*/src - if (!/packages[\\/].*[\\/]src[\\/]/.test(filePath)) return; - - let content = read(filePath); - - // Preserve Shebang - const shebangMatch = content.match(/^#!.*\n/); - const shebang = shebangMatch ? shebangMatch[0] : ''; - if (shebang) content = content.replace(shebang, ''); - - // Strip old headers (Block comment style) - content = content.replace(/^\/\*\*[\s\S]*?MPLP Protocol v1.0.0[\s\S]*?\*\/\s*/, ''); - content = content.replace(/^\/\*\*[\s\S]*?© 2025 邦士[\s\S]*?\*\/\s*/, ''); - - // Add new header - content = SOURCE_HEADER + "\n" + content.trimStart(); - - // Restore Shebang - if (shebang) content = shebang + content; - - write(filePath, content); -} - -function processPackageJson(filePath) { - // Only for packages/*/package.json - if (!/packages[\\/].*[\\/]package\.json/.test(filePath)) return; - - try { - const json = JSON.parse(read(filePath)); - - // Remove Frozen Head ($comment) if present - if (json.$comment) delete json.$comment; - - // Standard Fields - json.author = "Jearon Wong"; - json.copyright = "© 2026 Jearon Wong"; - if (!json.license) json.license = "Apache-2.0"; - - // Custom MPLP Meta - json.mplp = { - protocolVersion: "1.0.0", - frozen: true, - governance: "MPGC" - }; - - // Infer Layer - if (json.name.includes('core')) json.mplp.layer = 'L1'; - else if (json.name.includes('modules') || json.name.includes('coordination')) json.mplp.layer = 'L2'; - else if (json.name.includes('runtime')) json.mplp.layer = 'L3'; - else if (json.name.includes('integration')) json.mplp.layer = 'L4'; - else if (json.name.includes('devtools') || json.name.includes('sdk')) json.mplp.layer = 'Tools'; - - write(filePath, JSON.stringify(json, null, 2) + "\n"); - } catch (e) { - console.error('Pkg JSON Error:', filePath, e); - } -} - -// ------------------------------------------------------------ -// Walker -// ------------------------------------------------------------ - -function walk(dir) { - if (dir.includes('node_modules') || dir.includes('.git') || dir.includes('dist')) return; - - const items = fs.readdirSync(dir, { withFileTypes: true }); - - for (const item of items) { - const full = path.join(dir, item.name); - - if (item.isDirectory()) { - walk(full); - } else { - // Skip this script - if (full.endsWith('update-frozen-headers.mjs')) continue; - - if (full.endsWith('.md')) processMarkdown(full); - else if (full.endsWith('.schema.json')) processJsonSchema(full); - else if (full.endsWith('.yaml') || full.endsWith('.yml')) processYaml(full); - else if (full.endsWith('.ts') || full.endsWith('.js')) processSource(full); - else if (item.name === 'package.json') processPackageJson(full); - } - } -} - -console.log(`Starting MPLP v1.0.x Governance Header ${CHECK_MODE ? "Check" : "Update"}...`); -walk(process.cwd()); - -if (CHECK_MODE) { - if (WOULD_CHANGE.length > 0) { - console.warn("Header drift detected. Files that would change:"); - for (const file of WOULD_CHANGE) { - console.warn(` - ${file}`); - } - } - - console.log("Governance Header Check Complete. No changes required."); - process.exit(0); -} - -console.log("Governance Header Update Complete."); diff --git a/scripts/codex/repo-truth-first.sh b/scripts/codex/repo-truth-first.sh deleted file mode 100755 index 978795cbe..000000000 --- a/scripts/codex/repo-truth-first.sh +++ /dev/null @@ -1,63 +0,0 @@ -#!/usr/bin/env bash -set -euo pipefail - -echo "== Repo Truth First ==" -echo - -echo "[branch]" -git branch --show-current || true -echo - -echo "[status]" -git status --short || true -echo - -echo "[local HEAD]" -git rev-parse HEAD || true -echo - -echo "[origin/main HEAD]" -git rev-parse --verify origin/main 2>/dev/null || echo "origin/main unavailable" -echo - -echo "[origin/codex/latest-ops-foundation-wave-01 HEAD]" -git rev-parse --verify origin/codex/latest-ops-foundation-wave-01 2>/dev/null || echo "origin/codex/latest-ops-foundation-wave-01 unavailable" -echo - -echo "[recent commits]" -git log --oneline -5 || true -echo - -echo "[AGENTS.md bytes]" -if [ -f AGENTS.md ]; then - wc -c AGENTS.md -else - echo "AGENTS.md missing" -fi -echo - -echo "[skill mirror drift]" -if [ -d .codex/skills ] && [ -d .agents/skills ]; then - if diff -qr .codex/skills .agents/skills; then - echo "SKILL_MIRROR_DRIFT=NO" - else - echo "SKILL_MIRROR_DRIFT=YES" - fi -else - echo "SKILL_MIRROR_DRIFT=NOT_APPLICABLE" -fi -echo - -echo "[top-level files]" -find . -maxdepth 2 \ - -not -path './.git/*' \ - -not -path './node_modules/*' \ - -not -path './.next/*' \ - -not -path './dist/*' \ - -type f | sort | head -200 -echo - -echo "[package scripts if package.json exists]" -if [ -f package.json ]; then - node -e "const p=require('./package.json'); console.log(JSON.stringify(p.scripts||{}, null, 2))" -fi diff --git a/scripts/packages/validate-public-npm-package.mjs b/scripts/packages/validate-public-npm-package.mjs deleted file mode 100644 index fad2a944f..000000000 --- a/scripts/packages/validate-public-npm-package.mjs +++ /dev/null @@ -1,279 +0,0 @@ -#!/usr/bin/env node -import fs from "node:fs"; -import path from "node:path"; - -const args = new Map(); -for (let i = 2; i < process.argv.length; i += 2) { - if (!process.argv[i]?.startsWith("--")) { - throw new Error(`Unexpected argument: ${process.argv[i]}`); - } - args.set(process.argv[i].slice(2), process.argv[i + 1]); -} - -const model = args.get("model"); -const allowedModels = new Set(["wrapper_package", "schema_data_package"]); - -if (!allowedModels.has(model)) { - throw new Error(`Unsupported package build model: ${model}`); -} - -const packageDir = process.cwd(); -const packageJsonPath = path.join(packageDir, "package.json"); -const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8")); -const packageName = packageJson.name ?? path.basename(packageDir); -const failures = []; -const notes = []; - -function fail(message) { - failures.push(message); -} - -function note(message) { - notes.push(message); -} - -function hasFile(relativePath) { - return fs.existsSync(path.join(packageDir, relativePath)); -} - -function readIfExists(relativePath) { - const absolutePath = path.join(packageDir, relativePath); - return fs.existsSync(absolutePath) ? fs.readFileSync(absolutePath, "utf8") : ""; -} - -function listFilesRecursive(relativePath) { - const absolutePath = path.join(packageDir, relativePath); - if (!fs.existsSync(absolutePath)) { - return []; - } - - const output = []; - const stack = [absolutePath]; - - while (stack.length > 0) { - const current = stack.pop(); - const stat = fs.statSync(current); - if (stat.isDirectory()) { - for (const entry of fs.readdirSync(current)) { - stack.push(path.join(current, entry)); - } - } else { - output.push(path.relative(packageDir, current)); - } - } - - return output.sort(); -} - -function normalizePackageTarget(target) { - return target.startsWith("./") ? target.slice(2) : target; -} - -function validateTargetPath(label, target) { - if (typeof target !== "string") { - return; - } - - const normalizedTarget = normalizePackageTarget(target); - if (normalizedTarget.includes("*")) { - const wildcardPrefix = normalizedTarget.slice(0, normalizedTarget.indexOf("*")); - const directoryPrefix = wildcardPrefix.endsWith("/") - ? wildcardPrefix.slice(0, -1) - : path.dirname(wildcardPrefix); - - if (!hasFile(directoryPrefix)) { - fail(`${label} pattern target ${target} requires missing package path: ${directoryPrefix}`); - } - return; - } - - if (!hasFile(normalizedTarget)) { - fail(`${label} target ${target} is missing from package artifact surface`); - } -} - -function validateExportsTarget(exportKey, target) { - if (typeof target === "string") { - validateTargetPath(`exports.${exportKey}`, target); - return; - } - - if (target && typeof target === "object") { - for (const [condition, conditionTarget] of Object.entries(target)) { - validateTargetPath(`exports.${exportKey}.${condition}`, conditionTarget); - } - } -} - -function validateDeclaredEntrypoints() { - if (packageJson.main) { - validateTargetPath("main", packageJson.main); - } - - if (packageJson.types) { - validateTargetPath("types", packageJson.types); - } - - if (packageJson.exports && typeof packageJson.exports === "object") { - for (const [exportKey, target] of Object.entries(packageJson.exports)) { - validateExportsTarget(exportKey, target); - } - } -} - -function validateCoreMetadata() { - if (!packageName.startsWith("@mplp/")) { - fail("package name must be under @mplp scope"); - } - - if (packageJson.private === true) { - fail("public package target must not be private"); - } - - if (!packageJson.version) { - fail("package version is required"); - } - - if (packageJson.license !== "Apache-2.0") { - fail("package license must be Apache-2.0"); - } - - if (packageJson.author !== "Jearon Wong") { - fail("public package author must be Jearon Wong"); - } - - const repositoryUrl = - typeof packageJson.repository === "string" - ? packageJson.repository - : packageJson.repository?.url; - - if (!repositoryUrl?.includes("Coregentis/MPLP-Protocol")) { - fail("repository URL must remain Coregentis/MPLP-Protocol"); - } - - if (repositoryUrl?.includes("Multi-Agent-Lifecycle-Protocol")) { - fail("future org must not be used as current package repository URL"); - } - - const requiredFiles = ["package.json", "README.md", "DERIVATION_PROOF.yaml"]; - for (const requiredFile of requiredFiles) { - if (!hasFile(requiredFile)) { - fail(`missing required package artifact: ${requiredFile}`); - } - } - - if (!hasFile("LICENSE") && !hasFile("LICENSE.txt")) { - fail("missing LICENSE or LICENSE.txt"); - } - - const metadataText = [ - JSON.stringify(packageJson, null, 2), - readIfExists("README.md"), - readIfExists("DERIVATION_PROOF.yaml"), - ].join("\n"); - - if (/Bangshi|Beijing Network Technology|Bangshi Beijing/.test(metadataText)) { - fail("active package metadata must not contain Bangshi/Beijing identity"); - } - - if (/Multi-Agent-Lifecycle-Protocol/.test(metadataText)) { - fail("active package metadata must not use future org as current package URL"); - } - - if ( - /mplp-certified|certified by mplp|MPLP-certified|Certified by MPLP|endorsed|endorsement|regulator approval|approved by regulator|officially approved/i.test( - metadataText, - ) - ) { - fail("active package metadata must not contain certification, endorsement, or regulator approval overclaim"); - } - - const mplp = packageJson.mplp ?? {}; - if (mplp.protocolVersion !== "1.0.0") { - fail("mplp.protocolVersion must remain 1.0.0"); - } - - if (mplp.packageClass !== "PUBLIC") { - fail("mplp.packageClass must be PUBLIC"); - } - - if (mplp.publishSurface !== true) { - fail("mplp.publishSurface must be true"); - } -} - -function validateSchemaDataPackage() { - if (!hasFile("schemas")) { - fail("schema/data package must include schemas/"); - return; - } - - const schemaFiles = listFilesRecursive("schemas").filter( - (file) => file.endsWith(".json") || file.endsWith(".schema.json"), - ); - - if (schemaFiles.length === 0) { - fail("schema/data package must include JSON schema/data files"); - } - - for (const schemaFile of schemaFiles) { - try { - JSON.parse(readIfExists(schemaFile)); - } catch (error) { - fail(`invalid JSON schema/data file ${schemaFile}: ${error.message}`); - } - } - - const requiredSchemaDataAssets = [ - "schemas/kernel-duties.json", - "schemas/taxonomy/event-taxonomy.yaml", - "schemas/taxonomy/integration-event-taxonomy.yaml", - "schemas/taxonomy/learning-taxonomy.yaml", - "schemas/taxonomy/module-event-matrix.yaml", - "schemas/profiles/map-profile.yaml", - "schemas/profiles/sa-profile.yaml", - ]; - - for (const requiredAsset of requiredSchemaDataAssets) { - if (!hasFile(requiredAsset)) { - fail(`schema/data package must include required public asset: ${requiredAsset}`); - } - } - - if (packageJson.exports?.["./schemas/*"] !== "./schemas/*") { - fail("schema/data package must expose ./schemas/* for file-based asset consumers"); - } -} - -function validateWrapperPackage() { - if (hasFile("src")) { - note("src/ exists but build model is wrapper_package; this build validates package contract only"); - } - - if (hasFile("dist")) { - note("dist/ exists and is treated as pre-existing package artifact"); - } -} - -validateCoreMetadata(); -validateDeclaredEntrypoints(); - -if (model === "schema_data_package") { - validateSchemaDataPackage(); -} else { - validateWrapperPackage(); -} - -if (failures.length > 0) { - console.error(`Package build contract validation failed for ${packageName}:`); - for (const failure of failures) { - console.error(`- ${failure}`); - } - process.exit(1); -} - -console.log(`Package build contract validation passed for ${packageName}`); -console.log(`model=${model}`); -for (const modelNote of notes) { - console.log(`note=${modelNote}`); -} diff --git a/scripts/semantic/gate-publish-set.mjs b/scripts/semantic/gate-publish-set.mjs deleted file mode 100644 index cfce9e5e4..000000000 --- a/scripts/semantic/gate-publish-set.mjs +++ /dev/null @@ -1,189 +0,0 @@ -/** - * Gate: Verify Publish Set contains only PUBLIC packages - * - * This script is a MANDATORY gate before any npm publish. - * It produces evidence artifacts for the release chain. - * - * Reference: METHOD-SDKR-08 Section 6.4 - * - * Usage: - * node scripts/semantic/gate-publish-set.mjs - * - * Output: - * artifacts/release/publish-set.json - * artifacts/release/publish-gate-report.json - * - * Exit codes: - * 0 = PASS (all packages in publish set are PUBLIC) - * 1 = FAIL (blocked packages found in publish flow) - * - * © 2026 Jearon Wong - * Licensed under the Apache License, Version 2.0. - */ - -import { readFileSync, readdirSync, writeFileSync, mkdirSync, existsSync } from 'fs'; -import { join, dirname } from 'path'; -import { fileURLToPath } from 'url'; - -const __filename = fileURLToPath(import.meta.url); -const __dirname = dirname(__filename); -const ROOT_DIR = join(__dirname, '..', '..'); - -const PACKAGES_DIR = join(ROOT_DIR, 'packages', 'npm'); -const OUTPUT_DIR = join(ROOT_DIR, 'artifacts', 'release'); - -/** - * Read and parse package.json for a package - */ -function readPackageJson(pkgDir) { - const pkgJsonPath = join(pkgDir, 'package.json'); - if (!existsSync(pkgJsonPath)) { - return null; - } - return JSON.parse(readFileSync(pkgJsonPath, 'utf8')); -} - -/** - * Determine if a package is blocked from publishing - */ -function isBlocked(pkgJson) { - return { - isPrivate: pkgJson.private === true, - isCiOnly: pkgJson.mplp?.ci_only === true, - isPublishBlocked: pkgJson.mplp?.publishBlocked === true - }; -} - -/** - * Main gate function - */ -function gatePublishSet() { - console.log('='.repeat(60)); - console.log('MPLP Publish Gate - METHOD-SDKR-08 Section 6.4'); - console.log('='.repeat(60)); - - if (!existsSync(PACKAGES_DIR)) { - console.error(`FATAL: Packages directory not found: ${PACKAGES_DIR}`); - process.exit(1); - } - - const packages = readdirSync(PACKAGES_DIR, { withFileTypes: true }) - .filter(d => d.isDirectory()) - .map(d => d.name); - - console.log(`\nScanning ${packages.length} packages in ${PACKAGES_DIR}...\n`); - - const publishSet = []; - const blocked = []; - const errors = []; - - for (const pkg of packages) { - const pkgDir = join(PACKAGES_DIR, pkg); - const pkgJson = readPackageJson(pkgDir); - - if (!pkgJson) { - errors.push({ package: pkg, error: 'No package.json found' }); - continue; - } - - const blockReasons = isBlocked(pkgJson); - const isBlockedPackage = blockReasons.isPrivate || blockReasons.isCiOnly || blockReasons.isPublishBlocked; - - if (isBlockedPackage) { - blocked.push({ - name: pkgJson.name, - version: pkgJson.version, - path: pkg, - reason: blockReasons - }); - console.log(` [BLOCKED] ${pkgJson.name} - ${JSON.stringify(blockReasons)}`); - } else { - publishSet.push({ - name: pkgJson.name, - version: pkgJson.version, - path: pkg - }); - console.log(` [PUBLIC] ${pkgJson.name}@${pkgJson.version}`); - } - } - - // Check for violations: if --check-specific is passed, verify those packages - const specificPackages = process.argv.slice(2).filter(arg => !arg.startsWith('--')); - const violations = []; - - if (specificPackages.length > 0) { - for (const specified of specificPackages) { - const blockedMatch = blocked.find(b => b.name === specified || b.path === specified); - if (blockedMatch) { - violations.push(blockedMatch); - } - } - } - - // Create output directory - mkdirSync(OUTPUT_DIR, { recursive: true }); - - // Generate report - const report = { - timestamp: new Date().toISOString(), - gate: 'METHOD-SDKR-08-6.4', - summary: { - totalPackages: packages.length, - publishableCount: publishSet.length, - blockedCount: blocked.length, - errorCount: errors.length, - violationCount: violations.length - }, - publishSet: publishSet.map(p => ({ name: p.name, version: p.version })), - blocked: blocked.map(b => ({ name: b.name, reason: b.reason })), - violations, - errors, - status: violations.length === 0 && errors.length === 0 ? 'PASS' : 'FAIL' - }; - - // Write outputs - writeFileSync( - join(OUTPUT_DIR, 'publish-gate-report.json'), - JSON.stringify(report, null, 2) - ); - writeFileSync( - join(OUTPUT_DIR, 'publish-set.json'), - JSON.stringify(publishSet, null, 2) - ); - - // Print summary - console.log('\n' + '='.repeat(60)); - console.log('GATE SUMMARY'); - console.log('='.repeat(60)); - console.log(` Total packages: ${packages.length}`); - console.log(` Publishable: ${publishSet.length}`); - console.log(` Blocked: ${blocked.length}`); - console.log(` Errors: ${errors.length}`); - console.log(` Violations: ${violations.length}`); - console.log(''); - console.log(` Output: ${OUTPUT_DIR}/`); - console.log(''); - - if (violations.length > 0) { - console.error('❌ GATE FAIL: Blocked packages in publish flow!'); - console.error(' Violations:', violations.map(v => v.name).join(', ')); - console.error(''); - console.error(' This gate is NOT waivable.'); - console.error(' See: METHOD-SDKR-08 Section 6.3'); - process.exit(1); - } - - if (errors.length > 0) { - console.error('❌ GATE FAIL: Errors during scan!'); - console.error(' Errors:', errors.map(e => `${e.package}: ${e.error}`).join('; ')); - process.exit(1); - } - - console.log('✅ GATE PASS: All packages in Publish Set are PUBLIC.'); - console.log(''); - console.log(' Publish Set:', publishSet.map(p => p.name).join(', ')); - process.exit(0); -} - -// Run -gatePublishSet(); diff --git a/scripts/semantic/gate_pypi_set/__init__.py b/scripts/semantic/gate_pypi_set/__init__.py deleted file mode 100644 index ca89d8732..000000000 --- a/scripts/semantic/gate_pypi_set/__init__.py +++ /dev/null @@ -1,14 +0,0 @@ -""" -MPLP PyPI Publish Gate - Reference Implementation - -Corresponds to METHOD-SDKR-08 §8.1.5 / §8.1.6 -Role: Release Governance Gate (PyPI) - -This is a NORMATIVE-ORIENTED implementation designed for: -- Direct compliance with METHOD-SDKR-08 -- Language-neutral portability (Go / Rust can replicate) -- Evidence chain completeness - -© 2026 Jearon Wong -Licensed under the Apache License, Version 2.0. -""" diff --git a/scripts/semantic/gate_pypi_set/checks.py b/scripts/semantic/gate_pypi_set/checks.py deleted file mode 100644 index eaca7df26..000000000 --- a/scripts/semantic/gate_pypi_set/checks.py +++ /dev/null @@ -1,156 +0,0 @@ -""" -Gate Checks for PyPI Publish Gate - -Each function implements one governance invariant from METHOD-SDKR-08 §8.1. -These are the HARD-FAIL conditions that cannot be waived. -""" - -from pathlib import Path -from typing import List, Optional -import hashlib - -from .model import PythonPackage, DistArtifacts, GateCheckResult - - -# ============================================================================= -# §8.1.2 Classification Check -# ============================================================================= - -def check_public_category(pkg: PythonPackage) -> GateCheckResult: - """ - Verify package is classified as PUBLIC. - INTERNAL and CI-ONLY packages MUST NOT be in Publish Set. - """ - if pkg.category == "PUBLIC": - return GateCheckResult( - id="CLASSIFICATION", - result="PASS", - message=f"{pkg.name} is PUBLIC" - ) - else: - return GateCheckResult( - id="CLASSIFICATION", - result="FAIL", - message=f"{pkg.name} has category '{pkg.category}', not PUBLIC" - ) - - -# ============================================================================= -# §8.1.3 Derivation Proof Check -# ============================================================================= - -def check_derivation_proof_exists(pkg_path: Path) -> GateCheckResult: - """ - Verify DERIVATION_PROOF.yaml exists in package directory. - """ - proof_path = pkg_path / "DERIVATION_PROOF.yaml" - - if proof_path.exists(): - return GateCheckResult( - id="DERIVATION_PROOF", - result="PASS", - message=f"Found {proof_path}" - ) - else: - return GateCheckResult( - id="DERIVATION_PROOF", - result="FAIL", - message=f"Missing DERIVATION_PROOF.yaml at {pkg_path}" - ) - - -# ============================================================================= -# §8.1.3 Distribution Artifacts Check -# ============================================================================= - -def check_dist_artifacts(dist_dir: Path) -> GateCheckResult: - """ - Verify both sdist (.tar.gz) and wheel (.whl) exist. - """ - if not dist_dir.exists(): - return GateCheckResult( - id="ARTIFACTS", - result="FAIL", - message=f"Distribution directory not found: {dist_dir}" - ) - - files = list(dist_dir.iterdir()) - has_wheel = any(f.suffix == ".whl" for f in files) - has_sdist = any(f.name.endswith(".tar.gz") for f in files) - - if has_wheel and has_sdist: - return GateCheckResult( - id="ARTIFACTS", - result="PASS", - message="Both wheel and sdist found" - ) - else: - missing = [] - if not has_wheel: - missing.append("wheel") - if not has_sdist: - missing.append("sdist") - return GateCheckResult( - id="ARTIFACTS", - result="FAIL", - message=f"Missing distribution artifacts: {', '.join(missing)}" - ) - - -# ============================================================================= -# §8.1.4 Version Synchronization Check -# ============================================================================= - -def check_version_sync(pkg_version: str, bundle_version: str) -> GateCheckResult: - """ - Verify package version matches Release Bundle version (major.minor). - """ - pkg_major_minor = ".".join(pkg_version.split(".")[:2]) - bundle_major_minor = ".".join(bundle_version.split(".")[:2]) - - if pkg_major_minor == bundle_major_minor: - return GateCheckResult( - id="VERSION_SYNC", - result="PASS", - message=f"Version {pkg_version} matches bundle {bundle_version}" - ) - else: - return GateCheckResult( - id="VERSION_SYNC", - result="FAIL", - message=f"Version mismatch: package={pkg_version}, bundle={bundle_version}" - ) - - -# ============================================================================= -# Hash Verification (for Evidence Chain) -# ============================================================================= - -def compute_file_sha256(file_path: Path) -> Optional[str]: - """Compute SHA256 hash of a file.""" - if not file_path.exists(): - return None - - sha256 = hashlib.sha256() - with open(file_path, "rb") as f: - for chunk in iter(lambda: f.read(8192), b""): - sha256.update(chunk) - return sha256.hexdigest() - - -def collect_dist_info(dist_dir: Path) -> DistArtifacts: - """Collect distribution artifact information including hashes.""" - artifacts = DistArtifacts() - - if not dist_dir.exists(): - return artifacts - - for f in dist_dir.iterdir(): - if f.suffix == ".whl": - artifacts.wheel_path = str(f) - artifacts.wheel_sha256 = compute_file_sha256(f) - elif f.name.endswith(".tar.gz"): - artifacts.sdist_path = str(f) - artifacts.sdist_sha256 = compute_file_sha256(f) - - return artifacts diff --git a/scripts/semantic/gate_pypi_set/loader.py b/scripts/semantic/gate_pypi_set/loader.py deleted file mode 100644 index 2b05eadad..000000000 --- a/scripts/semantic/gate_pypi_set/loader.py +++ /dev/null @@ -1,54 +0,0 @@ -""" -Fact Loaders for PyPI Publish Gate - -Responsible for reading and parsing configuration files. -Uses standard library where possible for maximum portability. -""" - -import json -from pathlib import Path -from typing import Dict, Any, Optional - -# Python 3.11+ has tomllib in stdlib -try: - import tomllib -except ImportError: - import tomli as tomllib # fallback for 3.10 - -try: - import yaml -except ImportError: - yaml = None # Will fail gracefully if YAML files need parsing - - -def load_pyproject(path: Path) -> Dict[str, Any]: - """Load and parse pyproject.toml.""" - with open(path, "rb") as f: - return tomllib.load(f) - - -def load_derivation_proof(path: Path) -> Optional[Dict[str, Any]]: - """Load DERIVATION_PROOF.yaml if it exists.""" - if not path.exists(): - return None - - if yaml is None: - raise RuntimeError("PyYAML is required to parse DERIVATION_PROOF.yaml") - - with open(path, "r", encoding="utf-8") as f: - return yaml.safe_load(f) - - -def load_bundle_manifest(path: Path) -> Optional[Dict[str, Any]]: - """Load RELEASE_BUNDLE_MANIFEST.json if it exists.""" - if not path.exists(): - return None - - return json.loads(path.read_text(encoding="utf-8")) - - -def load_json(path: Path) -> Optional[Dict[str, Any]]: - """Generic JSON loader.""" - if not path.exists(): - return None - return json.loads(path.read_text(encoding="utf-8")) diff --git a/scripts/semantic/gate_pypi_set/main.py b/scripts/semantic/gate_pypi_set/main.py deleted file mode 100644 index e852e2e40..000000000 --- a/scripts/semantic/gate_pypi_set/main.py +++ /dev/null @@ -1,223 +0,0 @@ -#!/usr/bin/env python3 -""" -MPLP PyPI Publish Gate - CLI Entry Point - -Reference Implementation for METHOD-SDKR-08 §8.1.5 / §8.1.6 - -Usage: - python -m gate_pypi_set - # or - python scripts/semantic/gate_pypi_set/main.py - -Exit Codes: - 0 = PASS (all packages in publish set are valid) - 1 = FAIL (violations found - release blocked) - -Output: - artifacts/release/pypi-set.json - artifacts/release/pypi-gate-report.json - -© 2026 Jearon Wong -Licensed under the Apache License, Version 2.0. -""" - -import sys -from datetime import datetime, timezone -from pathlib import Path - -from .model import PythonPackage, GateReport, GateCheckResult, PyPISet -from .loader import load_pyproject, load_bundle_manifest -from .checks import ( - check_public_category, - check_derivation_proof_exists, - check_dist_artifacts, - check_version_sync, -) -from .report import write_pypi_set, write_gate_report - - -# ============================================================================= -# Configuration -# ============================================================================= - -ROOT_DIR = Path(__file__).parent.parent.parent.parent # scripts/semantic/gate_pypi_set -> root -PYPI_PACKAGES_DIR = ROOT_DIR / "packages" / "pypi" -ARTIFACT_DIR = ROOT_DIR / "artifacts" / "release" -BUNDLE_MANIFEST_PATH = ARTIFACT_DIR / "RELEASE_BUNDLE_MANIFEST.json" - -GATE_NAME = "pypi-publish-gate" - - -# ============================================================================= -# Main Gate Logic -# ============================================================================= - -def discover_packages() -> list[PythonPackage]: - """ - Automatically discover Python packages in packages/pypi/. - Manual specification of publish targets is NOT permitted. - """ - packages = [] - - if not PYPI_PACKAGES_DIR.exists(): - print(f"Warning: {PYPI_PACKAGES_DIR} does not exist") - return packages - - for pkg_dir in PYPI_PACKAGES_DIR.iterdir(): - if not pkg_dir.is_dir(): - continue - - pyproject_path = pkg_dir / "pyproject.toml" - if not pyproject_path.exists(): - continue - - try: - pyproject = load_pyproject(pyproject_path) - project = pyproject.get("project", {}) - tool_mplp = pyproject.get("tool", {}).get("mplp", {}) - - # Determine category from tool.mplp or default to PUBLIC - # (Python packages without explicit category are assumed PUBLIC - # since private packages wouldn't be in packages/pypi/) - category = "PUBLIC" - if tool_mplp.get("ci_only"): - category = "CI-ONLY" - elif tool_mplp.get("internal"): - category = "INTERNAL" - - packages.append(PythonPackage( - name=project.get("name", pkg_dir.name), - version=project.get("version", "0.0.0"), - path=str(pkg_dir), - category=category - )) - except Exception as e: - print(f"Error loading {pyproject_path}: {e}") - - return packages - - -def run_gate() -> int: - """ - Execute the PyPI Publish Gate. - Returns exit code (0 = PASS, 1 = FAIL). - """ - print("=" * 60) - print("MPLP PyPI Publish Gate - METHOD-SDKR-08 §8.1.5") - print("=" * 60) - - checks: list[GateCheckResult] = [] - violations: list[str] = [] - - # 1. Load bundle manifest (if exists) - bundle_version = "1.0.0" # Default - bundle = load_bundle_manifest(BUNDLE_MANIFEST_PATH) - if bundle: - bundle_version = bundle.get("bundle_version", bundle_version) - print(f"\nBundle Version: {bundle_version}") - else: - print(f"\nWarning: Bundle manifest not found at {BUNDLE_MANIFEST_PATH}") - print("Using default version for validation") - - # 2. Discover packages (automatic - manual specification forbidden) - packages = discover_packages() - print(f"\nDiscovered {len(packages)} Python package(s):") - - # 3. Build Publish Set (filter to PUBLIC only) - publish_set = PyPISet() - - for pkg in packages: - print(f"\n Checking: {pkg.name} ({pkg.category})") - - pkg_path = Path(pkg.path) - dist_dir = pkg_path / "dist" - - # Check 1: Classification - classification_result = check_public_category(pkg) - checks.append(classification_result) - if classification_result.result == "FAIL": - violations.append(f"Classification: {pkg.name}") - print(f" [BLOCKED] {classification_result.message}") - continue - - # Only PUBLIC packages proceed to further checks - publish_set.packages.append(pkg) - - # Check 2: Derivation Proof - proof_result = check_derivation_proof_exists(pkg_path) - checks.append(proof_result) - if proof_result.result == "FAIL": - violations.append(f"Derivation Proof: {pkg.name}") - print(f" [FAIL] {proof_result.message}") - else: - print(f" [PASS] {proof_result.message}") - - # Check 3: Distribution Artifacts - dist_result = check_dist_artifacts(dist_dir) - checks.append(dist_result) - if dist_result.result == "FAIL": - violations.append(f"Artifacts: {pkg.name}") - print(f" [FAIL] {dist_result.message}") - else: - print(f" [PASS] {dist_result.message}") - - # Check 4: Version Sync - version_result = check_version_sync(pkg.version, bundle_version) - checks.append(version_result) - if version_result.result == "FAIL": - violations.append(f"Version Sync: {pkg.name}") - print(f" [FAIL] {version_result.message}") - else: - print(f" [PASS] {version_result.message}") - - # 4. Determine status - status = "PASS" if not violations else "FAIL" - - # 5. Generate report - report = GateReport( - gate=GATE_NAME, - timestamp=datetime.now(timezone.utc).isoformat(), - bundle_version=bundle_version, - status=status, - checks=checks, - violations=violations - ) - - # 6. Write artifacts - write_pypi_set(ARTIFACT_DIR, publish_set.to_dict()) - write_gate_report(ARTIFACT_DIR, report.to_dict()) - - # 7. Print summary - print("\n" + "=" * 60) - print("GATE SUMMARY") - print("=" * 60) - print(f" Total packages: {len(packages)}") - print(f" In Publish Set: {len(publish_set.packages)}") - print(f" Checks performed: {len(checks)}") - print(f" Violations: {len(violations)}") - print(f"") - print(f" Output: {ARTIFACT_DIR}/") - print("") - - if status == "FAIL": - print("❌ GATE FAIL: Violations detected!") - for v in violations: - print(f" - {v}") - print("") - print(" This gate is NOT waivable.") - print(" See: METHOD-SDKR-08 §8.1.5") - return 1 - - print("✅ GATE PASS: All packages in Publish Set are valid.") - print("") - print(f" Publish Set: {', '.join(p.name for p in publish_set.packages)}") - return 0 - - -def main(): - """CLI entry point.""" - sys.exit(run_gate()) - - -if __name__ == "__main__": - main() diff --git a/scripts/semantic/gate_pypi_set/model.py b/scripts/semantic/gate_pypi_set/model.py deleted file mode 100644 index 74937b1bd..000000000 --- a/scripts/semantic/gate_pypi_set/model.py +++ /dev/null @@ -1,89 +0,0 @@ -""" -Data Models for PyPI Publish Gate - -These models are NORMATIVE and designed for 1:1 translation to Go/Rust. -""" - -from dataclasses import dataclass, field, asdict -from typing import List, Optional, Dict, Any - - -@dataclass -class PythonPackage: - """Represents a Python package in the publish set.""" - name: str - version: str - path: str - category: str # PUBLIC / INTERNAL / CI-ONLY - - def to_dict(self) -> Dict[str, Any]: - return asdict(self) - - -@dataclass -class DistArtifacts: - """Python distribution artifacts (wheel + sdist).""" - sdist_path: Optional[str] = None - wheel_path: Optional[str] = None - sdist_sha256: Optional[str] = None - wheel_sha256: Optional[str] = None - - @property - def has_sdist(self) -> bool: - return self.sdist_path is not None - - @property - def has_wheel(self) -> bool: - return self.wheel_path is not None - - @property - def is_complete(self) -> bool: - return self.has_sdist and self.has_wheel - - -@dataclass -class GateCheckResult: - """Result of a single gate check.""" - id: str - result: str # PASS / FAIL - message: Optional[str] = None - - def to_dict(self) -> Dict[str, Any]: - d = {"id": self.id, "result": self.result} - if self.message: - d["message"] = self.message - return d - - -@dataclass -class GateReport: - """Complete gate verification report.""" - gate: str - timestamp: str - bundle_version: str - status: str # PASS / FAIL - checks: List[GateCheckResult] = field(default_factory=list) - violations: List[str] = field(default_factory=list) - - def to_dict(self) -> Dict[str, Any]: - return { - "gate": self.gate, - "timestamp": self.timestamp, - "bundleVersion": self.bundle_version, - "status": self.status, - "checks": [c.to_dict() for c in self.checks], - "violations": self.violations - } - - -@dataclass -class PyPISet: - """Python Publish Set - the computed set of packages to publish.""" - ecosystem: str = "pypi" - packages: List[PythonPackage] = field(default_factory=list) - - def to_dict(self) -> Dict[str, Any]: - return { - "ecosystem": self.ecosystem, - "packages": [p.to_dict() for p in self.packages] - } diff --git a/scripts/semantic/gate_pypi_set/report.py b/scripts/semantic/gate_pypi_set/report.py deleted file mode 100644 index 262ae4822..000000000 --- a/scripts/semantic/gate_pypi_set/report.py +++ /dev/null @@ -1,29 +0,0 @@ -""" -Evidence Output for PyPI Publish Gate - -Responsible for writing standardized gate artifacts. -""" - -import json -from pathlib import Path -from typing import Any, Dict - - -def write_json(path: Path, data: Dict[str, Any]) -> None: - """Write JSON to file, creating parent directories as needed.""" - path.parent.mkdir(parents=True, exist_ok=True) - path.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8") - - -def write_pypi_set(output_dir: Path, pypi_set: Dict[str, Any]) -> Path: - """Write pypi-set.json artifact.""" - path = output_dir / "pypi-set.json" - write_json(path, pypi_set) - return path - - -def write_gate_report(output_dir: Path, report: Dict[str, Any]) -> Path: - """Write pypi-gate-report.json artifact.""" - path = output_dir / "pypi-gate-report.json" - write_json(path, report) - return path diff --git a/scripts/semantic/validate-public-manifest.mjs b/scripts/semantic/validate-public-manifest.mjs deleted file mode 100644 index 9dfc1f570..000000000 --- a/scripts/semantic/validate-public-manifest.mjs +++ /dev/null @@ -1,150 +0,0 @@ -#!/usr/bin/env node -import fs from "node:fs"; -import path from "node:path"; -import { fileURLToPath } from "node:url"; - -const __filename = fileURLToPath(import.meta.url); -const __dirname = path.dirname(__filename); -const root = path.resolve(__dirname, "../.."); - -const schemaPath = path.join(root, "release-manifests/mplp-public-manifest.schema.json"); -const manifestPath = path.join(root, "release-manifests/mplp-public-manifest.example.json"); - -function readJson(filePath) { - return JSON.parse(fs.readFileSync(filePath, "utf8")); -} - -function typeOf(value) { - if (value === null) return "null"; - if (Array.isArray(value)) return "array"; - return typeof value; -} - -function allowsType(schemaType, actualType) { - if (Array.isArray(schemaType)) return schemaType.includes(actualType); - return schemaType === actualType; -} - -function validateNode(schema, value, pointer, errors) { - if (!schema || typeof schema !== "object") return; - - if (schema.type) { - const actualType = typeOf(value); - if (!allowsType(schema.type, actualType)) { - errors.push(`${pointer}: expected type ${JSON.stringify(schema.type)}, got ${actualType}`); - return; - } - if (actualType === "null") return; - } - - if (Object.prototype.hasOwnProperty.call(schema, "const") && value !== schema.const) { - errors.push(`${pointer}: expected const ${JSON.stringify(schema.const)}, got ${JSON.stringify(value)}`); - } - - if (schema.enum && !schema.enum.includes(value)) { - errors.push(`${pointer}: expected one of ${schema.enum.join(", ")}, got ${JSON.stringify(value)}`); - } - - if (typeof value === "string") { - if (schema.minLength && value.length < schema.minLength) { - errors.push(`${pointer}: expected minLength ${schema.minLength}`); - } - if (schema.pattern && !(new RegExp(schema.pattern).test(value))) { - errors.push(`${pointer}: failed pattern ${schema.pattern}`); - } - if (schema.format === "uri") { - try { - new URL(value); - } catch { - errors.push(`${pointer}: expected URI`); - } - } - if (schema.format === "date-time" && Number.isNaN(Date.parse(value))) { - errors.push(`${pointer}: expected parseable date-time`); - } - } - - if (Array.isArray(value)) { - if (schema.minItems && value.length < schema.minItems) { - errors.push(`${pointer}: expected at least ${schema.minItems} item(s)`); - } - if (schema.items) { - value.forEach((item, index) => validateNode(schema.items, item, `${pointer}/${index}`, errors)); - } - } - - if (value && typeof value === "object" && !Array.isArray(value)) { - const properties = schema.properties || {}; - for (const key of schema.required || []) { - if (!Object.prototype.hasOwnProperty.call(value, key)) { - errors.push(`${pointer}: missing required property ${key}`); - } - } - if (schema.additionalProperties === false) { - for (const key of Object.keys(value)) { - if (!Object.prototype.hasOwnProperty.call(properties, key)) { - errors.push(`${pointer}: unexpected property ${key}`); - } - } - } - for (const [key, childSchema] of Object.entries(properties)) { - if (Object.prototype.hasOwnProperty.call(value, key)) { - validateNode(childSchema, value[key], `${pointer}/${key}`, errors); - } - } - } -} - -function requireBoundary(condition, message, errors) { - if (!condition) errors.push(`boundary: ${message}`); -} - -const schema = readJson(schemaPath); -const manifest = readJson(manifestPath); -const errors = []; - -validateNode(schema, manifest, "$", errors); - -requireBoundary( - manifest.validation_lab_boundary?.non_certifying === true && - manifest.validation_lab_boundary?.no_endorsement === true && - manifest.validation_lab_boundary?.no_regulator_approval === true, - "Validation Lab must remain non-certifying, non-endorsing, and non-regulatory", - errors -); - -requireBoundary( - manifest.website_boundary?.discovery_positioning_only === true && - manifest.website_boundary?.protocol_truth_override_allowed === false, - "Website must remain discovery/positioning only and cannot override protocol truth", - errors -); - -requireBoundary( - manifest.repo_migration_status?.migration_now === false && - manifest.repo_migration_status?.remotes_changed === false && - manifest.repo_migration_status?.package_repository_urls_changed === false, - "repo migration and package repository URL changes must remain false", - errors -); - -requireBoundary( - manifest.package_replacement_status?.status === "planned_not_published" && - manifest.package_replacement_status?.package_actions_executed === false, - "package replacement must remain planned_not_published with no package actions", - errors -); - -requireBoundary( - manifest.release_status?.gates?.submodule_removal_allowed === false, - "Website submodule removal must not be allowed by this draft manifest", - errors -); - -if (errors.length > 0) { - console.error("Protocol public manifest validation failed:"); - for (const error of errors) console.error(`- ${error}`); - process.exit(1); -} - -console.log("Protocol public manifest schema/example validation passed."); From 2bb047ee3a312c436ad5bd6cf65ddc07b1cf79e2 Mon Sep 17 00:00:00 2001 From: jearonwong <34419488+jearonwong@users.noreply.github.com> Date: Tue, 9 Jun 2026 17:59:35 +0800 Subject: [PATCH 2/2] projection: align clean public OSS candidate gates --- .github/workflows/deploy-docs.yml | 92 +++++++++++++++++++++++++++++-- RELEASE_MANIFEST.json | 4 +- 2 files changed, 89 insertions(+), 7 deletions(-) diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml index 8f5ed4d0d..b09a68f24 100644 --- a/.github/workflows/deploy-docs.yml +++ b/.github/workflows/deploy-docs.yml @@ -3,6 +3,8 @@ name: Deploy Docusaurus to GitHub Pages on: push: branches: ["main"] + pull_request: + branches: ["main"] workflow_dispatch: permissions: @@ -14,6 +16,9 @@ concurrency: group: "pages" cancel-in-progress: false +env: + FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true" + jobs: build: name: Build Docusaurus @@ -23,12 +28,12 @@ jobs: working-directory: ./docs steps: - name: Checkout - uses: actions/checkout@v4 + uses: actions/checkout@v5 with: fetch-depth: 0 - name: Setup Node.js - uses: actions/setup-node@v4 + uses: actions/setup-node@v5 with: node-version: 20 cache: npm @@ -37,22 +42,99 @@ jobs: - name: Install dependencies run: npm ci + - name: Normalize git context + run: | + git config --global --add safe.directory "$GITHUB_WORKSPACE" + git -C "$GITHUB_WORKSPACE" fetch --force --tags origin + + - name: Prepare git trace shim + run: | + trace_bin="$RUNNER_TEMP/docs-git-trace-bin" + trace_file="$GITHUB_WORKSPACE/docs-git-trace.log" + real_git="$(command -v git)" + + mkdir -p "$trace_bin" + : > "$trace_file" + + cat > "$trace_bin/git" </dev/null || true + } >> "$trace_file" + "$real_git" "\$@" + status=\$? + echo "[\$stamp] EXIT: \$status" >> "$trace_file" + echo "---" >> "$trace_file" + exit \$status + EOF + + chmod +x "$trace_bin/git" + echo "DOCS_GIT_TRACE_BIN=$trace_bin" >> "$GITHUB_ENV" + echo "DOCS_GIT_TRACE_FILE=$trace_file" >> "$GITHUB_ENV" + echo "DOCS_REAL_GIT=$real_git" >> "$GITHUB_ENV" + - name: Build Docusaurus - run: npm run build + run: | + PATH="$DOCS_GIT_TRACE_BIN:$PATH" REAL_GIT="$DOCS_REAL_GIT" GIT_TRACE_CAPTURE="$DOCS_GIT_TRACE_FILE" npm run build env: NODE_OPTIONS: --max-old-space-size=4096 + - name: Print git trace summary + if: always() + run: | + if [ -s "$DOCS_GIT_TRACE_FILE" ]; then + echo "::group::docs-git-trace" + cat "$DOCS_GIT_TRACE_FILE" + echo "::endgroup::" + python3 - <<'PY' + import os + from pathlib import Path + + trace_path = Path(os.environ["DOCS_GIT_TRACE_FILE"]) + content = trace_path.read_text().split('---\n') + + def esc(value: str) -> str: + return value.replace('%', '%25').replace('\r', '%0D').replace('\n', '%0A') + + for block in content: + block = [line for line in block.strip().splitlines() if line.strip()] + if not block: + continue + cmd = next((line.split('CMD: ', 1)[1] for line in block if 'CMD: ' in line), 'UNKNOWN') + pwd = next((line.split('PWD: ', 1)[1] for line in block if 'PWD: ' in line), 'UNKNOWN') + exit_code = next((line.split('EXIT: ', 1)[1] for line in block if 'EXIT: ' in line), 'UNKNOWN') + parent_index = next((i for i, line in enumerate(block) if 'PARENT_PID: ' in line), None) + parent = block[parent_index + 1].strip() if parent_index is not None and parent_index + 1 < len(block) else 'UNKNOWN' + message = esc(f"{cmd} | cwd={pwd} | exit={exit_code} | parent={parent}") + if exit_code != '0': + print(f"::warning title=docs-git-trace::{message}") + else: + print(f"::notice title=docs-git-trace::{message}") + PY + else + echo "::group::docs-git-trace" + echo "NO_GIT_TRACE_RECORDED" + echo "::endgroup::" + echo "::notice title=docs-git-trace::NO_GIT_TRACE_RECORDED" + fi + - name: Create CNAME run: echo "docs.mplp.io" > build/CNAME - name: Upload artifact - uses: actions/upload-pages-artifact@v3 + uses: actions/upload-pages-artifact@v4 with: path: ./docs/build deploy: name: Deploy to GitHub Pages needs: build + if: github.event_name == 'push' permissions: pages: write id-token: write @@ -63,4 +145,4 @@ jobs: steps: - name: Deploy to GitHub Pages id: deployment - uses: actions/deploy-pages@v4 + uses: actions/deploy-pages@v5 diff --git a/RELEASE_MANIFEST.json b/RELEASE_MANIFEST.json index 625d2e7f2..ca458a7f8 100644 --- a/RELEASE_MANIFEST.json +++ b/RELEASE_MANIFEST.json @@ -1,8 +1,8 @@ { "version": "1.0.0", - "generated": "2026-06-09T09:42:27.703Z", + "generated": "2026-06-09T09:57:50.881Z", "fileCount": 767, - "totalSizeBytes": 4828823, + "totalSizeBytes": 4832676, "totalSizeMB": "4.61", "buildInfo": { "node": "v22.22.2",