create-auto-app 0.9.11 → 0.9.13

package/templates/finance-app/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - '*'

package/templates/finance-app/tsconfig.base.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "skipLibCheck": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "noEmit": false,
+    "strict": true,
+    "strictNullChecks": true
+  },
+  "include": ["flows/**/*", "vitest.config.ts"],
+  "exclude": ["dist", "node_modules"]
+}

package/templates/finance-app/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "skipLibCheck": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "noEmit": false,
+    "strict": true,
+    "strictNullChecks": true
+  },
+  "include": ["flows/**/*", "vitest.config.ts"],
+  "exclude": ["dist", "node_modules"]
+}

package/templates/finance-app/turbo.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "extends": ["//"],
+  "tasks": {
+    "auto": {
+      "dependsOn": ["^build"],
+      "inputs": []
+    },
+    "auto:debug": {
+      "dependsOn": ["^build"],
+      "inputs": []
+    },
+    "build": {
+      "dependsOn": ["^build"],
+      "inputs": [],
+      "outputs": []
+    }
+  }
+}

package/templates/questionnaires/auto.config.ts

@@ -0,0 +1,158 @@
+import { autoConfig, on, dispatch } from '@auto-engineer/cli';
+import type { ExportSchemaCommand, ExportSchemaEvents } from '@auto-engineer/flow';
+import type { GenerateServerCommand, GenerateServerEvents } from '@auto-engineer/server-generator-apollo-emmett';
+import type { ImplementServerCommand, ImplementServerEvents } from '@auto-engineer/server-implementer';
+import type {
+  CheckTestsCommand,
+  CheckTestsEvents,
+  CheckTypesCommand,
+  CheckTypesEvents,
+  CheckLintCommand,
+  CheckLintEvents,
+  TestsCheckFailedEvent,
+} from '@auto-engineer/server-checks';
+import type { GenerateIACommand, GenerateIAEvents } from '@auto-engineer/information-architect';
+import type { ImplementClientCommand, ImplementClientEvents } from '@auto-engineer/frontend-implementer';
+import type { GenerateClientCommand, GenerateClientEvents } from '@auto-engineer/frontend-generator-react-graphql';
+
+export default autoConfig({
+  fileId: 'test2222', // unique 9-character base62 canvas file id where all flows in this project will be shown
+
+  plugins: [
+    '@auto-engineer/server-checks',
+    '@auto-engineer/design-system-importer',
+    '@auto-engineer/server-generator-apollo-emmett',
+    '@auto-engineer/flow',
+    '@auto-engineer/frontend-checks',
+    '@auto-engineer/frontend-implementer',
+    '@auto-engineer/information-architect',
+    '@auto-engineer/frontend-generator-react-graphql',
+    '@auto-engineer/server-implementer',
+  ],
+  aliases: {
+    // Resolve command name conflicts between packages
+    // 'test:types': checkTypesCommandHandler,
+  },
+  pipeline: () => {
+    on<ExportSchemaEvents>('SchemaExported', () =>
+      dispatch<GenerateServerCommand>('GenerateServer', {
+        schemaPath: './.context/schema.json',
+        destination: '.',
+      }),
+    );
+
+    on<GenerateServerEvents>('ServerGenerated', () =>
+      dispatch<GenerateIACommand>('GenerateIA', {
+        outputDir: './.context',
+        flowFiles: ['./flows/questionnaires.flow.ts'],
+      }),
+    );
+
+    on<GenerateIAEvents>('IAGenerated', () =>
+      dispatch<GenerateClientCommand>('GenerateClient', {
+        starterDir: '../../packages/frontend-generator-react-graphql/shadcn-starter',
+        targetDir: './client',
+        iaSchemaPath: './.context/auto-ia-scheme.json',
+        gqlSchemaPath: './.context/schema.graphql',
+        figmaVariablesPath: './.context/figma-variables.json',
+      }),
+    );
+
+    on<GenerateClientEvents>('ClientGenerated', () =>
+      dispatch<ImplementClientCommand>('ImplementClient', {
+        projectDir: './client',
+        iaSchemeDir: './.context',
+        designSystemPath: './.context/design-system.md',
+      }),
+    );
+
+    on<ImplementServerEvents>('SliceImplemented', () => {
+      dispatch<CheckTestsCommand>('CheckTests', {
+        targetDirectory: 'sds',
+        scope: 'slice',
+      });
+    });
+
+    on<ImplementServerEvents>('SliceImplemented', () => {
+      dispatch<CheckTypesCommand>('CheckTypes', {
+        targetDirectory: 'sds',
+        scope: 'slice',
+      });
+    });
+
+    on<ImplementServerEvents>('SliceImplemented', () => {
+      dispatch<CheckLintCommand>('CheckLint', {
+        targetDirectory: 'sds',
+        scope: 'slice',
+        fix: true,
+      });
+    });
+
+    on.settled<CheckTestsCommand, CheckTypesCommand, CheckLintCommand>(
+      ['CheckTests', 'CheckTypes', 'CheckLint'],
+      dispatch<ImplementClientCommand>(['ImplementClient'], (events, send) => {
+        const hasFailures =
+          events.CheckTests.some((e: CheckTestsEvents) => e.type === 'TestsCheckFailed') ||
+          events.CheckTypes.some((e: CheckTypesEvents) => e.type === 'TypeCheckFailed') ||
+          events.CheckLint.some((e: CheckLintEvents) => e.type === 'LintCheckFailed');
+
+        if (hasFailures) {
+          send({
+            type: 'ImplementClient',
+            data: {
+              projectDir: 'some/where',
+              iaSchemeDir: '/',
+              designSystemPath: '',
+              failures: [],
+            },
+          });
+        }
+      }),
+    );
+  },
+});
+/*
+
+rm -rf server client .context/schema.json .context/schema.graphql .context/auto-ia-scheme.json 
+pnpm auto export:schema
+pnpm auto generate:ia --output-dir=./.context --flow-files=./flows/questionnaires.flow.ts
+pnpm auto generate:server --schema-path=./.context/schema.json --destination=.
+pnpm auto generate:client --starter-dir=../../packages/frontend-generator-react-graphql/shadcn-starter --target-dir=./client  --ia-schema-path=./.context/auto-ia-scheme.json  --gql-schema-path=./.context/schema.graphql  --figma-variables-path=./.context/figma-variables.json
+pnpm auto implement:client --project-dir=./questionnaires/client --ia-scheme-dir=./questionnaires/.context --design-system-path=./questionnaires/.context/design-system.md
+
+
+// make this emit one slice at a time
+pnpm auto generate:server --schema-path=./.context/schema.json --destination=.
+
+// TODO remove the AI part and make it mathematical
+pnpm auto generate:client --starter-dir=/Users/sam/WebstormProjects/top/auto-engineer/packages/frontend-generator-react-graphql/shadcn-starter  --target-dir=./client  --ia-schema-path=./.context/auto-ia-scheme.json  --gql-schema-path=./.context/schema.graphql  --figma-variables-path=./.context/figma-variables.json
+
+// run this per slice in parallel
+pnpm auto implement:slice --slice-path=./questionnaires/server/src/domain/flows/questionnaires/submits-the-questionnaire
+// add checks
+// add retry logic tore-implement failed slices with a retry count
+
+// slice these up
+pnpm auto implement:client --project-dir=./questionnaires/client --ia-scheme-dir=./questionnaires/.context --design-system-path=./questionnaires/.context/design-system.md
+
+
+// implement atoms in parallel - how do I know all atoms are done?
+// implement molecules in parallel - how do I know all molecules are done?
+// implement organisms in parallel - how do I know all organisms are done?
+// implement pages in parallel - how do I know all pages are done?
+
+
+// generate slice > implement slice > check slice > retry failure 3 times > 
+// generate slice > implement slice > check slice > retry failure 3 times > 
+// generate slice > implement slice > check slice > retry failure 3 times > 
+
+cd ~/WebstormProjects/top/auto-engineer/examples/questionnaires &&\
+pnpm -w build &&\
+rm -rf server client .context/schema.json .context/schema.graphql .context/auto-ia-scheme.json &&\
+DEBUG=* pnpm auto export:schema &&\
+DEBUG=* pnpm auto generate:server --schema-path=./.context/schema.json --destination=. &&\
+DEBUG=* pnpm auto generate:ia --output-dir=./.context --flow-files=./flows/questionnaires.flow.ts &&\
+DEBUG=* pnpm auto generate:client --starter-dir=../../packages/frontend-generator-react-graphql/shadcn-starter --target-dir=./client  --ia-schema-path=./.context/auto-ia-scheme.json  --gql-schema-path=./.context/schema.graphql  --figma-variables-path=./.context/figma-variables.json
+
+
+*/

package/templates/questionnaires/flows/questionnaires.flow.ts

@@ -0,0 +1,359 @@
+import {
+  command,
+  query,
+  experience,
+  flow,
+  should,
+  specs,
+  rule,
+  example,
+  gql,
+  source,
+  data,
+  sink,
+  type Command,
+  type Event,
+  type State,
+} from '@auto-engineer/flow';
+
+type QuestionnaireLinkSent = Event<
+  'QuestionnaireLinkSent',
+  {
+    questionnaireId: string;
+    participantId: string;
+    link: string;
+    sentAt: Date;
+  }
+>;
+
+type QuestionAnswered = Event<
+  'QuestionAnswered',
+  {
+    questionnaireId: string;
+    participantId: string;
+    questionId: string;
+    answer: unknown;
+    savedAt: Date;
+  }
+>;
+
+type QuestionnaireSubmitted = Event<
+  'QuestionnaireSubmitted',
+  {
+    questionnaireId: string;
+    participantId: string;
+    submittedAt: Date;
+  }
+>;
+
+type QuestionnaireEditRejected = Event<
+  'QuestionnaireEditRejected',
+  {
+    questionnaireId: string;
+    participantId: string;
+    reason: string;
+    attemptedAt: Date;
+  }
+>;
+
+type AnswerQuestion = Command<
+  'AnswerQuestion',
+  {
+    questionnaireId: string;
+    participantId: string;
+    questionId: string;
+    answer: unknown;
+  }
+>;
+
+type SubmitQuestionnaire = Command<
+  'SubmitQuestionnaire',
+  {
+    questionnaireId: string;
+    participantId: string;
+  }
+>;
+
+type QuestionnaireConfig = State<
+  'QuestionnaireConfig',
+  {
+    questionnaireId: string;
+    numberOfQuestions: number;
+  }
+>;
+
+type QuestionnaireProgress = State<
+  'QuestionnaireProgress',
+  {
+    questionnaireId: string;
+    participantId: string;
+    status: 'in_progress' | 'ready_to_submit' | 'submitted';
+    currentQuestionId: string | null;
+    remainingQuestions: string[];
+    answers: { questionId: string; value: unknown }[];
+  }
+>;
+
+flow('Questionnaires', 'AUTO-Q9m2Kp4Lx', () => {
+  experience('Homepage', 'AUTO-H1a4Bn6Cy').client(() => {
+    specs(() => {
+      should('show a hero section with a welcome message');
+      should('allow user to start the questionnaire');
+    });
+  });
+
+  query('views the questionnaire', 'AUTO-V7n8Rq5M')
+    .server(() => {
+      specs(() => {
+        rule('questionnaires show current progress', 'AUTO-r1A3Bp9W', () => {
+          example('a question has already been answered')
+            .given<QuestionnaireLinkSent>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              link: 'https://app.example.com/q/q-001?participant=participant-abc',
+              sentAt: new Date('2030-01-01T09:00:00Z'),
+            })
+            .when<QuestionAnswered>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              questionId: 'q1',
+              answer: 'Yes',
+              savedAt: new Date('2030-01-01T09:05:00Z'),
+            })
+            .then<QuestionnaireProgress>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              status: 'in_progress',
+              currentQuestionId: 'q2',
+              remainingQuestions: ['q2', 'q3'],
+              answers: [{ questionId: 'q1', value: 'Yes' }],
+            });
+          example('no questions have been answered yet')
+            .given<QuestionnaireLinkSent>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              link: 'https://app.example.com/q/q-001?participant=participant-abc',
+              sentAt: new Date('2030-01-01T09:00:00Z'),
+            })
+            .when({})
+            .then<QuestionnaireProgress>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              status: 'in_progress',
+              currentQuestionId: 'q1',
+              remainingQuestions: ['q1', 'q2', 'q3'],
+              answers: [],
+            });
+        });
+      });
+      data([source().state('QuestionnaireProgress').fromProjection('Questionnaires', 'questionnaire-participantId')]);
+    })
+    .request(gql`
+      query QuestionnaireProgress($participantId: ID!) {
+        questionnaireProgress(participantId: $participantId) {
+          questionnaireId
+          participantId
+          currentQuestionId
+          remainingQuestions
+          status
+          answers {
+            questionId
+            value
+          }
+        }
+      }
+    `)
+    .client(() => {
+      specs('Questionnaire Progress', () => {
+        should('focus on the current question based on the progress state');
+        should('display the list of answered questions');
+        should('display the list of remaining questions');
+        should('show a progress indicator that is always visible as the user scrolls');
+      });
+    });
+
+  command('submits a questionnaire answer', 'AUTO-S4j6Nt8Z')
+    .server(() => {
+      specs(() => {
+        rule('answers are allowed while the questionnaire has not been submitted', 'AUTO-r2D5Eq0Y', () => {
+          example('no questions have been answered yet')
+            .when<AnswerQuestion>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              questionId: 'q1',
+              answer: 'Yes',
+            })
+            .then<QuestionAnswered>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              questionId: 'q1',
+              answer: 'Yes',
+              savedAt: new Date('2030-01-01T09:05:00Z'),
+            });
+
+          example('all questions have already been answered and submitted')
+            .given<QuestionnaireSubmitted>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              submittedAt: new Date('2030-01-01T09:00:00Z'),
+            })
+            .when<AnswerQuestion>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              questionId: 'q1',
+              answer: 'Yes',
+            })
+            .then<QuestionnaireEditRejected>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              reason: 'Questionnaire already submitted',
+              attemptedAt: new Date('2030-01-01T09:05:00Z'),
+            });
+        });
+      });
+      data([
+        sink().event('QuestionAnswered').toStream('questionnaire-participantId'),
+        sink().event('QuestionnaireEditRejected').toStream('questionnaire-participantId'),
+      ]);
+    })
+    .request(gql`
+      mutation AnswerQuestion($input: AnswerQuestionInput!) {
+        answerQuestion(input: $input) {
+          success
+        }
+      }
+    `)
+    .client(() => {
+      specs('Submissions', () => {
+        should('displays a success message when the answer is submitted');
+        should('display an error message when the answer submission is rejected');
+      });
+    });
+
+  query('questionnaire ready for submission', 'AUTO-R3f7Hu1X')
+    .server(() => {
+      specs(() => {
+        rule('questionnaire is ready for submission when all questions are answered', 'AUTO-r3G8Iv2W', () => {
+          example('all questions have been answered')
+            .given<QuestionnaireConfig>({
+              questionnaireId: 'q-001',
+              numberOfQuestions: 2,
+            })
+            .and<QuestionnaireLinkSent>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              link: 'https://app.example.com/q/q-001?participant=participant-abc',
+              sentAt: new Date('2030-01-01T09:00:00Z'),
+            })
+            .and<QuestionAnswered>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              questionId: 'q1',
+              answer: 'Yes',
+              savedAt: new Date('2030-01-01T09:05:00Z'),
+            })
+            .and<QuestionAnswered>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              questionId: 'q2',
+              answer: 'No',
+              savedAt: new Date('2030-01-01T09:05:00Z'),
+            })
+            .when({}) // FIX ME
+            .then<QuestionnaireProgress>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              status: 'ready_to_submit',
+              currentQuestionId: null,
+              remainingQuestions: [],
+              answers: [
+                { questionId: 'q1', value: 'Yes' },
+                { questionId: 'q2', value: 'No' },
+              ],
+            });
+          example('some questions are still unanswered')
+            .given<QuestionnaireLinkSent>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              link: 'https://app.example.com/q/q-001?participant=participant-abc',
+              sentAt: new Date('2030-01-01T09:00:00Z'),
+            })
+            .when<QuestionAnswered>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              questionId: 'q1',
+              answer: 'Yes',
+              savedAt: new Date('2030-01-01T09:05:00Z'),
+            })
+            .then<QuestionnaireProgress>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              status: 'in_progress',
+              currentQuestionId: 'q2',
+              remainingQuestions: ['q2', 'q3'],
+              answers: [{ questionId: 'q1', value: 'Yes' }],
+            });
+        });
+      });
+      data([
+        source().state('QuestionnaireProgress').fromProjection('Questionnaires', 'questionnaire-participantId'),
+        source().state('QuestionnaireConfig').fromDatabase('QuestionnaireConfigAPI'),
+      ]);
+    })
+    .request(gql`
+      query QuestionnaireProgress($participantId: ID!) {
+        questionnaireProgress(participantId: $participantId) {
+          questionnaireId
+          participantId
+          status
+          currentQuestionId
+          remainingQuestions
+          answers {
+            questionId
+            value
+          }
+        }
+      }
+    `)
+    .client(() => {
+      specs('Submission Readiness', () => {
+        should('enable the submit button when all questions are answered');
+        should('disable the submit button when all questions have not been answered');
+      });
+    });
+
+  command('submits the questionnaire', 'AUTO-T5k9Jw3V')
+    .server(() => {
+      specs(() => {
+        rule('questionnaire allowed to be submitted when all questions are answered', 'AUTO-r4H0Lx4U', () => {
+          example('submits the questionnaire successfully')
+            .when<SubmitQuestionnaire>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+            })
+            .then<QuestionnaireSubmitted>({
+              questionnaireId: 'q-001',
+              participantId: 'participant-abc',
+              submittedAt: new Date('2030-01-01T09:00:00Z'),
+            });
+        });
+      });
+      data([sink().event('QuestionnaireSubmitted').toStream('questionnaire-participantId')]);
+    })
+    .request(gql`
+      mutation SubmitQuestionnaire($input: SubmitQuestionnaireInput!) {
+        submitQuestionnaire(input: $input) {
+          success
+        }
+      }
+    `)
+    .client(() => {
+      specs('Submission Confirmation', () => {
+        should('display a confirmation message upon successful submission');
+      });
+    });
+});
+
+// notifications are updated
+// they are taken back home
+// homepage status shows "Pre-Registration Complete"

package/templates/questionnaires/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "questionnaires",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "auto": "node ../../packages/cli/dist/bin/auto.js",
+    "auto:debug": "DEBUG=flow:*,cli:*,auto*,ai*,-*file-syncer,-*flow* node ../../packages/cli/dist/bin/auto.js",
+    "start": "dotenv -e .env -- pnpm --parallel start"
+  },
+  "dependencies": {
+    "@auto-engineer/cli": "workspace:*",
+    "@auto-engineer/design-system-importer": "workspace:*",
+    "@auto-engineer/flow": "workspace:*",
+    "@auto-engineer/frontend-checks": "workspace:*",
+    "@auto-engineer/frontend-generator-react-graphql": "workspace:*",
+    "@auto-engineer/frontend-implementer": "workspace:*",
+    "@auto-engineer/information-architect": "workspace:*",
+    "@auto-engineer/message-bus": "workspace:*",
+    "@auto-engineer/server-checks": "workspace:*",
+    "@auto-engineer/server-generator-apollo-emmett": "workspace:*",
+    "@auto-engineer/server-implementer": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.1",
+    "chokidar": "^3.6.0",
+    "dotenv": "^16.4.5",
+    "dotenv-cli": "^9.0.0",
+    "tsx": "^3.12.7"
+  }
+}

package/templates/questionnaires/template.json

@@ -0,0 +1,7 @@
+{
+  "name": "questionnaires",
+  "displayName": "Questionnaires App",
+  "description": "Collect user input through a series of questions",
+  "type": "template",
+  "preset": "full"
+}

package/templates/questionnaires/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "skipLibCheck": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "outDir": "./dist",
+    "noEmit": false,
+    "strictNullChecks": true
+  },
+  "include": ["**/*", "vitest.config.ts"],
+  "exclude": ["dist", "node_modules"]
+}

package/templates/shopping-app/auto.config.ts

@@ -32,6 +32,8 @@ import {
 import { type GenerateClientCommand } from '@auto-engineer/frontend-generator-react-graphql';
 
 export default autoConfig({
+  fileId: 'test11111',
+
   plugins: [
     '@auto-engineer/server-checks',
     '@auto-engineer/design-system-importer',

package/templates/shopping-app/template.json

@@ -0,0 +1,7 @@
+{
+  "name": "shopping-assistant",
+  "displayName": "AI Shopping Assistant",
+  "description": "Suggest items from product catalog based on a prompt",
+  "type": "template",
+  "preset": "full"
+}