cc-agentic-framework 1.14.1

package/dist/commands/writer/init.js

@@ -0,0 +1,227 @@
+/**
+ * Writer Init Command
+ *
+ * CLI command for initializing a new book project with folder structure.
+ *
+ * Usage:
+ *   agentic-framework writer init --name my-book --title "My Fantasy Epic"
+ *   agentic-framework writer init --name my-book --dry-run
+ *
+ * @module commands/writer/init
+ */
+import { Command } from 'commander';
+import fs from 'fs-extra';
+import path from 'path';
+import { CliContext } from '../../lib/cli-context.js';
+import { recordCLICommand } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+/**
+ * Create the init command.
+ *
+ * @returns Commander command instance
+ */
+export function createInitCommand() {
+    const command = new Command('init');
+    command
+        .description('Initialize a new book project with folder structure')
+        .option('-n, --name <name>', 'Book project name in kebab-case (e.g., "my-fantasy-epic")')
+        .option('-t, --title <title>', 'Book title (e.g., "My Fantasy Epic")')
+        .option('--dry-run', 'Preview what would be created without creating files', false)
+        .option('-p, --path <path>', 'Project root path', '.')
+        .action(async (cmdOptions) => {
+        try {
+            await runInitCommand(cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`\nError: ${errorMessage}\n`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Run the init command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runInitCommand(cmdOptions) {
+    const startTime = Date.now();
+    const { name, title, dryRun, path: pathOption, } = cmdOptions;
+    // Validate required options
+    if (!name) {
+        throw new Error('Book name is required. Use --name <name> to specify it.');
+    }
+    // Validate name format (kebab-case)
+    const namePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+    if (!namePattern.test(name)) {
+        throw new Error('Book name must be kebab-case: lowercase letters, numbers, and hyphens only (no leading/trailing hyphens)');
+    }
+    // Use CliContext for project detection
+    const ctx = pathOption && pathOption !== '.'
+        ? await CliContext.create({ path: pathOption })
+        : await CliContext.require();
+    const projectRoot = ctx.projectRoot;
+    const bookTitle = title || name;
+    const currentDate = new Date().toISOString().split('T')[0];
+    // Define directory structure
+    const dirs = [
+        'manuscript',
+        'characters',
+        'world',
+        'world/rules',
+        'world/regions',
+        'world/nations',
+        'world/magic-systems',
+        'world/history',
+        'build',
+        'build/context',
+        'build/analysis',
+    ];
+    // Create BOOK.md content
+    const bookContent = `---
+title: "${bookTitle}"
+author: ""
+status: planning
+created: ${currentDate}
+word-count: 0
+target-word-count: 100000
+
+# Metadata
+genre: fantasy
+sub-genres: []
+themes: []
+target-audience: ""
+pov-style: "third-person limited"
+tense: "past"
+
+# Structure
+parts: []
+estimated-chapters: 0
+estimated-scenes: 0
+
+# World
+world-complexity: medium
+magic-system: ""
+tech-level: "medieval"
+
+# Project Management
+baseline-locked: false
+version: "0.1.0"
+---
+
+# ${bookTitle}
+
+## Synopsis
+
+[Provide a brief synopsis of your book. What is the core story? Who is the protagonist?
+What is the main conflict? This should be 2-4 paragraphs.]
+
+## Premise
+
+[What is the central premise or "what if" of your story? This is the core idea that
+drives the narrative.]
+
+## Target Audience
+
+[Who is this book for? Age range, interests, comparable titles?]
+
+## Themes
+
+[What are the major themes you want to explore in this book?]
+
+**Primary Themes:**
+- [Theme 1]: [Brief explanation]
+- [Theme 2]: [Brief explanation]
+
+**Secondary Themes:**
+- [Theme 3]: [Brief explanation]
+
+## Story Structure
+
+[How is the book structured? How many parts? What is the overall arc?]
+
+## Writing Goals
+
+[What do you want to achieve with this book?]
+
+**Narrative Goals:**
+- [Goal 1]
+- [Goal 2]
+
+**Personal Goals:**
+- [What do you want to learn or accomplish as a writer?]
+
+## Notes
+
+[Any additional notes about the project, approach, or inspirations.]
+`;
+    // Create world.lock.json content
+    const worldLockContent = {
+        version: '1.0.0',
+        locked: false,
+        baseline: null,
+        facts: {
+            immutable: [],
+            'append-only': [],
+            expandable: [],
+        },
+        hashes: {},
+        lastUpdated: currentDate,
+    };
+    // Dry run: show what would be created
+    if (dryRun) {
+        console.log('\nDRY RUN - No files created\n');
+        console.log('Book Project Details:');
+        console.log(`  Name:  ${name}`);
+        console.log(`  Title: ${bookTitle}`);
+        console.log(`  Root:  ${projectRoot}\n`);
+        console.log('Would create directories:');
+        dirs.forEach(dir => {
+            console.log(`  ✓ ${dir}/`);
+        });
+        console.log('\nWould create files:');
+        console.log(`  ✓ BOOK.md (${bookContent.length} bytes)`);
+        console.log(`  ✓ world.lock.json (${JSON.stringify(worldLockContent, null, 2).length} bytes)`);
+        console.log('\nNext steps:');
+        console.log('  1. Remove --dry-run flag to create project');
+        console.log('  2. Edit BOOK.md to define your book');
+        console.log('  3. Create parts with: agentic-framework writer create-part');
+        return;
+    }
+    // Create directories
+    for (const dir of dirs) {
+        const dirPath = path.join(projectRoot, dir);
+        await fs.ensureDir(dirPath);
+    }
+    // Create BOOK.md
+    const bookPath = path.join(projectRoot, 'BOOK.md');
+    await fs.writeFile(bookPath, bookContent, 'utf-8');
+    // Create world.lock.json
+    const lockPath = path.join(projectRoot, 'world.lock.json');
+    await fs.writeFile(lockPath, JSON.stringify(worldLockContent, null, 2), 'utf-8');
+    // Create .gitkeep files for empty directories
+    const gitkeepDirs = ['world/rules', 'world/regions', 'world/nations', 'world/magic-systems', 'world/history', 'build/context', 'build/analysis'];
+    for (const dir of gitkeepDirs) {
+        const gitkeepPath = path.join(projectRoot, dir, '.gitkeep');
+        await fs.writeFile(gitkeepPath, '', 'utf-8');
+    }
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('writer', 'init', { name, title: bookTitle, dryRun }, { book_name: name, project_root: projectRoot }, durationMs, true).catch(() => { });
+    // Output success
+    console.log('\nBook project initialized successfully!\n');
+    console.log(`Book Name:  ${name}`);
+    console.log(`Book Title: ${bookTitle}\n`);
+    console.log('Created directories:');
+    dirs.forEach(dir => {
+        console.log(`  📁 ${dir}/`);
+    });
+    console.log('\nCreated files:');
+    console.log(`  📄 ${bookPath}`);
+    console.log(`  📄 ${lockPath}\n`);
+    console.log('Next steps:');
+    console.log('  1. Edit BOOK.md to define your book details');
+    console.log('  2. Create your first part: agentic-framework writer create-part --name prologue');
+    console.log('  3. Initialize world baseline: agentic-framework writer init-baseline\n');
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/writer/init.js.map

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

package/dist/commands/writer/lib/immutability-utils.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Immutability validation utilities for writer CLI commands
+ * Inline implementation to avoid cross-package imports
+ */
+/**
+ * Validation error codes
+ */
+export declare enum ValidationErrorCode {
+    IMMUT_001 = "IMMUT-001",// Immutable fact hash mismatch
+    IMMUT_002 = "IMMUT-002",// Append-only original content modified
+    IMMUT_003 = "IMMUT-003",// Append-only additions not logged
+    IMMUT_004 = "IMMUT-004",// Established date changed
+    IMMUT_005 = "IMMUT-005"
+}
+export interface ValidationError {
+    code: ValidationErrorCode;
+    message: string;
+    factId: string;
+    file: string;
+    expectedHash?: string;
+    actualHash?: string;
+}
+export interface ValidationWarning {
+    message: string;
+    factId: string;
+    file: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    factsValidated: number;
+}
+export interface LockEntry {
+    hash: string;
+    established: string;
+    mutability: 'immutable' | 'append-only' | 'expandable';
+    'original-hash'?: string;
+    additions?: {
+        hash: string;
+    }[];
+    expansions?: string[];
+}
+export interface LockFile {
+    version: string;
+    facts: Record<string, LockEntry>;
+}
+/**
+ * Compute SHA256 hash of content
+ */
+export declare function computeHash(content: string): string;
+/**
+ * Read lock file
+ */
+export declare function readLockFile(projectRoot: string): Promise<LockFile | null>;
+/**
+ * Get fact entry from lock file
+ */
+export declare function getFactEntry(projectRoot: string, factId: string): Promise<{
+    entry: LockEntry;
+    mutability: string;
+} | null>;
+/**
+ * Validate a single fact file
+ */
+export declare function validateFactFile(projectRoot: string, filePath: string): Promise<ValidationResult>;
+/**
+ * Validate multiple fact files
+ */
+export declare function validateFactFiles(projectRoot: string, filePaths: string[]): Promise<ValidationResult>;
+/**
+ * Format validation result for display
+ */
+export declare function formatValidationResult(result: ValidationResult): string;
+/**
+ * Validate staged facts for pre-commit hook
+ */
+export declare function validateStagedFacts(projectRoot: string): Promise<{
+    exitCode: number;
+    message: string;
+}>;
+//# sourceMappingURL=immutability-utils.d.ts.map

package/dist/commands/writer/lib/immutability-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutability-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/writer/lib/immutability-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,SAAS,cAAc,CAAE,+BAA+B;IACxD,SAAS,cAAc,CAAE,wCAAwC;IACjE,SAAS,cAAc,CAAE,mCAAmC;IAC5D,SAAS,cAAc,CAAE,2BAA2B;IACpD,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,WAAW,GAAG,aAAa,GAAG,YAAY,CAAC;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAqCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAQhF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAO1D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CA8E3B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkCvE;AAyBD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBhD"}

package/dist/commands/writer/lib/immutability-utils.js

@@ -0,0 +1,253 @@
+/**
+ * Immutability validation utilities for writer CLI commands
+ * Inline implementation to avoid cross-package imports
+ */
+import * as crypto from 'crypto';
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Validation error codes
+ */
+export var ValidationErrorCode;
+(function (ValidationErrorCode) {
+    ValidationErrorCode["IMMUT_001"] = "IMMUT-001";
+    ValidationErrorCode["IMMUT_002"] = "IMMUT-002";
+    ValidationErrorCode["IMMUT_003"] = "IMMUT-003";
+    ValidationErrorCode["IMMUT_004"] = "IMMUT-004";
+    ValidationErrorCode["IMMUT_005"] = "IMMUT-005";
+})(ValidationErrorCode || (ValidationErrorCode = {}));
+/**
+ * Parse YAML frontmatter from markdown content
+ */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match) {
+        return { data: {}, content };
+    }
+    const yamlContent = match[1];
+    const markdownContent = match[2];
+    // Simple YAML parser for frontmatter
+    const data = {};
+    const lines = yamlContent.split('\n');
+    for (const line of lines) {
+        const colonIndex = line.indexOf(':');
+        if (colonIndex > 0) {
+            const key = line.substring(0, colonIndex).trim();
+            let value = line.substring(colonIndex + 1).trim();
+            // Handle quoted strings
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            data[key] = value;
+        }
+    }
+    return { data, content: markdownContent };
+}
+/**
+ * Compute SHA256 hash of content
+ */
+export function computeHash(content) {
+    return crypto.createHash('sha256').update(content, 'utf8').digest('hex');
+}
+/**
+ * Read lock file
+ */
+export async function readLockFile(projectRoot) {
+    const lockPath = path.join(projectRoot, 'world.lock.json');
+    try {
+        const content = await fs.readFile(lockPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get fact entry from lock file
+ */
+export async function getFactEntry(projectRoot, factId) {
+    const lockFile = await readLockFile(projectRoot);
+    if (!lockFile || !lockFile.facts[factId]) {
+        return null;
+    }
+    const entry = lockFile.facts[factId];
+    return { entry, mutability: entry.mutability };
+}
+/**
+ * Validate a single fact file
+ */
+export async function validateFactFile(projectRoot, filePath) {
+    const errors = [];
+    const warnings = [];
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const { data } = parseFrontmatter(content);
+        const factId = data.id;
+        if (!factId) {
+            return {
+                valid: true,
+                errors: [],
+                warnings: [{
+                        message: 'File has no fact ID in frontmatter, skipping validation',
+                        factId: 'unknown',
+                        file: path.relative(projectRoot, filePath),
+                    }],
+                factsValidated: 0,
+            };
+        }
+        const lockEntry = await getFactEntry(projectRoot, factId);
+        if (!lockEntry) {
+            return {
+                valid: true,
+                errors: [],
+                warnings: [{
+                        message: 'Fact not in lock file, skipping validation (run lock-fact to add)',
+                        factId,
+                        file: path.relative(projectRoot, filePath),
+                    }],
+                factsValidated: 0,
+            };
+        }
+        // Validate based on mutability type
+        if (lockEntry.mutability === 'immutable') {
+            // Check established date
+            if (data.established !== lockEntry.entry.established) {
+                errors.push({
+                    code: ValidationErrorCode.IMMUT_004,
+                    message: `Established date cannot be changed for immutable facts`,
+                    factId,
+                    file: path.relative(projectRoot, filePath),
+                });
+            }
+            // Check content hash
+            const currentHash = computeHash(content);
+            if (currentHash !== lockEntry.entry.hash) {
+                errors.push({
+                    code: ValidationErrorCode.IMMUT_001,
+                    message: `Immutable fact has been modified`,
+                    factId,
+                    file: path.relative(projectRoot, filePath),
+                    expectedHash: lockEntry.entry.hash,
+                    actualHash: currentHash,
+                });
+            }
+        }
+        // Add similar checks for append-only and expandable...
+    }
+    catch (error) {
+        errors.push({
+            code: ValidationErrorCode.IMMUT_001,
+            message: `Failed to validate file: ${error instanceof Error ? error.message : String(error)}`,
+            factId: 'unknown',
+            file: path.relative(projectRoot, filePath),
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        factsValidated: errors.length === 0 && warnings.length === 0 ? 1 : 0,
+    };
+}
+/**
+ * Validate multiple fact files
+ */
+export async function validateFactFiles(projectRoot, filePaths) {
+    const allErrors = [];
+    const allWarnings = [];
+    let totalValidated = 0;
+    for (const filePath of filePaths) {
+        const result = await validateFactFile(projectRoot, filePath);
+        allErrors.push(...result.errors);
+        allWarnings.push(...result.warnings);
+        totalValidated += result.factsValidated;
+    }
+    return {
+        valid: allErrors.length === 0,
+        errors: allErrors,
+        warnings: allWarnings,
+        factsValidated: totalValidated,
+    };
+}
+/**
+ * Format validation result for display
+ */
+export function formatValidationResult(result) {
+    const lines = [];
+    if (result.valid) {
+        lines.push(`✓ Validation passed (${result.factsValidated} facts validated)`);
+    }
+    else {
+        lines.push(`✗ Validation failed (${result.errors.length} errors, ${result.warnings.length} warnings)`);
+    }
+    if (result.errors.length > 0) {
+        lines.push('\nErrors:');
+        for (const error of result.errors) {
+            lines.push(`  ${error.code}: ${error.message}`);
+            lines.push(`    Fact: ${error.factId}`);
+            lines.push(`    File: ${error.file}`);
+            if (error.expectedHash && error.actualHash) {
+                lines.push(`    Expected hash: ${error.expectedHash.substring(0, 16)}...`);
+                lines.push(`    Actual hash:   ${error.actualHash.substring(0, 16)}...`);
+            }
+            lines.push('');
+        }
+    }
+    if (result.warnings.length > 0) {
+        lines.push('\nWarnings:');
+        for (const warning of result.warnings) {
+            lines.push(`  ${warning.message}`);
+            lines.push(`    Fact: ${warning.factId}`);
+            lines.push(`    File: ${warning.file}`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Get staged world fact files
+ */
+async function getStagedWorldFacts(projectRoot) {
+    try {
+        const { stdout } = await execAsync('git diff --cached --name-only --diff-filter=ACM', {
+            cwd: projectRoot,
+        });
+        if (!stdout.trim()) {
+            return [];
+        }
+        return stdout
+            .trim()
+            .split('\n')
+            .filter((file) => file.startsWith('world/') && file.endsWith('.md'))
+            .map((file) => path.join(projectRoot, file));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Validate staged facts for pre-commit hook
+ */
+export async function validateStagedFacts(projectRoot) {
+    const stagedFiles = await getStagedWorldFacts(projectRoot);
+    if (stagedFiles.length === 0) {
+        return { exitCode: 0, message: 'No world facts staged for commit' };
+    }
+    const result = await validateFactFiles(projectRoot, stagedFiles);
+    if (result.valid) {
+        return {
+            exitCode: 0,
+            message: `✓ World fact validation passed (${result.factsValidated} facts checked)`,
+        };
+    }
+    const formatted = formatValidationResult(result);
+    return {
+        exitCode: 1,
+        message: `✗ World fact validation failed\n\n${formatted}\n\nCommit blocked. Fix errors or unlock facts.`,
+    };
+}
+//# sourceMappingURL=immutability-utils.js.map

package/dist/commands/writer/lib/immutability-utils.js.map

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

package/dist/commands/writer/lib/lock-utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * World fact locking utilities for writer CLI commands
+ * Inline implementation to avoid cross-package imports
+ */
+export interface LockEntry {
+    hash: string;
+    established: string;
+    mutability: 'immutable' | 'append-only' | 'expandable';
+    lockedAt: string;
+    'original-hash'?: string;
+    additions?: {
+        hash: string;
+        addedAt: string;
+    }[];
+    expansions?: string[];
+}
+export interface LockFile {
+    version: string;
+    facts: Record<string, LockEntry>;
+}
+/**
+ * Compute SHA256 hash of content
+ */
+export declare function computeHash(content: string): string;
+/**
+ * Read lock file
+ */
+export declare function readLockFile(projectRoot: string): Promise<LockFile>;
+/**
+ * Write lock file
+ */
+export declare function writeLockFile(projectRoot: string, lockFile: LockFile): Promise<void>;
+/**
+ * Lock a fact file
+ */
+export declare function lockFact(projectRoot: string, filePath: string): Promise<{
+    success: boolean;
+    factId: string;
+    message: string;
+}>;
+/**
+ * Unlock a fact
+ */
+export declare function unlockFact(projectRoot: string, factId: string, reason: string): Promise<{
+    success: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=lock-utils.d.ts.map

package/dist/commands/writer/lib/lock-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/writer/lib/lock-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,WAAW,GAAG,aAAa,GAAG,YAAY,CAAC;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAsCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQzE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1F;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyChE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBhD"}