@auto-engineer/narrative 0.11.11 → 0.11.13

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.13",
+    "@auto-engineer/id": "0.11.13",
+    "@auto-engineer/message-bus": "0.11.13"
   },
   "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.13"
   },
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.11.11",
+  "version": "0.11.13",
   "scripts": {
     "build": "tsx scripts/build.ts",
     "test": "vitest run --reporter=dot",

package/src/commands/export-schema-helper.ts

@@ -12,7 +12,6 @@ const main = async () => {
   debug('Starting export-schema-helper with directory: %s', directory);
 
   try {
-    // Import getFlows from the project's node_modules to ensure we use the same module context
     const getFileStore = getFs as () => Promise<IExtendedFileStore>;
     const fs: IExtendedFileStore = await getFileStore();
     const projectNarrativePath = fs.join(
@@ -24,7 +23,7 @@ const main = async () => {
       'src',
       'getNarratives.js',
     );
-    debug('Importing getFlows from: %s', projectNarrativePath);
+    debug('Importing getNarratives from: %s', projectNarrativePath);
 
     const { pathToFileURL } = await import('url');
     const narrativeModule = (await import(pathToFileURL(projectNarrativePath).href)) as {

package/src/{getFlows.cache.specs.ts → getNarratives.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;
@@ -19,7 +19,7 @@ describe('getNarratives', (_mode) => {
     root = path.resolve(__dirname);
   });
   // eslint-disable-next-line complexity
-  it('loads multiple flows and generates correct models', async () => {
+  it('loads multiple narratives and generates correct models', async () => {
     const flows = await getNarratives({ vfs, root: path.resolve(__dirname), pattern, fastFsScan: true });
     const schemas = flows.toModel();
 
@@ -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');
@@ -191,8 +191,8 @@ describe('getNarratives', (_mode) => {
     expect(Array.isArray(parsed.integrations)).toBe(true);
   });
 
-  it('should handle flows with integrations', async () => {
-    const flows = await getNarratives({ vfs: vfs, root: root, pattern: /\.(flow)\.(ts)$/, fastFsScan: true });
+  it('should handle narratives with integrations', async () => {
+    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);
@@ -267,8 +267,8 @@ describe('getNarratives', (_mode) => {
     ).toBe(true);
   });
 
-  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 });
+  it('should have ids for narratives and slices that have ids', async () => {
+    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();
@@ -638,31 +640,27 @@ flow('questionnaires-test', () => {
     }
   });
 
-  it('does not emit empty generics for empty when()', async () => {
+  it('does not emit empty generics or empty when clauses', async () => {
     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();
     const code = await modelToNarrative(model);
 
-    // Should not produce `.when<>({})` for empty when-clauses
     expect(code).not.toMatch(/\.when<>\(\{\}\)/);
-
-    // should render empty whens as `.when({})` for empty when-clauses
-    const emptyWhenCount = (code.match(/\.when\(\{}\)/g) ?? []).length;
-    expect(emptyWhenCount).toBeGreaterThanOrEqual(2);
     expect(code).not.toMatch(/\.when<\s*\{\s*}\s*>\(\{}\)/);
+    expect(code).not.toMatch(/\.when\(\{}\)/);
   });
 
   it('should not generate phantom messages with empty names', async () => {
     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 +767,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();
@@ -925,17 +923,7 @@ function validateMixedGivenTypes(example: Example): void {
 }
 
 function validateEmptyWhenClause(example: Example): void {
-  expect(example.when).toBeDefined();
-  expect(typeof example.when === 'object' && !Array.isArray(example.when)).toBe(true);
-  if (typeof example.when === 'object' && !Array.isArray(example.when)) {
-    expect('commandRef' in example.when).toBe(false);
-    expect('eventRef' in example.when).toBe(true);
-    expect('stateRef' in example.when).toBe(false);
-    if ('eventRef' in example.when) {
-      expect(example.when.eventRef).toBe('');
-    }
-    expect(example.when.exampleData).toEqual({});
-  }
+  expect(example.when).toBeUndefined();
 }
 
 function validateThenClause(example: Example): void {
@@ -971,7 +959,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);