@plasius/images 1.0.23 → 1.0.25
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
|
@@ -20,6 +20,36 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
|
|
|
20
20
|
- **Security**
|
|
21
21
|
- (placeholder)
|
|
22
22
|
|
|
23
|
+
## [1.0.25] - 2026-10-25
|
|
24
|
+
|
|
25
|
+
- Refresh npm dependency lockfile to current supported stable versions (weekly maintenance, 2026-10-25).
|
|
26
|
+
|
|
27
|
+
- **Added**
|
|
28
|
+
- (placeholder)
|
|
29
|
+
|
|
30
|
+
- **Changed**
|
|
31
|
+
- (placeholder)
|
|
32
|
+
|
|
33
|
+
- **Fixed**
|
|
34
|
+
- (placeholder)
|
|
35
|
+
|
|
36
|
+
- **Security**
|
|
37
|
+
- (placeholder)
|
|
38
|
+
|
|
39
|
+
## [1.0.24] - 2026-10-21
|
|
40
|
+
|
|
41
|
+
- **Added**
|
|
42
|
+
- (placeholder)
|
|
43
|
+
|
|
44
|
+
- **Changed**
|
|
45
|
+
- Restore trusted push-only CI on the approved quarantined self-hosted group, with bounded validation, clean installation, credential isolation and final package admission.
|
|
46
|
+
|
|
47
|
+
- **Fixed**
|
|
48
|
+
- (placeholder)
|
|
49
|
+
|
|
50
|
+
- **Security**
|
|
51
|
+
- (placeholder)
|
|
52
|
+
|
|
23
53
|
## [1.0.23] - 2026-10-18
|
|
24
54
|
|
|
25
55
|
- Refresh npm dependency lockfile to current supported stable versions (weekly maintenance, 2026-10-18).
|
|
@@ -330,17 +360,17 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
|
|
|
330
360
|
|
|
331
361
|
## Release process (maintainers)
|
|
332
362
|
|
|
333
|
-
1.
|
|
334
|
-
2.
|
|
335
|
-
3.
|
|
336
|
-
4.
|
|
337
|
-
5.
|
|
363
|
+
1. Record user-visible changes under **Unreleased**.
|
|
364
|
+
2. Verify public visibility, production environment, npm trusted-publisher identity and the next unused version.
|
|
365
|
+
3. Dispatch `.github/workflows/cd.yml` on `main` with `phase=prepare` and the appropriate `bump`.
|
|
366
|
+
4. Review and merge the pipeline's release metadata PR after its required checks. The pipeline owns version/changelog promotion and release tags.
|
|
367
|
+
5. Verify successful exact-main push CI, hosted production OIDC publication, public registry integrity/provenance and the matching GitHub release.
|
|
338
368
|
|
|
339
|
-
|
|
369
|
+
Never publish locally or manually promote versioned changelog sections. Rollback disables the affected workflow/channel without restoring the administrative registry.
|
|
340
370
|
|
|
341
371
|
---
|
|
342
372
|
|
|
343
|
-
[Unreleased]: https://github.com/Plasius-LTD/images/compare/v1.0.
|
|
373
|
+
[Unreleased]: https://github.com/Plasius-LTD/images/compare/v1.0.25...HEAD
|
|
344
374
|
|
|
345
375
|
## [1.0.0] - 2026-02-11
|
|
346
376
|
|
|
@@ -375,3 +405,5 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
|
|
|
375
405
|
[1.0.21]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.21
|
|
376
406
|
[1.0.22]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.22
|
|
377
407
|
[1.0.23]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.23
|
|
408
|
+
[1.0.24]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.24
|
|
409
|
+
[1.0.25]: https://github.com/Plasius-LTD/images/releases/tag/v1.0.25
|
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.
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
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
|
|
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.
|
package/docs/adrs/index.md
CHANGED
|
@@ -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)
|