feat(dashboard): actor picker for the Sync Capability Inspector

The Capability Inspector silently auto-sampled the first hero actor (often a
stray like "Festival 1"), with no way to choose which character to inspect —
confusing GMs who never "selected" anything yet saw a name they didn't pick.

Add a dropdown of all actors of the synced type (linked ones flagged
"✓ synced"). The panel re-samples against the chosen actor. Until a pick is
made it still auto-picks (first linked, else first of type) and now says so
explicitly in the hint. Selection is per-session instance state, like the
existing search filter.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LaDDiXB5GTVurEzJwYYopf

Author: claude

scripts/sync-dashboard.mjs

@@ -122,6 +122,14 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
     /** @type {string} Current search filter text. */
     this._searchFilter = '';
 
+    /**
+     * @type {string|null} Actor id the GM chose to inspect in the Status tab's
+     * Capability Inspector. Null = auto-pick (first linked, else first of type).
+     * Per-session instance state (like _searchFilter): survives re-renders,
+     * resets when the dashboard window is closed.
+     */
+    this._capabilityActorId = null;
+
     /** @type {string} Currently active tab (persisted per-client). */
     this._activeTab = getSetting('dashboardActiveTab') || 'entities';
 
@@ -1026,14 +1034,36 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
     );
     const actorType = actorSync?._actorType || actorSync?._adapter?.actorType || 'character';
 
-    // Sample a representative actor: prefer a linked one, else the first of the type.
     const ofType = (game.actors?.contents || []).filter((a) => a?.type === actorType);
-    const sample = ofType.find((a) => a.getFlag?.(FLAG_SCOPE, 'entityId')) || ofType[0] || null;
+
+    // Which actor to inspect. If the GM picked one (and it still exists), use it;
+    // otherwise auto-pick a representative actor: prefer a Chronicle-linked one,
+    // else the first of the type. `autoPicked` drives the UI hint so the GM knows
+    // the panel chose for them and can switch with the dropdown.
+    const chosen = this._capabilityActorId
+      ? ofType.find((a) => a.id === this._capabilityActorId)
+      : null;
+    const autoPicked = !chosen;
+    const sample = chosen
+      || ofType.find((a) => a.getFlag?.(FLAG_SCOPE, 'entityId'))
+      || ofType[0]
+      || null;
     if (!sample) {
       this._capabilityReport = null;
-      return { available: false, actorType, error: `no "${actorType}" actor to sample` };
+      return { available: false, actorType, actors: [], error: `no "${actorType}" actor to sample` };
     }
 
+    // The full pick-list for the dropdown (linked actors flagged so the GM can
+    // tell which heroes already sync to Chronicle).
+    const actors = ofType
+      .map((a) => ({
+        id: a.id,
+        name: a.name || '(unnamed)',
+        linked: !!a.getFlag?.(FLAG_SCOPE, 'entityId'),
+        selected: a.id === sample.id,
+      }))
+      .sort((x, y) => x.name.localeCompare(y.name));
+
     // Fetch the system's declared character fields (same source the adapter uses).
     let fieldDefs = { fields: [] };
     try {
@@ -1050,6 +1080,8 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
     return {
       available: !!report.ok,
       actorType,
+      actors,
+      autoPicked,
       summary: report.summary,
       source: report.source,
       gaps: this._capabilityGaps(report),
@@ -1263,6 +1295,17 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
       });
     });
 
+    // --- Status tab: Capability Inspector actor picker ---
+    // ApplicationV2 `actions` only delegate `click`, so the `<select>` change is
+    // wired here directly. Picking an actor re-renders the panel against it.
+    const capActorSelect = el.querySelector('.capability-actor-select');
+    if (capActorSelect) {
+      capActorSelect.addEventListener('change', (e) => {
+        this._capabilityActorId = e.currentTarget.value || null;
+        this.render({ force: true });
+      });
+    }
+
     // Map tab handlers are wired via the `open-map-journal` action above;
     // no additional select listeners are needed in Path B.
   }

styles/chronicle-sync.css

@@ -1166,6 +1166,25 @@
   font-size: 12px;
 }
 
+/* Capability Inspector actor picker (Status tab) */
+.capability-actor-picker {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 10px;
+}
+
+.capability-actor-picker label {
+  font-size: 12px;
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.capability-actor-picker .config-select {
+  flex: 1;
+  min-width: 0;
+}
+
 .error-value {
   color: #ef4444 !important;
 }

templates/sync-dashboard.hbs

@@ -1004,7 +1004,15 @@
         {{#if capability}}
         <h3 class="section-heading">Sync Capability</h3>
         {{#if capability.available}}
-        <p class="config-hint">What a Foundry actor exposes vs what Chronicle currently syncs — sampled from <strong>{{capability.source.actorName}}</strong> (type <code>{{capability.source.actorType}}</code>).</p>
+        <p class="config-hint">Compares what a Foundry actor exposes against what Chronicle currently syncs.{{#if capability.autoPicked}} Auto-picked <strong>{{capability.source.actorName}}</strong> (the first <code>{{capability.source.actorType}}</code> actor) — pick a different one below to inspect it.{{else}} Inspecting <strong>{{capability.source.actorName}}</strong> (type <code>{{capability.source.actorType}}</code>).{{/if}}</p>
+        <div class="capability-actor-picker">
+          <label for="capability-actor-select">Inspect actor:</label>
+          <select id="capability-actor-select" class="config-select capability-actor-select">
+            {{#each capability.actors}}
+            <option value="{{id}}" {{#if selected}}selected{{/if}}>{{name}}{{#if linked}} ✓ synced{{/if}}</option>
+            {{/each}}
+          </select>
+        </div>
         <div class="diagnostics-detail">
           <div class="system-info-row"><span class="system-label">Synced:</span><span class="system-value">{{capability.summary.synced}} / {{capability.summary.totalDeclared}} declared</span></div>
           <div class="system-info-row"><span class="system-label">Declared, unmapped:</span><span class="system-value">{{capability.summary.declaredUnmapped}}</span></div>