maxsim-flutter 1.17.0 → 1.18.0

package/dist/claude-setup/rules-writer.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectContext } from '../core/context.js';
+export declare function writeRules(context: ProjectContext, outputPath: string): Promise<void>;
+//# sourceMappingURL=rules-writer.d.ts.map

package/dist/claude-setup/rules-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-writer.d.ts","sourceRoot":"","sources":["../../src/claude-setup/rules-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAsKzD,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3F"}

package/dist/claude-setup/rules-writer.js

@@ -0,0 +1,162 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+function frontmatter(paths) {
+    const pathLines = paths.map((p) => `  - "${p}"`).join('\n');
+    return `---\npaths:\n${pathLines}\n---\n\n`;
+}
+function generateArchitectureRule() {
+    return (frontmatter(['lib/**', 'test/**']) +
+        `# Clean Architecture Rules
+
+This project follows Clean Architecture with three layers:
+
+- **domain**: Entities, repository interfaces, use cases. No Flutter or package dependencies.
+- **data**: Repository implementations, data sources, DTOs. Implements domain interfaces.
+- **presentation**: UI widgets, controllers, Riverpod providers. Depends on domain use cases only.
+
+## Rules
+- Never import from \`presentation\` into \`domain\` or \`data\`.
+- Never import from \`data\` into \`domain\`.
+- Use cases live in \`domain/use_cases/\` and contain business logic only.
+- Repository interfaces are defined in \`domain/repositories/\`.
+- All external dependencies (network, database) are injected via interfaces.
+`);
+}
+function generateRiverpodRule() {
+    return (frontmatter(['lib/**']) +
+        `# Riverpod Patterns
+
+Use Riverpod for all state management and dependency injection.
+
+## Rules
+- Use \`ref.watch\` for reactive reads inside \`build()\` methods.
+- Use \`ref.read\` for one-time reads in event handlers.
+- Prefer \`AsyncNotifierProvider\` for async state with loading/error handling.
+- Annotate providers with \`@riverpod\` and run \`build_runner\` to generate code.
+- Keep providers small and focused — one responsibility per provider.
+`);
+}
+function generateGoRouterRule() {
+    return (frontmatter(['lib/**']) +
+        `# go_router Navigation Rules
+
+Use go_router for declarative navigation.
+
+## Rules
+- Define all routes in a central \`AppRouter\` class.
+- Use typed routes with \`GoRoute\` path parameters.
+- Redirect guards for authentication go in the \`redirect\` callback.
+- Prefer \`context.go()\` for full navigation stack replacement.
+- Use \`context.push()\` for stacked navigation.
+`);
+}
+function generateTestingRule() {
+    return (frontmatter(['test/**']) +
+        `# Testing Conventions
+
+All features must have corresponding test coverage.
+
+## Rules
+- Mirror the \`lib/\` structure under \`test/\`.
+- Unit test every use case, repository, and provider.
+- Use \`mocktail\` or \`mockito\` for mocking dependencies.
+- Widget tests go in \`test/presentation/\`.
+- Integration tests go in \`test/integration/\`.
+- Aim for 80%+ statement and branch coverage.
+`);
+}
+function generateSecurityRule() {
+    return (frontmatter(['lib/**']) +
+        `# Security Guidelines
+
+Follow these security best practices in all code.
+
+## Rules
+- Never hardcode secrets, API keys, or credentials in source code.
+- Use \`flutter_secure_storage\` for sensitive user data.
+- Validate and sanitize all user inputs before use.
+- Use HTTPS for all network requests; never allow plain HTTP in production.
+- Apply the principle of least privilege for permissions.
+- Redact sensitive data from logs.
+`);
+}
+function generateAuthRule() {
+    return (frontmatter(['lib/features/auth/**', 'test/features/auth/**']) +
+        `# Authentication Rules
+
+Guidelines for the auth feature module.
+
+## Rules
+- All auth state is managed through the auth provider — never store tokens in plain SharedPreferences.
+- Use secure storage for auth tokens and session data.
+- Protect routes by checking auth state in go_router redirect guards.
+- On logout, clear all cached user data and navigate to the login screen.
+- Handle token refresh transparently in the API client interceptor.
+`);
+}
+function generateApiRule() {
+    return (frontmatter(['lib/core/api/**', 'lib/data/**']) +
+        `# API & HTTP Client Rules
+
+Guidelines for HTTP networking with Dio.
+
+## Rules
+- All API calls go through the central Dio client configured in \`core/api/\`.
+- Use interceptors for auth token injection and token refresh.
+- Map HTTP error responses to typed domain failures — never expose raw Dio exceptions to use cases.
+- Use \`retrofit\` or a repository pattern to abstract API endpoints.
+- Log requests and responses only in debug mode; never log sensitive data.
+`);
+}
+function generateDatabaseRule() {
+    return (frontmatter(['lib/data/**', 'test/data/**']) +
+        `# Database & Local Storage Rules
+
+Guidelines for local database and storage access.
+
+## Rules
+- All database access is encapsulated in repository implementations under \`data/\`.
+- Use Drift (or Hive/Isar) for structured local data; never raw file I/O for app data.
+- Define database schema migrations explicitly — never drop and recreate tables.
+- Expose only domain models from repositories — never leak database entities to \`domain\` or \`presentation\`.
+- Use transactions for multi-step writes to ensure consistency.
+`);
+}
+function generateI18nRule() {
+    return (frontmatter(['lib/**']) +
+        `# Internationalization (i18n) Rules
+
+Guidelines for localization.
+
+## Rules
+- All user-visible strings must be externalized in ARB files under \`l10n/\`.
+- Never hardcode display strings in widget code.
+- Use \`AppLocalizations.of(context)!\` to access translations.
+- Add new strings to all supported locale files before shipping.
+- Use ICU message format for plurals and gender variations.
+`);
+}
+export async function writeRules(context, outputPath) {
+    const rulesDir = join(outputPath, '.claude', 'rules');
+    await mkdir(rulesDir, { recursive: true });
+    // Core rules — always generated
+    await writeFile(join(rulesDir, 'architecture.md'), generateArchitectureRule(), 'utf-8');
+    await writeFile(join(rulesDir, 'riverpod.md'), generateRiverpodRule(), 'utf-8');
+    await writeFile(join(rulesDir, 'go-router.md'), generateGoRouterRule(), 'utf-8');
+    await writeFile(join(rulesDir, 'testing.md'), generateTestingRule(), 'utf-8');
+    await writeFile(join(rulesDir, 'security.md'), generateSecurityRule(), 'utf-8');
+    // Conditional module rules
+    if (context.modules.auth) {
+        await writeFile(join(rulesDir, 'auth.md'), generateAuthRule(), 'utf-8');
+    }
+    if (context.modules.api) {
+        await writeFile(join(rulesDir, 'api.md'), generateApiRule(), 'utf-8');
+    }
+    if (context.modules.database) {
+        await writeFile(join(rulesDir, 'database.md'), generateDatabaseRule(), 'utf-8');
+    }
+    if (context.modules.i18n) {
+        await writeFile(join(rulesDir, 'i18n.md'), generateI18nRule(), 'utf-8');
+    }
+}
+//# sourceMappingURL=rules-writer.js.map

package/dist/claude-setup/rules-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-writer.js","sourceRoot":"","sources":["../../src/claude-setup/rules-writer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maxsim-flutter",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "AI-powered Flutter app scaffolding with Clean Architecture, Riverpod, and autonomous development via Ralph",
   "type": "module",
   "bin": {