feat: close stale issues #22 #23 #25 — npm validate, dynamic version, per-engine README

[sgriffiths]

Closes #22.
Closes #23.
Closes #25.

Summary

• Add --version flag to CLI #23 — npm --version: Node CLI now reads version from package.json instead of a hard-coded literal, so oa --version cannot drift from the published release. (Python CLI already reads from package metadata since 1.5.0.)
• Add spec validation command (oas validate) #25 — npm oa validate: Node CLI gains oa validate --spec <path>, mirroring the Python command's required-field check (open_agent_spec, agent, intelligence, tasks). No model call.
• Add usage examples to README for each engine type #22 — Per-engine README examples: "Multiple engines" section now ships a runnable block per engine (OpenAI, Anthropic, Grok/xAI, Local, Cortex, Custom). Each shows the intelligence: YAML, the env var to export, and the matching oa run command.
• Bumps both packages to 1.5.2 with a CHANGELOG entry.

Test plan

• npx tsc --noEmit clean
• ruff check oas_cli/ tests/ clean
• pytest tests/ — 442 passed, 5 skipped
• node ./bin/oa.js --version prints 1.5.2
• node ./bin/oa.js validate --spec <good> exits 0; validate --spec <bad> exits 1 with VALIDATION_ERROR
• README per-engine blocks render correctly on GitHub and PyPI

Notes

• npm package has no existing test infra; adding jest scaffolding for one command would be scope creep — left for a follow-up.
• .gitignore change visible in git status predates this branch and is not part of the commit.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
open-agent-spec	Ready	Preview, Comment	May 11, 2026 3:33am