@nockdev/awf 6.2.0

package/.agent/skills/frameworks/flutter/data/core.yaml

@@ -0,0 +1,210 @@
+# =============================================================================
+# Flutter Core Patterns (Feb 2026)
+# =============================================================================
+# Widgets, Dart 3.7, Build patterns
+
+metadata:
+  skill: flutter
+  domain: core
+  version: "3.29"
+  updated: "2026-02-05"
+  patterns_count: 6
+
+patterns:
+  - id: flt001
+    name: Widget Composition
+    category: architecture
+    version: "1.0+"
+    description: Compose UIs from small, focused widgets
+    text: widget stateless stateful composition build context
+    example: |
+      // ✅ Prefer StatelessWidget when possible
+      class UserCard extends StatelessWidget {
+        final User user;
+        const UserCard({super.key, required this.user});
+
+        @override
+        Widget build(BuildContext context) {
+          return Card(
+            child: ListTile(
+              leading: CircleAvatar(
+                backgroundImage: NetworkImage(user.avatarUrl),
+              ),
+              title: Text(user.name),
+              subtitle: Text(user.email),
+            ),
+          );
+        }
+      }
+
+      // ✅ Use const constructors for performance
+      const SizedBox(height: 16);
+      const Text('Hello');
+      const Icon(Icons.star);
+    severity: HIGH
+    docs_url: https://docs.flutter.dev/development/ui/widgets-intro
+
+  - id: flt002
+    name: Dart 3.7 Features
+    category: language
+    version: "3.7+"
+    description: Modern Dart features - digit separators, wildcards
+    text: dart 3.7 digit separator wildcard underscore formatter
+    example: |
+      // ✅ Digit separators (readability)
+      const billion = 1_000_000_000;
+      const hex = 0xFF_EC_DE_5D;
+      const binary = 0b1010_1100_1111_0000;
+
+      // ✅ Wildcard variables - elegant callback handling
+      future.then((_) => print('Done!')); // Underscore as wildcard
+
+      // ✅ Pattern matching with wildcards
+      switch (result) {
+        case Success(value: _): print('Success!');
+        case Failure(error: final e): print('Error: $e');
+      }
+
+      // ✅ Improved formatter - auto trailing commas
+      // Formatter now adds/removes trailing commas based on line length
+    severity: MEDIUM
+    docs_url: https://dart.dev/language
+
+  - id: flt003
+    name: Sealed Classes & Patterns
+    category: language
+    version: "3.0+"
+    description: Type-safe exhaustive pattern matching with sealed classes
+    text: sealed class pattern matching switch case exhaustive
+    example: |
+      // ✅ Sealed class for exhaustive pattern matching
+      sealed class Result<T> {
+        const Result();
+      }
+
+      class Success<T> extends Result<T> {
+        final T value;
+        const Success(this.value);
+      }
+
+      class Failure<T> extends Result<T> {
+        final Exception error;
+        const Failure(this.error);
+      }
+
+      // ✅ Pattern matching in switch (exhaustive!)
+      String handleResult(Result<User> result) {
+        return switch (result) {
+          Success(value: final user) => 'Hello, ${user.name}!',
+          Failure(error: final e) => 'Error: ${e.toString()}',
+        };
+      }
+
+      // ✅ if-case pattern matching
+      if (result case Success(value: final user)) {
+        print('User: ${user.name}');
+      }
+    severity: HIGH
+    docs_url: https://dart.dev/language/patterns
+
+  - id: flt004
+    name: Records & Destructuring
+    category: language
+    version: "3.0+"
+    description: Anonymous tuples and destructuring patterns
+    text: record tuple destructuring named field pattern
+    example: |
+      // ✅ Records (anonymous tuples)
+      (String, int) getUserInfo() => ('Alice', 25);
+
+      final (name, age) = getUserInfo();
+      print('$name is $age years old');
+
+      // ✅ Named fields in records
+      ({String name, int age}) getUser() => (name: 'Alice', age: 25);
+
+      final (:name, :age) = getUser();
+
+      // ✅ Use in function returns
+      (bool success, String? error) validateEmail(String email) {
+        if (email.contains('@')) {
+          return (true, null);
+        }
+        return (false, 'Invalid email format');
+      }
+
+      final (isValid, error) = validateEmail('test@example.com');
+    severity: MEDIUM
+    docs_url: https://dart.dev/language/records
+
+  - id: flt005
+    name: Freezed for Immutable Models
+    category: data
+    version: "2.0+"
+    description: Code generation for immutable data classes
+    text: freezed immutable copyWith json serializable model
+    example: |
+      import 'package:freezed_annotation/freezed_annotation.dart';
+
+      part 'user.freezed.dart';
+      part 'user.g.dart';
+
+      // ✅ Immutable data class with freezed
+      @freezed
+      class User with _$User {
+        const factory User({
+          required String id,
+          required String email,
+          required String name,
+          @Default(false) bool isActive,
+          DateTime? lastLoginAt,
+        }) = _User;
+
+        factory User.fromJson(Map<String, dynamic> json) =>
+            _$UserFromJson(json);
+      }
+
+      // Usage
+      final user = User(id: '1', email: 'a@b.com', name: 'Alice');
+      final updated = user.copyWith(isActive: true);  // Immutable update
+
+      // Run: dart run build_runner build --delete-conflicting-outputs
+    severity: HIGH
+    docs_url: https://pub.dev/packages/freezed
+
+  - id: flt006
+    name: Feature-First Structure
+    category: architecture
+    version: "1.0+"
+    description: Organize code by feature, not by type
+    text: project structure feature folder architecture organization
+    example: |
+      # ✅ Feature-First Project Structure
+      lib/
+      ├── main.dart
+      ├── app/
+      │   ├── app.dart              # MaterialApp setup
+      │   └── router.dart           # Navigation
+      ├── core/
+      │   ├── constants/
+      │   ├── network/
+      │   │   ├── api_client.dart
+      │   │   └── interceptors.dart
+      │   └── theme/
+      │       └── app_theme.dart
+      ├── features/
+      │   ├── auth/
+      │   │   ├── data/             # datasources, models, repositories
+      │   │   ├── domain/           # entities, usecases
+      │   │   └── presentation/     # pages, widgets, providers
+      │   └── home/
+      │       └── ...
+      └── shared/
+          └── widgets/
+
+      # ✅ Benefits:
+      # - Each feature is self-contained
+      # - Easy to add/remove features
+      # - Clear dependencies between features
+    severity: MEDIUM
+    docs_url: https://docs.flutter.dev/development/packages-and-plugins/developing-packages

package/.agent/skills/frameworks/flutter/data/platform.yaml

@@ -0,0 +1,246 @@
+# =============================================================================
+# Flutter Platform Patterns (Feb 2026)
+# =============================================================================
+# Flutter 3.29 features, Impeller, performance
+
+metadata:
+  skill: flutter
+  domain: platform
+  version: "3.29"
+  updated: "2026-02-05"
+  patterns_count: 6
+
+patterns:
+  - id: flt011
+    name: Impeller (iOS Default)
+    category: rendering
+    version: "3.29+"
+    description: |
+      Impeller is now the DEFAULT rendering engine on iOS.
+      Skia removed from iOS builds. ~2x faster rendering.
+    text: impeller rendering engine ios performance skia
+    example: |
+      // ✅ Flutter 3.29: Impeller is DEFAULT on iOS
+      // No configuration needed - automatic performance boost
+
+      // Benefits:
+      // - ~2x faster rendering than Skia
+      // - Consistent frame rates
+      // - Reduced shader compilation jank
+      // - Smaller binary size (Skia removed)
+
+      // ⚠️ Android: Impeller still opt-in
+      // In AndroidManifest.xml:
+      <meta-data
+        android:name="io.flutter.embedding.android.EnableImpeller"
+        android:value="true" />
+
+      // Or via command line:
+      // flutter run --enable-impeller
+    severity: CRITICAL
+    docs_url: https://docs.flutter.dev/perf/impeller
+
+  - id: flt012
+    name: Main Thread Dart Execution
+    category: architecture
+    version: "3.29+"
+    description: |
+      Dart code now runs on platform main thread (Android/iOS).
+      Eliminates UI thread overhead, better platform interop.
+    text: main thread dart execution platform native interop
+    example: |
+      // ✅ Flutter 3.29: Main Thread Dart Execution
+
+      // Benefits:
+      // 1. Eliminates separate UI thread - simpler architecture
+      // 2. Synchronous platform channel calls possible
+      // 3. Better integration with platform native code
+      // 4. Reduced overhead for platform channels
+
+      // Platform channels now faster:
+      import 'package:flutter/services.dart';
+
+      class NativeBridge {
+        static const platform = MethodChannel('com.example/native');
+
+        // ✅ Faster synchronous-like calls
+        Future<String> getNativeData() async {
+          return await platform.invokeMethod<String>('getData') ?? '';
+        }
+      }
+    severity: HIGH
+    docs_url: https://docs.flutter.dev/release/breaking-changes
+
+  - id: flt013
+    name: BackdropGroup Widget
+    category: ui
+    version: "3.29+"
+    description: Optimized blur effects with grouped BackdropFilters
+    text: backdrop blur filter group optimized glassmorphism
+    example: |
+      import 'package:flutter/widgets.dart';
+      import 'dart:ui';
+
+      // ✅ BackdropGroup for multiple blur effects
+      BackdropGroup(
+        children: [
+          BackdropFilter.grouped(
+            filter: ImageFilter.blur(sigmaX: 10, sigmaY: 10),
+            child: Container(
+              color: Colors.white.withOpacity(0.5),
+              child: Text('Blurred background 1'),
+            ),
+          ),
+          BackdropFilter.grouped(
+            filter: ImageFilter.blur(sigmaX: 5, sigmaY: 5),
+            child: Container(
+              color: Colors.blue.withOpacity(0.3),
+              child: Text('Blurred background 2'),
+            ),
+          ),
+        ],
+      )
+
+      // Benefits:
+      // - Shared blur computation between children
+      // - Better performance than separate BackdropFilters
+      // - Perfect for glassmorphism UIs
+    severity: MEDIUM
+    docs_url: https://api.flutter.dev/flutter/widgets/BackdropGroup-class.html
+
+  - id: flt014
+    name: ImageFilter.shader
+    category: ui
+    version: "3.29+"
+    description: Apply custom fragment shaders to widgets
+    text: shader fragment image filter custom effect gpu
+    example: |
+      import 'dart:ui' as ui;
+
+      // ✅ Load and apply custom shader
+      class ShaderWidget extends StatefulWidget {
+        @override
+        State<ShaderWidget> createState() => _ShaderWidgetState();
+      }
+
+      class _ShaderWidgetState extends State<ShaderWidget> {
+        ui.FragmentShader? _shader;
+
+        @override
+        void initState() {
+          super.initState();
+          _loadShader();
+        }
+
+        Future<void> _loadShader() async {
+          final program = await ui.FragmentProgram.fromAsset('shaders/my_effect.frag');
+          setState(() => _shader = program.fragmentShader());
+        }
+
+        @override
+        Widget build(BuildContext context) {
+          if (_shader == null) return const SizedBox();
+
+          return ImageFiltered(
+            imageFilter: ui.ImageFilter.shader(_shader!),
+            child: Image.asset('assets/photo.png'),
+          );
+        }
+      }
+
+      // shader file: shaders/my_effect.frag
+      // #version 460
+      // precision mediump float;
+      // ...
+    severity: MEDIUM
+    docs_url: https://docs.flutter.dev/development/ui/advanced/shaders
+
+  - id: flt015
+    name: Performance Optimization
+    category: performance
+    version: "3.0+"
+    description: Key techniques for smooth 60fps Flutter apps
+    text: performance optimization const rebuild repaint isolate
+    example: |
+      // ✅ 1. Use const constructors
+      const SizedBox(height: 16);
+      const Text('Hello');
+      const Icon(Icons.star);
+
+      // ✅ 2. Extract widgets to avoid rebuilds
+      class UserList extends StatelessWidget {
+        @override
+        Widget build(BuildContext context) {
+          return ListView.builder(
+            itemCount: users.length,
+            itemBuilder: (context, index) => UserListItem(
+              key: ValueKey(users[index].id),  // ✅ Add keys!
+              user: users[index],
+            ),
+          );
+        }
+      }
+
+      // ✅ 3. RepaintBoundary for complex widgets
+      RepaintBoundary(
+        child: ComplexAnimatedWidget(),
+      )
+
+      // ✅ 4. Offload heavy computation to isolates
+      import 'dart:isolate';
+
+      Future<List<ProcessedItem>> processDataInIsolate(
+        List<RawItem> items
+      ) async {
+        return await Isolate.run(() {
+          return items.map((item) => processItem(item)).toList();
+        });
+      }
+
+      // ✅ 5. Use ListView.builder not ListView
+      // ✅ 6. Cache network images with CachedNetworkImage
+      // ✅ 7. Profile with DevTools Performance tab
+    severity: CRITICAL
+    docs_url: https://docs.flutter.dev/perf/best-practices
+
+  - id: flt016
+    name: Material 3 Updates
+    category: ui
+    version: "3.29+"
+    description: Latest Material 3 transitions and theming
+    text: material 3 theme transition page animation design
+    example: |
+      // ✅ FadeForwardsPageTransitionsBuilder - new default transition
+      MaterialApp(
+        theme: ThemeData(
+          useMaterial3: true,  // ✅ Material 3 (default in 3.27+)
+          colorScheme: ColorScheme.fromSeed(
+            seedColor: Colors.blue,
+            brightness: Brightness.light,
+          ),
+          pageTransitionsTheme: PageTransitionsTheme(
+            builders: {
+              TargetPlatform.android: FadeForwardsPageTransitionsBuilder(),
+              TargetPlatform.iOS: CupertinoPageTransitionsBuilder(),
+            },
+          ),
+        ),
+      )
+
+      // ✅ Dynamic color (Android 12+)
+      import 'package:dynamic_color/dynamic_color.dart';
+
+      DynamicColorBuilder(
+        builder: (ColorScheme? lightDynamic, ColorScheme? darkDynamic) {
+          return MaterialApp(
+            theme: ThemeData(
+              colorScheme: lightDynamic ?? defaultLightColorScheme,
+            ),
+            darkTheme: ThemeData(
+              colorScheme: darkDynamic ?? defaultDarkColorScheme,
+            ),
+          );
+        },
+      )
+    severity: HIGH
+    docs_url: https://m3.material.io/develop/flutter

package/.agent/skills/frameworks/flutter/data/state.yaml

@@ -0,0 +1,250 @@
+# =============================================================================
+# Flutter State Management Patterns (Feb 2026)
+# =============================================================================
+# Riverpod, BLoC, Provider best practices
+
+metadata:
+  skill: flutter
+  domain: state
+  version: "3.29"
+  updated: "2026-02-05"
+  patterns_count: 4
+
+patterns:
+  - id: flt007
+    name: Riverpod 3.0
+    category: state
+    version: "3.0+"
+    description: |
+      Recommended state management for most Flutter apps.
+      Type-safe, testable, compile-time safety.
+    text: riverpod provider notifier async future state management
+    example: |
+      import 'package:riverpod/riverpod.dart';
+
+      // ✅ FutureProvider for async data
+      final userProvider = FutureProvider.autoDispose<User>((ref) async {
+        final api = ref.watch(apiClientProvider);
+        return api.fetchUser();
+      });
+
+      // ✅ Notifier for complex state
+      class CounterNotifier extends Notifier<int> {
+        @override
+        int build() => 0;  // Initial state
+
+        void increment() => state++;
+        void decrement() => state--;
+      }
+
+      final counterProvider = NotifierProvider<CounterNotifier, int>(
+        CounterNotifier.new,
+      );
+
+      // ✅ In widgets: watch() in build, read() in callbacks
+      class CounterWidget extends ConsumerWidget {
+        @override
+        Widget build(BuildContext context, WidgetRef ref) {
+          final count = ref.watch(counterProvider);  // ✅ watch in build
+
+          return Column(
+            children: [
+              Text('Count: $count'),
+              ElevatedButton(
+                onPressed: () => ref.read(counterProvider.notifier).increment(),
+                child: Text('Increment'),
+              ),
+            ],
+          );
+        }
+      }
+
+      // ✅ Use ref.select() to reduce rebuilds
+      final userName = ref.watch(userProvider.select((u) => u.name));
+    severity: CRITICAL
+    docs_url: https://riverpod.dev/
+
+  - id: flt008
+    name: BLoC Pattern
+    category: state
+    version: "8.0+"
+    description: |
+      Business Logic Component pattern for enterprise apps.
+      Separates UI from business logic with events and states.
+    text: bloc cubit event state stream business logic flutter_bloc
+    example: |
+      import 'package:flutter_bloc/flutter_bloc.dart';
+
+      // ✅ Events (sealed for exhaustive matching)
+      sealed class AuthEvent {}
+      class LoginRequested extends AuthEvent {
+        final String email;
+        final String password;
+        LoginRequested(this.email, this.password);
+      }
+      class LogoutRequested extends AuthEvent {}
+
+      // ✅ States (sealed for exhaustive matching)
+      sealed class AuthState {}
+      class AuthInitial extends AuthState {}
+      class AuthLoading extends AuthState {}
+      class AuthAuthenticated extends AuthState {
+        final User user;
+        AuthAuthenticated(this.user);
+      }
+      class AuthError extends AuthState {
+        final String message;
+        AuthError(this.message);
+      }
+
+      // ✅ BLoC
+      class AuthBloc extends Bloc<AuthEvent, AuthState> {
+        final AuthRepository _repository;
+
+        AuthBloc(this._repository) : super(AuthInitial()) {
+          on<LoginRequested>(_onLoginRequested);
+          on<LogoutRequested>(_onLogoutRequested);
+        }
+
+        Future<void> _onLoginRequested(
+          LoginRequested event,
+          Emitter<AuthState> emit,
+        ) async {
+          emit(AuthLoading());
+          try {
+            final user = await _repository.login(event.email, event.password);
+            emit(AuthAuthenticated(user));
+          } catch (e) {
+            emit(AuthError(e.toString()));
+          }
+        }
+
+        Future<void> _onLogoutRequested(
+          LogoutRequested event,
+          Emitter<AuthState> emit,
+        ) async {
+          await _repository.logout();
+          emit(AuthInitial());
+        }
+      }
+
+      // ✅ Use BlocBuilder efficiently
+      BlocBuilder<AuthBloc, AuthState>(
+        buildWhen: (previous, current) => current is! AuthLoading,
+        builder: (context, state) {
+          return switch (state) {
+            AuthInitial() => LoginScreen(),
+            AuthLoading() => LoadingIndicator(),
+            AuthAuthenticated(user: final u) => HomeScreen(user: u),
+            AuthError(message: final m) => ErrorScreen(message: m),
+          };
+        },
+      )
+    severity: HIGH
+    docs_url: https://bloclibrary.dev/
+
+  - id: flt009
+    name: Cubit (Simplified BLoC)
+    category: state
+    version: "8.0+"
+    description: Simpler alternative to BLoC without events
+    text: cubit state simple bloc emit flutter_bloc
+    example: |
+      import 'package:flutter_bloc/flutter_bloc.dart';
+
+      // ✅ Cubit - simpler than BLoC (no events)
+      class CounterCubit extends Cubit<int> {
+        CounterCubit() : super(0);
+
+        void increment() => emit(state + 1);
+        void decrement() => emit(state - 1);
+        void reset() => emit(0);
+      }
+
+      // ✅ Async Cubit
+      class UserCubit extends Cubit<UserState> {
+        final UserRepository _repository;
+
+        UserCubit(this._repository) : super(UserInitial());
+
+        Future<void> loadUser(String id) async {
+          emit(UserLoading());
+          try {
+            final user = await _repository.getUser(id);
+            emit(UserLoaded(user));
+          } catch (e) {
+            emit(UserError(e.toString()));
+          }
+        }
+      }
+
+      // ✅ Use in widget
+      BlocProvider(
+        create: (context) => CounterCubit(),
+        child: BlocBuilder<CounterCubit, int>(
+          builder: (context, count) {
+            return Text('Count: $count');
+          },
+        ),
+      )
+
+      // ✅ Call methods
+      context.read<CounterCubit>().increment();
+    severity: MEDIUM
+    docs_url: https://bloclibrary.dev/bloc-concepts/#cubit
+
+  - id: flt010
+    name: Provider (Simple State)
+    category: state
+    version: "6.0+"
+    description: Simple state management for small apps
+    text: provider changenotifier valuenotifier simple state
+    example: |
+      import 'package:provider/provider.dart';
+
+      // ✅ ChangeNotifier for simple mutable state
+      class CartProvider extends ChangeNotifier {
+        final List<CartItem> _items = [];
+
+        List<CartItem> get items => List.unmodifiable(_items);
+        int get itemCount => _items.length;
+        double get totalPrice => _items.fold(0, (sum, item) => sum + item.price);
+
+        void addItem(CartItem item) {
+          _items.add(item);
+          notifyListeners();  // ✅ Notify widgets
+        }
+
+        void removeItem(String id) {
+          _items.removeWhere((item) => item.id == id);
+          notifyListeners();
+        }
+
+        void clear() {
+          _items.clear();
+          notifyListeners();
+        }
+      }
+
+      // ✅ Provide at top level
+      void main() {
+        runApp(
+          ChangeNotifierProvider(
+            create: (_) => CartProvider(),
+            child: MyApp(),
+          ),
+        );
+      }
+
+      // ✅ Consume in widgets
+      Consumer<CartProvider>(
+        builder: (context, cart, child) {
+          return Text('Items: ${cart.itemCount}');
+        },
+      )
+
+      // ✅ Quick access (use sparingly)
+      final cart = context.read<CartProvider>();
+      cart.addItem(item);
+    severity: MEDIUM
+    docs_url: https://pub.dev/packages/provider