Phase 956: guild mesh stability stats journey stub (v0.8.923)

Add runGuildMeshStabilityStatsJourney headless helper for production
hardening track verification. Non-breaking; mesh stats output unchanged.

Co-authored-by: Cursor <[email protected]>

README.md

@@ -275,6 +275,8 @@ Enable autonomous agents (and developers) to drive Pearcord like a real user wit
 
 Both modes use **`pearcord-ui-flow` `dispatchUiMessage`** — the same handler as `apps/pearcord/index.js`.
 
+**v0.8.923 (Phase 956):** Headless `runGuildMeshStabilityStatsJourney(guildId)` — `getMeshStabilityStats` journey stub. Smoke: `npm run test:agentctl-guild-mesh-stability-journey-stub`.
+
 **v0.8.921 (Phase 954):** Headless `runExportMeshRegistryValidateJourney()` — calls `runExportMeshFetchRegistryValidateE2e()` for export mesh registry alignment + coverage stub. Smoke: `npm run test:agentctl-export-mesh-journey-stub`.
 
 **v0.8.610 (Phase 638):** Headless `runGuildSyncDiagnosticsJourney(guildId)` — refresh health counts, `getGuildSyncHealth`, `exportGuildSyncDiagnostics` (discovery join debugging). Smoke: `npm run test:agentctl-guild-sync-diagnostics`.

headless.js

@@ -1742,6 +1742,16 @@ class HeadlessSession {
     return { health, diagnostics }
   }
 
+  /** Journey stub: guild mesh stability stats (Phase 956). */
+  async runGuildMeshStabilityStatsJourney (guildId) {
+    if (!this.platform) throw new Error('headless not started')
+    const gid = guildId || this.platform.guild?.guild?.id
+    if (!gid) throw new Error('no guild')
+    const stats = this.platform.getMeshStabilityStats(gid)
+    await this.refreshView()
+    return { stats }
+  }
+
   /** Journey stub: export mesh registry validate e2e (Phase 954). */
   async runExportMeshRegistryValidateJourney () {
     if (!this.platform) throw new Error('headless not started')