feat: fw-4.19.0 + cli-3.16.0 — Codex CLI (OpenAI) skill support

[montfort]

Summary

• Framework fw-4.19.0: ships a fourth parallel skill distribution under dist/.codex/skills/ (11 skills) so the OpenAI Codex CLI can discover StrayMark skills. Generated from .claude/skills/ with minimal frontmatter (only name + description); body byte-identical.
• CLI cli-3.16.0: new subcommand straymark install-skills --agent codex that copies the project's .codex/skills/ into ~/.codex/skills/ (where Codex actually looks); straymark validate --agent codex verifies the install.
• Motivation: an adopter using Codex CLI for external Charter audits in Sentinel observed Codex doesn't discover skills under .claude/skills/ and rejects the Claude-only allowed-tools frontmatter. Codex also reads skills at user level (~/.codex/skills/), not from the project tree like Claude/Gemini.

What's in the box

Framework (fw-4.19.0)

• dist/.codex/skills/ — 11 generated skills with Codex-compatible frontmatter.
• dist/dist-manifest.yml — adds .codex/skills/ to the files: list so straymark init/update materializes it in adopter projects.
• AGENT-RULES.md (EN/es/zh-CN) — codex-cli-v1.0 added to the agent: examples.

CLI (cli-3.16.0)

• cli/src/commands/install_skills.rs — new subcommand. Supports --agent codex (copy/symlink to $CODEX_HOME/skills/ or ~/.codex/skills/), --dry-run, --symlink. --agent claude|gemini exits with guidance.
• cli/src/commands/validate.rs — new --agent codex mode: checks ~/.codex/skills/straymark-* for presence, parseable YAML frontmatter, required name/description, and absence of Claude-only keys (allowed-tools, argument-hint, model).
• cli/src/bin/gen_codex_skills.rs — generator binary. cargo run --bin gen_codex_skills regenerates dist/.codex/skills/ from dist/.claude/skills/. --check mode for CI drift detection.

Docs

• CHANGELOG.md — fw-4.19.0 / cli-3.16.0 entry.
• READMEs (EN/es/zh-CN) — Codex column in skills table, .codex/skills/ in multi-agent diagram, Codex CLI in supported-platforms table.
• CLI-REFERENCE.md (EN/es/zh-CN) — new sections for install-skills and validate --agent; Skills section mentions the .codex/skills/ variant.
• Version footers bumped fw-4.18.0 → fw-4.19.0 across governance docs.

Out of scope (follow-ups)

• Umbrella skill (straymark/SKILL.md) routing to specific flows.
• agents/openai.yaml per skill.
• Tool-agnostic refactor of skill bodies.
• Integration with Codex's native ~/.codex/skills/.system/skill-installer.
• Soporte análogo para Copilot CLI (mismo patrón aplicable).
• Blog post — separate seguimiento del usuario.

Test plan

• cargo build --release — clean.
• cargo test in cli/ — 217 tests pass (3 new from generator).
• cargo run --bin gen_codex_skills -- --check — reports in-sync (0 drift).
• E2E sandbox: install-skills --dry-run → install-skills → validate --agent codex (clean) → corrupt one skill by re-introducing allowed-tools → validate --agent codex warns; install-skills --agent claude errors with guidance.
• Post-merge: tag fw-4.19.0 + cli-3.16.0 and verify the release-framework + release-cli workflows produce the expected artifacts.
• Post-release: smoke test in a fresh project — straymark init, straymark install-skills --agent codex, open Codex CLI in the project, ask for an AILOG, confirm Codex discovers and runs straymark-ailog.

🤖 Generated with Claude Code