cc-agentic-framework 1.14.1

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

@@ -0,0 +1,122 @@
+/**
+ * World fact locking 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';
+/**
+ * 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];
+    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();
+            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 { version: '1.0.0', facts: {} };
+    }
+}
+/**
+ * Write lock file
+ */
+export async function writeLockFile(projectRoot, lockFile) {
+    const lockPath = path.join(projectRoot, 'world.lock.json');
+    await fs.writeFile(lockPath, JSON.stringify(lockFile, null, 2), 'utf-8');
+}
+/**
+ * Lock a fact file
+ */
+export async function lockFact(projectRoot, filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const { data } = parseFrontmatter(content);
+        const factId = data.id;
+        if (!factId) {
+            return { success: false, factId: '', message: 'File has no fact ID in frontmatter' };
+        }
+        const mutability = data.mutability || 'immutable';
+        const established = data.established || new Date().toISOString().split('T')[0];
+        const lockFile = await readLockFile(projectRoot);
+        const hash = computeHash(content);
+        lockFile.facts[factId] = {
+            hash,
+            established,
+            mutability: mutability,
+            lockedAt: new Date().toISOString(),
+        };
+        if (mutability === 'append-only' || mutability === 'expandable') {
+            lockFile.facts[factId]['original-hash'] = hash;
+        }
+        await writeLockFile(projectRoot, lockFile);
+        return {
+            success: true,
+            factId,
+            message: `Locked fact ${factId} as ${mutability}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            factId: '',
+            message: `Failed to lock fact: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Unlock a fact
+ */
+export async function unlockFact(projectRoot, factId, reason) {
+    try {
+        const lockFile = await readLockFile(projectRoot);
+        if (!lockFile.facts[factId]) {
+            return { success: false, message: `Fact ${factId} is not locked` };
+        }
+        delete lockFile.facts[factId];
+        await writeLockFile(projectRoot, lockFile);
+        return {
+            success: true,
+            message: `Unlocked fact ${factId}. Reason: ${reason}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to unlock fact: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=lock-utils.js.map

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

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

package/dist/commands/writer/lock-fact.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Writer Lock Fact Command
+ *
+ * CLI command for locking world facts with hash-based immutability.
+ * Computes hash and adds to world.lock.json registry.
+ *
+ * Usage:
+ *   agentic-framework writer lock-fact --fact <fact-id>
+ *   agentic-framework writer lock-fact --path <file-path>
+ *
+ * @module commands/writer/lock-fact
+ */
+import { Command } from 'commander';
+/**
+ * Create the lock-fact command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createLockFactCommand(): Command;
+//# sourceMappingURL=lock-fact.d.ts.map

package/dist/commands/writer/lock-fact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-fact.d.ts","sourceRoot":"","sources":["../../../src/commands/writer/lock-fact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CA2B/C"}

package/dist/commands/writer/lock-fact.js

@@ -0,0 +1,174 @@
+/**
+ * Writer Lock Fact Command
+ *
+ * CLI command for locking world facts with hash-based immutability.
+ * Computes hash and adds to world.lock.json registry.
+ *
+ * Usage:
+ *   agentic-framework writer lock-fact --fact <fact-id>
+ *   agentic-framework writer lock-fact --path <file-path>
+ *
+ * @module commands/writer/lock-fact
+ */
+import { Command } from 'commander';
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import { glob } from 'glob';
+import { CliContext } from '../../lib/cli-context.js';
+import { withCLITelemetry } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+import { parseFrontmatter } from '../../lib/common/yaml-frontmatter.js';
+import { lockFact, writeLockFile } from './lib/lock-utils.js';
+/**
+ * Create the lock-fact command.
+ *
+ * @returns Commander command instance
+ */
+export function createLockFactCommand() {
+    const command = new Command('lock-fact');
+    command
+        .description('Lock a world fact with hash-based immutability')
+        .option('--fact <fact-id>', 'Fact ID to lock (e.g., world-core-physics)')
+        .option('--path <file-path>', 'Path to fact file to lock')
+        .option('--init', 'Initialize world.lock.json if it does not exist', false)
+        .action(async (cmdOptions) => {
+        await withCLITelemetry('writer', 'lock-fact', cmdOptions, async () => {
+            try {
+                await runLockFactCommand(cmdOptions);
+                return { success: true };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(chalk.red(`\nError: ${errorMessage}\n`));
+                process.exit(1);
+            }
+        });
+    });
+    return command;
+}
+/**
+ * Run the lock-fact command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runLockFactCommand(cmdOptions) {
+    const { fact: factId, path: filePath, init } = cmdOptions;
+    // Get CLI context
+    const ctx = await CliContext.require();
+    // Check if world.lock.json exists
+    const lockFilePath = path.join(ctx.projectRoot, 'world.lock.json');
+    const lockFileExists = await fs.pathExists(lockFilePath);
+    // Initialize lock file if --init or if it doesn't exist
+    if (!lockFileExists) {
+        if (init) {
+            console.log(chalk.dim('Initializing world.lock.json...\n'));
+            await writeLockFile(ctx.projectRoot, { version: '1.0.0', facts: {} });
+            console.log(chalk.green(`✓ Created ${lockFilePath}\n`));
+        }
+        else {
+            console.log(chalk.yellow('No world.lock.json found.'));
+            console.log(chalk.dim('Run with --init to create it, or create it manually.\n'));
+            throw new Error('Lock file not found. Use --init to create it.');
+        }
+    }
+    // Determine file path to lock
+    let targetFilePath;
+    if (filePath) {
+        // Use provided path
+        targetFilePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.join(ctx.projectRoot, filePath);
+    }
+    else if (factId) {
+        // Find file by fact ID
+        const worldPath = ctx.paths.resolve('world') || path.join(ctx.projectRoot, 'world');
+        if (!(await fs.pathExists(worldPath))) {
+            throw new Error(`World directory not found: ${worldPath}`);
+        }
+        // Search for file with this fact ID
+        const worldFactFiles = await glob('**/*.md', {
+            cwd: worldPath,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/.git/**'],
+        });
+        let foundFile = null;
+        for (const file of worldFactFiles) {
+            const content = await fs.readFile(file, 'utf-8');
+            const { data } = parseFrontmatter(content);
+            if (data.id === factId) {
+                foundFile = file;
+                break;
+            }
+        }
+        if (!foundFile) {
+            throw new Error(`Fact with ID "${factId}" not found in world directory`);
+        }
+        targetFilePath = foundFile;
+    }
+    else {
+        throw new Error('Either --fact or --path must be provided');
+    }
+    // Check if file exists
+    if (!(await fs.pathExists(targetFilePath))) {
+        throw new Error(`File not found: ${targetFilePath}`);
+    }
+    // Print header
+    console.log('');
+    console.log(chalk.bold('='.repeat(80)));
+    console.log(chalk.bold('Lock World Fact'));
+    console.log(chalk.bold('='.repeat(80)));
+    console.log('');
+    // Read file to get metadata
+    const content = await fs.readFile(targetFilePath, 'utf-8');
+    const { data } = parseFrontmatter(content);
+    const displayFactId = data.id;
+    const mutability = data.mutability;
+    console.log(chalk.dim('Fact Details:'));
+    console.log(chalk.dim(`  ID:           ${displayFactId}`));
+    console.log(chalk.dim(`  File:         ${path.relative(ctx.projectRoot, targetFilePath)}`));
+    console.log(chalk.dim(`  Mutability:   ${mutability}`));
+    console.log(chalk.dim(`  Established:  ${data.established}`));
+    console.log(chalk.dim(`  Version:      ${data.version || '1.0.0'}`));
+    console.log('');
+    // Lock the fact
+    const result = await lockFact(ctx.projectRoot, targetFilePath);
+    if (result.success) {
+        console.log(chalk.green(`✓ ${result.message}\n`));
+        // Show what this means for each mutability type
+        console.log(chalk.bold('What this means:'));
+        switch (mutability) {
+            case 'immutable':
+                console.log(chalk.dim('  • Content is now hash-locked'));
+                console.log(chalk.dim('  • Cannot be modified without explicit unlock'));
+                console.log(chalk.dim('  • Pre-commit hook will verify hash'));
+                console.log(chalk.dim('  • Use "unlock-fact" to make changes'));
+                break;
+            case 'append-only':
+                console.log(chalk.dim('  • Original content is hash-locked'));
+                console.log(chalk.dim('  • New sections can be added at the end'));
+                console.log(chalk.dim('  • Additions must be logged in frontmatter'));
+                console.log(chalk.dim('  • Original sections cannot be modified'));
+                break;
+            case 'expandable':
+                console.log(chalk.dim('  • Parent content is hash-locked'));
+                console.log(chalk.dim('  • New sub-items can be added'));
+                console.log(chalk.dim('  • Expansions must be logged in frontmatter'));
+                console.log(chalk.dim('  • Parent content cannot be modified'));
+                break;
+        }
+        console.log('');
+    }
+    else {
+        if (result.message.includes('already locked')) {
+            console.log(chalk.yellow('⚠ This fact is already locked.\n'));
+            console.log(chalk.dim('To modify it:'));
+            console.log(chalk.dim(`  1. Unlock: agentic-framework writer unlock-fact --fact ${displayFactId}`));
+            console.log(chalk.dim('  2. Make changes'));
+            console.log(chalk.dim(`  3. Re-lock: agentic-framework writer lock-fact --fact ${displayFactId}\n`));
+        }
+        else {
+            throw new Error(result.message);
+        }
+    }
+}
+//# sourceMappingURL=lock-fact.js.map

package/dist/commands/writer/lock-fact.js.map

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

package/dist/commands/writer/unlock-fact.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Writer Unlock Fact Command
+ *
+ * CLI command for unlocking world facts to allow modifications.
+ * Requires a reason for audit trail purposes.
+ *
+ * Usage:
+ *   agentic-framework writer unlock-fact --fact <fact-id> --reason "explanation"
+ *   agentic-framework writer unlock-fact --fact <fact-id> --dry-run
+ *
+ * @module commands/writer/unlock-fact
+ */
+import { Command } from 'commander';
+/**
+ * Create the unlock-fact command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createUnlockFactCommand(): Command;
+//# sourceMappingURL=unlock-fact.d.ts.map

package/dist/commands/writer/unlock-fact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlock-fact.d.ts","sourceRoot":"","sources":["../../../src/commands/writer/unlock-fact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CA4BjD"}

package/dist/commands/writer/unlock-fact.js

@@ -0,0 +1,160 @@
+/**
+ * Writer Unlock Fact Command
+ *
+ * CLI command for unlocking world facts to allow modifications.
+ * Requires a reason for audit trail purposes.
+ *
+ * Usage:
+ *   agentic-framework writer unlock-fact --fact <fact-id> --reason "explanation"
+ *   agentic-framework writer unlock-fact --fact <fact-id> --dry-run
+ *
+ * @module commands/writer/unlock-fact
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import readline from 'readline';
+import { CliContext } from '../../lib/cli-context.js';
+import { withCLITelemetry } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+import { unlockFact, readLockFile } from './lib/lock-utils.js';
+/**
+ * Create the unlock-fact command.
+ *
+ * @returns Commander command instance
+ */
+export function createUnlockFactCommand() {
+    const command = new Command('unlock-fact');
+    command
+        .description('Unlock a world fact to allow modifications')
+        .option('--fact <fact-id>', 'Fact ID to unlock (e.g., world-core-physics)')
+        .option('--reason <reason>', 'Reason for unlocking (required for audit trail)')
+        .option('--dry-run', 'Show what would be unlocked without making changes', false)
+        .option('-y, --yes', 'Skip confirmation prompt', false)
+        .action(async (cmdOptions) => {
+        await withCLITelemetry('writer', 'unlock-fact', cmdOptions, async () => {
+            try {
+                await runUnlockFactCommand(cmdOptions);
+                return { success: true };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(chalk.red(`\nError: ${errorMessage}\n`));
+                process.exit(1);
+            }
+        });
+    });
+    return command;
+}
+/**
+ * Prompt user for confirmation
+ *
+ * @param message - Confirmation message
+ * @returns True if user confirms, false otherwise
+ */
+async function promptConfirmation(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(message, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
+/**
+ * Run the unlock-fact command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runUnlockFactCommand(cmdOptions) {
+    const { fact: factId, reason, dryRun, yes } = cmdOptions;
+    // Validate required options
+    if (!factId) {
+        throw new Error('--fact option is required');
+    }
+    if (!dryRun && !reason) {
+        throw new Error('--reason option is required (unless using --dry-run)');
+    }
+    // Get CLI context
+    const ctx = await CliContext.require();
+    // Check if fact exists in lock file
+    const lockFile = await readLockFile(ctx.projectRoot);
+    const lockEntry = lockFile.facts[factId];
+    if (!lockEntry) {
+        throw new Error(`Fact "${factId}" not found in lock file. It may not be locked yet.`);
+    }
+    // Print header
+    console.log('');
+    console.log(chalk.bold('='.repeat(80)));
+    console.log(chalk.bold(dryRun ? 'Unlock Fact (Dry Run)' : 'Unlock Fact'));
+    console.log(chalk.bold('='.repeat(80)));
+    console.log('');
+    console.log(chalk.dim('Fact Details:'));
+    console.log(chalk.dim(`  ID:           ${factId}`));
+    console.log(chalk.dim(`  Mutability:   ${lockEntry.mutability}`));
+    console.log(chalk.dim(`  Established:  ${lockEntry.established}`));
+    console.log('');
+    if (dryRun) {
+        console.log(chalk.yellow('DRY RUN - No changes made\n'));
+        console.log(chalk.dim('What would happen:'));
+        console.log(chalk.dim(`  • Fact would be unlocked from ${lockEntry.mutability} registry`));
+        console.log(chalk.dim('  • Audit trail entry would be created'));
+        console.log('');
+        console.log(chalk.dim('After unlocking, you could:'));
+        console.log(chalk.dim('  1. Modify the fact file'));
+        console.log(chalk.dim(`  2. Re-lock with: agentic-framework writer lock-fact --fact ${factId}`));
+        console.log('');
+        return;
+    }
+    // Show warning and get confirmation for immutable facts
+    if (lockEntry.mutability === 'immutable' && !yes) {
+        console.log(chalk.yellow('⚠ WARNING: You are about to unlock an IMMUTABLE fact.\n'));
+        console.log(chalk.dim('Immutable facts are the foundation of world consistency.'));
+        console.log(chalk.dim('Modifying them may create contradictions across your story.\n'));
+        console.log(chalk.dim(`Reason for unlock: ${reason}\n`));
+        const confirmed = await promptConfirmation(chalk.bold('Are you sure you want to proceed? (y/N): '));
+        if (!confirmed) {
+            console.log(chalk.dim('\nUnlock cancelled.\n'));
+            return;
+        }
+    }
+    // Perform unlock
+    const result = await unlockFact(ctx.projectRoot, factId, reason || 'Dry run');
+    if (result.success) {
+        console.log('');
+        console.log(chalk.green(`✓ ${result.message}\n`));
+        // Show next steps
+        console.log(chalk.bold('Next Steps:'));
+        console.log(chalk.dim('  1. Make your changes to the fact file'));
+        console.log(chalk.dim(`  2. Re-lock the fact: agentic-framework writer lock-fact --fact ${factId}`));
+        console.log(chalk.dim('  3. Verify consistency across affected books'));
+        console.log('');
+        // Show mutability-specific guidance
+        switch (lockEntry.mutability) {
+            case 'immutable':
+                console.log(chalk.yellow('IMMUTABLE Fact Guidance:'));
+                console.log(chalk.dim('  • Ensure changes do not contradict established lore'));
+                console.log(chalk.dim('  • Update any dependent facts if necessary'));
+                console.log(chalk.dim('  • Review all books that reference this fact'));
+                break;
+            case 'append-only':
+                console.log(chalk.yellow('APPEND-ONLY Fact Guidance:'));
+                console.log(chalk.dim('  • Consider adding a new section instead of modifying'));
+                console.log(chalk.dim('  • If modifying original content, update carefully'));
+                console.log(chalk.dim('  • Log any additions in frontmatter'));
+                break;
+            case 'expandable':
+                console.log(chalk.yellow('EXPANDABLE Fact Guidance:'));
+                console.log(chalk.dim('  • Consider creating a new sub-item instead'));
+                console.log(chalk.dim('  • If modifying parent, ensure sub-items remain valid'));
+                console.log(chalk.dim('  • Log any expansions in frontmatter'));
+                break;
+        }
+        console.log('');
+    }
+    else {
+        throw new Error(result.message);
+    }
+}
+//# sourceMappingURL=unlock-fact.js.map

package/dist/commands/writer/unlock-fact.js.map

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

package/dist/commands/writer/validate-immutability.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Writer Validate Immutability Command
+ *
+ * CLI command for validating world fact immutability.
+ * Checks world facts against world.lock.json to enforce immutability rules.
+ *
+ * Usage:
+ *   agentic-framework writer validate-immutability [options]
+ *
+ * @module commands/writer/validate-immutability
+ */
+import { Command } from 'commander';
+/**
+ * Create the validate-immutability command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createValidateImmutabilityCommand(): Command;
+//# sourceMappingURL=validate-immutability.d.ts.map

package/dist/commands/writer/validate-immutability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-immutability.d.ts","sourceRoot":"","sources":["../../../src/commands/writer/validate-immutability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,OAAO,CA2B3D"}