chore: add release packaging workflow

Author: nariyanto

.distignore

@@ -1,6 +1,8 @@
 .git/
 .github/
+dist/
 docs/
+scripts/
 tests/
 vendor/
 .phpunit.cache/

.github/workflows/ci.yml

@@ -24,5 +24,8 @@ jobs:
       - name: Run tests
         run: php tests/run.php
 
+      - name: Validate readme metadata
+        run: php tests/validate-readme.php
+
       - name: Lint PHP files
         run: find . -path ./vendor -prune -o -name '*.php' -print0 | xargs -0 -n1 php -l

.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+
+jobs:
+  build-release-zip:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          coverage: none
+
+      - name: Run tests
+        run: php tests/run.php
+
+      - name: Validate readme metadata
+        run: php tests/validate-readme.php
+
+      - name: Lint PHP files
+        run: find . -path ./vendor -prune -o -name '*.php' -print0 | xargs -0 -n1 php -l
+
+      - name: Build plugin ZIP
+        run: bash scripts/build-release.sh
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: cron-inspector-lite
+          path: dist/cron-inspector-lite.zip
+
+      - name: Publish GitHub release asset
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/cron-inspector-lite.zip
+          generate_release_notes: true

.gitignore

@@ -1,4 +1,5 @@
 /vendor/
 /.phpunit.cache/
+/dist/
 *.log
 .DS_Store

CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to Cron Inspector Lite will be documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses semantic versioning for GitHub releases.
+
+## [0.1.0] - 2026-06-02
+
+### Added
+
+- Read-only admin page under **Tools → Cron Inspector**.
+- Scheduled WP-Cron event list with hook, next run time, schedule, interval, and flags.
+- Duplicate hook detection for support/debugging workflows.
+- Unusually frequent recurring hook detection for intervals shorter than one hour.
+- Overdue event counting.
+- Copyable plain-text support report.
+- Translation template for the `cron-inspector-lite` text domain.
+- Local PHP test runner and GitHub Actions CI.
+
+### Notes
+
+- Version 0.1.0 does not delete, reschedule, or mutate cron events.
+- The plugin does not send data to external services.

README.md

@@ -22,9 +22,17 @@ This plugin is read-only in the initial version. It lists scheduled WP-Cron even
 
 ```bash
 php tests/run.php
+php tests/validate-readme.php
 find . -path ./vendor -prune -o -name '*.php' -print0 | xargs -0 -n1 php -l
+bash scripts/build-release.sh
 ```
 
+The release package is written to `dist/cron-inspector-lite.zip`.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
 ## License
 
 GPL-2.0-or-later

composer.json

@@ -10,7 +10,9 @@
   },
   "scripts": {
     "test": "php tests/run.php",
-    "lint": "find . -path ./vendor -prune -o -name '*.php' -print0 | xargs -0 -n1 php -l"
+    "validate-readme": "php tests/validate-readme.php",
+    "lint": "find . -path ./vendor -prune -o -name '*.php' -print0 | xargs -0 -n1 php -l",
+    "build-release": "bash scripts/build-release.sh"
   },
   "require": {
     "php": ">=7.4"

docs/wporg-publishing-checklist.md

@@ -8,7 +8,8 @@ Plugin slug target: `cron-inspector-lite`
 - Public GitHub repository exists.
 - Plugin has been tested on the staging site `peepso.nariyanto.id`.
 - Plugin is read-only and does not delete or mutate cron events.
-- CI runs PHP tests and PHP syntax checks.
+- CI runs PHP tests, readme metadata validation, and PHP syntax checks.
+- Release workflow builds `dist/cron-inspector-lite.zip` for GitHub release assets.
 - A screenshot from the staging site is available in `docs/screenshots/` for GitHub documentation.
 - Translation template exists at `languages/cron-inspector-lite.pot`.
 

scripts/build-release.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PLUGIN_SLUG="cron-inspector-lite"
+DIST_DIR="$ROOT_DIR/dist"
+BUILD_DIR="$DIST_DIR/build"
+PACKAGE_DIR="$BUILD_DIR/$PLUGIN_SLUG"
+ZIP_PATH="$DIST_DIR/$PLUGIN_SLUG.zip"
+
+rm -rf "$BUILD_DIR" "$ZIP_PATH"
+mkdir -p "$PACKAGE_DIR" "$DIST_DIR"
+
+copy_file() {
+  local src="$1"
+  local dest="$PACKAGE_DIR/$src"
+  mkdir -p "$(dirname "$dest")"
+  cp "$ROOT_DIR/$src" "$dest"
+}
+
+copy_file "cron-inspector-lite.php"
+copy_file "readme.txt"
+copy_file "CHANGELOG.md"
+copy_file "languages/cron-inspector-lite.pot"
+copy_file "src/AdminPage.php"
+copy_file "src/CronEventInspector.php"
+
+python3 - "$BUILD_DIR" "$ZIP_PATH" "$PLUGIN_SLUG" <<'PY'
+import sys
+import zipfile
+from pathlib import Path
+
+build_dir = Path(sys.argv[1])
+zip_path = Path(sys.argv[2])
+plugin_slug = sys.argv[3]
+
+with zipfile.ZipFile(zip_path, 'w', compression=zipfile.ZIP_DEFLATED) as archive:
+    for path in sorted((build_dir / plugin_slug).rglob('*')):
+        if path.is_file():
+            archive.write(path, path.relative_to(build_dir))
+PY
+
+printf 'Built %s\n' "$ZIP_PATH"

tests/validate-readme.php

@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+$root = dirname(__DIR__);
+$readme = file_get_contents($root . '/readme.txt');
+$plugin = file_get_contents($root . '/cron-inspector-lite.php');
+
+if (false === $readme || false === $plugin) {
+    fwrite(STDERR, "Unable to read plugin metadata files.\n");
+    exit(1);
+}
+
+$failures = [];
+
+$required_readme_patterns = [
+    '/^=== Cron Inspector Lite ===$/m' => 'readme plugin title',
+    '/^Contributors:\s*nariyanto$/m' => 'readme contributors',
+    '/^Requires at least:\s*6\.0$/m' => 'minimum WordPress version',
+    '/^Requires PHP:\s*7\.4$/m' => 'minimum PHP version',
+    '/^Stable tag:\s*0\.1\.0$/m' => 'stable tag',
+    '/^License:\s*GPLv2 or later$/m' => 'license',
+    '/== Changelog ==/' => 'changelog section',
+    '/= 0\.1\.0 =/' => '0.1.0 changelog entry',
+];
+
+foreach ($required_readme_patterns as $pattern => $label) {
+    if (1 !== preg_match($pattern, $readme)) {
+        $failures[] = "Missing or invalid {$label}.";
+    }
+}
+
+$required_plugin_patterns = [
+    '/Plugin Name:\s*Cron Inspector Lite/' => 'plugin name',
+    '/Version:\s*0\.1\.0/' => 'plugin version',
+    '/Text Domain:\s*cron-inspector-lite/' => 'text domain',
+    '/Domain Path:\s*\/languages/' => 'domain path',
+    '/Requires at least:\s*6\.0/' => 'plugin minimum WordPress version',
+    '/Requires PHP:\s*7\.4/' => 'plugin minimum PHP version',
+    '/License:\s*GPL-2\.0-or-later/' => 'plugin license',
+];
+
+foreach ($required_plugin_patterns as $pattern => $label) {
+    if (1 !== preg_match($pattern, $plugin)) {
+        $failures[] = "Missing or invalid {$label}.";
+    }
+}
+
+if (str_contains($readme, 'wp-cron-inspector-lite')) {
+    $failures[] = 'readme.txt still contains old plugin slug/name text.';
+}
+
+if ($failures) {
+    foreach ($failures as $failure) {
+        fwrite(STDERR, "FAIL: {$failure}\n");
+    }
+    exit(1);
+}
+
+echo "Readme and plugin metadata validation passed.\n";