crewly 1.0.7 → 1.0.8

package/dist/cli/backend/src/types/sop.types.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Standard Operating Procedure (SOP) Type Definitions
+ *
+ * Types for defining, storing, and matching SOPs that guide
+ * agent behavior with standardized procedures.
+ *
+ * @module types/sop.types
+ */
+/**
+ * Roles that can have associated SOPs
+ */
+export type SOPRole = 'orchestrator' | 'pm' | 'tpm' | 'pgm' | 'developer' | 'frontend-developer' | 'backend-developer' | 'qa' | 'tester' | 'designer' | 'devops';
+/**
+ * Categories of SOPs
+ */
+export type SOPCategory = 'workflow' | 'quality' | 'communication' | 'escalation' | 'tools' | 'debugging' | 'testing' | 'git' | 'security';
+/**
+ * Condition operator for SOP activation
+ */
+export type SOPConditionOperator = 'equals' | 'contains' | 'matches';
+/**
+ * Condition type for SOP activation
+ */
+export type SOPConditionType = 'task-type' | 'file-pattern' | 'project-type' | 'custom';
+/**
+ * Condition for SOP activation
+ */
+export interface SOPCondition {
+    /** Type of condition */
+    type: SOPConditionType;
+    /** Value to check against */
+    value: string;
+    /** Comparison operator */
+    operator: SOPConditionOperator;
+}
+/**
+ * Example demonstrating correct SOP usage
+ */
+export interface SOPExample {
+    /** Example title */
+    title: string;
+    /** Scenario description */
+    scenario: string;
+    /** How to correctly handle this scenario */
+    correctApproach: string;
+    /** How NOT to handle this scenario */
+    incorrectApproach?: string;
+}
+/**
+ * Complete SOP definition
+ */
+export interface SOP {
+    /** Unique SOP identifier */
+    id: string;
+    /** Version number (increments on updates) */
+    version: number;
+    /** ISO timestamp of creation */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Creator: 'system' or agentId */
+    createdBy: string;
+    /** Role this SOP applies to, or 'all' for universal */
+    role: SOPRole | 'all';
+    /** Category of the SOP */
+    category: SOPCategory;
+    /** Priority (higher = more important) */
+    priority: number;
+    /** Short title */
+    title: string;
+    /** Brief description */
+    description: string;
+    /** Full SOP content in Markdown */
+    content: string;
+    /** Keywords that trigger this SOP */
+    triggers: string[];
+    /** Optional conditions for activation */
+    conditions?: SOPCondition[];
+    /** Categorization tags */
+    tags: string[];
+    /** IDs of related SOPs */
+    relatedSOPs?: string[];
+    /** Usage examples */
+    examples?: SOPExample[];
+}
+/**
+ * Entry in the SOP index for fast lookup
+ */
+export interface SOPIndexEntry {
+    /** SOP identifier */
+    id: string;
+    /** Relative path to the SOP file */
+    path: string;
+    /** Role this SOP applies to */
+    role: SOPRole | 'all';
+    /** Category of the SOP */
+    category: SOPCategory;
+    /** Priority (higher = more important) */
+    priority: number;
+    /** Keywords that trigger this SOP */
+    triggers: string[];
+    /** Short title */
+    title: string;
+    /** Whether this is a system SOP (true) or custom (false) */
+    isSystem: boolean;
+}
+/**
+ * Complete SOP index
+ */
+export interface SOPIndex {
+    /** Index format version */
+    version: string;
+    /** ISO timestamp of last update */
+    lastUpdated: string;
+    /** All indexed SOPs */
+    sops: SOPIndexEntry[];
+}
+/**
+ * Parameters for finding relevant SOPs
+ */
+export interface SOPMatchParams {
+    /** Agent role */
+    role: string;
+    /** Current task context */
+    taskContext: string;
+    /** Type of task being performed */
+    taskType?: string;
+    /** File patterns involved */
+    filePatterns?: string[];
+    /** Maximum number of SOPs to return */
+    limit?: number;
+}
+/**
+ * Interface for SOP matching logic
+ */
+export interface ISOPMatcher {
+    /**
+     * Find SOPs relevant to the given context
+     *
+     * @param params - Match parameters
+     * @returns Array of matching SOPs, sorted by relevance
+     */
+    findRelevant(params: SOPMatchParams): Promise<SOP[]>;
+    /**
+     * Score how relevant an SOP is to the given context
+     *
+     * @param sop - SOP index entry to score
+     * @param context - Context string
+     * @returns Relevance score (0-1)
+     */
+    scoreRelevance(sop: SOPIndexEntry, context: string): number;
+}
+/**
+ * SOP file frontmatter (YAML header)
+ */
+export interface SOPFrontmatter {
+    id: string;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    role: SOPRole | 'all';
+    category: SOPCategory;
+    priority: number;
+    title: string;
+    description: string;
+    triggers: string[];
+    conditions?: SOPCondition[];
+    tags: string[];
+    relatedSOPs?: string[];
+}
+/**
+ * Result of parsing an SOP file
+ */
+export interface ParsedSOP {
+    /** Parsed frontmatter */
+    frontmatter: SOPFrontmatter;
+    /** Markdown content (without frontmatter) */
+    content: string;
+    /** Parsed examples (if present) */
+    examples?: SOPExample[];
+}
+/**
+ * SOP constants
+ */
+export declare const SOP_CONSTANTS: {
+    /** Directory names */
+    readonly PATHS: {
+        readonly SOP_DIR: "sops";
+        readonly SYSTEM_SOP_DIR: "system";
+        readonly CUSTOM_SOP_DIR: "custom";
+        readonly INDEX_FILE: "index.json";
+    };
+    /** Limits */
+    readonly LIMITS: {
+        readonly MAX_SOPS_IN_PROMPT: 5;
+        readonly MAX_SOP_CONTENT_LENGTH: 2000;
+        readonly MAX_TRIGGERS_PER_SOP: 20;
+        readonly MAX_CONDITIONS_PER_SOP: 10;
+        readonly MAX_EXAMPLES_PER_SOP: 5;
+    };
+    /** Matching configuration */
+    readonly MATCHING: {
+        readonly MIN_TRIGGER_MATCH_SCORE: 0.3;
+        readonly DEFAULT_PRIORITY: 5;
+        readonly ROLE_MATCH_BOOST: 0.3;
+        readonly CATEGORY_MATCH_BOOST: 0.2;
+    };
+    /** Index version */
+    readonly INDEX_VERSION: "1.0";
+};
+/**
+ * Default SOP categories organized by role
+ */
+export declare const DEFAULT_SOP_CATEGORIES: Record<SOPRole | 'all', SOPCategory[]>;
+/**
+ * All valid SOP roles
+ */
+export declare const ALL_SOP_ROLES: SOPRole[];
+/**
+ * All valid SOP categories
+ */
+export declare const ALL_SOP_CATEGORIES: SOPCategory[];
+//# sourceMappingURL=sop.types.d.ts.map

package/dist/cli/backend/src/types/sop.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop.types.d.ts","sourceRoot":"","sources":["../../../../../backend/src/types/sop.types.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/types/sop.types.js

@@ -0,0 +1,85 @@
+/**
+ * Standard Operating Procedure (SOP) Type Definitions
+ *
+ * Types for defining, storing, and matching SOPs that guide
+ * agent behavior with standardized procedures.
+ *
+ * @module types/sop.types
+ */
+/**
+ * SOP constants
+ */
+export const SOP_CONSTANTS = {
+    /** Directory names */
+    PATHS: {
+        SOP_DIR: 'sops',
+        SYSTEM_SOP_DIR: 'system',
+        CUSTOM_SOP_DIR: 'custom',
+        INDEX_FILE: 'index.json',
+    },
+    /** Limits */
+    LIMITS: {
+        MAX_SOPS_IN_PROMPT: 5,
+        MAX_SOP_CONTENT_LENGTH: 2000,
+        MAX_TRIGGERS_PER_SOP: 20,
+        MAX_CONDITIONS_PER_SOP: 10,
+        MAX_EXAMPLES_PER_SOP: 5,
+    },
+    /** Matching configuration */
+    MATCHING: {
+        MIN_TRIGGER_MATCH_SCORE: 0.3,
+        DEFAULT_PRIORITY: 5,
+        ROLE_MATCH_BOOST: 0.3,
+        CATEGORY_MATCH_BOOST: 0.2,
+    },
+    /** Index version */
+    INDEX_VERSION: '1.0',
+};
+/**
+ * Default SOP categories organized by role
+ */
+export const DEFAULT_SOP_CATEGORIES = {
+    all: ['communication', 'escalation', 'security'],
+    orchestrator: ['workflow', 'communication', 'escalation'],
+    pm: ['workflow', 'communication', 'quality'],
+    tpm: ['workflow', 'communication', 'quality'],
+    pgm: ['workflow', 'communication', 'quality'],
+    developer: ['workflow', 'quality', 'git', 'testing', 'debugging'],
+    'frontend-developer': ['workflow', 'quality', 'git', 'testing', 'debugging'],
+    'backend-developer': ['workflow', 'quality', 'git', 'testing', 'debugging', 'security'],
+    qa: ['testing', 'quality', 'debugging', 'communication'],
+    tester: ['testing', 'quality', 'debugging', 'communication'],
+    designer: ['workflow', 'communication', 'tools'],
+    devops: ['workflow', 'security', 'tools', 'debugging'],
+};
+/**
+ * All valid SOP roles
+ */
+export const ALL_SOP_ROLES = [
+    'orchestrator',
+    'pm',
+    'tpm',
+    'pgm',
+    'developer',
+    'frontend-developer',
+    'backend-developer',
+    'qa',
+    'tester',
+    'designer',
+    'devops',
+];
+/**
+ * All valid SOP categories
+ */
+export const ALL_SOP_CATEGORIES = [
+    'workflow',
+    'quality',
+    'communication',
+    'escalation',
+    'tools',
+    'debugging',
+    'testing',
+    'git',
+    'security',
+];
+//# sourceMappingURL=sop.types.js.map

package/dist/cli/backend/src/types/sop.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop.types.js","sourceRoot":"","sources":["../../../../../backend/src/types/sop.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2NH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,sBAAsB;IACtB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,QAAQ;QACxB,cAAc,EAAE,QAAQ;QACxB,UAAU,EAAE,YAAY;KACzB;IAED,aAAa;IACb,MAAM,EAAE;QACN,kBAAkB,EAAE,CAAC;QACrB,sBAAsB,EAAE,IAAI;QAC5B,oBAAoB,EAAE,EAAE;QACxB,sBAAsB,EAAE,EAAE;QAC1B,oBAAoB,EAAE,CAAC;KACxB;IAED,6BAA6B;IAC7B,QAAQ,EAAE;QACR,uBAAuB,EAAE,GAAG;QAC5B,gBAAgB,EAAE,CAAC;QACnB,gBAAgB,EAAE,GAAG;QACrB,oBAAoB,EAAE,GAAG;KAC1B;IAED,oBAAoB;IACpB,aAAa,EAAE,KAAK;CACZ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2C;IAC5E,GAAG,EAAE,CAAC,eAAe,EAAE,YAAY,EAAE,UAAU,CAAC;IAChD,YAAY,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,YAAY,CAAC;IACzD,EAAE,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,CAAC;IAC5C,GAAG,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,CAAC;IAC7C,GAAG,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,CAAC;IAC7C,SAAS,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC;IACjE,oBAAoB,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC;IAC5E,mBAAmB,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC;IACvF,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,CAAC;IACxD,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,CAAC;IAC5D,QAAQ,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC;IAChD,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,cAAc;IACd,IAAI;IACJ,KAAK;IACL,KAAK;IACL,WAAW;IACX,oBAAoB;IACpB,mBAAmB;IACnB,IAAI;IACJ,QAAQ;IACR,UAAU;IACV,QAAQ;CACT,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAkB;IAC/C,UAAU;IACV,SAAS;IACT,eAAe;IACf,YAAY;IACZ,OAAO;IACP,WAAW;IACX,SAAS;IACT,KAAK;IACL,UAAU;CACX,CAAC"}

package/dist/cli/backend/src/types/task-output.types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Task Output Type Definitions
+ *
+ * Types for structured task output with JSON Schema validation.
+ * Enables agents to produce validated, structured deliverables
+ * when completing tasks.
+ *
+ * @module types/task-output.types
+ */
+/**
+ * JSON Schema definition for validating task output.
+ * Uses a subset of JSON Schema Draft 7 compatible with ajv.
+ */
+export interface TaskOutputSchema {
+    /** JSON Schema type (typically 'object') */
+    type: string;
+    /** Property definitions for the output */
+    properties?: Record<string, Record<string, unknown>>;
+    /** List of required property names */
+    required?: string[];
+    /** Whether additional properties are allowed */
+    additionalProperties?: boolean;
+    /** Human-readable description of the expected output */
+    description?: string;
+}
+/**
+ * Result of validating task output against its schema
+ */
+export interface TaskOutputValidationResult {
+    /** Whether the output passed validation */
+    valid: boolean;
+    /** Validation error messages (empty if valid) */
+    errors: string[];
+    /** The validated output data (only set if valid) */
+    data?: TaskOutputData;
+}
+/**
+ * Structured output data from a completed task
+ */
+export interface TaskOutputData {
+    /** The validated output object */
+    output: Record<string, unknown>;
+    /** ISO timestamp of when the output was produced */
+    producedAt: string;
+    /** Session name of the agent that produced the output */
+    sessionName: string;
+}
+/**
+ * Retry tracking information embedded in task markdown
+ */
+export interface TaskOutputRetryInfo {
+    /** Number of validation attempts so far */
+    retryCount: number;
+    /** Maximum allowed retries */
+    maxRetries: number;
+    /** Error messages from the last failed validation */
+    lastErrors: string[];
+    /** ISO timestamp of the last retry attempt */
+    lastAttemptAt: string;
+}
+/**
+ * Constants for task output validation
+ */
+export declare const TASK_OUTPUT_CONSTANTS: {
+    /** Maximum number of validation retries before blocking the task */
+    readonly MAX_RETRIES: 2;
+    /** Maximum output size in bytes (1MB) */
+    readonly MAX_OUTPUT_SIZE_BYTES: 1048576;
+    /** Markdown section headers used in task files */
+    readonly SECTION_HEADERS: {
+        readonly OUTPUT_SCHEMA: "## Output Schema";
+        readonly RETRY_INFO: "## Output Validation Retry Info";
+        readonly VALIDATION_FAILURE: "## Validation Failure";
+    };
+    /** File extension for stored output files */
+    readonly OUTPUT_FILE_EXTENSION: ".output.json";
+};
+//# sourceMappingURL=task-output.types.d.ts.map

package/dist/cli/backend/src/types/task-output.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.types.d.ts","sourceRoot":"","sources":["../../../../../backend/src/types/task-output.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,oEAAoE;;IAEpE,yCAAyC;;IAEzC,kDAAkD;;;;;;IAMlD,6CAA6C;;CAErC,CAAC"}

package/dist/cli/backend/src/types/task-output.types.js

@@ -0,0 +1,27 @@
+/**
+ * Task Output Type Definitions
+ *
+ * Types for structured task output with JSON Schema validation.
+ * Enables agents to produce validated, structured deliverables
+ * when completing tasks.
+ *
+ * @module types/task-output.types
+ */
+/**
+ * Constants for task output validation
+ */
+export const TASK_OUTPUT_CONSTANTS = {
+    /** Maximum number of validation retries before blocking the task */
+    MAX_RETRIES: 2,
+    /** Maximum output size in bytes (1MB) */
+    MAX_OUTPUT_SIZE_BYTES: 1_048_576,
+    /** Markdown section headers used in task files */
+    SECTION_HEADERS: {
+        OUTPUT_SCHEMA: '## Output Schema',
+        RETRY_INFO: '## Output Validation Retry Info',
+        VALIDATION_FAILURE: '## Validation Failure',
+    },
+    /** File extension for stored output files */
+    OUTPUT_FILE_EXTENSION: '.output.json',
+};
+//# sourceMappingURL=task-output.types.js.map

package/dist/cli/backend/src/types/task-output.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.types.js","sourceRoot":"","sources":["../../../../../backend/src/types/task-output.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyDH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,oEAAoE;IACpE,WAAW,EAAE,CAAC;IACd,yCAAyC;IACzC,qBAAqB,EAAE,SAAS;IAChC,kDAAkD;IAClD,eAAe,EAAE;QACf,aAAa,EAAE,kBAAkB;QACjC,UAAU,EAAE,iCAAiC;QAC7C,kBAAkB,EAAE,uBAAuB;KAC5C;IACD,6CAA6C;IAC7C,qBAAqB,EAAE,cAAc;CAC7B,CAAC"}

package/dist/cli/backend/src/utils/file-io.utils.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Centralized Atomic File I/O Utilities
+ *
+ * Provides safe, atomic file operations for all JSON persistence in Crewly.
+ * Uses temp-file + fsync + rename to prevent corruption on crash,
+ * and in-process locks to serialize concurrent writes to the same file.
+ *
+ * @module utils/file-io.utils
+ */
+/**
+ * Minimal logger interface accepted by safeReadJson / modifyJsonFile.
+ * Compatible with ComponentLogger from LoggerService.
+ */
+export interface FileIOLogger {
+    warn(message: string, meta?: Record<string, unknown>): void;
+    debug?(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Ensures a directory exists, creating it recursively if necessary.
+ *
+ * @param dirPath - Absolute path to the directory
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Serialize concurrent writes to the same file.
+ *
+ * @param lockKey - Unique key for the lock (typically the file path)
+ * @param operation - Async operation to run while holding the lock
+ * @returns The result of the operation
+ */
+export declare function withFileLock<T>(lockKey: string, operation: () => Promise<T>): Promise<T>;
+/**
+ * Serialize read-modify-write cycles on a logical resource.
+ *
+ * Uses a separate lock map from {@link withFileLock} so that callers
+ * can hold an operation lock across a read + write without deadlocking
+ * on the inner file lock.
+ *
+ * @param lockKey - Unique key for the lock
+ * @param operation - Async operation to run while holding the lock
+ * @returns The result of the operation
+ */
+export declare function withOperationLock<T>(lockKey: string, operation: () => Promise<T>): Promise<T>;
+/**
+ * Write a string to a file atomically (temp file → fsync → rename).
+ *
+ * Acquires a per-path file lock so concurrent callers targeting the
+ * same path are serialized.
+ *
+ * **Precondition:** The parent directory must already exist. This function
+ * does not create intermediate directories — use {@link ensureDir} first
+ * if the directory may not exist.
+ *
+ * @param filePath - Destination file path
+ * @param content - String content to write
+ */
+export declare function atomicWriteFile(filePath: string, content: string): Promise<void>;
+/**
+ * Serialize a JavaScript value to JSON and write it atomically.
+ *
+ * @param filePath - Destination file path
+ * @param data - Value to serialize (via `JSON.stringify`)
+ */
+export declare function atomicWriteJson<T>(filePath: string, data: T): Promise<void>;
+/**
+ * Read and parse a JSON file safely.
+ *
+ * - On `ENOENT` → returns `defaultValue` silently.
+ * - On parse error → backs up the corrupt file as `<path>.corrupt.<ts>`
+ *   and returns `defaultValue`.
+ *
+ * @param filePath - Path to the JSON file
+ * @param defaultValue - Value to return when the file is missing or corrupt
+ * @param logger - Optional logger for warnings on corruption
+ * @returns Parsed value or `defaultValue`
+ */
+export declare function safeReadJson<T>(filePath: string, defaultValue: T, logger?: FileIOLogger): Promise<T>;
+/**
+ * Locked read → mutate → atomic write cycle.
+ *
+ * This is the most common persistence pattern: load a JSON file,
+ * apply a mutation, and write it back atomically — all while holding
+ * an operation lock to prevent concurrent read-modify-write races.
+ *
+ * **Important:** If the mutator returns `undefined` (void), the mutated
+ * `data` object is written back. If it returns any other value — including
+ * falsy values like `null`, `0`, or `false` — that value is written instead.
+ * Beware of methods like `Array.push()` which return a number: an accidental
+ * `return records.push(item)` will write the array length to the file.
+ *
+ * @param filePath - Path to the JSON file
+ * @param defaultValue - Value to use if the file is missing or corrupt
+ * @param mutator - Function that receives the current data and mutates it in place (or returns new data)
+ * @param logger - Optional logger
+ * @returns The value returned by `mutator` (or void)
+ */
+export declare function modifyJsonFile<T, R = void>(filePath: string, defaultValue: T, mutator: (data: T) => R | Promise<R>, logger?: FileIOLogger): Promise<R>;
+/**
+ * Reset all lock maps. **Test-only** — never call in production.
+ */
+export declare function _clearAllLocks(): void;
+//# sourceMappingURL=file-io.utils.d.ts.map

package/dist/cli/backend/src/utils/file-io.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-io.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/file-io.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/D;AAaD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAuCD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEnG;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBtF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAyB1G;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAC9C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACpC,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAMD;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}