feat(plugins): add gv:debug:pluginScopes ledger dump

document.dispatchEvent(new Event('gv:debug:pluginScopes')) logs every
scope-based plugin's live side-effect ledger (effect labels keyed by
plugin id) for leak inspection, following the existing gv:debug:* event
pattern.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: Nagi-ovo

src/features/plugins/index.ts

@@ -33,17 +33,30 @@ export * from './types';
 
 let host: PluginHost | null = null;
 
+/**
+ * Debug: dump every scope-based plugin's live side-effect ledger. From the
+ * page console (extension context in DevTools):
+ *   document.dispatchEvent(new Event('gv:debug:pluginScopes'))
+ */
+export const PLUGIN_SCOPES_DEBUG_EVENT = 'gv:debug:pluginScopes';
+
+const dumpScopeLedgers = (): void => {
+  logger.info('Plugin scope ledgers', host?.getScopeLedgers() ?? {});
+};
+
 export function startPluginHost(): () => void {
   if (host) return () => {};
   try {
     host = new PluginHost();
     void host.start();
+    document.addEventListener(PLUGIN_SCOPES_DEBUG_EVENT, dumpScopeLedgers);
   } catch (error) {
     if (!isExtensionContextInvalidatedError(error)) {
       logger.error('startPluginHost failed', { error: String(error) });
     }
   }
   return () => {
+    document.removeEventListener(PLUGIN_SCOPES_DEBUG_EVENT, dumpScopeLedgers);
     host?.stop();
     host = null;
   };

src/features/plugins/runtime/PluginHost.ts

@@ -83,6 +83,11 @@ export class PluginHost {
     return this.adapter;
   }
 
+  /** Live side-effect ledgers of scope-based plugins, keyed by plugin id. */
+  getScopeLedgers(): Record<string, readonly string[]> {
+    return this.engine?.getScopeLedgers() ?? {};
+  }
+
   async start(): Promise<void> {
     if (this.started) return;
     this.started = true;

src/features/plugins/runtime/declarativeEngine.test.ts

@@ -168,6 +168,21 @@ describe('DeclarativeEngine', () => {
     expect(activate).toHaveBeenCalledOnce();
   });
 
+  it('getScopeLedgers reports live effect labels per scope-based plugin', () => {
+    registerNativeHandler('test.scoped-ledger', {
+      activate: (scope: PluginScope) => {
+        scope.effect(() => () => {}, 'my-effect');
+      },
+    });
+    const engine = new DeclarativeEngine({ doc: document });
+    engine.mount(makeManifest({}, 'test.scoped-ledger'));
+
+    expect(engine.getScopeLedgers()).toEqual({ 'test.scoped-ledger': ['my-effect'] });
+
+    engine.unmount('test.scoped-ledger');
+    expect(engine.getScopeLedgers()).toEqual({});
+  });
+
   it('a throwing activation rolls back what it already registered', async () => {
     const registered = vi.fn();
     registerNativeHandler('test.scoped-throw', {

src/features/plugins/runtime/declarativeEngine.ts

@@ -97,6 +97,15 @@ export class DeclarativeEngine {
     return this.active.size;
   }
 
+  /** Live side-effect ledger per scope-based plugin — debug/leak inspection. */
+  getScopeLedgers(): Record<string, readonly string[]> {
+    const ledgers: Record<string, readonly string[]> = {};
+    for (const [id, entry] of this.active) {
+      if (entry.scope) ledgers[id] = entry.scope.getEffects();
+    }
+    return ledgers;
+  }
+
   isActive(id: string): boolean {
     return this.active.has(id);
   }