Repository navigation
[Feat]: Serve the plugin only from released commits and fix the private-repository docs #19
Copy link
Copy link
Closed
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Description
Summary
As a plugin user, I want the marketplace to give me only released plugin versions, and the docs to stop saying the repository is private.
Motivation
Miragon/bpmn-cliis public: an install without GitHub credentials works, and every npm version since 0.1.1 has SLSA provenance.docs/releasing.mdand thenpm publishcomment inrelease-please.ymlstill say the repository is private and has no provenance.- The marketplace entry
"source": "./plugins/bpmn-cli"resolves from the tip ofmain. A fresh install can get a skill ahead of its CLI (65 min between feat: bpmn render — SVG/PNG for agents with crops, halos and numbered layout problems (#12) #15 and 0.5.0: the skill ranbpmn renderon a pinned 0.4.0), or one pinning a version npm does not have yet (4 to 6 min per release). Such a copy carries the release's version string, soclaude plugin updatekeeps it until the next release.
Proposed Solution
- Fix the provenance statements (docs: state that npm adds provenance to releases of the public repository #124).
- Install the plugin from a branch
release(fix(plugin): serve the plugin from the release branch, moved only after npm publish #125):marketplace.json:git-subdirsource,https://URL,path: plugins/bpmn-cli,ref: release. ThehttpsURL matters: theowner/reposhorthand goes through the SSH probe.release-please.yml: a job afterpublishfast-forwardsreleaseto the tag (GitHub API,force=false), so the branch only moves once npm has the version.
Acceptance Criteria
- No doc says the repository is private or lacks provenance.
-
releaseexists at the latest tag before the marketplace change is merged. -
marketplace.jsoninstalls fromreleaseviagit-subdir, without aversion. -
releasemoves only afterpublishsucceeded, fast-forward only,contents: writescoped to that job. -
docs/releasing.mddescribes the branch and how to recover from a failed move. -
test/e2e/plugin.test.tschecks the new entry;claude plugin validate --strictpasses in CI. - After the next release: an existing
bpmn-cli@miragon-bpmninstall updates to it without a reinstall, and only once npm has the version.
Alternatives Considered
- A separate public marketplace repo: no gain while this repo is public; only worth it as a Miragon-wide catalog.
- An
npmplugin source: the package root would have to be the plugin root (bin/lands onPATH), so it needs a second package. - Release-please bumping
ref: vX.Y.Z: its updater drops thev, andmainwould point at a tag before npm has it. - Users add
Miragon/bpmn-cli#release: changes the install command, existing users keep trackingmain.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Activity
[-]Plugin: the repo is already public. Fix the "private repository" install docs and serve the plugin only from released commits[/-][+][Feat]: Serve the plugin only from released commits and fix the private-repository docs[/+]