@auto-engineer/narrative 0.19.1 → 0.21.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @auto-engineer/narrative@0.19.1 build /home/runner/work/auto-engineer/auto-engineer/packages/narrative
+> @auto-engineer/narrative@0.21.0 build /Users/sam/code/auto/2/auto-engineer-2/packages/narrative
 > tsx scripts/build.ts
 
 Running: tsc

package/.turbo/turbo-format.log

@@ -0,0 +1,4 @@
+
+> @auto-engineer/narrative@0.11.16 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

@@ -0,0 +1,4 @@
+
+> @auto-engineer/narrative@0.11.16 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

@@ -0,0 +1,14 @@
+
+> @auto-engineer/narrative@0.21.0 test /Users/sam/code/auto/2/auto-engineer-2/packages/narrative
+> vitest run --reporter=dot
+
+
+ RUN  v3.2.4 /Users/sam/code/auto/2/auto-engineer-2/packages/narrative
+
+············································································································································································································
+
+ Test Files  14 passed (14)
+      Tests  204 passed (204)
+   Start at  18:49:24
+   Duration  3.39s (transform 4.21s, setup 0ms, collect 11.92s, tests 2.33s, environment 1ms, prepare 3.08s)
+

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

@@ -0,0 +1,5 @@
+
+
+> @auto-engineer/narrative@0.21.0 type-check /Users/sam/code/auto/2/auto-engineer-2/packages/narrative
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -1,15 +1,26 @@
 # @auto-engineer/flow
 
-## 0.19.1
+## 0.21.0
+
+### Minor Changes
+
+- Unifies ports on cli
 
 ### Patch Changes
 
-- add optional id field to DataSink and DataSource
+- Updated dependencies []:
+  - @auto-engineer/message-bus@0.21.0
+  - @auto-engineer/file-store@0.21.0
+  - @auto-engineer/id@0.21.0
+
+## 0.20.0
+
+### Patch Changes
 
 - Updated dependencies []:
-  - @auto-engineer/file-store@0.19.1
-  - @auto-engineer/id@0.19.1
-  - @auto-engineer/message-bus@0.19.1
+  - @auto-engineer/file-store@0.20.0
+  - @auto-engineer/id@0.20.0
+  - @auto-engineer/message-bus@0.20.0
 
 ## 0.19.0
 
@@ -931,7 +942,6 @@
 ### Patch Changes
 
 - [`988ab04`](https://github.com/SamHatoum/auto-engineer/commit/988ab04530d41e116df9196434c0e57ff2ee11a8) Thanks [@SamHatoum](https://github.com/SamHatoum)! - Fix export:schema command and add comprehensive debug logging
-
   - Fixed export-schema command to use npx tsx for TypeScript support
   - Added proper JSON extraction from stdout to handle integration logs
   - Resolved issue where export:schema produced empty schemas despite valid flow definitions

package/dist/src/commands/export-schema-runner.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=export-schema-runner.d.ts.map

package/dist/src/commands/export-schema-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-schema-runner.d.ts","sourceRoot":"","sources":["../../../src/commands/export-schema-runner.ts"],"names":[],"mappings":""}

package/dist/src/commands/export-schema-runner.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// This runner is executed in the target directory context to avoid module resolution issues
+import { resolve } from 'path';
+import { writeFileSync, mkdirSync } from 'fs';
+import createDebug from 'debug';
+import { NodeFileStore } from '@auto-engineer/file-store';
+const debug = createDebug('auto:narrative:export-schema-runner');
+if ('color' in debug && typeof debug === 'object') {
+    debug.color = '4';
+} // blue
+const main = async () => {
+    const contextDir = process.argv[2] || './.context';
+    const narrativesDir = process.argv[3] || './narratives';
+    debug('Starting export-schema-runner');
+    debug('  Context dir: %s', contextDir);
+    debug('  Flows dir: %s', narrativesDir);
+    try {
+        // Import from the installed package in the target directory
+        // This ensures we use the same module instance as the flow files
+        const narrative = await import('@auto-engineer/narrative');
+        const { getNarratives } = narrative;
+        if (typeof getNarratives !== 'function') {
+            throw new Error('getNarratives not found in @auto-engineer/narrative exports');
+        }
+        const narrativesPath = resolve(process.cwd(), narrativesDir);
+        debug('Resolved narratives path: %s', narrativesPath);
+        const result = await getNarratives({ vfs: new NodeFileStore(), root: narrativesPath });
+        const schema = result.toModel();
+        debug('Schema generated with %d narratives, %d messages, %d integrations', schema.narratives.length, schema.messages.length, schema.integrations?.length ?? 0);
+        const json = JSON.stringify(schema, null, 2);
+        const resolvedContextDir = resolve(process.cwd(), contextDir);
+        const outPath = resolve(resolvedContextDir, 'schema.json');
+        mkdirSync(resolvedContextDir, { recursive: true });
+        writeFileSync(outPath, json);
+        debug('Schema written to: %s', outPath);
+        // Output success as JSON for parent process
+        console.log(JSON.stringify({
+            success: true,
+            outputPath: outPath,
+        }));
+    }
+    catch (error) {
+        debug('Error occurred: %o', error);
+        // Output error as JSON for parent process
+        console.log(JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error occurred',
+        }));
+        process.exit(1);
+    }
+};
+void main();
+//# sourceMappingURL=export-schema-runner.js.map

package/dist/src/commands/export-schema-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-schema-runner.js","sourceRoot":"","sources":["../../../src/commands/export-schema-runner.ts"],"names":[],"mappings":"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"}

package/dist/src/fluent-builder.specs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fluent-builder.specs.d.ts.map

package/dist/src/fluent-builder.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluent-builder.specs.d.ts","sourceRoot":"","sources":["../../src/fluent-builder.specs.ts"],"names":[],"mappings":""}

package/dist/src/fluent-builder.specs.js

@@ -0,0 +1,28 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { command, react } from './fluent-builder.js';
+import { createIntegration } from './types.js';
+import { startNarrative, clearCurrentNarrative } from './narrative-context.js';
+// Test integrations
+const MailChimp = createIntegration('mailchimp', 'MailChimp');
+const Twilio = createIntegration('twilio', 'Twilio');
+describe('via method', () => {
+    beforeEach(() => {
+        startNarrative('test-flow');
+    });
+    afterEach(() => {
+        clearCurrentNarrative();
+    });
+    it('should accept a single integration', () => {
+        const slice = command('test').via(MailChimp);
+        expect(slice).toBeDefined();
+    });
+    it('should accept multiple integrations as array', () => {
+        const slice = command('test').via([MailChimp, Twilio]);
+        expect(slice).toBeDefined();
+    });
+    it('should work with react', () => {
+        const slice = react('test').via([MailChimp, Twilio]);
+        expect(slice).toBeDefined();
+    });
+});
+//# sourceMappingURL=fluent-builder.specs.js.map

package/dist/src/fluent-builder.specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluent-builder.specs.js","sourceRoot":"","sources":["../../src/fluent-builder.specs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,oBAAoB;AACpB,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAC9D,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAErD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,UAAU,CAAC,GAAG,EAAE;QACd,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,qBAAqB,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7C,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAEvD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAErD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/getNarratives.cache.specs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getNarratives.cache.specs.d.ts.map

package/dist/src/getNarratives.cache.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNarratives.cache.specs.d.ts","sourceRoot":"","sources":["../../src/getNarratives.cache.specs.ts"],"names":[],"mappings":""}

package/dist/src/getNarratives.cache.specs.js

@@ -0,0 +1,234 @@
+import { describe, expect, it, beforeEach } from 'vitest';
+import { getNarratives, clearGetNarrativesCache } from './getNarratives.js';
+import { InMemoryFileStore } from '@auto-engineer/file-store';
+import * as flowApi from './narrative.js';
+import * as fluent from './fluent-builder.js';
+import * as dataBuilders from './data-narrative-builders.js';
+import * as typesApi from './types.js';
+import gql from 'graphql-tag';
+const importMap = {
+    '../flow': flowApi,
+    '../fluent-builder': fluent,
+    '../data-flow-builders': dataBuilders,
+    '../types': typesApi,
+    'graphql-tag': { default: gql, gql },
+};
+const pattern = /\.(narrative)\.(ts)$/;
+describe('getNarratives caching', () => {
+    let vfs;
+    const root = '/test';
+    beforeEach(() => {
+        vfs = new InMemoryFileStore();
+        clearGetNarrativesCache();
+    });
+    it('should rebuild cache when a helper file is modified', async () => {
+        const helperContent1 = `
+      export function formatName(name: string): string {
+        return name.toUpperCase();
+      }
+    `;
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      import { formatName } from './helper.js';
+      
+      narrative('TestFlow', () => {
+        const name = formatName('test');
+      });
+    `;
+        await vfs.write('/test/helper.ts', new TextEncoder().encode(helperContent1));
+        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(',');
+        const helperContent2 = `
+      export function formatName(name: string): string {
+        return name.toLowerCase(); // Changed implementation
+      }
+    `;
+        await vfs.write('/test/helper.ts', new TextEncoder().encode(helperContent2));
+        const secondCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
+        const hash2 = secondCallResult.vfsFiles.sort().join(',');
+        expect(hash1).toBe(hash2);
+        expect(secondCallResult.narratives).toBeDefined();
+    });
+    it('should rebuild cache when import map changes', async () => {
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      
+      narrative('TestFlow', () => {
+        const x = 1;
+      });
+    `;
+        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 });
+        const importMap2 = { 'test-module': { default: 'value2' } };
+        const result2 = await getNarratives({ vfs, root, importMap: importMap2, pattern, fastFsScan: true });
+        expect(result1.narratives.length).toBe(result2.narratives.length);
+    });
+    it('should rebuild cache when a new dependency is added', async () => {
+        const helperContent1 = `
+      export function getValue(): string {
+        return 'direct';
+      }
+    `;
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      import { getValue } from './helper.js';
+      
+      narrative('TestFlow', () => {
+        const val = getValue();
+      });
+    `;
+        await vfs.write('/test/helper.ts', new TextEncoder().encode(helperContent1));
+        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;
+        const transitiveContent = `
+      export function transitiveHelper(): string {
+        return 'transitive';
+      }
+    `;
+        const helperContent2 = `
+      import { transitiveHelper } from './transitive.js';
+      
+      export function getValue(): string {
+        return transitiveHelper();
+      }
+    `;
+        await vfs.write('/test/transitive.ts', new TextEncoder().encode(transitiveContent));
+        await vfs.write('/test/helper.ts', new TextEncoder().encode(helperContent2));
+        const secondCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
+        const filesCount2 = secondCallResult.vfsFiles.length;
+        expect(filesCount2).toBeGreaterThan(filesCount1);
+        expect(secondCallResult.vfsFiles.some((f) => f.includes('transitive'))).toBe(true);
+    });
+    it('should not rebuild cache when an unrelated file is touched', async () => {
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      
+      narrative('TestFlow', () => {
+        const x = 1;
+      });
+    `;
+        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 });
+        await vfs.write('/test/unrelated.txt', new TextEncoder().encode('modified content'));
+        const secondCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
+        expect(secondCallResult.vfsFiles.some((f) => f.includes('unrelated.txt'))).toBe(false);
+        expect(firstCallResult.vfsFiles).toEqual(secondCallResult.vfsFiles);
+    });
+    it('should rebuild cache when a file is deleted from the graph', async () => {
+        const flowContent1 = `
+      import { narrative } from '../narrative.js';
+      
+      narrative('TestFlow1', () => {
+        const x = 1;
+      });
+    `;
+        const flowContent2 = `
+      import { narrative } from '../narrative.js';
+      
+      narrative('TestFlow2', () => {
+        const x = 2;
+      });
+    `;
+        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.narrative.ts');
+        const secondCallResult = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
+        expect(secondCallResult.narratives.length).toBeLessThan(firstCallResult.narratives.length);
+        expect(secondCallResult.vfsFiles.length).toBeLessThan(firstCallResult.vfsFiles.length);
+    });
+    it('should rebuild cache when a file is renamed', async () => {
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      
+      narrative('TestFlow', () => {
+        const x = 1;
+      });
+    `;
+        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.narrative.ts'))).toBe(true);
+        const content = await vfs.read('/test/test.narrative.ts');
+        if (content) {
+            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.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 () => {
+        const dtsContent = `
+      declare module 'custom-module' {
+        export function customFunc(): string;
+      }
+    `;
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      
+      narrative('TestFlow', () => {
+        const x: string = 'test';
+      });
+    `;
+        await vfs.write('/test/types.d.ts', new TextEncoder().encode(dtsContent));
+        await vfs.write('/test/test.narrative.ts', new TextEncoder().encode(flowContent));
+        const result = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
+        expect(result.vfsFiles.some((f) => f.endsWith('.d.ts'))).toBe(false);
+    });
+    it('should rebuild when import map keys change even with same values', async () => {
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      
+      narrative('TestFlow', () => {
+        const x = 1;
+      });
+    `;
+        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 });
+        const importMap2 = { 'module-c': 'value', 'module-d': 'value' };
+        const result2 = await getNarratives({ vfs, root, importMap: importMap2, pattern, fastFsScan: true });
+        expect(result1.narratives).toEqual(result2.narratives); // Same flows
+    });
+    it('should handle complex transitive dependency chains', async () => {
+        const chain3Content = `
+      export const DEEP_VALUE = 'deep';
+    `;
+        const chain2Content = `
+      import { DEEP_VALUE } from './chain3.js';
+      export const MID_VALUE = DEEP_VALUE + '-mid';
+    `;
+        const chain1Content = `
+      import { MID_VALUE } from './chain2.js';
+      export const TOP_VALUE = MID_VALUE + '-top';
+    `;
+        const flowContent = `
+      import { narrative } from '../narrative.js';
+      import { TOP_VALUE } from './chain1.js';
+      
+      narrative('TestFlow', () => {
+        const val = TOP_VALUE;
+      });
+    `;
+        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.narrative.ts', new TextEncoder().encode(flowContent));
+        const result1 = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
+        expect(result1.vfsFiles.some((f) => f.includes('chain1'))).toBe(true);
+        expect(result1.vfsFiles.some((f) => f.includes('chain2'))).toBe(true);
+        expect(result1.vfsFiles.some((f) => f.includes('chain3'))).toBe(true);
+        const modifiedChain3Content = `
+      export const DEEP_VALUE = 'modified-deep';
+    `;
+        await vfs.write('/test/chain3.ts', new TextEncoder().encode(modifiedChain3Content));
+        const result2 = await getNarratives({ vfs, root, pattern, fastFsScan: true, importMap });
+        expect(result2.vfsFiles.length).toBe(result1.vfsFiles.length);
+    });
+});
+//# sourceMappingURL=getNarratives.cache.specs.js.map

package/dist/src/getNarratives.cache.specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNarratives.cache.specs.js","sourceRoot":"","sources":["../../src/getNarratives.cache.specs.ts"],"names":[],"mappings":"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"}

package/dist/src/getNarratives.specs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getNarratives.specs.d.ts.map

package/dist/src/getNarratives.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNarratives.specs.d.ts","sourceRoot":"","sources":["../../src/getNarratives.specs.ts"],"names":[],"mappings":""}