@pennyfarthing/core 10.1.0 → 10.2.0

package/packages/core/dist/workflow/file-watch.test.js

@@ -0,0 +1,469 @@
+/**
+ * Tests for Story 95-4: File-watch Observation Scope
+ *
+ * RED state tests for file change detection in the backseat agent.
+ * These tests cover all acceptance criteria:
+ *
+ * AC1: Detect file create events in working tree
+ * AC2: Detect file modify events in working tree
+ * AC3: Detect file delete events in working tree
+ * AC4: Detection within 5 seconds (poll interval ≤ 2s)
+ * AC5: Non-blocking — functions return promptly, polling is async
+ * AC6: Writes observations with file-watch trigger type via ObservationWriter
+ * AC7: Context accumulation — tracks seen files, avoids redundant observations
+ * AC8: Ignores non-source directories (.pennyfarthing/, .session/, node_modules/)
+ * AC9: Error resilience — continues observing if a single write fails
+ * AC10: Returns result objects ({success, error?}) per framework pattern
+ *
+ * Run with: npm test
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { mkdirSync, rmSync, existsSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Import the module under test (does not exist yet — will cause import failure)
+import { detectFileChanges, startFileWatcher, stopFileWatcher, createFileWatchScope, } from './file-watch.js';
+// Import observation writer for integration tests
+import { initObservationFile, parseObservationFile, } from './observation-writer.js';
+// Get directory for test fixtures
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEST_DIR = join(__dirname, '__test_file_watch__');
+const SESSION_DIR = join(TEST_DIR, '.session');
+const WORK_DIR = join(TEST_DIR, 'workdir');
+// =============================================================================
+// Test Fixtures
+// =============================================================================
+const DEFAULT_POLL_MS = 100; // Fast for testing
+const DEFAULT_CONFIG = {
+    workDir: WORK_DIR,
+    sessionDir: SESSION_DIR,
+    storyId: '95-4',
+    agent: 'architect',
+    persona: 'Will Bailey',
+    phase: 'implement',
+    pollIntervalMs: DEFAULT_POLL_MS,
+    ignorePaths: ['.pennyfarthing/', '.session/', 'node_modules/'],
+};
+const OBS_CONFIG = {
+    storyId: '95-4',
+    agent: 'architect',
+    persona: 'Will Bailey',
+    phase: 'implement',
+    sessionDir: SESSION_DIR,
+};
+// =============================================================================
+// Setup / Teardown
+// =============================================================================
+describe('95-4: File-watch Observation Scope', () => {
+    beforeEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+        mkdirSync(SESSION_DIR, { recursive: true });
+        mkdirSync(WORK_DIR, { recursive: true });
+    });
+    afterEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+    });
+    // ===========================================================================
+    // AC1: Detect file create events
+    // ===========================================================================
+    describe('AC1: Detect file create events', () => {
+        it('should detect a newly created file', async () => {
+            // Baseline — no files yet
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            // Create a file
+            writeFileSync(join(WORK_DIR, 'new-file.ts'), 'export const x = 1;');
+            // Detect changes
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(result.data);
+            assert.ok(result.data.length > 0, 'Should detect at least one change');
+            const created = result.data.find((c) => c.path.includes('new-file.ts'));
+            assert.ok(created, 'Should find the created file');
+            assert.strictEqual(created.event, 'create');
+        });
+        it('should detect multiple created files in a single poll', async () => {
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            writeFileSync(join(WORK_DIR, 'a.ts'), 'a');
+            writeFileSync(join(WORK_DIR, 'b.ts'), 'b');
+            writeFileSync(join(WORK_DIR, 'c.ts'), 'c');
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(result.data);
+            assert.ok(result.data.length >= 3, `Expected ≥3 changes, got ${result.data.length}`);
+        });
+        it('should detect files created in subdirectories', async () => {
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            const subDir = join(WORK_DIR, 'src', 'components');
+            mkdirSync(subDir, { recursive: true });
+            writeFileSync(join(subDir, 'Widget.tsx'), 'export function Widget() {}');
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(result.data);
+            const created = result.data.find((c) => c.path.includes('Widget.tsx'));
+            assert.ok(created, 'Should find file in subdirectory');
+        });
+    });
+    // ===========================================================================
+    // AC2: Detect file modify events
+    // ===========================================================================
+    describe('AC2: Detect file modify events', () => {
+        it('should detect a modified file', async () => {
+            // Create file first
+            const filePath = join(WORK_DIR, 'existing.ts');
+            writeFileSync(filePath, 'export const x = 1;');
+            // Baseline with existing file
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            // Modify the file
+            writeFileSync(filePath, 'export const x = 2;');
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(result.data);
+            const modified = result.data.find((c) => c.path.includes('existing.ts'));
+            assert.ok(modified, 'Should find the modified file');
+            assert.strictEqual(modified.event, 'modify');
+        });
+    });
+    // ===========================================================================
+    // AC3: Detect file delete events
+    // ===========================================================================
+    describe('AC3: Detect file delete events', () => {
+        it('should detect a deleted file', async () => {
+            // Create file first
+            const filePath = join(WORK_DIR, 'to-delete.ts');
+            writeFileSync(filePath, 'export const temp = true;');
+            // Baseline
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            // Delete the file
+            unlinkSync(filePath);
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(result.data);
+            const deleted = result.data.find((c) => c.path.includes('to-delete.ts'));
+            assert.ok(deleted, 'Should find the deleted file');
+            assert.strictEqual(deleted.event, 'delete');
+        });
+    });
+    // ===========================================================================
+    // AC4: Detection within 5 seconds (poll interval)
+    // ===========================================================================
+    describe('AC4: Detection within 5 seconds', () => {
+        it('should accept poll interval ≤ 2000ms', () => {
+            // Verify the config accepts a valid poll interval
+            const config = {
+                ...DEFAULT_CONFIG,
+                pollIntervalMs: 2000,
+            };
+            assert.strictEqual(config.pollIntervalMs, 2000);
+        });
+        it('should default poll interval to ≤ 2000ms when not specified', async () => {
+            const configNoInterval = {
+                workDir: WORK_DIR,
+                sessionDir: SESSION_DIR,
+                storyId: '95-4',
+                agent: 'architect',
+                persona: 'Will Bailey',
+                phase: 'implement',
+                ignorePaths: [],
+            };
+            // createFileWatchScope should use a default interval ≤ 2000ms
+            const scope = createFileWatchScope(configNoInterval);
+            assert.ok(scope, 'Should create scope');
+            assert.ok(scope.pollIntervalMs <= 2000, `Default poll interval should be ≤ 2000ms, got ${scope.pollIntervalMs}`);
+        });
+    });
+    // ===========================================================================
+    // AC5: Non-blocking — functions return promptly
+    // ===========================================================================
+    describe('AC5: Non-blocking', () => {
+        it('detectFileChanges should resolve without long blocking', async () => {
+            const start = Date.now();
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            const elapsed = Date.now() - start;
+            assert.ok(result.success);
+            // Single detection cycle should complete in < 5000ms
+            assert.ok(elapsed < 5000, `detectFileChanges took ${elapsed}ms, expected < 5000ms`);
+        });
+        it('startFileWatcher should return handle immediately', async () => {
+            const start = Date.now();
+            const result = await startFileWatcher(DEFAULT_CONFIG);
+            const elapsed = Date.now() - start;
+            assert.ok(result.success);
+            assert.ok(result.data, 'Should return a handle');
+            // Start should be fast — sets up watcher, doesn't block
+            assert.ok(elapsed < 1000, `startFileWatcher took ${elapsed}ms, expected < 1000ms`);
+            // Cleanup
+            if (result.data) {
+                await stopFileWatcher(result.data);
+            }
+        });
+    });
+    // ===========================================================================
+    // AC6: Writes observations with file-watch trigger type
+    // ===========================================================================
+    describe('AC6: Writes file-watch observations', () => {
+        it('should write observation with file-watch trigger type on file create', async () => {
+            // Init observation file
+            const initResult = initObservationFile(OBS_CONFIG);
+            assert.ok(initResult.success);
+            assert.ok(initResult.data);
+            // Start watcher
+            const watchResult = await startFileWatcher({
+                ...DEFAULT_CONFIG,
+                observationFilePath: initResult.data.path,
+            });
+            assert.ok(watchResult.success);
+            assert.ok(watchResult.data);
+            // Create a file to trigger observation
+            writeFileSync(join(WORK_DIR, 'trigger.ts'), 'export const trigger = true;');
+            // Wait for at least one poll cycle
+            await new Promise(resolve => setTimeout(resolve, DEFAULT_POLL_MS * 3));
+            // Stop watcher
+            await stopFileWatcher(watchResult.data);
+            // Parse the observation file
+            const parsed = parseObservationFile(initResult.data.path);
+            assert.ok(parsed.success);
+            assert.ok(parsed.data);
+            assert.ok(parsed.data.entries.length > 0, 'Should have at least one observation entry');
+            const entry = parsed.data.entries[0];
+            assert.strictEqual(entry.triggerType, 'file-watch', 'Trigger type should be file-watch');
+            assert.ok(entry.triggerDetail.includes('trigger.ts'), 'Trigger detail should mention the file');
+        });
+        it('should include event type (create/modify/delete) in trigger detail', async () => {
+            const initResult = initObservationFile(OBS_CONFIG);
+            assert.ok(initResult.success);
+            assert.ok(initResult.data);
+            const watchResult = await startFileWatcher({
+                ...DEFAULT_CONFIG,
+                observationFilePath: initResult.data.path,
+            });
+            assert.ok(watchResult.success);
+            assert.ok(watchResult.data);
+            // Create a file
+            writeFileSync(join(WORK_DIR, 'event-type.ts'), 'content');
+            await new Promise(resolve => setTimeout(resolve, DEFAULT_POLL_MS * 3));
+            await stopFileWatcher(watchResult.data);
+            const parsed = parseObservationFile(initResult.data.path);
+            assert.ok(parsed.success);
+            assert.ok(parsed.data);
+            assert.ok(parsed.data.entries.length > 0);
+            // Trigger detail should contain the event type
+            const entry = parsed.data.entries[0];
+            assert.ok(entry.triggerDetail.includes('create') ||
+                entry.triggerDetail.includes('modify') ||
+                entry.triggerDetail.includes('delete'), `Trigger detail should include event type, got: "${entry.triggerDetail}"`);
+        });
+    });
+    // ===========================================================================
+    // AC7: Context accumulation — no redundant observations
+    // ===========================================================================
+    describe('AC7: Context accumulation', () => {
+        it('should not write duplicate observations for the same unchanged file', async () => {
+            const initResult = initObservationFile(OBS_CONFIG);
+            assert.ok(initResult.success);
+            assert.ok(initResult.data);
+            const watchResult = await startFileWatcher({
+                ...DEFAULT_CONFIG,
+                observationFilePath: initResult.data.path,
+            });
+            assert.ok(watchResult.success);
+            assert.ok(watchResult.data);
+            // Create a file
+            writeFileSync(join(WORK_DIR, 'once.ts'), 'content');
+            // Wait for multiple poll cycles
+            await new Promise(resolve => setTimeout(resolve, DEFAULT_POLL_MS * 6));
+            await stopFileWatcher(watchResult.data);
+            const parsed = parseObservationFile(initResult.data.path);
+            assert.ok(parsed.success);
+            assert.ok(parsed.data);
+            // File was created once and not modified again — should appear at most once
+            const onceEntries = parsed.data.entries.filter((e) => e.triggerDetail.includes('once.ts'));
+            assert.strictEqual(onceEntries.length, 1, `File should appear exactly once, got ${onceEntries.length}`);
+        });
+        it('should write a new observation when a previously seen file changes again', async () => {
+            const initResult = initObservationFile(OBS_CONFIG);
+            assert.ok(initResult.success);
+            assert.ok(initResult.data);
+            const watchResult = await startFileWatcher({
+                ...DEFAULT_CONFIG,
+                observationFilePath: initResult.data.path,
+            });
+            assert.ok(watchResult.success);
+            assert.ok(watchResult.data);
+            const filePath = join(WORK_DIR, 'changing.ts');
+            // Create file
+            writeFileSync(filePath, 'version 1');
+            await new Promise(resolve => setTimeout(resolve, DEFAULT_POLL_MS * 3));
+            // Modify the same file
+            writeFileSync(filePath, 'version 2');
+            await new Promise(resolve => setTimeout(resolve, DEFAULT_POLL_MS * 3));
+            await stopFileWatcher(watchResult.data);
+            const parsed = parseObservationFile(initResult.data.path);
+            assert.ok(parsed.success);
+            assert.ok(parsed.data);
+            const changingEntries = parsed.data.entries.filter((e) => e.triggerDetail.includes('changing.ts'));
+            // Should have at least 2 entries: create + modify
+            assert.ok(changingEntries.length >= 2, `Expected ≥2 entries for file, got ${changingEntries.length}`);
+        });
+    });
+    // ===========================================================================
+    // AC8: Ignores non-source directories
+    // ===========================================================================
+    describe('AC8: Ignores non-source paths', () => {
+        it('should ignore files in .pennyfarthing/ directory', async () => {
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            const ignoredDir = join(WORK_DIR, '.pennyfarthing');
+            mkdirSync(ignoredDir, { recursive: true });
+            writeFileSync(join(ignoredDir, 'config.yaml'), 'ignored: true');
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            const changes = result.data ?? [];
+            const pfChanges = changes.filter((c) => c.path.includes('.pennyfarthing'));
+            assert.strictEqual(pfChanges.length, 0, 'Should not detect changes in .pennyfarthing/');
+        });
+        it('should ignore files in node_modules/ directory', async () => {
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            const ignoredDir = join(WORK_DIR, 'node_modules', 'some-pkg');
+            mkdirSync(ignoredDir, { recursive: true });
+            writeFileSync(join(ignoredDir, 'index.js'), 'module.exports = {}');
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            const changes = result.data ?? [];
+            const nmChanges = changes.filter((c) => c.path.includes('node_modules'));
+            assert.strictEqual(nmChanges.length, 0, 'Should not detect changes in node_modules/');
+        });
+        it('should ignore files in .session/ directory', async () => {
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            mkdirSync(join(WORK_DIR, '.session'), { recursive: true });
+            writeFileSync(join(WORK_DIR, '.session', 'state.md'), '# state');
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            const changes = result.data ?? [];
+            // Note: .session within WORK_DIR, not SESSION_DIR
+            const sessionChanges = changes.filter((c) => c.path.includes('.session'));
+            assert.strictEqual(sessionChanges.length, 0, 'Should not detect changes in .session/');
+        });
+        it('should detect files in non-ignored directories', async () => {
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            const srcDir = join(WORK_DIR, 'src');
+            mkdirSync(srcDir, { recursive: true });
+            writeFileSync(join(srcDir, 'app.ts'), 'export const app = true;');
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(result.data);
+            assert.ok(result.data.length > 0, 'Should detect changes in src/');
+        });
+    });
+    // ===========================================================================
+    // AC9: Error resilience — continue if write fails
+    // ===========================================================================
+    describe('AC9: Error resilience', () => {
+        it('should return error result for invalid work directory', async () => {
+            const badConfig = {
+                ...DEFAULT_CONFIG,
+                workDir: '/nonexistent/path/that/does/not/exist',
+            };
+            const result = await detectFileChanges(badConfig);
+            // Should return error result, not throw
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error, 'Should have error message');
+        });
+        it('startFileWatcher should continue polling after observation write error', async () => {
+            // Use a non-existent observation file path to trigger write errors
+            const watchResult = await startFileWatcher({
+                ...DEFAULT_CONFIG,
+                observationFilePath: '/nonexistent/obs.md',
+            });
+            assert.ok(watchResult.success, 'Watcher should start even with bad observation path');
+            assert.ok(watchResult.data);
+            // Create a file — should trigger detection but write will fail
+            writeFileSync(join(WORK_DIR, 'resilient.ts'), 'content');
+            // Wait for a few poll cycles — watcher should NOT crash
+            await new Promise(resolve => setTimeout(resolve, DEFAULT_POLL_MS * 5));
+            // Watcher should still be alive (stopFileWatcher should succeed)
+            const stopResult = await stopFileWatcher(watchResult.data);
+            assert.ok(stopResult.success, 'Should stop cleanly even after write errors');
+        });
+    });
+    // ===========================================================================
+    // AC10: Returns result objects per framework pattern
+    // ===========================================================================
+    describe('AC10: Result objects', () => {
+        it('detectFileChanges should return {success, data?, error?}', async () => {
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(typeof result === 'object');
+            assert.ok('success' in result, 'Result must have success field');
+            if (result.success) {
+                assert.ok('data' in result || result.data === undefined, 'Successful result may have data');
+            }
+            else {
+                assert.ok('error' in result, 'Failed result must have error');
+            }
+        });
+        it('startFileWatcher should return {success, data?: FileWatchHandle, error?}', async () => {
+            const result = await startFileWatcher(DEFAULT_CONFIG);
+            assert.ok(typeof result === 'object');
+            assert.ok('success' in result);
+            if (result.success && result.data) {
+                assert.ok('handle' in result.data || 'stop' in result.data || typeof result.data === 'object', 'Handle should be an object');
+                await stopFileWatcher(result.data);
+            }
+        });
+        it('stopFileWatcher should return {success, error?}', async () => {
+            const watchResult = await startFileWatcher(DEFAULT_CONFIG);
+            assert.ok(watchResult.success);
+            assert.ok(watchResult.data);
+            const stopResult = await stopFileWatcher(watchResult.data);
+            assert.ok(typeof stopResult === 'object');
+            assert.ok('success' in stopResult);
+            assert.ok(stopResult.success);
+        });
+    });
+    // ===========================================================================
+    // Edge cases
+    // ===========================================================================
+    describe('Edge cases', () => {
+        it('should handle empty working directory gracefully', async () => {
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(Array.isArray(result.data));
+            assert.strictEqual(result.data.length, 0, 'No changes in empty directory');
+        });
+        it('should handle rapid successive file changes', async () => {
+            const baseline = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(baseline.success);
+            // Create many files rapidly
+            for (let i = 0; i < 10; i++) {
+                writeFileSync(join(WORK_DIR, `rapid-${i}.ts`), `content ${i}`);
+            }
+            const result = await detectFileChanges(DEFAULT_CONFIG);
+            assert.ok(result.success);
+            assert.ok(result.data);
+            assert.strictEqual(result.data.length, 10, `Expected 10 changes, got ${result.data.length}`);
+        });
+        it('stopFileWatcher should be idempotent', async () => {
+            const watchResult = await startFileWatcher(DEFAULT_CONFIG);
+            assert.ok(watchResult.success);
+            assert.ok(watchResult.data);
+            // Stop twice — second should not throw
+            const stop1 = await stopFileWatcher(watchResult.data);
+            assert.ok(stop1.success);
+            const stop2 = await stopFileWatcher(watchResult.data);
+            assert.ok(stop2.success, 'Second stop should also succeed (idempotent)');
+        });
+    });
+});
+//# sourceMappingURL=file-watch.test.js.map

package/packages/core/dist/workflow/file-watch.test.js.map

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

package/packages/core/dist/workflow/observation-writer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Observation File Writer for Story 95-3
+ *
+ * Creates and appends to observation files used by tandem backseat agents.
+ * Files are append-only markdown at `.session/{storyId}-tandem-{agent}.md`.
+ * Each write is entry-atomic — the file remains valid markdown on crash.
+ */
+/**
+ * Configuration for initializing an observation file
+ */
+export interface ObservationWriterConfig {
+    /** Current story ID */
+    storyId: string;
+    /** Observer agent name */
+    agent: string;
+    /** Observer persona name */
+    persona: string;
+    /** Current workflow phase */
+    phase: string;
+    /** Path to .session/ directory */
+    sessionDir: string;
+}
+/**
+ * A single observation entry to append
+ */
+export interface ObservationEntry {
+    /** Trigger type: file-watch, tool-watch, context-watch */
+    triggerType: string;
+    /** Trigger detail, e.g. "src/foo.ts modified" */
+    triggerDetail: string;
+    /** The observation text */
+    observation: string;
+}
+/**
+ * Standard result object per framework pattern
+ */
+export interface ObservationResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export interface ObservationFileHeader {
+    storyId: string;
+    observer: string;
+    phase: string;
+    started: string;
+}
+export interface ParsedObservationEntry {
+    timestamp: string;
+    triggerType: string;
+    triggerDetail: string;
+    observation: string;
+}
+/**
+ * Initialize an observation file with header metadata.
+ *
+ * Creates the file at `.session/{storyId}-tandem-{agent}.md` with
+ * a header containing observer agent, persona, phase, and start timestamp.
+ */
+export declare function initObservationFile(config: ObservationWriterConfig): ObservationResult<{
+    path: string;
+}>;
+/**
+ * Append an observation entry to an existing observation file.
+ *
+ * Each append is entry-atomic: the complete entry (separator, timestamp,
+ * trigger, observation text) is written in a single operation.
+ */
+export declare function appendObservation(filePath: string, entry: ObservationEntry): ObservationResult;
+/**
+ * Parse an observation file and return its entries.
+ *
+ * Used by bell mode to read recent observations for injection.
+ */
+export declare function parseObservationFile(filePath: string): ObservationResult<{
+    header: ObservationFileHeader;
+    entries: ParsedObservationEntry[];
+}>;
+//# sourceMappingURL=observation-writer.d.ts.map

package/packages/core/dist/workflow/observation-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-writer.d.ts","sourceRoot":"","sources":["../../src/workflow/observation-writer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBrC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,GACtB,iBAAiB,CAkBnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAAC;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAAC,CAsCzF"}