golem15/msd-core
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(#2088): migrate Codex onto the Embeddable Orchestration System (ADR-1239)

Browse Source 
Drive Codex install/uninstall through the descriptor-driven Host-Integration
Interface (declarative embedding adapter → engine surface dispatch) and fold
every positive `runtime === 'codex'` / `isCodex` projection into descriptor-driven
`runtime.hostBehaviors`. Install/uninstall output stays byte-parity-gated
(tests/fixtures/golden-install-parity/codex.json); no other runtime changes.

Three Context7-verified upgrades, each with a test on the user-reachable surface:
- Skill root → canonical $HOME/.agents/skills via a skills-kind `home` override,
  with pre-move migration cleanup (stale ~/.codex/skills/gsd-* removed on install
  and uninstall; user content preserved). Fixes getGlobalSkillsBase, writeManifest,
  and the skill-manifest inventory to honor the override so --skills-root /
  sync-skills / the manifest report the real location.
- Six new hooks.json lifecycle events (PreToolUse, PermissionRequest, PreCompact,
  PostCompact, SubagentStop, UserPromptSubmit) shared by install + uninstall;
  extendedHookEvents reconciled [] -> the schema-valid wired subset.
- Explicit `[agents] max_depth = 1` in the managed config.toml block, pinning the
  negotiated dispatch.maxDepth:1 axis. validateCodexConfigSchema now permits a
  known-scalar-only bare `[agents]` AgentsToml table (still rejects [[agents]] and
  unknown-key break-forms, #2760); mergeCodexConfig preserves the user's own
  AgentsToml scalars (max_threads etc.) instead of dropping them.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Tom Boucher
2026-07-08 21:42:11 -04:00
parent e5a1d7f5c4
commit 6e773d97df
24 changed files with 1252 additions and 211 deletions
Download Patch File Download Diff File Expand all files Collapse all files

146
tests/fixtures/golden-install-parity/codex.json vendored
View File

@@ -1,4 +1,75 @@
{
".agents/skills/gsd-add-tests/SKILL.md": "f3c1594a059de3ee",
".agents/skills/gsd-ai-integration-phase/SKILL.md": "ba4b5f406db6de96",
".agents/skills/gsd-audit-fix/SKILL.md": "9cea2764b92aa352",
".agents/skills/gsd-audit-milestone/SKILL.md": "0528ef8a5834b5df",
".agents/skills/gsd-audit-uat/SKILL.md": "6c2aa0c2b62c5233",
".agents/skills/gsd-autonomous/SKILL.md": "d56dc692750f4926",
".agents/skills/gsd-capture/SKILL.md": "211d601d122b5dd6",
".agents/skills/gsd-cleanup/SKILL.md": "18cba17463c6ef97",
".agents/skills/gsd-code-review/SKILL.md": "74749a1aff4224d7",
".agents/skills/gsd-complete-milestone/SKILL.md": "77bee8741f8cb381",
".agents/skills/gsd-config/SKILL.md": "5fde92e30619edcb",
".agents/skills/gsd-debug/SKILL.md": "7e56964e14fd0a10",
".agents/skills/gsd-discuss-phase/SKILL.md": "837d46c55cc2424e",
".agents/skills/gsd-docs-update/SKILL.md": "5028dc5dd44bee7d",
".agents/skills/gsd-eval-review/SKILL.md": "a300e78a27ba74d6",
".agents/skills/gsd-execute-phase/SKILL.md": "e77bee13068600d3",
".agents/skills/gsd-explore/SKILL.md": "d660cde0e6f31ebf",
".agents/skills/gsd-extract-learnings/SKILL.md": "e32388999da384e4",
".agents/skills/gsd-fast/SKILL.md": "14c407a76a40e115",
".agents/skills/gsd-forensics/SKILL.md": "6d496a16f5ca74b3",
".agents/skills/gsd-graphify/SKILL.md": "1bbd96129fbacc5c",
".agents/skills/gsd-health/SKILL.md": "656c9c63852e3787",
".agents/skills/gsd-help/SKILL.md": "28eb8d0b487239f8",
".agents/skills/gsd-import/SKILL.md": "4d15ee09e531342f",
".agents/skills/gsd-inbox/SKILL.md": "1315033595643485",
".agents/skills/gsd-ingest-docs/SKILL.md": "5bd2838bf0b6dc1b",
".agents/skills/gsd-manager/SKILL.md": "cb1cf56f5d3f66d6",
".agents/skills/gsd-map-codebase/SKILL.md": "cd27dc028718426b",
".agents/skills/gsd-mempalace-capture/SKILL.md": "1a7fac4d53f607ab",
".agents/skills/gsd-mempalace-recall/SKILL.md": "7205b02250e89f25",
".agents/skills/gsd-milestone-summary/SKILL.md": "af84ecb400f23556",
".agents/skills/gsd-mvp-phase/SKILL.md": "72b65ae927b280fe",
".agents/skills/gsd-new-milestone/SKILL.md": "587574d2d475bb10",
".agents/skills/gsd-new-project/SKILL.md": "129ac16e6a1f04ba",
".agents/skills/gsd-next/SKILL.md": "7855fd70e387087e",
".agents/skills/gsd-ns-context/SKILL.md": "9b496da79789b3f9",
".agents/skills/gsd-ns-ideate/SKILL.md": "84ca1cde06110981",
".agents/skills/gsd-ns-manage/SKILL.md": "909dafa0cd19ba5a",
".agents/skills/gsd-ns-project/SKILL.md": "936b6998d42520ac",
".agents/skills/gsd-ns-review/SKILL.md": "022253010db0e072",
".agents/skills/gsd-ns-workflow/SKILL.md": "cba075bc819b539e",
".agents/skills/gsd-onboard/SKILL.md": "f42fc2edebeda671",
".agents/skills/gsd-pause-work/SKILL.md": "b379469eed78a196",
".agents/skills/gsd-phase/SKILL.md": "25477edc97a90c91",
".agents/skills/gsd-plan-phase/SKILL.md": "19ead1acb151a868",
".agents/skills/gsd-plan-review-convergence/SKILL.md": "f654089c11024027",
".agents/skills/gsd-pr-branch/SKILL.md": "6901da15e321913e",
".agents/skills/gsd-profile-user/SKILL.md": "6259fabfb6afe7be",
".agents/skills/gsd-progress/SKILL.md": "85d76286162b9189",
".agents/skills/gsd-quick/SKILL.md": "b4f4e711ba664aa0",
".agents/skills/gsd-resume-work/SKILL.md": "04f6c2e5b579e8c4",
".agents/skills/gsd-review-backlog/SKILL.md": "469696b944c4e7b5",
".agents/skills/gsd-review/SKILL.md": "a45ab2fdca06793b",
".agents/skills/gsd-secure-phase/SKILL.md": "e64ad269c1e6e319",
".agents/skills/gsd-settings/SKILL.md": "fcdda8dd545622ae",
".agents/skills/gsd-ship/SKILL.md": "9615cc4c8f6de060",
".agents/skills/gsd-sketch/SKILL.md": "90c219b843db7ec7",
".agents/skills/gsd-spec-phase/SKILL.md": "56a5cbd606db9cba",
".agents/skills/gsd-spike/SKILL.md": "77209fef7a04c11a",
".agents/skills/gsd-stats/SKILL.md": "566024444ef71f44",
".agents/skills/gsd-surface/SKILL.md": "492cda98187a969b",
".agents/skills/gsd-thread/SKILL.md": "85326c97c83a02d1",
".agents/skills/gsd-ui-phase/SKILL.md": "a0c8fbcbe5e3c2b9",
".agents/skills/gsd-ui-review/SKILL.md": "081a3292a2d357f5",
".agents/skills/gsd-ultraplan-phase/SKILL.md": "06fb3d76eb785f94",
".agents/skills/gsd-undo/SKILL.md": "007d3b307e027af9",
".agents/skills/gsd-update/SKILL.md": "e6e49e117c7c8f35",
".agents/skills/gsd-validate-phase/SKILL.md": "373059517a94a194",
".agents/skills/gsd-verify-work/SKILL.md": "4272275698e9a3fe",
".agents/skills/gsd-workspace/SKILL.md": "06d6400d68318361",
".agents/skills/gsd-workstreams/SKILL.md": "2f77bb94db1be1a4",
".gsd-profile": "0e716a5fef4e6dc1",
".gsd/defaults.json": "560664b045e645cb",
"agents/gsd-advisor-researcher.md": "eea6d1604aaf305c",
@@ -69,7 +140,7 @@
"agents/gsd-user-profiler.toml": "b9c244bb8fbf8140",
"agents/gsd-verifier.md": "4ac4b860e2504374",
"agents/gsd-verifier.toml": "8ed9fb961409e894",
"config.toml": "a34316b9ac61a620",
"config.toml": "fa48d84b92174890",
"gsd-core/VERSION": "ef0deccd81a6723c",
"gsd-core/bin/check-latest-version.cjs": "e4a224058c8f4d74",
"gsd-core/bin/ensure-runtime-build.cjs": "51bc64467ab30f62",
@@ -359,76 +430,5 @@
"scripts/gen-capability-registry.cjs": "c52201ff4d1c2cd7",
"scripts/gen-loop-host-contract.cjs": "c7f15237234811a0",
"scripts/lib/allowlist-ratchet.cjs": "ffaceaac3efc2660",
"scripts/lib/cli-exit.cjs": "612d0c372c75b7e7",
"skills/gsd-add-tests/SKILL.md": "f3c1594a059de3ee",
"skills/gsd-ai-integration-phase/SKILL.md": "ba4b5f406db6de96",
"skills/gsd-audit-fix/SKILL.md": "9cea2764b92aa352",
"skills/gsd-audit-milestone/SKILL.md": "0528ef8a5834b5df",
"skills/gsd-audit-uat/SKILL.md": "6c2aa0c2b62c5233",
"skills/gsd-autonomous/SKILL.md": "d56dc692750f4926",
"skills/gsd-capture/SKILL.md": "211d601d122b5dd6",
"skills/gsd-cleanup/SKILL.md": "18cba17463c6ef97",
"skills/gsd-code-review/SKILL.md": "74749a1aff4224d7",
"skills/gsd-complete-milestone/SKILL.md": "77bee8741f8cb381",
"skills/gsd-config/SKILL.md": "5fde92e30619edcb",
"skills/gsd-debug/SKILL.md": "7e56964e14fd0a10",
"skills/gsd-discuss-phase/SKILL.md": "837d46c55cc2424e",
"skills/gsd-docs-update/SKILL.md": "5028dc5dd44bee7d",
"skills/gsd-eval-review/SKILL.md": "a300e78a27ba74d6",
"skills/gsd-execute-phase/SKILL.md": "e77bee13068600d3",
"skills/gsd-explore/SKILL.md": "d660cde0e6f31ebf",
"skills/gsd-extract-learnings/SKILL.md": "e32388999da384e4",
"skills/gsd-fast/SKILL.md": "14c407a76a40e115",
"skills/gsd-forensics/SKILL.md": "6d496a16f5ca74b3",
"skills/gsd-graphify/SKILL.md": "1bbd96129fbacc5c",
"skills/gsd-health/SKILL.md": "656c9c63852e3787",
"skills/gsd-help/SKILL.md": "28eb8d0b487239f8",
"skills/gsd-import/SKILL.md": "4d15ee09e531342f",
"skills/gsd-inbox/SKILL.md": "1315033595643485",
"skills/gsd-ingest-docs/SKILL.md": "5bd2838bf0b6dc1b",
"skills/gsd-manager/SKILL.md": "cb1cf56f5d3f66d6",
"skills/gsd-map-codebase/SKILL.md": "cd27dc028718426b",
"skills/gsd-mempalace-capture/SKILL.md": "1a7fac4d53f607ab",
"skills/gsd-mempalace-recall/SKILL.md": "7205b02250e89f25",
"skills/gsd-milestone-summary/SKILL.md": "af84ecb400f23556",
"skills/gsd-mvp-phase/SKILL.md": "72b65ae927b280fe",
"skills/gsd-new-milestone/SKILL.md": "587574d2d475bb10",
"skills/gsd-new-project/SKILL.md": "129ac16e6a1f04ba",
"skills/gsd-next/SKILL.md": "7855fd70e387087e",
"skills/gsd-ns-context/SKILL.md": "9b496da79789b3f9",
"skills/gsd-ns-ideate/SKILL.md": "84ca1cde06110981",
"skills/gsd-ns-manage/SKILL.md": "909dafa0cd19ba5a",
"skills/gsd-ns-project/SKILL.md": "936b6998d42520ac",
"skills/gsd-ns-review/SKILL.md": "022253010db0e072",
"skills/gsd-ns-workflow/SKILL.md": "cba075bc819b539e",
"skills/gsd-onboard/SKILL.md": "f42fc2edebeda671",
"skills/gsd-pause-work/SKILL.md": "b379469eed78a196",
"skills/gsd-phase/SKILL.md": "25477edc97a90c91",
"skills/gsd-plan-phase/SKILL.md": "19ead1acb151a868",
"skills/gsd-plan-review-convergence/SKILL.md": "f654089c11024027",
"skills/gsd-pr-branch/SKILL.md": "6901da15e321913e",
"skills/gsd-profile-user/SKILL.md": "6259fabfb6afe7be",
"skills/gsd-progress/SKILL.md": "85d76286162b9189",
"skills/gsd-quick/SKILL.md": "b4f4e711ba664aa0",
"skills/gsd-resume-work/SKILL.md": "04f6c2e5b579e8c4",
"skills/gsd-review-backlog/SKILL.md": "469696b944c4e7b5",
"skills/gsd-review/SKILL.md": "a45ab2fdca06793b",
"skills/gsd-secure-phase/SKILL.md": "e64ad269c1e6e319",
"skills/gsd-settings/SKILL.md": "fcdda8dd545622ae",
"skills/gsd-ship/SKILL.md": "9615cc4c8f6de060",
"skills/gsd-sketch/SKILL.md": "90c219b843db7ec7",
"skills/gsd-spec-phase/SKILL.md": "56a5cbd606db9cba",
"skills/gsd-spike/SKILL.md": "77209fef7a04c11a",
"skills/gsd-stats/SKILL.md": "566024444ef71f44",
"skills/gsd-surface/SKILL.md": "492cda98187a969b",
"skills/gsd-thread/SKILL.md": "85326c97c83a02d1",
"skills/gsd-ui-phase/SKILL.md": "a0c8fbcbe5e3c2b9",
"skills/gsd-ui-review/SKILL.md": "081a3292a2d357f5",
"skills/gsd-ultraplan-phase/SKILL.md": "06fb3d76eb785f94",
"skills/gsd-undo/SKILL.md": "007d3b307e027af9",
"skills/gsd-update/SKILL.md": "e6e49e117c7c8f35",
"skills/gsd-validate-phase/SKILL.md": "373059517a94a194",
"skills/gsd-verify-work/SKILL.md": "4272275698e9a3fe",
"skills/gsd-workspace/SKILL.md": "06d6400d68318361",
"skills/gsd-workstreams/SKILL.md": "2f77bb94db1be1a4"
"scripts/lib/cli-exit.cjs": "612d0c372c75b7e7"
}