@styleflow.app/flowpress-deploy 1.0.0-beta.0 → 1.0.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.0.0-beta.1
+
+- Added the automatically selected `flowpress-deploy` Core queue provider.
+- Added revision-safe queue, deployed state and batch snapshot tables.
+- Added fingerprint deduplication, WPML post grouping, URI history and safe
+  success/failure/stale-batch handling.
+- Added non-destructive migration from the Core database queue.
+- Added end-of-request enqueue, manual editor actions and the expanded
+  **Strumenti → FlowPress Deploy** operations screen.
+- Added complete internal documentation and PHP queue contract tests.
+
 ## 1.0.0-beta.0
 
 - Adopted the FlowPress WordPress Core v1 Composer contract.

package/README.md

@@ -1,8 +1,9 @@
 # FlowPress Deploy
 
-Installable npm/Composer feature pack for safe Cloudflare Pages and Workers
-build orchestration. CMS partial builds require a successful compatible
-baseline; code and manual triggers remain full builds.
+Installable npm/Composer feature pack for revision-safe editorial queues and
+safe full/partial build orchestration. WordPress owns a durable queue per
+frontend target; frontend workflows keep the existing `batchId`, `target`,
+`mode`, `paths` and `deletedPaths` wire contract.
 
 The public API validates paths and `_routes.json`, merges partial artifacts
 without traversal or case collisions, regenerates sitemaps, selects Pages for
@@ -10,8 +11,24 @@ static targets and Workers for dev, requires `ASTRO_KEY` for protected batches,
 and acknowledges the CMS queue only after deploy and smoke test. Failed
 batches are released for retry.
 
+## WordPress queue
+
+When the Composer package is installed, Deploy automatically becomes the
+FlowPress Core queue provider. It fingerprints content at the end of the
+request, groups WPML translations, keeps current and previous URIs and stores
+a revision snapshot for every dispatched batch. A callback acknowledges only
+the dispatched revision; concurrent editorial changes remain pending.
+
+Editors can use **Aggiungi alla build queue** from edit screens and list rows.
+Administrators operate the queue in **Strumenti → FlowPress Deploy**.
+
+## Documentation
+
+Start with [docs/README.md](docs/README.md). It links configuration, queue
+semantics, frontend integration, operations, recovery and troubleshooting.
+
 ## WordPress Core v1
 
-The `1.0.0-beta.0` line requires FlowPress WordPress Core v1. It does not
+The `1.0.0-beta.x` line requires FlowPress WordPress Core v1. It does not
 provide a v0.x compatibility constraint or adapter; canary applications pin
 the selected Core prerelease exactly.

package/composer.json

@@ -1,6 +1,6 @@
 {
   "name": "flowpress/deploy",
-  "description": "WordPress capability registration for FlowPress deploy.",
+  "description": "Revision-safe editorial build queue and deploy capability for FlowPress.",
   "type": "wordpress-muplugin",
   "license": "proprietary",
   "require": {

package/docs/README.md

@@ -0,0 +1,16 @@
+# FlowPress Deploy: documentazione
+
+FlowPress Deploy collega le modifiche editoriali di WordPress ai workflow di
+build senza salvare token o contenuti nella propria coda.
+
+## Pagine
+
+| Argomento | Documento |
+| --- | --- |
+| Modello e responsabilità | [Architettura](architecture.md) |
+| Variabili richieste | [Configurazione](configuration.md) |
+| Deduplica, URI e revisioni | [Queue WordPress](wordpress-queue.md) |
+| Payload e callback | [Frontend e workflow](frontend-workflow.md) |
+| Uso quotidiano | [Operazioni](operations.md) |
+| Callback mancanti e retry | [Recovery](recovery.md) |
+| Diagnostica | [Troubleshooting](troubleshooting.md) |

package/docs/activities/2026-07-30-2339-initial-pack.md

@@ -0,0 +1,9 @@
+# Release iniziale deploy pack
+
+- Obiettivo: estrarre build full/partial, baseline e guardie Cloudflare.
+- Modifiche: package npm, MU-plugin Composer, test e workflow OIDC.
+- Verifiche: typecheck, 7 test, npm pack, Composer validate e PHP lint positivi.
+- Hardening pre-release: merge sicuro full/partial, sitemap, target
+  Pages/Workers, guardia `ASTRO_KEY` e lifecycle ack/release della queue.
+- Workflow tag idempotente per il bootstrap della prima pubblicazione npm.
+- Release prevista: `0.1.0-beta.0`; resta da configurare il Trusted Publisher npm.

package/docs/activities/2026-08-24-1745-wordpress-core-v1.md

@@ -0,0 +1,40 @@
+# Deploy su WordPress Core v1
+
+## Esito
+
+Preparata la major prerelease `1.0.0-beta.0` npm/Composer con dipendenza
+limitata a `flowpress/wordpress-core ^1.0.0@beta` e senza adapter v0.x. Il
+consumer canary mantiene il pin Core esatto.
+
+## Scope
+
+La logica Deploy non cambia. Versione package, Composer contract, lockfile,
+changelog e documentazione vengono pubblicati dallo stesso tag.
+
+## Verifiche
+
+| Gate | Esito |
+|---|---|
+| `npm ci && npm run release:check` | OK; 7/7 test e pack 9 file |
+| `npm audit` | OK; 0 vulnerabilita' dopo aggiornamento lockfile `nanoid` |
+| `composer validate --strict --no-check-publish` | OK |
+| PHP lint | OK |
+| `git diff --check` | OK |
+
+## Pubblicazione verificata
+
+- PR v1 unita su `main`; merge e `gitHead` npm:
+  `24e0033d78566890263249e56da3c15449e80897`.
+- Workflow Publish `32747502576`: verde con trusted publishing e provenance.
+- npm: `@styleflow.app/flowpress-deploy@1.0.0-beta.0`, dist-tag `next`;
+  integrity, shasum, tarball e firma presenti. `latest` resta sulla linea
+  precedente.
+- Repman: `flowpress/deploy@v1.0.0-beta.0`, sincronizzato dallo stesso tag e
+  con requisito `flowpress/wordpress-core ^1.0.0@beta`.
+- Canary DMO: installazione npm/Composer da registry, manifest coerente e gate
+  completo verde.
+
+## Rollback
+
+La linea `0.1.0-beta.0` resta immutabile. I consumer v1 usano pin esatti e non
+spostano `latest`.

package/docs/activities/2026-08-26-0926-revision-safe-queue.md

@@ -0,0 +1,41 @@
+# FlowPress Deploy: revision-safe editorial queue
+
+- Data: 2026-08-26 09:26 Europe/Rome
+- Repository: `StyleFlow-App/flowpress-deploy`
+- Versione prevista: `1.0.0-beta.1`
+
+## Obiettivo
+
+Rendere Deploy proprietario della queue editoriale tramite il provider Core,
+senza cambiare Core e senza assumere configurazioni Bagful/Cloudflare.
+
+## Modifiche
+
+- Provider automatico, schema queue/state/batch e migrazione Core non
+  distruttiva.
+- Fingerprint, URI history, WPML grouping, snapshot e ack revision-safe.
+- Enqueue a fine richiesta, azioni manuali, UI operativa e GitHub test.
+- Documentazione completa in `docs/` e inclusione nel pacchetto npm.
+
+## Verifiche
+
+- `php tests/php/queue-provider-test.php`: superato.
+- `find . -name '*.php' ... php -l`: superato.
+- `git diff --check`: superato.
+- `composer validate --strict`: superato.
+- `npm run release:check`: superato (typecheck, 7 test Vitest, test PHP,
+  pack dry-run con `docs/` e `includes/`).
+
+## Verifica manuale
+
+La verifica integrata in WordPress DMO sarà registrata nel report DMO; nessun
+dispatch o deploy remoto è autorizzato in questo task.
+
+## Commit suggerito
+
+`feat: add revision-safe editorial build queue`
+
+## Rischi e follow-up
+
+Il rollout richiede configurazione remota dei token e un test editoriale
+controllato prima di abilitare la pubblicazione production.

package/docs/activities/README.md

@@ -0,0 +1,5 @@
+# Indice attività
+
+- [2026-08-26-0926-revision-safe-queue.md](2026-08-26-0926-revision-safe-queue.md)
+- [2026-08-24-1745-wordpress-core-v1.md](2026-08-24-1745-wordpress-core-v1.md)
+- [2026-07-30-2339-initial-pack.md](2026-07-30-2339-initial-pack.md)

package/docs/architecture.md

@@ -0,0 +1,19 @@
+# Architettura
+
+## Perché
+
+Core espone il contratto di dispatch e callback; Deploy possiede lo stato
+editoriale necessario a non perdere aggiornamenti concorrenti.
+
+## Come funziona
+
+1. Il plugin registra il provider `flowpress-deploy` e lo seleziona.
+2. Gli hook Core inoltrano post, termini e modifiche globali al provider.
+3. Gli update vengono materializzati a `shutdown`, dopo meta e tassonomie.
+4. Le tabelle `flowpress_deploy_queue`, `flowpress_deploy_state` e
+   `flowpress_deploy_batches` conservano rispettivamente lavoro, ultimo stato
+   distribuito e snapshot immutabile del batch.
+5. Core effettua repository dispatch e callback usando il wire contract
+   pubblico. Deploy applica l’ack alla sola revisione fotografata.
+
+La coda conserva hash SHA-256 e URI, non il contenuto completo o credenziali.

package/docs/configuration.md

@@ -0,0 +1,19 @@
+# Configurazione
+
+## Perché
+
+Target e credenziali sono configurazione di ambiente e non devono finire nel
+database WordPress.
+
+## Come fare
+
+1. Definire `SF_STATIC_TARGETS_JSON`, per esempio `['production']` in JSON
+   valido.
+2. Definire `GITHUB_REPOSITORY_SLUG=organizzazione/repository`.
+3. Definire `CMS_GITHUB_DISPATCH_TOKEN` con il minimo accesso necessario al
+   repository.
+4. Definire `CMS_BUILD_CALLBACK_TOKEN` sia nel backend sia nel workflow.
+5. Aprire **Strumenti → FlowPress Deploy**: lo stato indica soltanto presenza
+   o assenza dei token, mai il loro valore.
+
+⚠️ Un target deve corrispondere esattamente a quello gestito dal workflow.

package/docs/frontend-workflow.md

@@ -0,0 +1,23 @@
+# Frontend e workflow
+
+## Wire contract
+
+Il repository dispatch riceve:
+
+```json
+{
+  "batchId": "uuid",
+  "target": "production",
+  "mode": "partial",
+  "paths": ["/pagina/"],
+  "deletedPaths": ["/vecchio-slug/"],
+  "queueIds": [12]
+}
+```
+
+Il workflow deve chiamare `POST /flowpress/v1/build-complete` con bearer token
+e body `{"batchId":"uuid","status":"success"}` soltanto dopo build, deploy
+e smoke test. In ogni altro caso invia `failure`.
+
+⚠️ L’assenza del callback non equivale a successo: il batch resta in-flight e
+sarà rilasciato dal recovery.

package/docs/operations.md

@@ -0,0 +1,15 @@
+# Operazioni
+
+## Come fare
+
+1. Aprire **Strumenti → FlowPress Deploy**.
+2. Verificare repository, token, righe pending, URI e batch in-flight.
+3. Espandere **Payload preview** prima dell’invio.
+4. Usare **Pubblica queue** per la modalità prevista.
+5. Usare **Force full** soltanto quando baseline o codice richiedono una build
+   completa; il browser chiede conferma.
+6. Per forzare un singolo contenuto usare **Aggiungi alla build queue** nella
+   schermata o nella lista di post/termini.
+
+Il pulsante **Test GitHub** verifica autenticazione e accesso al repository,
+senza inviare un deployment.

package/docs/recovery.md

@@ -0,0 +1,16 @@
+# Recovery
+
+## Callback failure
+
+1. Il callback `failure` libera il batch.
+2. Le righe tornano pending mantenendo l’ultima revisione editoriale.
+3. Correggere la causa nel workflow e ripubblicare la queue.
+
+## Callback mancante
+
+1. Il cron orario cerca batch in-flight più vecchi di sei ore.
+2. Il batch viene rilasciato come failure.
+3. Il limite è modificabile con `flowpress_deploy_stale_batch_hours`.
+
+⚠️ Non cancellare manualmente righe delle tre tabelle: si perderebbe la
+corrispondenza fra stato distribuito e snapshot. Usare callback/retry.

package/docs/troubleshooting.md

@@ -0,0 +1,22 @@
+# Troubleshooting
+
+## Queue vuota
+
+Controllare `SF_STATIC_TARGETS_JSON`, tipo di contenuto instradabile e che il
+salvataggio non sia autosave/revisione. Un salvataggio identico è correttamente
+deduplicato.
+
+## URI vecchio non eliminato
+
+Controllare `previous_uris` nella pagina Deploy e che il workflow consumi
+`deletedPaths`.
+
+## Batch sempre in-flight
+
+Verificare token callback e log del workflow. Attendere il recovery oppure
+inviare esplicitamente `failure` per il `batchId` corretto.
+
+## GitHub rifiuta il test
+
+Verificare slug repository, scadenza e permessi del token. La pagina non mostra
+né registra il segreto.

package/docs/wordpress-queue.md

@@ -0,0 +1,22 @@
+# Queue WordPress
+
+## Perché
+
+Salvataggi ripetuti, traduzioni e cambi slug non devono produrre build inutili
+o lasciare file vecchi online.
+
+## Come funziona
+
+1. Autosave e revisioni sono esclusi da Core.
+2. Deploy raggruppa per post/term ID; con WPML usa il translation group.
+3. Il fingerprint include contenuto, meta non volatili e tassonomie. Il filtro
+   `flowpress_deploy_volatile_meta_keys` aggiunge esclusioni.
+4. `flowpress_deploy_fingerprint_fields`, `flowpress_deploy_group_key` e
+   `flowpress_deploy_canonical_uris` permettono estensioni senza patch.
+5. `previous_uris` resta ancorato allo stato distribuito: uno slug change
+   produce il nuovo path e inserisce quello vecchio in `deletedPaths`.
+6. Una modifica durante un batch incrementa la revisione. Il callback completa
+   lo snapshot, ma rimette la revisione nuova in pending.
+
+La prima installazione importa le righe Core senza cancellarle; ogni vecchio
+batch in-flight viene importato come pending per un retry sicuro.

package/flowpress-deploy.php

@@ -1,21 +1,49 @@
 <?php
 /**
  * Plugin Name: FlowPress Deploy
- * Description: Installable deployment capability for FlowPress.
- * Version: 0.1.0-beta.0
+ * Description: Revision-safe editorial build queue and deployment capability for FlowPress.
+ * Version: 1.0.0-beta.1
  */
 
 if (! defined('ABSPATH')) {
     exit;
 }
 
+define('FLOWPRESS_DEPLOY_VERSION', '1.0.0-beta.1');
+define('FLOWPRESS_DEPLOY_FILE', __FILE__);
+
+require_once __DIR__ . '/includes/queue-provider.php';
+require_once __DIR__ . '/includes/manual-queue.php';
+require_once __DIR__ . '/includes/admin.php';
+
+add_action('muplugins_loaded', static function (): void {
+    if (! function_exists('flowpress_register_build_queue_provider')) {
+        return;
+    }
+    flowpress_register_build_queue_provider('flowpress-deploy', [
+        'enqueue' => 'flowpress_deploy_collect_change',
+        'payload' => 'flowpress_deploy_build_payload',
+        'markDispatched' => 'flowpress_deploy_mark_dispatched',
+        'complete' => 'flowpress_deploy_complete_batch',
+        'pendingCount' => 'flowpress_deploy_pending_count',
+    ]);
+}, 110);
+
+add_filter('flowpress_build_queue_provider', static fn (): string => 'flowpress-deploy', 100);
+
 add_action('muplugins_loaded', static function (): void {
     if (! function_exists('flowpress_register_feature')) {
         return;
     }
     flowpress_register_feature('deploy', [
-        'version' => '0.1.0-beta.0',
-        'capabilities' => ['full-build', 'partial-build', 'build-callback'],
+        'version' => FLOWPRESS_DEPLOY_VERSION,
+        'capabilities' => [
+            'full-build',
+            'partial-build',
+            'build-callback',
+            'revision-safe-queue',
+            'manual-enqueue',
+        ],
         'config' => [
             'targets' => function_exists('flowpress_static_targets')
                 ? flowpress_static_targets()

package/includes/admin.php

@@ -0,0 +1,110 @@
+<?php
+
+if (! defined('ABSPATH')) {
+    exit;
+}
+
+add_action('admin_menu', static function (): void {
+    remove_submenu_page('tools.php', 'flowpress-builds');
+    add_management_page(
+        'FlowPress Deploy',
+        'FlowPress Deploy',
+        'manage_options',
+        'flowpress-builds',
+        'flowpress_deploy_render_admin_page'
+    );
+}, 100);
+
+add_action('admin_post_flowpress_deploy_test_github', static function (): void {
+    if (! current_user_can('manage_options')) {
+        wp_die('Forbidden', 403);
+    }
+    check_admin_referer('flowpress_deploy_test_github');
+    $repository = flowpress_env('GITHUB_REPOSITORY_SLUG');
+    $token = flowpress_env('CMS_GITHUB_DISPATCH_TOKEN');
+    $response = ($repository !== '' && $token !== '')
+        ? wp_remote_get('https://api.github.com/repos/' . $repository, [
+            'timeout' => 15,
+            'headers' => [
+                'Accept' => 'application/vnd.github+json',
+                'Authorization' => 'Bearer ' . $token,
+                'User-Agent' => 'FlowPress-Deploy/' . FLOWPRESS_DEPLOY_VERSION,
+            ],
+        ])
+        : new WP_Error('missing_config', 'Configurazione GitHub incompleta.');
+    $ok = ! is_wp_error($response) && wp_remote_retrieve_response_code($response) === 200;
+    set_transient('flowpress_build_notice_' . get_current_user_id(), [
+        'type' => $ok ? 'success' : 'error',
+        'message' => $ok ? 'Connessione GitHub verificata.' : (is_wp_error($response) ? $response->get_error_message() : 'GitHub ha rifiutato la richiesta.'),
+    ], 60);
+    wp_safe_redirect(admin_url('tools.php?page=flowpress-builds'));
+    exit;
+});
+
+function flowpress_deploy_render_admin_page(): void
+{
+    if (! current_user_can('manage_options')) {
+        return;
+    }
+    global $wpdb;
+    $notice = get_transient('flowpress_build_notice_' . get_current_user_id());
+    delete_transient('flowpress_build_notice_' . get_current_user_id());
+    $repository = flowpress_env('GITHUB_REPOSITORY_SLUG');
+    $has_dispatch_token = flowpress_env('CMS_GITHUB_DISPATCH_TOKEN') !== '';
+    $has_callback_token = flowpress_env('CMS_BUILD_CALLBACK_TOKEN') !== '';
+    echo '<div class="wrap"><h1>FlowPress Deploy</h1>';
+    if (is_array($notice)) {
+        printf('<div class="notice notice-%s"><p>%s</p></div>', esc_attr((string) $notice['type']), esc_html((string) $notice['message']));
+    }
+    echo '<p>La coda è deduplicata per contenuto logico e target. I token non vengono salvati né mostrati.</p>';
+    echo '<table class="widefat striped" style="max-width:900px"><tbody>';
+    printf('<tr><th>Repository GitHub</th><td>%s</td></tr>', esc_html($repository !== '' ? $repository : 'non configurato'));
+    printf('<tr><th>Token dispatch</th><td>%s</td></tr>', $has_dispatch_token ? 'configurato' : 'mancante');
+    printf('<tr><th>Token callback</th><td>%s</td></tr>', $has_callback_token ? 'configurato' : 'mancante');
+    echo '</tbody></table>';
+    echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="margin:16px 0">';
+    wp_nonce_field('flowpress_deploy_test_github');
+    echo '<input type="hidden" name="action" value="flowpress_deploy_test_github">';
+    submit_button('Test GitHub', 'secondary', 'submit', false);
+    echo '</form>';
+    foreach (flowpress_static_targets() as $target) {
+        $payload = flowpress_deploy_build_payload($target, false);
+        $rows = (array) $wpdb->get_results($wpdb->prepare(
+            'SELECT * FROM ' . flowpress_deploy_queue_table() . ' WHERE target = %s ORDER BY updated_at DESC LIMIT 100',
+            $target
+        ), ARRAY_A);
+        $in_flight = (int) $wpdb->get_var($wpdb->prepare(
+            "SELECT COUNT(*) FROM " . flowpress_deploy_batch_table() . " WHERE target = %s AND status = 'in_flight'",
+            $target
+        ));
+        echo '<section style="margin:20px 0;padding:16px;background:#fff;border:1px solid #ccd0d4">';
+        printf('<h2>%s <small>(%d pending, %d in-flight)</small></h2>', esc_html($target), flowpress_deploy_pending_count($target), $in_flight);
+        echo '<p>Modalità prevista: <strong>' . esc_html($payload['mode']) . '</strong></p>';
+        echo '<details><summary>Payload preview</summary><pre style="white-space:pre-wrap">' . esc_html((string) wp_json_encode($payload, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES)) . '</pre></details>';
+        echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="display:inline-block;margin:12px 8px 12px 0">';
+        wp_nonce_field('flowpress_publish_build');
+        echo '<input type="hidden" name="action" value="flowpress_publish_build"><input type="hidden" name="target" value="' . esc_attr($target) . '">';
+        submit_button('Pubblica queue', 'primary', 'submit', false);
+        echo '</form>';
+        echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="display:inline-block" onsubmit="return confirm(\'Confermi la build completa?\')">';
+        wp_nonce_field('flowpress_publish_build');
+        echo '<input type="hidden" name="action" value="flowpress_publish_build"><input type="hidden" name="target" value="' . esc_attr($target) . '"><input type="hidden" name="force_full" value="1">';
+        submit_button('Force full', 'secondary', 'submit', false);
+        echo '</form>';
+        if ($rows !== []) {
+            echo '<table class="widefat striped"><thead><tr><th>Gruppo</th><th>URI correnti</th><th>URI precedenti</th><th>Rev.</th><th>Stato</th></tr></thead><tbody>';
+            foreach ($rows as $row) {
+                printf('<tr><td>%s</td><td>%s</td><td>%s</td><td>%d</td><td>%s</td></tr>',
+                    esc_html((string) $row['group_key']),
+                    esc_html(implode(', ', flowpress_deploy_decode_uris($row['current_uris'])) ?: '—'),
+                    esc_html(implode(', ', flowpress_deploy_decode_uris($row['previous_uris'])) ?: '—'),
+                    (int) $row['revision'],
+                    $row['batch_id'] ? 'in-flight' : 'pending'
+                );
+            }
+            echo '</tbody></table>';
+        }
+        echo '</section>';
+    }
+    echo '</div>';
+}

package/includes/manual-queue.php

@@ -0,0 +1,78 @@
+<?php
+
+if (! defined('ABSPATH')) {
+    exit;
+}
+
+function flowpress_deploy_manual_url(string $type, int $id): string
+{
+    return wp_nonce_url(
+        admin_url('admin-post.php?action=flowpress_deploy_enqueue&type=' . rawurlencode($type) . '&id=' . $id),
+        'flowpress_deploy_enqueue_' . $type . '_' . $id
+    );
+}
+
+function flowpress_deploy_post_action(array $actions, WP_Post $post): array
+{
+    if (current_user_can('edit_post', $post->ID)) {
+        $actions['flowpress_deploy_enqueue'] = '<a href="' . esc_url(flowpress_deploy_manual_url('post', $post->ID)) . '">Aggiungi alla build queue</a>';
+    }
+    return $actions;
+}
+add_filter('post_row_actions', 'flowpress_deploy_post_action', 20, 2);
+add_filter('page_row_actions', 'flowpress_deploy_post_action', 20, 2);
+
+add_action('post_submitbox_misc_actions', static function (WP_Post $post): void {
+    if (! current_user_can('edit_post', $post->ID)) {
+        return;
+    }
+    echo '<div class="misc-pub-section"><a class="button" href="'
+        . esc_url(flowpress_deploy_manual_url('post', $post->ID))
+        . '">Aggiungi alla build queue</a></div>';
+});
+
+add_filter('term_row_actions', static function (array $actions, WP_Term $term): array {
+    $taxonomy = get_taxonomy($term->taxonomy);
+    if ($taxonomy && current_user_can($taxonomy->cap->edit_terms)) {
+        $actions['flowpress_deploy_enqueue'] = '<a href="'
+            . esc_url(flowpress_deploy_manual_url('term-' . $term->taxonomy, $term->term_id))
+            . '">Aggiungi alla build queue</a>';
+    }
+    return $actions;
+}, 20, 2);
+
+add_action('admin_post_flowpress_deploy_enqueue', static function (): void {
+    $type = sanitize_key((string) ($_GET['type'] ?? ''));
+    $id = max(0, (int) ($_GET['id'] ?? 0));
+    check_admin_referer('flowpress_deploy_enqueue_' . $type . '_' . $id);
+    $uri = '';
+    $resource_type = '';
+    if ($type === 'post' && current_user_can('edit_post', $id)) {
+        $post = get_post($id);
+        if ($post instanceof WP_Post) {
+            $resource_type = $post->post_type;
+            $uri = (string) get_permalink($post);
+        }
+    } elseif (str_starts_with($type, 'term-')) {
+        $taxonomy = substr($type, 5);
+        $object = get_taxonomy($taxonomy);
+        if ($object && current_user_can($object->cap->edit_terms)) {
+            $term = get_term($id, $taxonomy);
+            $link = $term instanceof WP_Term ? get_term_link($term) : '';
+            if (! is_wp_error($link)) {
+                $resource_type = $taxonomy;
+                $uri = (string) $link;
+            }
+        }
+    }
+    if ($resource_type === '' || $uri === '') {
+        wp_die('Forbidden', 403);
+    }
+    flowpress_deploy_enqueue_change($resource_type, $id, $uri, 'update', false);
+    set_transient('flowpress_build_notice_' . get_current_user_id(), [
+        'type' => 'success',
+        'message' => 'Contenuto aggiunto alla build queue.',
+    ], 60);
+    wp_safe_redirect(wp_get_referer() ?: admin_url('tools.php?page=flowpress-builds'));
+    exit;
+});

package/includes/queue-provider.php

@@ -0,0 +1,619 @@
+<?php
+
+if (! defined('ABSPATH')) {
+    exit;
+}
+
+function flowpress_deploy_queue_table(): string
+{
+    global $wpdb;
+    return $wpdb->prefix . 'flowpress_deploy_queue';
+}
+
+function flowpress_deploy_state_table(): string
+{
+    global $wpdb;
+    return $wpdb->prefix . 'flowpress_deploy_state';
+}
+
+function flowpress_deploy_batch_table(): string
+{
+    global $wpdb;
+    return $wpdb->prefix . 'flowpress_deploy_batches';
+}
+
+function flowpress_deploy_install_schema(): void
+{
+    if (! function_exists('flowpress_wordpress_ready') || ! flowpress_wordpress_ready()) {
+        return;
+    }
+    if (get_option('flowpress_deploy_schema') === '1') {
+        return;
+    }
+
+    global $wpdb;
+    require_once ABSPATH . 'wp-admin/includes/upgrade.php';
+    $charset = $wpdb->get_charset_collate();
+    $queue = flowpress_deploy_queue_table();
+    $state = flowpress_deploy_state_table();
+    $batches = flowpress_deploy_batch_table();
+    dbDelta("CREATE TABLE {$queue} (
+        id bigint unsigned NOT NULL AUTO_INCREMENT,
+        target varchar(64) NOT NULL,
+        group_key varchar(191) NOT NULL,
+        resource_type varchar(64) NOT NULL,
+        resource_id bigint unsigned NOT NULL DEFAULT 0,
+        current_uris longtext NOT NULL,
+        previous_uris longtext NOT NULL,
+        fingerprint char(64) NOT NULL,
+        revision bigint unsigned NOT NULL DEFAULT 1,
+        force_full tinyint(1) NOT NULL DEFAULT 0,
+        batch_id varchar(64) NULL,
+        dispatched_revision bigint unsigned NULL,
+        dispatched_at datetime NULL,
+        created_at datetime NOT NULL,
+        updated_at datetime NOT NULL,
+        PRIMARY KEY (id),
+        UNIQUE KEY target_group (target, group_key),
+        KEY batch_id (batch_id),
+        KEY target_pending (target, batch_id)
+    ) {$charset};");
+    dbDelta("CREATE TABLE {$state} (
+        target varchar(64) NOT NULL,
+        group_key varchar(191) NOT NULL,
+        current_uris longtext NOT NULL,
+        fingerprint char(64) NOT NULL,
+        revision bigint unsigned NOT NULL DEFAULT 0,
+        updated_at datetime NOT NULL,
+        PRIMARY KEY (target, group_key)
+    ) {$charset};");
+    dbDelta("CREATE TABLE {$batches} (
+        batch_id varchar(64) NOT NULL,
+        target varchar(64) NOT NULL,
+        mode varchar(16) NOT NULL,
+        snapshot longtext NOT NULL,
+        status varchar(16) NOT NULL DEFAULT 'in_flight',
+        created_at datetime NOT NULL,
+        completed_at datetime NULL,
+        PRIMARY KEY (batch_id),
+        KEY status_created (status, created_at)
+    ) {$charset};");
+    update_option('flowpress_deploy_schema', '1', false);
+    flowpress_deploy_migrate_core_queue();
+}
+add_action('init', 'flowpress_deploy_install_schema', 0);
+
+/** @return list<string> */
+function flowpress_deploy_decode_uris(mixed $value): array
+{
+    $decoded = is_array($value) ? $value : json_decode((string) $value, true);
+    if (! is_array($decoded)) {
+        return [];
+    }
+    $uris = [];
+    foreach ($decoded as $uri) {
+        if (! is_string($uri) || $uri === '') {
+            continue;
+        }
+        $normalized = function_exists('flowpress_normalize_uri')
+            ? flowpress_normalize_uri($uri)
+            : (string) (wp_parse_url($uri, PHP_URL_PATH) ?: '/');
+        $uris[$normalized] = true;
+    }
+    $uris = array_keys($uris);
+    sort($uris, SORT_STRING);
+    return $uris;
+}
+
+function flowpress_deploy_json(array $value): string
+{
+    return (string) wp_json_encode(array_values($value), JSON_UNESCAPED_SLASHES);
+}
+
+/** @return array{paths:list<string>,deletedPaths:list<string>} */
+function flowpress_deploy_route_delta(array $previous, array $current): array
+{
+    $previous = flowpress_deploy_decode_uris($previous);
+    $current = flowpress_deploy_decode_uris($current);
+    return [
+        'paths' => $current,
+        'deletedPaths' => array_values(array_diff($previous, $current)),
+    ];
+}
+
+function flowpress_deploy_ack_action(string $status, int $current_revision, int $snapshot_revision): string
+{
+    if ($status !== 'success') {
+        return 'release';
+    }
+    return $current_revision === $snapshot_revision ? 'delete' : 'release';
+}
+
+/** @return array{resourceType:string,resourceId:int,uri:string,operation:string,forceFull:bool,target:string} */
+function flowpress_deploy_normalize_legacy_row(array $row): array
+{
+    return [
+        'resourceType' => sanitize_key((string) ($row['resource_type'] ?? 'legacy')) ?: 'legacy',
+        'resourceId' => max(0, (int) ($row['resource_id'] ?? 0)),
+        'uri' => (string) ($row['uri'] ?? '/'),
+        'operation' => ($row['operation'] ?? '') === 'delete' ? 'delete' : 'update',
+        'forceFull' => ! empty($row['force_full']),
+        'target' => sanitize_key((string) ($row['target'] ?? '')),
+    ];
+}
+
+/** @return array{groupKey:string,resourceType:string,resourceId:int,uris:list<string>,fingerprint:string} */
+function flowpress_deploy_describe_resource(string $resource_type, int $resource_id, string $fallback_uri): array
+{
+    $resource_type = sanitize_key($resource_type);
+    $group_key = $resource_type . ':' . max(0, $resource_id);
+    $uris = flowpress_deploy_decode_uris([$fallback_uri]);
+    $fingerprint_fields = [
+        'resourceType' => $resource_type,
+        'resourceId' => $resource_id,
+    ];
+
+    $post = $resource_id > 0 ? get_post($resource_id) : null;
+    if ($post instanceof WP_Post) {
+        $element_type = 'post_' . $post->post_type;
+        $trid = apply_filters('wpml_element_trid', null, $resource_id, $element_type);
+        if (is_numeric($trid) && (int) $trid > 0) {
+            $group_key = 'wpml:' . $element_type . ':' . (int) $trid;
+        }
+        $translations = is_numeric($trid)
+            ? apply_filters('wpml_get_element_translations', [], (int) $trid, $element_type)
+            : [];
+        $post_ids = [$resource_id];
+        if (is_array($translations)) {
+            foreach ($translations as $translation) {
+                $translated_id = is_object($translation) ? ($translation->element_id ?? 0) : 0;
+                if ((int) $translated_id > 0) {
+                    $post_ids[] = (int) $translated_id;
+                }
+            }
+        }
+        $post_ids = array_values(array_unique($post_ids));
+        sort($post_ids, SORT_NUMERIC);
+        $uris = [];
+        $posts = [];
+        foreach ($post_ids as $post_id) {
+            $translated = get_post($post_id);
+            if (! $translated instanceof WP_Post) {
+                continue;
+            }
+            if ($translated->post_status === 'publish') {
+                $permalink = get_permalink($translated);
+                if (is_string($permalink) && $permalink !== '') {
+                    $uris[] = $permalink;
+                }
+            }
+            $meta = get_post_meta($post_id);
+            $excluded = (array) apply_filters('flowpress_deploy_volatile_meta_keys', [
+                '_edit_lock', '_edit_last', '_wp_old_slug', '_wp_page_template',
+            ], 'post', $post_id);
+            foreach ($excluded as $key) {
+                unset($meta[(string) $key]);
+            }
+            ksort($meta);
+            $terms = wp_get_object_terms($post_id, get_object_taxonomies($translated->post_type), ['fields' => 'tt_ids']);
+            if (! is_wp_error($terms)) {
+                $terms = array_map('intval', $terms);
+                sort($terms, SORT_NUMERIC);
+            }
+            $posts[] = [
+                'id' => $post_id,
+                'type' => $translated->post_type,
+                'status' => $translated->post_status,
+                'slug' => $translated->post_name,
+                'title' => $translated->post_title,
+                'content' => $translated->post_content,
+                'excerpt' => $translated->post_excerpt,
+                'parent' => (int) $translated->post_parent,
+                'modified' => $translated->post_modified_gmt,
+                'meta' => $meta,
+                'terms' => is_wp_error($terms) ? [] : $terms,
+            ];
+        }
+        $fingerprint_fields['posts'] = $posts;
+    } elseif ($resource_id > 0) {
+        $term = get_term($resource_id, $resource_type);
+        if ($term instanceof WP_Term) {
+            $element_type = 'tax_' . $resource_type;
+            $trid = apply_filters('wpml_element_trid', null, $term->term_taxonomy_id, $element_type);
+            if (is_numeric($trid) && (int) $trid > 0) {
+                $group_key = 'wpml:' . $element_type . ':' . (int) $trid;
+            }
+            $translations = is_numeric($trid)
+                ? apply_filters('wpml_get_element_translations', [], (int) $trid, $element_type)
+                : [];
+            $translated_terms = [$term];
+            if (is_array($translations)) {
+                foreach ($translations as $translation) {
+                    $tt_id = is_object($translation) ? (int) ($translation->element_id ?? 0) : 0;
+                    $translated_term = $tt_id > 0
+                        ? get_term_by('term_taxonomy_id', $tt_id, $resource_type)
+                        : null;
+                    if ($translated_term instanceof WP_Term) {
+                        $translated_terms[] = $translated_term;
+                    }
+                }
+            }
+            $term_map = [];
+            foreach ($translated_terms as $translated_term) {
+                $term_map[$translated_term->term_id] = $translated_term;
+            }
+            ksort($term_map, SORT_NUMERIC);
+            $uris = [];
+            $terms = [];
+            foreach ($term_map as $translated_term) {
+                $link = get_term_link($translated_term);
+                if (! is_wp_error($link) && is_string($link)) {
+                    $uris[] = $link;
+                }
+                $meta = get_term_meta($translated_term->term_id);
+                $excluded = (array) apply_filters(
+                    'flowpress_deploy_volatile_meta_keys',
+                    [],
+                    'term',
+                    $translated_term->term_id
+                );
+                foreach ($excluded as $key) {
+                    unset($meta[(string) $key]);
+                }
+                ksort($meta);
+                $terms[] = [
+                    'id' => $translated_term->term_id,
+                    'taxonomy' => $resource_type,
+                    'slug' => $translated_term->slug,
+                    'name' => $translated_term->name,
+                    'description' => $translated_term->description,
+                    'parent' => (int) $translated_term->parent,
+                    'meta' => $meta,
+                ];
+            }
+            $fingerprint_fields['terms'] = $terms;
+        }
+    }
+
+    $group_key = (string) apply_filters(
+        'flowpress_deploy_group_key',
+        $group_key,
+        $resource_type,
+        $resource_id
+    );
+    $uris = flowpress_deploy_decode_uris((array) apply_filters(
+        'flowpress_deploy_canonical_uris',
+        $uris,
+        $resource_type,
+        $resource_id,
+        $group_key
+    ));
+    $fingerprint_fields = (array) apply_filters(
+        'flowpress_deploy_fingerprint_fields',
+        $fingerprint_fields,
+        $resource_type,
+        $resource_id,
+        $group_key
+    );
+    return [
+        'groupKey' => sanitize_key(str_replace(':', '-', $group_key)),
+        'resourceType' => $resource_type,
+        'resourceId' => max(0, $resource_id),
+        'uris' => $uris,
+        'fingerprint' => hash('sha256', (string) wp_json_encode($fingerprint_fields)),
+    ];
+}
+
+/** @var array<string,array{resourceType:string,resourceId:int,uri:string,operation:string,forceFull:bool}> */
+function &flowpress_deploy_collected_changes(): array
+{
+    static $changes = [];
+    return $changes;
+}
+
+function flowpress_deploy_collect_change(
+    string $resource_type,
+    int $resource_id,
+    string $uri,
+    string $operation = 'update',
+    bool $force_full = false
+): void {
+    if ($operation === 'delete') {
+        flowpress_deploy_enqueue_change($resource_type, $resource_id, $uri, 'delete', $force_full);
+        return;
+    }
+    $changes = &flowpress_deploy_collected_changes();
+    $changes[$resource_type . ':' . $resource_id] = [
+        'resourceType' => $resource_type,
+        'resourceId' => $resource_id,
+        'uri' => $uri,
+        'operation' => $operation,
+        'forceFull' => $force_full,
+    ];
+}
+
+function flowpress_deploy_flush_changes(): void
+{
+    $changes = &flowpress_deploy_collected_changes();
+    foreach ($changes as $change) {
+        flowpress_deploy_enqueue_change(
+            $change['resourceType'],
+            $change['resourceId'],
+            $change['uri'],
+            $change['operation'],
+            $change['forceFull']
+        );
+    }
+    $changes = [];
+}
+add_action('shutdown', 'flowpress_deploy_flush_changes', 0);
+
+function flowpress_deploy_enqueue_change(
+    string $resource_type,
+    int $resource_id,
+    string $uri,
+    string $operation = 'update',
+    bool $force_full = false,
+    ?string $only_target = null
+): void {
+    global $wpdb;
+    $descriptor = flowpress_deploy_describe_resource($resource_type, $resource_id, $uri);
+    if ($operation === 'delete') {
+        $descriptor['uris'] = [];
+        $descriptor['fingerprint'] = hash('sha256', 'deleted:' . $descriptor['groupKey']);
+    }
+    $targets = $only_target !== null ? [$only_target] : flowpress_static_targets();
+    foreach ($targets as $target) {
+        $target = sanitize_key($target);
+        if ($target === '') {
+            continue;
+        }
+        $existing = $wpdb->get_row($wpdb->prepare(
+            'SELECT * FROM ' . flowpress_deploy_queue_table() . ' WHERE target = %s AND group_key = %s',
+            $target,
+            $descriptor['groupKey']
+        ), ARRAY_A);
+        $state = $wpdb->get_row($wpdb->prepare(
+            'SELECT * FROM ' . flowpress_deploy_state_table() . ' WHERE target = %s AND group_key = %s',
+            $target,
+            $descriptor['groupKey']
+        ), ARRAY_A);
+        if (
+            ! $force_full
+            && $operation !== 'delete'
+            && ! is_array($existing)
+            && is_array($state)
+            && hash_equals((string) $state['fingerprint'], $descriptor['fingerprint'])
+            && flowpress_deploy_decode_uris($state['current_uris']) === $descriptor['uris']
+        ) {
+            continue;
+        }
+        $previous = is_array($existing)
+            ? flowpress_deploy_decode_uris($existing['previous_uris'])
+            : (is_array($state) ? flowpress_deploy_decode_uris($state['current_uris']) : []);
+        if ($operation === 'delete' && $previous === []) {
+            $previous = flowpress_deploy_decode_uris([$uri]);
+        }
+        $now = current_time('mysql', true);
+        if (is_array($existing)) {
+            $wpdb->update(flowpress_deploy_queue_table(), [
+                'resource_type' => $descriptor['resourceType'],
+                'resource_id' => $descriptor['resourceId'],
+                'current_uris' => flowpress_deploy_json($descriptor['uris']),
+                'fingerprint' => $descriptor['fingerprint'],
+                'revision' => (int) $existing['revision'] + 1,
+                'force_full' => ($force_full || ! empty($existing['force_full'])) ? 1 : 0,
+                'updated_at' => $now,
+            ], ['id' => (int) $existing['id']]);
+        } else {
+            $wpdb->insert(flowpress_deploy_queue_table(), [
+                'target' => $target,
+                'group_key' => $descriptor['groupKey'],
+                'resource_type' => $descriptor['resourceType'],
+                'resource_id' => $descriptor['resourceId'],
+                'current_uris' => flowpress_deploy_json($descriptor['uris']),
+                'previous_uris' => flowpress_deploy_json($previous),
+                'fingerprint' => $descriptor['fingerprint'],
+                'revision' => 1,
+                'force_full' => $force_full ? 1 : 0,
+                'created_at' => $now,
+                'updated_at' => $now,
+            ]);
+        }
+    }
+}
+
+/** @return array<string,list<array<string,mixed>>> */
+function &flowpress_deploy_payload_snapshots(): array
+{
+    static $snapshots = [];
+    return $snapshots;
+}
+
+function flowpress_deploy_build_payload(string $target, bool $force_full = false): array
+{
+    flowpress_deploy_flush_changes();
+    flowpress_deploy_recover_stale_batches();
+    global $wpdb;
+    $rows = (array) $wpdb->get_results($wpdb->prepare(
+        'SELECT * FROM ' . flowpress_deploy_queue_table()
+        . ' WHERE target = %s AND batch_id IS NULL ORDER BY id ASC',
+        $target
+    ), ARRAY_A);
+    $paths = [];
+    $deleted = [];
+    $full = $force_full;
+    foreach ($rows as $row) {
+        $current = flowpress_deploy_decode_uris($row['current_uris']);
+        $previous = flowpress_deploy_decode_uris($row['previous_uris']);
+        $delta = flowpress_deploy_route_delta($previous, $current);
+        foreach ($delta['paths'] as $path) {
+            $paths[$path] = true;
+            unset($deleted[$path]);
+        }
+        foreach ($delta['deletedPaths'] as $path) {
+            if (! isset($paths[$path])) {
+                $deleted[$path] = true;
+            }
+        }
+        $full = $full || ! empty($row['force_full']);
+    }
+    $batch_id = wp_generate_uuid4();
+    $snapshots = &flowpress_deploy_payload_snapshots();
+    $snapshots[$batch_id] = $rows;
+    return [
+        'batchId' => $batch_id,
+        'target' => sanitize_key($target),
+        'mode' => $full ? 'full' : 'partial',
+        'paths' => array_keys($paths),
+        'deletedPaths' => array_keys($deleted),
+        'queueIds' => array_map('intval', array_column($rows, 'id')),
+    ];
+}
+
+function flowpress_deploy_mark_dispatched(array $payload): void
+{
+    global $wpdb;
+    $batch_id = sanitize_text_field((string) ($payload['batchId'] ?? ''));
+    $snapshots = &flowpress_deploy_payload_snapshots();
+    $rows = $snapshots[$batch_id] ?? [];
+    unset($snapshots[$batch_id]);
+    $now = current_time('mysql', true);
+    $accepted = [];
+    foreach ($rows as $row) {
+        $updated = $wpdb->query($wpdb->prepare(
+            'UPDATE ' . flowpress_deploy_queue_table()
+            . ' SET batch_id = %s, dispatched_revision = %d, dispatched_at = %s'
+            . ' WHERE id = %d AND revision = %d AND batch_id IS NULL',
+            $batch_id,
+            (int) $row['revision'],
+            $now,
+            (int) $row['id'],
+            (int) $row['revision']
+        ));
+        if ($updated) {
+            $accepted[] = $row;
+        }
+    }
+    $wpdb->replace(flowpress_deploy_batch_table(), [
+        'batch_id' => $batch_id,
+        'target' => sanitize_key((string) ($payload['target'] ?? '')),
+        'mode' => ($payload['mode'] ?? '') === 'full' ? 'full' : 'partial',
+        'snapshot' => (string) wp_json_encode($accepted, JSON_UNESCAPED_SLASHES),
+        'status' => 'in_flight',
+        'created_at' => $now,
+    ]);
+}
+
+function flowpress_deploy_complete_batch(string $batch_id, string $status): int
+{
+    global $wpdb;
+    $batch = $wpdb->get_row($wpdb->prepare(
+        'SELECT * FROM ' . flowpress_deploy_batch_table() . ' WHERE batch_id = %s',
+        $batch_id
+    ), ARRAY_A);
+    if (! is_array($batch)) {
+        return 0;
+    }
+    $rows = json_decode((string) $batch['snapshot'], true);
+    $rows = is_array($rows) ? $rows : [];
+    $affected = 0;
+    foreach ($rows as $snapshot) {
+        $current = $wpdb->get_row($wpdb->prepare(
+            'SELECT * FROM ' . flowpress_deploy_queue_table() . ' WHERE id = %d',
+            (int) ($snapshot['id'] ?? 0)
+        ), ARRAY_A);
+        if (! is_array($current) || (string) $current['batch_id'] !== $batch_id) {
+            continue;
+        }
+        if ($status === 'success') {
+            $wpdb->replace(flowpress_deploy_state_table(), [
+                'target' => (string) $snapshot['target'],
+                'group_key' => (string) $snapshot['group_key'],
+                'current_uris' => (string) $snapshot['current_uris'],
+                'fingerprint' => (string) $snapshot['fingerprint'],
+                'revision' => (int) $snapshot['revision'],
+                'updated_at' => current_time('mysql', true),
+            ]);
+        }
+        $ack_action = flowpress_deploy_ack_action(
+            $status,
+            (int) $current['revision'],
+            (int) $snapshot['revision']
+        );
+        if ($ack_action === 'delete') {
+            $affected += (int) $wpdb->delete(flowpress_deploy_queue_table(), ['id' => (int) $current['id']]);
+        } else {
+            $affected += (int) $wpdb->update(flowpress_deploy_queue_table(), [
+                'batch_id' => null,
+                'dispatched_revision' => null,
+                'dispatched_at' => null,
+            ], ['id' => (int) $current['id']]);
+        }
+    }
+    $wpdb->update(flowpress_deploy_batch_table(), [
+        'status' => $status,
+        'completed_at' => current_time('mysql', true),
+    ], ['batch_id' => $batch_id]);
+    return $affected;
+}
+
+function flowpress_deploy_pending_count(string $target): int
+{
+    global $wpdb;
+    return (int) $wpdb->get_var($wpdb->prepare(
+        'SELECT COUNT(*) FROM ' . flowpress_deploy_queue_table()
+        . ' WHERE target = %s AND batch_id IS NULL',
+        sanitize_key($target)
+    ));
+}
+
+function flowpress_deploy_recover_stale_batches(): int
+{
+    global $wpdb;
+    $hours = max(1, (int) apply_filters('flowpress_deploy_stale_batch_hours', 6));
+    $cutoff = gmdate('Y-m-d H:i:s', time() - ($hours * HOUR_IN_SECONDS));
+    $batch_ids = (array) $wpdb->get_col($wpdb->prepare(
+        'SELECT batch_id FROM ' . flowpress_deploy_batch_table()
+        . " WHERE status = 'in_flight' AND created_at < %s",
+        $cutoff
+    ));
+    $affected = 0;
+    foreach ($batch_ids as $batch_id) {
+        $affected += flowpress_deploy_complete_batch((string) $batch_id, 'failure');
+    }
+    return $affected;
+}
+add_action('flowpress_deploy_recover_stale_batches', 'flowpress_deploy_recover_stale_batches');
+add_action('init', static function (): void {
+    if (! wp_next_scheduled('flowpress_deploy_recover_stale_batches')) {
+        wp_schedule_event(time() + HOUR_IN_SECONDS, 'hourly', 'flowpress_deploy_recover_stale_batches');
+    }
+}, 20);
+
+function flowpress_deploy_migrate_core_queue(): void
+{
+    if (get_option('flowpress_deploy_core_queue_migrated') === '1') {
+        return;
+    }
+    global $wpdb;
+    $core = $wpdb->prefix . 'flowpress_build_queue';
+    $like = method_exists($wpdb, 'esc_like') ? $wpdb->esc_like($core) : $core;
+    if ($wpdb->get_var($wpdb->prepare('SHOW TABLES LIKE %s', $like)) !== $core) {
+        update_option('flowpress_deploy_core_queue_migrated', '1', false);
+        return;
+    }
+    $rows = (array) $wpdb->get_results("SELECT * FROM {$core} ORDER BY id ASC", ARRAY_A);
+    foreach ($rows as $row) {
+        $legacy = flowpress_deploy_normalize_legacy_row($row);
+        flowpress_deploy_enqueue_change(
+            $legacy['resourceType'],
+            $legacy['resourceId'],
+            $legacy['uri'],
+            $legacy['operation'],
+            $legacy['forceFull'],
+            $legacy['target']
+        );
+    }
+    update_option('flowpress_deploy_core_queue_migrated', '1', false);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@styleflow.app/flowpress-deploy",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.1",
   "description": "Safe full and partial deployment primitives for FlowPress.",
   "type": "module",
   "license": "UNLICENSED",
@@ -18,11 +18,11 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist", "flowpress-deploy.php", "composer.json", "README.md", "CHANGELOG.md"],
+  "files": ["dist", "includes", "docs", "flowpress-deploy.php", "composer.json", "README.md", "CHANGELOG.md"],
   "scripts": {
     "build": "tsc -b",
     "typecheck": "tsc -b --pretty false",
-    "test": "vitest run",
+    "test": "vitest run && php tests/php/queue-provider-test.php",
     "release:check": "npm run typecheck && npm test && npm pack --dry-run",
     "release:publish:next": "npm publish --access public --tag next",
     "prepublishOnly": "npm run typecheck && npm test"