@redaksjon/protokoll 0.0.11 → 0.0.13

package/dist/util/sound.js

@@ -0,0 +1,116 @@
+import { spawn } from 'child_process';
+import { getLogger } from '../logging.js';
+
+// macOS system sounds that work well for notifications
+const MACOS_NOTIFICATION_SOUNDS = [
+    '/System/Library/Sounds/Glass.aiff',
+    '/System/Library/Sounds/Ping.aiff',
+    '/System/Library/Sounds/Pop.aiff',
+    '/System/Library/Sounds/Tink.aiff'
+];
+// Default sound to use (Glass is similar to Cursor's notification)
+const DEFAULT_MACOS_SOUND = MACOS_NOTIFICATION_SOUNDS[0];
+/**
+ * Play a sound file using afplay (macOS)
+ */ const playWithAfplay = (soundPath)=>{
+    return new Promise((resolve)=>{
+        const afplay = spawn('afplay', [
+            soundPath
+        ], {
+            stdio: 'ignore',
+            detached: true
+        });
+        afplay.on('error', ()=>{
+            resolve(false);
+        });
+        afplay.on('close', (code)=>{
+            resolve(code === 0);
+        });
+        // Don't wait for the sound to finish - just fire and forget
+        afplay.unref();
+        // Consider it successful if spawn didn't throw
+        setTimeout(()=>resolve(true), 50);
+    });
+};
+/**
+ * Play Windows system notification sound using PowerShell
+ * Uses SystemSounds.Asterisk which is a pleasant notification tone
+ */ const playWithPowerShell = ()=>{
+    return new Promise((resolve)=>{
+        // Use PowerShell to access .NET System.Media.SystemSounds
+        // Asterisk is a pleasant notification sound, similar to macOS Glass
+        const ps = spawn('powershell', [
+            '-NoProfile',
+            '-NonInteractive',
+            '-Command',
+            '[System.Media.SystemSounds]::Asterisk.Play()'
+        ], {
+            stdio: 'ignore',
+            detached: true,
+            // On Windows, use shell to ensure PowerShell is found
+            shell: true
+        });
+        ps.on('error', ()=>{
+            resolve(false);
+        });
+        ps.on('close', (code)=>{
+            resolve(code === 0);
+        });
+        ps.unref();
+        // Consider it successful if spawn didn't throw
+        setTimeout(()=>resolve(true), 50);
+    });
+};
+/**
+ * Play terminal bell as fallback for Linux and other platforms
+ */ const playTerminalBell = ()=>{
+    // Write ASCII bell character to stdout
+    process.stdout.write('\x07');
+};
+const create = (config)=>{
+    const logger = getLogger();
+    const playNotification = async ()=>{
+        if (config.silent) {
+            logger.debug('Sound notification skipped (silent mode)');
+            return;
+        }
+        try {
+            // macOS: use afplay with system sounds
+            if (process.platform === 'darwin') {
+                const success = await playWithAfplay(DEFAULT_MACOS_SOUND);
+                if (success) {
+                    logger.debug('Played notification sound: %s', DEFAULT_MACOS_SOUND);
+                    return;
+                }
+            }
+            // Windows: use PowerShell to play system sound
+            if (process.platform === 'win32') {
+                const success = await playWithPowerShell();
+                if (success) {
+                    logger.debug('Played Windows notification sound via PowerShell');
+                    return;
+                }
+            }
+            // Linux and others: fall back to terminal bell
+            playTerminalBell();
+            logger.debug('Played terminal bell notification');
+        } catch (error) {
+            // Sound failures should never interrupt the workflow
+            logger.debug('Failed to play notification sound: %s', error);
+            // Try terminal bell as last resort
+            try {
+                playTerminalBell();
+            } catch  {
+            // Silently ignore - sound is not critical
+            }
+        }
+    };
+    const isEnabled = ()=>!config.silent;
+    return {
+        playNotification,
+        isEnabled
+    };
+};
+
+export { create };
+//# sourceMappingURL=sound.js.map

package/dist/util/sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound.js","sources":["../../src/util/sound.ts"],"sourcesContent":["/**\n * Sound Notification Utility\n * \n * Plays system sounds to notify the user when interactive input is needed.\n * Similar to Cursor's notification behavior.\n * \n * Platform support:\n * - macOS: Uses afplay with system sounds (Glass.aiff)\n * - Windows: Uses PowerShell to play system notification sound\n * - Linux/Other: Falls back to terminal bell\n */\n\nimport { spawn } from 'child_process';\nimport * as Logging from '../logging';\n\nexport interface SoundConfig {\n    /** Whether sounds are disabled (silent mode) */\n    silent: boolean;\n}\n\nexport interface SoundInstance {\n    /** Play a notification sound to get user's attention */\n    playNotification(): Promise<void>;\n    /** Check if sounds are enabled */\n    isEnabled(): boolean;\n}\n\n// macOS system sounds that work well for notifications\nconst MACOS_NOTIFICATION_SOUNDS = [\n    '/System/Library/Sounds/Glass.aiff',\n    '/System/Library/Sounds/Ping.aiff', \n    '/System/Library/Sounds/Pop.aiff',\n    '/System/Library/Sounds/Tink.aiff',\n];\n\n// Default sound to use (Glass is similar to Cursor's notification)\nconst DEFAULT_MACOS_SOUND = MACOS_NOTIFICATION_SOUNDS[0];\n\n/**\n * Play a sound file using afplay (macOS)\n */\nconst playWithAfplay = (soundPath: string): Promise<boolean> => {\n    return new Promise((resolve) => {\n        const afplay = spawn('afplay', [soundPath], {\n            stdio: 'ignore',\n            detached: true,\n        });\n\n        afplay.on('error', () => {\n            resolve(false);\n        });\n\n        afplay.on('close', (code) => {\n            resolve(code === 0);\n        });\n\n        // Don't wait for the sound to finish - just fire and forget\n        afplay.unref();\n        \n        // Consider it successful if spawn didn't throw\n        setTimeout(() => resolve(true), 50);\n    });\n};\n\n/**\n * Play Windows system notification sound using PowerShell\n * Uses SystemSounds.Asterisk which is a pleasant notification tone\n */\nconst playWithPowerShell = (): Promise<boolean> => {\n    return new Promise((resolve) => {\n        // Use PowerShell to access .NET System.Media.SystemSounds\n        // Asterisk is a pleasant notification sound, similar to macOS Glass\n        const ps = spawn('powershell', [\n            '-NoProfile',\n            '-NonInteractive', \n            '-Command',\n            '[System.Media.SystemSounds]::Asterisk.Play()'\n        ], {\n            stdio: 'ignore',\n            detached: true,\n            // On Windows, use shell to ensure PowerShell is found\n            shell: true,\n        });\n\n        ps.on('error', () => {\n            resolve(false);\n        });\n\n        ps.on('close', (code) => {\n            resolve(code === 0);\n        });\n\n        ps.unref();\n        \n        // Consider it successful if spawn didn't throw\n        setTimeout(() => resolve(true), 50);\n    });\n};\n\n/**\n * Play terminal bell as fallback for Linux and other platforms\n */\nconst playTerminalBell = (): void => {\n    // Write ASCII bell character to stdout\n    process.stdout.write('\\x07');\n};\n\nexport const create = (config: SoundConfig): SoundInstance => {\n    const logger = Logging.getLogger();\n    \n    const playNotification = async (): Promise<void> => {\n        if (config.silent) {\n            logger.debug('Sound notification skipped (silent mode)');\n            return;\n        }\n\n        try {\n            // macOS: use afplay with system sounds\n            if (process.platform === 'darwin') {\n                const success = await playWithAfplay(DEFAULT_MACOS_SOUND);\n                if (success) {\n                    logger.debug('Played notification sound: %s', DEFAULT_MACOS_SOUND);\n                    return;\n                }\n            }\n            \n            // Windows: use PowerShell to play system sound\n            if (process.platform === 'win32') {\n                const success = await playWithPowerShell();\n                if (success) {\n                    logger.debug('Played Windows notification sound via PowerShell');\n                    return;\n                }\n            }\n            \n            // Linux and others: fall back to terminal bell\n            playTerminalBell();\n            logger.debug('Played terminal bell notification');\n        } catch (error) {\n            // Sound failures should never interrupt the workflow\n            logger.debug('Failed to play notification sound: %s', error);\n            // Try terminal bell as last resort\n            try {\n                playTerminalBell();\n            } catch {\n                // Silently ignore - sound is not critical\n            }\n        }\n    };\n\n    const isEnabled = (): boolean => !config.silent;\n\n    return {\n        playNotification,\n        isEnabled,\n    };\n};\n\n"],"names":["MACOS_NOTIFICATION_SOUNDS","DEFAULT_MACOS_SOUND","playWithAfplay","soundPath","Promise","resolve","afplay","spawn","stdio","detached","on","code","unref","setTimeout","playWithPowerShell","ps","shell","playTerminalBell","process","stdout","write","create","config","logger","Logging","playNotification","silent","debug","platform","success","error","isEnabled"],"mappings":"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"}

package/dist/util/storage.js

@@ -1,7 +1,7 @@
-import * as fs from 'fs';
+import * as fs from 'node:fs';
 import { glob } from 'glob';
-import path__default from 'path';
-import crypto from 'crypto';
+import path__default from 'node:path';
+import crypto from 'node:crypto';
 
 // eslint-disable-next-line no-restricted-imports
 const create = (params)=>{

package/dist/util/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sources":["../../src/util/storage.ts"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport * as fs from 'fs';\nimport { glob } from 'glob';\nimport path from 'path';\nimport crypto from 'crypto';\n/**\n * This module exists to isolate filesystem operations from the rest of the codebase.\n * This makes testing easier by avoiding direct fs mocking in jest configuration.\n * \n * Additionally, abstracting storage operations allows for future flexibility - \n * this export utility may need to work with storage systems other than the local filesystem\n * (e.g. S3, Google Cloud Storage, etc).\n */\n\nexport interface Utility {\n    exists: (path: string) => Promise<boolean>;\n    isDirectory: (path: string) => Promise<boolean>;\n    isFile: (path: string) => Promise<boolean>;\n    isReadable: (path: string) => Promise<boolean>;\n    isWritable: (path: string) => Promise<boolean>;\n    isFileReadable: (path: string) => Promise<boolean>;\n    isDirectoryWritable: (path: string) => Promise<boolean>;\n    isDirectoryReadable: (path: string) => Promise<boolean>;\n    createDirectory: (path: string) => Promise<void>;\n    readFile: (path: string, encoding: string) => Promise<string>;\n    readStream: (path: string) => Promise<fs.ReadStream>;\n    writeFile: (path: string, data: string | Buffer, encoding: string) => Promise<void>;\n    forEachFileIn: (directory: string, callback: (path: string) => Promise<void>, options?: { pattern: string }) => Promise<void>;\n    hashFile: (path: string, length: number) => Promise<string>;\n    listFiles: (directory: string) => Promise<string[]>;\n    deleteFile: (path: string) => Promise<void>;\n    getFileSize: (path: string) => Promise<number>;\n}\n\nexport const create = (params: { log?: (message: string, ...args: any[]) => void }): Utility => {\n\n    // eslint-disable-next-line no-console\n    const log = params.log || console.log;\n\n    const exists = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.stat(path);\n            return true;\n            // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        } catch (error: any) {\n            return false;\n        }\n    }\n\n    const isDirectory = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isDirectory()) {\n            log(`${path} is not a directory`);\n            return false;\n        }\n        return true;\n    }\n\n    const isFile = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isFile()) {\n            log(`${path} is not a file`);\n            return false;\n        }\n        return true;\n    }\n\n    const isReadable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.R_OK);\n        } catch (error: any) {\n            log(`${path} is not readable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isWritable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.W_OK);\n        } catch (error: any) {\n            log(`${path} is not writable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isFileReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isFile(path) && await isReadable(path);\n    }\n\n    const isDirectoryWritable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isWritable(path);\n    }\n\n    const isDirectoryReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isReadable(path);\n    }\n\n    const createDirectory = async (path: string): Promise<void> => {\n        try {\n            await fs.promises.mkdir(path, { recursive: true });\n        } catch (mkdirError: any) {\n            throw new Error(`Failed to create output directory ${path}: ${mkdirError.message} ${mkdirError.stack}`);\n        }\n    }\n\n    const readFile = async (path: string, encoding: string): Promise<string> => {\n        return await fs.promises.readFile(path, { encoding: encoding as BufferEncoding });\n    }\n\n    const writeFile = async (path: string, data: string | Buffer, encoding: string): Promise<void> => {\n        await fs.promises.writeFile(path, data, { encoding: encoding as BufferEncoding });\n    }\n\n    const forEachFileIn = async (directory: string, callback: (file: string) => Promise<void>, options: { pattern: string | string[] } = { pattern: '*.*' }): Promise<void> => {\n        try {\n            const files = await glob(options.pattern, { cwd: directory, nodir: true });\n            for (const file of files) {\n                await callback(path.join(directory, file));\n            }\n        } catch (err: any) {\n            throw new Error(`Failed to glob pattern ${options.pattern} in ${directory}: ${err.message}`);\n        }\n    }\n\n    const readStream = async (path: string): Promise<fs.ReadStream> => {\n        return fs.createReadStream(path);\n    }\n\n    const hashFile = async (path: string, length: number): Promise<string> => {\n        const file = await readFile(path, 'utf8');\n        return crypto.createHash('sha256').update(file).digest('hex').slice(0, length);\n    }\n\n    const listFiles = async (directory: string): Promise<string[]> => {\n        return await fs.promises.readdir(directory);\n    }\n\n    const deleteFile = async (path: string): Promise<void> => {\n        await fs.promises.unlink(path);\n    }\n\n    const getFileSize = async (path: string): Promise<number> => {\n        const stats = await fs.promises.stat(path);\n        return stats.size;\n    }\n\n    return {\n        exists,\n        isDirectory,\n        isFile,\n        isReadable,\n        isWritable,\n        isFileReadable,\n        isDirectoryWritable,\n        isDirectoryReadable,\n        createDirectory,\n        readFile,\n        readStream,\n        writeFile,\n        forEachFileIn,\n        hashFile,\n        listFiles,\n        deleteFile,\n        getFileSize,\n    };\n}"],"names":["create","params","log","console","exists","path","fs","promises","stat","error","isDirectory","stats","isFile","isReadable","access","constants","R_OK","message","stack","isWritable","W_OK","isFileReadable","isDirectoryWritable","isDirectoryReadable","createDirectory","mkdir","recursive","mkdirError","Error","readFile","encoding","writeFile","data","forEachFileIn","directory","callback","options","pattern","files","glob","cwd","nodir","file","join","err","readStream","createReadStream","hashFile","length","crypto","createHash","update","digest","slice","listFiles","readdir","deleteFile","unlink","getFileSize","size"],"mappings":";;;;;AAAA;AAkCO,MAAMA,SAAS,CAACC,MAAAA,GAAAA;;AAGnB,IAAA,MAAMC,GAAAA,GAAMD,MAAAA,CAAOC,GAAG,IAAIC,QAAQD,GAAG;AAErC,IAAA,MAAME,SAAS,OAAOC,IAAAA,GAAAA;QAClB,IAAI;AACA,YAAA,MAAMC,EAAAA,CAAGC,QAAQ,CAACC,IAAI,CAACH,IAAAA,CAAAA;YACvB,OAAO,IAAA;;AAEX,QAAA,CAAA,CAAE,OAAOI,KAAAA,EAAY;YACjB,OAAO,KAAA;AACX,QAAA;AACJ,IAAA,CAAA;AAEA,IAAA,MAAMC,cAAc,OAAOL,IAAAA,GAAAA;AACvB,QAAA,MAAMM,QAAQ,MAAML,EAAAA,CAAGC,QAAQ,CAACC,IAAI,CAACH,IAAAA,CAAAA;QACrC,IAAI,CAACM,KAAAA,CAAMD,WAAW,EAAA,EAAI;YACtBR,GAAAA,CAAI,CAAA,EAAGG,IAAAA,CAAK,mBAAmB,CAAC,CAAA;YAChC,OAAO,KAAA;AACX,QAAA;QACA,OAAO,IAAA;AACX,IAAA,CAAA;AAEA,IAAA,MAAMO,SAAS,OAAOP,IAAAA,GAAAA;AAClB,QAAA,MAAMM,QAAQ,MAAML,EAAAA,CAAGC,QAAQ,CAACC,IAAI,CAACH,IAAAA,CAAAA;QACrC,IAAI,CAACM,KAAAA,CAAMC,MAAM,EAAA,EAAI;YACjBV,GAAAA,CAAI,CAAA,EAAGG,IAAAA,CAAK,cAAc,CAAC,CAAA;YAC3B,OAAO,KAAA;AACX,QAAA;QACA,OAAO,IAAA;AACX,IAAA,CAAA;AAEA,IAAA,MAAMQ,aAAa,OAAOR,IAAAA,GAAAA;QACtB,IAAI;YACA,MAAMC,EAAAA,CAAGC,QAAQ,CAACO,MAAM,CAACT,IAAAA,EAAMC,EAAAA,CAAGS,SAAS,CAACC,IAAI,CAAA;AACpD,QAAA,CAAA,CAAE,OAAOP,KAAAA,EAAY;YACjBP,GAAAA,CAAI,CAAA,EAAGG,KAAK,uBAAuB,CAAC,EAAEI,KAAAA,CAAMQ,OAAO,EAAER,KAAAA,CAAMS,KAAK,CAAA;YAChE,OAAO,KAAA;AACX,QAAA;QACA,OAAO,IAAA;AACX,IAAA,CAAA;AAEA,IAAA,MAAMC,aAAa,OAAOd,IAAAA,GAAAA;QACtB,IAAI;YACA,MAAMC,EAAAA,CAAGC,QAAQ,CAACO,MAAM,CAACT,IAAAA,EAAMC,EAAAA,CAAGS,SAAS,CAACK,IAAI,CAAA;AACpD,QAAA,CAAA,CAAE,OAAOX,KAAAA,EAAY;YACjBP,GAAAA,CAAI,CAAA,EAAGG,KAAK,uBAAuB,CAAC,EAAEI,KAAAA,CAAMQ,OAAO,EAAER,KAAAA,CAAMS,KAAK,CAAA;YAChE,OAAO,KAAA;AACX,QAAA;QACA,OAAO,IAAA;AACX,IAAA,CAAA;AAEA,IAAA,MAAMG,iBAAiB,OAAOhB,IAAAA,GAAAA;AAC1B,QAAA,OAAO,MAAMD,MAAAA,CAAOC,IAAAA,CAAAA,IAAS,MAAMO,MAAAA,CAAOP,IAAAA,CAAAA,IAAS,MAAMQ,UAAAA,CAAWR,IAAAA,CAAAA;AACxE,IAAA,CAAA;AAEA,IAAA,MAAMiB,sBAAsB,OAAOjB,IAAAA,GAAAA;AAC/B,QAAA,OAAO,MAAMD,MAAAA,CAAOC,IAAAA,CAAAA,IAAS,MAAMK,WAAAA,CAAYL,IAAAA,CAAAA,IAAS,MAAMc,UAAAA,CAAWd,IAAAA,CAAAA;AAC7E,IAAA,CAAA;AAEA,IAAA,MAAMkB,sBAAsB,OAAOlB,IAAAA,GAAAA;AAC/B,QAAA,OAAO,MAAMD,MAAAA,CAAOC,IAAAA,CAAAA,IAAS,MAAMK,WAAAA,CAAYL,IAAAA,CAAAA,IAAS,MAAMQ,UAAAA,CAAWR,IAAAA,CAAAA;AAC7E,IAAA,CAAA;AAEA,IAAA,MAAMmB,kBAAkB,OAAOnB,IAAAA,GAAAA;QAC3B,IAAI;AACA,YAAA,MAAMC,EAAAA,CAAGC,QAAQ,CAACkB,KAAK,CAACpB,IAAAA,EAAM;gBAAEqB,SAAAA,EAAW;AAAK,aAAA,CAAA;AACpD,QAAA,CAAA,CAAE,OAAOC,UAAAA,EAAiB;AACtB,YAAA,MAAM,IAAIC,KAAAA,CAAM,CAAC,kCAAkC,EAAEvB,IAAAA,CAAK,EAAE,EAAEsB,UAAAA,CAAWV,OAAO,CAAC,CAAC,EAAEU,UAAAA,CAAWT,KAAK,CAAA,CAAE,CAAA;AAC1G,QAAA;AACJ,IAAA,CAAA;IAEA,MAAMW,QAAAA,GAAW,OAAOxB,IAAAA,EAAcyB,QAAAA,GAAAA;AAClC,QAAA,OAAO,MAAMxB,EAAAA,CAAGC,QAAQ,CAACsB,QAAQ,CAACxB,IAAAA,EAAM;YAAEyB,QAAAA,EAAUA;AAA2B,SAAA,CAAA;AACnF,IAAA,CAAA;IAEA,MAAMC,SAAAA,GAAY,OAAO1B,IAAAA,EAAc2B,IAAAA,EAAuBF,QAAAA,GAAAA;AAC1D,QAAA,MAAMxB,GAAGC,QAAQ,CAACwB,SAAS,CAAC1B,MAAM2B,IAAAA,EAAM;YAAEF,QAAAA,EAAUA;AAA2B,SAAA,CAAA;AACnF,IAAA,CAAA;AAEA,IAAA,MAAMG,aAAAA,GAAgB,OAAOC,SAAAA,EAAmBC,QAAAA,EAA2CC,OAAAA,GAA0C;QAAEC,OAAAA,EAAS;KAAO,GAAA;QACnJ,IAAI;AACA,YAAA,MAAMC,KAAAA,GAAQ,MAAMC,IAAAA,CAAKH,OAAAA,CAAQC,OAAO,EAAE;gBAAEG,GAAAA,EAAKN,SAAAA;gBAAWO,KAAAA,EAAO;AAAK,aAAA,CAAA;YACxE,KAAK,MAAMC,QAAQJ,KAAAA,CAAO;AACtB,gBAAA,MAAMH,QAAAA,CAAS9B,aAAAA,CAAKsC,IAAI,CAACT,SAAAA,EAAWQ,IAAAA,CAAAA,CAAAA;AACxC,YAAA;AACJ,QAAA,CAAA,CAAE,OAAOE,GAAAA,EAAU;AACf,YAAA,MAAM,IAAIhB,KAAAA,CAAM,CAAC,uBAAuB,EAAEQ,OAAAA,CAAQC,OAAO,CAAC,IAAI,EAAEH,SAAAA,CAAU,EAAE,EAAEU,GAAAA,CAAI3B,OAAO,CAAA,CAAE,CAAA;AAC/F,QAAA;AACJ,IAAA,CAAA;AAEA,IAAA,MAAM4B,aAAa,OAAOxC,IAAAA,GAAAA;QACtB,OAAOC,EAAAA,CAAGwC,gBAAgB,CAACzC,IAAAA,CAAAA;AAC/B,IAAA,CAAA;IAEA,MAAM0C,QAAAA,GAAW,OAAO1C,IAAAA,EAAc2C,MAAAA,GAAAA;QAClC,MAAMN,IAAAA,GAAO,MAAMb,QAAAA,CAASxB,IAAAA,EAAM,MAAA,CAAA;AAClC,QAAA,OAAO4C,MAAAA,CAAOC,UAAU,CAAC,QAAA,CAAA,CAAUC,MAAM,CAACT,IAAAA,CAAAA,CAAMU,MAAM,CAAC,KAAA,CAAA,CAAOC,KAAK,CAAC,CAAA,EAAGL,MAAAA,CAAAA;AAC3E,IAAA,CAAA;AAEA,IAAA,MAAMM,YAAY,OAAOpB,SAAAA,GAAAA;AACrB,QAAA,OAAO,MAAM5B,EAAAA,CAAGC,QAAQ,CAACgD,OAAO,CAACrB,SAAAA,CAAAA;AACrC,IAAA,CAAA;AAEA,IAAA,MAAMsB,aAAa,OAAOnD,IAAAA,GAAAA;AACtB,QAAA,MAAMC,EAAAA,CAAGC,QAAQ,CAACkD,MAAM,CAACpD,IAAAA,CAAAA;AAC7B,IAAA,CAAA;AAEA,IAAA,MAAMqD,cAAc,OAAOrD,IAAAA,GAAAA;AACvB,QAAA,MAAMM,QAAQ,MAAML,EAAAA,CAAGC,QAAQ,CAACC,IAAI,CAACH,IAAAA,CAAAA;AACrC,QAAA,OAAOM,MAAMgD,IAAI;AACrB,IAAA,CAAA;IAEA,OAAO;AACHvD,QAAAA,MAAAA;AACAM,QAAAA,WAAAA;AACAE,QAAAA,MAAAA;AACAC,QAAAA,UAAAA;AACAM,QAAAA,UAAAA;AACAE,QAAAA,cAAAA;AACAC,QAAAA,mBAAAA;AACAC,QAAAA,mBAAAA;AACAC,QAAAA,eAAAA;AACAK,QAAAA,QAAAA;AACAgB,QAAAA,UAAAA;AACAd,QAAAA,SAAAA;AACAE,QAAAA,aAAAA;AACAc,QAAAA,QAAAA;AACAO,QAAAA,SAAAA;AACAE,QAAAA,UAAAA;AACAE,QAAAA;AACJ,KAAA;AACJ;;;;"}
+{"version":3,"file":"storage.js","sources":["../../src/util/storage.ts"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport * as fs from 'node:fs';\nimport { glob } from 'glob';\nimport path from 'node:path';\nimport crypto from 'node:crypto';\n/**\n * This module exists to isolate filesystem operations from the rest of the codebase.\n * This makes testing easier by avoiding direct fs mocking in jest configuration.\n * \n * Additionally, abstracting storage operations allows for future flexibility - \n * this export utility may need to work with storage systems other than the local filesystem\n * (e.g. S3, Google Cloud Storage, etc).\n */\n\nexport interface Utility {\n    exists: (path: string) => Promise<boolean>;\n    isDirectory: (path: string) => Promise<boolean>;\n    isFile: (path: string) => Promise<boolean>;\n    isReadable: (path: string) => Promise<boolean>;\n    isWritable: (path: string) => Promise<boolean>;\n    isFileReadable: (path: string) => Promise<boolean>;\n    isDirectoryWritable: (path: string) => Promise<boolean>;\n    isDirectoryReadable: (path: string) => Promise<boolean>;\n    createDirectory: (path: string) => Promise<void>;\n    readFile: (path: string, encoding: string) => Promise<string>;\n    readStream: (path: string) => Promise<fs.ReadStream>;\n    writeFile: (path: string, data: string | Buffer, encoding: string) => Promise<void>;\n    forEachFileIn: (directory: string, callback: (path: string) => Promise<void>, options?: { pattern: string }) => Promise<void>;\n    hashFile: (path: string, length: number) => Promise<string>;\n    listFiles: (directory: string) => Promise<string[]>;\n    deleteFile: (path: string) => Promise<void>;\n    getFileSize: (path: string) => Promise<number>;\n}\n\nexport const create = (params: { log?: (message: string, ...args: any[]) => void }): Utility => {\n\n    // eslint-disable-next-line no-console\n    const log = params.log || console.log;\n\n    const exists = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.stat(path);\n            return true;\n            // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        } catch (error: any) {\n            return false;\n        }\n    }\n\n    const isDirectory = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isDirectory()) {\n            log(`${path} is not a directory`);\n            return false;\n        }\n        return true;\n    }\n\n    const isFile = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isFile()) {\n            log(`${path} is not a file`);\n            return false;\n        }\n        return true;\n    }\n\n    const isReadable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.R_OK);\n        } catch (error: any) {\n            log(`${path} is not readable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isWritable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.W_OK);\n        } catch (error: any) {\n            log(`${path} is not writable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isFileReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isFile(path) && await isReadable(path);\n    }\n\n    const isDirectoryWritable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isWritable(path);\n    }\n\n    const isDirectoryReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isReadable(path);\n    }\n\n    const createDirectory = async (path: string): Promise<void> => {\n        try {\n            await fs.promises.mkdir(path, { recursive: true });\n        } catch (mkdirError: any) {\n            throw new Error(`Failed to create output directory ${path}: ${mkdirError.message} ${mkdirError.stack}`);\n        }\n    }\n\n    const readFile = async (path: string, encoding: string): Promise<string> => {\n        return await fs.promises.readFile(path, { encoding: encoding as BufferEncoding });\n    }\n\n    const writeFile = async (path: string, data: string | Buffer, encoding: string): Promise<void> => {\n        await fs.promises.writeFile(path, data, { encoding: encoding as BufferEncoding });\n    }\n\n    const forEachFileIn = async (directory: string, callback: (file: string) => Promise<void>, options: { pattern: string | string[] } = { pattern: '*.*' }): Promise<void> => {\n        try {\n            const files = await glob(options.pattern, { cwd: directory, nodir: true });\n            for (const file of files) {\n                await callback(path.join(directory, file));\n            }\n        } catch (err: any) {\n            throw new Error(`Failed to glob pattern ${options.pattern} in ${directory}: ${err.message}`);\n        }\n    }\n\n    const readStream = async (path: string): Promise<fs.ReadStream> => {\n        return fs.createReadStream(path);\n    }\n\n    const hashFile = async (path: string, length: number): Promise<string> => {\n        const file = await readFile(path, 'utf8');\n        return crypto.createHash('sha256').update(file).digest('hex').slice(0, length);\n    }\n\n    const listFiles = async (directory: string): Promise<string[]> => {\n        return await fs.promises.readdir(directory);\n    }\n\n    const deleteFile = async (path: string): Promise<void> => {\n        await fs.promises.unlink(path);\n    }\n\n    const getFileSize = async (path: string): Promise<number> => {\n        const stats = await fs.promises.stat(path);\n        return stats.size;\n    }\n\n    return {\n        exists,\n        isDirectory,\n        isFile,\n        isReadable,\n        isWritable,\n        isFileReadable,\n        isDirectoryWritable,\n        isDirectoryReadable,\n        createDirectory,\n        readFile,\n        readStream,\n        writeFile,\n        forEachFileIn,\n        hashFile,\n        listFiles,\n        deleteFile,\n        getFileSize,\n    };\n}"],"names":["create","params","log","console","exists","path","fs","promises","stat","error","isDirectory","stats","isFile","isReadable","access","constants","R_OK","message","stack","isWritable","W_OK","isFileReadable","isDirectoryWritable","isDirectoryReadable","createDirectory","mkdir","recursive","mkdirError","Error","readFile","encoding","writeFile","data","forEachFileIn","directory","callback","options","pattern","files","glob","cwd","nodir","file","join","err","readStream","createReadStream","hashFile","length","crypto","createHash","update","digest","slice","listFiles","readdir","deleteFile","unlink","getFileSize","size"],"mappings":"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"}

package/docs/duplicate-question-prevention.md

@@ -0,0 +1,117 @@
+# Duplicate Question Prevention
+
+## Problem
+When processing long transcripts in interactive mode, protokoll was asking the same questions repeatedly about people and projects that had already been resolved during the same session.
+
+## Root Cause
+The lookup tools (`lookup_person`, `lookup_project`) were only checking the context files on disk, not the in-memory state of entities that were just resolved. When a user answered a question about "John Doe" early in the transcript, and the same name appeared again later, the tool would ask about it again because:
+
+1. The newly created entity was saved to disk but not immediately available in subsequent searches
+2. The tools didn't check if the entity was already resolved during this processing session
+
+## Solution
+
+### 1. Resolved Entities Tracking
+Added `resolvedEntities` Map to the `ToolContext`:
+
+```typescript
+export interface ToolContext {
+    // ... existing fields
+    resolvedEntities?: Map<string, string>;  // Entities resolved during this session
+}
+```
+
+This Map tracks all entity resolutions made during the current transcript processing session.
+
+### 2. Check Before Prompting
+Updated both `lookup_person` and `lookup_project` tools to check the resolved entities first:
+
+```typescript
+// First, check if this person was already resolved in this session
+if (ctx.resolvedEntities?.has(args.name)) {
+    const resolvedName = ctx.resolvedEntities.get(args.name);
+    return {
+        success: true,
+        data: {
+            found: true,
+            suggestion: `Already resolved: use "${resolvedName}"`,
+            cached: true,
+        },
+    };
+}
+```
+
+### 3. Immediate Context Reload
+After saving a new entity to disk, immediately reload the context:
+
+```typescript
+await ctx.contextInstance.saveEntity(newProject);
+await ctx.contextInstance.reload();  // Reload so subsequent searches find this entity
+```
+
+This ensures that subsequent tool calls will find the newly created entity even before checking the resolved entities cache.
+
+## Benefits
+
+**No Duplicate Questions:** Users are only asked about each person/project/term once per transcript  
+**Better UX:** Faster processing for long transcripts with repeated mentions  
+**Maintains State:** The resolved entities Map is shared across all tool executions in the session  
+**Backwards Compatible:** Works even if `resolvedEntities` is undefined (graceful fallback)
+
+## Example
+
+### Before (Annoying!)
+```
+Processing transcript with 20 mentions of "Trey Toulson"...
+
+────────────────────────────────────────────────────────────
+[Unknown Person Detected]
+Name heard: "Trey Toulson"
+...
+────────────────────────────────────────────────────────────
+Is the name spelled correctly? → User enters details
+
+[... processing continues ...]
+
+────────────────────────────────────────────────────────────
+[Unknown Person Detected]
+Name heard: "Trey Toulson"  ← SAME PERSON AGAIN!
+...
+────────────────────────────────────────────────────────────
+Is the name spelled correctly? → User asked AGAIN!
+```
+
+### After (Fixed!)
+```
+Processing transcript with 20 mentions of "Trey Toulson"...
+
+────────────────────────────────────────────────────────────
+[Unknown Person Detected]
+Name heard: "Trey Toulson"
+...
+────────────────────────────────────────────────────────────
+Is the name spelled correctly? → User enters details
+
+[... processing continues ...]
+
+[Tool automatically uses cached resolution for "Trey Toulson"]
+[No prompt - continues processing smoothly]
+```
+
+## Implementation Details
+
+### Files Modified
+- `src/agentic/types.ts` - Added `resolvedEntities` to `ToolContext`
+- `src/agentic/executor.ts` - Wire up resolved entities and reload context after saves
+- `src/agentic/tools/lookup-person.ts` - Check cache before prompting
+- `src/agentic/tools/lookup-project.ts` - Check cache before prompting
+
+### Test Coverage
+Added 8 new tests in `tests/agentic/resolved-entities.test.ts`:
+- Test that first lookup prompts
+- Test that second lookup returns cached result
+- Test that multiple lookups of same entity don't prompt again
+- Test cross-tool entity sharing
+- Test graceful handling when resolvedEntities is undefined
+
+All 580 tests passing.

package/docs/examples.md

@@ -222,3 +222,155 @@ cd ~/work/project-a
 protokoll --input-directory ./recordings
 ```
 
+## Scenario 11: Edit Transcript Title
+
+Rename a transcript with a more meaningful title.
+
+```bash
+# Change title (updates document heading and filename)
+protokoll action --title "Q1 Budget Review Meeting" ~/notes/2026/01/15-1412-meeting.md
+
+# Preview changes first
+protokoll action --title "Q1 Budget Review" ~/notes/file.md --dry-run --verbose
+```
+
+Result:
+- Document heading changes to `# Q1 Budget Review Meeting`
+- File renames to `15-1412-q1-budget-review-meeting.md`
+
+## Scenario 12: Move Transcript to Different Project
+
+Realize a transcript belongs to a different project.
+
+```bash
+# Move to different project (updates metadata and routes to project destination)
+protokoll action --project client-alpha ~/notes/2026/01/15-1412-meeting.md
+
+# Change both title and project
+protokoll action --title "Alpha Kickoff" --project client-alpha ~/notes/file.md
+```
+
+Result:
+- Metadata updated with new project name and ID
+- File moved to project's configured destination
+- Original file removed
+
+## Scenario 13: Combine Multiple Transcripts
+
+Merge several related transcripts from a long meeting.
+
+```bash
+# Combine with a custom title
+protokoll action --title "Full Team Standup" --combine "~/notes/2026/01/15-1412-part1.md
+~/notes/2026/01/15-1421-part2.md
+~/notes/2026/01/15-1435-part3.md"
+
+# Combine and assign to project
+protokoll action --title "Sprint 42 Planning" --project sprint-42 --combine "~/notes/misc1.md
+~/notes/misc2.md"
+
+# Preview what would happen
+protokoll action --combine "~/notes/files..." --dry-run --verbose
+```
+
+Result:
+- Single combined transcript with custom title
+- Sorted chronologically by timestamp
+- Durations summed, tags deduplicated
+- Source files automatically deleted
+
+## Scenario 14: Reorganize Scattered Notes
+
+Consolidate notes that were initially routed to the default location.
+
+```bash
+# Find notes that mention a specific topic
+ls ~/notes/2026/01/*standards*.md
+
+# Combine them into a project
+protokoll action --title "Fellow Standards Discussion" --project fellow-standards --combine "~/notes/2026/01/15-1412-ne-4th-st-0.md
+~/notes/2026/01/15-1421-dimension-talk.md
+~/notes/2026/01/15-1435-standards-continued.md"
+```
+
+Result:
+- All related notes combined into one comprehensive document
+- Routed to the `fellow-standards` project destination
+- Original scattered files cleaned up
+
+## Scenario 15: Fix a Misheard Term
+
+A technical term was transcribed incorrectly.
+
+```bash
+# The transcript has "WCMP" but should be "WCNP"
+protokoll feedback ~/notes/2026/01/15-1412-meeting.md \
+  -f "Everywhere it says WCMP, that should be WCNP - Walmart's Native Cloud Platform"
+```
+
+Result:
+- "WCMP" replaced with "WCNP" throughout the transcript
+- "WCNP" added to your vocabulary with the full expansion
+- Phonetic variants stored so it won't be misheard again
+
+## Scenario 16: Fix a Misheard Name
+
+A person's name was transcribed phonetically.
+
+```bash
+# The transcript has "San Jay Grouper" but should be "Sanjay Gupta"
+protokoll feedback ~/notes/2026/01/15-1412-meeting.md \
+  -f "San Jay Grouper is actually Sanjay Gupta"
+```
+
+Result:
+- Name corrected throughout the transcript
+- Variations like "San Jay" or "Sanjay Grouper" also fixed
+- Person added to context for future recognition
+
+## Scenario 17: Reassign to Different Project via Feedback
+
+A transcript was routed to the wrong project.
+
+```bash
+# Interactive feedback
+protokoll feedback ~/notes/2026/01/15-1412-meeting.md
+
+# When prompted: "This should be in the Quantum Readiness project"
+```
+
+Result:
+- Project metadata updated in the transcript
+- File moved to the project's configured destination
+- Filename updated according to project rules
+
+## Scenario 18: Preview Feedback Changes
+
+See what would happen without making changes.
+
+```bash
+# Dry run with verbose output
+protokoll feedback ~/notes/2026/01/15-1412-meeting.md \
+  -f "YB should be Wibey" \
+  --dry-run --verbose
+```
+
+Output:
+```
+[Dry Run] Would apply the following changes:
+  - Replaced "YB" with "Wibey" (3 occurrences)
+  - Added term "Wibey" to context
+```
+
+## Scenario 19: Get Help with Feedback
+
+Not sure what feedback you can give.
+
+```bash
+# Show feedback examples
+protokoll feedback --help-me
+
+# Or during interactive session
+protokoll feedback ~/notes/meeting.md
+# Enter: "What kinds of feedback can I give?"
+```

package/docs/interactive-context-example.md

@@ -0,0 +1,92 @@
+# Interactive Prompt Context Improvements
+
+## Overview
+When protokoll encounters an unknown person or project, it now provides rich context about the file being processed, making it easier to make informed decisions.
+
+## Before (Old Output)
+```
+────────────────────────────────────────────────────────────
+[Unknown Person Detected]
+Name heard: "Trey Toulson"
+Context: Name heard: "Trey Toulson"
+────────────────────────────────────────────────────────────
+
+Is the name spelled correctly? (Enter to accept, or type correction): 
+```
+
+**Problem:** No file context, duplicate information, unclear what recording this is from.
+
+## After (New Output)
+```
+────────────────────────────────────────────────────────────
+[Unknown Person Detected]
+Name heard: "Trey Toulson"
+
+File: meeting-notes-2026-01-15.m4a
+Date: Wed, Jan 15, 2026, 07:10 AM
+
+Unknown person mentioned: "Trey Toulson"
+
+Context from transcript:
+"I had a really productive meeting with Trey Toulson yesterday. 
+He's the new VP of Engineering at Acme Corp and is interested 
+in collaborating on the Phoenix Initiative."
+────────────────────────────────────────────────────────────
+
+Is the name spelled correctly? (Enter to accept, or type correction): 
+```
+
+**Benefits:**
+- **File context:** See which recording this person was mentioned in
+- **Date/time:** Know when the recording was made
+- **Transcript excerpt:** See the sentences around where the name appears
+- **Clear formatting:** Better visual hierarchy and no duplication
+
+Now you can immediately see that Trey is the VP of Engineering at Acme Corp!
+
+## Project/Term Detection
+
+Similar improvements for unknown projects:
+
+```
+────────────────────────────────────────────────────────────
+[Unknown Project/Term]
+Term: "Phoenix Initiative"
+
+File: status-update-2026-01-15.m4a
+Date: Wed, Jan 15, 2026, 02:30 PM
+
+Unknown project/term: "Phoenix Initiative"
+
+Context from transcript:
+"We're making great progress on the Phoenix Initiative. The team 
+has completed the initial architecture design and we're ready to 
+start implementation next week."
+────────────────────────────────────────────────────────────
+
+Is this a Project or a Term? (P/T, or Enter to skip):
+```
+
+You can immediately see this is an active project with progress updates!
+
+## Implementation Details
+
+The improvements were made to:
+- `src/agentic/tools/lookup-person.ts` - Added file metadata and transcript context extraction
+- `src/agentic/tools/lookup-project.ts` - Added file metadata and transcript context extraction
+- `src/interactive/handler.ts` - Enhanced display formatting in wizard prompts
+
+The `ToolContext` interface already provided:
+- `sourceFile: string` - Full path to the audio file
+- `audioDate: Date` - Recording creation date
+- `transcriptText: string` - The full transcript being processed
+
+### Transcript Context Extraction
+
+The tools now include intelligent context extraction that:
+1. **Finds the mention:** Searches for the name/term in the transcript (case-insensitive)
+2. **Extracts surrounding text:** Captures approximately one sentence before and after
+3. **Limits length:** Keeps context under ~300 characters to avoid overwhelming the prompt
+4. **Handles edge cases:** Gracefully handles missing mentions or very long sentences
+
+This gives you immediate understanding of who someone is or what a project involves, right from the prompt!

package/docs/package-lock.json

@@ -49,6 +49,7 @@
             "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==",
             "dev": true,
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "@babel/code-frame": "^7.27.1",
                 "@babel/generator": "^7.28.5",
@@ -1214,6 +1215,7 @@
             "integrity": "sha512-cisd7gxkzjBKU2GgdYrTdtQx1SORymWyaAFhaxQPK9bYO9ot3Y5OikQRvY0VYQtvwjeQnizCINJAenh/V7MK2w==",
             "dev": true,
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "@types/prop-types": "*",
                 "csstype": "^3.2.2"
@@ -1280,6 +1282,7 @@
                 }
             ],
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "baseline-browser-mapping": "^2.9.0",
                 "caniuse-lite": "^1.0.30001759",
@@ -1549,6 +1552,7 @@
             "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
             "dev": true,
             "license": "MIT",
+            "peer": true,
             "engines": {
                 "node": ">=12"
             },
@@ -1590,6 +1594,7 @@
             "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
             "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "loose-envify": "^1.1.0"
             },
@@ -1748,6 +1753,7 @@
             "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==",
             "dev": true,
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "esbuild": "^0.27.0",
                 "fdir": "^6.5.0",

package/docs/package.json

@@ -7,7 +7,9 @@
     "scripts": {
         "dev": "vite",
         "build": "vite build && cp dist/index.html dist/404.html",
-        "preview": "vite preview"
+        "preview": "vite preview",
+        "lint": "true",
+        "test": "true"
     },
     "dependencies": {
         "react": "^18.2.0",

package/eslint.config.mjs

@@ -71,7 +71,7 @@ export default defineConfig([
             "no-console": ["error"],
 
             "no-restricted-imports": ["error", {
-                paths: ["dayjs", "fs", "moment-timezone"],
+                paths: ["dayjs", "fs", "node:fs", "moment-timezone"],
                 patterns: [
                     {
                         group: ["src/**"],