post-audit: close remaining Tiny Actor, council integration, and build-doc drift gaps

[JeremyDev87]

Background

A fresh audit after the recent fixes found that the project is much healthier overall: build, typecheck, and hook tests are green, and earlier runtime issues around mode detection, data-dir consistency, and standalone behavior appear to be in much better shape.

However, the audit also found a small set of remaining gaps that matter because they affect visible behavior rather than internal plumbing.

These fall into three groups:

• Tiny Actor terminal output is partially implemented but still not fully width-safe or fully wired into real Claude Code terminal surfaces.
• The new council preset / consensus work exists in isolation but is not yet integrated into the main parse_mode response path.
• The plugin build still regenerates a README that drifts away from the current standalone-aware product behavior.

This parent issue tracks those remaining gaps.

Scope

In scope:

• Claude Code terminal-rendered plugin output, not the separate TUI
• Tiny Actor width safety, runtime integration, and persona fidelity
• MCP response integration for council preset / consensus data
• Build-generated plugin documentation drift

Out of scope:

• The command namespace migration work already tracked elsewhere
• Replacing every existing Buddy surface in one pass
• Large visual redesign beyond the Tiny Actor rollout

Why this matters

The remaining problems are subtle because many tests already pass. The issue is not that the codebase is unstable; it is that some newly added features are still incomplete at the final integration layer.

That means users can still run into:

• crooked Tiny Actor layouts with multilingual text
• a feature-flagged preview path that does not show up in normal Claude Code terminal output
• generic actor faces instead of the actual agent personas already defined in the repo
• council building blocks that exist in code but do not affect the real parse_mode response yet
• a build step that rewrites docs back to an older MCP-only stance

Acceptance criteria

This parent issue is complete when all of the following are true:

• Tiny Actor terminal output remains aligned under CJK, emoji, and ANSI cases
• Tiny Actor rendering uses the width-safe card/grid path instead of ad-hoc preview formatting
• Tiny Actor output is reachable from actual Claude Code terminal plugin surfaces behind an explicit flag or rollout gate
• Tiny Actor cards use real agent visual.eye metadata where available
• council preset / consensus data is emitted from the main MCP workflow in a way clients can actually consume
• the generated plugin README no longer reintroduces outdated MCP-required messaging

Sub-issues

• fix(plugin): make Tiny Actor Grid layout truly display-width-safe for CJK and ANSI text #1304 Make Tiny Actor Grid layout truly display-width-safe for CJK and ANSI text
• fix(plugin): make Tiny Actor preview use the width-safe renderer and grid pipeline #1303 Make Tiny Actor preview use the width-safe renderer and grid pipeline
• feat(plugin): wire feature-flagged Tiny Actor output into real Claude Code terminal surfaces #1302 Wire feature-flagged Tiny Actor output into real Claude Code terminal surfaces
• feat(plugin): derive Tiny Actor faces from each agent's visual.eye metadata #1301 Derive Tiny Actor faces from each agent's visual.eye metadata
• feat(mcp): emit council preset and consensus data from the main parse_mode response path #1300 Emit council preset and consensus data from the main parse_mode response path
• fix(plugin): stop build-generated README from reverting to outdated MCP-required messaging #1299 Stop build-generated README from reverting to outdated MCP-required messaging

Recommended order

1. fix(plugin): make Tiny Actor Grid layout truly display-width-safe for CJK and ANSI text #1304
2. fix(plugin): make Tiny Actor preview use the width-safe renderer and grid pipeline #1303
3. feat(plugin): wire feature-flagged Tiny Actor output into real Claude Code terminal surfaces #1302
4. feat(plugin): derive Tiny Actor faces from each agent's visual.eye metadata #1301
5. feat(mcp): emit council preset and consensus data from the main parse_mode response path #1300
6. fix(plugin): stop build-generated README from reverting to outdated MCP-required messaging #1299

[JeremyDev87]

All 6 sub-issues completed and merged:

• fix(plugin): stop build-generated README from reverting to outdated MCP-required messaging #1299 build README fix (PR fix(plugin): stop build-generated README from reverting to outdated MCP-required messaging (#1299) #1305) ✅
• feat(mcp): emit council preset and consensus data from the main parse_mode response path #1300 MCP council integration (PR feat(mcp): emit council preset and consensus data from parse_mode (#1300) #1307) ✅
• fix(plugin): make Tiny Actor Grid layout truly display-width-safe for CJK and ANSI text #1304 grid display-width fix (PR fix(plugin): make Tiny Actor Grid layout display-width-safe for CJK/ANSI (#1304) #1306) ✅
• fix(plugin): make Tiny Actor preview use the width-safe renderer and grid pipeline #1303 preview pipeline refactor (PR fix(plugin): make Tiny Actor preview use width-safe renderer and grid pipeline (#1303) #1314) ✅
• feat(plugin): wire feature-flagged Tiny Actor output into real Claude Code terminal surfaces #1302 terminal surface wiring (PR feat(plugin): wire feature-flagged Tiny Actor output into terminal surfaces (#1302) #1315) ✅
• feat(plugin): derive Tiny Actor faces from each agent's visual.eye metadata #1301 agent eye metadata (PR feat(plugin): derive Tiny Actor faces from agent visual.eye metadata (#1301) #1316) ✅

Post-audit gaps fully closed.