@mr.dj2u/cli 0.1.15 → 0.1.17

package/dist/project-memory.js

@@ -45,26 +45,22 @@ const DEFAULT_GUIDELINES_TEMPLATE_PATH = path.join(PACKAGE_ROOT, 'templates', 'p
 const STYLIST_SCREEN_TEMPLATE_PATH = path.join(PACKAGE_ROOT, 'templates', 'stylist-screen.template.tsx');
 const EMBEDDED_FONTS_TEMPLATE_PATH = path.join(PACKAGE_ROOT, 'templates', 'embedded-fonts.template.ts');
 const EXPO_SDK_56_SCREEN_UNIVERSAL_TEMPLATE_PATH = path.join(PACKAGE_ROOT, 'templates', 'expo-sdk-56-screen-universal.template.tsx');
-const CESS_SNAPSHOT_START = '<!-- MDS_CESS_SNAPSHOT_START -->';
-const CESS_SNAPSHOT_END = '<!-- MDS_CESS_SNAPSHOT_END -->';
 const INFO_HEADINGS = [
+    'App Name',
     'Overview',
     'Target Users',
+    'Problem this app solves',
     'Product Goals',
     'Non-Goals',
-    'Core Features',
-    'Core User Flows',
-    'Must-Include Screens Or Flows',
-    'Data And Backend',
+    'First User Flow',
+    'Core Flows and Features',
+    'Screens',
     'Platforms',
-    'Package Choices',
     'Monetization Strategy',
     'Team Context',
-    'Release Strategy',
-    'Questions To Revisit',
-    'Open Questions',
-    'Resources',
-    'Tech Stack & MDS Onboarding',
+    'Later Scope & Possibilities',
+    'Research, Notes, and References',
+    'Tech Stack & CESS Onboarding',
 ];
 const STYLE_HEADINGS = [
     'Visual Direction',
@@ -217,9 +213,15 @@ export async function scaffoldRichBoilerplate(projectPath, answers, force, optio
 export function renderInfo(projectPath, answers, existingInfo) {
     const importedNotes = renderImportedNotes(existingInfo, INFO_HEADINGS);
     const hasConcreteCoreFlows = !isGenericCoreFlowsText(answers.coreFlows);
+    const firstFlow = hasConcreteCoreFlows
+        ? extractFirstNonEmptyLine(answers.coreFlows)
+        : '# TodoForContext(optional): Describe the first real end-to-end user flow the MVP should support.';
     return [
         `# ${answers.appName} Project Info`,
         '',
+        '## App Name',
+        answers.appName,
+        '',
         '## Overview',
         '',
         `Build an Expo app for ${answers.audience}.`,
@@ -228,6 +230,9 @@ export function renderInfo(projectPath, answers, existingInfo) {
         '',
         answers.audience,
         '',
+        '## Problem this app solves',
+        '# TodoForContext(optional): Explain the user problem or pain this app exists to solve.',
+        '',
         '## Product Goals',
         '',
         '# TodoForContext(optional): Add the business/product outcomes that would make this app successful.',
@@ -236,49 +241,26 @@ export function renderInfo(projectPath, answers, existingInfo) {
         '',
         '# TodoForContext(optional): Add anything this app should intentionally avoid for the MVP.',
         '',
-        '## Core Features',
+        '## First User Flow',
         '',
-        hasConcreteCoreFlows
-            ? `Derived from the first planned flows: ${answers.coreFlows}`
-            : '# TodoForContext(optional): List the first core features the MVP should deliver.',
+        firstFlow,
         '',
-        '## Core User Flows',
+        '## Core Flows and Features',
         '',
         hasConcreteCoreFlows
             ? answers.coreFlows
-            : '# TodoForContext(optional): Describe the first real end-to-end user flow the MVP should support.',
+            : '# TodoForContext(optional): List the first core flows and features the MVP should deliver.',
         '',
-        '## Must-Include Screens Or Flows',
+        '## Screens',
         '',
         answers.screens?.trim()
             ? answers.screens
-            : '# TodoForContext(optional): List any known screens or flows that must be included in planning and implementation.',
-        '',
-        '## Data And Backend',
-        '',
-        answers.dataNeeds,
-        '',
-        `Starting mode: ${formatDataStart(answers.dataStart)}.`,
+            : '# TodoForContext(optional): List any known screens that must be included in planning and implementation.',
         '',
         '## Platforms',
         '',
         `- Target platforms: ${answers.targetPlatforms.join(', ') || 'none selected'}`,
         `- First MVP platform: ${answers.firstTargetPlatform}`,
-        `- Expo Router app directory: ${formatAppDirectory(answers.appDirectory)}`,
-        `- Platform-specific organization: ${formatPlatformStrategy(answers.platformFileStrategy)}`,
-        `- Platform layout mode: ${formatPlatformLayoutMode(answers.platformLayoutMode)}`,
-        `- Web output: ${answers.webOutput}`,
-        `- Deployed server: ${formatServerChoice(answers.deployedServer)}`,
-        `- Expo UI: ${formatBoolean(answers.usesExpoUi)}`,
-        `- Expo UI Universal components: ${formatBoolean(answers.usesExpoUiUniversalComponents)}`,
-        `- Expo Native Tabs: ${formatBoolean(answers.usesExpoNativeTabs)}`,
-        '',
-        '## Package Choices',
-        '',
-        answers.defaults.map((item) => `- ${item}`).join('\n'),
-        '',
-        '- Software Mansion core examples are included for Reanimated/Worklets, Gesture Handler, Screens, SVG, and Keyboard Controller.',
-        '- Prune package examples and dependencies after reviewing the exposition pages.',
         '',
         '## Monetization Strategy',
         '',
@@ -288,58 +270,50 @@ export function renderInfo(projectPath, answers, existingInfo) {
         '',
         '# TodoForContext(optional): Add team size, roles, delegated responsibilities, stakeholders, and client contacts if useful.',
         '',
-        '## Release Strategy',
+        '## Later Scope & Possibilities',
         '',
-        `- Deployment plan: ${answers.deploymentTarget}`,
-        `- EAS usage: ${answers.easUses.length > 0 ? answers.easUses.join(', ') : 'not planned yet'}`,
-        `- Test-to-main safeguards: ${formatBoolean(answers.testToMainSafeguards)}`,
+        '# TodoForContext(optional): Add future ideas or enhancements outside the first MVP.',
         '',
-        '## Questions To Revisit',
-        '',
-        '',
-        '## Resources',
+        '## Research, Notes, and References',
         '',
         `- Source project: ${projectPath}`,
         '- # TodoForContext(optional): Add designs, repos, docs, client notes, analytics, credentials process, or research links.',
         '',
         ...importedNotes,
         '',
-        '## Tech Stack & MDS Onboarding',
+        '# Tech Stack & CESS Onboarding',
         '',
-        '> Quick-reference stack summary for agents and collaborators. Fill in or correct any items marked below.',
+        `- TypeScript: ${formatYesNo(answers.generatorScriptLanguage !== 'javascript')}`,
+        `- Package Manager: ${answers.generatorPackageManager ?? 'npm'}`,
+        `- Navigation: ${formatGeneratorNavigation(answers.generatorNavigationLibrary)}`,
+        `- Type of Navigation: ${formatGeneratorNavigationType(answers.generatorReactNavigationLayout)}`,
+        `- Expo Router app directory: ${formatAppDirectory(answers.appDirectory)}`,
+        `- Platform-specific organization: ${formatPlatformStrategy(answers.platformFileStrategy)}`,
+        `- Platform layout mode: ${formatPlatformLayoutMode(answers.platformLayoutMode)}`,
+        `- Web output: ${answers.webOutput}`,
         '',
-        CESS_SNAPSHOT_START,
-        '```json',
-        JSON.stringify(buildCessSnapshot(answers), null, 2),
-        '```',
-        CESS_SNAPSHOT_END,
-        '',
-        `- **App:** ${answers.appName} — ${answers.audience}`,
-        `- **Language:** ${formatGeneratorLanguage(answers.generatorScriptLanguage)}`,
-        `- **Package manager:** ${formatGeneratorPackageManager(answers.generatorPackageManager)}`,
-        `- **Routing:** ${formatGeneratorRouting(answers)}`,
-        `- **Styling:** ${formatStyleStack(answers)}`,
-        `- **State management:** ${formatGeneratorStateManagement(answers.generatorStateManagement)}`,
-        `- **Auth:** ${formatAuthSummary(answers)}`,
-        `- **Data:** ${formatDataStart(answers.dataStart)}`,
-        `- **Platforms:** ${answers.targetPlatforms.join(', ') || 'none selected'}, first MVP target: ${answers.firstTargetPlatform}`,
-        `- **Code organization:** ${formatCodeOrg(answers)}`,
-        `- **Deployed server:** ${formatServerAdapterSummary(answers)}`,
-        `- **Distribution:** ${answers.deploymentTarget}`,
-        `- **EAS:** ${answers.easUses.length > 0 ? answers.easUses.join(', ') : 'not planned yet'}`,
-        '',
-        '### MDS Onboarding Decisions',
-        '',
-        `- Advanced package setup: ${formatBoolean(answers.advancedPackageSetup)}`,
-        `- Create Expo starter components: ${formatBoolean(answers.includeCreateExpoComponents)}`,
-        `- EAS starter selected during generation: ${formatBoolean(answers.generatorEasSetup ?? answers.easUses.length > 0)}`,
-        `- MDS guidelines template: yes`,
-        `- Expo UI: ${formatBoolean(answers.usesExpoUi)}`,
-        `- Expo UI Universal components: ${formatBoolean(answers.usesExpoUiUniversalComponents)}`,
-        `- Expo Native Tabs: ${formatBoolean(answers.usesExpoNativeTabs)}`,
-        `- Test-to-main safeguards: ${formatBoolean(answers.testToMainSafeguards)}`,
-        `- Data start: ${formatDataStart(answers.dataStart)}`,
-        `- Defaults selected: ${answers.defaults.join(', ')}`,
+        `- Style Library: ${formatCessStyleLibrary(answers)}`,
+        '- Which NativeWindUI components: All',
+        `- Components from create-expo-app: ${formatYesNo(answers.includeCreateExpoComponents)}`,
+        `- Expo UI: ${formatYesNo(answers.usesExpoUi)}`,
+        `- Expo UI Universal components: ${formatYesNo(answers.usesExpoUiUniversalComponents)}`,
+        `- Expo Native Tabs: ${formatYesNo(answers.usesExpoNativeTabs)}`,
+        '',
+        '- Which Software Mansion packages: All',
+        `- State management library: ${formatGeneratorStateManagement(answers.generatorStateManagement)}`,
+        `- Auth: ${formatGeneratorAuth(answers.generatorAuthBackend)}`,
+        `- Data Categories: ${answers.dataNeeds}`,
+        `- Starting Data mode: ${formatDataStart(answers.dataStart)}.`,
+        '',
+        '- Internationalization: None',
+        '- Analytics: None',
+        `- EAS: ${formatYesNo(answers.generatorEasSetup ?? answers.easUses.length > 0)}`,
+        `- EAS Usage: ${answers.easUses.length > 0 ? answers.easUses.join(', ') : 'not planned yet'}`,
+        `- Deployed server: ${formatServerChoice(answers.deployedServer)}`,
+        `- Initial Deployment plan: ${answers.deploymentTarget}`,
+        '',
+        `- Start with MDS project guidelines template: ${formatYesNo(true)}`,
+        `- Use test-to-main safeguards: ${formatYesNo(answers.testToMainSafeguards)}`,
         '',
     ].join('\n');
 }
@@ -354,6 +328,9 @@ export function renderTodo(answers) {
         '- [ ] Review `project/` files for accuracy and planning adjustments.',
         '- [ ] Run or defer `eject-stylist`; mark this todo done after ejection or deciding to defer (if you want to keep the stylist around for tinkering).',
         '- [ ] Run `mds eject exposition` and keep only the generated sections you want to retain.',
+        ...(answers.generatorEasSetup ?? answers.easUses.length > 0
+            ? ['- [ ] Sign in and set up EAS in the terminal.']
+            : []),
         '- [ ] Resolve every `# TodoForContext(optional):` marker in `project/info.md` by filling the section underneath or deleting the marker line to acknowledge no extra context is needed.',
         '- [ ] Confirm visual direction in `project/style.md` after using the Stylist page.',
         '- [ ] After the `project/info.md` markers are resolved, refresh the agent-derived roadmap from `project/info.md` and review it for accuracy.',
@@ -880,22 +857,6 @@ function formatServerChoice(value) {
 function formatDataStart(value) {
     return value === 'supabase' ? 'Supabase from the start' : 'local dummy data with Expo SQLite';
 }
-function formatServerAdapterSummary(answers) {
-    if (answers.webOutput === 'none')
-        return 'none (native-only)';
-    switch (answers.expoServerAdapter) {
-        case 'eas':
-            return 'EAS hosting';
-        case 'express':
-            return 'Express adapter (node server.js, port 3000)';
-        case 'bun':
-            return 'Bun adapter (node server.js)';
-        case 'other':
-            return 'custom (not yet specified)';
-        default:
-            return formatServerChoice(answers.deployedServer);
-    }
-}
 function deriveServeProdScript(answers) {
     if (answers.expoServerAdapter === 'express' || answers.expoServerAdapter === 'bun') {
         return 'node server.js';
@@ -908,105 +869,53 @@ function deriveServeProdFreshScript(answers) {
     }
     return `${MDS_NPX_COMMAND} free-port 8081 && npm run build:web && npx expo serve`;
 }
-function formatStyleStack(answers) {
-    if (answers.defaults.includes('uniwind')) {
-        return 'Uniwind / Tailwind CSS v4';
-    }
-    if (answers.defaults.includes('nativewindui')) {
-        return 'NativeWindUI / NativeWind';
+function extractFirstNonEmptyLine(value) {
+    return (value
+        .split(/\r?\n/u)
+        .map((line) => line.replace(/^[-*]\s+/u, '').trim())
+        .find(Boolean) ?? value.trim());
+}
+function formatYesNo(value) {
+    return value ? 'Yes' : 'No';
+}
+function formatGeneratorNavigation(value) {
+    return value === 'react-navigation' ? 'React Navigation' : 'Expo Router';
+}
+function formatGeneratorNavigationType(value) {
+    if (value === 'tabs') {
+        return 'Tabs';
     }
-    if (answers.defaults.includes('nativewind')) {
-        return 'NativeWind / Tailwind CSS';
+    if (value === 'drawer') {
+        return 'Drawer + Tabs';
     }
-    if (answers.defaults.includes('unistyles')) {
-        return 'Unistyles';
+    return 'Stack';
+}
+function formatCessStyleLibrary(answers) {
+    if (answers.generatorStylingSystem === 'nativewindui' || answers.defaults.includes('nativewindui')) {
+        return 'NativeWindUI';
     }
-    if (answers.defaults.includes('restyle')) {
-        return 'Shopify Restyle';
+    if (answers.generatorStylingSystem === 'nativewind' || answers.defaults.includes('nativewind')) {
+        return 'NativeWind';
     }
-    if (answers.defaults.includes('tamagui')) {
+    if (answers.generatorStylingSystem === 'tamagui' || answers.defaults.includes('tamagui')) {
         return 'Tamagui';
     }
-    return 'standard React Native StyleSheet';
-}
-function formatAuthSummary(answers) {
-    if (answers.dataStart === 'supabase' || answers.defaults.includes('supabase')) {
-        return 'Supabase auth (available via supabase-js)';
+    if (answers.generatorStylingSystem === 'restyle' || answers.defaults.includes('restyle')) {
+        return 'Restyle';
     }
-    return 'no auth planned yet';
-}
-function formatCodeOrg(answers) {
-    const parts = [
-        formatPlatformStrategy(answers.platformFileStrategy),
-        `${formatAppDirectory(answers.appDirectory)} routes`,
-        formatPlatformLayoutMode(answers.platformLayoutMode),
-    ];
-    if (answers.webOutput === 'none') {
-        parts.push('no web');
-    }
-    else {
-        parts.push(`web: ${answers.webOutput}`);
+    if (answers.generatorStylingSystem === 'stylesheet') {
+        return 'StyleSheet';
     }
-    return parts.join(', ');
+    return 'Uniwind';
 }
-function buildCessSnapshot(answers) {
-    return {
-        version: 1,
-        displayAppName: answers.appName,
-        folderSlug: toKebabCase(answers.appName),
-        answers: {
-            scriptLanguage: answers.generatorScriptLanguage,
-            packageManager: answers.generatorPackageManager,
-            navigationLibrary: answers.generatorNavigationLibrary,
-            reactNavigationLayout: answers.generatorReactNavigationLayout,
-            stylingSystem: answers.generatorStylingSystem,
-            stateManagement: answers.generatorStateManagement,
-            authBackend: answers.generatorAuthBackend,
-            easSetup: answers.generatorEasSetup,
-            displayAppName: answers.appName,
-            audience: answers.audience,
-            coreFlows: answers.coreFlows,
-            screens: answers.screens,
-            targetPlatforms: answers.targetPlatforms,
-            firstTargetPlatform: answers.firstTargetPlatform,
-            platformStrategy: answers.platformFileStrategy,
-            appDirectory: answers.appDirectory,
-            platformLayouts: answers.platformLayoutMode,
-            webOutput: answers.webOutput,
-            expoServerAdapter: answers.expoServerAdapter,
-            customBackend: answers.customBackend,
-            customBackendEntry: answers.customBackendEntry,
-            deploymentTarget: answers.deploymentTarget,
-            includeCreateExpoComponents: answers.includeCreateExpoComponents,
-            usesExpoUi: answers.usesExpoUi,
-            usesExpoUiUniversalComponents: answers.usesExpoUiUniversalComponents,
-            usesExpoNativeTabs: answers.usesExpoNativeTabs,
-            easUses: answers.easUses,
-            guidelinesTemplate: true,
-            dataStart: answers.dataStart,
-            testToMainSafeguards: answers.testToMainSafeguards,
-        },
-    };
-}
-function formatGeneratorLanguage(value) {
-    return value === 'javascript' ? 'JavaScript' : value === 'typescript' ? 'TypeScript' : '# TodoForContext(optional): TypeScript / JavaScript';
-}
-function formatGeneratorPackageManager(value) {
-    return value ?? '# TodoForContext(optional): pnpm / npm / yarn / bun';
-}
-function formatGeneratorRouting(answers) {
-    if (answers.generatorNavigationLibrary === 'react-navigation') {
-        const layout = answers.generatorReactNavigationLayout === 'tabs'
-            ? 'Tabs'
-            : answers.generatorReactNavigationLayout === 'drawer'
-                ? 'Drawer + Tabs'
-                : 'Stack';
-        return `React Navigation (${layout})`;
+function formatGeneratorAuth(value) {
+    if (value === 'supabase') {
+        return 'Supabase';
     }
-    if (answers.generatorNavigationLibrary === 'expo-router') {
-        return `Expo Router (${formatAppDirectory(answers.appDirectory)})`;
+    if (value === 'firebase') {
+        return 'Firebase';
     }
-    return `# TodoForContext(optional): Expo Router / React Navigation (${formatAppDirectory(answers.appDirectory)})`;
+    return 'None';
 }
 function formatGeneratorStateManagement(value) {
     if (value === 'zustand') {
@@ -1017,13 +926,6 @@ function formatGeneratorStateManagement(value) {
     }
     return '# TodoForContext(optional): Zustand / Jotai / React context / none';
 }
-function toKebabCase(value) {
-    return value
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/gu, '-')
-        .replace(/^-+|-+$/gu, '') || 'expo-app';
-}
 function hasThinOnboardingAnswers(answers) {
     const genericValues = new Set([
         'Expo app users',