@plasius/images 1.0.22 → 1.0.24

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 CHANGED
@@ -8,6 +8,36 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
8
8
 
9
9
  ## [Unreleased]
10
10
 
11
+ - **Added**
12
+ - (placeholder)
13
+
14
+ - **Changed**
15
+ - (placeholder)
16
+
17
+ - **Fixed**
18
+ - (placeholder)
19
+
20
+ - **Security**
21
+ - (placeholder)
22
+
23
+ ## [1.0.24] - 2026-10-21
24
+
25
+ - **Added**
26
+ - (placeholder)
27
+
28
+ - **Changed**
29
+ - Restore trusted push-only CI on the approved quarantined self-hosted group, with bounded validation, clean installation, credential isolation and final package admission.
30
+
31
+ - **Fixed**
32
+ - (placeholder)
33
+
34
+ - **Security**
35
+ - (placeholder)
36
+
37
+ ## [1.0.23] - 2026-10-18
38
+
39
+ - Refresh npm dependency lockfile to current supported stable versions (weekly maintenance, 2026-10-18).
40
+
11
41
  - **Added**
12
42
  - (placeholder)
13
43
 
@@ -314,17 +344,17 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
314
344
 
315
345
  ## Release process (maintainers)
316
346
 
317
- 1. Update `CHANGELOG.md` under **Unreleased** with user-visible changes.
318
- 2. Bump version in `package.json` following SemVer (major/minor/patch).
319
- 3. Move entries from **Unreleased** to a new version section with the current date.
320
- 4. Tag the release in Git (`vX.Y.Z`) and push tags.
321
- 5. Publish to npm (via CI/CD or `npm publish`).
347
+ 1. Record user-visible changes under **Unreleased**.
348
+ 2. Verify public visibility, production environment, npm trusted-publisher identity and the next unused version.
349
+ 3. Dispatch `.github/workflows/cd.yml` on `main` with `phase=prepare` and the appropriate `bump`.
350
+ 4. Review and merge the pipeline's release metadata PR after its required checks. The pipeline owns version/changelog promotion and release tags.
351
+ 5. Verify successful exact-main push CI, hosted production OIDC publication, public registry integrity/provenance and the matching GitHub release.
322
352
 
323
- > Tip: Use Conventional Commits in PR titles/bodies to make changelog updates easier.
353
+ Never publish locally or manually promote versioned changelog sections. Rollback disables the affected workflow/channel without restoring the administrative registry.
324
354
 
325
355
  ---
326
356
 
327
- [Unreleased]: https://github.com/Plasius-LTD/images/compare/v1.0.22...HEAD
357
+ [Unreleased]: https://github.com/Plasius-LTD/images/compare/v1.0.24...HEAD
328
358
 
329
359
  ## [1.0.0] - 2026-02-11
330
360
 
@@ -358,3 +388,5 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
358
388
  [1.0.20]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.20
359
389
  [1.0.21]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.21
360
390
  [1.0.22]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.22
391
+ [1.0.23]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.23
392
+ [1.0.24]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.24
package/README.md CHANGED
@@ -55,11 +55,33 @@ MIT
55
55
  ## Release integrity
56
56
 
57
57
  CI keeps the administrative contributor registry outside Git and npm package
58
- artifacts using exact, case-normalised path checks. CI runs on approved
59
- GitHub-hosted runners for same-repository pull requests and `main`, with
60
- package-manager cache finalization disabled; fork PR code is denied.
61
- Publication uses the GitHub-hosted `production` job with Node 24 and a pinned
62
- npm 11.6.2 client. It is token-free and proceeds only while the prepared SHA
63
- is the exact `main` head after successful push-triggered CI. Do not dispatch CD
64
- until the npm trusted-publisher binding is verified.
58
+ artifacts using exact, case-normalised path checks. The public CI workflow
59
+ accepts only pushes in `Plasius-LTD/images` and resolves both validation jobs
60
+ to the literal `Public CI - Quarantined` runner group with
61
+ `[self-hosted, Linux, X64]` labels. Fork and pull-request events, reusable calls,
62
+ manual dispatch, caller-selected runners and hosted fallback are not admitted.
63
+ Branch pushes require explicit reviewed workflow admission in that group;
64
+ `main` is already admitted. Jobs have 15/10 minute limits, checkout credential
65
+ persistence and package-manager cache finalization are disabled, and clean
66
+ `npm ci` retains lint, types, audit, build, 80% LCOV, source/index admission and
67
+ final package-manifest gates.
68
+
69
+ Publication uses the existing literal `ubuntu-latest` GitHub-hosted `production`
70
+ job with Node 24 and pinned npm 11.6.2. It is token-free and proceeds only while
71
+ the prepared SHA is the exact `main` head after successful push-triggered CI.
72
+ Verify public visibility, the production environment, trusted-publisher
73
+ repository/workflow/main/environment identity and the next unused version
74
+ before dispatching `cd.yml` with `phase=prepare` and `bump=patch`. The pipeline
75
+ alone generates release metadata, queues exact-commit CI, and dispatches the
76
+ publish phase; do not edit versioned changelog sections or publish locally.
77
+
78
+ Inherited rollout flag: `platform.public-artifact-integrity.enabled`, evaluated
79
+ by the platform's governed feature-flag store for staged public distribution.
80
+ Enabled permits verified promotion; disabled stops promotion. Neither state
81
+ bypasses mandatory source/package/CI/CD checks. This package has no runtime
82
+ flag evaluator, capability, or environment-variable override. Roll back by
83
+ stopping promotion and disabling the affected workflow/channel; remove any
84
+ temporary branch workflow admission after checks and merge. Never restore the
85
+ removed administrative registry or reuse a removed npm version. See
86
+ [ADR-0004](docs/adrs/adr-0004-quarantined-public-ci.md).
65
87
  <!-- END PLASIUS RELEASE INTEGRITY -->
@@ -16,7 +16,7 @@ Publish only from the GitHub-hosted `production` job using npm trusted
16
16
  publishing. Prove the prepared SHA is still the exact remote `main` head and
17
17
  that push-triggered `ci.yml` succeeded for it. Require Node 24 and npm 11.5.1 or
18
18
  newer, request provenance, and prohibit npm write-token fallbacks. Reviewed CI
19
- uses explicit GitHub-hosted runners; fork PR code is denied.
19
+ uses the trusted push-only quarantined self-hosted policy in ADR-0004; fork and PR events are denied.
20
20
 
21
21
  ## Consequences
22
22
 
@@ -0,0 +1,62 @@
1
+ # ADR-0004: Quarantined public CI with hosted package publication
2
+
3
+ - Status: Accepted
4
+ - Date: 2026-10-21
5
+ - Project: images#29; plasius-ltd-site#1626; Feature #1597
6
+ - Supersedes: ADR-0003's CI runner policy only
7
+
8
+ ## Context
9
+
10
+ The public images repository must satisfy its Project requirement for approved
11
+ self-hosted validation without allowing external-fork code onto organisation
12
+ capacity. Hosted OIDC publication is a separate, existing trust boundary.
13
+
14
+ ## Decision
15
+
16
+ Accept only push events from the literal `Plasius-LTD/images` repository.
17
+ Both CI jobs use the literal `Public CI - Quarantined` group and
18
+ `[self-hosted, Linux, X64]` labels. The group's selected repository/workflow
19
+ allowlist admits main and only specifically reviewed source branches while
20
+ needed. No pull-request/target/dispatch/call trigger, dynamic selector or hosted
21
+ fallback exists. Checkout does not persist credentials, package-manager cache
22
+ finalization is disabled, and validation is bounded to 15/10 minutes.
23
+
24
+ Use clean `npm ci` and keep lint, types, runtime audit, build, 80% LCOV,
25
+ source/index artifact admission and final package-manifest checks. Reuse the
26
+ existing validators rather than introducing a second admission implementation.
27
+ No package dependencies, runtime source or public API change.
28
+
29
+ Keep ADR-0003's hosted exact-main production OIDC publication unchanged. Before
30
+ release verify visibility, production, publisher identity and an unused patch
31
+ version, then use only main's approved two-phase cd.yml. The preparation
32
+ pipeline owns version/changelog metadata and tags; exact-main push CI gates
33
+ publication. Verify registry bytes, provenance, signatures and public release.
34
+
35
+ The inherited `platform.public-artifact-integrity.enabled` flag is evaluated
36
+ by the platform's governed store. Enabled permits staged verified promotion;
37
+ disabled stops it. Mandatory integrity gates remain active in either state.
38
+ This library needs no capability, runtime flag evaluation or env override.
39
+
40
+ ## Alternatives
41
+
42
+ Hosted CI contradicts the tracked acceptance criteria. Public PR-head
43
+ execution, caller-selected runner inputs and automatic hosted fallbacks weaken
44
+ the intended admission boundary. A new shared package or runtime flag would
45
+ add an unnecessary package boundary for repository workflow configuration.
46
+
47
+ ## Impact and tests
48
+
49
+ Workflow regressions first demonstrate failures for event admission, runner
50
+ isolation and reproducible quality/artifact gates, then enforce both jobs and
51
+ the unchanged hosted production OIDC/exact-SHA boundary. Run full package
52
+ validation and actionlint, source/main CI, and approved CD. Runtime source is
53
+ unchanged, so changed-runtime-file LCOV is N/A; retain overall 80% coverage.
54
+ No UI, browser, SEO, backend deployment or ACA secret-reference change applies.
55
+ Bounded jobs and explicit logs support reliability and observability.
56
+
57
+ ## Rollback
58
+
59
+ Disable the affected CI/CD workflow or distribution channel and stop promotion;
60
+ remove temporary source-branch workflow admission after merge/checks. Retain
61
+ source, index and package admission; never restore the administrative registry,
62
+ fall back to a long-lived npm token, or reuse a removed version.
@@ -3,3 +3,5 @@
3
3
  - [ADR-0001: Standalone @plasius/images Package Scope](./adr-0001-images-package-scope.md)
4
4
  - [ADR-0002: Public Repository Governance Baseline](./adr-0002-public-repo-governance.md)
5
5
  - [ADR-0003: Hosted OIDC Package Publication](./adr-0003-hosted-oidc-package-publication.md)
6
+
7
+ - [ADR-0004: Quarantined public CI](adr-0004-quarantined-public-ci.md)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plasius/images",
3
- "version": "1.0.22",
3
+ "version": "1.0.24",
4
4
  "main": "./dist/index.cjs",
5
5
  "types": "./dist/index.d.ts",
6
6
  "private": false,