Changed #

• Updated titan_envoy constraint to ^1.1.0 (transport abstraction layer)

Added #

Scry — Real-Time AI Agent Interface (18 Intelligence Capabilities)

• Scry — AI agent loop: observe screen → decide → act → observe result. Returns structured ScryGaze with all visible elements, screen type classification, form status, and spatial analysis.
• ScryGaze — Observation result with ScryElement list, ScryScreenType, alerts, and landmarks.
• ScryElement — Screen element with kind, label, value, semantics, position, and reachability metadata.
• ScryDiff — Compare screen states: appeared/disappeared/changed elements, route changes, overlay changes.
• 18 intelligence capabilities: spatial layout, reachability, scroll inventory, overlay detection, toggle states, tab order, target stability scoring, multiplicity, ancestor context, form validation, element grouping, landmarks, visual prominence, value type inference, action impact prediction, layout pattern detection.
• 16 action types: tap, enterText, clearText, scroll, back, longPress, doubleTap, swipe, navigate, waitForElement, waitForElementGone, pressKey, submitField, toggleSwitch, toggleCheckbox, selectDropdown.
• Multi-action support — scry_act accepts an actions array for batched execution.
• Drag action — scry_act supports drag with value="x,y" coordinate format.
• Screen type classification — ScryScreenType enum: login, form, list, detail, settings, empty, error, dashboard, unknown.
• Alert detection — ScryAlert with ScryAlertSeverity for framework error and performance issue highlighting.

Relay — Cross-Platform HTTP Bridge

• Relay — Platform-agnostic HTTP bridge connecting MCP server to running Flutter app.
  • Native (Android, iOS, macOS, Windows, Linux): HTTP server on port 8642
  • Web (Chrome, Firefox, Edge): WebSocket client connecting to MCP server's /relay endpoint (reversed connection)
• RelayConfig — Configuration with host, port, authToken, targetUrl.
• RelayHandler — 36 route handlers for all MCP tools.
• RelayStatus — Health reporting with uptime and platform info.
• Graceful port-in-use handling — WebSocket relay silently falls back on busy ports.

MCP Server — 48 Tools, 5 Transports

• Blueprint MCP Server — Full Model Context Protocol server with 48 tools across 11 categories.
• 5 Transport protocols: stdio, HTTP+SSE, WebSocket, Streamable HTTP (MCP 2025-03-26), auto-detect (all-in-one).
• TLS/SSL support — --tls-cert and --tls-key for encrypted connections across all HTTP transports.
• Bearer token authentication — --auth-token (repeatable) for secure access. Health endpoint remains public.
• API key rotation — --auth-tokens-file with hot-reload: file changes detected automatically, zero-downtime key rotation without server restart.
• McpWebSocketClient — Dart client with auto-reconnect, exponential backoff (±25% jitter), heartbeat/pong, message queuing, and McpConnectionStatus stream.
• Screenshot vision — capture_screenshot saves PNG to .titan/screenshots/ and returns MCP image content for AI visual analysis.
• toggle_lens — Show/hide Lens FAB during MCP sessions.

New MCP Tools (17 tools added since 1.3.0)

• get_api_metrics — API metrics with latency percentiles (p50/p95/p99), success rate, endpoint grouping
• get_api_errors — Failed API requests for quick error triage
• get_tremors — Current Tremor alert thresholds
• add_tremor — Add Tremor alerts at runtime (8 types: fps, jankRate, pageLoad, memory, rebuilds, leaks, apiLatency, apiErrorRate)
• remove_tremor — Remove Tremor by name
• reset_tremors — Reset all Tremor fired states
• get_widget_tree — Widget tree statistics (element count, max depth, top 20 types)
• get_events — Integration events from Colossus bridges (atlas, basalt, argus, bastion)
• get_route_history — Navigation route history in chronological order
• replay_session — Replay saved Shade sessions via Phantom
• capture_screenshot — Screenshot with disk save + inline image content
• audit_accessibility — Accessibility audit (labels, touch targets, semantic roles)
• inspect_di — Titan DI container (Vault) inspection
• inspect_envoy — Envoy HTTP client configuration and courier chain
• configure_envoy — Runtime Envoy configuration (base URL, timeouts, headers, couriers)
• reload_page — Re-navigate current route or full widget tree rebuild
• toggle_lens — Show/hide Lens debug FAB

Cross-Package Integration Bridges

• ColossusEnvoy — Auto-wires Envoy MetricsCourier metrics to Colossus for API tracking.
• ColossusBasalt — Bridge for Basalt infrastructure events (circuit trips, saga steps, etc.).
• ColossusBastion — Bridge for Bastion widget lifecycle events.
• ColossusAtlasObserver — Bridge for Atlas navigation events and page load timing.
• ColossusArgus — Bridge for Argus authentication state changes.
• Colossus.trackEvent() — Unified event ingestion from all bridges.

Lens Integration Tabs

• BridgeLensTab — Cross-package event visualization with source filtering.
• EnvoyLensTab — HTTP traffic visualization (requests, latency, errors, courier chain).
• ArgusLensTab — Auth session tracking (sign-in/sign-out events, token refreshes).

Error Detection

• FrameworkError — Captures FlutterError.onError and ErrorWidget instances for overflow, build, layout, paint, and gesture errors.
• get_framework_errors MCP tool for error reporting.

Performance Monitoring Enhancements

• API Tremors — apiLatency and apiErrorRate Tremor types for HTTP monitoring.
• MarkCategory.api — New metric category for API-related marks.
• Richer API reporting — Latency percentiles, endpoint auto-grouping (numeric IDs and UUIDs normalized).

Changed #

• FAB hidden during recording — Lens FAB auto-hides when Shade recording is active.
• Tooltip → Semantics — Lens FAB uses Semantics widget instead of Tooltip to avoid "No Overlay" crash (Lens wraps above MaterialApp).
• Lens.relayConnected — ValueNotifier<bool> for reactive FAB visibility control via MCP.
• Updated dependencies — titan_atlas: ^1.1.1, titan_argus: ^1.0.4.

Fixed #

• Web relay query params — WebSocket relay now parses path with Uri.tryParse() to strip query params before route matching.
• Scry proximity pairs — Reject distant horizontal proximity pairs.
• Interactive multiplicity — Suppress duplicate interactive element detection.
• NavigationBar targeting — Classify NavigationDestination as interactive for correct tap targeting.
• Semantics label discovery — widget.properties.label for Lens FAB detection in Scry glyph scanner.

Added #

AI Blueprint Generation — Six-Phase Discovery & Testing Engine

• Scout — Passive session analyzer that builds a flow graph (Terrain) from recorded Shade sessions. Discovers screens, transitions, and interactive elements automatically.
• Terrain — Flow graph model storing discovered routes (Outposts), transitions (Marches), and structural metadata (dead ends, unreliable transitions, auth-protected screens). Exports to Mermaid diagrams and AI-ready maps.
• Outpost — Discovered screen node with route pattern, interactive elements, display elements, and dimensional info.
• March — Discovered transition edge with source/destination routes, trigger type, trigger element, timing, and reliability score.
• Lineage — Prerequisite chain resolver that computes the navigation steps required to reach any screen from the app's entry point. Outputs AI-consumable setup instructions.
• Gauntlet — Edge-case test generator that produces targeted Stratagems for specific screens based on their interactive elements (taps, long-presses, text inputs, scrolls, boundary values).
• Stratagem — Executable test step specification with route, action, expected outcomes, and metadata. Serializable to/from JSON for AI consumption. Includes StratagemRunner for headless execution.
• Campaign — Multi-route test orchestrator that sequences Stratagems across flows, managing setup, execution, and teardown. Supports JSON campaign definitions.
• Verdict — Per-Stratagem execution result with pass/fail, timing, error details, and captured Tableau snapshots. Rich equality and serialization.
• Debrief — Verdict analyzer that produces structured reports with pass/fail ratios, failure categorization, fix suggestions, and AI-ready summaries.
• RouteParameterizer — Normalizes dynamic route segments (e.g., /user/42 → /user/:id) for consistent terrain mapping.
• Signet — Screen identity fingerprint using interactive element hashing for change detection across sessions.

AI-Bridge Export — Bringing Blueprint Data to IDE-Time AI Assistants

• BlueprintExport — Structured container for exporting Terrain, Stratagems, Verdicts, and Debrief results to disk. Factory constructors fromScout() (live app) and fromSessions() (offline analysis). Serializes to JSON via toJson()/toJsonString() and generates AI-ready Markdown prompts via toAiPrompt().
• BlueprintExportIO — File I/O utilities: save() writes blueprint.json, savePrompt() writes blueprint-prompt.md, saveAll() writes both. loadTerrain() and loadSessions() for offline consumption. Auto-creates directories.
• Export CLI (bin/export_blueprint.dart) — Command-line tool for offline Blueprint export from saved Shade sessions. Flags: --sessions-dir, --output-dir, --patterns (comma-separated route patterns), --intensity (quick/standard/thorough), --prompt-only, --help.
• Blueprint MCP Server (bin/blueprint_mcp_server.dart) — Model Context Protocol server exposing Blueprint data to AI assistants (Copilot, Claude) over stdio. Tools: get_terrain (json/mermaid/ai_map), get_stratagems, get_ai_prompt, get_dead_ends, get_unreliable_routes, get_route_patterns. File-level caching with automatic invalidation.
• blueprintExportDirectory on ColossusPlugin — Set a directory path (e.g., '.titan') and the plugin auto-exports blueprint.json + blueprint-prompt.md on app shutdown via onDetach(). Fire-and-forget for zero-friction developer experience.

Blueprint Lens Tab — Interactive Debug Overlay

• BlueprintLensTab — Lens plugin with five interactive sub-tabs:
  • Terrain — Live flow graph metrics (screens, transitions, sessions, dead ends, unreliable transitions) with reactive auto-refresh
  • Lineage — Route selector and prerequisite chain viewer with copy-to-clipboard actions
  • Gauntlet — Edge-case generator with intensity selector, stratagem cards, and pattern count display
  • Campaign — JSON campaign builder with execute/copy actions and result display
  • Debrief — Verdict analysis with insights, fix suggestions, and AI summary export

Zero-Code Auto-Integration

• autoLearnSessions — When true (default), completed Shade recordings are automatically fed to Scout. No manual learnFromSession() wiring needed.
• terrainNotifier — ChangeNotifier that fires after every learnFromSession() call. Blueprint Lens Tab subscribes automatically for live-updating metrics.
• autoAtlasIntegration — When true (default), ColossusPlugin automatically:
  • Registers ColossusAtlasObserver for page-load timing via Atlas.addObserver()
  • Pre-seeds RouteParameterizer with declared Atlas route patterns via Atlas.registeredPatterns
  • Auto-wires Shade.getCurrentRoute via Atlas.current.path (only if not user-provided)
  • Gracefully degrades if Atlas is not present or not initialized
• enableTableauCapture — Defaults to true in ColossusPlugin (vs false in Colossus.init() for backward compatibility). Required for Scout discovery.

Changed #

• ColossusPlugin — Three new configuration parameters: enableTableauCapture, autoLearnSessions, autoAtlasIntegration. All default to true for zero-configuration setup.
• Colossus.init() — New autoLearnSessions parameter (default: true). Colossus now owns the Shade → Scout → Terrain pipeline internally.

Fixed #

• Shade session persistence — Recorded sessions now survive Lens hide/show cycles. Session is stored on Colossus instance instead of disposed Pillar.

Added #

• Auto-show Lens after FAB stop — Lens overlay automatically opens when stopping a recording via the floating action button.
• Draggable FAB — Lens floating button can be dragged to any position. Position persists across hide/show. Added Lens.resetFabPosition() to restore defaults.

Changed #

• Plugin tabs first — Plugin tabs (Shade) now appear before built-in tabs (Pillars, Herald, Vigil, Chronicle) in the Lens panel.

Added #

• ColossusPlugin — One-line TitanPlugin adapter for full Colossus integration. Add or remove performance monitoring with a single line in Beacon(plugins: [...])
  • Manages Colossus.init(), Lens overlay, ShadeListener, export/route callbacks, auto-replay, and Colossus.shutdown() automatically

Changed #

• Assert → Runtime Errors: Phantom speedMultiplier validation and Colossus.instance guard changed from debug-only assert to runtime errors (ArgumentError / StateError)

Changed #

• Updated titan dependency to ^1.1.0

Added #

• Example file for pub.dev documentation score

Changed #

• Updated titan dependency to ^1.0.1
• Updated titan_bastion dependency to ^1.0.1
• Updated titan_atlas dependency to ^1.0.1

• Lens — Lens, LensPlugin, and LensLogSink moved here from titan_bastion. Import from package:titan_colossus/titan_colossus.dart.

• Initial release
• Colossus — Enterprise performance monitoring Pillar
• Pulse — Frame metrics (FPS, jank detection, build/raster timing)
• Stride — Page load timing with Atlas integration
• Vessel — Memory monitoring and leak detection
• Echo — Widget rebuild tracking
• Tremor — Configurable performance alerts via Herald
• Decree — Performance report generation
• Lens integration — Plugin tab for the Lens debug overlay
• ColossusAtlasObserver — Automatic route timing via Atlas