@cubis/foundry 0.3.34 → 0.3.35

package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/postman/flutter-expert/references/riverpod-state.md

@@ -1,404 +0,0 @@
-# Riverpod 3 State Management
-
-## Provider Types (Codegen Only)
-
-### Functional Providers
-```dart
-// Simple sync
-@riverpod
-String greeting(Ref ref) => 'Hello';
-
-// Async
-@riverpod
-Future<User> currentUser(Ref ref) async {
-  return ref.watch(apiProvider).fetchCurrentUser();
-}
-
-// Stream
-@riverpod
-Stream<List<Message>> messages(Ref ref) {
-  return ref.watch(chatProvider).messageStream;
-}
-
-// Family (with params)
-@riverpod
-Future<User> userById(Ref ref, String id) async {
-  return ref.watch(apiProvider).fetchUser(id);
-}
-```
-
-### Notifier Providers
-```dart
-// Sync Notifier
-@riverpod
-class Counter extends _$Counter {
-  @override
-  int build() => 0;
-  
-  void increment() => state++;
-}
-
-// Async Notifier
-@riverpod
-class TodoList extends _$TodoList {
-  @override
-  FutureOr<List<Todo>> build() async => fetchTodos();
-  
-  Future<void> add(Todo todo) async {
-    state = const AsyncLoading();
-    state = await AsyncValue.guard(() async {
-      await api.addTodo(todo);
-      return [...await future, todo];
-    });
-  }
-}
-
-// Family Notifier
-@riverpod
-class UserEditor extends _$UserEditor {
-  @override
-  FutureOr<User> build(String userId) async => fetchUser(userId);
-}
-```
-
----
-
-## ✅ DO's
-
-### 1. Use Codegen Always
-```dart
-// ✅ Always use @riverpod
-@riverpod
-Future<Data> myProvider(Ref ref) async => fetchData();
-
-@riverpod
-class MyNotifier extends _$MyNotifier {
-  @override
-  FutureOr<State> build() async => initialState();
-}
-```
-
-### 2. Single Responsibility Per Provider
-```dart
-// ✅ One provider = one concern
-@riverpod
-Future<User> currentUser(Ref ref) async => fetchUser();
-
-@riverpod
-Future<List<Todo>> userTodos(Ref ref) async {
-  final user = await ref.watch(currentUserProvider.future);
-  return fetchTodos(user.id);
-}
-```
-
-### 3. Use ref.mounted After Async
-```dart
-@riverpod
-class MyNotifier extends _$MyNotifier {
-  @override
-  FutureOr<Data> build() async => fetchData();
-  
-  Future<void> update() async {
-    final result = await api.update();
-    if (!ref.mounted) return; // ✅ Always check
-    state = AsyncData(result);
-  }
-}
-```
-
-### 4. Use AsyncValue.guard for Error Handling
-```dart
-Future<void> save(Data data) async {
-  state = const AsyncLoading();
-  state = await AsyncValue.guard(() async {
-    await api.save(data);
-    return data;
-  });
-}
-```
-
-### 5. Invalidate Instead of Manual Refresh
-```dart
-// ✅ Let Riverpod handle refresh
-Future<void> refresh() async {
-  ref.invalidateSelf();
-  await future; // Wait for rebuild
-}
-```
-
-### 6. Use select() to Reduce Rebuilds
-```dart
-// ✅ Only rebuild when name changes
-final name = ref.watch(userProvider.select((u) => u.value?.name));
-```
-
----
-
-## ❌ DON'Ts
-
-### 1. Don't Use Legacy Providers
-```dart
-// ❌ NEVER use these (moved to legacy import)
-StateProvider
-StateNotifierProvider
-ChangeNotifierProvider
-
-// ✅ Use codegen instead
-@riverpod
-class MyNotifier extends _$MyNotifier { ... }
-```
-
-### 2. Don't Chain Provider Dependencies Deeply
-```dart
-// ❌ BAD: Deep chain = refactor nightmare
-@riverpod
-Future<A> providerA(Ref ref) async => ...;
-
-@riverpod
-Future<B> providerB(Ref ref) async {
-  final a = await ref.watch(providerAProvider.future);
-  return transformA(a);
-}
-
-@riverpod
-Future<C> providerC(Ref ref) async {
-  final b = await ref.watch(providerBProvider.future);
-  return transformB(b);
-}
-
-@riverpod
-Future<D> providerD(Ref ref) async {
-  final c = await ref.watch(providerCProvider.future);  // 4 levels deep!
-  return transformC(c);
-}
-
-// ✅ GOOD: Flat dependencies, use repository pattern
-@riverpod
-Future<D> providerD(Ref ref) async {
-  final repo = ref.watch(repositoryProvider);
-  return repo.getD(); // Repository handles the chain internally
-}
-```
-
-### 3. Don't Watch in Callbacks
-```dart
-// ❌ BAD
-onPressed: () {
-  final value = ref.watch(provider); // WRONG!
-}
-
-// ✅ GOOD
-onPressed: () {
-  final value = ref.read(provider); // Use read in callbacks
-  ref.read(provider.notifier).doSomething();
-}
-```
-
-### 4. Don't Mutate State Directly
-```dart
-// ❌ BAD
-state.value!.items.add(item); // Mutating existing object
-
-// ✅ GOOD
-state = AsyncData([...state.value!, item]); // New object
-```
-
-### 5. Don't Create Providers Inside Build
-```dart
-// ❌ BAD
-Widget build(context, ref) {
-  final provider = Provider((ref) => ...); // Created every build!
-}
-
-// ✅ GOOD - Define at top level
-@riverpod
-Data myProvider(Ref ref) => ...;
-```
-
-### 6. Don't Ignore Errors
-```dart
-// ❌ BAD
-final data = ref.watch(provider).value; // Ignores loading/error
-
-// ✅ GOOD
-ref.watch(provider).when(
-  data: (d) => show(d),
-  loading: () => spinner(),
-  error: (e, st) => errorWidget(e),
-);
-```
-
----
-
-## 🚫 STRICT RULES (Avoid Chain Refactoring)
-
-### Rule 1: Max 2 Levels of Provider Dependencies
-```dart
-// ✅ OK: 2 levels
-userProvider → userTodosProvider
-
-// ❌ BAD: 3+ levels
-userProvider → userTodosProvider → filteredTodosProvider → sortedTodosProvider
-```
-
-### Rule 2: Use Repository Pattern for Complex Data
-```dart
-// ✅ Repository encapsulates complexity
-@riverpod
-TodoRepository todoRepository(Ref ref) {
-  return TodoRepository(
-    api: ref.watch(apiProvider),
-    db: ref.watch(dbProvider),
-    auth: ref.watch(authProvider),
-  );
-}
-
-@riverpod
-class TodoListNotifier extends _$TodoListNotifier {
-  @override
-  FutureOr<List<Todo>> build() async {
-    return ref.watch(todoRepositoryProvider).getTodos();
-  }
-}
-```
-
-### Rule 3: Feature Providers Stay in Feature
-```dart
-// ✅ Feature-scoped providers
-// features/todo/presentation/providers/
-@riverpod
-class TodoListNotifier extends _$TodoListNotifier { ... }
-
-// ❌ Don't let other features depend on this directly
-// Instead, use shared domain layer
-```
-
-### Rule 4: Shared State Goes to Core
-```dart
-// core/providers/
-@riverpod
-Future<User> currentUser(Ref ref) async => ...;
-
-@riverpod
-AuthState auth(Ref ref) => ...;
-
-// Features can depend on core, not on each other
-```
-
-### Rule 5: Use keepAlive for App-Wide State
-```dart
-@Riverpod(keepAlive: true)
-Future<AppConfig> appConfig(Ref ref) async => loadConfig();
-
-@Riverpod(keepAlive: true)
-class AuthNotifier extends _$AuthNotifier { ... }
-```
-
-### Rule 6: Prefer Composition Over Inheritance
-```dart
-// ✅ Compose providers
-@riverpod
-Future<DashboardData> dashboard(Ref ref) async {
-  final user = await ref.watch(currentUserProvider.future);
-  final todos = await ref.watch(userTodosProvider(user.id).future);
-  final stats = await ref.watch(userStatsProvider(user.id).future);
-  return DashboardData(user: user, todos: todos, stats: stats);
-}
-```
-
----
-
-## Ref Methods
-
-```dart
-ref.watch(provider)           // Subscribe to changes (use in build)
-ref.read(provider)            // Read once (use in callbacks)
-ref.listen(provider, (p, n) {})  // Listen with callback
-ref.invalidate(provider)      // Force refresh another provider
-ref.invalidateSelf()          // Refresh current provider
-ref.mounted                   // Check if still active after async
-ref.onDispose(() {})          // Cleanup callback
-ref.keepAlive()               // Prevent auto-dispose
-```
-
-## AsyncValue Handling
-
-```dart
-// Pattern matching (sealed in Riverpod 3)
-switch (state) {
-  case AsyncData(:final value): return Text(value);
-  case AsyncError(:final error): return Text('Error: $error');
-  case AsyncLoading(): return CircularProgressIndicator();
-}
-
-// .when method
-state.when(
-  data: (data) => Text(data),
-  loading: () => CircularProgressIndicator(),
-  error: (e, st) => Text('Error: $e'),
-);
-
-// Properties
-state.value          // T? (null if loading/error)
-state.requireValue   // T (throws if not data)
-state.hasValue       // bool
-state.isLoading      // bool
-state.hasError       // bool
-```
-
-## Provider Options
-
-```dart
-// Keep alive (don't auto-dispose)
-@Riverpod(keepAlive: true)
-Future<Config> appConfig(Ref ref) async => loadConfig();
-
-// Custom retry
-@Riverpod(retry: myRetryFunction)
-Future<Data> withRetry(Ref ref) async => fetchData();
-
-Duration? myRetryFunction(int retryCount, Object error) {
-  if (retryCount > 3) return null;
-  return Duration(seconds: retryCount * 2);
-}
-```
-
-## Testing
-
-```dart
-void main() {
-  test('notifier test', () {
-    final container = ProviderContainer.test(
-      overrides: [
-        todoRepositoryProvider.overrideWithValue(MockTodoRepository()),
-        // Override just the build method
-        myNotifierProvider.overrideWithBuild((ref) => initialState),
-      ],
-    );
-    
-    final notifier = container.read(todoListNotifierProvider.notifier);
-    notifier.add(Todo(title: 'Test'));
-    
-    expect(container.read(todoListNotifierProvider).value, hasLength(1));
-  });
-}
-```
-
-## Migration from Riverpod 2
-
-```dart
-// ❌ Old (Riverpod 2)
-final provider = FutureProvider.autoDispose<Data>((ref) async => ...);
-class MyNotifier extends AutoDisposeAsyncNotifier<Data> { ... }
-Future<Data> myProvider(MyProviderRef ref) async { ... }
-
-// ✅ New (Riverpod 3)
-@riverpod
-Future<Data> myProvider(Ref ref) async => ...;
-
-@riverpod
-class MyNotifier extends _$MyNotifier {
-  @override
-  FutureOr<Data> build() async => ...;
-}
-```

package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/postman/flutter-expert/references/widget-patterns.md

@@ -1,123 +0,0 @@
-# Widget Patterns
-
-## Optimized Widget Pattern
-
-```dart
-// Use const constructors
-class OptimizedCard extends StatelessWidget {
-  final String title;
-  final VoidCallback onTap;
-
-  const OptimizedCard({
-    super.key,
-    required this.title,
-    required this.onTap,
-  });
-
-  @override
-  Widget build(BuildContext context) {
-    return Card(
-      child: InkWell(
-        onTap: onTap,
-        child: Padding(
-          padding: const EdgeInsets.all(16),
-          child: Text(title, style: Theme.of(context).textTheme.titleMedium),
-        ),
-      ),
-    );
-  }
-}
-```
-
-## Responsive Layout
-
-```dart
-class ResponsiveLayout extends StatelessWidget {
-  final Widget mobile;
-  final Widget? tablet;
-  final Widget desktop;
-
-  const ResponsiveLayout({
-    super.key,
-    required this.mobile,
-    this.tablet,
-    required this.desktop,
-  });
-
-  @override
-  Widget build(BuildContext context) {
-    return LayoutBuilder(
-      builder: (context, constraints) {
-        if (constraints.maxWidth >= 1100) return desktop;
-        if (constraints.maxWidth >= 650) return tablet ?? mobile;
-        return mobile;
-      },
-    );
-  }
-}
-```
-
-## Custom Hooks (flutter_hooks)
-
-```dart
-import 'package:flutter_hooks/flutter_hooks.dart';
-
-class CounterWidget extends HookWidget {
-  @override
-  Widget build(BuildContext context) {
-    final counter = useState(0);
-    final controller = useTextEditingController();
-
-    useEffect(() {
-      // Setup
-      return () {
-        // Cleanup
-      };
-    }, []);
-
-    return Column(
-      children: [
-        Text('Count: ${counter.value}'),
-        ElevatedButton(
-          onPressed: () => counter.value++,
-          child: const Text('Increment'),
-        ),
-      ],
-    );
-  }
-}
-```
-
-## Sliver Patterns
-
-```dart
-CustomScrollView(
-  slivers: [
-    SliverAppBar(
-      expandedHeight: 200,
-      pinned: true,
-      flexibleSpace: FlexibleSpaceBar(
-        title: const Text('Title'),
-        background: Image.network(imageUrl, fit: BoxFit.cover),
-      ),
-    ),
-    SliverList(
-      delegate: SliverChildBuilderDelegate(
-        (context, index) => ListTile(title: Text('Item $index')),
-        childCount: 100,
-      ),
-    ),
-  ],
-)
-```
-
-## Key Optimization Patterns
-
-| Pattern | Implementation |
-|---------|----------------|
-| **const widgets** | Add `const` to static widgets |
-| **keys** | Use `Key` for list items |
-| **select** | `ref.watch(provider.select(...))` |
-| **RepaintBoundary** | Isolate expensive repaints |
-| **ListView.builder** | Lazy loading for lists |
-| **const constructors** | Always use when possible |

package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/postman/flutter-security-reviewer/POWER.md

@@ -1,204 +0,0 @@
----
-name: "flutter-security-reviewer"
-displayName: "Flutter/Dart Security Reviewer"
-description: "Review Flutter/Dart code for security vulnerabilities: secure storage, network hardening, log redaction, and data protection"
-keywords:
-  [
-    "security",
-    "flutter security",
-    "dart security",
-    "secure storage",
-    "encryption",
-    "log redaction",
-    "network security",
-    "data protection",
-    "pii",
-    "sensitive data",
-    "authentication",
-    "authorization",
-  ]
----
-
-# Flutter/Dart Security Reviewer
-
-## Overview
-
-This power helps you identify and fix security vulnerabilities in mobile and web applications, focusing on secure storage, network hardening, log redaction, and sensitive data handling.
-
-## When to Use
-
-- Reviewing code that handles authentication tokens
-- Implementing secure storage for sensitive data
-- Adding logging/analytics that might expose PII
-- Reviewing network requests for security issues
-- Implementing biometric authentication
-- Handling user passwords or credentials
-- Processing payment information
-- Storing user preferences that contain sensitive data
-- Implementing session management
-- Any code that touches user data
-
-## Review Output Format
-
-When reviewing, output exactly:
-
-1. **Threat summary** (what could go wrong; 3-6 bullets)
-2. **Findings** grouped by severity (CRITICAL/HIGH/MED/LOW)
-3. **Concrete mitigations** (specific code-level steps)
-4. **Security regression tests/checks** (what to verify)
-5. **Logging & privacy audit** (PII, tokens, crash reports)
-
-## Severity Definitions
-
-- **CRITICAL**: Token/session compromise, auth bypass, remote code/data exposure, storing secrets insecurely, PII leakage
-- **HIGH**: Weak access control, insecure defaults, sensitive data in logs, missing TLS assumptions
-- **MED**: Hardening gaps (timeouts, retry abuse, overly broad permissions)
-- **LOW**: Best-practice improvements
-
----
-
-## 1) Authentication & Session Security
-
-### Tokens
-
-**CRITICAL:**
-- Tokens in logs, analytics events, crash reports
-- Tokens stored in plain SharedPreferences without justification
-
-**Recommendations:**
-- Prefer secure storage for tokens (platform-backed) where possible
-- If SharedPreferences must be used, ensure:
-  - Short-lived access tokens + refresh tokens handled carefully
-  - Minimal token surface; never log
-
-### Route Guards
-- Ensure router guards cannot be bypassed by deep links
-- Guard decisions must use authoritative session provider state
-- Avoid redirect loops (secure + usability)
-
----
-
-## 2) Network Security
-
-### Checklist
-- [ ] Use HTTPS in UAT/Prod baseUrl
-- [ ] Reasonable timeouts (connect/receive)
-- [ ] Avoid disabling cert validation
-- [ ] Do not accept all certs in production
-- [ ] Interceptors must not log sensitive headers or body fields
-
-### Retry Policy
-- Avoid retrying non-idempotent requests unless safe
-- Backoff + max attempts
-
-### Device ↔ Gateway Security
-- Prefer server-side validation and proper auth
-- Never "security-by-obscurity" headers
-
----
-
-## 3) Local Data Protection
-
-**CRITICAL:**
-- Storing PII or tokens unencrypted without threat model
-
-**Guidance:**
-- Store only what's needed offline
-- Encrypt sensitive cached blobs if possible, or avoid caching them
-- Apply TTL to cached session/profile data
-- Clear data on logout
-
----
-
-## 4) Input Validation & Injection Safety
-
-- [ ] Validate all user inputs before sending to API
-- [ ] Avoid string interpolation for SQL queries: use parameters
-- [ ] Avoid trusting client-only checks (roles, orgId); server must enforce
-
----
-
-## 5) Privacy, Logging, Analytics
-
-**CRITICAL:**
-- PII in logs (`name`, `phone`, `location`, identifiers)
-- Tokens/headers in logs
-- Crashlytics sending PII
-
-**Guidance:**
-- Redact: Authorization headers, cookies, IDs if sensitive
-- Provide `toSafeLog()` helpers
-- Ensure debug logging is disabled/limited in release builds
-
----
-
-## 6) Dependency & Supply Chain Hygiene
-
-- [ ] Check new packages are reputable and maintained
-- [ ] Avoid adding packages that request broad permissions without need
-- [ ] Pin versions as appropriate; review changelogs for security fixes
-
----
-
-## 7) Security Review Checklist for PRs
-
-### Always Search For
-- `print(`, `debugPrint(`, logging interceptors
-- `Authorization`, `token`, `refresh`, `secret`, `apiKey`
-- `badCertificateCallback`, `HttpClient` overrides
-- Persistent storage of user/session data
-
-### Enforce
-- [ ] No secrets in repo
-- [ ] No insecure network overrides in production
-- [ ] Logout clears sensitive local data
-- [ ] Access control enforced server-side (don't trust client role/org headers alone)
-
----
-
-## Quick Reference
-
-### Secure Storage (DO)
-
-```dart
-// ✅ Use flutter_secure_storage for tokens
-final storage = FlutterSecureStorage();
-await storage.write(key: 'auth_token', value: token);
-```
-
-### Secure Storage (DON'T)
-
-```dart
-// ❌ Never store tokens in SharedPreferences
-final prefs = await SharedPreferences.getInstance();
-prefs.setString('auth_token', token); // INSECURE!
-
-// ❌ Never hardcode secrets
-const apiKey = 'sk_live_abc123'; // NEVER DO THIS
-```
-
-### Log Redaction
-
-```dart
-// ❌ Bad - logs sensitive data
-logger.info('User login: ${user.email}, password: ${password}');
-
-// ✅ Good - no sensitive data in logs
-logger.info('User login successful: userId=${user.id}');
-```
-
----
-
-## Steering Files
-
-| File                        | Load When                              |
-| --------------------------- | -------------------------------------- |
-| `secure_storage_policy.md`  | What to store where                    |
-| `network_hardening.md`      | Network security best practices        |
-| `log_redaction.md`          | How to redact sensitive data from logs |
-| `vulnerability-patterns.md` | SQL injection, XSS, IDOR patterns      |
-| `secret-scanning.md`        | Finding hardcoded secrets              |
-
-## Templates
-
-- `security_review_response.md` - Security review report template