claude-plugin-wordpress-manager 2.12.1 → 2.13.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wordpress-manager",
-  "version": "2.6.0",
-  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (111 tools incl. WooCommerce + Multisite + Webhooks + Mailchimp + Buffer + SendGrid + Google Search Console), and WordPress.com MCP (hosted sites) with 12 specialized agents, 36 skills, and security hooks. Includes AI content optimization (headline scoring, readability, SEO scoring, content triage), Google Search Console integration (keyword tracking, indexing, SEO feedback), social/email distribution (Mailchimp, Buffer, SendGrid), programmatic SEO, content-commerce attribution, multi-language network, fleet monitoring, content repurposing, webhook propagation, site monitoring, CI/CD pipeline automation, WordPress Multisite network management, WooCommerce store management, local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
+  "version": "2.13.0",
+  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP, WP REST API bridge (148 tools incl. WooCommerce, Multisite, Mailchimp, Buffer, SendGrid, GSC, GA4, Plausible, CWV, Slack, Workflows, LinkedIn, Twitter, Schema), and WordPress.com MCP with 45 skills, 12 agents, and security hooks. v2.13.0 adds Content Framework: 3-phase pipeline from signals intelligence to editorial calendar to WordPress publishing.",
   "author": {
     "name": "vinmor",
     "email": "morreale.v@gmail.com"
@@ -37,7 +37,12 @@
     "seo-feedback",
     "content-optimization",
     "readability",
-    "headline-scoring"
+    "headline-scoring",
+    "content-framework",
+    "content-pipeline",
+    "editorial-calendar",
+    "signals-intelligence",
+    "structured-data"
   ],
   "mcpServers": "./.mcp.json"
 }

package/CHANGELOG.md

@@ -2,6 +2,84 @@
 
 All notable changes to the WordPress Manager plugin for Claude Code.
 
+## [2.13.0] — 2026-03-02
+
+### Added — Content Framework (3 Phases)
+
+Il Content Framework introduce un'architettura a 3 fasi che collega signal intelligence, content pipeline e editorial calendar. Zero nuovi MCP tool TypeScript — l'intera orchestrazione vive nel CLI via skill + file Markdown strutturati.
+
+**Phase 1: Content Pipeline Engine**
+- Nuova skill `wp-content-pipeline` con workflow 5-step: `RECEIVE → PREPARE → PUBLISH → DISTRIBUTE → ARCHIVE`
+- Schema `content-brief.schema.md` — formato di scambio tra Gen* skill e WordPress
+- Schema `site-config.schema.md` — configurazione per-sito (cadenza, canali, defaults)
+- Directory `.content-state/` con pipeline-active/archive per gestione brief
+- Supporto multi-sito (opencactus + altri)
+- Distribuzione automatica su Buffer + Mailchimp dopo pubblicazione
+
+**Phase 2: Content Intelligence**
+- Estesa skill `wp-analytics` con Step 7 (signal feed generation)
+- Schema `signals-feed.schema.md` — compatibile con GenSignal NormalizedEvent
+- Delta calculation: confronto metriche con periodo precedente
+- Riconoscimento automatico pattern GenSignal (Search Intent Shift, Early-Adopter Surge, Price-Floor Inversion)
+- Pipeline: analytics → signals-feed.md → insight azionabili
+
+**Phase 3: Editorial Calendar**
+- Nuova skill `wp-editorial-planner` con workflow 4-step: `PLAN → BRIEF → SCHEDULE → SYNC`
+- Schema `editorial.schema.md` — calendario mensile con tabelle settimanali (7 colonne)
+- Lifecycle entry: `planned → draft → ready → scheduled → published`
+- Integrazione cross-phase: signals-feed → topic suggestions → calendar → brief → WP post
+- SYNC bidirezionale: status WordPress → aggiornamento calendario
+
+**E2E Test su opencactus.com**
+- PLAN: anomalia signals-feed (acqua di cactus +120%) → topic assignment ✅
+- BRIEF: calendar entry → BRF-2026-005.brief.md con contenuto completo ✅
+- SCHEDULE: brief → WP post via AIWU ✅ (con limitazione `post_date` documentata)
+- SYNC: lettura status WP e verifica calendario ✅
+- Cleanup: test posts eliminati ✅
+
+**Known Limitation — AIWU MCP**
+- `wp_create_post` / `wp_update_post` non supportano `post_date`
+- `status: future` non funziona via AIWU (auto-publish)
+- Workaround: usare wp-rest-bridge `create_content` che supporta `date`
+
+### Added — Validation Runner v1.2.0
+
+- Sistema di validazione automatica per tutti i 148 MCP tool
+- Test CRUD per 26 write tool con sequenze automatiche a 2 tier
+- Modalità interattiva CLI con `@clack/prompts` (selezione sito, tipo validazione, filtro modulo)
+- Flag `--site=X` per selezione sito in batch mode
+- Report: 48 read passed, 26 write passed, 0 failed su opencactus
+
+### Stats
+
+- Skills: 43 → **45** (+wp-content-pipeline, +wp-editorial-planner)
+- Reference schemas: +4 (content-brief, site-config, signals-feed, editorial)
+- Architecture doc: `docs/plans/2026-03-02-content-framework-architecture.md`
+- GUIDE.md: +3 sezioni (17.4 Content Pipeline, 17.5 Content Intelligence, 17.6 Editorial Calendar)
+
+## [2.12.2] — 2026-03-01
+
+### Fixed — Structured Data Tools Rewrite
+
+**sd_inject: content-block approach (replaces broken meta approach)**
+- JSON-LD now injected as `<!-- wp:html -->` block in post content
+- No mu-plugin or `register_post_meta()` required — works out of the box
+- Idempotent: re-injecting same @type replaces existing block, no duplicates
+
+**sd_list_schemas: content scanning (replaces broken meta scanning)**
+- Scans post content for `<script type="application/ld+json">` blocks
+- No longer depends on unregistered `_schema_json_ld` meta field
+
+**sd_validate: multi-block support**
+- Now finds ALL JSON-LD scripts on a page (not just the first)
+- Reports per-schema issues with type labels
+
+### Validated end-to-end on opencactus.com
+- sd_inject Article on post 2348: ✅
+- sd_list_schemas finds injected schema: ✅
+- sd_validate on live URL: ✅ (2 schemas detected)
+- Idempotency verified: ✅
+
 ## [2.12.1] — 2026-03-01
 
 ### Fixed — Critical MCP Tool Parameter Passing

package/docs/GUIDE.md

@@ -1,6 +1,6 @@
 # WordPress Manager - Guida Completa per Utenti e Amministratori
 
-**Versione:** 2.12.1
+**Versione:** 2.12.2
 **Ultimo aggiornamento:** 2026-03-01
 **Repository:** https://github.com/morrealev/wordpress-manager
 
@@ -110,7 +110,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
 ### Componenti del Plugin
 
 ```
-wordpress-manager/                          # v2.12.1
+wordpress-manager/                          # v2.12.2
 +-- .claude-plugin/plugin.json              # Manifest
 +-- .mcp.json                               # Server MCP bundled
 +-- LICENSE                                 # MIT + GPL-2.0-or-later
@@ -130,7 +130,7 @@ wordpress-manager/                          # v2.12.1
 |   +-- wp-distribution-manager.md              # Multi-channel distribution + LinkedIn + Twitter/X (v2.10.0)
 +-- commands/                               # 5 slash commands
 |   +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
-+-- skills/                                 # 43 skill totali
++-- skills/                                 # 45 skill totali
 |   +-- [OPERATIVE - 5 skill]
 |   +-- wp-deploy/                              # Procedure deploy
 |   +-- wp-audit/                               # Checklist audit
@@ -181,8 +181,8 @@ wordpress-manager/                          # v2.12.1
 |   +-- [DISTRIBUZIONE DIRETTA + CONTENT FACTORY - 4 skill]
 |   +-- wp-linkedin/                            # LinkedIn direct posting e analytics (v2.10.0)
 |   +-- wp-twitter/                             # Twitter/X direct posting e thread (v2.10.0)
-|   +-- wp-structured-data/                     # Schema.org/JSON-LD validation e injection (v2.12.1)
-|   +-- wp-content-generation/                  # AI content generation pipeline (v2.12.1)
+|   +-- wp-structured-data/                     # Schema.org/JSON-LD validation e injection (v2.12.2)
+|   +-- wp-content-generation/                  # AI content generation pipeline (v2.12.2)
 +-- hooks/                                  # 12 hook di sicurezza
 |   +-- hooks.json                              # 10 prompt + 2 command
 |   +-- scripts/                                # Script per hook command-type
@@ -619,9 +619,9 @@ IDEAZIONE -> BOZZA -> REVISIONE -> OTTIMIZZAZIONE -> PUBBLICAZIONE -> MONITORAGG
 
 **AI Content Optimization** (v2.6.0): Pipeline AI-driven in 5 step per ottimizzazione contenuti: headline scoring → readability analysis (Flesch-Kincaid) → SEO scoring → meta optimization → content freshness check. Include bulk triage per analisi rapida di tutti i contenuti con classificazione Quick Wins / Maintain / Deep Review / Outdated. Usa la skill `wp-content-optimization`.
 
-**AI Content Generation** (v2.12.1): Pipeline completa 7 step per generare contenuti da zero: brief → keyword research (GSC se disponibile) → outline (4 pattern: standard, tutorial, listicle, FAQ) → draft (calibrato sulla voce del sito) → SEO optimize → structured data injection → publish as draft. Procedure-based, usa tool MCP esistenti (`wp/v2`, `gsc_*`, `sd_*`). Usa la skill `wp-content-generation`.
+**AI Content Generation** (v2.12.2): Pipeline completa 7 step per generare contenuti da zero: brief → keyword research (GSC se disponibile) → outline (4 pattern: standard, tutorial, listicle, FAQ) → draft (calibrato sulla voce del sito) → SEO optimize → structured data injection → publish as draft. Procedure-based, usa tool MCP esistenti (`wp/v2`, `gsc_*`, `sd_*`). Usa la skill `wp-content-generation`.
 
-**Structured Data Management** (v2.12.1): Gestione completa Schema.org/JSON-LD con 3 tool MCP dedicati: `sd_validate` (validazione markup via URL o inline), `sd_inject` (iniezione JSON-LD nei post), `sd_list_schemas` (audit sitewide). 8 tipi supportati: Article, Product, FAQ, HowTo, LocalBusiness, Event, Organization, BreadcrumbList. Usa la skill `wp-structured-data`.
+**Structured Data Management** (v2.12.2): Gestione completa Schema.org/JSON-LD con 3 tool MCP dedicati: `sd_validate` (validazione markup via URL o inline), `sd_inject` (iniezione JSON-LD nei post), `sd_list_schemas` (audit sitewide). 8 tipi supportati: Article, Product, FAQ, HowTo, LocalBusiness, Event, Organization, BreadcrumbList. Usa la skill `wp-structured-data`.
 
 **Skill correlata**: `wp-content`, `wp-i18n`, `wp-content-repurposing`, `wp-programmatic-seo`, `wp-search-console`, `wp-content-optimization`, `wp-content-generation`, `wp-structured-data`
 
@@ -965,7 +965,7 @@ Le skill di sviluppo provengono da due fonti:
 - **3 skill strategia + SEO internazionale** (MIT) aggiunte in v2.3.0: Programmatic SEO, Content-Commerce Attribution, Multi-Language Network.
 - **3 skill distribuzione + SEO avanzato** (MIT) aggiunte in v2.4.0-v2.6.0: Social/Email Distribution, Google Search Console, AI Content Optimization.
 - **3 skill analytics + alerting + automazione** (MIT) aggiunte in v2.7.0-v2.9.0: Analytics (GA4/Plausible/CWV), Smart Alerting (Slack/SendGrid severity routing), Automated Workflows (triggers + multi-channel actions).
-- **4 skill distribuzione diretta + content factory** (MIT) aggiunte in v2.10.0-v2.12.1: LinkedIn Direct (posting + analytics), Twitter/X Direct (tweet + thread + metriche), Structured Data (Schema.org/JSON-LD), AI Content Generation (pipeline 7-step).
+- **4 skill distribuzione diretta + content factory** (MIT) aggiunte in v2.10.0-v2.12.2: LinkedIn Direct (posting + analytics), Twitter/X Direct (tweet + thread + metriche), Structured Data (Schema.org/JSON-LD), AI Content Generation (pipeline 7-step).
 
 ### Il Router Unificato
 
@@ -1194,7 +1194,7 @@ Aggiunte in v2.7.0-v2.9.0, queste skill completano il layer Observability + Auto
 
 ### Panoramica Skills Distribuzione Diretta + Content Factory (4)
 
-Aggiunte in v2.10.0-v2.12.1, queste skill completano il WCOP portando il punteggio totale da 8.8/10 a 9.2/10 (Distribution 9/10, Content Factory 10/10).
+Aggiunte in v2.10.0-v2.12.2, queste skill completano il WCOP portando il punteggio totale da 8.8/10 a 9.2/10 (Distribution 9/10, Content Factory 10/10).
 
 | Skill | Si attiva quando... | Risorse | Agent dedicato |
 |-------|---------------------|---------|----------------|
@@ -1238,8 +1238,8 @@ Le skill includono 31 script Node.js (`.mjs`) che eseguono analisi automatica de
 | `workflow_inspect.mjs` | Action channel config, automation plugins, custom REST endpoints, WP-Cron, webhook config (v2.9.0) |
 | `linkedin_inspect.mjs` | LinkedIn access token, profile info, API connectivity (v2.10.0) |
 | `twitter_inspect.mjs` | Twitter Bearer token, OAuth tokens, API v2 connectivity (v2.10.0) |
-| `schema_inspect.mjs` | SEO plugins (Yoast, Rank Math), existing JSON-LD in theme, Schema Pro (v2.12.1) |
-| `content_gen_inspect.mjs` | REST access, GSC credentials, pipeline step availability (v2.12.1) |
+| `schema_inspect.mjs` | SEO plugins (Yoast, Rank Math), existing JSON-LD in theme, Schema Pro (v2.12.2) |
+| `content_gen_inspect.mjs` | REST access, GSC credentials, pipeline step availability (v2.12.2) |
 
 ### WordPress Playground — Ambienti Disposable
 
@@ -2159,6 +2159,130 @@ File:           644 (rw-r--r--)
 wp-config.php:  440 (r--r-----)
 ```
 
+### 14.8 Validation Runner — Test Automatizzati dei Tool MCP
+
+Il **Validation Runner** (`scripts/run-validation.mjs`) verifica il corretto funzionamento di tutti i 148 tool MCP registrati. Supporta due modalita di utilizzo: **interattiva** (menu guidato) e **batch** (flag CLI per automazione/CI).
+
+#### Modalita Interattiva
+
+Lanciando lo script senza flag si attiva un menu guidato con `@clack/prompts`:
+
+```bash
+node scripts/run-validation.mjs
+```
+
+Il menu guida attraverso 4 step:
+
+1. **Selezione sito target** — lista automatica dai siti in `WP_SITES_CONFIG`
+2. **Tipo di validazione** — read tool, write tool per tier, o validazione completa
+3. **Filtro modulo** (opzionale) — per testare un singolo modulo (es. `unified-content`)
+4. **Conferma** — riepilogo e conferma prima dell'esecuzione
+
+```
+┌  WP REST Bridge — Validation Runner v1.2.0
+│
+◆  Seleziona il sito target
+│  ● opencactus (https://opencactus.com)
+│  ○ bioinagro (https://www.bioinagro.it)
+└
+◆  Cosa vuoi validare?
+│  ○ Solo read tool
+│  ○ Solo write tool (Tier 1 — CRUD base)
+│  ○ Solo write tool (Tier 2 — con dipendenze)
+│  ○ Solo write tool (tutti i tier)
+│  ○ Tutto (read + write)
+└
+```
+
+#### Modalita Batch (CLI)
+
+Per automazione, CI, o uso da Claude Code si usano i flag:
+
+```bash
+# Selezionare sito specifico
+node scripts/run-validation.mjs --site=opencactus
+
+# Test solo read tool
+node scripts/run-validation.mjs --site=opencactus --module=unified-content
+
+# Test write CRUD sequences
+node scripts/run-validation.mjs --site=opencactus --test-writes
+
+# Solo Tier 1 (content, term, comment, user)
+node scripts/run-validation.mjs --test-writes --tier=1
+
+# Solo Tier 2 (media, plugin, assign_terms)
+node scripts/run-validation.mjs --test-writes --tier=2
+
+# Regolare il delay tra le chiamate
+node scripts/run-validation.mjs --delay=200
+```
+
+**Flag disponibili**:
+
+| Flag | Descrizione |
+|------|-------------|
+| `--site=ID` | Seleziona il sito target (switch automatico via MCP) |
+| `--module=NOME` | Filtra per modulo (es. `unified-content`, `gsc`, `wc-products`) |
+| `--test-writes` | Esegue sequenze CRUD: create > verify > update > verify > delete |
+| `--tier=N` | Filtra le write sequences per tier (1, 2, o 3) |
+| `--include-writes` | Include write tool nel test read (senza sequenze CRUD) |
+| `--delay=MS` | Millisecondi di attesa tra le chiamate (default: 100) |
+| `--timeout=MS` | Timeout per singola chiamata (default: 10000) |
+
+**Regola duale**: senza flag → interattivo. Con almeno un flag → batch mode.
+
+#### Write Test Tiers
+
+| Tier | Sequenze | Descrizione |
+|------|----------|-------------|
+| **1** | content, term, comment, user | CRUD base, entita standalone |
+| **2** | media, plugin, assign_terms | CRUD con dipendenze tra entita |
+| **3** | switch_site | Operazioni speciali (cambio sito e ritorno) |
+
+Ogni sequenza esegue il ciclo completo **create → verify → update → verify → delete** con cleanup automatico in caso di errore.
+
+#### Output: Tre Livelli di Dettaglio
+
+I risultati vengono generati in tre formati complementari:
+
+1. **Console (stderr)** — log in tempo reale durante l'esecuzione, ideale per monitorare il progresso:
+   ```
+   [validation] Write sequences to run: content(T1), term(T1), user(T1)
+   [validation]   ── Sequence: content (Tier 1) ──
+   [validation]     → extracted id=2451
+   [validation]     [+] create:create_content (488ms)
+   [validation]     [+] verify:get_content (341ms)
+   ```
+
+2. **Markdown** (`docs/VALIDATION.md`) — report tabellare per consultazione rapida, con status per ogni tool, servizio e modulo.
+
+3. **Dashboard HTML** (`docs/validation/dashboard.html`) — interfaccia grafica interattiva con:
+   - Grafici riassuntivi (passed/failed/skipped)
+   - Dettaglio per modulo e servizio
+   - Tempo di risposta per ogni tool
+   - Filtri e ricerca
+
+   > **Importante**: La dashboard carica `results.json` via `fetch()`, quindi richiede un server HTTP. Non funziona con il protocollo `file://`.
+
+   ```bash
+   # Avviare un server locale per la dashboard
+   cd docs/validation && python3 -m http.server 8111
+
+   # Poi aprire nel browser
+   # http://localhost:8111/dashboard.html
+   ```
+
+#### File Generati
+
+| File | Formato | Descrizione |
+|------|---------|-------------|
+| `docs/validation/results.json` | JSON | Dati strutturati, merge incrementale tra run |
+| `docs/VALIDATION.md` | Markdown | Report leggibile, rigenerato ad ogni run |
+| `docs/validation/dashboard.html` | HTML | Dashboard interattiva (richiede HTTP server) |
+
+I risultati sono **incrementali**: un run su un singolo modulo (`--module=X`) aggiorna solo quel modulo in `results.json`, preservando i risultati precedenti degli altri.
+
 ---
 
 ## 15. Troubleshooting
@@ -2363,6 +2487,121 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
 
 ---
 
-*Guida v2.12.1 — WordPress Manager Plugin per Claude Code*
+## 17. Content Framework
+
+The Content Framework connects Gen* ecosystem skills (GenCorpComm, GenMarketing, GenSignal) to WordPress publishing through structured Markdown files.
+
+### 17.1 Architecture
+
+The framework uses three types of MD files as configuration layer:
+
+| Type | Suffix | Purpose | Location |
+|------|--------|---------|----------|
+| Schema | `.schema.md` | Template definition | `skills/wp-content-pipeline/references/` |
+| Config | `.config.md` | Site-specific settings | `.content-state/{site_id}.config.md` |
+| Brief | `.brief.md` | Content instance | `.content-state/pipeline-active/` |
+
+### 17.2 Content Pipeline (Phase 1)
+
+**Skill**: `wp-content-pipeline`
+
+The pipeline orchestrates: `SCAN → CONFIG → VALIDATE → PUBLISH → DISTRIBUTE → UPDATE → ARCHIVE`
+
+**Creating a brief**:
+1. Generate content (via GenCorpComm or manually)
+2. Save as `.content-state/pipeline-active/BRF-YYYY-NNN.brief.md`
+3. Set frontmatter: site_id, title, categories, channels, SEO params
+4. Set `status: ready` when content is finalized
+
+**Publishing a brief**:
+1. Invoke `wp-content-pipeline` skill
+2. Pipeline reads all `status: ready` briefs
+3. Validates quality gates
+4. Creates WP post → distributes to channels → archives brief
+
+**Site configuration**:
+- One `.content-state/{site_id}.config.md` per managed site
+- Defines brand voice, default categories, active channels, SEO settings
+- Brief values override config defaults
+
+### 17.3 Directory Structure
+
+```
+.content-state/
+├── {site_id}.config.md          # site configuration
+├── pipeline-active/             # briefs in progress
+│   └── BRF-YYYY-NNN.brief.md
+└── pipeline-archive/            # completed briefs
+    └── BRF-YYYY-NNN.brief.md
+```
+
+### 17.4 Integration with Gen* Skills
+
+| Gen* Skill | Produces | Pipeline Consumes |
+|------------|----------|-------------------|
+| GenCorpComm | Multi-format content | Body + metadata → brief.md |
+| GenMarketing | Content calendar | Topics + dates → brief.md |
+| GenBrand | Brand voice | Tone + style → config.md |
+| GenSignal | Market signals | Topics → editorial planning (Phase 2) |
+
+### 17.5 Content Intelligence (Phase 2)
+
+**Skill**: `wp-analytics` (extended with Step 7: Signal Feed Generation)
+
+The intelligence layer creates a feedback loop: analytics data → structured signals → actionable insights.
+
+**Generating a signals feed**:
+1. Run `wp-analytics` signal feed generation for a site
+2. Step 7 collects data from GA4, GSC, Plausible, CWV tools
+3. Calculates delta % vs previous period
+4. Maps metrics to GenSignal NormalizedEvent format
+5. Identifies anomalies (±30% threshold by default)
+6. Matches 3 GenSignal patterns automatically
+7. Writes `.content-state/signals-feed.md`
+
+**Detectable patterns**:
+
+| Pattern | Detection Source | Trigger |
+|---------|-----------------|---------|
+| Search Intent Shift | GSC queries | CTR ≥ +20% with stable position |
+| Early-Adopter Surge | GA4 traffic sources | Single source ≥ +50% vs site < +20% |
+| Hype→Utility Crossover | GA4 page metrics | Engagement ≥ +15% with bounce ≤ -10% |
+
+**Acting on signals**:
+- "Approfondisci con GenSignal" → Full SignalCard with scoring and next_actions
+- "Crea brief dai segnali" → Auto-generate content briefs in pipeline-active/
+- Signals feed topic suggestions → Editorial calendar (Phase 3)
+
+**Signal feed file**: `.content-state/signals-feed.md` (overwritten each generation)
+
+### 17.6 Editorial Calendar (Phase 3)
+
+**Skill**: `wp-editorial-planner`
+
+The editorial planner manages monthly content calendars as `.state.md` files, bridging strategic planning to tactical execution.
+
+**Workflow**: `PLAN → BRIEF → SCHEDULE → SYNC`
+
+| Step | Action | Input | Output |
+|------|--------|-------|--------|
+| PLAN | Create monthly calendar | site config + signals feed | `{YYYY-MM}-editorial.state.md` |
+| BRIEF | Convert entries to briefs | calendar entries | `pipeline-active/BRF-*.brief.md` |
+| SCHEDULE | Create WP future posts | ready briefs | WordPress posts with `status: future` |
+| SYNC | Update calendar from WP | WordPress post status | Updated calendar entries |
+
+**Calendar structure**:
+- One `.content-state/{YYYY-MM}-editorial.state.md` per month
+- YAML frontmatter: monthly goals, posts target, focus topics, SEO targets
+- Markdown tables: one per week with columns Data, Titolo, Tipo, Status, Brief ID, Post ID, Canali
+
+**Entry lifecycle**: `planned → draft → ready → scheduled → published`
+
+**Cross-phase integration**:
+- Phase 2 signals → topic suggestions for `[da assegnare]` entries
+- Calendar entries → Phase 1 briefs → WordPress publishing pipeline
+
+---
+
+*Guida v2.12.2 — WordPress Manager Plugin per Claude Code*
 *Ultimo aggiornamento: 2026-03-01*
 *WCOP Score: 8.8/10 (Tier 4+5 complete)*