@jc_stack/ez-github 0.1.0-beta.1 → 0.1.0-beta.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/CONTRIBUTING.md +37 -1
- package/README.md +3 -3
- package/bin/github.mjs +1 -1
- package/ez-plugin.json +1 -1
- package/package.json +1 -1
- package/scripts/release-check.mjs +62 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.0-beta.3
|
|
4
|
+
|
|
5
|
+
- Align the executable, README, package and plugin manifest on the new prerelease version.
|
|
6
|
+
- Add the standard verify and release package-boundary checks; Git/gh transport remains unchanged.
|
|
7
|
+
|
|
8
|
+
## 0.1.0-beta.2
|
|
9
|
+
|
|
10
|
+
- Adopt latest-tag publication and the corrected shared publisher main-CI selection. Git/gh transport remains unchanged.
|
|
11
|
+
- Testing beta; previously documented live-provider and fresh-host acceptance limits remain.
|
|
12
|
+
|
|
3
13
|
## 0.1.0-beta.1
|
|
4
14
|
|
|
5
15
|
Initial Git/gh transport with private profile, writable repository volume,
|
package/CONTRIBUTING.md
CHANGED
|
@@ -1,9 +1,45 @@
|
|
|
1
1
|
# Contributing
|
|
2
2
|
|
|
3
3
|
Use one isolated worktree and branch per change. Preserve unrelated state.
|
|
4
|
-
Run npm
|
|
4
|
+
Run npm run verify, npm run release:check, npm audit --omit=dev and git diff --check. Package with npm pack --ignore-scripts;
|
|
5
5
|
test and build the extracted package and verify Ez manager installation.
|
|
6
6
|
Credentials, argument transport and cancellation changes require negative tests.
|
|
7
7
|
Never put provider credentials or private records in tests or PRs.
|
|
8
8
|
Independent review, CI and maintainer authorization precede merge/publication.
|
|
9
9
|
Keep the worktree while review or QA is open. Publication is a separate decision.
|
|
10
|
+
|
|
11
|
+
## Shared beta publisher
|
|
12
|
+
|
|
13
|
+
`.github/workflows/publish-beta.yml` is a generated caller of the reviewed,
|
|
14
|
+
SHA-pinned shared publisher in `jdorado/ez-agents`. Keep the reusable workflow
|
|
15
|
+
reference and `publisher-sha` on the same full commit; regenerate through a
|
|
16
|
+
reviewed PR when upgrading. Required checks are `test` from
|
|
17
|
+
`.github/workflows/ci.yml`, successful on the exact source commit's push to
|
|
18
|
+
`main`. Review the check list whenever CI policy changes.
|
|
19
|
+
|
|
20
|
+
Follow the [shared publishing procedure](https://github.com/jdorado/ez-agents/blob/main/docs/trusted-publishing.md)
|
|
21
|
+
for caller regeneration, receipt fields, dispatch and failure reconciliation.
|
|
22
|
+
Complete this repository's contribution checks, packed installation QA and
|
|
23
|
+
independent review before release. Stage the exact tested tarball as
|
|
24
|
+
`candidate.tgz` with `release-receipt.json` on a draft prerelease `vVERSION`,
|
|
25
|
+
whose tag resolves to the tested current `main` commit. The receipt binds
|
|
26
|
+
`jdorado/ez_github`, `@jc_stack/ez-github`, version, full source SHA,
|
|
27
|
+
SHA-256 and public independent-review/test evidence URLs. Dispatch the caller
|
|
28
|
+
on `main` with the numeric draft release ID, version, source SHA and independently
|
|
29
|
+
verified SHA-256. Actions validates and publishes those bytes without rebuilding.
|
|
30
|
+
Only `X.Y.Z-beta.N` versions published to the `latest` dist-tag are supported.
|
|
31
|
+
|
|
32
|
+
The npm package owner must separately authenticate and enroll `jdorado/ez_github`
|
|
33
|
+
and caller filename `publish-beta.yml`, with direct publication enabled and no
|
|
34
|
+
environment (the shared job currently declares none). npm validates the caller
|
|
35
|
+
identity for reusable workflows. Verify enrollment with npm settings or
|
|
36
|
+
`npm trust list @jc_stack/ez-github`; workflow merge does not establish trust.
|
|
37
|
+
Keep npm tokens and private profiles out of Actions and test containers.
|
|
38
|
+
|
|
39
|
+
Preserve Actions registry readback and artifact hash on the release record,
|
|
40
|
+
then finish and read back the public GitHub prerelease and required installation
|
|
41
|
+
QA. After uncertain publication, inspect registry state before retrying. Never
|
|
42
|
+
publish to probe authentication or overwrite a version.
|
|
43
|
+
|
|
44
|
+
Initial beta.1 bootstrap is complete. Verify current registry version, trust and
|
|
45
|
+
release readback before preparing a new version; never replace that artifact.
|
package/README.md
CHANGED
|
@@ -4,8 +4,8 @@ Thin native GitHub CLI and Git plugin for Ez. Private per-agent profile and writ
|
|
|
4
4
|
repository volume; no provider API implementation or workflow engine.
|
|
5
5
|
|
|
6
6
|
Requires Node 22+, Docker/Compose and Ez with the cancellation fix (manager release
|
|
7
|
-
0.1.0-beta.13 or newer). Obtain `@jc_stack/ez-github@0.1.0-beta.
|
|
8
|
-
`npm pack @jc_stack/ez-github@0.1.0-beta.
|
|
7
|
+
0.1.0-beta.13 or newer). Obtain `@jc_stack/ez-github@0.1.0-beta.3` with
|
|
8
|
+
`npm pack @jc_stack/ez-github@0.1.0-beta.3 --ignore-scripts`, extract into a permanent
|
|
9
9
|
private tools directory, and inspect the extracted package.
|
|
10
10
|
|
|
11
11
|
Inspect this directory with `ez plugins inspect github --source /absolute/package`,
|
|
@@ -25,7 +25,7 @@ not encrypted by a keyring. No unattended identity creation or token display.
|
|
|
25
25
|
|
|
26
26
|
Uninstall preserves data. Revocation is separate in GitHub's authorized applications.
|
|
27
27
|
Rollback retains volumes; do not run concurrent writers on one repository. Test with
|
|
28
|
-
`npm
|
|
28
|
+
`npm run verify`, `npm run release:check`, Docker build and manager dispatch. Live GitHub verification needs consent.
|
|
29
29
|
|
|
30
30
|
Testing beta: Debian supplies Git/gh updates at image build; the installed image
|
|
31
31
|
is retained by Ez's source revision. Capture `gh --version` and `git --version` during QA.
|
package/bin/github.mjs
CHANGED
|
@@ -11,7 +11,7 @@ export function command(args) {
|
|
|
11
11
|
if(process.argv[1]&&import.meta.url===pathToFileURL(process.argv[1]).href) {
|
|
12
12
|
process.umask(0o077);
|
|
13
13
|
const args=process.argv.slice(2);
|
|
14
|
-
if(args[0]==='--version') console.log('ez-github 0.1.0-beta.
|
|
14
|
+
if(args[0]==='--version') console.log('ez-github 0.1.0-beta.3');
|
|
15
15
|
else if(!args.length||args[0]==='--help') console.log('ez github doctor | gh <native arguments> | git <native arguments>\nPrivate repositories: /repos. Native stdin, output and exit codes. Read skills/github/SKILL.md for OAuth onboarding.');
|
|
16
16
|
else {
|
|
17
17
|
try {
|
package/ez-plugin.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"schemaVersion":1,"id":"github","version":"0.1.0-beta.
|
|
1
|
+
{"schemaVersion":1,"id":"github","version":"0.1.0-beta.3","description":"GitHub CLI and Git with a private agent profile and writable repositories","commands":{"github":{"executable":"bin/github.mjs","args":[],"exposure":{"receivesExternalContent":true,"sendsExternally":true,"changesRecords":true,"requiresReview":true}}},"skills":["skills/github/SKILL.md"]}
|
package/package.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"name":"@jc_stack/ez-github","version":"0.1.0-beta.
|
|
1
|
+
{"name":"@jc_stack/ez-github","version":"0.1.0-beta.3","description":"Native Git and GitHub CLI with private per-agent profiles for Ez","license":"MIT","engines":{"node":">=22"},"packageManager":"npm@10.9.4","repository":{"type":"git","url":"git+https://github.com/jdorado/ez_github.git"},"homepage":"https://github.com/jdorado/ez_github#readme","bugs":{"url":"https://github.com/jdorado/ez_github/issues"},"publishConfig":{"access":"public","tag":"latest"},"files":["bin","skills","test","scripts/release-check.mjs","Dockerfile",".dockerignore","ez-plugin.json","ez-deployment.json","README.md","LICENSE","CHANGELOG.md","CONTRIBUTING.md","SECURITY.md","THIRD_PARTY_NOTICES.md"],"scripts":{"test":"node --test test/*.test.mjs","verify":"node --check bin/github.mjs && npm test","release:check":"node scripts/release-check.mjs"}}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
// Read-only package boundary check; no credentials or provider access.
|
|
2
|
+
import {execFileSync, spawnSync} from 'node:child_process';
|
|
3
|
+
import {readFileSync} from 'node:fs';
|
|
4
|
+
import assert from 'node:assert/strict';
|
|
5
|
+
|
|
6
|
+
const readJson = path => JSON.parse(readFileSync(path, 'utf8'));
|
|
7
|
+
const pkg = readJson('package.json');
|
|
8
|
+
const manifest = readJson('ez-plugin.json');
|
|
9
|
+
const deployment = readJson('ez-deployment.json');
|
|
10
|
+
|
|
11
|
+
assert.match(pkg.version, /^\d+\.\d+\.\d+-beta\.\d+$/);
|
|
12
|
+
assert.equal(pkg.private, undefined);
|
|
13
|
+
assert.deepEqual(pkg.publishConfig, {access: 'public', tag: 'latest'});
|
|
14
|
+
assert.equal(pkg.version, manifest.version);
|
|
15
|
+
assert.equal(manifest.id, 'github');
|
|
16
|
+
assert.deepEqual(manifest.commands.github, {
|
|
17
|
+
executable: 'bin/github.mjs',
|
|
18
|
+
args: [],
|
|
19
|
+
exposure: {
|
|
20
|
+
receivesExternalContent: true,
|
|
21
|
+
sendsExternally: true,
|
|
22
|
+
changesRecords: true,
|
|
23
|
+
requiresReview: true,
|
|
24
|
+
},
|
|
25
|
+
});
|
|
26
|
+
assert.deepEqual(manifest.skills, ['skills/github/SKILL.md']);
|
|
27
|
+
assert.deepEqual(deployment.commands.github.argv, ['node', '/app/bin/github.mjs']);
|
|
28
|
+
assert.deepEqual(deployment.services.plugin.healthcheck, ['node', '/app/bin/github.mjs', '--version']);
|
|
29
|
+
|
|
30
|
+
const version = spawnSync(process.execPath, ['bin/github.mjs', '--version'], {encoding: 'utf8'});
|
|
31
|
+
assert.equal(version.status, 0, version.stderr);
|
|
32
|
+
assert.equal(version.stdout.trim(), `ez-github ${pkg.version}`);
|
|
33
|
+
|
|
34
|
+
const readme = readFileSync('README.md', 'utf8');
|
|
35
|
+
assert.match(readme, new RegExp(`@jc_stack/ez-github@${pkg.version.replaceAll('.', '\\.')}`));
|
|
36
|
+
|
|
37
|
+
const [pack] = JSON.parse(execFileSync('npm', ['pack', '--dry-run', '--ignore-scripts', '--json'], {encoding: 'utf8'}));
|
|
38
|
+
const files = pack.files.map(file => file.path);
|
|
39
|
+
for (const required of [
|
|
40
|
+
'bin/github.mjs',
|
|
41
|
+
'scripts/release-check.mjs',
|
|
42
|
+
'skills/github/SKILL.md',
|
|
43
|
+
'test/cli.test.mjs',
|
|
44
|
+
'Dockerfile',
|
|
45
|
+
'.dockerignore',
|
|
46
|
+
'ez-plugin.json',
|
|
47
|
+
'ez-deployment.json',
|
|
48
|
+
'README.md',
|
|
49
|
+
'CHANGELOG.md',
|
|
50
|
+
'CONTRIBUTING.md',
|
|
51
|
+
'SECURITY.md',
|
|
52
|
+
'LICENSE',
|
|
53
|
+
'THIRD_PARTY_NOTICES.md',
|
|
54
|
+
]) assert.ok(files.includes(required), `Missing ${required}`);
|
|
55
|
+
for (const entry of pkg.files) {
|
|
56
|
+
assert.ok(files.includes(entry) || files.some(file => file.startsWith(`${entry}/`)), `Declared package entry missing: ${entry}`);
|
|
57
|
+
}
|
|
58
|
+
for (const file of files) {
|
|
59
|
+
assert.doesNotMatch(file, /(^|\/)(node_modules|\.git|\.env|state|repos)(\/|$)/, `Private package entry: ${file}`);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
console.log(JSON.stringify({name: pkg.name, version: pkg.version, files, unpackedSize: pack.unpackedSize}, null, 2));
|