@auto-engineer/narrative 0.11.11 → 0.11.12

package/package.json

@@ -19,9 +19,9 @@
     "typescript": "^5.9.2",
     "zod": "^3.22.4",
     "zod-to-json-schema": "^3.22.3",
-    "@auto-engineer/file-store": "0.11.11",
-    "@auto-engineer/id": "0.11.11",
-    "@auto-engineer/message-bus": "0.11.11"
+    "@auto-engineer/file-store": "0.11.12",
+    "@auto-engineer/id": "0.11.12",
+    "@auto-engineer/message-bus": "0.11.12"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -29,12 +29,12 @@
     "eslint-plugin-sort-keys-fix": "^1.1.2",
     "fake-indexeddb": "^6.0.0",
     "tsx": "^4.20.3",
-    "@auto-engineer/cli": "0.11.11"
+    "@auto-engineer/cli": "0.11.12"
   },
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.11.11",
+  "version": "0.11.12",
   "scripts": {
     "build": "tsx scripts/build.ts",
     "test": "vitest run --reporter=dot",

package/src/getFlows.cache.specs.ts

@@ -15,7 +15,7 @@ const importMap = {
   'graphql-tag': { default: gql, gql },
 };
 
-const pattern = /\.(flow)\.(ts)$/;
+const pattern = /\.(narrative)\.(ts)$/;
 
 describe('getNarratives caching', () => {
   let vfs: IFileStore;
@@ -42,7 +42,7 @@ describe('getNarratives caching', () => {
     `;
 
     await vfs.write('/test/helper.ts', new TextEncoder().encode(helperContent1));
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const firstCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
     const hash1 = firstCallResult.vfsFiles.sort().join(',');
@@ -69,7 +69,7 @@ describe('getNarratives caching', () => {
         const x = 1;
       });
     `;
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const importMap1 = { 'test-module': { default: 'value1' } };
     const result1 = await getNarratives({ vfs, root, importMap: importMap1, pattern, fastFsScan: true });
@@ -96,7 +96,7 @@ describe('getNarratives caching', () => {
     `;
 
     await vfs.write('/test/helper.ts', new TextEncoder().encode(helperContent1));
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const firstCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
     const filesCount1 = firstCallResult.vfsFiles.length;
@@ -133,7 +133,7 @@ describe('getNarratives caching', () => {
       });
     `;
 
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
     await vfs.write('/test/unrelated.txt', new TextEncoder().encode('initial content'));
 
     const firstCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
@@ -162,13 +162,13 @@ describe('getNarratives caching', () => {
       });
     `;
 
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent1));
-    await vfs.write('/test/test2.flow.ts', new TextEncoder().encode(flowContent2));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent1));
+    await vfs.write('/test/test2.narrative.ts', new TextEncoder().encode(flowContent2));
 
     const firstCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
     expect(firstCallResult.narratives.length).toBeGreaterThanOrEqual(2);
 
-    await vfs.remove('/test/test2.flow.ts');
+    await vfs.remove('/test/test2.narrative.ts');
 
     const secondCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
 
@@ -185,21 +185,21 @@ describe('getNarratives caching', () => {
       });
     `;
 
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const firstCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
-    expect(firstCallResult.vfsFiles.some((f) => f.includes('test.flow.ts'))).toBe(true);
+    expect(firstCallResult.vfsFiles.some((f) => f.includes('test.narrative.ts'))).toBe(true);
 
-    const content = await vfs.read('/test/test.flow.ts');
+    const content = await vfs.read('/test/test.narrative.ts');
     if (content) {
-      await vfs.write('/test/renamed.flow.ts', content);
-      await vfs.remove('/test/test.flow.ts');
+      await vfs.write('/test/renamed.narrative.ts', content);
+      await vfs.remove('/test/test.narrative.ts');
     }
 
     const secondCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true });
 
-    expect(secondCallResult.vfsFiles.some((f) => f.includes('renamed.flow.ts'))).toBe(true);
-    expect(secondCallResult.vfsFiles.some((f) => f.includes('test.flow.ts'))).toBe(false);
+    expect(secondCallResult.vfsFiles.some((f) => f.includes('renamed.narrative.ts'))).toBe(true);
+    expect(secondCallResult.vfsFiles.some((f) => f.includes('test.narrative.ts'))).toBe(false);
   });
 
   it('should handle .d.ts files if they affect the graph', async () => {
@@ -217,7 +217,7 @@ describe('getNarratives caching', () => {
     `;
 
     await vfs.write('/test/types.d.ts', new TextEncoder().encode(dtsContent));
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const result = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
 
@@ -233,7 +233,7 @@ describe('getNarratives caching', () => {
       });
     `;
 
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const importMap1 = { 'module-a': 'value', 'module-b': 'value' };
     const result1 = await getNarratives({ vfs, root, importMap: importMap1, pattern, fastFsScan: true });
@@ -268,7 +268,7 @@ describe('getNarratives caching', () => {
     await vfs.write('/test/chain3.ts', new TextEncoder().encode(chain3Content));
     await vfs.write('/test/chain2.ts', new TextEncoder().encode(chain2Content));
     await vfs.write('/test/chain1.ts', new TextEncoder().encode(chain1Content));
-    await vfs.write('/test/test.flow.ts', new TextEncoder().encode(flowContent));
+    await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const result1 = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
 

package/src/{getFlows.specs.ts → getNarratives.specs.ts}

@@ -8,7 +8,7 @@ import { getNarratives } from './getNarratives';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-const pattern = /\.(flow)\.(ts)$/;
+const pattern = /\.(narrative)\.(ts)$/;
 
 describe('getNarratives', (_mode) => {
   let vfs: NodeFileStore;
@@ -182,7 +182,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('validates the complete schema with Zod', async () => {
-    const flows = await getNarratives({ vfs: vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
     const schemas = flows.toModel();
     const parsed = modelSchema.parse(schemas);
     expect(parsed.variant).toBe('specs');
@@ -192,7 +192,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('should handle flows with integrations', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
     const specsSchema = flows.toModel();
 
     const flowsWithIntegrations = specsSchema.narratives.filter((f) =>
@@ -216,7 +216,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('should handle react slices correctly', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
     const specsSchema = flows.toModel();
 
     const reactSlices = specsSchema.narratives.flatMap((f) => f.slices.filter((s) => s.type === 'react'));
@@ -241,7 +241,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('should parse and validate a complete flow with all slice types', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
     const schemas = flows.toModel();
 
     const validationResult = modelSchema.safeParse(schemas);
@@ -268,7 +268,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('should have ids for flows and slices that have ids', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
 
     const schemas = flows.toModel();
 
@@ -286,7 +286,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('should have ids for command slice rules', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
     const schemas = flows.toModel();
 
     const testFlowWithIds = schemas.narratives.find((f) => f.name === 'Test Flow with IDs');
@@ -309,7 +309,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('should have ids for query slice rules', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
     const schemas = flows.toModel();
 
     const testFlowWithIds = schemas.narratives.find((f) => f.name === 'Test Flow with IDs');
@@ -327,7 +327,7 @@ describe('getNarratives', (_mode) => {
   });
 
   it('should have ids for react slice rules', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true });
     const schemas = flows.toModel();
 
     const testFlowWithIds = schemas.narratives.find((f) => f.name === 'Test Flow with IDs');
@@ -348,7 +348,7 @@ describe('getNarratives', (_mode) => {
     const flows = await getNarratives({
       vfs,
       root,
-      pattern: /(?:^|\/)questionnaires\.flow\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
+      pattern: /(?:^|\/)questionnaires\.narrative\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
     });
     const model = flows.toModel();
 
@@ -379,7 +379,7 @@ describe('getNarratives', (_mode) => {
     const flows = await getNarratives({
       vfs,
       root,
-      pattern: /(?:^|\/)questionnaires\.flow\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
+      pattern: /(?:^|\/)questionnaires\.narrative\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
       fastFsScan: true,
     });
     const model = flows.toModel();
@@ -401,7 +401,7 @@ flow('Test Experience Flow', () => {
 });
       `;
 
-    await memoryVfs.write('/test/experience.flow.ts', new TextEncoder().encode(flowWithExperienceContent));
+    await memoryVfs.write('/test/experience.narrative.ts', new TextEncoder().encode(flowWithExperienceContent));
 
     const flows = await getNarratives({ vfs: memoryVfs, root: '/test', pattern, fastFsScan: true });
     const model = flows.toModel();
@@ -444,14 +444,14 @@ flow('Browser Test Flow', () => {
 });
       `;
 
-    await memoryVfs.write('/browser/test.flow.ts', new TextEncoder().encode(flowContent));
+    await memoryVfs.write('/browser/test.narrative.ts', new TextEncoder().encode(flowContent));
 
     const { executeAST } = await import('./loader');
     const { registry } = await import('./narrative-registry');
 
     registry.clearAll();
 
-    await executeAST(['/browser/test.flow.ts'], memoryVfs, {}, '/browser');
+    await executeAST(['/browser/test.narrative.ts'], memoryVfs, {}, '/browser');
 
     const flows = registry.getAllNarratives();
     expect(flows).toHaveLength(1);
@@ -484,11 +484,13 @@ flow('Questionnaires', 'AUTO-Q9m2Kp4Lx', () => {
 });
       `;
 
-    await memoryVfs.write('/browser/questionnaires.flow.ts', new TextEncoder().encode(flowContent));
+    await memoryVfs.write('/browser/questionnaires.narrative.ts', new TextEncoder().encode(flowContent));
 
     registry.clearAll();
 
-    await expect(executeAST(['/browser/questionnaires.flow.ts'], memoryVfs, {}, '/browser')).resolves.toBeDefined();
+    await expect(
+      executeAST(['/browser/questionnaires.narrative.ts'], memoryVfs, {}, '/browser'),
+    ).resolves.toBeDefined();
 
     const flows = registry.getAllNarratives();
     expect(flows).toHaveLength(1);
@@ -598,7 +600,7 @@ flow('questionnaires-test', () => {
 });
     `;
 
-    await memoryVfs.write('/test/questionnaires.flow.ts', new TextEncoder().encode(questionnaireFlowContent));
+    await memoryVfs.write('/test/questionnaires.narrative.ts', new TextEncoder().encode(questionnaireFlowContent));
 
     const flows = await getNarratives({ vfs: memoryVfs, root: '/test', pattern, fastFsScan: true });
     const model = flows.toModel();
@@ -642,7 +644,7 @@ flow('questionnaires-test', () => {
     const flows = await getNarratives({
       vfs,
       root,
-      pattern: /(?:^|\/)questionnaires\.flow\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
+      pattern: /(?:^|\/)questionnaires\.narrative\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
       fastFsScan: true,
     });
 
@@ -662,7 +664,7 @@ flow('questionnaires-test', () => {
     const flows = await getNarratives({
       vfs,
       root: root,
-      pattern: /(?:^|\/)questionnaires\.flow\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
+      pattern: /(?:^|\/)questionnaires\.narrative\.(?:ts|tsx|js|jsx|mjs|cjs)$/,
       fastFsScan: true,
     });
     const model = flows.toModel();
@@ -769,7 +771,7 @@ flow('Todo List', () => {
 });
     `;
 
-    await memoryVfs.write('/test/todo-summary.flow.ts', new TextEncoder().encode(todoSummaryFlowContent));
+    await memoryVfs.write('/test/todo-summary.narrative.ts', new TextEncoder().encode(todoSummaryFlowContent));
 
     const flows = await getNarratives({ vfs: memoryVfs, root: '/test', pattern, fastFsScan: true });
     const model = flows.toModel();
@@ -971,7 +973,7 @@ function validateMixedGivenTypeMessages(model: Model): void {
 async function createQuestionnaireBugTestModel(): Promise<Model> {
   const memoryVfs = new InMemoryFileStore();
   const questionnaireFlowContent = getQuestionnaireFlowContent();
-  await memoryVfs.write('/test/questionnaires-bug.flow.ts', new TextEncoder().encode(questionnaireFlowContent));
+  await memoryVfs.write('/test/questionnaires-bug.narrative.ts', new TextEncoder().encode(questionnaireFlowContent));
   const flows = await getNarratives({ vfs: memoryVfs, root: '/test', pattern, fastFsScan: true });
   return flows.toModel();
 }

package/src/id/addAutoIds.specs.ts

@@ -220,7 +220,7 @@ describe('addAutoIds', () => {
       narratives: [
         {
           name: 'Home Screen',
-          sourceFile: '/path/to/homepage.flow.ts',
+          sourceFile: '/path/to/homepage.narrative.ts',
           slices: [
             {
               name: 'Active Surveys Summary',
@@ -236,7 +236,7 @@ describe('addAutoIds', () => {
         },
         {
           name: 'Create Survey',
-          sourceFile: '/path/to/homepage.flow.ts',
+          sourceFile: '/path/to/homepage.narrative.ts',
           slices: [
             {
               name: 'Create Survey Form',
@@ -252,7 +252,7 @@ describe('addAutoIds', () => {
         },
         {
           name: 'Response Analytics',
-          sourceFile: '/path/to/homepage.flow.ts',
+          sourceFile: '/path/to/homepage.narrative.ts',
           slices: [
             {
               name: 'Response Rate Charts',
@@ -289,8 +289,8 @@ describe('addAutoIds', () => {
     expect(result.narratives[0].slices[0].id).not.toBe(result.narratives[2].slices[0].id);
     expect(result.narratives[1].slices[0].id).not.toBe(result.narratives[2].slices[0].id);
 
-    expect(result.narratives[0].sourceFile).toBe('/path/to/homepage.flow.ts');
-    expect(result.narratives[1].sourceFile).toBe('/path/to/homepage.flow.ts');
-    expect(result.narratives[2].sourceFile).toBe('/path/to/homepage.flow.ts');
+    expect(result.narratives[0].sourceFile).toBe('/path/to/homepage.narrative.ts');
+    expect(result.narratives[1].sourceFile).toBe('/path/to/homepage.narrative.ts');
+    expect(result.narratives[2].sourceFile).toBe('/path/to/homepage.narrative.ts');
   });
 });

package/src/id/hasAllIds.specs.ts

@@ -146,14 +146,14 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
     const flowContent3 = new TextEncoder().encode(multipleFlowsSameSource);
     const flowContent4 = new TextEncoder().encode(multipleFlowsIncomplete);
     const flowContent5 = new TextEncoder().encode(multipleFlowsSliceMissing);
-    await vfs.write('/test/flow-without-ids.flow.ts', flowContent1);
-    await vfs.write('/test/flow-with-ids.flow.ts', flowContent2);
-    await vfs.write('/test/homepage.flow.ts', flowContent3);
-    await vfs.write('/test/homepage-incomplete.flow.ts', flowContent4);
-    await vfs.write('/test/homepage-slice-missing.flow.ts', flowContent5);
+    await vfs.write('/test/flow-without-ids.narrative.ts', flowContent1);
+    await vfs.write('/test/flow-with-ids.narrative.ts', flowContent2);
+    await vfs.write('/test/homepage.narrative.ts', flowContent3);
+    await vfs.write('/test/homepage-incomplete.narrative.ts', flowContent4);
+    await vfs.write('/test/homepage-slice-missing.narrative.ts', flowContent5);
   });
   it('should return false for models without IDs', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const flowWithoutIds = model.narratives.find((f) => f.name === 'Test Flow Without IDs');
@@ -166,7 +166,7 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
   });
 
   it('should return true for models with complete IDs', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const modelWithIds = addAutoIds(model);
@@ -174,7 +174,7 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
   });
 
   it('should return true for flows that already have IDs', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const testFlowWithIds = model.narratives.find((f) => f.name === 'Test Flow with IDs');
@@ -187,7 +187,7 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
   });
 
   it('should return false if any slice is missing an ID', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const modelWithIds = addAutoIds(model);
@@ -200,7 +200,7 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
   });
 
   it('should return false if any rule is missing an ID', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const modelWithIds = addAutoIds(model);
@@ -227,11 +227,11 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
   });
 
   it('should return true when multiple flows with same sourceFile all have IDs', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const homepageFlows = model.narratives.filter(
-      (f) => f.sourceFile !== undefined && f.sourceFile.includes('homepage.flow.ts'),
+      (f) => f.sourceFile !== undefined && f.sourceFile.includes('homepage.narrative.ts'),
     );
     expect(homepageFlows.length).toBe(3);
 
@@ -240,11 +240,11 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
   });
 
   it('should return false when any flow in multiple flows with same sourceFile is missing ID', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const homepageFlows = model.narratives.filter(
-      (f) => f.sourceFile !== undefined && f.sourceFile.includes('homepage-incomplete.flow.ts'),
+      (f) => f.sourceFile !== undefined && f.sourceFile.includes('homepage-incomplete.narrative.ts'),
     );
     expect(homepageFlows.length).toBe(3);
 
@@ -253,11 +253,11 @@ flow('Response Analytics', 'AUTO-eME978Euk', () => {
   });
 
   it('should return false when any slice in multiple flows with same sourceFile is missing ID', async () => {
-    const result = await getNarratives({ vfs, root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true, importMap });
+    const result = await getNarratives({ vfs, root, pattern: /\.(narrative)\.(ts)$/, fastFsScan: true, importMap });
     const model = result.toModel();
 
     const homepageFlows = model.narratives.filter(
-      (f) => f.sourceFile !== undefined && f.sourceFile.includes('homepage-slice-missing.flow.ts'),
+      (f) => f.sourceFile !== undefined && f.sourceFile.includes('homepage-slice-missing.narrative.ts'),
     );
     expect(homepageFlows.length).toBe(3);
 

package/src/model-to-flow.specs.ts

@@ -1739,7 +1739,7 @@ narrative('Date Handling Flow', 'DATE-FLOW', () => {
       narratives: [
         {
           name: 'Home Screen',
-          sourceFile: '/path/to/homepage.flow.ts',
+          sourceFile: '/path/to/homepage.narrative.ts',
           slices: [
             {
               name: 'Active Surveys Summary',
@@ -1756,7 +1756,7 @@ narrative('Date Handling Flow', 'DATE-FLOW', () => {
         },
         {
           name: 'Create Survey',
-          sourceFile: '/path/to/homepage.flow.ts',
+          sourceFile: '/path/to/homepage.narrative.ts',
           slices: [
             {
               name: 'Create Survey Form',
@@ -1773,7 +1773,7 @@ narrative('Date Handling Flow', 'DATE-FLOW', () => {
         },
         {
           name: 'Response Analytics',
-          sourceFile: '/path/to/homepage.flow.ts',
+          sourceFile: '/path/to/homepage.narrative.ts',
           slices: [
             {
               name: 'Response Rate Charts',

package/src/samples/{place-order.flow.ts → place-order.narrative.ts}

@@ -11,7 +11,7 @@ export interface OrderPlaced {
   };
 }
 
-export interface PlaceOrderFlow {
+export interface PlaceOrderNarrative {
   type: 'PlaceOrder';
   data: {
     productId: string;
@@ -41,7 +41,7 @@ flow('Place order', () => {
       specs('User submits a new order', () => {
         rule('Valid orders should be processed successfully', () => {
           example('User places order for available product')
-            .when<PlaceOrderFlow>({
+            .when<PlaceOrderNarrative>({
               productId: 'product_789',
               quantity: 3,
             })

package/src/samples/seasonal-assistant.schema.json

@@ -452,7 +452,7 @@
           }
         }
       ],
-      "sourceFile": "/Users/ramihatoum/WebstormProjects/xolvio/auto-engineer/examples/shopping-app/flows/shopping-assistant.flow.ts"
+      "sourceFile": "/Users/ramihatoum/WebstormProjects/xolvio/auto-engineer/examples/shopping-app/flows/shopping-assistant.narrative.ts"
     }
   ],
   "messages": [

package/.turbo/turbo-format.log

@@ -1,4 +0,0 @@
-
-> @auto-engineer/narrative@0.11.10 format /Users/sam/WebstormProjects/top/auto-engineer-2/packages/narrative
-> prettier --write "**/*.{js,ts,json,md,yml,yaml}" --ignore-path ../../.prettierignore --log-level warn
-

package/.turbo/turbo-lint.log

@@ -1,4 +0,0 @@
-
-> @auto-engineer/narrative@0.11.10 lint /Users/sam/WebstormProjects/top/auto-engineer-2/packages/narrative
-> eslint '{src,scripts}/**/*.ts' --max-warnings 0 --config ./eslint.config.ts
-

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @auto-engineer/narrative@0.11.10 test /Users/sam/WebstormProjects/top/auto-engineer-2/packages/narrative
-> vitest run --reporter=dot
-
-
- RUN  v3.2.4 /Users/sam/WebstormProjects/top/auto-engineer-2/packages/narrative
-
-·································································
-
- Test Files  8 passed (8)
-      Tests  65 passed (65)
-   Start at  15:23:05
-   Duration  2.32s (transform 1.53s, setup 0ms, collect 5.01s, tests 2.45s, environment 1ms, prepare 1.30s)
-

package/.turbo/turbo-type-check.log

@@ -1,4 +0,0 @@
-
-> @auto-engineer/narrative@0.11.10 type-check /Users/sam/WebstormProjects/top/auto-engineer-2/packages/narrative
-> tsc --noEmit
-

package/dist/src/data-flow-builders.d.ts

@@ -1,71 +0,0 @@
-import type { DataSinkItem, DataSourceItem, MessageTarget, Integration } from './types';
-export interface ChainableSinkMethods {
-    additionalInstructions(instructions: string): ChainableSink;
-    withState(source: DataSourceItem | ChainableSource): ChainableSink;
-}
-export interface ChainableSourceMethods {
-    additionalInstructions(instructions: string): ChainableSource;
-}
-export type ChainableSink = DataSinkItem & ChainableSinkMethods;
-export type ChainableSource = DataSourceItem & ChainableSourceMethods;
-export interface FieldSelector {
-    [key: string]: boolean | FieldSelector;
-}
-declare abstract class MessageTargetBuilder<TResult> {
-    protected target: Partial<MessageTarget>;
-    protected instructions?: string;
-    fields(selector: FieldSelector): this;
-    additionalInstructions(instructions: string): this;
-    abstract build(): TResult;
-}
-export declare class EventSinkBuilder extends MessageTargetBuilder<DataSinkItem> {
-    constructor(name: string);
-    toStream(pattern: string): ChainableSink;
-    toIntegration(...systems: Integration[]): ChainableSink;
-    toDatabase(collection: string): ChainableSink;
-    toTopic(name: string): ChainableSink;
-    build(): DataSinkItem;
-}
-export declare class CommandSinkBuilder extends MessageTargetBuilder<DataSinkItem> {
-    private stateSource?;
-    constructor(name: string);
-    withState(source: DataSourceItem | ChainableSource): this;
-    toIntegration(system: Integration | string, messageName: string, messageType: 'command' | 'query' | 'reaction'): ChainableSink;
-    hints(hint: string): ChainableSink;
-    toDatabase(collection: string): ChainableSink;
-    toTopic(name: string): ChainableSink;
-    build(): DataSinkItem;
-}
-export declare class StateSinkBuilder extends MessageTargetBuilder<DataSinkItem> {
-    constructor(name: string);
-    toDatabase(collection: string): ChainableSink;
-    toStream(pattern: string): ChainableSink;
-    build(): DataSinkItem;
-}
-export declare class StateSourceBuilder extends MessageTargetBuilder<DataSourceItem> {
-    constructor(name: string);
-    fromProjection(name: string, idField: string): ChainableSource;
-    fromReadModel(name: string): ChainableSource;
-    fromDatabase(collection: string, query?: Record<string, unknown>): ChainableSource;
-    fromApi(endpoint: string, method?: string): ChainableSource;
-    fromIntegration(...systems: (Integration | string)[]): ChainableSource;
-    build(): DataSourceItem;
-}
-interface BuilderResult {
-    type: string;
-    __messageCategory: 'event' | 'command' | 'state';
-}
-export declare class DataSinkBuilder {
-    event(nameOrBuilder: string | BuilderResult): EventSinkBuilder;
-    command(nameOrBuilder: string | BuilderResult): CommandSinkBuilder;
-    state(nameOrBuilder: string | BuilderResult): StateSinkBuilder;
-}
-export declare class DataSourceBuilder {
-    state(nameOrBuilder: string | BuilderResult): StateSourceBuilder;
-}
-export declare const sink: () => DataSinkBuilder;
-export declare const source: () => DataSourceBuilder;
-export declare function typedSink(builderResult: BuilderResult): EventSinkBuilder | CommandSinkBuilder | StateSinkBuilder;
-export declare function typedSource(builderResult: BuilderResult): StateSourceBuilder;
-export {};
-//# sourceMappingURL=data-flow-builders.d.ts.map

package/dist/src/data-flow-builders.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"data-flow-builders.d.ts","sourceRoot":"","sources":["../../src/data-flow-builders.ts"],"names":[],"mappings":"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"}