mirror of
https://github.com/openprose/prose.git
synced 2026-09-19 05:55:05 +08:00
Jose Montes de Oca
93e91325d7
OpenProse already installed as a Claude Code plugin via `npx skills add openprose/prose`, but the packaging surface was uneven: missing manifest fields, no native Codex envelope, no plugin-track release process, and a couple of doc/audience inconsistencies. This commit closes those gaps without changing skill behavior. OpenProse now ships from the repo root as a dual-host plugin envelope — `.claude-plugin/` for Claude Code, `.codex-plugin/` plus `.agents/plugins/` for Codex — with `skills/open-prose/` as the shared core and `prose ...` as the only user-facing command surface. Codex envelope: - .codex-plugin/plugin.json with first-class catalog metadata (displayName, developer, descriptions, category, capabilities, defaultPrompt, privacy/terms URLs). - .agents/plugins/marketplace.json local-source catalog, installable by anyone who clones this repo. Claude Code manifest hygiene: - Added license, homepage, and skills: ./skills so the plugin is self-describing. - Added marketplace.json metadata.description, clearing the sole `claude plugin validate` warning. - Deleted the stale .claude-plugin/README.md. Skill metadata: - Added license: MIT to skills/open-prose/SKILL.md frontmatter (no top-level version — Claude Code strips unrecognized top-level frontmatter keys; see anthropics/claude-code#13005). - Fixed an inconsistent parse-table cell pair in skills/open-prose/deps.md. Audience boundaries: - AGENTS.md is now contributor-only per agents.md. - Recommended consumer [agents] Codex config moved to README.md alongside the Quickstart. Release process: - scripts/bump-version.sh + .version-bump.json bump both manifests atomically, with a --check mode for CI. The Claude Code marketplace deduplicates by version, so a forgotten bump silently strands users on cached copies; this gate prevents that. - scripts/extract-changelog.sh pulls a single `## [X.Y.Z]` block out of CHANGELOG.md. - RELEASE.md documents the manual flow. - .github/workflows/release.yml verifies declared versions match on `v*` tag push and publishes a GitHub Release. CI: - New plugin-manifest.yml: every-PR gate validating both plugin.json files, asserting declared skills paths resolve, and running bump-version.sh --check. - cli-skills-smoke.yml: added `npx skills list openprose/prose` discoverability check alongside the existing install smoke. - openprose-smoke/run.ts: removed a dead commands/prose-*.md regex.
72 lines
2.6 KiB
YAML
72 lines
2.6 KiB
YAML
name: Plugin Manifest
|
|
|
|
on:
|
|
pull_request:
|
|
paths:
|
|
- ".claude-plugin/**"
|
|
- ".codex-plugin/**"
|
|
- ".agents/plugins/**"
|
|
- "skills/open-prose/SKILL.md"
|
|
- "scripts/bump-version.sh"
|
|
- ".version-bump.json"
|
|
- "CHANGELOG.md"
|
|
- ".github/workflows/plugin-manifest.yml"
|
|
push:
|
|
branches:
|
|
- main
|
|
paths:
|
|
- ".claude-plugin/**"
|
|
- ".codex-plugin/**"
|
|
- ".agents/plugins/**"
|
|
- "skills/open-prose/SKILL.md"
|
|
- "scripts/bump-version.sh"
|
|
- ".version-bump.json"
|
|
- "CHANGELOG.md"
|
|
- ".github/workflows/plugin-manifest.yml"
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
concurrency:
|
|
group: plugin-manifest-${{ github.ref }}
|
|
cancel-in-progress: true
|
|
|
|
jobs:
|
|
validate:
|
|
name: Validate plugin manifests
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 2
|
|
steps:
|
|
- name: Checkout
|
|
uses: actions/checkout@v4
|
|
|
|
- name: Validate Claude plugin manifest
|
|
run: |
|
|
node -e '
|
|
const fs = require("fs");
|
|
const m = JSON.parse(fs.readFileSync(".claude-plugin/plugin.json","utf8"));
|
|
if (!m.name || !m.version) { console.error("missing name/version"); process.exit(1); }
|
|
const skillsField = String(m.skills || "./skills").replace(/^\.\//,"").replace(/\/$/,"");
|
|
const target = skillsField + "/open-prose/SKILL.md";
|
|
if (!fs.existsSync(target)) { console.error("skills path not found: " + target); process.exit(1); }
|
|
console.log("ok: claude plugin manifest");
|
|
'
|
|
|
|
- name: Validate Codex plugin manifest
|
|
run: |
|
|
node -e '
|
|
const fs = require("fs");
|
|
const m = JSON.parse(fs.readFileSync(".codex-plugin/plugin.json","utf8"));
|
|
if (!m.name || !m.version) { console.error("missing name/version"); process.exit(1); }
|
|
if (!m.interface || !m.interface.displayName) { console.error("missing interface.displayName"); process.exit(1); }
|
|
const skillsField = String(m.skills || "./skills").replace(/^\.\//,"").replace(/\/$/,"");
|
|
const target = skillsField + "/open-prose/SKILL.md";
|
|
if (!fs.existsSync(target)) { console.error("skills path not found: " + target); process.exit(1); }
|
|
const mp = JSON.parse(fs.readFileSync(".agents/plugins/marketplace.json","utf8"));
|
|
if (!Array.isArray(mp.plugins) || mp.plugins[0].name !== "open-prose") { console.error("agents/plugins/marketplace.json mismatch"); process.exit(1); }
|
|
console.log("ok: codex plugin manifest");
|
|
'
|
|
|
|
- name: Plugin versions in sync
|
|
run: ./scripts/bump-version.sh --check
|