chore: 12-iter autonomous maintenance pass — dispose-hazard sweep, pana 160/160, RTL story

Twelve iterations of unattended package maintenance on a 9-min /loop. No
version bump (deferred to next release tag); all changes additive and
backwards-compatible. 278 → 330 tests, pana 160/160, zero analyzer issues.

Code quality:
- Timer-leak audit: `Future.delayed` / `Timer` calls across `lib/src/` are
  now tracked + cancelled in `dispose()` on `ChatMessagesController`,
  `ActionController`, `StreamingTextWidget`, `AnimatedBubble`,
  `CopilotTextarea`. Fixes the `!timersPending` test failures plus a
  latent `setState`-from-dispose crash in `CopilotTextarea._hideSuggestions`.
- StreamSubscription audit: `AgentOrchestrator` now tracks per-agent state
  subscriptions and cancels them on `unregisterAgent` / before its
  broadcast controllers close. Re-registering an agent under an existing
  id cancels the orphan.
- Frame-callback audit: `mounted` guards on the two real
  `addPostFrameCallback` hazards (`SmartChatInput` autoFocus,
  `CustomChatWidget` scroll-controller connection).

Tests (+52): new `test/agents/example_agents_test.dart` (21),
`test/controllers/agent_orchestrator_test.dart` (24 covering registration,
routing, delegation, collaboration, streaming, error handling, dispose,
stream-sub lifecycle), `test/widgets/dispose_hazard_test.dart`,
`test/widgets/rtl_chat_test.dart`.

Docs / SEO / discoverability:
- New `AGENTS.md` — LLM-tuned package reference for AI coding assistants
  picking dependencies.
- `pubspec.yaml` topics expanded to 10 (ai, chat, llm, streaming, agent,
  markdown, rtl, openai, anthropic, gemini); description rewritten.
- README: Quick Start moved above Features, new RTL section with verified
  snippet, install snippet bumped to ^2.11.1, example menu synced.
- Dartdoc raised on top public types (`AiChatWidget`,
  `ChatMessagesController`, `ChatMessage`, `AiActionProvider`,
  `AiActionConfig`, `AiActionHook`, `AiActionBuilder`, `AgentOrchestrator`)
  — class summaries, primary-constructor docs, runnable code-example
  blocks, per-member docs. `dart doc --validate-links` clean.

Dependencies:
- `flutter_streaming_text_markdown` ^1.4.0 → ^1.8.0 (lands the 1.7.0
  Arabic/RTL word-splitting fix + emoji-resume fix + trailing-fade fix).
- `google_fonts` ^8.0.1 → ^8.1.0.

Tooling:
- New `.github/workflows/ci.yml`: `dart format --set-exit-if-changed`,
  `flutter analyze --fatal-infos` (root + example), `flutter test` on
  push / PR to main. The formatter step exists because
  `flutter analyze` does not catch formatter drift and pana's
  lint+format check (50/50 of pub.dev score) silently dropped during
  iter 6 from a dartdoc edit exceeding 80 cols.

RTL example app:
- New `example/lib/examples/rtl_chat.dart` with `Directionality(rtl)` wrap
  and Arabic streaming markdown. Wired into `home_screen.dart` and
  `main.dart` (`/rtl` route).

Onboarding audit:
- `doc/ONBOARDING_AUDIT.md` — cold-read journey audit caught 4 broken
  code snippets in `AGENTS.md` and `ai_action_provider.dart` dartdoc that
  would not have compiled on first paste (`ActionParameter.integer`
  doesn't exist; `ActionResult.success(data:...)` should be
  `createSuccess(...)`; `updateMessage(id, text:...)` takes a `ChatMessage`).
  All fixed.

Verification:
- `flutter analyze` clean (root + example/).
- `flutter test` 330/330 pass.
- `dart format --output=none --set-exit-if-changed .` clean (153 files).
- `pana --no-warning` 160/160 across all 11 sections.
- Zero open issues, zero open PRs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: hooshyar

.github/workflows/ci.yml

@@ -0,0 +1,72 @@
+name: CI
+
+# Lightweight CI gate for the flutter_gen_ai_chat_ui package.
+#
+# What this catches:
+#   - Formatter drift (`dart format --set-exit-if-changed`). The local
+#     `flutter analyze` step does NOT catch formatter drift, and pub.dev's
+#     `pana` deducts 10 points if any file is unformatted (iter-7 of the
+#     internal maintenance log surfaced this as a real recurring risk
+#     introduced by dartdoc edits).
+#   - Static analyzer warnings (`flutter analyze`).
+#   - Unit + widget test regressions (`flutter test`).
+#
+# Intentionally not in scope here:
+#   - `dart pub publish --dry-run` (the user controls releases and
+#     gitignored-file state).
+#   - `pana` (slow; runs locally as part of the release-prep checklist).
+#   - Integration tests under `example/integration_test/` (require a
+#     running device/simulator; gated by the package's "do not run app on
+#     simulators in CI" policy).
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  analyze-format-test:
+    name: Analyze, format, and test
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+          cache: true
+
+      - name: Print Flutter and Dart versions
+        run: |
+          flutter --version
+          dart --version
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Check formatting
+        # The leading `dart format --set-exit-if-changed` is the iter-8
+        # guardrail. If any file is unformatted this step fails the build
+        # before analyze/tests run, surfacing the issue immediately.
+        run: dart format --output=none --set-exit-if-changed .
+
+      - name: Analyze
+        run: flutter analyze --fatal-infos
+
+      - name: Analyze example app
+        # The example/ directory has its own pubspec and is outside the
+        # package's analyzer scope. Iter-10 surfaced 9 lints there that
+        # the main `flutter analyze` step did not catch, so we gate
+        # example-app regressions explicitly.
+        run: |
+          cd example
+          flutter pub get
+          flutter analyze --fatal-infos
+
+      - name: Test
+        run: flutter test --reporter expanded