maxsim-flutter 1.0.0

package/dist/claude-setup/prd-generator.js

@@ -0,0 +1,295 @@
+/**
+ * Generates a prd.json for the scaffolded Flutter project.
+ * Stories are organized into three phases:
+ *   Phase 1 - Core app setup and basic navigation
+ *   Phase 2 - Module-specific features (conditional on enabled modules)
+ *   Phase 3 - Integration and end-to-end testing
+ */
+export function generatePrd(context) {
+    const rawStories = [
+        ...generatePhase1Stories(context),
+        ...generatePhase2Stories(context),
+        ...generatePhase3Stories(context),
+    ];
+    // Assign sequential IDs
+    const numbered = rawStories.map((story, index) => ({
+        ...story,
+        id: `S-${String(index + 1).padStart(3, '0')}`,
+    }));
+    const prd = {
+        version: '1.0.0',
+        project: context.projectName,
+        stories: numbered,
+    };
+    return JSON.stringify(prd, null, 2) + '\n';
+}
+function generatePhase1Stories(context) {
+    return [
+        {
+            phase: 1,
+            priority: 'P0',
+            title: 'Setup Clean Architecture project structure',
+            description: `Verify and finalize the scaffolded project structure for ${context.projectName}. Ensure all directories follow Clean Architecture conventions with domain, data, and presentation layers per feature. Configure analysis_options.yaml with appropriate lint rules.`,
+            acceptanceCriteria: [
+                '`lib/features/` directory exists with at minimum a `home` feature',
+                'Each feature contains `domain/`, `data/`, and `presentation/` subdirectories',
+                '`lib/core/` contains router, theme, and providers directories',
+                '`flutter analyze` reports zero errors',
+                '`dart format --set-exit-if-changed .` passes',
+            ],
+            passes: false,
+        },
+        {
+            phase: 1,
+            priority: 'P0',
+            title: 'Configure go_router with type-safe routes',
+            description: 'Set up go_router in `lib/core/router/app_router.dart` using TypedGoRoute annotations. Define initial route to HomeRoute. Register the router as a Riverpod provider. Run build_runner to generate route code.',
+            acceptanceCriteria: [
+                '`lib/core/router/app_router.dart` exists with GoRouter configuration',
+                'Router is exposed as a Riverpod provider (`routerProvider`)',
+                '`HomeRoute` is defined with `@TypedGoRoute(path: \'/\')`',
+                '`lib/core/router/app_router.g.dart` is generated by build_runner',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        },
+        {
+            phase: 1,
+            priority: 'P0',
+            title: 'Configure Riverpod ProviderScope and global providers',
+            description: 'Ensure `main.dart` wraps the app in `ProviderScope`. Set up `lib/core/providers/app_providers.dart` as a barrel export for all core providers. Verify the app boots without errors.',
+            acceptanceCriteria: [
+                '`main.dart` wraps `runApp` with `ProviderScope`',
+                '`lib/core/providers/app_providers.dart` exports core providers',
+                'App compiles and runs without errors',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        },
+        {
+            phase: 1,
+            priority: 'P1',
+            title: `Implement ${context.projectName} home screen`,
+            description: `Build the initial home screen at \`lib/features/home/presentation/pages/home_page.dart\`. The page should use ConsumerWidget and display the project name. Wire it up to the \`/\` route in app_router.`,
+            acceptanceCriteria: [
+                '`home_page.dart` exists and extends `ConsumerWidget`',
+                'Home page displays the app name or a welcome message',
+                'Route `/` navigates to the home page',
+                'Widget test in `test/features/home/` passes',
+                '`flutter test` passes all tests',
+            ],
+            passes: false,
+        },
+    ];
+}
+function generatePhase2Stories(context) {
+    const stories = [];
+    if (context.modules.auth) {
+        const provider = context.modules.auth.provider;
+        const providerLabel = provider === 'firebase' ? 'Firebase Auth' : provider === 'supabase' ? 'Supabase Auth' : 'custom auth';
+        stories.push({
+            phase: 2,
+            priority: 'P0',
+            title: `Implement authentication with ${providerLabel}`,
+            description: `Build the auth feature in \`lib/features/auth/\` following Clean Architecture. Domain layer: \`AuthRepository\` interface and \`User\` entity. Data layer: \`${capitalize(provider)}AuthDataSource\` and \`AuthRepositoryImpl\`. Presentation layer: \`authRepositoryProvider\`, login page, register page. Add auth guard to go_router redirect.`,
+            acceptanceCriteria: [
+                '`lib/features/auth/domain/repositories/auth_repository.dart` defines `AuthRepository` interface',
+                '`lib/features/auth/domain/entities/user.dart` defines `User` entity with freezed',
+                'Auth repository implementation connects to ' + providerLabel,
+                '`/login` and `/register` routes exist and render auth pages',
+                'Auth guard in go_router redirects unauthenticated users to `/login`',
+                'Unit tests for auth use cases pass',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.api) {
+        const baseUrl = context.modules.api.baseUrl ?? 'API_BASE_URL env variable';
+        stories.push({
+            phase: 2,
+            priority: 'P1',
+            title: 'Implement API client with Dio and interceptors',
+            description: `Configure a Dio HTTP client in \`lib/features/api/\`. Base URL: ${baseUrl}. Add interceptors for auth token injection, retry on transient failures, and request logging. Expose via \`dioClientProvider\`. Define \`ApiException\` for typed error handling.`,
+            acceptanceCriteria: [
+                '`dioClientProvider` is a Riverpod Provider returning a configured `Dio` instance',
+                'Auth interceptor injects Bearer token from auth state (if auth module is enabled)',
+                'Retry interceptor handles 5xx errors with exponential backoff',
+                '`ApiException` maps HTTP status codes to typed errors',
+                'Unit tests for interceptors pass',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.database) {
+        const engine = context.modules.database.engine;
+        const engineLabel = engine === 'drift' ? 'Drift (SQLite)' : engine === 'hive' ? 'Hive' : 'Isar';
+        stories.push({
+            phase: 2,
+            priority: 'P1',
+            title: `Configure local database with ${engineLabel}`,
+            description: `Set up ${engineLabel} in \`lib/features/database/\`. Define initial schema/collections. Expose database via \`databaseProvider\`. Add initialization in main.dart before runApp. Run build_runner to generate database code.`,
+            acceptanceCriteria: [
+                `${engineLabel} is initialized before the app starts`,
+                '`databaseProvider` exposes the database instance via Riverpod',
+                engine === 'drift' ? '`AppDatabase` class with at least one table defined' : `${engineLabel} adapter/collection defined`,
+                'build_runner generates code without conflicts',
+                'Unit test verifies database can be opened and written to',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.i18n) {
+        const { defaultLocale, supportedLocales } = context.modules.i18n;
+        stories.push({
+            phase: 2,
+            priority: 'P1',
+            title: 'Implement internationalization with flutter_localizations',
+            description: `Set up i18n in \`lib/core/l10n/\`. Create ARB files for: ${supportedLocales.join(', ')} (default: ${defaultLocale}). Run \`flutter gen-l10n\` to generate \`AppLocalizations\`. Update MaterialApp to include localization delegates.`,
+            acceptanceCriteria: [
+                `ARB files exist for all supported locales: ${supportedLocales.join(', ')}`,
+                '`AppLocalizations` is generated and available via `AppLocalizations.of(context)!`',
+                'MaterialApp includes `AppLocalizations.delegate` and `supportedLocales`',
+                'At minimum, app title and home screen greeting are localized',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.theme) {
+        const { seedColor, darkMode } = context.modules.theme;
+        const seedNote = seedColor ? `seed color ${seedColor}` : 'default purple seed color';
+        stories.push({
+            phase: 2,
+            priority: 'P1',
+            title: 'Implement Material 3 theme system',
+            description: `Build the theme in \`lib/core/theme/app_theme.dart\` using Material 3 ColorScheme.fromSeed with ${seedNote}. ${darkMode ? 'Support both light and dark themes via `appThemeModeProvider`.' : 'Light theme only.'} Apply Google Fonts (Inter) as the default text theme.`,
+            acceptanceCriteria: [
+                '`AppTheme.light()` returns a `ThemeData` with Material 3 enabled',
+                darkMode ? '`AppTheme.dark()` returns a dark `ThemeData`' : 'Light theme applied consistently',
+                darkMode ? '`appThemeModeProvider` toggles between light and dark modes' : 'Theme applied to MaterialApp',
+                'Google Fonts Inter is applied as the text theme',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.push) {
+        const provider = context.modules.push.provider;
+        const providerLabel = provider === 'firebase' ? 'Firebase Cloud Messaging' : 'OneSignal';
+        stories.push({
+            phase: 2,
+            priority: 'P2',
+            title: `Implement push notifications with ${providerLabel}`,
+            description: `Configure ${providerLabel} in \`lib/features/push/\`. Request notification permissions at app startup. Handle foreground, background, and terminated state notifications. Expose push token via \`pushTokenProvider\`.`,
+            acceptanceCriteria: [
+                `${providerLabel} is initialized before the app starts`,
+                'Notification permission is requested on first launch',
+                'Foreground notification handler displays an in-app notification',
+                'Background/terminated notification tap navigates to correct screen',
+                '`pushTokenProvider` returns the device token as a Future<String?>',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.analytics) {
+        stories.push({
+            phase: 2,
+            priority: 'P2',
+            title: 'Implement analytics event tracking',
+            description: 'Create `AnalyticsService` abstraction in `lib/features/analytics/`. Implement a GoRouter observer that tracks screen views automatically. Provide `analyticsServiceProvider` for logging custom events. Log app open event on startup.',
+            acceptanceCriteria: [
+                '`AnalyticsService` interface defines `logEvent(name, params)` and `logScreen(name)`',
+                'GoRouter observer automatically tracks screen navigation',
+                '`analyticsServiceProvider` exposes the `AnalyticsService`',
+                'App open event is logged on startup',
+                'Unit tests mock `AnalyticsService` and verify event calls',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.cicd) {
+        const providerLabel = context.modules.cicd.provider;
+        stories.push({
+            phase: 2,
+            priority: 'P2',
+            title: `Configure ${capitalize(providerLabel)} CI/CD pipeline`,
+            description: `Set up CI/CD pipeline for ${capitalize(providerLabel)}. Pipeline should run on every push: (1) flutter analyze, (2) flutter test, (3) flutter build. Cache Flutter SDK and pub dependencies for speed.`,
+            acceptanceCriteria: [
+                providerLabel === 'github' ? '`.github/workflows/ci.yml` exists and is valid YAML' : providerLabel === 'gitlab' ? '`.gitlab-ci.yml` exists and is valid YAML' : '`bitbucket-pipelines.yml` exists and is valid YAML',
+                'Pipeline includes analyze, test, and build stages/jobs',
+                'Flutter pub cache is configured for fast runs',
+                'Pipeline triggers on push to main and pull requests',
+                '`flutter analyze` reports zero errors in CI config files',
+            ],
+            passes: false,
+        });
+    }
+    if (context.modules.deepLinking) {
+        const { scheme, host } = context.modules.deepLinking;
+        const linkExample = scheme && host ? `${scheme}://${host}` : 'app://example.com';
+        stories.push({
+            phase: 2,
+            priority: 'P2',
+            title: 'Implement deep linking with app_links',
+            description: `Configure deep links using \`app_links\` package. Handle Universal Links (iOS) and App Links (Android). Integrate with go_router for automatic route resolution. Example link: \`${linkExample}\`.`,
+            acceptanceCriteria: [
+                '`app_links` is initialized at app startup',
+                'Incoming deep links are forwarded to go_router for navigation',
+                scheme ? `Custom scheme \`${scheme}://\` is handled` : 'Deep link scheme is configured in platform files',
+                host ? `Host \`${host}\` is configured for Universal/App Links` : 'Host is configured in platform-specific files',
+                'Widget test verifies deep link navigation',
+                '`flutter analyze` reports zero errors',
+            ],
+            passes: false,
+        });
+    }
+    return stories;
+}
+function generatePhase3Stories(context) {
+    const enabledModules = [];
+    if (context.modules.auth)
+        enabledModules.push('auth');
+    if (context.modules.api)
+        enabledModules.push('api');
+    if (context.modules.database)
+        enabledModules.push('database');
+    return [
+        {
+            phase: 3,
+            priority: 'P1',
+            title: 'Write integration tests for core user flows',
+            description: `Write integration tests covering the main user journeys in ${context.projectName}. ${enabledModules.length > 0 ? `Test flows involving: ${enabledModules.join(', ')}.` : 'Test home screen navigation and basic app flows.'} Use \`integration_test\` package with \`flutter_test\`.`,
+            acceptanceCriteria: [
+                '`integration_test/` directory exists with at least one integration test file',
+                'Tests cover the happy path for core user journeys',
+                'Tests use `WidgetTester` for UI interactions',
+                '`flutter test integration_test/` passes all tests',
+                'Test coverage report shows >70% coverage for presentation layer',
+            ],
+            passes: false,
+        },
+        {
+            phase: 3,
+            priority: 'P2',
+            title: 'Final quality audit and documentation',
+            description: `Perform a final quality pass on all code in ${context.projectName}. Fix any remaining analyzer warnings. Ensure all public APIs have dartdoc comments. Verify README.md documents how to run the app and run tests.`,
+            acceptanceCriteria: [
+                '`flutter analyze` reports zero errors AND zero warnings',
+                '`flutter test` passes all tests',
+                '`dart format --set-exit-if-changed .` passes',
+                'README.md includes setup instructions and how to run the app',
+                'All public provider declarations have dartdoc comments',
+            ],
+            passes: false,
+        },
+    ];
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=prd-generator.js.map

package/dist/claude-setup/prd-generator.js.map

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

package/dist/claude-setup/setup-orchestrator.d.ts

@@ -0,0 +1,11 @@
+import type { ProjectContext } from '../core/context.js';
+export interface ClaudeSetupResult {
+    filesWritten: string[];
+}
+/**
+ * Runs the full Claude setup for a scaffolded Flutter project.
+ * Generates CLAUDE.md, agent definitions, skills, hooks, MCP config,
+ * slash commands, and prd.json.
+ */
+export declare function runClaudeSetup(context: ProjectContext, outputPath: string): Promise<ClaudeSetupResult>;
+//# sourceMappingURL=setup-orchestrator.d.ts.map

package/dist/claude-setup/setup-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-orchestrator.d.ts","sourceRoot":"","sources":["../../src/claude-setup/setup-orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,CA+C5B"}

package/dist/claude-setup/setup-orchestrator.js

@@ -0,0 +1,46 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { generateClaudeMd } from './claude-md-generator.js';
+import { writeAgents } from './agent-writer.js';
+import { writeSkills } from './skill-writer.js';
+import { writeHooks } from './hooks-writer.js';
+import { writeMcpConfig } from './mcp-config-writer.js';
+import { writeCommands } from './commands-writer.js';
+import { generatePrd } from './prd-generator.js';
+/**
+ * Runs the full Claude setup for a scaffolded Flutter project.
+ * Generates CLAUDE.md, agent definitions, skills, hooks, MCP config,
+ * slash commands, and prd.json.
+ */
+export async function runClaudeSetup(context, outputPath) {
+    const filesWritten = [];
+    // Ensure .claude directory exists
+    await mkdir(join(outputPath, '.claude'), { recursive: true });
+    // 1. Generate and write CLAUDE.md
+    const claudeMdContent = generateClaudeMd(context);
+    const claudeMdPath = join(outputPath, 'CLAUDE.md');
+    await writeFile(claudeMdPath, claudeMdContent, 'utf-8');
+    filesWritten.push(claudeMdPath);
+    // 2. Write agent definition files (.claude/agents/)
+    const agentFiles = await writeAgents(context, outputPath);
+    filesWritten.push(...agentFiles);
+    // 3. Write skill files (.claude/skills/)
+    await writeSkills(context, outputPath);
+    filesWritten.push(join(outputPath, '.claude', 'skills', 'flutter-patterns.md'), join(outputPath, '.claude', 'skills', 'go-router-patterns.md'), join(outputPath, '.claude', 'skills', 'module-conventions.md'), join(outputPath, '.claude', 'skills', 'prd.md'));
+    // 4. Write hooks config (.claude/settings.local.json)
+    await writeHooks(context, outputPath);
+    filesWritten.push(join(outputPath, '.claude', 'settings.local.json'));
+    // 5. Write MCP server config (.mcp.json)
+    await writeMcpConfig(context, outputPath);
+    filesWritten.push(join(outputPath, '.mcp.json'));
+    // 6. Write slash commands (.claude/commands/)
+    await writeCommands(context, outputPath);
+    filesWritten.push(join(outputPath, '.claude', 'commands', 'add-feature.md'), join(outputPath, '.claude', 'commands', 'analyze.md'));
+    // 7. Generate and write prd.json
+    const prdContent = generatePrd(context);
+    const prdPath = join(outputPath, 'prd.json');
+    await writeFile(prdPath, prdContent, 'utf-8');
+    filesWritten.push(prdPath);
+    return { filesWritten };
+}
+//# sourceMappingURL=setup-orchestrator.js.map

package/dist/claude-setup/setup-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-orchestrator.js","sourceRoot":"","sources":["../../src/claude-setup/setup-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB,EACvB,UAAkB;IAElB,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,kCAAkC;IAClC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9D,kCAAkC;IAClC,MAAM,eAAe,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACnD,MAAM,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IACxD,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAEhC,oDAAoD;IACpD,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1D,YAAY,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAEjC,yCAAyC;IACzC,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,CACf,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,qBAAqB,CAAC,EAC5D,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,CAAC,EAC9D,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,CAAC,EAC9D,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAChD,CAAC;IAEF,sDAAsD;IACtD,MAAM,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAEtE,yCAAyC;IACzC,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAEjD,8CAA8C;IAC9C,MAAM,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACzC,YAAY,CAAC,IAAI,CACf,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,CAAC,EACzD,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CACtD,CAAC;IAEF,iCAAiC;IACjC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3B,OAAO,EAAE,YAAY,EAAE,CAAC;AAC1B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,256 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function writeSkills(context, outputPath) {
+    const skillsDir = path.join(outputPath, '.claude', 'skills');
+    await fs.ensureDir(skillsDir);
+    await Promise.all([
+        fs.writeFile(path.join(skillsDir, 'flutter-patterns.md'), generateFlutterPatterns()),
+        fs.writeFile(path.join(skillsDir, 'go-router-patterns.md'), generateGoRouterPatterns(context)),
+        fs.writeFile(path.join(skillsDir, 'module-conventions.md'), generateModuleConventions()),
+        fs.writeFile(path.join(skillsDir, 'prd.md'), generatePrdGuide()),
+    ]);
+}
+function generateFlutterPatterns() {
+    return [
+        '# Flutter / Riverpod Patterns',
+        '',
+        '## Provider Naming Conventions',
+        '',
+        '- Providers are top-level `final` variables with a `Provider` suffix',
+        '- Repository providers: `authRepositoryProvider`, `userRepositoryProvider`',
+        '- State providers: `userNotifierProvider`, `authStateProvider`',
+        '- Computed providers: `isLoggedInProvider`, `currentUserProvider`',
+        '',
+        '## Provider Types',
+        '',
+        '| Type | Use Case |',
+        '|------|----------|',
+        '| `Provider` | Computed values, repository instances, services |',
+        '| `NotifierProvider` | Synchronous mutable state (Riverpod 2.0+) |',
+        '| `AsyncNotifierProvider` | Async mutable state (Riverpod 2.0+) |',
+        '| `FutureProvider` | One-shot async data (auto-disposes, caches) |',
+        '| `StreamProvider` | Real-time streams (Firestore, WebSocket) |',
+        '| `StateProvider` | Simple primitive state (bool, int, String) |',
+        '',
+        '## ref.watch vs ref.read',
+        '',
+        '- **`ref.watch()`**: Use inside `build()` methods and provider bodies. Re-builds when value changes.',
+        '- **`ref.read()`**: Use inside callbacks, event handlers. Does NOT trigger rebuilds.',
+        '- **`ref.listen()`**: Side effects in response to state changes (snackbars, navigation).',
+        '',
+        '## AsyncNotifier (preferred for Riverpod 2.0+)',
+        '',
+        '```dart',
+        'final userProvider = AsyncNotifierProvider<UserNotifier, User?>(() {',
+        '  return UserNotifier();',
+        '});',
+        '',
+        'class UserNotifier extends AsyncNotifier<User?> {',
+        '  @override',
+        '  Future<User?> build() async {',
+        '    return ref.watch(authRepositoryProvider).getCurrentUser();',
+        '  }',
+        '',
+        '  Future<void> refresh() async {',
+        '    state = const AsyncLoading();',
+        '    state = await AsyncValue.guard(() =>',
+        '      ref.read(authRepositoryProvider).getCurrentUser()',
+        '    );',
+        '  }',
+        '}',
+        '```',
+        '',
+        '## Provider Composition',
+        '',
+        '```dart',
+        'final httpClientProvider = Provider<Dio>((ref) => Dio());',
+        '',
+        'final authDataSourceProvider = Provider<AuthRemoteDataSource>((ref) {',
+        '  return AuthRemoteDataSourceImpl(ref.watch(httpClientProvider));',
+        '});',
+        '',
+        'final authRepositoryProvider = Provider<AuthRepository>((ref) {',
+        '  return AuthRepositoryImpl(ref.watch(authDataSourceProvider));',
+        '});',
+        '```',
+        '',
+        '## State Management Best Practices',
+        '',
+        '1. **Immutable state**: Use `freezed` for state classes to avoid mutation bugs',
+        '2. **Single source of truth**: One provider owns each piece of state',
+        '3. **Invalidation**: Use `ref.invalidate(provider)` to force a refresh',
+        '4. **Family providers**: Use `.family` modifier for parameterized providers',
+        '5. **Auto-dispose**: Use `.autoDispose` to clean up providers when not in use',
+    ].join('\n');
+}
+function generateGoRouterPatterns(context) {
+    const deepLinkingNote = context.modules.deepLinking
+        ? [
+            '',
+            '## Deep Linking Integration',
+            '',
+            'This project has deep linking enabled. Routes are handled via `app_links`.',
+        ].join('\n')
+        : '';
+    const authGuardNote = context.modules.auth
+        ? [
+            '',
+            '## Auth Guards',
+            '',
+            '```dart',
+            'GoRouter(',
+            '  redirect: (context, state) {',
+            '    final isLoggedIn = ref.read(isLoggedInProvider);',
+            '    final isAuthRoute = state.matchedLocation.startsWith(\'/auth\');',
+            '    if (!isLoggedIn && !isAuthRoute) return \'/auth/login\';',
+            '    if (isLoggedIn && isAuthRoute) return \'/\';',
+            '    return null;',
+            '  },',
+            ')',
+            '```',
+        ].join('\n')
+        : '';
+    return [
+        '# go_router Patterns',
+        '',
+        '## Route Definition',
+        '',
+        'Routes are defined in `lib/core/router/app_router.dart` using TypedGoRoute for type-safe navigation.',
+        '',
+        '```dart',
+        'part \'app_router.g.dart\';',
+        '',
+        '@TypedGoRoute<HomeRoute>(path: \'/\', routes: [',
+        '  TypedGoRoute<ProfileRoute>(path: \'profile\'),',
+        '])',
+        '@immutable',
+        'class HomeRoute extends GoRouteData {',
+        '  const HomeRoute();',
+        '',
+        '  @override',
+        '  Widget build(BuildContext context, GoRouterState state) => const HomePage();',
+        '}',
+        '```',
+        '',
+        '## Navigation',
+        '',
+        '```dart',
+        '// Type-safe (preferred)',
+        'const HomeRoute().go(context);',
+        'ProfileRoute(userId: \'123\').push(context);',
+        '```',
+        authGuardNote,
+        deepLinkingNote,
+        '',
+        '## Adding a New Route',
+        '',
+        '1. Create a route class with `@TypedGoRoute` annotation',
+        '2. Implement the `build()` method returning the page widget',
+        '3. Run `dart run build_runner build --delete-conflicting-outputs`',
+        '4. Update the parent route\'s `routes` list if it\'s a child route',
+    ].join('\n');
+}
+function generateModuleConventions() {
+    return [
+        '# Module Conventions (Clean Architecture)',
+        '',
+        '## Directory Structure Per Feature',
+        '',
+        '```',
+        'lib/features/<feature-name>/',
+        '├── domain/',
+        '│   ├── entities/          # Pure Dart models (use freezed)',
+        '│   ├── repositories/      # Abstract repository interfaces',
+        '│   └── usecases/          # Single-responsibility business operations',
+        '├── data/',
+        '│   ├── datasources/       # Remote (API) and local (DB) data sources',
+        '│   ├── models/            # Data transfer objects with serialization',
+        '│   └── repositories/      # Repository implementations',
+        '└── presentation/',
+        '    ├── pages/             # Full-screen UI (route targets)',
+        '    ├── widgets/           # Reusable UI components',
+        '    └── providers/         # Riverpod providers and state notifiers',
+        '```',
+        '',
+        '## Layer Dependency Rules',
+        '',
+        '```',
+        'Domain ← Data ← Presentation',
+        '```',
+        '',
+        '- **Domain**: No dependencies on other layers or external packages',
+        '- **Data**: Depends on Domain only (implements repository interfaces)',
+        '- **Presentation**: Depends on Domain only (accesses Data via providers)',
+        '',
+        '## Cross-Feature Communication',
+        '',
+        'Features should NOT import from each other directly. Use:',
+        '',
+        '- **Providers**: Share state through Riverpod providers in `lib/core/providers/`',
+        '- **Entities**: Share domain entities through `lib/core/domain/`',
+        '- **Events**: Use streams or callbacks for loose coupling',
+        '',
+        '## Adding a New Feature',
+        '',
+        '1. Create feature directory following the structure above',
+        '2. Start with Domain layer: entities, repository interfaces, use cases',
+        '3. Add Data layer: models, data sources, repository implementation',
+        '4. Add Presentation layer: providers, pages, widgets',
+        '5. Register routes in `lib/core/router/app_router.dart`',
+        '6. Run code generation: `dart run build_runner build`',
+        '7. Write tests in `test/features/<name>/`',
+    ].join('\n');
+}
+function generatePrdGuide() {
+    return [
+        '# Working with prd.json',
+        '',
+        '## Story Structure',
+        '',
+        '```json',
+        '{',
+        '  "id": "S-001",',
+        '  "phase": 1,',
+        '  "priority": "P0",',
+        '  "title": "Short imperative title",',
+        '  "description": "Detailed description of what needs to be built",',
+        '  "acceptanceCriteria": [',
+        '    "Criterion 1 that must be true for the story to be complete",',
+        '    "Criterion 2"',
+        '  ],',
+        '  "passes": false',
+        '}',
+        '```',
+        '',
+        '## Fields',
+        '',
+        '| Field | Type | Description |',
+        '|-------|------|-------------|',
+        '| `id` | string | Unique story identifier (e.g., "S-001") |',
+        '| `phase` | number | Implementation phase (1=core, 2=features, 3=polish, 4=advanced) |',
+        '| `priority` | string | P0 (critical), P1 (high), P2 (medium), P3 (low) |',
+        '| `title` | string | Short description of what to implement |',
+        '| `description` | string | Full requirements and context |',
+        '| `acceptanceCriteria` | string[] | Measurable conditions that must be true when done |',
+        '| `passes` | boolean | `true` when story is complete and quality gates pass |',
+        '',
+        '## Workflow for Implementing a Story',
+        '',
+        '1. **Read the story**: Understand the description and acceptance criteria',
+        '2. **Plan**: Identify which files need to be created or modified',
+        '3. **Implement**: Follow Clean Architecture layers (domain → data → presentation)',
+        '4. **Test**: Write unit/integration tests covering the acceptance criteria',
+        '5. **Quality gates**: Run `flutter analyze && flutter test`',
+        '6. **Mark complete**: Set `"passes": true` in `prd.json`',
+        '7. **Commit**: `git commit -m "feat: [S-001] - Story title"`',
+        '',
+        '## Marking a Story Complete',
+        '',
+        'Only mark `passes: true` when:',
+        '- All acceptance criteria are demonstrably met',
+        '- `flutter analyze` returns zero errors or warnings',
+        '- `flutter test` passes all tests',
+        '- Code follows Clean Architecture layer rules',
+    ].join('\n');
+}
+//# sourceMappingURL=skill-writer.js.map