cc-agentic-framework 1.14.1

package/dist/commands/writer/validate-immutability.js

@@ -0,0 +1,148 @@
+/**
+ * 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';
+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 { validateFactFiles, formatValidationResult, validateStagedFacts, } from './lib/immutability-utils.js';
+/**
+ * Create the validate-immutability command.
+ *
+ * @returns Commander command instance
+ */
+export function createValidateImmutabilityCommand() {
+    const command = new Command('validate-immutability');
+    command
+        .description('Validate world fact immutability against world.lock.json')
+        .option('--path <path>', 'Path to world facts directory', './world')
+        .option('--staged-only', 'Only validate staged files (for pre-commit hook)', false)
+        .option('-v, --verbose', 'Show detailed validation output', false)
+        .action(async (cmdOptions) => {
+        await withCLITelemetry('writer', 'validate-immutability', cmdOptions, async () => {
+            try {
+                await runValidateImmutabilityCommand(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 validate-immutability command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runValidateImmutabilityCommand(cmdOptions) {
+    const { path: worldPath = './world', stagedOnly, verbose } = cmdOptions;
+    // Get CLI context
+    const ctx = await CliContext.require();
+    // If staged-only, use git hook validator
+    if (stagedOnly) {
+        const result = await validateStagedFacts(ctx.projectRoot);
+        console.log(result.message);
+        process.exit(result.exitCode);
+        return;
+    }
+    // Resolve world path
+    const resolvedPath = ctx.paths.resolve('world') || path.join(ctx.projectRoot, worldPath);
+    // Check if world directory exists
+    if (!(await fs.pathExists(resolvedPath))) {
+        throw new Error(`World directory not found: ${resolvedPath}`);
+    }
+    // Check if world.lock.json exists
+    const lockFilePath = path.join(ctx.projectRoot, 'world.lock.json');
+    if (!(await fs.pathExists(lockFilePath))) {
+        console.log(chalk.yellow('\nNo world.lock.json found. World facts are not locked yet.'));
+        console.log(chalk.dim('Run "agentic-framework writer lock-fact" to lock facts.\n'));
+        return;
+    }
+    // Print header
+    console.log('');
+    console.log(chalk.bold('='.repeat(80)));
+    console.log(chalk.bold('World Fact Immutability Validation'));
+    console.log(chalk.bold('='.repeat(80)));
+    console.log('');
+    console.log(chalk.dim('Configuration:'));
+    console.log(chalk.dim(`  Project Root:  ${ctx.projectRoot}`));
+    console.log(chalk.dim(`  World Path:    ${resolvedPath}`));
+    console.log(chalk.dim(`  Lock File:     ${lockFilePath}`));
+    console.log('');
+    // Find all world fact files
+    const worldFactFiles = await glob('**/*.md', {
+        cwd: resolvedPath,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/.git/**'],
+    });
+    if (worldFactFiles.length === 0) {
+        console.log(chalk.yellow('No world fact files found in the specified path.\n'));
+        return;
+    }
+    console.log(chalk.dim(`Found ${worldFactFiles.length} world fact files\n`));
+    // Validate files
+    const startTime = Date.now();
+    const validationResult = await validateFactFiles(ctx.projectRoot, worldFactFiles);
+    const duration = Date.now() - startTime;
+    // Format and display results
+    const formatted = formatValidationResult(validationResult);
+    console.log(formatted);
+    // Show summary
+    console.log('');
+    console.log(chalk.bold('Summary:'));
+    console.log(chalk.dim(`  Files checked:    ${worldFactFiles.length}`));
+    console.log(chalk.dim(`  Facts validated:  ${validationResult.factsValidated}`));
+    console.log(chalk.dim(`  Errors:           ${validationResult.errors.length}`));
+    console.log(chalk.dim(`  Warnings:         ${validationResult.warnings.length}`));
+    console.log(chalk.dim(`  Duration:         ${duration}ms`));
+    console.log('');
+    // Show verbose details if requested
+    if (verbose) {
+        console.log(chalk.bold('Validation Details:'));
+        console.log('');
+        if (validationResult.errors.length > 0) {
+            console.log(chalk.red('Errors:'));
+            for (const error of validationResult.errors) {
+                console.log(chalk.red(`  [${error.code}] ${error.factId}`));
+                console.log(chalk.dim(`    File: ${error.file}`));
+                console.log(chalk.dim(`    ${error.message}`));
+                if (error.expectedHash && error.actualHash) {
+                    console.log(chalk.dim(`    Expected: ${error.expectedHash.substring(0, 16)}...`));
+                    console.log(chalk.dim(`    Actual:   ${error.actualHash.substring(0, 16)}...`));
+                }
+                console.log('');
+            }
+        }
+        if (validationResult.warnings.length > 0) {
+            console.log(chalk.yellow('Warnings:'));
+            for (const warning of validationResult.warnings) {
+                console.log(chalk.yellow(`  ${warning.factId}`));
+                console.log(chalk.dim(`    File: ${warning.file}`));
+                console.log(chalk.dim(`    ${warning.message}`));
+                console.log('');
+            }
+        }
+    }
+    // Exit with error code if validation failed
+    if (!validationResult.valid) {
+        console.log(chalk.red('Validation failed. Fix errors before committing.\n'));
+        process.exit(1);
+    }
+    console.log(chalk.green('✓ All validations passed\n'));
+}
+//# sourceMappingURL=validate-immutability.js.map

package/dist/commands/writer/validate-immutability.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * Writer Validate Command
+ *
+ * CLI command for validating book structure and metadata.
+ *
+ * Usage:
+ *   agentic-framework writer validate
+ *   agentic-framework writer validate --verbose
+ *   agentic-framework writer validate --strict
+ *
+ * @module commands/writer/validate
+ */
+import { Command } from 'commander';
+/**
+ * Create the validate command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createValidateCommand(): Command;
+//# sourceMappingURL=validate.d.ts.map

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

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

package/dist/commands/writer/validate.js

@@ -0,0 +1,370 @@
+/**
+ * Writer Validate Command
+ *
+ * CLI command for validating book structure and metadata.
+ *
+ * Usage:
+ *   agentic-framework writer validate
+ *   agentic-framework writer validate --verbose
+ *   agentic-framework writer validate --strict
+ *
+ * @module commands/writer/validate
+ */
+import { Command } from 'commander';
+import fs from 'fs-extra';
+import path from 'path';
+import yaml from 'yaml';
+import { CliContext } from '../../lib/cli-context.js';
+import { recordCLICommand } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+/**
+ * Create the validate command.
+ *
+ * @returns Commander command instance
+ */
+export function createValidateCommand() {
+    const command = new Command('validate');
+    command
+        .description('Validate book structure, references, and metadata')
+        .option('-v, --verbose', 'Show detailed validation information', false)
+        .option('--strict', 'Exit with error code on warnings', false)
+        .option('-p, --path <path>', 'Project root path', '.')
+        .action(async (cmdOptions) => {
+        try {
+            await runValidateCommand(cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`\nError: ${errorMessage}\n`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Parse YAML frontmatter from markdown file.
+ *
+ * @param filePath - Path to markdown file
+ * @returns Parsed frontmatter or null
+ */
+async function parseFrontmatter(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            return null;
+        }
+        return yaml.parse(frontmatterMatch[1]);
+    }
+    catch (_error) {
+        return null;
+    }
+}
+/**
+ * Validate BOOK.md structure.
+ *
+ * @param projectRoot - Project root path
+ * @returns Array of validation issues
+ */
+async function validateBookFile(projectRoot) {
+    const issues = [];
+    const bookPath = path.join(projectRoot, 'BOOK.md');
+    if (!(await fs.pathExists(bookPath))) {
+        issues.push({
+            type: 'error',
+            location: 'BOOK.md',
+            message: 'BOOK.md not found. Run "agentic-framework writer init" first.',
+        });
+        return issues;
+    }
+    const frontmatter = await parseFrontmatter(bookPath);
+    if (!frontmatter) {
+        issues.push({
+            type: 'error',
+            location: 'BOOK.md',
+            message: 'Invalid or missing YAML frontmatter',
+        });
+        return issues;
+    }
+    // Validate required fields
+    const requiredFields = ['title', 'status', 'created'];
+    for (const field of requiredFields) {
+        if (!frontmatter[field]) {
+            issues.push({
+                type: 'error',
+                location: 'BOOK.md',
+                message: `Missing required field: ${field}`,
+            });
+        }
+    }
+    // Validate status
+    const validStatuses = ['planning', 'drafting', 'revising', 'complete'];
+    if (frontmatter.status && !validStatuses.includes(frontmatter.status)) {
+        issues.push({
+            type: 'warning',
+            location: 'BOOK.md',
+            message: `Invalid status: ${frontmatter.status}. Expected one of: ${validStatuses.join(', ')}`,
+        });
+    }
+    return issues;
+}
+/**
+ * Validate manuscript structure.
+ *
+ * @param projectRoot - Project root path
+ * @param verbose - Show verbose output
+ * @returns Array of validation issues
+ */
+async function validateManuscriptStructure(projectRoot, _verbose) {
+    const issues = [];
+    const manuscriptDir = path.join(projectRoot, 'manuscript');
+    if (!(await fs.pathExists(manuscriptDir))) {
+        issues.push({
+            type: 'error',
+            location: 'manuscript/',
+            message: 'Manuscript directory not found',
+        });
+        return issues;
+    }
+    // Validate parts
+    const partPattern = /^part-(\d{3})-(.+)$/;
+    const items = await fs.readdir(manuscriptDir);
+    const partDirs = items.filter(item => partPattern.test(item));
+    if (partDirs.length === 0) {
+        issues.push({
+            type: 'warning',
+            location: 'manuscript/',
+            message: 'No parts found. Create parts with "agentic-framework writer create-part"',
+        });
+        return issues;
+    }
+    for (const partDir of partDirs) {
+        const partPath = path.join(manuscriptDir, partDir);
+        const partFile = path.join(partPath, 'PART.md');
+        if (!(await fs.pathExists(partFile))) {
+            issues.push({
+                type: 'error',
+                location: `${partDir}/PART.md`,
+                message: 'PART.md not found',
+            });
+            continue;
+        }
+        // Validate part frontmatter
+        const partFrontmatter = await parseFrontmatter(partFile);
+        if (!partFrontmatter) {
+            issues.push({
+                type: 'error',
+                location: `${partDir}/PART.md`,
+                message: 'Invalid or missing YAML frontmatter',
+            });
+            continue;
+        }
+        if (!partFrontmatter['part-number']) {
+            issues.push({
+                type: 'error',
+                location: `${partDir}/PART.md`,
+                message: 'Missing part-number in frontmatter',
+            });
+        }
+        // Validate chapters
+        const chapterPattern = /^chapter-(\d{3})-(.+)$/;
+        const partItems = await fs.readdir(partPath);
+        const chapterDirs = partItems.filter(item => {
+            const itemPath = path.join(partPath, item);
+            return fs.statSync(itemPath).isDirectory() && chapterPattern.test(item);
+        });
+        for (const chapterDir of chapterDirs) {
+            const chapterPath = path.join(partPath, chapterDir);
+            const chapterFile = path.join(chapterPath, 'CHAPTER.md');
+            if (!(await fs.pathExists(chapterFile))) {
+                issues.push({
+                    type: 'error',
+                    location: `${partDir}/${chapterDir}/CHAPTER.md`,
+                    message: 'CHAPTER.md not found',
+                });
+                continue;
+            }
+            // Validate chapter frontmatter
+            const chapterFrontmatter = await parseFrontmatter(chapterFile);
+            if (!chapterFrontmatter) {
+                issues.push({
+                    type: 'error',
+                    location: `${partDir}/${chapterDir}/CHAPTER.md`,
+                    message: 'Invalid or missing YAML frontmatter',
+                });
+                continue;
+            }
+            if (!chapterFrontmatter['chapter-number']) {
+                issues.push({
+                    type: 'error',
+                    location: `${partDir}/${chapterDir}/CHAPTER.md`,
+                    message: 'Missing chapter-number in frontmatter',
+                });
+            }
+            if (!chapterFrontmatter['pov-character']) {
+                issues.push({
+                    type: 'warning',
+                    location: `${partDir}/${chapterDir}/CHAPTER.md`,
+                    message: 'Missing pov-character in frontmatter',
+                });
+            }
+            // Validate scenes
+            const scenePattern = /^scene-(\d{3})-(.+)\.md$/;
+            const chapterItems = await fs.readdir(chapterPath);
+            const sceneFiles = chapterItems.filter(item => scenePattern.test(item));
+            for (const sceneFile of sceneFiles) {
+                const scenePath = path.join(chapterPath, sceneFile);
+                const sceneFrontmatter = await parseFrontmatter(scenePath);
+                if (!sceneFrontmatter) {
+                    issues.push({
+                        type: 'error',
+                        location: `${partDir}/${chapterDir}/${sceneFile}`,
+                        message: 'Invalid or missing YAML frontmatter',
+                    });
+                    continue;
+                }
+                if (!sceneFrontmatter['scene-number']) {
+                    issues.push({
+                        type: 'error',
+                        location: `${partDir}/${chapterDir}/${sceneFile}`,
+                        message: 'Missing scene-number in frontmatter',
+                    });
+                }
+                const validSceneTypes = ['action', 'dialogue', 'introspection', 'transition'];
+                if (sceneFrontmatter['scene-type'] && !validSceneTypes.includes(sceneFrontmatter['scene-type'])) {
+                    issues.push({
+                        type: 'warning',
+                        location: `${partDir}/${chapterDir}/${sceneFile}`,
+                        message: `Invalid scene-type: ${sceneFrontmatter['scene-type']}. Expected one of: ${validSceneTypes.join(', ')}`,
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Validate character files.
+ *
+ * @param projectRoot - Project root path
+ * @returns Array of validation issues
+ */
+async function validateCharacters(projectRoot) {
+    const issues = [];
+    const charactersDir = path.join(projectRoot, 'characters');
+    if (!(await fs.pathExists(charactersDir))) {
+        issues.push({
+            type: 'warning',
+            location: 'characters/',
+            message: 'Characters directory not found',
+        });
+        return issues;
+    }
+    const items = await fs.readdir(charactersDir);
+    for (const item of items) {
+        if (item.startsWith('.'))
+            continue;
+        const characterPath = path.join(charactersDir, item);
+        const stat = await fs.stat(characterPath);
+        if (stat.isDirectory()) {
+            const profileFile = path.join(characterPath, 'profile.md');
+            if (!(await fs.pathExists(profileFile))) {
+                issues.push({
+                    type: 'error',
+                    location: `characters/${item}/profile.md`,
+                    message: 'profile.md not found',
+                });
+                continue;
+            }
+            const frontmatter = await parseFrontmatter(profileFile);
+            if (!frontmatter) {
+                issues.push({
+                    type: 'error',
+                    location: `characters/${item}/profile.md`,
+                    message: 'Invalid or missing YAML frontmatter',
+                });
+                continue;
+            }
+            if (!frontmatter.id || frontmatter.id !== item) {
+                issues.push({
+                    type: 'error',
+                    location: `characters/${item}/profile.md`,
+                    message: `Character ID mismatch: frontmatter.id (${frontmatter.id}) should match folder name (${item})`,
+                });
+            }
+            const validTypes = ['main', 'supporting', 'minor'];
+            if (frontmatter.type && !validTypes.includes(frontmatter.type)) {
+                issues.push({
+                    type: 'warning',
+                    location: `characters/${item}/profile.md`,
+                    message: `Invalid character type: ${frontmatter.type}. Expected one of: ${validTypes.join(', ')}`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Run the validate command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runValidateCommand(cmdOptions) {
+    const startTime = Date.now();
+    const { verbose, strict, path: pathOption, } = cmdOptions;
+    // Use CliContext
+    const ctx = pathOption && pathOption !== '.'
+        ? await CliContext.create({ path: pathOption })
+        : await CliContext.require();
+    const projectRoot = ctx.projectRoot;
+    console.log('Validating book structure...\n');
+    // Run validations
+    const allIssues = [];
+    const bookIssues = await validateBookFile(projectRoot);
+    allIssues.push(...bookIssues);
+    const manuscriptIssues = await validateManuscriptStructure(projectRoot, verbose ?? false);
+    allIssues.push(...manuscriptIssues);
+    const characterIssues = await validateCharacters(projectRoot);
+    allIssues.push(...characterIssues);
+    // Categorize issues
+    const errors = allIssues.filter(issue => issue.type === 'error');
+    const warnings = allIssues.filter(issue => issue.type === 'warning');
+    // Output results
+    if (errors.length > 0) {
+        console.log('Errors:\n');
+        errors.forEach(issue => {
+            const lineInfo = issue.line ? `:${issue.line}` : '';
+            console.log(`  ❌ ${issue.location}${lineInfo}`);
+            console.log(`     ${issue.message}\n`);
+        });
+    }
+    if (warnings.length > 0 && verbose) {
+        console.log('Warnings:\n');
+        warnings.forEach(issue => {
+            const lineInfo = issue.line ? `:${issue.line}` : '';
+            console.log(`  ⚠️  ${issue.location}${lineInfo}`);
+            console.log(`     ${issue.message}\n`);
+        });
+    }
+    // Summary
+    console.log('Validation Summary:');
+    console.log(`  Errors:   ${errors.length}`);
+    console.log(`  Warnings: ${warnings.length}\n`);
+    if (errors.length === 0 && warnings.length === 0) {
+        console.log('✅ Book structure is valid!\n');
+    }
+    else if (errors.length === 0) {
+        console.log('✅ No critical errors found\n');
+    }
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    const success = errors.length === 0;
+    recordCLICommand('writer', 'validate', { verbose, strict }, { errors: errors.length, warnings: warnings.length }, durationMs, success).catch(() => { });
+    // Exit with appropriate code
+    if (errors.length > 0) {
+        process.exit(1);
+    }
+    if (strict && warnings.length > 0) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

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

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

package/dist/hooks/claude-folder-protection.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Claude Folder Protection Hook
+ *
+ * Advisory hook that warns when editing files in protected .claude/ subdirectories.
+ * These files are synced from framework modules and direct edits will be overwritten
+ * when running `agentic-framework sync`.
+ *
+ * Protected paths (warn on edit):
+ * - .claude/skills/     - Synced from framework modules
+ * - .claude/commands/   - Synced from framework modules
+ * - .claude/hooks/      - Synced from framework modules
+ * - .claude/registries/ - Auto-generated by sync
+ *
+ * User-owned paths (allow edits):
+ * - .claude/settings.local.json  - User customizations
+ * - .claude/settings.json        - Plugin settings
+ * - .claude/agents/              - Custom agent JSON configs
+ * - .claude/context/             - Project-specific context files
+ * - .claude/statusline.sh        - Can be customized
+ */
+export {};
+//# sourceMappingURL=claude-folder-protection.d.ts.map

package/dist/hooks/claude-folder-protection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-folder-protection.d.ts","sourceRoot":"","sources":["../../src/hooks/claude-folder-protection.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG"}