feat: add Codex guidance install tool

[owenshen0907]

Summary

• Add evolver_install_codex_guidance, an explicit MCP tool that installs or refreshes a marker-delimited Evolver section in global ~/.codex/AGENTS.md.
• The tool supports dry_run, English/Chinese guidance text, and timestamped backups before changing an existing AGENTS.md file.
• Point the plugin manifest repository field at this Codex plugin marketplace repo.
• Document the optional @evomap/evolver CLI + setup-hooks --platform=codex flow and clarify that current Codex plugin installs use the evolver_* MCP tool names.

Safety notes

• Plugin installation itself does not silently modify the user's home directory.
• evolver_install_codex_guidance should be called only when the user explicitly asks to install or refresh global Codex guidance.

Test plan

• python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/evolver
• node --check plugins/evolver/mcp/evolver-proxy.mjs
• printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node plugins/evolver/mcp/evolver-proxy.mjs
• printf '%s\n' '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"evolver_install_codex_guidance","arguments":{"dry_run":true,"language":"zh"}}}' | node plugins/evolver/mcp/evolver-proxy.mjs

---

Note

Medium Risk
The new tool writes under the user's home directory (~/.codex/AGENTS.md), but it is gated to explicit user requests, backs up existing files, and only touches a bounded marker section.

Overview
Adds evolver_install_codex_guidance on the Evolver Proxy MCP bridge so Codex can install or refresh a marker-delimited Evolver section in ~/.codex/AGENTS.md (English or Chinese), with dry_run, timestamped backup, and safe insert/replace when markers are present or malformed.

Docs and manifest now point the plugin repository at this marketplace repo, describe calling the new tool vs. the optional @evomap/evolver + setup-hooks --platform=codex path, and clarify that current setups should use evolver_* MCP tools instead of legacy gep_recall / gep_record_outcome in AGENTS.md. The skill and plugin UI copy were updated to match (including a new default prompt for global guidance).

^{Reviewed by Cursor Bugbot for commit 87bfde1. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 87bfde1. Configure here.}

[cursor]

Read errors mimic missing file

Medium Severity

installCodexGuidance treats any readFileSync failure like a missing ~/.codex/AGENTS.md, leaving before empty and existed false. A readable-on-write failure (permissions, I/O, etc.) can skip the backup and overwrite the real file with only the injected section.

 

^{Reviewed by Cursor Bugbot for commit 87bfde1. Configure here.}