omega_architecture 1.1.0

A reactive, agent-based architecture framework for Flutter applications.

1.1.0

• [OmegaTypedIntent] / [OmegaFlowManager.handleTypedIntent]: intents con tipo que implementan [OmegaIntentName]; el mismo objeto aporta el wire name y el payload. En el flow, lectura con [OmegaIntentTypedPayloadExtension.typedPayloadAs] (ver omega_typed_intent.dart y documentación en [OmegaFlowContext]).
• [OmegaFlowManager]: ajustes en el ciclo de intents y navegación cableada al canal; pruebas ampliadas en omega_flow_manager_test.dart.
• [OmegaNavigator]: reglas más claras para ids de ruta y alineación con intents navigate.* (documentado en la guía de navegación).
• Semántica / eventos: refuerzos en [OmegaIntent], [OmegaEvent] y tipado de eventos; [OmegaSequencer] para ordenación en el canal.
• Ejemplo (auth): alineado con el modelo de intents/eventos y navegación actual.
• Documentación (sitio VitePress): guía Observability & statistics, diagrama SVG de panel de métricas (ilustrativo), componente OmegaObservabilityDashboard, texto “What each panel means” en la home y en la guía; ampliación de Widgets y enlaces del inspector; README reestructurado.

1.0.5

• CLI omega validate + arranque en frío: Antes de analizar, aplica correcciones deterministas en omega_setup.dart (deduplicar listas, initialFlowId / initialNavigationIntent cuando hay rutas y flows). El parche ya no exige app tipo Auth + varias rutas: infiere el primer flow (super(id:…)), el intent desde los OmegaRoute(id:…) y el AppIntent, y puede añadir un navigate… en app_semantics.dart si falta. Prompts de IA reforzados para no omitir esos campos en JSON.
• omega validate — ids de ruta: Rechaza OmegaRoute(id: …) con mayúsculas en el string (contrato [OmegaNavigator] + wires navigate.* en minúsculas).
• IA / HEAL — navegación: Reglas explícitas: OmegaRoute.id en minúsculas; [OmegaNavigator] quita solo el prefijo inicial navigate. / navigate.push. (p. ej. navigate.user.profile → id user.profile); ejemplo navigateAuthPerfil → auth.perfil; registerInOmegaSetup (omega g ecosystem) calcula el id con la misma regla DottedCamel que OmegaIntentNameDottedCamel (ya no usa el nombre PascalCase del módulo salvo casos Auth/Home → login / home).
• Documentación (Windows / PATH): README, doc/COMANDOS_CLI.md y doc/GUIA.md detallan añadir %LOCALAPPDATA%\Pub\Cache\bin (ruta expandida típica C:\Users\<usuario>\AppData\Local\Pub\Cache\bin) al Path del usuario, cierre de terminales y comprobación con where omega / omega --help.
• Docs / Omega Studio: Pub no admite dart pub global run ni flutter pub global run para paquetes con dependencia de Flutter; sin omega en PATH hay que usar el shim (omega.bat / ruta completa) o dart run omega_architecture:omega desde un proyecto. Omega Studio solo invoca ese shim en Pub/Cache/bin (búsqueda ampliada en Windows).

1.0.4

• omega validate: El bloque routes: se detecta también como routes: [...] (sin <OmegaRoute>), igual que routes: <OmegaRoute>[...], para extraer id: y aplicar duplicados + reglas de arranque en frío cuando hay rutas y flows. Comprueba AppIntent.navigateRoot ↔ OmegaRoute(id: 'root') si aparece en el setup.
• IA / plantilla: Kickstart ya no fuerza módulos Auth/Home en el planner; omega init deja AppIntent.navigateRoot por defecto. Prompts _omegaAiColdStartShell y checklist: siempre initialFlowId + initialNavigationIntent alineados con rutas; Login/Home solo si el producto lo pide.
• CLI omega create app: Tras generar módulos y main.dart, se aplica un paso final sobre lib/omega/omega_setup.dart: renombrar rutas legacy Auth → login y Home → home (contrato [OmegaNavigator] con AppIntent.navigateLogin / navigateHome) e insertar initialFlowId + initialNavigationIntent cuando el setup califica (Auth + varias rutas). registerInOmegaSetup registra ya login / home para los módulos Auth y Home.
• Sanación / IA: Catálogo tool/omega_heal_catalog.yaml — reglas match_groups + textos HEAL; el CLI los inyecta tras “ANALYZER ERRORS”. bin/omega_heal_catalog.dart carga el YAML desde la raíz del paquete (OMEGA_PACKAGE_ROOT / script). OMEGA_HEAL_CATALOG=false desactiva; dependencia yaml. Incluye (entre otras): emit del canal, fromName String vs enum, payloads falsos (OmegaIntentPayload), omega_setup sin agent, OmegaFlowContext sin APIs inventadas, imports Flow/Agent en setup, navigationIntent, enum Event / emit del agente, equatable/intl/OmegaViewState/viewStateStream, tipos faltantes en *_events.dart, nullable en UI. Las recetas equivalentes dejaron de duplicarse en bin/omega.dart (solo quedan hints dinámicos del validador + pubspec).

1.0.3

• CLI / IA (bin/omega.dart): Reglas y receta de heal para no confundir OmegaChannel.emit(OmegaEvent) con OmegaAgent.emit(String, {payload}); reforzar OmegaEvent.fromName (enum + payload: / puente desde ctx.intent?.payloadAs).
• Documentación: OmegaEventBus.emit, OmegaEvent.fromName y OmegaIntent.fromName aclaran firma y anti‑patrones en el paquete.

1.0.2

• omega validate: Detecta OmegaRoute con id: duplicado dentro de routes:; duplicados en agents: por la misma variable repetida (p. ej. dos veces orderManagementAgent) además de dos FooAgent(channel); duplicados en flows: por tipo (UserManagementFlow dos veces). Los chequeos se limitan al cuerpo de cada lista (menos falsos positivos). Prompts MASTER + heal compact reforzados con ejemplo explícito y remisión a omega validate.
• [OmegaAgent] / [OmegaFlow] (contratos en debug): El aviso “not in contract” en agentes solo aparece si el [OmegaAgentBehaviorEngine] tiene una reacción para ese evento/intent y el contrato no lo declara (evita ruido del bus compartido). En flows, el aviso por eventos solo si el flow escucha un [OmegaChannelNamespace] y el evento trae el mismo namespace (no se avisa por globales u otros módulos); intents y emitExpression siguen comprobándose como antes.
• [OmegaConfig] / [OmegaRuntime]: Campo opcional initialNavigationIntent — declara en omega_setup la primera pantalla Omega (navigate.*) junto a initialFlowId. [OmegaScope.initialNavigationIntent] + widget [OmegaInitialRoute] (solo child) evitan pasar el intent por MyApp; [OmegaInitialNavigationEmitter] sigue disponible para un intent explícito. Ejemplo y plantilla omega create app alineados.
• [OmegaWorkflowFlow]: Default implementations of [onIntent] / [onEvent] (no-op) so subclasses that only use [defineStep] + [startAt]/[next] compile without being forced to add empty overrides ([OmegaFlow] still requires those members). IA / CLI: prompts for workflow flows now state that super must receive id + channel, that [defineStep] does not run until [startAt] or [next], and that contracts should list workflow.step / workflow.error / workflow.done.
• IA / OmegaWorkflowFlow: _omegaAiOmegaWorkflowFlow exige defineStep con handler sin argumentos (FutureOr<void> Function() — nunca (OmegaFlowContext ctx)); ctx solo en onIntent/onEvent; evitar emitExpression + next duplicando el mismo tipo en onEvent y en el step. Heal compact + MASTER CHECKLIST §4 alineados.
• IA / documentación: Clase OmegaAiCommand documentada (rol de cada _omegaAi* + composición de prompts). Nuevo bloque de prompt _omegaAiConceptualArchitecture (scope mínimo, handleIntent vs channel, de dónde salen los agentes, por qué inventar APIs falla) en módulo y heal; comentarios /// en fragmentos de prompt principales.
• IA / main.dart: Bloque _omegaAiMainDartEntry (heal + módulo): copiar estructura de example/lib/main.dart (async main, inspector web/VM, OmegaScope con initialNavigationIntent, OmegaInitialRoute + RootHandler); plantilla omega create app alineada. MASTER CHECKLIST + _omegaAiConceptualArchitecture / heal compact citan initialNavigationIntent en [OmegaScope].
• IA / navegación: Bloque _omegaAiNavigationChannelEmit (módulo + heal): patrón canónico AppEvent.navigationIntent + OmegaIntent.fromName(AppIntent.navigateHome) con import de app_semantics; prohibido OmegaIntent.fromName('navigate.home') y placeholders en string. _omegaAiPagePassSanity acepta AppIntent. además de intents del módulo cuando hay OmegaIntent.fromName.
• IA / FlowActivator + FlowManager: _omegaAiFlowActivatorAndFlowManager documenta OmegaFlowActivator, OmegaFlowManager (sin getAgent) y OmegaScope sin agentManager / agentManager.getAgent('…') (patrón inventado en formularios). _omegaAiAgentUiStateListening, heal compact y MASTER CHECKLIST §5 Forbidden refuerzan lo mismo.
• IA / agent UI: Nuevo bloque _omegaAiAgentUiStateListening en prompts (módulo + heal): explica viewState + setViewState, stateStream/viewStateStream, que OmegaAgentWidgetBuilder es solo (BuildContext, TState), que OmegaScopedAgentBuilder no admite firmas tipo Provider (context, agent, state, child); MASTER CHECKLIST + _omegaAiAgentBehaviorApi + plantilla decoupled alineados.
• IA / pasos: STEPWISE reforzado (pipeline events → behavior → agent → flow → page; prohibido adelantar página/flujo antes de fijar nombres en events). reasoning del módulo completo debe ir numerado 1)–5) por fase; heal pide arreglos mínimos por archivo en lugar de reescribir todo de golpe; UI-only deja claro que es un solo paso (solo page).
• IA / fidelidad: Prompts añaden _omegaAiOmegaSourceOfTruth: solo API pública package:omega_architecture/omega_architecture.dart, reglas del propio prompt y PACKAGE GROUND TRUTH; prohibido inventar APIs Omega, imports internos del paquete y capas extra (BLoC/Riverpod/GetX) salvo petición explícita; priorizar solución mínima que compile. Heal y system strings refuerzan “solo lo adjunto + ejemplos”.
• IA / tokens: Heal ya no pega el MASTER CHECKLIST completo ni el bloque largo duplicado de API; usa _omegaAiHealPromptCompactOmega + roles + canal + SCREEN ENTRY. Generación de módulo deja de incluir el bloque repetido OMEGA SCOPE (queda en el MASTER CHECKLIST). PACKAGE GROUND TRUTH: menos archivos de ejemplo (sin provider_flow / orders_flow / duplicado lib/omega/app_runtime_ids), límites maxEachExample/maxTotal más bajos; README y doc/ARQUITECTURA.md solo si OMEGA_AI_ATTACH_PACKAGE_DOCS=true (por defecto no se adjuntan para ahorrar tokens).
• IA: MASTER CHECKLIST section 6 + generación de módulo citan example/lib/omega/omega_setup.dart como registro canónico (agents: + flows: con la misma instancia de agente). PACKAGE GROUND TRUTH prioriza omega_setup + flujo auth de ejemplo; flujos extra con deps nombradas se documentan en GUIA sin duplicar todo el ejemplo en el prompt.
• IA / JSON: si el modelo emite en el JSON una barra invertida suelta delante de $ (p. ej. texto Dart tipo Total: \\$ + interpolación), jsonDecode fallaba (FormatException: Unrecognized string escape). El CLI aplica sanitizeAiJsonTextForDecode antes de parsear respuestas de módulo y heal; regla 10 en prompts pide concatenación u escapes JSON válidos.
• IA / imports: _providerGenerateModuleCode recibe el name: real del pubspec (getPackageName) e inyecta PROJECT PUBSPEC NAME + pasos (events → behavior → agent → flow → page) y ejemplos package:<id>/omega/... con ese id; el heal añade APP PUBSPEC. El MASTER CHECKLIST deja de usar <pubspec_name> literal — indica THE_EXACT_PUBSPEC_NAME / bloque del prompt para no inventar delivery_app cuando el proyecto es my_ai_app.

1.0.1

• [OmegaFlow.uiScopeAgent]: optional getter (default null). When a flow subclass returns its primary UI [OmegaAgent], [OmegaFlowExpressionBuilder] wraps the builder result in [OmegaAgentScope] so [OmegaScopedAgentBuilder] resolves the agent without wrapping the whole route. Override in flows that own one agent for the screen (same instance the flow uses).
• [OmegaFlowManager.getFlowFlexible]: resolves a flow when the id matches a registered key ignoring ASCII case (e.g. route UserInterface vs enum wire userInterface). [OmegaFlowExpressionBuilder] uses it so [OmegaFlow.uiScopeAgent] / expressions still apply when ids differ only by casing. [OmegaFlowManager.registeredFlowIds] for debugging. Debug logs when no flow matches or when uiScopeAgent is null but subtree may need scope.
• CLI registerInOmegaSetup: If *_flow.dart declares required this.agent or required ModuleAgent agent, the setup now adds a single final moduleAgent = ModuleAgent(channel), includes it in agents:, and registers ModuleFlow(channel: channel, agent: moduleAgent) (same variable). Heal recipe notes the same. Example omega_setup.dart documents the pattern.
• Example: AuthFlow, ProviderFlow and OrdersFlow take {required channel, required agent} (and OrdersFlow also offlineQueue); each overrides [OmegaFlow.uiScopeAgent]. Added OrdersAgent + orders_behavior.dart and AppAgentId.orders. omega_setup wires one instance per agent into agents: and into the matching flow.
• CLI / IA (bin/omega.dart): MASTER CHECKLIST y plantilla omega g ecosystem documentan dependencias extra en el flujo (p. ej. offlineQueue, repos): no son agentes; se crean una vez en createOmegaConfig y se pasan nombradas al constructor; el ecosistema generado por defecto solo añade channel + agent.

1.0.0

• omega init: Also creates lib/omega/app_runtime_ids.dart (enums AppFlowId / AppAgentId with placeholder members) when missing, same as app_semantics.dart. omega g ecosystem: Requires that file (run omega init first); merges new ids and generates flow/agent with AppFlowId.<id>.id / AppAgentId.<id>.id (invalid CLI name chars become _ in the enum wire).
• [OmegaFlowId] / [OmegaAgentId] with [OmegaFlowIdEnumWire] / [OmegaAgentIdEnumWire]: typed flow/agent ids (example app_runtime_ids.dart). [OmegaFlowActivator] accepts flowId as [String] or [OmegaFlowId]; calls [activate]/[switchTo] once (OmegaLoginPage, _RootHandler, HomePage, ProviderPage).
• Intent handlers: [OmegaFlowManager.registerIntentHandler] / [OmegaFlowManager.clearIntentHandlers] run before intents reach running flows; consumeIntent: true skips flow delivery. [Omega.handle] is a thin static alias; [OmegaIntentReducer] holds reducer-style state updates. [OmegaIntentHandlerPipeline] fluent validate → execute → onSuccess / onError / onPayloadMissing → register. doc/GUIA.md adds “Intent handlers: qué elegir (DX)”.
• OmegaIntentNameEnumWire / OmegaIntentNameDottedCamel: enum intents without per-case string literals; [OmegaIntentNameDottedCamel] derives dotted wires from camelCase (ordersCreate → orders.create) via [omegaWireNameFromCamelCaseEnumMember]. OmegaEventNameEnumWire / OmegaEventNameDottedCamel: same for events. Demo: example/lib/demo/demo_counter_intent.dart.
• Example app_semantics: AppEvent / AppIntent migrated to dotted-camel mixins; createOrder renamed to ordersCreate for wire orders.create. omega init default template and omega g ecosystem _events.dart use the same pattern.
• OmegaConfig.intentHandlerRegistrars: optional OmegaIntentHandlerRegistrar list run at end of [OmegaRuntime.bootstrap] (after [OmegaFlowManager.wireNavigator]) so [Omega.handle] registration lives next to flows/routes instead of main.
• UI decoupling: [OmegaAgentScope] exposes an [OmegaAgent] to descendants without threading it through every widget constructor; [OmegaScopedAgentBuilder] is [OmegaAgentBuilder] that reads the agent from scope. [OmegaFlowExpressionBuilder] listens to [OmegaFlow.expressions] by flow id (uses [OmegaFlow.lastExpression] for initial [StreamBuilder] data). [OmegaFlow.lastExpression] getter added. doc/GUIA.md documents usage; Omega AI prompts in bin/omega.dart instruct models to prefer these APIs when decoupling pages from agents.

0.0.33

• omega init: Creates lib/omega/app_semantics.dart next to omega_setup.dart (minimal AppEvent / AppIntent). If omega_setup.dart already exists, running init again adds only the missing semantics file (no --force on setup).
• registerInOmegaSetup / coach: Detects pages with required this.agent and final …Agent agent; upgrades routes from const FooPage() to FooPage(agent: …); strips and re-adds agent/flow/page imports in a loop to avoid duplicates; runs registerInOmegaSetup again after the advanced/IA template so omega_setup matches the final page.
• Self-healing: Includes each module’s *_events.dart when errors touch that folder; recipes for missing ViewState / typed events, nullable OmegaAgentBuilder state, and channel.emitTyped vs bogus “methods” on the agent; optional dart pub add when the analyzer reports missing package: URIs (OMEGA_AI_HEAL_PUB_ADD, default on); slightly larger file context and stricter prompts.
• Imports: Deduplicates identical import / export lines when applying heal JSON and when writing coach module files; dedupe pass on omega_setup after registration; heal + artifact guide forbid duplicate imports in omega_setup.
• Docs in prompts: omega_setup checklist mentions app_semantics and single import per URI.

0.0.32 (CLI & AI Redesign Support)

• New Command omega ai coach redesign: Dedicated command to redesign existing modules or UI screens by providing current code as context to the AI.
• AI Redesign Support: omega ai coach module also detects existing module files for evolutionary updates.
• Improved AI Prompts: Strengthened instructions to prevent placeholder UIs and ensure consistent Material 3 usage.
• Contract Mismatch Reduction: Silence false-positive debug warnings on shared global channels.
• Audit Tool Fixes: Enhanced registration detection for agents, flows, and routes in omega_setup.dart.
• VS Code Extension Integration: Added omega_studio for one-click AI-powered module redesigns.
• Self-Healing Enhancements: More robust parsing of analyzer output for iterative AI fixes.
• Docs: Added doc/COMANDOS_CLI.md (Spanish CLI reference for developers). README.md and doc/GUIA.md link to it; README Omega CLI section now includes inspector and ai coach redesign / coach flags.
• Web docs: presentation/index.html and presentation/index-en.html — CLI section adds inspector tab, link to COMANDOS_CLI.md / README, expanded ai coach (module flags, redesign); feature card and “Other documentation” list updated.

0.0.31 (Module design & evolution)

• omega ai coach module improvements:
  • Update existing modules: You can now use --module <Name> or "Name: description" to update an existing module instead of creating a new one.
  • Immediate Self-Healing: The CLI now runs a self-healing pass right after generating a module with AI, ensuring the "designed" code actually compiles.
  • Lenient validation: Sanity checks no longer discard the entire AI output on minor flaws, relying on the healing pass to fix them.
• omega ai coach audit improvements:
  • Robust registration detection: Improved detection of flows, agents, and routes in omega_setup.dart, supporting PascalCase/lowercase variations and namespaces.
  • Route audit: Added a check to verify if the module route is registered in omega_setup.dart.

0.0.30 (CLI contracts & AI UX)

• Advanced module template: OmegaFlowContract for OmegaWorkflowFlow now includes workflow.step and workflow.error, and lists *.requested in listenedEventNames when those events use the shared bus. OmegaAgentContract uses empty listenedEventNames on the global channel to avoid spurious debug warnings across modules (with code comment).
• AI generation: Kickstart text is passed as productContext per module; prompts ask for real Material UI from the description; contract/namespace guidance for providers and self-heal.

0.0.29 (Generated app navigation)

• omega create app main.dart: Uses OmegaFlowActivator in _OmegaAppRoot and OmegaScope.initialNavigationIntent + OmegaInitialRoute on MaterialApp.home, matching example/lib/main.dart — no bogus navigate.$flowId string.

0.0.28 (CLI AI reliability)

• Self-healing: Re-runs dart analyze after AI fixes (up to OMEGA_AI_HEAL_MAX_PASSES, default 3); merges analyzer stdout+stderr; only treats ERROR| machine lines as blocking; prints remaining errors if healing fails.
• Generated apps: main.dart and widget_test.dart use OmegaRuntime.bootstrap((OmegaChannel c) => createOmegaConfig(c)) for correct inference.
• AI module generation: Prompts reference OmegaIntentName / OmegaEventName, app_semantics.dart enum style, and correct OmegaIntent.fromName(enumValue) usage.
• Validation fallback: If AI-written *_events.dart or page code fails sanity checks, the CLI falls back to the default advanced scaffold (or default page only) so dart analyze is less likely to break on bad AI output.
• Default advanced template: Intent/event enums use const constructors and final String name, matching the example app.

0.0.27 (Autonomous Self-Healing)

• Self-Healing Project Creation: omega create app now automatically runs dart analyze after generation.
  • If compilation errors are found, the CLI uses AI to diagnose and auto-fix the code.
  • Ensures the generated project is 100% functional and error-free without manual intervention.
• Improved AI Logic: More precise prompts for AI-generated modules to minimize syntax errors.

0.0.26 (CLI Robustness & UX)

• omega create app improvements:
  • Widget Test Fix: The generator now correctly overwrites test/widget_test.dart with a compatible smoke test using OmegaApp and OmegaRuntime.
  • Automatic Route Registration: New modules generated via g ecosystem (including AI kickstart) now automatically register their primary route and UI import in omega_setup.dart.
  • Windows Robustness: Improved path resolution and added forced file overwriting for a cleaner initial setup.
• Documentation & AI configuration:
  • Quick Start: Added a dedicated section to README.md and web docs for instant onboarding.
  • AI Configuration Guide: Detailed instructions for setting up OMEGA_AI_API_KEY and other environment variables in doc/GUIA.md and README.md.
  • Web Docs Enhancement: Added "Steps for Success" to the CLI command panels.

0.0.25 (Orchestration & App Creation)

• omega create app: New top-level CLI command to bootstrap a full Flutter project with Omega pre-configured.
• AI Kickstart: Generates real business logic (agents, flows, UI) based on descriptions.
• Widget Test Fix: The generator now correctly overwrites test/widget_test.dart with a compatible smoke test, avoiding MyApp errors.
• AI Auth Fix: Corrected $apiKey escaping in provider calls.
• OmegaNavigator compatibility: Added onGenerateRoute support.
• Exported Bootstrap: OmegaRuntime and OmegaConfig are now exported from the main entry point.

0.0.24

• The official Omega documentation was added.

0.0.23 (AI Evolution)

• omega ai coach module: New AI-guided command to generate complete ecosystems with advanced boilerplate. Use --template advanced to generate OmegaWorkflowFlow, OmegaStatefulAgent, typed events, declarative contracts, and initial test files.
• AI-assisted diagnosis and auditing: Added omega ai coach start (step-by-step guidance) and omega ai coach audit (project gap analysis for features).
• Plug-and-play UI templates: Generated UI pages now dynamically connect to OmegaFlowManager via OmegaScope and use StreamBuilder<OmegaFlowExpression> for a reactive, decoupled experience.
• Improved generator accuracy: Fixed null-safety issues (ctx.intent?.name) and API usage (OmegaEvent.fromName) in all generated templates.
• AI CLI output options: AI commands now default to opening a temporary Markdown report in the editor for better readability, with a --stdout flag for console output.
• Localization for AI: AI reports and CLI messages now respect system locale or OMEGA_AI_LANG environment variables.

0.0.22

• Reactive agent state (optional): Added [OmegaStatefulAgent] and [OmegaAgentBuilder]. Agents can expose a typed reactive viewState (stateStream) for UI widgets while preserving Omega’s core event/intent model.
• Workflow engine flow (optional): Added [OmegaWorkflowFlow] for explicit step-based flows with defineStep, startAt, next, failStep, and completeWorkflow to model multi-step processes (e.g. checkout/onboarding) without replacing [OmegaFlow].
• Example auth updated: example/lib/auth now demonstrates reactive agent state in practice (AuthAgent + AuthViewState + OmegaAgentBuilder in login UI) with flow semantics kept focused on milestones.

0.0.21

• Typed events (OmegaTypedEvent + emitTyped): New [OmegaTypedEvent] interface and [OmegaEventBus.emitTyped] method so you can model events as classes (e.g. LoginRequestedEvent) instead of plain string names with loose payloads. The channel wraps them into [OmegaEvent] with the instance as payload; listeners use event.payloadAs<LoginRequestedEvent>() for full type safety. Example app updated (AuthFlow, AuthAgent, auth/models.dart) and tests added in omega_channel_test.dart.
• Docs (GUIA, README, ROADMAP): doc/GUIA.md now has a dedicated “Eventos tipados (clase como evento)” section with a full example; README’s feature list highlights typed events as the recommended style; doc/ROADMAP.md marks typed events as completed under “Contratos y convenciones”.
• Web docs — What’s new section: presentation/index.html and index-en.html include a new “Nuevas mejoras / What’s new” slide with a collapsible block per version (<details><summary>…</summary>) starting with 0.0.21 and a concrete code snippet for LoginRequestedEvent + emitTyped. Future releases can append new collapsibles there.
• Analytics for documentation site: Both presentation/index.html and index-en.html now embed Google Analytics 4 (G-Q2XTRMEHHH) so you can track visits to the Omega documentation pages.

0.0.20

• Inspector (VM Service + public web): [OmegaInspectorServer] now exposes Omega state via a VM Service extension instead of a local HTTP server. On Android/iOS/desktop it prints a URL of the form https://yefersonsegura.com/projects/omega/inspector.html#<encoded-VM-URL> that opens the online Inspector and auto-connects; no adb reverse is required.
• Inspector CLI: New CLI command omega inspector opens the hosted Inspector page in the browser. When combined with the URL printed by [OmegaInspectorServer], you can debug a device from the PC without searching for the HTML file.
• Inspector UI refresh (web + public): presentation/inspector.html and the web receiver (OmegaInspectorReceiver in omega_inspector_receiver_web.dart) share a modern dark dashboard layout: flows sidebar, events list with timeline, and a JSON details panel for the selected event/flow. Layout adapts to desktop, tablet and mobile widths.
• Inspector server (web stub): When [OmegaInspectorServer.start] is called on web, a debug message is printed explaining that the server is not available on web and to use [OmegaInspectorLauncher] instead.

0.0.19

• Channel namespaces: OmegaChannel.namespace and [OmegaChannelNamespace] for scoped events (e.g. auth, checkout). [OmegaEvent] and [OmegaIntent] have optional namespace; [OmegaEventBus] abstraction so [OmegaFlow] and [OmegaAgent] accept either the global channel or a namespace view. Example app uses namespaces per domain (auth, provider, orders). ROADMAP and doc/GUIA.md updated.
• Inspector server (web stub): When [OmegaInspectorServer.start] is called on web, a debug message is printed explaining that the server is not available on web and to use [OmegaInspectorLauncher] instead.
• Inspector example and docs: Example app shows overlay + launcher + server in debug; doc/INSPECTOR.md added with full copy-paste guide (overlay, launcher, server) and "Inspector not showing" troubleshooting.
• Inspector server (IO) encoding fix: Events whose payload is an [OmegaIntent] (e.g. navigation.intent) are now serialized safely for WebSocket broadcast; fixes "Converting object to an encodable object failed: Instance of 'OmegaIntent'" when running on mobile or desktop with the Inspector server.

0.0.18

• CLI: Wrapped single-statement if body in omega doctor in a block to satisfy curly_braces_in_flow_control_structures lint.

0.0.17

• OmegaInspectorServer: Inspector in browser (desktop/mobile): OmegaInspectorServer.start runs an HTTP/WebSocket server so you can open the Inspector at e.g. http://localhost:9292 without the in-app overlay. Stub on web (no-op). Example and doc/GUIA.md updated.
• Inspector safe for production: [OmegaInspector], [OmegaInspectorLauncher], [OmegaInspectorReceiver] and [OmegaInspectorServer] guard with kDebugMode: in release they do not subscribe, show the button, or start the server; receiver shows a short message. No inspector code runs in production.
• CLI: Replaced print with stdout.writeln in bin/omega.dart to satisfy the avoid_print lint.
• Docs: README and example/README with Inspector usage (overlay, launcher, server). Web docs (ES/EN): "Uso del Inspector" in OmegaScope section and API section updated with OmegaInspectorServer and release behavior.

0.0.16

• omega trace: CLI command omega trace view <file.json> (trace summary: events, initial snapshot) and omega trace validate <file.json> (validates structure; exit 0/1). Trace files are generated by saving [OmegaRecordedSession.toJson()] (e.g. after [OmegaTimeTravelRecorder.stopRecording]).
• omega doctor: CLI command that checks project health: validates omega_setup.dart (structure, duplicate IDs) and optionally lists flows/agents without a contract (recommendation).
• Trace serialization: [OmegaEvent.toJson]/[OmegaEvent.fromJson] and [OmegaRecordedSession.toJson]/[OmegaRecordedSession.fromJson] to save and load recorded sessions (time-travel, debugging).
• CLI documentation: CLI section on the web (ES/EN) in tabs (doc, init, g ecosystem, g agent, g flow, validate, trace, doctor) with "Why", instruction (both forms when applicable), concept and examples. README: commands listed one under the other with Why, instruction, concept and examples; omega doctor and omega init in both forms (with/without path, with/without --force).
• Export session to JSON: In doc/TIME_TRAVEL.md section "Export session to JSON (trace file)" with examples for mobile (path_provider + File), web (blob + download) and minimal usage. README and trace tab on the web with snippet and link to TIME_TRAVEL.md.
• Example: Contracts added to OrdersFlow, ProviderFlow and ProviderAgent so omega doctor does not list them under "Optional (contracts)".

0.0.15

• Inspector: Visual tweaks for a cleaner, more modern look (softer colors, fewer shadows, clearer separation between event list and flow state), keeping all previous functionality.

0.0.14

• Declarative contracts: [OmegaFlowContract] and [OmegaAgentContract] to declare which events a flow listens to, which intents it accepts, and which expression types it emits (and for agents: events and intents). In debug mode Omega warns in the console when something undeclared is received or emitted. Optional contract override on [OmegaFlow] and [OmegaAgent]; empty sets = no restriction. Factory fromTyped for [OmegaEventName]/[OmegaIntentName] enums.
• Time-travel: [OmegaTimeTravelRecorder] records channel events and an initial snapshot; [OmegaRecordedSession] stores them. replay(session, channel, flowManager, upToIndex: n) restores the snapshot and re-emits events up to index n for debugging or reproducing a session. See doc/TIME_TRAVEL.md. Web (presentation): "Time-travel" section in Spanish and English.
• Offline-first (infra): New types [OmegaQueuedIntent], [OmegaOfflineQueue] and [OmegaMemoryOfflineQueue] to queue intents when the network fails and re-emit them when connectivity is restored. Example in example/ (OrdersFlow + "Crear pedido (offline demo)" button on HomePage).
• Inspector / DevTools: Cleaner dashboard-style inspector: two columns (events on the left, flow state on the right) with a small timeline of recent events above the list, in both overlay and web window.
• Docs: doc/CONTRACTS.md with guide and examples; doc/TIME_TRAVEL.md and Offline-first section in doc/GUIA.md; web (presentation) with glossary and mentions of contracts, time-travel, offline queue and timeline.

0.0.13

• Pub.dev: README with https links only (documentation points to pub.dev API reference). CLI: if body in bin/omega.dart wrapped in a block to pass the lint and recover points.

0.0.12

• Favicon: SVG favicon with Omega symbol drawn by path (no font dependency). Link in presentation/index.html.
• CLI: Command omega doc opens the official web documentation in the browser.
• Web documentation: Reading progress bar, copy button on code blocks, light/dark theme with persistence, scroll-to-top button, SEO meta, breadcrumbs, footer with version, accessibility (skip-link, focus-visible). Font Awesome icons in sidebar and navigation.
• Docs: GUIA.md, README with documentation badge, example with link to docs. pubspec: documentation, issue_tracker.

0.0.11

• Documentation: doc/COMPARATIVA.md with Omega vs BLoC vs Riverpod comparison and when to choose each. Web (presentation) declared as full documentation; "Comparativa" link in navigation. README and ROADMAP updated.
• Inspector: Modern design (blue theme, gradients, shadowed cards, pills for state and counts). Same style in overlay and remote (web) window.
• Inspector web: When closing the inspector window and reopening, a unique window name is used so the browser opens a new window correctly.

0.0.10

• Pub.dev static analysis: Inspector web migrated from dart:html to package:web and dart:js_interop to remove deprecation INFO and recover 10 points on "Pass static analysis". Dependency web: ^1.0.0 added.

0.0.9

• Typed events and intents: [OmegaEventName] and [OmegaIntentName] (interfaces) + [OmegaEvent.fromName] and [OmegaIntent.fromName] to use enums or classes and avoid magic strings (autocomplete, refactors). Documentation in README, ARQUITECTURA and ROADMAP; tests in omega_channel_test and omega_intent_test.
• Example: example/lib/omega/app_semantics.dart with AppEvent and AppIntent enums; main, auth_flow, auth_agent, auth_behavior and auth_page use fromName and typed names. example/README.md updated.

0.0.8

• Persistence and restore: Snapshot serialization with OmegaFlowSnapshot.toJson/fromJson and OmegaAppSnapshot.toJson/fromJson. OmegaFlow.restoreMemory and OmegaFlowManager.restoreFromSnapshot to restore state when opening the app. Optional OmegaSnapshotStorage interface (save/load). Documentation in README, ARQUITECTURA and ROADMAP.
• Pub.dev: dependency_overrides: meta: ^1.18.1 to pass "Support up-to-date dependencies" in static analysis.

0.0.7

• Inspector in separate window (web, Isar-style): [OmegaInspectorLauncher] opens the inspector in another browser tab/window; the app sends data via BroadcastChannel. [OmegaInspectorReceiver] shows events and snapshots in that window. On non-web platforms the launcher opens the inspector in a dialog. Documentation in README and ARQUITECTURA.

0.0.6

• CLI fix: When running g agent <Name> or g flow <Name> separately, the CLI now only removes and re-adds the import for the artifact being registered (agent or flow), so the other import is preserved. Previously, running g flow Orders after g agent Orders could remove the agent import.
• Snapshot (Step 2): OmegaFlowSnapshot and OmegaAppSnapshot for debugging, persistence, and time-travel. OmegaFlow.getSnapshot(), OmegaFlowManager.getFlowSnapshot, getSnapshots, getAppSnapshot. Documentation of purpose in dartdoc and ARQUITECTURA.
• Logging (Step 3): Replaced print with debugPrint in omega_navigator.dart and omega_bootstrap.dart (lib) so diagnostics only appear in debug mode.
• Navigation (Step 4): Contract documented (navigation.intent, navigate.*). navigate.<id> = pushReplacement, navigate.push.<id> = push. Intent payload passed as RouteSettings.arguments. Constant navigationIntentEvent.
• Testing (Step 5): More unit tests (agent receiveIntent, flow receiveIntent running/idle, OmegaFlowExpression). example/README.md for minimal login flow. doc/TESTING.md for testing agents and flows without Flutter.
• CLI (Step 6): Clearer error messages (prefix "Error:", absolute paths). New generators: omega g agent <Name>, omega g flow <Name>. omega validate checks omega_setup.dart (structure, duplicate ids). All generators create files in the terminal's current directory (CWD).
• Docs: ARQUITECTURA.md and README kept in sync with snapshot, navigation, testing, and CLI.

0.0.5

• Fix static analysis: enclose while body in a block in bin/omega.dart (pub.dev lint).

0.0.4

• CLI g ecosystem: create files in the current directory (where you run the command), not forced under lib/.
• CLI: refresh imports in omega_setup.dart (replace old paths with the correct one for the ecosystem).
• CLI: register both Agent and Flow in OmegaConfig; add flows: section if missing in omega_setup.dart.
• Docs: README and web updated with CLI behavior (CWD, path refresh, flow registration).

0.0.3

• Add official example in example/lib/main.dart for pub.dev scoring.
• Tweak documentation (README and website) to point to pub.dev installation.

0.0.2

• Publish on pub.dev and switch doc/install to pub.dev usage (omega_architecture: ^0.0.2).
• Add web documentation (presentation) and architecture diagram.
• Improve CLI behavior (flows/agents registration, no auto-route creation).
• Clarify runtime bootstrap and flow activation from the app host.

0.0.1

• Initial release of Omega Architecture: core agents/flows/channel runtime, basic CLI and auth example.