pm-orchestrator-runner 1.0.0

package/dist/locks/lock-manager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Lock Manager
+ * Based on 04_COMPONENTS.md L178-201
+ *
+ * Responsible for:
+ * - Lock acquisition and release
+ * - Deadlock detection
+ * - Lock ordering (sorted acquisition)
+ * - Global semaphore management (max 4 executors)
+ *
+ * IMPORTANT: expires_at is INFORMATIONAL ONLY
+ * Auto-release based on expires_at is forbidden (E405)
+ */
+import { FileLock } from '../models/file-lock';
+import { LockType } from '../models/enums';
+import { ErrorCode } from '../errors/error-codes';
+/**
+ * Lock Manager Error
+ */
+export declare class LockManagerError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: ErrorCode, message?: string, details?: Record<string, unknown>);
+}
+/**
+ * Wait graph entry for deadlock detection
+ */
+interface WaitGraphEntry {
+    executor_id: string;
+    holds: string[];
+    wants: string[];
+}
+/**
+ * Lock Manager class
+ */
+export declare class LockManager {
+    private readonly baseDir;
+    private readonly locks;
+    private readonly fileLocks;
+    private readonly executorSemaphores;
+    private readonly maxExecutors;
+    /**
+     * Create a new LockManager
+     * @param baseDir Base directory for lock storage
+     */
+    constructor(baseDir: string);
+    /**
+     * Acquire a lock on a file
+     * @throws LockManagerError with E401 if lock cannot be acquired
+     */
+    acquireLock(filePath: string, executorId: string, lockType: LockType): FileLock;
+    /**
+     * Release a lock
+     * @throws LockManagerError with E402 if lock not found
+     */
+    releaseLock(lockId: string): void;
+    /**
+     * Acquire multiple locks in sorted order (to prevent deadlocks)
+     */
+    acquireMultipleLocks(files: string[], executorId: string, lockType: LockType): FileLock[];
+    /**
+     * Acquire global semaphore for an executor
+     * @throws LockManagerError with E404 if executor limit exceeded
+     */
+    acquireGlobalSemaphore(executorId: string): boolean;
+    /**
+     * Release global semaphore for an executor
+     */
+    releaseGlobalSemaphore(executorId: string): void;
+    /**
+     * Detect deadlock from wait graph
+     * Uses cycle detection in the wait-for graph
+     */
+    detectDeadlock(waitGraph: WaitGraphEntry[]): boolean;
+    /**
+     * Acquire lock with deadlock check
+     * @throws LockManagerError with E403 if deadlock would occur
+     */
+    acquireLockWithDeadlockCheck(filePath: string, executorId: string, lockType: LockType, holdingFiles: string[]): FileLock;
+    /**
+     * Update lock expiry (informational only)
+     */
+    updateLockExpiry(lockId: string, newExpiry: string): void;
+    /**
+     * Get a lock by ID
+     */
+    getLock(lockId: string): FileLock | undefined;
+    /**
+     * Get lock age in milliseconds
+     */
+    getLockAge(lockId: string): number;
+    /**
+     * Auto-release expired locks - FORBIDDEN
+     * expires_at is INFORMATIONAL ONLY
+     * @throws LockManagerError with E405 always
+     */
+    autoReleaseExpiredLocks(): void;
+    /**
+     * Get all active locks
+     */
+    getActiveLocks(): FileLock[];
+    /**
+     * Get locks by executor
+     */
+    getLocksByExecutor(executorId: string): FileLock[];
+    /**
+     * Get locks by file
+     */
+    getLocksByFile(filePath: string): FileLock[];
+    /**
+     * Check if a file is locked
+     */
+    isFileLocked(filePath: string): boolean;
+}
+export {};
+//# sourceMappingURL=lock-manager.d.ts.map

package/dist/locks/lock-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/locks/lock-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAoC,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAmB,MAAM,uBAAuB,CAAC;AAEnE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMjF;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAc;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAE1C;;;OAGG;gBACS,OAAO,EAAE,MAAM;IAO3B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAiC/E;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAwBjC;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAwBzF;;;OAGG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAanD;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhD;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO;IAuDpD;;;OAGG;IACH,4BAA4B,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,EAAE,GACrB,QAAQ;IAwCX;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAWzD;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI7C;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAUlC;;;;OAIG;IACH,uBAAuB,IAAI,IAAI;IAe/B;;OAEG;IACH,cAAc,IAAI,QAAQ,EAAE;IAI5B;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMlD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAW5C;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAIxC"}

package/dist/locks/lock-manager.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * Lock Manager
+ * Based on 04_COMPONENTS.md L178-201
+ *
+ * Responsible for:
+ * - Lock acquisition and release
+ * - Deadlock detection
+ * - Lock ordering (sorted acquisition)
+ * - Global semaphore management (max 4 executors)
+ *
+ * IMPORTANT: expires_at is INFORMATIONAL ONLY
+ * Auto-release based on expires_at is forbidden (E405)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LockManager = exports.LockManagerError = void 0;
+const file_lock_1 = require("../models/file-lock");
+const error_codes_1 = require("../errors/error-codes");
+/**
+ * Lock Manager Error
+ */
+class LockManagerError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message || (0, error_codes_1.getErrorMessage)(code));
+        this.name = 'LockManagerError';
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.LockManagerError = LockManagerError;
+/**
+ * Lock Manager class
+ */
+class LockManager {
+    baseDir;
+    locks;
+    fileLocks; // file_path -> Set<lock_id>
+    executorSemaphores;
+    maxExecutors = 4;
+    /**
+     * Create a new LockManager
+     * @param baseDir Base directory for lock storage
+     */
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        this.locks = new Map();
+        this.fileLocks = new Map();
+        this.executorSemaphores = new Set();
+    }
+    /**
+     * Acquire a lock on a file
+     * @throws LockManagerError with E401 if lock cannot be acquired
+     */
+    acquireLock(filePath, executorId, lockType) {
+        // Check existing locks on this file
+        const existingLockIds = this.fileLocks.get(filePath);
+        if (existingLockIds && existingLockIds.size > 0) {
+            // Check if any existing lock conflicts
+            for (const lockId of existingLockIds) {
+                const existingLock = this.locks.get(lockId);
+                if (existingLock && !(0, file_lock_1.isLockCompatible)(existingLock, lockType)) {
+                    throw new LockManagerError(error_codes_1.ErrorCode.E401_LOCK_ACQUISITION_FAILURE, `Cannot acquire ${lockType} lock on ${filePath}: conflicting lock exists`, { filePath, executorId, lockType, conflictingLockId: lockId });
+                }
+            }
+        }
+        // Create the lock
+        const lock = (0, file_lock_1.createFileLock)(filePath, executorId, lockType);
+        // Store the lock
+        this.locks.set(lock.lock_id, lock);
+        // Track file -> locks mapping
+        if (!this.fileLocks.has(filePath)) {
+            this.fileLocks.set(filePath, new Set());
+        }
+        this.fileLocks.get(filePath).add(lock.lock_id);
+        return lock;
+    }
+    /**
+     * Release a lock
+     * @throws LockManagerError with E402 if lock not found
+     */
+    releaseLock(lockId) {
+        const lock = this.locks.get(lockId);
+        if (!lock) {
+            throw new LockManagerError(error_codes_1.ErrorCode.E402_LOCK_RELEASE_FAILURE, `Lock not found: ${lockId}`, { lockId });
+        }
+        // Remove from file -> locks mapping
+        const fileLockIds = this.fileLocks.get(lock.file_path);
+        if (fileLockIds) {
+            fileLockIds.delete(lockId);
+            if (fileLockIds.size === 0) {
+                this.fileLocks.delete(lock.file_path);
+            }
+        }
+        // Remove the lock
+        this.locks.delete(lockId);
+    }
+    /**
+     * Acquire multiple locks in sorted order (to prevent deadlocks)
+     */
+    acquireMultipleLocks(files, executorId, lockType) {
+        // Sort files to ensure consistent lock acquisition order
+        const sortedFiles = [...files].sort();
+        const acquiredLocks = [];
+        try {
+            for (const filePath of sortedFiles) {
+                const lock = this.acquireLock(filePath, executorId, lockType);
+                acquiredLocks.push(lock);
+            }
+            return acquiredLocks;
+        }
+        catch (error) {
+            // Rollback: release all acquired locks in reverse order
+            for (const lock of acquiredLocks.reverse()) {
+                try {
+                    this.releaseLock(lock.lock_id);
+                }
+                catch {
+                    // Ignore release errors during rollback
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Acquire global semaphore for an executor
+     * @throws LockManagerError with E404 if executor limit exceeded
+     */
+    acquireGlobalSemaphore(executorId) {
+        if (this.executorSemaphores.size >= this.maxExecutors) {
+            throw new LockManagerError(error_codes_1.ErrorCode.E404_EXECUTOR_LIMIT_EXCEEDED, `Executor limit exceeded: max ${this.maxExecutors} executors allowed`, { executorId, currentCount: this.executorSemaphores.size });
+        }
+        this.executorSemaphores.add(executorId);
+        return true;
+    }
+    /**
+     * Release global semaphore for an executor
+     */
+    releaseGlobalSemaphore(executorId) {
+        this.executorSemaphores.delete(executorId);
+    }
+    /**
+     * Detect deadlock from wait graph
+     * Uses cycle detection in the wait-for graph
+     */
+    detectDeadlock(waitGraph) {
+        // Build adjacency list: executor -> set of executors it's waiting for
+        const adjacencyList = new Map();
+        // Initialize all executors
+        for (const entry of waitGraph) {
+            adjacencyList.set(entry.executor_id, new Set());
+        }
+        // Build the wait-for graph
+        for (const entry of waitGraph) {
+            for (const wantedFile of entry.wants) {
+                // Find who holds this file
+                for (const other of waitGraph) {
+                    if (other.executor_id !== entry.executor_id && other.holds.includes(wantedFile)) {
+                        adjacencyList.get(entry.executor_id).add(other.executor_id);
+                    }
+                }
+            }
+        }
+        // Detect cycle using DFS
+        const visited = new Set();
+        const recursionStack = new Set();
+        const hasCycle = (node) => {
+            visited.add(node);
+            recursionStack.add(node);
+            const neighbors = adjacencyList.get(node) || new Set();
+            for (const neighbor of neighbors) {
+                if (!visited.has(neighbor)) {
+                    if (hasCycle(neighbor)) {
+                        return true;
+                    }
+                }
+                else if (recursionStack.has(neighbor)) {
+                    return true;
+                }
+            }
+            recursionStack.delete(node);
+            return false;
+        };
+        for (const executor of adjacencyList.keys()) {
+            if (!visited.has(executor)) {
+                if (hasCycle(executor)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Acquire lock with deadlock check
+     * @throws LockManagerError with E403 if deadlock would occur
+     */
+    acquireLockWithDeadlockCheck(filePath, executorId, lockType, holdingFiles) {
+        // Check if acquiring this lock would cause a deadlock
+        const existingLockIds = this.fileLocks.get(filePath);
+        if (existingLockIds && existingLockIds.size > 0) {
+            // Get the executor holding the wanted file
+            for (const lockId of existingLockIds) {
+                const existingLock = this.locks.get(lockId);
+                if (existingLock && existingLock.holder_executor_id !== executorId) {
+                    // Check if that executor wants any file we're holding
+                    const otherExecutorId = existingLock.holder_executor_id;
+                    // Check all locks to see if the other executor wants our files
+                    for (const [lId, lock] of this.locks) {
+                        if (lock.holder_executor_id === otherExecutorId) {
+                            // The other executor holds some file, check if they're waiting for our files
+                            // This is a simplified deadlock check - in reality would need more context
+                        }
+                    }
+                    // Build wait graph to check for deadlock
+                    const waitGraph = [
+                        { executor_id: executorId, holds: holdingFiles, wants: [filePath] },
+                        { executor_id: otherExecutorId, holds: [filePath], wants: holdingFiles },
+                    ];
+                    if (this.detectDeadlock(waitGraph)) {
+                        throw new LockManagerError(error_codes_1.ErrorCode.E403_DEADLOCK_DETECTED, `Deadlock detected: ${executorId} waiting for ${filePath} held by ${otherExecutorId}`, { executorId, filePath, otherExecutorId, holdingFiles });
+                    }
+                }
+            }
+        }
+        return this.acquireLock(filePath, executorId, lockType);
+    }
+    /**
+     * Update lock expiry (informational only)
+     */
+    updateLockExpiry(lockId, newExpiry) {
+        const lock = this.locks.get(lockId);
+        if (lock) {
+            const updatedLock = {
+                ...lock,
+                expires_at: newExpiry,
+            };
+            this.locks.set(lockId, updatedLock);
+        }
+    }
+    /**
+     * Get a lock by ID
+     */
+    getLock(lockId) {
+        return this.locks.get(lockId);
+    }
+    /**
+     * Get lock age in milliseconds
+     */
+    getLockAge(lockId) {
+        const lock = this.locks.get(lockId);
+        if (!lock) {
+            return -1;
+        }
+        const acquiredAt = new Date(lock.acquired_at);
+        return Date.now() - acquiredAt.getTime();
+    }
+    /**
+     * Auto-release expired locks - FORBIDDEN
+     * expires_at is INFORMATIONAL ONLY
+     * @throws LockManagerError with E405 always
+     */
+    autoReleaseExpiredLocks() {
+        // Check if there are any expired locks
+        for (const [lockId, lock] of this.locks) {
+            const expiresAt = new Date(lock.expires_at);
+            if (expiresAt < new Date()) {
+                // Auto-release is forbidden
+                throw new LockManagerError(error_codes_1.ErrorCode.E405_RESOURCE_RELEASE_FAILURE, 'Auto-release based on expires_at is forbidden. Locks must be explicitly released.', { lockId, expires_at: lock.expires_at });
+            }
+        }
+    }
+    /**
+     * Get all active locks
+     */
+    getActiveLocks() {
+        return Array.from(this.locks.values());
+    }
+    /**
+     * Get locks by executor
+     */
+    getLocksByExecutor(executorId) {
+        return Array.from(this.locks.values()).filter(lock => lock.holder_executor_id === executorId);
+    }
+    /**
+     * Get locks by file
+     */
+    getLocksByFile(filePath) {
+        const lockIds = this.fileLocks.get(filePath);
+        if (!lockIds) {
+            return [];
+        }
+        return Array.from(lockIds)
+            .map(lockId => this.locks.get(lockId))
+            .filter((lock) => lock !== undefined);
+    }
+    /**
+     * Check if a file is locked
+     */
+    isFileLocked(filePath) {
+        const lockIds = this.fileLocks.get(filePath);
+        return lockIds !== undefined && lockIds.size > 0;
+    }
+}
+exports.LockManager = LockManager;
+//# sourceMappingURL=lock-manager.js.map

package/dist/locks/lock-manager.js.map

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

package/dist/logging/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Logging Module Index
+ *
+ * Per spec 13_LOGGING_AND_OBSERVABILITY.md
+ */
+export { maskSensitiveData, containsSensitiveData, maskSensitiveObject, getApiKeyStatus, checkApiKeyForProvider, MASKING_PATTERNS, } from './sensitive-data-masker';
+export { TaskLogManager, CompleteTaskOptions, LOG_DIR, INDEX_FILE, TASKS_DIR, RAW_DIR, } from './task-log-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,oBAAoB,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Logging Module Index
+ *
+ * Per spec 13_LOGGING_AND_OBSERVABILITY.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAW_DIR = exports.TASKS_DIR = exports.INDEX_FILE = exports.LOG_DIR = exports.TaskLogManager = exports.MASKING_PATTERNS = exports.checkApiKeyForProvider = exports.getApiKeyStatus = exports.maskSensitiveObject = exports.containsSensitiveData = exports.maskSensitiveData = void 0;
+var sensitive_data_masker_1 = require("./sensitive-data-masker");
+Object.defineProperty(exports, "maskSensitiveData", { enumerable: true, get: function () { return sensitive_data_masker_1.maskSensitiveData; } });
+Object.defineProperty(exports, "containsSensitiveData", { enumerable: true, get: function () { return sensitive_data_masker_1.containsSensitiveData; } });
+Object.defineProperty(exports, "maskSensitiveObject", { enumerable: true, get: function () { return sensitive_data_masker_1.maskSensitiveObject; } });
+Object.defineProperty(exports, "getApiKeyStatus", { enumerable: true, get: function () { return sensitive_data_masker_1.getApiKeyStatus; } });
+Object.defineProperty(exports, "checkApiKeyForProvider", { enumerable: true, get: function () { return sensitive_data_masker_1.checkApiKeyForProvider; } });
+Object.defineProperty(exports, "MASKING_PATTERNS", { enumerable: true, get: function () { return sensitive_data_masker_1.MASKING_PATTERNS; } });
+var task_log_manager_1 = require("./task-log-manager");
+Object.defineProperty(exports, "TaskLogManager", { enumerable: true, get: function () { return task_log_manager_1.TaskLogManager; } });
+Object.defineProperty(exports, "LOG_DIR", { enumerable: true, get: function () { return task_log_manager_1.LOG_DIR; } });
+Object.defineProperty(exports, "INDEX_FILE", { enumerable: true, get: function () { return task_log_manager_1.INDEX_FILE; } });
+Object.defineProperty(exports, "TASKS_DIR", { enumerable: true, get: function () { return task_log_manager_1.TASKS_DIR; } });
+Object.defineProperty(exports, "RAW_DIR", { enumerable: true, get: function () { return task_log_manager_1.RAW_DIR; } });
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,iEAOiC;AAN/B,0HAAA,iBAAiB,OAAA;AACjB,8HAAA,qBAAqB,OAAA;AACrB,4HAAA,mBAAmB,OAAA;AACnB,wHAAA,eAAe,OAAA;AACf,+HAAA,sBAAsB,OAAA;AACtB,yHAAA,gBAAgB,OAAA;AAGlB,uDAO4B;AAN1B,kHAAA,cAAc,OAAA;AAEd,2GAAA,OAAO,OAAA;AACP,8GAAA,UAAU,OAAA;AACV,6GAAA,SAAS,OAAA;AACT,2GAAA,OAAO,OAAA"}

package/dist/logging/sensitive-data-masker.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Sensitive Data Masker
+ *
+ * Per spec 13_LOGGING_AND_OBSERVABILITY.md Section 4:
+ * Per spec 06_CORRECTNESS_PROPERTIES.md Property 24/25:
+ *
+ * 11 Masking Patterns across 4 Priority Levels:
+ *
+ * Priority 1 - Critical Secrets:
+ *   1. OpenAI API Key: sk-[A-Za-z0-9]{20,}
+ *   2. Anthropic API Key: sk-ant-[A-Za-z0-9-]{20,}
+ *   3. Private Key blocks: -----BEGIN.*PRIVATE KEY-----
+ *
+ * Priority 2 - Tokens and Auth Headers:
+ *   4. JWT Token: eyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+
+ *   5. Authorization Header: Authorization:\s*\S+
+ *   6. Cookie: Cookie:\s*.+
+ *   7. Set-Cookie: Set-Cookie:\s*.+
+ *
+ * Priority 3 - Credentials:
+ *   8. JSON Credential: "(?:apiKey|password|secret|token)":\s*"[^"]+"
+ *   9. Environment Credential: [A-Z_]+(?:PASSWORD|SECRET|KEY|TOKEN)=[^\s]+
+ *   10. Bearer Token: Bearer\s+[A-Za-z0-9._-]+
+ *
+ * Priority 4 - Generic Secrets:
+ *   11. Generic Secret: (?:password|secret|token)\s*[=:]\s*["']?[^\s"']+
+ */
+/**
+ * Masking pattern definition with priority
+ */
+interface MaskingPattern {
+    name: string;
+    regex: RegExp;
+    mask: string;
+    priority: 1 | 2 | 3 | 4;
+}
+/**
+ * Masking patterns ordered by priority (higher priority first)
+ * Per spec 06_CORRECTNESS_PROPERTIES.md Property 25 Section 3
+ */
+declare const MASKING_PATTERNS: MaskingPattern[];
+/**
+ * Mask sensitive data in a string
+ * Per spec 13_LOGGING_AND_OBSERVABILITY.md Section 4.3
+ *
+ * Patterns are applied in priority order (1 first, then 2, etc.)
+ *
+ * @param content - Content to mask
+ * @returns Masked content
+ */
+export declare function maskSensitiveData(content: string): string;
+/**
+ * Check if content contains sensitive data
+ *
+ * @param content - Content to check
+ * @returns true if sensitive data is detected
+ */
+export declare function containsSensitiveData(content: string): boolean;
+/**
+ * Mask sensitive data in an object (recursive)
+ *
+ * @param obj - Object to mask
+ * @returns Masked object
+ */
+export declare function maskSensitiveObject<T>(obj: T): T;
+/**
+ * Get API key status (SET/NOT SET) without revealing the value
+ * Per spec 06_CORRECTNESS_PROPERTIES.md Property 24
+ *
+ * @param envVar - Environment variable name
+ * @returns 'SET' or 'NOT SET'
+ */
+export declare function getApiKeyStatus(envVar: string): 'SET' | 'NOT SET';
+/**
+ * Check API key availability for a provider
+ *
+ * @param provider - Provider identifier
+ * @returns Object with status and env variable name
+ */
+export declare function checkApiKeyForProvider(provider: string): {
+    required: boolean;
+    envVar: string | null;
+    status: 'SET' | 'NOT SET' | 'NOT_REQUIRED';
+};
+/**
+ * Get list of pattern names by priority
+ */
+export declare function getPatternsByPriority(priority: 1 | 2 | 3 | 4): string[];
+export { MASKING_PATTERNS };
+//# sourceMappingURL=sensitive-data-masker.d.ts.map

package/dist/logging/sensitive-data-masker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive-data-masker.d.ts","sourceRoot":"","sources":["../../src/logging/sensitive-data-masker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;GAEG;AACH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,QAAA,MAAM,gBAAgB,EAAE,cAAc,EA0ErC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBzD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAsBhD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAGjE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,cAAc,CAAC;CAC5C,CAkBA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAIvE;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}