@mean-weasel/lineage-plugin-installer
v0.1.1
Published
Version-locked Codex plugin installer for @mean-weasel/lineage.
Readme
Lineage Plugin Installer
npm-powered installer that installs the Codex Lineage plugin matching a
resolved @mean-weasel/lineage version.
The installer verifies the plugin manifest before writing anything:
- plugin
versionequals the resolved Lineage package version - plugin
lineage.packageequals@mean-weasel/lineage - plugin
lineage.versionequals the resolved Lineage package version - optional artifact checksums match before install
Publishing
The package is published manually from GitHub Actions with npm provenance:
gh workflow run lineage-plugin-installer-publish.yml \
--repo mean-weasel/lineage \
-f tag=next \
-f dry_run=trueThe publish workflow defaults to dry-run mode. A real publish requires:
- npm trusted publishing for
@mean-weasel/lineage-plugin-installerto trust this repository and the.github/workflows/lineage-plugin-installer-publish.ymlworkflow
If the package does not exist yet, npm's current trusted-publishing setup may require an initial owner-controlled package publish before the trusted publisher can be added.
Install Modes
Show the installed installer package version:
lineage-plugin-installer --versionLocal plugin directory, useful while developing the plugin:
lineage-plugin-installer install --version 0.1.2 --plugin ../../plugins/lineage-codex-plugin --dry-run --jsonLocal release-style artifact, useful for testing a GitHub release asset before uploading it:
lineage-plugin-installer install --version 0.1.2 \
--artifact-file ./dist/lineage-codex-plugin-0.1.2.tgz \
--checksum-file ./dist/lineage-codex-plugin-0.1.2.tgz.sha256 \
--dry-run --jsonFuture GitHub release download, once release artifacts exist:
lineage-plugin-installer install --channel latest --github-repo mean-weasel/lineage --dry-run --jsonBy default, latest resolves with:
npm view @mean-weasel/lineage@latest version --jsonThen the installer derives:
https://github.com/mean-weasel/lineage/releases/download/v<VERSION>/lineage-codex-plugin-<VERSION>.tgz
https://github.com/mean-weasel/lineage/releases/download/v<VERSION>/lineage-codex-plugin-<VERSION>.tgz.sha256The installer downloads both files, verifies the checksum, extracts the artifact
to a temporary directory, validates .codex-plugin/plugin.json, and only then
installs or dry-runs the target plugin directory.
