Enable spec publishing to NPM

[bcdxn]

publish a spec-only package to NPM to support downstream packages that rely on the OpenCLI specification. On publish, the canonical spec is copied from the root of the opencli repo to the npm/specification package directory. The version of the package is determined by the git tag that triggers the workflow (and verified to match the version within the JSON schema)

Published NPM packages for OpenCLI can be found at: https://www.npmjs.com/package/@openclidev/specification

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Copilot]

Copilot review overview

🟢 Approval recommended

The remaining README clarification is a minor, non-blocking nit.

Review effort: Lite
Findings: None

What changed in this PR

Adds a spec-only NPM package for distributing the canonical OpenCLI JSON Schema.

Changes:

• Adds package metadata, exports, and documentation.
• Adds tag-triggered validation and publishing workflow.
• Includes the schema and license in the published package.

File	Summary
npm/​specification/​README.md	Documents installation and schema usage; clarify prerelease dist-tag usage.
npm/​specification/​package.json.tmpl	Defines package metadata and exports.
.github/​workflows/​npm-publish-specification.yaml	Validates versions, prepares contents, and publishes the package.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.