Skip to content

Release Nginx Cache 0.3.0: measured KPIs, safe previews and dashboard updates - #16

Merged
brianvarskonst merged 8 commits into
mainfrom
release/v0.3.0
Oct 9, 2026
Merged

brianvarskonst merged 8 commits into
mainfrom
release/v0.3.0

Conversation

@brianvarskonst

@brianvarskonst brianvarskonst commented Oct 9, 2026 •

Copy link
Copy Markdown
Member

The dashboard previously inferred a 100% cache hit rate from directory availability and hid the cause of failed purge previews. This release measures eligible Nginx requests over the last hour, shows the denominator and explicit missing/empty states, and previews expired cache layouts without creating or modifying cache files, sentinels or locks.

The dashboard now uses NGINX green accents, black action buttons, consistent section headings and a responsive metrics panel with collapsed measurement details. Generated Nginx includes support validated cache limits and separate HTTP/server/logging/FastCGI contexts; an exact empty-query map entry restores ordinary anonymous caching. Deferred prewarming runs in durable five-URL batches, checkpoints successful URLs, preserves the failure budget and rejects HTTP errors and redirects.

Prepare v0.3.0 with the existing tagged WordPress archive and Plugin Check workflow. Production archives include the dashboard stylesheet and exclude prototypes and development files. The new local feature-set roadmap is outside this branch and is not included in this PR.

Validation:

  • Local composer qa: coding standards, PHPStan and 71 unit tests / 313 assertions passed.
  • Local composer tests:nginx: nine real HTTP cases passed, including cache-root creation, query maps, JSON metrics and preservation of existing access logs.
  • Previously verified on the local WordPress consumer: all seven settings sections at 320/768/1024/1440px, keyboard navigation, metrics empty/sample states and scoped green/black styling; dry-run cache hashes/mtimes/directories, queue and tag index remained unchanged.
  • Hosted QA, MariaDB/MySQL concurrency, Redis, native Nginx and workflow lint checks passed for exact head ca0a0d76cd526a1a60c9965857e197d67dfc8152: QA run.
  • The pre-release archive and WordPress Plugin Check passed. Packaged entrypoint/autoload, metrics empty state, Nginx includes, source identity, production file identity, exclusions and manifest checksums were checked locally.
  • Post-merge main CI and the tagged archive/Plugin Check passed at 2c2cfd1509f29c3bb9aff4487e25a7d59d2ad681. Release v0.3.0 is published with the ZIP and SHA-256 file; the unauthenticated public download matches the verified archive and all 2,435 manifest checksums. Packagist resolves to the same commit.

Deployment: regenerate the relevant Nginx includes and apply them through the existing server deployment process to enable metrics logging and updated cache rules/limits. The plugin does not reload Nginx. WordPress cron must run reliably to process deferred work.

@brianvarskonst
brianvarskonst merged commit 2c2cfd1 into main Oct 9, 2026
10 checks passed
@brianvarskonst
brianvarskonst deleted the release/v0.3.0 branch October 16, 2026 16:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant