Skip to content

Commit c732625

Browse files
chore(release): prepare runtime 0.2.0
1 parent 8f35aad commit c732625

11 files changed

Lines changed: 79 additions & 21 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22

33
## Unreleased
44

5+
No changes yet.
6+
7+
## 0.2.0 — 2026-09-30
8+
59
- Rename the standalone executable to `bin/runtime`, installed by Composer as `vendor/bin/runtime`; update existing shell and CI scripts when upgrading.
610
- Prevent environment secrets from reaching temporary-directory fallbacks; support private group-readable artifacts.
711
- Add native source-aware environment cache invalidation, mounted secret files, typed requirements and names-only environment comparison.

‎README.md‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,9 @@ PHP **8.5 or newer**, Composer **2.10.3 or newer** with plugin API **2.6 or newe
2828
and a Composer-managed WordPress installation. Composer resolves Runtime's Symfony
2929
8.1 dependencies. WordPress and your application may require additional PHP extensions.
3030

31-
Install the tagged release `0.1.0` and commit the resolved lockfile. The repository
31+
Install the tagged release `0.2.0` and commit the resolved lockfile. The repository
3232
is private, so use an authorized GitHub account or a repository-scoped read credential.
33-
Version 0.1.0 is the initial release accepted for the documented SymPress layouts;
34-
review release notes before changing the pinned version.
33+
Review the [upgrade notes](docs/releases/0.2.0.md) before updating an existing site.
3534

3635
## Start here
3736

@@ -41,9 +40,8 @@ For an existing site, start with [Adopting Runtime](docs/migration.md).
4140

4241
Once Runtime is installed, run these commands from your project root:
4342

44-
The examples use the upcoming executable name `runtime`. With the tagged 0.1.0
45-
release, use `sympress-runtime` as the executable name instead; see the
46-
[CLI upgrade note](docs/cli.md).
43+
Version 0.2.0 uses the executable name `runtime`. When upgrading from 0.1.0,
44+
update shell and CI scripts to use this name; see [Command line](docs/cli.md).
4745

4846
```sh
4947
vendor/bin/runtime validate

‎SECURITY.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Do not include production credentials in the report.
66

77
## Supported revisions
88

9-
The initial supported release is `0.1.0`. Fixes are developed on `main` and shipped
9+
The current supported release is `0.2.0`. Fixes are developed on `main` and shipped
1010
as tagged releases. Pin a reviewed release and its lockfile; update deliberately
1111
when a relevant fix is available. The Composer library is restricted to `~2.10.3`;
1212
new minor lines require recovery-matrix validation before widening that constraint.

‎docs/cli.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
Run these commands from the directory containing your project's `composer.json`.
44

5-
The development branch provides `bin/runtime`, installed by Composer as
6-
`vendor/bin/runtime`. This rename is unreleased; version 0.1.0 uses the executable
7-
name `sympress-runtime`. Update shell and CI scripts when upgrading.
5+
Version 0.2.0 provides `bin/runtime`, installed by Composer as `vendor/bin/runtime`.
6+
Version 0.1.0 used the executable name `sympress-runtime`. Update shell and CI
7+
scripts when upgrading; see the [0.2.0 upgrade notes](releases/0.2.0.md).
88

99
```sh
1010
# Inspect configuration without running project providers.

‎docs/configuration.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Configuration
22

3-
This page describes the current development branch. The production operations
4-
options listed in [Unreleased](../CHANGELOG.md#unreleased) are not part of 0.1.0.
3+
This page describes Runtime 0.2.0. See the [upgrade notes](releases/0.2.0.md)
4+
for new options and changed native defaults when moving from 0.1.0.
55

66
Runtime settings describe setup behavior. WordPress environment values such as
77
database credentials and public URLs belong in [environment configuration](environment.md).

‎docs/getting-started.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,8 @@ You need PHP 8.5+, Composer 2.10.3+, a database and a web server. Runtime's priv
55
repository also requires GitHub read access. Keep credentials in Composer's private
66
authentication configuration or an SSH agent, never in `composer.json`.
77

8-
Commands below use the upcoming executable name `runtime`. The example manifest
9-
pins 0.1.0, whose executable is named `sympress-runtime`; substitute that name
10-
until you upgrade to a release containing the rename. See [Command line](cli.md).
8+
Commands below use `runtime`, the executable provided by the pinned 0.2.0 release.
9+
Existing 0.1.0 projects should follow the [upgrade notes](releases/0.2.0.md).
1110

1211
## 1. Describe the project
1312

@@ -24,7 +23,7 @@ cd my-site
2423
composer install
2524
```
2625

27-
The example pins Runtime `0.1.0`. Commit `composer.lock` and deploy with `composer install`, not an unreviewed update.
26+
The example pins Runtime `0.2.0`. Commit `composer.lock` and deploy with `composer install`, not an unreviewed update.
2827

2928
The resulting layout is:
3029

‎docs/migration.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ web-server routes. Adding Runtime does not require a URL change.
1414
Install the package without running setup while preparing the configuration:
1515

1616
```sh
17-
composer require sympress/runtime:0.1.0 --no-plugins --no-scripts
17+
composer require sympress/runtime:0.2.0 --no-plugins --no-scripts
1818
```
1919

2020
The private repository must already be present in Composer's repository

‎docs/operations.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Deployment checks and maintenance
22

3-
These commands and options are unreleased. They will be available in the next
4-
Runtime release; installing 0.1.0 does not include them.
3+
These commands and options require Runtime 0.2.0 or newer. Existing 0.1.0 projects
4+
should first follow the [upgrade notes](releases/0.2.0.md).
55

66
Build once with the regular Composer installers, verify the generated artifacts,
77
then deploy the lockfiles, generated configuration and referenced runtime payload.

‎docs/releases/0.2.0.md‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Upgrading to Runtime 0.2.0
2+
3+
Version 0.2.0 adds production diagnostics, deployment drift checks, download pins
4+
and crash recovery. PHP 8.5+, Composer 2.10.3+ and the reviewed Composer library
5+
line remain required. Read the [changelog](../../CHANGELOG.md) for the full list.
6+
7+
## Update the package and command paths
8+
9+
Change shell scripts and CI jobs from `vendor/bin/sympress-runtime` to
10+
`vendor/bin/runtime`. The old executable is no longer shipped. Composer commands
11+
such as `composer sympress-runtime` and configuration keys keep their names.
12+
13+
Update in your development or build environment, review the resulting lockfile
14+
and generated files, then deploy that reviewed build:
15+
16+
```sh
17+
composer require sympress/runtime:0.2.0 --no-plugins --no-scripts
18+
composer install --no-interaction
19+
vendor/bin/runtime validate
20+
vendor/bin/runtime --no-interaction
21+
```
22+
23+
If deployment uses a prebuilt environment dump, rebuild it for the intended
24+
environment before deployment. Do not distribute a development dump to production.
25+
Keep the referenced `var/runtime` payload with the generated configuration as
26+
described in [Deployment](../deployment.md).
27+
28+
## Review native defaults
29+
30+
- Environment caching defaults to `auto` and invalidates on source path, size or
31+
modification-time changes. Production dumps remain immutable until rebuilt.
32+
- `composer-managed: auto` disables dashboard file modifications and automatic
33+
updates in staging/production through the generated section. Existing constants
34+
take precedence; explicitly configure `false` if updates are managed elsewhere.
35+
- Native URL downloads create `sympress-runtime.lock`. Review and commit it, and
36+
use `--update-lock` deliberately when changing downloaded artifacts.
37+
- Native `db-check: health` no longer scans every table during setup. Schedule
38+
`vendor/bin/runtime doctor --database-health` explicitly; `--quick` is available.
39+
- Doctor requires explicit `WP_HOME` in staging/production. Its production profile
40+
requires HTTPS and reports opaque bootstrap code or unproven permissions as
41+
unknown, rather than certifying them.
42+
43+
Compatibility profiles retain their documented defaults. The generated-file mode
44+
still defaults to `0600`; use `generated-file-mode: "0640"` with appropriate group
45+
ownership when deployment and PHP run as different users.
46+
47+
## Establish deployment checks
48+
49+
Run setup successfully before using `--check` or `--dry-run`: drift detection needs
50+
the generated baseline. Custom setup side effects can produce an unknown result.
51+
Use [production operations](../operations.md) for deployment gates, typed required
52+
variables, mounted secrets, names-only environment comparison and pruning.
53+
54+
Interrupted supported package moves now recover through a private journal.
55+
Keep pending journals and owned backups intact until recovery completes. Pruning
56+
retains active payloads and refuses unknown ownership or pending recovery state.
57+
The supported layout boundaries remain documented in [Deployment](../deployment.md).

‎examples/site/composer.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"type": "project",
44
"require": {
55
"php": "^8.5",
6-
"sympress/runtime": "0.1.0",
6+
"sympress/runtime": "0.2.0",
77
"johnpbloch/wordpress-core": "^7.1",
88
"johnpbloch/wordpress-core-installer": "^2.0",
99
"composer/installers": "^2.3"

0 commit comments

Comments
 (0)