maxsim-flutter 1.29.0 → 1.31.0

package/dist/plan/index.d.ts

@@ -0,0 +1,12 @@
+export { isValidSnakeCase } from './types.js';
+export type { PlanInput, PlanResult } from './types.js';
+export { writePartialConfig } from './config-writer.js';
+export type { PartialConfigInput } from './config-writer.js';
+export { generateBriefTemplate } from './brief-template-generator.js';
+export type { BriefTemplateInput } from './brief-template-generator.js';
+export { generatePlanAppSkill } from './skill-generator.js';
+export type { SkillInput } from './skill-generator.js';
+export { runPlan } from './plan-orchestrator.js';
+export { classifyAppType } from './app-type-classifier.js';
+export type { AppType, AppTypeResult, ModuleSuggestion } from './app-type-classifier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/plan/index.js

@@ -0,0 +1,7 @@
+export { isValidSnakeCase } from './types.js';
+export { writePartialConfig } from './config-writer.js';
+export { generateBriefTemplate } from './brief-template-generator.js';
+export { generatePlanAppSkill } from './skill-generator.js';
+export { runPlan } from './plan-orchestrator.js';
+export { classifyAppType } from './app-type-classifier.js';
+//# sourceMappingURL=index.js.map

package/dist/plan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/plan/skill-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAmF/D"}
+{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CA2Q/D"}

package/dist/plan/skill-generator.js

@@ -1,6 +1,7 @@
 export function generatePlanAppSkill(input) {
     const name = input?.name ?? 'your_app';
     const description = input?.description ?? 'A Flutter app';
+    const ticks = '```';
     return `---
 description: AI-guided planning for ${name}. Leads through vision, features, technical decisions, and PRD generation. Ask questions one at a time.
 model: claude-opus-4-6
@@ -67,18 +68,200 @@ Use this decision tree to guide module selection. Ask each sub-question only if
 
 ---
 
-## After Collecting Answers
+## Step 4: Module Suggestions
 
-Once you have answers to all questions, generate:
+Based on the app description and answers collected, suggest modules using this decision matrix.
 
-1. **Updated \`maxsim.config.yaml\`** with selected modules
-2. **\`prd.json\`** with user stories organized by phase
-3. **\`docs/architecture.md\`** with system design overview
+**Classify the app type** from the description, then apply the relevant row:
 
-Then tell the user:
-\`\`\`
-maxsim-flutter create --config maxsim.config.yaml
-\`\`\`
+| App Type | REQUIRED | RECOMMENDED | NICE-TO-HAVE |
+|---|---|---|---|
+| **team-collaboration** | auth, push, database | analytics, deep-linking | i18n, theme |
+| **e-commerce** | auth, database, api | push, analytics, deep-linking | theme, i18n |
+| **content-social** | auth, analytics, database | push, deep-linking | i18n, theme |
+| **utility-tool** | theme | i18n, analytics | — |
+| **fitness-health** | auth, database, push | analytics, theme | — |
+| **education** | auth, database, api | push, i18n | analytics |
+| **general** | auth, api | theme | — |
+
+**For each suggested module, explain the rationale** (why it is needed for this specific app):
+
+Example format:
+- \`auth\` ✅ REQUIRED — *Because ${name} needs user accounts to save personal data*
+- \`push\` ⭐ RECOMMENDED — *Because users benefit from timely notifications*
+- \`i18n\` 💡 NICE-TO-HAVE — *If you plan to target non-English markets in the future*
+
+Present the suggestions clearly, then ask:
+
+**Question 4.1** — Do these module suggestions match your vision, or would you add/remove anything?
+
+---
+
+## Step 5: Confirm Selections & Approve
+
+Summarize all decisions collected in Steps 1-4:
+
+**Summary of choices:**
+- App type: [detected type]
+- Platforms: [selected]
+- Auth: [yes/no, provider if yes]
+- Database: [local/cloud/none]
+- Modules: [final list with priorities]
+
+**Question 5.1** — Does this summary accurately reflect your app? Should we proceed with generating the config and PRD, or would you like to adjust anything?
+
+Once the user confirms and approves, proceed through Steps 6-9.
+
+---
+
+## Step 6: Generate project-brief.md
+
+Synthesize the conversation into a complete \`docs/project-brief.md\` file:
+
+${ticks}markdown
+# Project Brief — ${name}
+
+## Description
+${description}
+
+## Problem Statement
+[from Question 1.1]
+
+## Core User Journey
+[from Question 1.2]
+
+## Core Features (v1)
+[from Question 2.1]
+
+## Non-Goals (v1)
+[from Question 2.2]
+
+## Technical Decisions
+- Auth: [result]
+- Database: [result]
+- Platforms: [result]
+- Modules: [final list]
+${ticks}
+
+Write this file to: \`docs/project-brief.md\`
+
+---
+
+## Step 7: Generate architecture.md
+
+Create \`docs/architecture.md\` with provider tree and navigation flow ASCII diagrams.
+
+### Provider Tree (Riverpod ASCII Diagram)
+
+${ticks}
+AppProviders
+├── authStateProvider (StreamProvider)
+│   └── userProvider (derived)
+├── [featureNameProvider] (StateNotifierProvider)
+│   └── [featureNameState]
+└── routerProvider (go_router routing)
+${ticks}
+
+### Navigation Flow (go_router ASCII Diagram)
+
+${ticks}
+/ (root)
+├── /login
+├── /home
+│   ├── /home/[feature-1]
+│   └── /home/[feature-2]
+└── /settings
+${ticks}
+
+### Clean Architecture Layers
+
+For each enabled module, describe domain / data / presentation layers.
+
+### Database Schema (if database module enabled)
+
+Describe key data models and relationships.
+
+Write to: \`docs/architecture.md\`
+
+---
+
+## Step 8: Generate complete maxsim.config.yaml
+
+Using all decisions from Steps 1-5, generate a complete \`maxsim.config.yaml\`:
+
+${ticks}yaml
+project:
+  name: ${name}
+  description: >-
+    ${description}
+  orgId: com.example
+
+platforms:
+  - android
+  - ios
+
+modules:
+  auth:
+    enabled: true
+    provider: firebase
+  # ... other selected modules
+
+claude:
+  preset: standard
+${ticks}
+
+Write to: \`maxsim.config.yaml\` (overwrites the partial config).
+
+---
+
+## Step 9: Generate prd.json
+
+Create \`prd.json\` in v2 format. Derive user stories from the user journeys and core features.
+Organize stories across **4 phases**.
+
+${ticks}json
+{
+  "version": "2.0.0",
+  "project": "${name}",
+  "phases": [
+    { "phase": 1, "title": "Core Infrastructure", "description": "Auth, navigation, theme" },
+    { "phase": 2, "title": "Core Features", "description": "Primary user journey features" },
+    { "phase": 3, "title": "Secondary Features", "description": "Additional features" },
+    { "phase": 4, "title": "Polish & Optimization", "description": "Analytics, CI/CD, i18n" }
+  ],
+  "stories": [
+    {
+      "id": "S-001",
+      "phase": 1,
+      "priority": "P0",
+      "title": "...",
+      "description": "As a user, I want to...",
+      "storyPoints": 3,
+      "dependencies": [],
+      "acceptanceCriteria": [{ "description": "..." }],
+      "passes": false
+    }
+  ]
+}
+${ticks}
+
+Write to: \`prd.json\`
+
+---
+
+## Next Steps
+
+Once all artifacts are generated, tell the user:
+
+${ticks}
+✅ Planning complete! Your planning workspace is ready.
+
+Next steps:
+  1. Review docs/project-brief.md and docs/architecture.md
+  2. Run: maxsim-flutter create --config maxsim.config.yaml
+  3. Then: cd ${name} && claude
+  4. Start implementing stories from prd.json with Ralph
+${ticks}
 `;
 }
 //# sourceMappingURL=skill-generator.js.map

package/dist/plan/skill-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,UAAU,CAAC;IACvC,MAAM,WAAW,GAAG,KAAK,EAAE,WAAW,IAAI,eAAe,CAAC;IAE1D,OAAO;sCAC6B,IAAI;;;;gBAI1B,IAAI;;;;eAIL,IAAI;mBACA,WAAW;;;;;;;;;;kDAUoB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DrD,CAAC;AACF,CAAC"}
+{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,UAAU,CAAC;IACvC,MAAM,WAAW,GAAG,KAAK,EAAE,WAAW,IAAI,eAAe,CAAC;IAE1D,MAAM,KAAK,GAAG,KAAK,CAAC;IAEpB,OAAO;sCAC6B,IAAI;;;;gBAI1B,IAAI;;;;eAIL,IAAI;mBACA,WAAW;;;;;;;;;;kDAUoB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAiEnB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BrC,KAAK;oBACa,IAAI;;;EAGtB,WAAW;;;;;;;;;;;;;;;;;;;EAmBX,KAAK;;;;;;;;;;;;EAYL,KAAK;;;;;;;EAOL,KAAK;;;;EAIL,KAAK;;;;;;;EAOL,KAAK;;;;;;;;;;;;;;;;;;EAkBL,KAAK;;UAEG,IAAI;;MAER,WAAW;;;;;;;;;;;;;;;EAef,KAAK;;;;;;;;;;;EAWL,KAAK;;;gBAGS,IAAI;;;;;;;;;;;;;;;;;;;;;EAqBlB,KAAK;;;;;;;;;;EAUL,KAAK;;;;;;gBAMS,IAAI;;EAElB,KAAK;CACN,CAAC;AACF,CAAC"}

package/package.json

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